这是一个面向中文开发者的 DeepSeek Harness（dsh）深度手册/白皮书项目，而不是 dsh 框架本体代码库。它提供在线文档、PDF、快速上手、插件开发、配置说明、性能调优、安全沙箱、成本缓存、生态观察和实测案例，目标是帮助开发者从零理解并实践 DeepSeek 官方 Agent 运行时 dsh。仓库主要以 HTML/文档形式组织，适合作为学习资料、选型参考和插件开发指南。
适用领域
AI Agent / LLM 应用开发 / DeepSeek 生态 / Agent Runtime / 插件系统 / MCP 与工具调用 / 自动化工作流 / AI 编程助手 / 性能调优 / AI 安全与沙箱 / 成本与缓存工程 / 中文技术文档
配置难度
中等。单纯阅读和按命令启动 dsh 属于低难度；理解 profile、插件系统、MCP、子代理、工作流、沙箱和性能调优需要一定 Node.js、TypeScript、LLM Agent 与工程化经验。对于中文开发者而言，该手册显著降低了入门门槛。
商业价值
未知
01
技术亮点
- 中文优先，适合国内开发者系统学习 dsh
- 覆盖从入门、安装、配置、插件开发到性能、安全、成本和生态的完整链路
- 提供 15 章内容、速查卡、FAQ、学习路径、配置参考和插件模板
- 强调实测命令和可复制实践，而不仅是架构说明
- 包含 dsh 与 Claude Code、Codex、OpenCode、Gemini CLI、Kimi CLI 等主流 Agent 工具的对比
- 对 dsh 生态进行了较系统的观察，包括插件仓库、社区讨论、Windows 痛点、安全缺口和成本工具需求
- 覆盖 Web UI 与 headless CLI 两种使用方式
- 包含插件开发中的扩展点、waterfall、host/client 双半结构、settings、ctx.provide 等关键概念
- 对性能调优有明确建议，例如根据任务复杂度调整 reasoningEffort
- 安全章节提到沙箱、权限、审批流和第三方插件审计清单，对工程落地有帮助
02
目标用户
- 第一次接触 DeepSeek Harness / dsh 的中文开发者
- 希望快速搭建 AI Agent 运行环境的工程师
- 想开发 dsh 插件的 TypeScript / Node.js 开发者
- 正在对比 Claude Code、Codex、OpenCode、Gemini CLI、Kimi CLI 等 Agent 工具的技术负责人
- 关注 DeepSeek Agent 生态早期机会的独立开发者或创业团队
- 需要在 CI、脚本、自动化任务中接入 Agent 能力的 DevOps / 平台工程师
- 关注 Agent 安全、沙箱、权限审批和插件审计的安全工程师
- 想系统了解 dsh 配置、profile、bundle、cordis.patch.yml 的用户
03
配置要求
- Node.js >= 22
- 需要可用的 dsh 包：@deepseek-ai/dsh
- 需要配置 DeepSeek 或其他兼容模型服务的访问凭据，具体取决于所使用的 LLM 插件/适配器
- 常见配置文件包括 settings.yaml、package.json、cordis.patch.yml
- 模型默认配置示例：agent-default-model.model 可设为 deepseek-v4-flash 或 deepseek-v4-pro
- 推理档位 reasoningEffort 可配置为 off/high/max；README 中也提到部分实测网关使用 low/high/max
- 插件开发通常需要 pnpm、TypeScript/Node.js 生态基础
- Windows 用户需要额外注意中文路径、koffi、端口占用、子进程、依赖安装等问题
- 生产环境需要重点评估 dsh 仍处于 0.1.0-rc.6 预发布阶段带来的兼容性和稳定性风险
04
适用场景
- 按照 3 天学习路径从零上手 dsh
- 使用一条命令启动 dsh Web UI 进行对话体验
- 通过 headless 模式在脚本或 CI 中执行一次性 AI 任务
- 学习 dsh 的 profile、bundle、插件挂载和配置机制
- 基于示例模板开发自定义 dsh 插件
- 评估 dsh 与 Claude Code、Codex、OpenCode、Gemini CLI、Kimi CLI 等工具的差异
- 参考性能调优章节选择 reasoningEffort 档位，降低工具链任务耗时
- 参考缓存与成本章节估算 DeepSeek 模型调用成本
- 了解 Windows、端口、依赖、序列化等常见踩坑点
- 根据安全章节对第三方插件进行基础审计
- 参考复杂案例构建数据清洗、Bug 修复、报表生成等多步 Agent 工作流
05
部署与配置
- 如果只是阅读手册，可直接访问在线文档：https://electricitysheep.github.io/dsh-handbook/
- 也可以从 GitHub Releases 下载中文或英文 PDF 离线阅读。
- 如果需要体验手册中介绍的 dsh，需要先安装 Node.js，版本要求 Node.js >= 22。
- 启动 dsh Web UI：npx -y @deepseek-ai/dsh web
- 浏览器打开 http://127.0.0.1:3080 开始对话。
- 运行一次性 headless 任务：dsh --profile headless "你好，请用一句话介绍自己"
- 如需插件开发，参考 examples/plugin-template/，并在对应 profile 的 package.json 与 cordis.patch.yml 中挂载插件。
- 插件本地挂载后通常需要进入对应 profile 目录执行 pnpm install，然后重新启动 dsh web。
06
风险与注意事项
- 该仓库主要是文档/手册，不是 dsh 框架源码；如果用户想找核心实现，需要访问 DeepSeek Harness 官方仓库。
- dsh 当前标注为 0.1.0-rc.6 预发布阶段，API、依赖、配置和插件接口可能发生破坏性变化。
- README 中出现较多生态数据、实测结论和社区统计，实际有效性需要结合原始链接和最新官方状态复核。
- 仓库元数据 license 为空，但 README badge 显示 CC-BY-NC-SA-4.0，许可证信息存在需要确认的地方。
- 如果用于商业内部培训或二次分发，需要注意 CC-BY-NC-SA 可能包含非商业和相同方式共享限制。
- Windows 兼容性是 dsh 生态当前重点痛点之一，中文路径、依赖、端口、子进程等问题可能影响上手体验。
- 安全沙箱和插件生态仍处于早期阶段，第三方插件不可默认信任。
- README 中提到的模型名、版本号、缓存折扣、生态数量等可能随时间快速变化，需要以官方最新文档为准。
- 手册内容较多，初学者如果不按学习路径阅读，可能被 profile、bundle、cordis、MCP、workflow 等概念淹没。
2026-08-20
第28名
新收录 · github_search
