dsh-session-doctor

DeepSeek Harness

English | 中文

DeepSeek Harness（dsh）是由 DeepSeek AI 开发的开源 agent harness（智能体框架）。

它构建于一切皆插件的架构之上，由 Cordis 驱动，其设计参见论文 A Programming Paradigm for Spatiotemporal Composability。

文档：https://deepseek-harness.github.io/deepseek-harness/

开发者预览

DeepSeek Harness 处于 开发者预览 阶段，正在快速迭代。未来将出现破坏兼容性的变更。

运行本项目前，请阅读安全说明。

运行

通过 npm 运行

安装 Node.js，然后运行：

npx @deepseek-ai/dsh web

该命令默认会在 http://127.0.0.1:3080 启动 Web UI，本机启动时还会用默认浏览器打开页面。通过 SSH 启动时只打印宿主机 URL，因为本地转发地址由 SSH 客户端或编辑器持有。传入 --no-open 可仅运行服务器而不打开浏览器。详见 Web UI 指南。

从源码运行

如需从仓库源码运行：

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

pnpm run build 会准备仓库产物。pnpm dsh web 会直接使用这些已构建产物，不会重新构建。

社区与支持

• 通过 GitHub Discussions 提交反馈或 bug 报告。
• 为你的插件仓库添加 dsh-plugin 话题，便于被发现。
• 欢迎加入 DeepSeek Harness 企微群：扫码添加企微小助手并填写入群问卷，完成后小助手会邀请你入群。

Session Doctor 社区插件

社区 Session Doctor 集成帮助运维人员解释 agent Session 为什么停止、循环、反复重试或产生不完整的 JSONL 日志。

• 确定性诊断会回放已持久化的 Session 事件，并识别重复失败的工具调用、未变化的失败循环、工具错误突发、提供方重试风暴、达到 token 上限的轮次、持续的上下文增长以及中断轮次。
• Web UI 会展示发现项，并可以根据有界且不含负载的摘要请求结构化 LLM RCA。
• 跨 Session 聚类会按重复出现的探测器、类别和建议身份分组，帮助优先处理重复事故。
• 显式物理修复只恢复 JSONL 末尾被截断的部分，同时保留有效的逻辑事件前缀。

诊断和聚类均为只读操作。RCA 会排除原始消息、工具参数、调用 id 和不透明元数据；物理修复必须显式执行 --repair。

使用方式见 Session Doctor 组合包，已发布的源码快照见社区仓库。

参与贡献

参见 CONTRIBUTING.md。

开发

请先阅读开发指南与架构文档。

面向 agent：请遵循 AGENTS.md。

许可证

MIT

第三方依赖及其许可证见 THIRD_PARTY_NOTICES.md。