dsh-handbook

项目详情摘要

DeepSeek Harness 白皮书 · dsh-handbook **DeepSeek Harness 中文手册 × 生态观察中心**——从 0 到 1 玩转 dsh，跟着 780 帖讨论区看懂生态 · 中文 · English 📖 在线阅读 · 📄 下载 PDF · ⭐ 点 Star 支持** · 15 章手册 · 195 帖社区响应 · 280+ Stars** [!WARNING] dsh 当前 GitHub 版本为 `v0.1.3-alpha.1`（预发布 tag；npm 已发布线 `0.1.2-rc.1`），生产环境请谨慎评估，详见 ℹ️ 版本说明。 🚀 快速体验（30 秒） 想系统学？看 🗺 学习路径（3 天计划）；想先跑？第 2 章：五分钟快速上手；想速查？📇 一页速查卡 30 秒看懂 dsh Web UI ：新建会话 → 输入任务 → 模型选择 → 发送 → AI 回复 🎯 这是什么 DeepSeek Harness（`dsh`）**是 DeepSeek 官方 2026-08-13 开源的 Agent 运行时——一个"一切皆插件"（everything is a plugin）的框架。 但官方文档以架构说明为主，**缺少一条从零上手的路径**。 这本白皮书补上这条路**：从"什么是 Agent 运行时"讲起，到安装、使用、开发插件、性能调优——每一章都有可复制、可运行的命令，全部在本机实测验证。**目标是：任何一个开发者，跟着这本书都能从 0 到 1 用起来、写起来。** 为什么值得读（而不是只看官方文档） 官方文档 | 本白皮书| 架构视角（AGENTS.md / architecture.md） | **新手视角**：一条从 0 到 1 的路径| 零散示例 | **每章可运行**，命令全部实测| 无中文教程 | **中文优先**，英文同步| 无生态实操 | **真实插件/PR 拆解**（含踩坑与安全约束）| 🎁 这本能给你什么 如果你是… | 你会得到 | 🆕 **第一次接触 dsh** | 3 天从 0 到 1 学习路径（每天有目标+验收） | 🛠 **开发者** | 可克隆的插件模板 + 配置参考大全（照抄能跑） | ⚖️ **正在选型** | 6 个主流 Agent 对比（表格+文字）+ 同模型实测 benchmark | ⚡ **要调优** | 推理档位策略 + 缓存命中率专题（实测 97%） | 📚 **要案例** | 5 个真实复杂案例（含耗时/产物/验证） | 🌟 感谢与社区 首先要感谢每一位 Star、回复和投稿——这本手册不是一个人的作品，是 dsh 社区一起"长"出来的。 发布两天，很幸运得到了这些反馈： ⭐ **280+ Stars**——对一份刚发布的教程来说远超预期，感谢大家认可 💬 **官方库 195 帖回应**——我们持续在讨论区和大家一起踩坑、排障、交流 🧠 **FAQ 里的 39 条问题大多来自真实提问**——社区问什么，我们沉淀什么（#380/#817/#1052…） 📦 已向 awesome-dsh-plugin 提交收录 PR（#33，待合并）；阮一峰周刊自荐已提交 🤝 与 30+ 社区项目互链（dsh-usage / dsh-sgme / AgentSoul / dsh-vault / egress-guard / agentmemory…） 内容随讨论区持续更新（沉淀流水线，19 项可追踪）。如果你觉得有用，Star 是对我们最大的支持。 🔭 生态观察（第 15 章·全景报告） 把 **1804 个插件仓库**的数据盘点 × **780 帖讨论区**定性观察交叉验证，5 个关键结论： 结论 | 一句话 | 🪟 **Windows 是第一痛点** | 中文路径（15+ 帖同根因）/ koffi / 端口 / 子进程——数据讨论双证实 | 🧩 **"官方没做，社区全做"** | 桌面壳 140+ / TUI / 记忆 77 / 视觉 132——健康互补 | 🛡️ **安全审计活跃，工具稀缺** | sandbox 分类仅 9 个插件——**供给缺口** | 🐛 **序列化 bug 家族** | unknown tool / reasoning 省略 / run_code