五分钟其实很宽裕。全部流程就一条命令、一把钥匙、一个文件夹——真正值得理解的是 agent 能对那个文件夹做什么,以及各部件怎么咬合。
第 0 步:前置条件
Node.js,仅此而已。任意当前 LTS 版本。node --version 能打印出合理的版本号,前置条件就算完成了。
第 1 步:启动 Web UI
cd your-project
npx @deepseek-ai/dsh web
这是 README 的官方路径:不全局安装、不 clone、不构建。进程启动本地服务并打印地址——默认 http://127.0.0.1:3080。打开它。
关于你刚启动的这个进程,有两点值得知道:
- 启动目录就是默认文件系统位置。
dsh把你的启动目录当大本营,所以要从项目目录里启动。 - 此刻什么都还没选中。 Web UI 刻意以“未绑定工作区”的状态启动——这是下一步,不是 bug。
如果你要走源码路径(通常不需要,除非你在开发 harness 本身):clone、pnpm install、pnpm run build、pnpm dsh web,殊途同归到同一个 UI。
第 2 步:API key
打开 设置 → 模型,粘贴你的 DeepSeek API key,保存。配置仪式到此结束——而且不需要重启:保存的那一刻模型路由就可用了。
从其他 harness 迁移过来的人常会意外:默认假设是官方 DeepSeek API。其他提供方和 OpenAI 兼容端点也存在,但那是配置项而非前置条件,需要时看官方 providers 指南。
第 3 步:选择工作区
点 选择工作区,把项目目录(启动时所在目录)加进来,选中它。不做这一步,会话输入框一直不可用——harness 拒绝漫无目的地闲聊。
这是新用户的第 1 号坑:输入框锁着是故意的。工作区是文件访问与命令执行的边界范围;选中它的那一刻,agent 才有了身体。
第 4 步:第一次会话
开一个会话,发点真东西:
总结这个仓库的结构,指出主要包。
按照官方指南,从这里开始 agent 可以:读写工作区文件、执行命令、委派任务、维护计划。当某个操作在当前权限策略下需要审批时,Web UI 会先问你——任何要紧的事你始终在环上。
第一次会话建议用来观察它什么时候开口问。审批的节奏是理解这套 harness 安全观的最佳入口:原则上一切皆可为,要紧之事必先问。
第 5 步:知道自己站在什么上面
README 里直白的免责声明:DeepSeek Harness 处于 developer preview,迭代极快——会有兼容性破坏变更。锁死版本、预期颠簸,遇到反常行为当作该报的 issue(GitHub Discussions 是官方渠道),而不是自己的错。
这条路通往哪里
循环已经跑起来了。之外的一切——记忆、皮肤、IM 桥、多智能体团队、TUI——都以插件形式到来,挂载在核心旁边而不是 fork 进核心。两个门:
- Plugin 101——用你读完这篇指南的时间写完第一个插件
- 资源地图——50+ 条经核验的生态条目,链接全部可达
五分钟到了;标签页里的 agent 还在等你。