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 等社区客户端，以及一份安全下载清单。
一步步安装 DSH Desktop 桌面客户端
十三步截图实测：目录里 star 数最高的社区客户端——真实下载链接、macOS DMG 与 Windows NSIS 向导、首次运行，以及拿到文件后的四项核对。
Ollama 与免费模型
把 DeepSeek Harness 指向 OpenRouter 免费模型或本地 Ollama 服务，不用付费 API key 也能跑会话。
dsh 白嫖免费模型：OpenRouter 实战
跳过 DeepSeek 密钥，在设置里接入 OpenRouter 的 :free 免费模型，再用一个真实的 README 任务验收——逐帧截图攻略。
切换模型与自定义 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/视频模型提示词,导出结构化数据对接下游制作。
让 DSH 看懂图片：两种方式
路线一给 DSH 接上 GLM 视觉模型；路线二装免费的 dsh-vision-router 插件——贴一张截图，得到真正的回答。
把 DSH 接入微信和飞书
安装 dsh-im、扫一次二维码，就能在微信或飞书里和你的 harness 聊天——倒计时、手机端确认与机器人回复全程实录。
用 DSH 干办公活：一句话出 PPT
装好 dsh-univer-office，一句话要一份行情 PPT，看它调研、生成六页幻灯片、审阅合并并放映——全程实录。
一段提示词汇总 Excel 表格
三个部门费用表、1800 行数据：规则、映射与验收写进一段提示词，图文实录。
在 DeepSeek Harness 里玩小游戏
装上小游戏面板，等模型干活时来一局俄罗斯方块，顺手盯住账户余额。
不写代码，对话做出一个插件
一句话想法 → 共创规格 → 创造模式开发 → 版本审批：一个插件的完整诞生记。
把 dsh 部署到服务器 7×24 跑
十三步截图实测：从一台空 VPS 到常驻运行的 DeepSeek Harness——SSH 与浏览器终端、自定义模型和上下文窗口、不离开标签页装插件、构建结果直接给出公网链接。
把调好的流程做成可复用 dsh 技能
七步截图实测：从你刚调通的一套流程到 SKILL.md——文件放在哪、name、description、whenToUse 各写什么、以及怎么用埋一个假密钥来验证它真的生效。
定制你的业务 Agent：从需求到验收全流程
12 步实录：先写验收标准，再配插件、批一次权限，1800 行数据汇总逐项核对。
上下文压缩与长任务
80% 阈值、/compact 与工具结果裁剪如何配合，长会话不再失控
dsh TUI 终端上手
在终端里跑 dsh：profile 切换、SKILL 管理与后台任务同屏实录
语音插件双场景上手
对 AI 说：本地语音输入；听 AI 说：TTS 播报，两条线都有逐帧实录
dsh 怎么找插件（实拍图文）
插件市场、awesome 目录站、官方管理页——三条找插件路径逐帧实测
把 Obsidian 变成 dsh 知识库(图文)
API 密钥 → 工作区 → AGENTS.md 骨架 → 按库内文风写笔记,7 步接入实战,帧帧可回源
dsh + ComfyUI 全自动视频生成(图文)
提示词模板变成技能,ComfyUI 工作流出 15 秒竖屏大片,显存在后台自动释放——全程逐帧核对
dsh 渲染插件:让回答从能读到能看(图文)
raw-html 插件把纯文本回答变成 HTML 卡片、图表、动画与风格系统——可信模式的安全边界一并讲清
用小鲸鱼娘挂件盯住 dsh 余额
把 dsh-whale-widget 挂进 web profile，配好角落那个显示 DeepSeek 余额、今日已用和刷新倒计时的气泡。
用 AI 美化 dsh 界面
wallpaper-plugin 图文攻略：外观三态开关、预设工作室的图层合成壁纸，以及一句话让 AI 搓出明暗双模完整主题。
dsh 必装插件实操
必装清单图文版：把可搜索的市场装进管理面板，用星标和脚本审计做甄别，再上手视觉、侧边栏与后台任务插件——每步都有逐帧核对的截图。
可验证的架构图
让 agent 画出能拿去评审的系统图，而不是一次性的草图：装好 archify skill，一句话下需求，然后读完 9/9 校验报告再决定信不信这张图。
dsh 创造模式：对话造自定义 Agent 预设
从预设下拉到沙箱审批、挂载校验，再到咖啡店经营分析与 Excel 公式核验——创造模式全流程图文，9 张帧级核对截图。
配置与开发
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 不生效。
给 DeepSeek Harness 接入 MCP 服务器
把 MCP 接进 dsh：Claude Code / Codex 字段对照怎么迁移、注册好的服务卡长什么样、要粘贴的 mcpServers 配置，以及 dsh 会话真正调用高德地图 MCP 的实录。
安全与生态
沙箱、值得信任的插件，以及更大的 dsh 世界。
沙箱、审批与密钥
dsh 的安全模型：沙箱三档、审批策略、守卫，以及你的密钥去了哪里。
安全地安装插件
dsh 里“安装插件”到底发生什么，附一套第三方代码审查清单。
必装插件清单
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。
dsh 插件生态盘点
官方包、社区组织、dsh-plugin topic，以及本 DeepSeek Harness 插件市场如何保持新鲜。
插件 API 与 RSS
公开的只读 JSON API 和 RSS 订阅源,查询完整插件目录,无需 API Key。
中文系统教程
中文系统教程
社区沉淀的系统性中文学习资源，配合本站教程一起看：从零理解 DeepSeek Harness 的概念、安装与插件体系。
系统中文教程仓库
ht426 维护的系统性中文教程仓库：从安装、核心概念到插件体系逐章推进，适合从头系统学。
阅读指南保姆级理解教程
JingHao-Leon 的保姆级理解教程：用大白话讲清 DeepSeek Harness 的心智模型与上手路径，新手友好。
阅读指南DSH 蓝皮书文档站
dsh.hicyou.com 蓝皮书文档站：功能速查、实践笔记与进阶用法，随版本持续更新。
阅读指南DeepSeek Harness：10 步全流程导览
从 git clone 到 headless 模式——安装、接服务商、配预设、Creator 模式造插件、沙箱与轨迹收据，一篇导览走完。
阅读指南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 路线全自动；进精选清单还能获得分类和人工撰写的描述。
阅读指南