learn
DeepSeek Harness 指南（dsh guide）
一份面向用户与插件开发者的实用指南：跑起来、搞懂 Profile 与 Preset、安全地装插件、自己动手写一个。
全局安装、以 web profile 启动，然后在网页端填上 API key——环境变量里已有则跳过。除此之外，一切都是插件。
这份 dsh guide 讲什么
DeepSeek Harness（dsh）是 DeepSeek 开源的智能体运行时：模型是大脑，Harness 是身体，而身体的每一部分都是插件。这份 DeepSeek Harness 指南就是那本缺失的说明书——不讲营销话术，只讲它到底怎么组装、怎么运转。
第一次来建议按顺序读，也可以直接跳到需要的章节。
- /01跑起来 —— 安装、第一个任务、四种模式
- /02看懂组装 —— Bundle、Profile、Patch、Preset
- /03用得安全 —— 沙箱三档、审批、密钥
- /04融入生态 —— 找插件、装插件、发布插件
guides
从这里开始
Harness 是什么，以及五分钟跑通第一次。
配置与开发
Profile、Preset，以及写自己的插件。
faq
常见问题
大家搜 DeepSeek Harness 指南时最想找的短答案，都在这里。
DeepSeek Harness 是什么？
DeepSeek Harness（dsh）是 DeepSeek 开源的智能体框架：把模型变成能读写文件、执行命令、联网搜索的智能体的那一层运行时。它的核心理念是“一切皆插件”——工具、模型接入、UI，甚至主循环，都是插件。
阅读指南DeepSeek Harness 免费吗？
Harness 本体开源（MIT）。模型调用是另一回事：你接入自己的供应商（比如 DeepSeek API），由对方按 token 计费。社区插件大多也开源，安装前看下每个仓库的许可证。
怎么安装？
全局安装 CLI（npm install -g @deepseek-ai/dsh），然后运行 dsh --profile web 打开网页端，在页面填上 API key——环境变量里已有则跳过。另外还有 headless CLI、Python / TypeScript SDK 和 ACP 服务端。
阅读指南dsh 插件怎么装？
在 dsh 里，“安装”通常是在你的 Profile / Patch 配置里加一行——每个插件的 README 都写了自己的安装方式。插件随之进入插件树，删除这一行就整体卸载，不留残余。
阅读指南dsh 就是 Claude Code / Codex 吗？
不一样。Claude Code 和 Codex 交付的是开箱即用的智能体；DeepSeek Harness 交付的是一套由你组装的智能体运行时，任何部分都能被插件替换或扩展。同类工具，两种思路。
怎么让我的插件被这个目录收录？
给公开仓库加上 dsh-plugin topic，并向本目录同步来源的社区清单提交 PR。topic 路线全自动；进精选清单还能获得分类和人工撰写的描述。
阅读指南