learn
DeepSeek Harness 指南：安装、配置与插件开发
一份面向用户与插件开发者的实用指南：跑起来、搞懂 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 是什么，以及五分钟跑通第一次。
什么是 DeepSeek Harness？
Agent = Model + Harness 的思路、Profile 与 Patch、Preset 与四种模式。
什么是 dsh 插件？
dsh 插件到底是什么、能改动什么、插件树如何组装。
快速上手：5 分钟跑通 dsh
安装 DeepSeek Harness、启动 Web UI、完成第一个任务、选对模式。
DeepSeek Harness：10 步全流程导览
从 git clone 到 headless 模式——安装、接服务商、配预设、Creator 模式造插件、沙箱与轨迹收据，一篇导览走完。
从需求到交付:用 DSH 做完一个真实项目
完整交付流程:需求拷问落成 CONTEXT.md 与 ADR,整理成 PRD,拆成 GitHub 任务单,再逐单开发、合并、真机验收。
DeepSeek Harness 子代理与多智能体实战
一次拉起五个子代理并行干活：会话头部逐个监控、完成报告逐个读、按子代理指定模型，截图逐步对齐
dsh 会话回放与复盘
打开执行轨迹面板、读懂结构化回执、按轮次定位失败，再从任意一步分支重跑，截图逐步演示
DeepSeek Harness Windows 安装教程
10 步实机截图安装教程:Node.js、npm 全局安装、3080 端口的 Web UI、API key,Win10/11 免 WSL。
Mac 安装 DeepSeek Harness
截图逐步验证的 macOS 装机实测教程：一条 npx 命令，不需要 API key，第七步接好服务商。
DeepSeek Harness Linux 安装教程
逐帧核对的 Linux 安装教程：Node.js、一条 npx 命令、服务商配置，另附 Windows 用户的 WSL 章节。
DeepSeek Harness 桌面版：官方 vs 社区
官方 Web UI、DSHDesktop 等社区客户端，以及一份安全下载清单。
Ollama 与免费模型
把 DeepSeek Harness 指向 OpenRouter 免费模型或本地 Ollama 服务，不用付费 API key 也能跑会话。
切换模型与自定义 Provider
会话中途换模型、接入 NVIDIA NIM 或 Ollama 自定义 Provider，并验证自己到底在和哪个模型说话。
dsh 用量与费用统计
看懂逐请求用量收据、用 Trajectory 找上下文大户，再用模型降档和统计插件把费用打下来。
升级 DSH 与插件
经过核实的升级命令：查版本、升级 dsh CLI、在终端或 Web UI 插件市场更新插件，以及安全回滚。
dsh 插件卸载与清理
移除单个插件、卸载 dsh 本体、彻底清理 ~/.dsh 数据目录——全部对照真实终端输出核实。
手机远程控制 dsh
ngrok 内网穿透把 Web UI 挂上公网,在外面用手机连回家里的 Agent,免装 App,实测截图逐步对照。
四种模式：Standard、PTC、Minimal、Creator
每种 agent preset 包含什么、什么场景用哪种，以及怎么在 Creator 模式里做自己的 preset。
计划模式:/plan、审阅、批准
DeepSeek Harness 的 /plan 命令实测:橙色计划标记、exit_plan_mode 审批卡,以及和直接执行的区别,10 张截图逐步讲清。
dsh 对比 Claude Code
客观对比：开放程度、价格、模型自由度与可扩展性。
DeepSeek Harness 对比 OpenClaw
同为 MIT 开源，一个是自己组装的编码 Agent 运行时，一个是住在你聊天软件里的助手。六个维度对比，附明确结论。
DeepSeek Harness 对比 Cursor
编辑器对 Harness 的诚实对比：价格、模型自由度、插件生态，以及两者搭配使用的方式。
DeepSeek Harness 对比 Gemini CLI
免费百万 token 上下文对上「模型即插件」的运行时：六个维度对比、选型结论，以及两个一起用的方法
免费 Claude Code 替代品
不花钱的开源 agentic coding 工具盘点，以及 dsh 的位置。
插件 vs 技能:区别在哪
一个替换 harness 能力,一个教 agent 做事。对照表 + 实机截图 + 两个完整实例,一次分清。
技能安装实操指南
从 mkdir 到 trajectory 回执的 7 步实测:建 .dsh/skills、写 SKILL.md、确认目录注入——全程无需重启。
最值得装的 dsh 技能推荐
哪些 skill 值得装、装完能干什么，逐个实测演示，附启用步骤
用 DeepSeek Harness 搭 AI 小说工作台
一条命令装上三栏创作台:大纲推演、正文写作、角色追踪与去 AI 腔审校——草稿全部存在本机。
小说一键改短剧,分镜自动生成
把小说拆成多集短剧,自动写对白与反转,逐镜头生成分镜和 Midjourney/视频模型提示词,导出结构化数据对接下游制作。
配置与开发
Profile、Preset，以及写自己的插件。
Profile、Patch 与 Preset
一个 dsh 进程如何由层层配置组装而成——以及怎么把它调成你的形状。
打造自定义 DSH Agent 预设
用创造模式设计专属的 DeepSeek Harness 预设：配插件、批准写入、一键切换工作台——逐帧核实的实战教程。
插件开发入门
Cordis 插件怎么写、怎么发布、怎么进目录 —— 附官方锚点。
动手写你自己的 DSH 插件
完整开发实录：最小契约、Config Schema、profile 安装，外加 MCP Apps 实测演示验证插件真的能跑。
故障排查与报错百科
症状 → 原因 → 修复：安装失败、pnpm workspace allowlist 报错、cordis.patch.yml 冲突、bundle 格式错误与 Profile 不生效。
安全与生态
沙箱、值得信任的插件，以及更大的 dsh 世界。
沙箱、审批与密钥
dsh 的安全模型：沙箱三档、审批策略、守卫，以及你的密钥去了哪里。
安全地安装插件
dsh 里“安装插件”到底发生什么，附一套第三方代码审查清单。
必装插件清单
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。
dsh 插件生态盘点
官方包、社区组织、dsh-plugin topic，以及本 DeepSeek Harness 插件市场如何保持新鲜。
插件 API 与 RSS
公开的只读 JSON API 和 RSS 订阅源,查询完整插件目录,无需 API Key。
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 路线全自动；进精选清单还能获得分类和人工撰写的描述。
阅读指南