by shanananana
支持对接内部系统的 AI 排障工作台：通过 HTTP API / Webhook 接入工单与告警系统，串联代码、日志、配置和 Agent，并提供面向产品、运营、客服的 Web 自助分析页面。
# Add to your Claude Code skills
git clone https://github.com/shanananana/deepticketdeepticket is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by shanananana. 支持对接内部系统的 AI 排障工作台：通过 HTTP API / Webhook 接入工单与告警系统，串联代码、日志、配置和 Agent，并提供面向产品、运营、客服的 Web 自助分析页面。. It has 55 GitHub stars.
deepticket's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/shanananana/deepticket" and add it to your Claude Code skills directory (see the Installation section above).
deepticket is primarily written in Python. It is open-source under shanananana on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh deepticket against similar tools.
No comments yet. Be the first to share your thoughts!
Unlocks once the catalog security scan passes (runs nightly).
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
DeepTicket 是一层部署在团队自己环境里的 AI 工单排障与 Agent 编排平台。
它提供统一的 HTTP Ingress API 和可配置 Webhook：内部工单、告警、监控平台或自研系统，只要能够发送或接收 HTTP 请求，就可以按统一事件格式接入。DeepTicket 当前提供的是通用接入能力，不内置某个具体厂商的专用适配器。
进入 DeepTicket 的工单会按项目路由到对应的 Git 仓库、日志查询 Skill、配置中心 MCP 和其他内部工具。OpenHands Agent 完成多轮分析后，DeepTicket 将摘要、证据、影响面、根因假设和建议通过 Webhook 写回原工单系统，也可以选择只存储、不回调。
一句话概括：DeepTicket 让内部工单从“人工转述问题”，变成“自动带着项目上下文完成第一轮排查”。
很多问题并不需要立刻叫研发，却也不是一句“建议检查日志”就能结束。
DeepTicket 把问题分析所需的上下文放到同一个工作台里：项目源码、运行日志、配置项、内部工具和原始工单。客服、运营、产品与研发可以围绕同一份上下文协作。Agent 先读取事实，再给出问题原因、影响范围和处理建议。
从“问一个 AI”到“完成一次排查”。
重点不是让对话更长，而是让每个结论都更接近证据。
DeepTicket 不是公司级 Copilot 的替代品，也不是把所有文档灌进向量库的纯 RAG。它更像一层面向具体项目的“排查与回写编排”：接入真实工具，限定项目边界，让 Agent 对着可验证的上下文工作。
工单 / 告警 / 用户提问
↓
Ingress
↓
按项目路由：Git + 日志 + 配置 + MCP / Skill
↓
OpenHands Agent 多轮分析
↓
带证据的结论：摘要 · 根因假设 · 影响面 · 建议
↓
工作台查看 / 人工确认 / Webhook 回写
| 能力 | 纯 RAG | 公司级 Copilot | DeepTicket |
|---|---|---|---|
| 读取项目源码 | 文档片段 | 视平台而定 | ✅ Git workspace |
| 查询内网日志 / 配置 | 需要先灌库 | 通常较粗 | ✅ MCP / Skill |
| 多项目隔离 | 通常有限 | 平台统一管理 | ✅ 项目级配置 |
| 接收工单 / 告警 | ❌ | 视集成而定 | ✅ HTTP API / Webhook |
| 结论写回原系统 | ❌ | 视集成而定 | ✅ Webhook |
| 业务团队自托管 | 视方案而定 | 通常不支持 | ✅ Docker / YAML |
和 OpenHands 的关系： OpenHands 负责 Agent 执行；DeepTicket 负责工作台、项目配置、知识库同步、Ingress 和结果回写。
把日志和配置查询接好后，客服、运营、产品等角色可以直接问：
“这个现象和需求一致吗？”
“线上配置为什么和文档不一致？”
“这是数据问题、配置问题，还是代码问题？”
回答带上日志、配置项和代码位置，帮助不同角色共同判断问题原因，并决定后续的处理方式。
任意支持 HTTP 的工单或告警系统都可以推送事件，DeepTicket 在后台完成关联项目、读取代码与配置、整理影响面，并通过 Webhook 将结果回写原系统。值班同学看到的是一份可审阅的分析草稿，而不是一条孤立的错误消息。
接入报表或 BI MCP 后，可以分析活动 ROI、日报与投放日志之间的不一致。垂类示例见 ad_agent；DeepTicket 本身负责项目隔离、工具接入和编排，不绑定具体业务领域。
前提：已安装 Docker Desktop 或 Docker Engine + Compose v2。
mkdir deepticket && cd deepticket
curl -LO https://raw.githubusercontent.com/shanananana/deepticket/main/docker-compose.image.yml
curl -LO https://raw.githubusercontent.com/shanananana/deepticket/main/.env.docker.example
cp .env.docker.example .env
docker compose -f docker-compose.image.yml up -d
打开 **http://127.0.0.1:8600**，使用默认账户 admin / admin 登录。LLM Key 可以提前写入 .env，也可以登录后在侧栏 LLM 配置 中填写。
⚠️ 默认账号仅用于本地体验。部署到内网或生产环境前，请立即修改密码、配置鉴权和持久化策略。
git clone https://github.com/shanananana/deepticket.git
cd deepticket
bash scripts/setup.sh
bash scripts/start_all.sh
第一次体验可以直接复制 DEMO_PROMPT.md 中的 Nginx 日志提问；想看“日志 → 配置 / 代码 → ROI 结论”的完整流程，参考 5 分钟上手 & ROI 演示。
常用命令：
docker compose logs -f deepticket # 查看日志
docker compose down # 停止服务
bash scripts/verify.sh # 本地自检
DeepTicket 将系统拆成输入、知识、引擎、输出和存储等层：输入负责聊天与 Ingress，知识层负责 Git / Skill / MCP，上层由 OpenHands 执行分析，输出层负责流式展示与 Webhook 回写，存储层负责对话、项目配置和运行记录。
| 文档 | 适合什么时候看 |
|---|---|
| docs/docker.md | Docker 部署、GHCR 镜像、数据卷和内网试点 |
| docs/quickstart-demo.md | 从零体验 Demo 与 ROI 场景 |
| docs/DEMO_PROMPT.md | 复制即用的 Nginx / ROI 示例提问 |
| deepticket.example.yaml | 查看完整配置项和接入示例 |
| deepticket/skills/README.md | 编写与挂载项目 Skill |
| CONTRIBUTING.md | 本地开发、测试与贡献指南 |
| CHANGELOG.md | 版本变化与已知能力边界 |
多项目、MCP、Ingress 和 agents.md 都可以在工作台侧栏配置，也可以通过管理员 API 管理：/api/admin/projects/{id}。
DeepTicket 当前处于 Alpha（v0.4.0）。核心链路已经覆盖：项目管理、Git 知识库、Skill / MCP、OpenHands Agent、工作台对话、Ingress 异步分析、Webhook 回写和运行观测。