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 命令行速查表
安装启动、模式对照、插件管理、配置检查、版本固定——每条值得放在手边的 dsh 命令，逐字对照官方文档核实。
从需求到交付:用 DSH 做完一个真实项目
完整交付流程:需求拷问落成 CONTEXT.md 与 ADR,整理成 PRD,拆成 GitHub 任务单,再逐单开发、合并、真机验收。
DSH 任务看板：dsh-graph 与 cron 任务板
目标泳道、判据先行、worktree 派发、评审收据与发布门禁，再加五列 cron 任务板的独立验收——11 帧逐帧核实。
可视化你的 dsh 上下文窗口
dsh-context 插件实录：构成模态框、逐请求趋势图，以及给上下文每个组成部分标价的请求浏览器。
DeepSeek Harness 子代理与多智能体实战
一次拉起五个子代理并行干活：会话头部逐个监控、完成报告逐个读、按子代理指定模型，截图逐步对齐
dsh 会话回放与复盘
打开执行轨迹面板、读懂结构化回执、按轮次定位失败，再从任意一步分支重跑，截图逐步演示
dsh 会话备份与迁移：隔离 lane 实操
把 dsh 安装克隆成带独立 HOME 和端口的隔离 lane，副本验收后再就地升级，对话按 lane 备份——7 张逐帧核对截图。
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 找上下文大户，再用模型降档和统计插件把费用打下来。
省 token：dsh-ops 实测
dsh 长任务为什么烧掉百万级 token，dsh-ops 加 PTC 模式改了什么，带条件的 27 倍对比——逐帧实录。
升级 DSH 与插件
经过核实的升级命令：查版本、升级 dsh CLI、在终端或 Web UI 插件市场更新插件，以及安全回滚。
dsh 插件卸载与清理
移除单个插件、卸载 dsh 本体、彻底清理 ~/.dsh 数据目录——全部对照真实终端输出核实。
手机远程控制 dsh
ngrok 内网穿透把 Web UI 挂上公网,在外面用手机连回家里的 Agent,免装 App,实测截图逐步对照。
DSH Web UI 从启动到手机
dsh web 一条命令启动网页版，吃透 3080 工作台、斜杠技能与模型设置，再用 dsh-web 生态把手机接进来——9 步实测截图
局域网访问与端口
为什么 http://<你的IP>:3080 只有本机能打开，--port 怎么用，以及用 dsh-LAN 插件把 Web UI 连防火墙一起开放给手机。
dsh-pocket：把 DSH 装进口袋
电脑跑 dsh web，手机扫码即同屏：局域网直连或 Cloudflare 免费隧道，输出实时同步、手机可反向操作——7 张逐帧核对截图。
DSH 常见报错与修复实操
按报错现象对照排查：安装失败、插件导致启动崩溃、更新后异常，全部步骤配真实录屏截图，命令与官方 Discussions 交叉核对。
dsh 科研数据分析实战
101,766 行 EHR 数据集进，清洗、Cox 回归、期刊图表、Word Results 章节出——逐帧核对截图。
DeepSeek Harness 回滚后悔药：一键撤回与存档点
安装 dsh-undo-savepoint，用 WebUI 按钮、Ctrl+Alt+Z 或对话触发撤销，快照管理与崩溃救援全图解。
dsh-dafeiyu：给 DeepSeek Harness 装一只大肥鱼桌宠
一条命令装好大肥鱼桌宠，跟着智能体的真实任务状态变动作——逐帧核对的图文攻略。
dsh 换皮肤：client ui 主题安装与定制化
dsh 网页界面换肤图文教程：一键安装流萤主题皮肤，或用 dsh-client-ui-custom 自定义壁纸、毛玻璃与六套预设，改动即时生效，附一键还原命令。
dsh 本体升级：更新、验证与回滚
插件更新指南的本体篇：查版本、一条 npm 命令升级、读懂 changed packages 回执，出问题用固定版本号装回去。
dsh 酒馆插件 dsh-tavern:把 SillyTavern 搬进 dsh
人物卡 PNG/JSON 直导、开局选剧本、Guide 引导、单轮重写、一键生图,再到 /debug-card 自助调试——12 张帧检截图,每步深链回源视频。
dsh 记忆插件 meow-memory:给 dsh 装上长期记忆
一条命令安装 meow-memory,图文拆解首轮整块注入、memory_* 工具自动调用与 dream 空闲整理,附四款插件选型与 mnemon 费用坑——8 张帧检截图,每步深链回源视频。
dsh QQ 机器人插件:把 dsh 接进 QQ
两条路线、9 张帧检截图:dsh-im 插件扫码接入 QQ 等 9 大平台,NapCat 协议端跑群级 bot——每一步都深链回源视频。
dsh agent loop 详解
一次 dsh 对话到底怎么跑:turn 生命周期、插件拦截点,以及防止会话失控的 loop guard。
dsh 系统提示词是怎么装配的
拆解 DeepSeek Harness 每轮注入的系统提示词：段落顺序、插件注入点、persona 挂钩，以及改造它的三类插件
dsh skill 安装实操
把 skill 放进项目级或全局目录，看懂调用开关，验证第一次加载——12 步逐帧实录
dsh 自动化任务实操
在对话里创建定时提醒，打开内置 Automation tasks 面板，看懂投递记录——10 步逐帧实录
DSH 工作状态外显：任务栏状态灯与完工通知
任务栏三色灯实时映照 agent 状态，提问、干完活的第一时间弹窗与推送来找你——8 张逐帧核验截图。
dsh 装进 WSL 实操
跟着终端命令在 WSL 里装 dsh，或者用 dsh-wsl-workspace 插件跳过手动安装——两条路线一篇讲清
会话管理实操：归档、删除与批量操作
在桌面端侧栏找到会话入口，用内置面板归档恢复，再用 multiselect 插件批量选择——9 帧实录，每帧带时间戳
手机上跑 DSH：三条路线
扫码配对的原生客户端、逐帧实录的本地容器客户端，或终端加浏览器——按需选择移动路线，9 帧实录带时间戳
Agent 团队面板实操
把 AgentTeams 面板当运行手册读——成员状态、按代理配置工具、有界任务板与团队聊天——6 帧来自真实运行
dsh 科研插件实操：文献检索实战
安装文献检索插件、配置 Tavily API key、把中外文文献拉成带引用的阅读清单——12 步带时间戳深链
dsh 生图插件配置实操
把 MiniMax、DashScope、ChatGPT 网页渠道接进 img2img-studio，生图、涂抹改图一张搞定——12 步带时间戳深链
dsh 浏览器自动化实操
看 browser MCP 在 DeepSeek Harness 里自主导航、抓取证据、完成多步调研——11 帧逐步深链
联网搜索：计费暗坑与免费搜索插件
dsh 的 web_search 为什么用 Grok 聊天也扣 DeepSeek 的钱，一次调用怎么被算 4 次，以及免配 Key 的免费搜索插件怎么装。
四种模式：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 genui：AI 输出变成交互界面（图解）
OpenTiny 社区 dsh-genui 实录逐帧拆解：对话式安装、火车票表单与可排序表格、按需生成的番茄钟与计算器，以及 GenUI 提示词开关。
让 DSH 每天替你刷 B 站（图解实录）
dsh-bili-scroll 实录逐帧拆解：装依赖、扫码登录、峰谷时段省 token、自动评论 @ 你，直到评论区里那条真实的 @。
让便宜模型听懂话：提示词注入实录
轮次中自动补注你的提示词：手动一次性注入、条件注入与窗口判据，让便宜模型做好指令遵循——带真实录屏帧的图文攻略。
用小鲸鱼娘挂件盯住 dsh 余额
把 dsh-whale-widget 挂进 web profile，配好角落那个显示 DeepSeek 余额、今日已用和刷新倒计时的气泡。
用 AI 美化 dsh 界面
wallpaper-plugin 图文攻略：外观三态开关、预设工作室的图层合成壁纸，以及一句话让 AI 搓出明暗双模完整主题。
dsh 必装插件实操
必装清单图文版：把可搜索的市场装进管理面板，用星标和脚本审计做甄别，再上手视觉、侧边栏与后台任务插件——每步都有逐帧核对的截图。
可验证的架构图
让 agent 画出能拿去评审的系统图，而不是一次性的草图：装好 archify skill，一句话下需求，然后读完 9/9 校验报告再决定信不信这张图。
dsh 创造模式：对话造自定义 Agent 预设
从预设下拉到沙箱审批、挂载校验，再到咖啡店经营分析与 Excel 公式核验——创造模式全流程图文，9 张帧级核对截图。
dsh 自动代码审查：预设与工作台
只读风控评审预设、被预检与测试把关的编码预设、能抓 README 与运行时漂移的插件工作台——审查闭环 8 张逐帧核对截图。
dsh 无限画布：用 ThoughtDAG 做会话分支
问题变节点，连线注入摘要或完整上下文，PDF 长出分支，旧 Claude Code 会话只读导入——画布工作流图文攻略。
DSH 壁纸插件实操
把 Wallpaper Engine 接进 dsh web 界面，让背景随模型切换——9 帧全来自插件作者本人实录。
DeepSeek Orb 悬浮球实操
装 dsh-orb，一句话派活，看 Computer Use 操控屏幕、后台 Agent 干长活——9 帧全来自作者本人实录。
DSH 翻译插件：游戏本地化
tav2 游戏本地化流水线逐帧看：一句话初始化、确认五段流水线、读质量门——停更状态如实标注。
Termux 原生跑通 DeepSeek Harness
逐帧核实的 Termux 攻略:一键安装脚本、127.0.0.1:3080 首次启动,以及在手机上真实编译运行。
DSH 3D 建模与 CAD 插件实操
Blender MCP 联动实录、Tripo 图生 3D 插件 dsh-tripo-studio，再看 dsh 替你写 AutoCAD 插件——8 帧逐帧核验
DSH 启动器与整合包
Melody Launcher 序曲逐帧实操：就绪卡片、整合包配置、跨整合包会话迁移与内置市场，另附独立的 .dspack 路线。
配置与开发
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 的实录。
用 ACP 把 dsh 接进 Zed
dsh 的 Agent Client Protocol 实战：官方 automation-only 服务器和社区交互式路线怎么选、Zed settings.json 怎么填，外加一份覆盖其他 ACP 客户端的适配器目录。
安全与生态
沙箱、值得信任的插件，以及更大的 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 路线全自动；进精选清单还能获得分类和人工撰写的描述。
阅读指南