插件化编码智能体 JacksonTai2007/dsh-ultra

DSH Ultra

面向软件工程的 agent harness（智能体框架）：它驱动一个编码 agent 读写你的文件、执行你的 shell、检索网络、把任务分派给子 agent 并汇报结果——可以经浏览器 UI、一次性的无头命令，或一个供其他客户端调用的 MCP 端点使用。

其中的一切都是插件。工具、策略、记忆、钩子、模型适配器，乃至系统提示词的各个 section 都是独立的包，由 Cordis 在启动时组装；因此某个部署要增加一项能力就挂载对应的包，要去掉就不挂载。

非官方 fork。 本仓库是 DeepSeek AI 开源项目 DeepSeek Harness 的个人 fork，由 @JacksonTai2007 维护，与 DeepSeek AI 无隶属关系，也未获其背书或支持，且包含大量本地改动——请把问题提到本仓库，不要提给他们。许可证与上游一致为 MIT，原始版权声明保留在 LICENSE 中。

安装

需要 Node.js 22 及以上，以及 pnpm（corepack enable）。

git clone https://github.com/JacksonTai2007/dsh-ultra.git
cd dsh-ultra
pnpm install
pnpm run build

之后既可以在这个 checkout 里经 pnpm 使用：

pnpm dsh web

也可以把 dsh 命令装到全局：

pnpm link --global ./apps/cli

运行

dsh 启动的是一个 profile——由若干插件 bundle 层叠加、并置于你自己的覆盖层之下的有序栈，存放在 $DSH_HOME/profiles（默认 ~/.dsh/profiles）。开箱即用的有三个。

dsh web # browser UI on http://127.0.0.1:3080
dsh --profile headless "run the tests" # answer one task, print the result, exit
dsh --profile web --port 8080 --no-open # serve without opening a browser

先配置模型凭据——DeepSeek 适配器从环境变量读取 DEEPSEEK_API_KEY，也可以改由 Web UI 的 Models 页面替你保存。

export DEEPSEEK_API_KEY=sk-... # PowerShell: $env:DEEPSEEK_API_KEY = 'sk-...'

不启动、只查看某个 profile 实际组装出的插件树：

dsh --profile web --dump-config

agent 能做什么

| 领域 | 能力 |
| 文件 | 读／写／编辑、glob 与 ripgrep 检索、Jupyter notebook 单元格编辑、按轮次的检查点与 /rewind 恢复 |
| Shell | bash 与 PowerShell、持久会话、后台任务（可轮询输出、可终止）、PTY 终端 |
| 分派 | 子 agent（spawn、fork、resume）、由 .dsh/agents/*.md 定义的 agent 类型、agent 间消息、实验性的 agent 团队 |
| 规划 | 带审批门的 plan mode、目标栈、todo 清单，以及带依赖关系的任务板 |
| 上下文 | 工作区指令、git 状态、自动记忆目录、文件引用、会话引用、延迟工具发现、带工具结果裁剪的上下文压缩 |
| 策略 | 沙箱执行（bwrap／Landlock／Seatbelt／Windows ACL）、Tool(content) 权限规则、审批提示，以及可选的模型预审批器 |
| 集成 | MCP 客户端（工具、资源、提示词、elicitation）与 MCP 服务端、LSP、两套钩子协议桥、支持参数与 fork 执行的 skills |
| 运行时 | Web UI、无头一次性执行、JSON-RPC SDK、ACP、code mode（run_code）、支持冷启动补投的定时任务、经 /cost 的成本报告 |

完整的工具参考（自动生成）见 docs/tool-catalog.md。

配置

profile 是 YAML。$DSH_HOME/profiles/<name>/cordis.yml 归你编辑；它以补丁方式作用于下层的 bundle，因此你只需要写差异部分。

- id: system-prompt
config:
persona: >-
You are a coding agent for the payments service.
- insert:
- id: memory-dir
name: '@deepseek-ai/dsh-memory-dir'

每个插件的配置字段都收录在 docs/config-catalog.md，而各个包自己的 README 记录了它的服务 API、事件与模型可见面。

文档

- 架构——插件模型、能力接缝，以及一个回合是怎么跑的
- 开发指南——仓库结构、门禁与测试政策
- 工具目录——每个面向模型的工具及其 schema
- 配置目录——每个插件的配置字段
- 子系统文档——会话、工具、系统提示词、沙箱等
- AGENTS.md——agent 在本仓库必须遵守的编写契约

状态

开发者预览阶段，迭代很快。会有破坏兼容性的改动。 Windows、macOS、Linux 均在使用，但部分测试套件需要平台权限（Windows 创建符号链接）或特定工具（pwsh、POSIX shell），缺失时会跳过。

许可证

MIT。第三方依赖及其许可证披露在 THIRD_PARTY_NOTICES.md。