DeepSeek Harness 实战手册
用可运行的教程帮助开发者上手 dsh、开发插件并评估其适用性。
- Star 数
- ★ 942
- 最近更新
- 1 天前
- 主语言
- HTML
- FA 评分
- 54/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 第一次接触 dsh 的开发者，按三天学习路径安装并完成入门验收。
- 不适合
- 需要稳定生产版本的团队
- 源码审查
- 54/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
这是一本面向 DeepSeek Harness（dsh）的中英双语实战手册和生态观察资料，覆盖从入门到插件开发、性能调优、安全与成本。手册包含 15 章、附录和可克隆的插件模板，并提供在线阅读与中英文 PDF。示例围绕 dsh 的 Web UI 和 headless CLI 展开，也介绍 profile、插件扩展点、MCP、子代理及工作流。内容包含命令、案例和同模型多 Agent 基准测试，并说明测试环境与 dsh 的预发布状态。它适合希望评估或定制 dsh 的开发者；手册不是 dsh 运行时本身。
手册从 npx -y @deepseek-ai/dsh web 的安装与启动流程讲起，展示如何在浏览器访问 http://127.0.0.1:3080，或用 dsh --profile headless "任务" 执行一次性任务。它说明如何通过 package.json 添加插件依赖，并在 cordis.patch.yml 中挂载插件；第 4 章以 agent/request waterfall 为例讲解插件逻辑。后续章节介绍内置工具、上下文压缩、MCP 接入、并行子代理、工作流、安全与成本。案例和 benchmark 记录任务耗时、产物、验证方式及同模型下不同 Agent 的结果。
- 第一次接触 dsh 的开发者，按三天学习路径安装并完成入门验收。
- 准备扩展 dsh 的插件作者，使用模板并学习依赖添加、挂载和
agent/request扩展。 - 评估 dsh 是否适合团队工具链的工程师，阅读边界说明、案例和同模型 benchmark。
- 需要调试工具链速度或推理成本的用户，参考推理档位策略与缓存命中率实测。
- 审查 dsh 插件安全边界的维护者，使用沙箱章节和第三方插件审计清单。
如何安装或部署这个 Agent？
手册可在线阅读，也可下载中英文 PDF。若要跟随示例运行 dsh，README 要求 Node.js ≥ 22：
npx -y @deepseek-ai/dsh web该命令启动 Web UI；手册未在此处列出 API 密钥的配置步骤。
如何使用这个 Agent？
在浏览器打开 http://127.0.0.1:3080 开始对话。README 也记录了 headless 一次性任务方式：
dsh --profile headless "你好，请用一句话介绍自己"开发插件时，示例先在 package.json 添加依赖，再在 cordis.patch.yml 插入插件配置；随后在 profile 目录安装依赖并启动：
cd ~/.dsh/profiles/web && pnpm install && dsh web这个 Agent 有哪些优点和局限？
- 15 章覆盖安装、profile、插件开发、性能、安全、成本和生态观察。
- 提供可克隆插件模板，包含纯函数、waterfall 示例和测试。
- 包含复杂案例及同模型多 Agent benchmark，并给出耗时与验证信息。
- 中文优先并同步提供英文内容和双语 PDF。
- 手册说明 dsh 处于预发布阶段，版本迭代可能带来破坏性变更。
- 正文实测基于 Windows 11、Node 24 和特定 dsh/模型版本，其他环境的结果未在此材料中证明。
- dsh 对话按量付费；手册描述缓存折扣和成本工具，但没有提供固定总费用。
- 手册声称命令经过本机验证，但给出的材料无法独立核实全部测试结果。
这个 Agent 与同类方案有什么区别？
手册将 dsh 与 Claude Code、OpenAI Codex、OpenCode、Gemini CLI 和 Kimi CLI 作能力对比，并称 dsh 面向深度定制与生态扩展，Claude Code 等更适合开箱即用。它还记录了统一使用 deepseek-v4-flash 的五项任务测试：omp 为 70 秒、dsh 为 130 秒、opencode 为 172 秒；三者均完成 45/45 项。该结果来自手册所述的三轮采样中位数，不应视为所有任务或环境的普遍结论。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| DeepSeek Harness 实战手册 当前 | 54 · 缺口较多 | 网页应用免费 + 模型费 | ★ 942 | 1 天前 | HTML | — |
| AgenC Core | 74 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 107 | 今天 | TypeScript | — |
| OpenAI Agents SDK | 64 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 30k | 今天 | Python | OpenAI API |
| Orca | 59 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 512 | 1 天前 | Rust | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
材料清楚解释 sandbox、权限预设与审批的边界，并建议默认 workspace-write + ask、loopback 和插件来源检查，因此最小权限、确认机制及外部效果有实用覆盖；但插件可执行代码、可读工作区外文件、审批回环、明文会话残留和多项已知边界降低了敏感数据处理分数。依赖安全仅有插件来源建议，未见签名校验或依赖审计；回滚主要建议纳入版本控制，未给出通用恢复流程。来源以官方文档和社区讨论编号为主，发布者维护身份不清，因此归因仅部分充分。
文档提供安装问题、平台故障签名及排障办法，但中英文快速开始在 Node 最低版本、安装命令及部分能力表述上存在差异，README 评审材料也记录了表格列数与章节顺序问题，故自洽性偏低。依赖版本与 npm 发布线有说明，但仍处于 rc 阶段且存在插件依赖断裂报告，故可用性仅部分处理。失败提示和对应解决建议较具体，获得较高但非满分评价。
材料覆盖新手安装、Web、headless、CI、插件开发及团队安全基线，也明确说明沙箱不涵盖网络和进程、部分模式未逐项实测；但面向场景的触发条件主要是章节建议，缺少更精确的适用判定和能力选择规则。Node、Windows、WSL2 等环境差异及限制有一定说明。
手册章节、配置参考、快速开始、FAQ 和练习可支持日常查阅，但 README 评审指出首屏行动入口不足、重要卖点靠后、顺序和表格存在问题。安装说明较细，术语与命令大致稳定，已知限制覆盖充分；许可证元数据为 unknown，不能给分。版本信息提及多个 rc 与核验日期，却未见完整变更历史或明确维护责任，所以版本与维护项仅部分满足。
快速开始、配置示例、排障表和安全基线让读者能据此操作；手册宣称覆盖安装、插件、调优和实测案例，样本也展示了安全机制分析与插件示例测试，提供了超出官方架构说明的潜在增量价值。扣分在于 README 评审发现内容重复与关键信息排序不佳，且部分价值和实测结论在所给材料中只有陈述，尚不足以证明全面收益。
安全章节将若干说法关联到官方文档名称、社区讨论编号和仓库内研究报告，也把建议预设、推导场景及待实测项标为推断；因此事实与推断区分较好。中英文材料互相呼应，并给出多个来源类别，但提供的材料没有源代码或官方文档原文可供独立核对，交叉佐证和主张追溯只能部分充分。
- 将材料中的安全结论视为低置信度静态评估；章节注明部分社区报告来自 rc.6 时期，可能已变化。
- 安装前核对适用 Node 版本与 npm 发布线；插件是可执行代码，按来源和权限审查。
- 不要把 sandbox 当作网络或进程隔离，也不要假设 workspace-write 能阻止工作区内删除。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v1.8.0 dsh-handbook 白皮书 v1.8（15 章完整版）
发布说明摘录
DeepSeek Harness 白皮书 v1.8 15章节 · 附录 A/B/C · 中英双语 · PDF 全文可搜索（4.2MB） 本轮新增（v1.7 → v1.8） - 第 13 章 安全与沙箱模型：沙箱机制 / 权限模型 / 审批流 / 插件安全审计清单 / 企业安全基线（引用官方安全审计 #817） - 第 14 章 缓存与成本工程：缓存命中率实测 97% / 成本模型 / 推理档位联动 / 预算实战 / dsh-usage 工具推荐 - 附录 B 官方包速查大全：33 个核实包清单 + 能力域分组 - 讨论区反馈二次迭代：FAQ 收录插件六坑（#380 作者授权）/ 免装 Node 安装包 / 子代理模型缺口标注 - 英文版完整同步：14 章全双语 + README.en 全量同步 在线文档 https://electricitysheep.github.io/dsh-handbook/（侧边栏 + 全文搜索） 社区 - 官方库讨论区持续活跃（33 帖响应） - 社区案例征集中：跑过 dsh 真实案例？欢迎投稿收录在 GitHub 查看 ↗ -
v1.7.0 dsh-handbook 白皮书 v1.7（未来展望版）
发布说明摘录
DeepSeek Harness 白皮书 v1.7 14 章节 · 中文 118k 字符 · 中英双语 PDF 本轮新增 - 第 11 章：未来展望——六角度演进预测（技术/生态/竞争/行业/机会/风险）+ 时间线（1-3 月 / 1 年 / 2-3 年）+ 给读者的建议 - 第 5 章：高缓存命中率专题（实测 97%，98% 缓存折扣成本分析）+ 行业视角（金融/教育/销售/运营/研究，含合规提醒） - 第 5 章英文版同步（应用场景版） 资产 - [中文 PDF](./DeepSeek-Harness-白皮书.pdf) - [英文 PDF](./DeepSeek-Harness-Handbook.pdf)在 GitHub 查看 ↗ -
v1.6.0 dsh-handbook 白皮书 v1.6（行业标准版）
发布说明摘录
DeepSeek Harness 白皮书 v1.6 13 章节 · 中文 110k 字符 · 中英双语 PDF · 5 个真实复杂案例 内容总览 - 学习路径：3 天从 0 到 1（每日目标 + 验收标准） - 第 1-2 章：认识 dsh + 快速上手（TL;DR + mermaid 架构图 + 练习） - 第 3-4 章：profile/插件系统 + 插件开发实战（完整代码） - 第 5 章：应用场景全景（5 大场景 + 高缓存命中率专题 + 5 行业视角） - 第 6-7 章：性能调优 + 生态资源 - 第 8-9 章：工具/上下文系统 + MCP/子代理/工作流 - 第 10 章：5 个真实复杂案例（数据清洗/修 bug/HTML 解析/代码重构/API 文档） - 附录：术语表 30+ 术语 + 命令速查 + 同模型 3 Agent benchmark 亮点 - 高缓存命中率专题（实测 97%，98% 缓存折扣的成本分析） - 每个案例含真实耗时/产物/验证（合成数据，隐私安全） - 同模型 × 不同 Agent 实测（omp 36s / dsh 85s / opencode 114s） 资产 …在 GitHub 查看 ↗
常见问题
这本手册本身是 Agent 吗？
运行示例需要什么？
npx -y @deepseek-ai/dsh web。README 未在快速体验步骤中说明 API 密钥配置。使用 dsh 是否完全免费？
现在适合直接用于生产吗？
手册包含哪些插件开发内容？
agent/request 扩展示例，以及安全约束和实测案例。