信息卡

一句话定位

社区撰写的 DeepSeek Harness（dsh）从认知、安装、插件开发到调优的中文深度手册，含中英双语 PDF，自称所有命令均经实机验证。

走红原因分析

时机是最大变量：dsh 是 DeepSeek 于 2026-08-13 开源的新一代 Agent 运行时（"一切皆插件"），官方文档偏架构向、缺少新手路径，本手册在开源当日同步发布填补真空，两天即获 280+ Star；内容密度罕见——15 章加三附录覆盖 60+ 能力包地图与 1804 插件生态交叉验证；"生态观察中心"的定位让它超越普通教程，成为 dsh 社区的事实信息枢纽；双语 PDF 130k+ 字符的诚意也拉动了收藏与转发。

核心功能拆解

• 入门线：第 1 章 Harness 认知与主流 Agent 对比、第 2 章五分钟上手；
• 开发线：profile 与插件系统解析、插件开发实战（模板含 waterfall+测试）；
• 实战线：5 大应用场景加行业视角、性能调优（推理档位降档为最高杠杆提速）；
• 生态线：工具与上下文系统 60+ 能力包地图、MCP/子代理/工作流；
• 进阶案例：数据清洗管线 186 秒完成、5 个 bug 并行修复 94 秒；
• 全景报告：第 15 章基于 1804 插件×780 帖交叉验证，总结 Windows 第一痛点、sandbox 插件供给缺口等五大结论并提出六个"能力缝"；

7. 附录：30+ 术语表、官方包速查、Benchmark；另有三天学习路线图与速查卡。

架构与技术栈浅析

本体是 Markdown 文档仓库渲染站点，配 Mermaid 图；dsh 本身为 TypeScript、MIT、模型无关。手册重点拆解了 dsh 的 host/client 双半结构（一个 npm 包同时供 Node 工具侧与浏览器 UI）、profile=package.json+cordis.patch.yml 的两行挂载模型、agent/request 等 5 大扩展点，以及 bwrap/Landlock/Seatbelt 进程级沙箱机制。

安装与环境要求

阅读手册本身零依赖；若按手册实操 dsh，需 Node.js ≥ 22，执行 `npx -y @deepseek-ai/dsh web` 后访问 http://127.0.0.1:3080 。手册特别警示 dsh 处于 0.1.0-rc 预发布阶段，生产需谨慎。

快速上手示例

按手册路线：五分钟跑通 web 对话 → 试 headless 单次任务 `dsh --profile headless "你好"` → 在 settings.yaml 设 `agent-default-model` 与推理档位（off/high/max）→ 克隆 examples/plugin-template 模板开发首个插件 → 锁定 `^0.1.0-rc.6` 版本线避开 rc.1 依赖断裂坑。

进阶使用要点

用实测缓存数据省钱：会话缓存命中率约 97%，Flash 折扣近 98%；Benchmark 显示同模型下 omp 最快（70s）、dsh 居中（130s）、opencode 172s，正确率均满分，选型看效率偏好；关注作者标出的能力缝（视觉通道、记忆 seam、Windows 一等支持等）判断生态投入方向。

典型应用场景

• 新用户快速入门 dsh 并规避 rc 版本坑；
• 团队评估 dsh 与竞品的效率/成本基线参考；
• 插件开发者查阅扩展点速查与社区优秀插件清单（awesome-dsh-plugin 收录 122+）；
• 中文社区追踪 dsh 生态演进的观察站。

同类生态位对比

同期出现 vibeinging/dsh-desktop（P087，图形桌面发行版）走产品化路线，本手册走知识基础设施路线，两者互补不冲突；相比官方文档只讲架构，手册补齐了上手指引、调优配方与生态地图，角色类似早期 Next.js 中文实战书之于官方 docs。

资源导航

README 提供在线阅读地址、中文版 PDF（约 5.5MB）与英文版 PDF（83 页）；docs/roadmap.md 三天学习计划、cheatsheet.md 速查卡；配套章节链接直达各章 Markdown；已向 awesome-dsh-plugin 提交 PR 并开放案例投稿。