DeepSeek Harness 现状：源码 0.1.5-alpha.1 与 npm 通道
一句话版：官方源码已到
0.1.5-alpha.1；npmlatest/next仍停在0.1.2-rc.1，alpha通道已发布0.1.5-alpha.1。默认npx启动的是latest，本文新增接口对应源码版。
核验日期：2026-09-09。本站是社区教程站，与 DeepSeek 官方无隶属关系。
状态总览
| 项 | 核验结果 |
|---|---|
| 官方仓库 | deepseek-ai/deepseek-harness |
| 源码基线 | master / 5dda764ed3aa172535a7967b06ff95d9cbfe536a |
| 提交时间 | 2026-09-08 23:25:45（北京时间） |
| 源码版本 / tag | 0.1.5-alpha.1 / dsh-v0.1.5-alpha.1 |
| npm 通道 | latest = next = 0.1.2-rc.1；alpha = 0.1.5-alpha.1 |
| 与本站旧基线相比 | 从 cd5ef8148158 到当前基线新增 1863 个提交 |
| 许可 / 阶段 | MIT；Developer Preview，接口仍有破坏性变化 |
| Node 要求 | ^22.19.0 || >=24.0.0（根 package.json#engines） |
| 默认 Web 地址 | http://127.0.0.1:3080；源码版需使用 CLI 打印的带 token 启动链接 |
版本事实来自官方 Git、根 package.json 与 npm registry；功能摘要同时核对 0.1.5-alpha.1 发布说明、0.1.3-alpha.2、0.1.3-alpha.1 和对应 TypeScript 实现。
破坏性变更（升级前必读）
| 变更 | 影响 | 本站文档 |
|---|---|---|
| 会话格式升级至 V3 | 恢复受支持的历史会话时生成新版日志并保留原文件；系统提示词纳入消息历史；旧 PTC 事件与 code 预设引用自动迁移。自定义日志读取器需适配新格式，升级后的会话不支持降级读取 | 升级与迁移、会话机制 |
| 插件 Agent API | 移除 ctx.agent，调用方需显式传递 Agent；同时修正可继续对话的子代理归属，避免它们被当作根会话参与定时调度 | 插件解剖、子 Agent |
| Inbox API | Inbox 改为类型接口，不再导出可构造的运行时类；插件通过 agent.inbox 读写待处理消息，hasPending 与 claim 不再属于公共接口 | 会话机制、事件系统 |
本次源码变化与本站文档
| 变化 | 使用 / 迁移要点 | 本站文档 |
|---|---|---|
| 动态系统提示词 | 可在不破坏 KV Cache 的前提下修改系统提示词，需模型显式声明支持 | LLM 路由 |
| 实验性右侧 Sidebar | 多标签、分栏与全屏；聊天文件链接与产出文件可在 Sidebar 打开，原 Detail 面板移除 | Web UI、客户端资源 |
| 通用文件上传 | 任意类型文件与图片在同一预览区混排；后台上传支持进度、取消与会话切换续显，模型按已保存路径用现有文件工具读取 | 附件 |
| 出站代理 | 所有出站网络请求遵循启动环境中的 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY、NO_PROXY | 环境变量 |
| 工作区文件 API | 新增 packages/api/workspace-files，Web/插件按工作区读写文件 | 工作区文件 |
| Web 顶栏「在应用中打开」 | 用已安装的编辑器、IDE、终端或文件管理器打开 Workspace | Web UI |
| 子代理会话操作 | 可继续对话的子代理支持消息排队、编辑、删除、单条或全部 Steer，以及停止 | 子 Agent |
| PTC 输出展开 | PTC 模式下可展开查看命令及其输出 | 工具执行 |
| 模型探测 | 支持自定义模型提供商的 models 对象与 Anthropic 原生模型列表，回填名称、上下文窗口与最大输出 token；升级 pi-ai 到 0.85.1 | LLM 路由 |
| 子代理插件运行时 | 可选子代理插件的内置运行时升级至 Codex 0.153.4 与 Claude Code 2.1.263；显式模型配置保持不变 | 子 Agent |
| 界面与统计 | 输入框菜单层级、提示文字与间距改善；会话统计拆为两个可展开摘要（轮次与速度、精确 Token 用量与缓存命中）；内置斜杠命令说明支持中文并随界面语言即时更新 | Web UI |
| Python SDK | 新增 macOS x64 runtime wheel，可在 Intel Mac 上安装随包 runtime | 程序驱动 Harness |
| 修复 | 发送按钮与 Enter 行为统一（繁忙时按设置排队或插话）；目标暂停后模型不能自行恢复；模型回复中 POSIX 绝对路径图片可显示；拒绝空消息与空白队列编辑；项目根目录发现的权限/IO 错误改为直接报告；macOS/Linux 的 fs-ext 不再需要本地编译 | 相关页面 |
官方文档地图
以下链接直接指向官方中文原文，英文文件与其并列：
选择安装渠道
继续使用已发布 npm 版（latest 通道）：
npx @deepseek-ai/dsh@0.1.2-rc.1 web
npm view @deepseek-ai/dsh dist-tags --json
想用本文的源码版能力，在独立目录检出已知 tag：
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
git checkout --detach dsh-v0.1.5-alpha.1
pnpm install
pnpm run build
pnpm dsh web
跨版本升级已有安装时，先清掉上一版的构建残留（packages/*/* 下没有 package.json 的目录、全部 lib/、全部 *.tsbuildinfo），否则 tsc -b 会因陈旧增量缓存跳过产出。不要把源码 tag 当成已经发布的 npm 版本；下一次升级前重新查询 registry。SDK 的客户端与运行时也应采用匹配版本。
升级检查
备份、独立验收与回退操作见 版本升级与迁移指南。升级后可按 GitHub PR 自动审查 和 MCP 长期记忆 验证可选能力。
- 先备份会话数据：V3 迁移保留原日志文件，但升级后的会话不支持降级读取；回退需要旧版本二进制与升级前的会话目录副本。
- 检查插件是否使用
ctx.agent、Inbox构造器、hasPending/claim，按上文破坏性变更表调整。 - 检查旧
code工具模式、API Proxy 导入与 SDKlaunch配置，按迁移页调整。 - 用
dsh web --dump-config核对实际组合，特别是 telemetry、WebFetch、模型选择和第三方插件。 - 源码 README / SECURITY 提醒项目尚未经安全审计；审批、权限预设与 sandbox 机制不等于隔离保证。先用不含敏感信息的测试目录，单独评估插件与数据出口。
如何跟进
官方 Releases 记录发布变化；Discussions 用于交流反馈。本站 插件生态 是社区目录，不代表官方背书。