[Show and tell] dsh-handbook：DeepSeek Harness 新手教程白皮书（中英双语 + PDF + demo）

[Electricitysheep]

🚀 社区发布：dsh-handbook —— DeepSeek Harness 新手教程白皮书（中英双语 + PDF）

作为 dsh 生态的早期参与者，我整理了一份从 0 到 1 的新手教程白皮书，填补官方文档之外的入门路径：

一句话概括

《DeepSeek Harness 从 0 到 1——官方开源 Agent 运行时的新手百科全书》

仓库

https://github.com/Electricitysheep/dsh-handbook （dsh-plugin / documentation topic，MIT）

内容（7 章，全部命令实测验证）

1. 认识 dsh（架构、与 Claude Code 差异、生态定位）
2. 五分钟快速上手（web / headless / 模型与推理档位）
3. profile 与插件系统（扩展点 + 真实踩坑）
4. 插件开发实战（完整代码：agent/request waterfall + 纯函数决策 + 测试）
5. 实战案例（三个真实开源 PR 拆解）
6. 进阶与性能调优（reasoning_effort 策略、耗时分析）
7. 生态与资源

附加

• 📺 30 秒图文 demo（真实运行截图）
• 📄 中文 PDF 完整版（1.25MB，仓库内可直接下载）
• 🌏 英文版 README 已就绪（章节英文翻译进行中）
• ⚡ 配套社区插件 dsh-tool-turbo（工具调用提速）

为什么做这个

官方 CONTRIBUTING 明确鼓励社区写教程与生态项目。白皮书是 dsh 生态的第一份系统中文教程——希望帮助更多开发者快速上手，也欢迎 issue 指正（rc 版本迭代快，命令如有失效请反馈，我会持续更新）。

[Electricitysheep]

📈 白皮书 v1.2 更新 + 同模型多 Agent 实测数据

白皮书持续迭代中（https://github.com/Electricitysheep/dsh-handbook），本轮更新：

新增内容

1. 📊 同模型 × 不同 Agent 实测对比（附录 benchmark 章节）——统一 deepseek-v4-flash + 同一网关 + 同一 key，对比 dsh / opencode / omp 三个 Agent 的工程层差异：

Agent	总耗时（3 任务）	正确率
omp	31s	3/3
dsh	49s	3/3
opencode	87s	3/3

结论：同模型下正确率持平，差异在效率；复杂任务差异放大至 3.8x。多轮采样数据补充中。

2. 🎨 README 标杆化：顶部横幅、30 秒 demo 直接内嵌（Web UI/Headless/Git 面板真实截图）、dsh vs 主流 Agent 能力矩阵、9 个 topic 推流。

3. 🌏 双语：第 1 章中英对照，英文版章节持续翻译中。

4. 📄 PDF 完整版：7 章 + benchmark 附录，45k 字符，仓库内直接下载。

欢迎

• 觉得有帮助点个 Star ⭐
• 有改进建议/命令失效反馈 → GitHub issue
• 想参与英文化/benchmark 扩展 → 见第 7 章

[Electricitysheep]

📈 白皮书 v1.5：真实复杂案例 + 英文版推进

仓库：https://github.com/Electricitysheep/dsh-handbook（10 章 + 2 附录 + PDF，68k 字符）

新增：真实复杂实战案例（dsh 跑出来的）

案例	领域	耗时	结果
数据清洗+可视化	数据分析	186s	52→35 行归零 + chart + 权衡说明
5-bug 修复+49 测试	软件工程	94s	pytest 49 passed
HTML 解析（新增）	Web 前端	进行中	—
代码重构（新增）	工程	进行中	—
API 文档生成（新增）	文档	进行中	—

全部合成数据（隐私安全），每个案例含产物/验证/耗时——"亲历者"视角的差异化内容。

生态联动

• 已提交到 2 个 awesome 列表（官方 awesome-deepseek-agent PR#378 + e2b awesome-ai-agents PR#1394，29k★）
• 英文版章节持续翻译中（第 3-10 章后台进行）

欢迎 Star / issue / 翻译贡献。

[Electricitysheep]

📈 白皮书 v1.6：5 个真实复杂案例 + 行业标准打磨 + 英文版

仓库：https://github.com/Electricitysheep/dsh-handbook（13 章节，中文 109k 字符 / 英文版已出）

真实复杂案例（dsh 全部真实跑出，合成数据）

案例	领域	耗时	验证
数据清洗+可视化	数据分析	186s	52→35 行 + chart
5-bug 修复+49 测试	软件工程	94s	49 passed
HTML 解析	Web 前端	3m18s	CSV 逐字段一致
代码重构	工程	4m37s	17/17 PASS（含脚本级产物对比）
API 文档生成	文档	1m04s	423 行全覆盖

案例亮点：dsh 会做工程权衡（零依赖、沙箱感知、向后兼容、契约差异识别）——这是"能答"与"能干活"的分水岭。

行业标准打磨

• 每章新增 TL;DR + 动手练习 + FAQ（第 3-10 章，+35k 字符）
• 第 1 章新增 mermaid 架构图
• 新增学习路径（3 天从 0 到 1，每日目标+验收）

中英双语

• 中文 PDF 3.9MB（109k 字符）· 英文 PDF 1.2MB（54k 字符）
• 第 3-10 章英文翻译完成

欢迎 Star / issue / 翻译贡献。