DeepSeek Harness 中文使用指南与资源大全（dsh 教程 · 插件 · Skills）

中文 | English

DeepSeek Harness（简称 dsh）是 DeepSeek 开源的 AI Agent 运行框架，采用「万物皆插件」的架构（MIT 协议）。 本仓库用中文讲清楚 dsh 怎么安装、怎么配模型和 API Key、怎么装插件和 Skills、哪些默认设置要先改、遇到报错怎么办，并收录了 68 个精选插件、Skills 和中文教程。

📌 最后核对：2026-10-23，对应 dsh 0.2.1-rc 版本。dsh 还是开发者预览版，官方明确说会有不兼容的更新，遇到和本文不一致的地方请以官方文档为准，也欢迎提 Issue 告诉我们。

由 Orbis（orbiorbi.com） 团队维护；本仓库与 DeepSeek 官方无关联。

目录

• dsh 是什么
• 5 分钟上手
• 用之前先改的 3 个设置
• 入门教程
• 精选插件
• 精选 Skills
• 常见报错速查
• FAQ
• 贡献与收录标准

dsh 是什么

项目	说明
开发方	DeepSeek AI，官方仓库 deepseek-ai/deepseek-harness
定位	开源 AI Agent 运行框架，一切功能都是插件：模型、工具、界面、记忆都能替换
协议	MIT，软件本身免费
当前版本	0.2.1-rc（开发者预览版，2026 年 8 月发布）
使用方式	Web 界面（默认 http://127.0.0.1:3080）、桌面版（Windows / macOS）、命令行无界面模式、Python SDK
默认模型	DeepSeek 官方 API（deepseek-flash、deepseek-v4-pro），也能接 Kimi、GLM 和任何 OpenAI / Anthropic 兼容服务
反馈渠道	官方仓库关闭了 Issues，只能在 Discussions 反馈

5 分钟上手

第 1 步：安装，三选一：

方式	适合谁	命令 / 下载
桌面版（推荐新手）	Windows、macOS 用户，不想装 Node.js	Windows x64 · macOS Apple 芯片 · macOS Intel
npx 一行启动（官方快速开始）	已装 Node.js 的开发者	npx @deepseek-ai/dsh web
源码运行	想改代码、装 Git 插件	见安装教程

npx 第一次运行要解析大量依赖，看起来像卡住是常见现象，解决办法见安装卡住怎么办。

第 2 步：填 API Key。打开 Settings → Models，填入 DeepSeek 开放平台 的 API Key 并保存。也可以登录 DeepSeek 账号，或者接其他模型。

第 3 步：选工作区。点 Choose workspace 选择项目文件夹。不选工作区，输入框是灰的，这是很多人以为「装坏了」的原因。

第 4 步：发第一条消息，比如「读一下这个项目的 README，总结一下」。

用之前先改的 3 个设置

这几点官方文档里都有写，但中文资料很少提到：

1. 会话日志默认上传：用 DeepSeek 官方 API 时，dsh 默认把会话日志上传给 DeepSeek。另外还有一套遥测上传对所有用户生效。不想上传就分别关掉，方法见 隐私与安全设置。
2. 内置联网搜索会带着你的 Key 发请求：它会把 DeepSeek 卡片上配置的 Key 发到对应地址，而且每搜一次都消耗一次模型调用。用第三方服务时要特别注意，见联网搜索。
3. 在隔离环境里用：dsh 会执行模型生成的命令、加载第三方插件，官方说明它没有经过安全审计，建议在虚拟机或容器里使用。

入门教程

教程	解决什么问题
DeepSeek Harness 安装教程	桌面版、npx、全局安装、源码运行；安装卡住、Windows 文件夹选择框报错
配置模型与 API Key	DeepSeek 官方、Kimi、GLM、自定义 OpenAI 兼容服务；Key 存在哪
插件安装教程与精选插件	dsh plugin add 命令、插件市场、51 个精选插件
Skills 安装与使用	Skills 放在哪个目录、SKILL.md 怎么写、精选 Skills
配置 MCP 服务器	接入 GitHub、本地服务等 MCP 工具
隐私与安全设置	关掉日志上传和遥测、代理密码泄露风险
常见报错排查	403、模型连不上、UNKNOWN_MODEL、输出被截断等
中文教程与资料	橙皮书、深度手册、开发教程、其他精选列表

精选插件

按星数挑了最常用的一部分，完整的 51 个按用途分类的插件见 精选插件。

插件	做什么
anywhere-labs/dsh-desktop	社区最火的 dsh 桌面端
dsh-market/dsh-market	可视化插件市场：浏览、搜索、一键安装
ccch1mneyyy/dsh-TUI	终端界面（TUI），npm 一键安装
bowenliang123/dsh-context	上下文洞察与管理，带上下文仪表盘
liustack/modlens	让纯文本模型也能看图
liustack/modsearch	免费联网搜索，无需 API Key
NanmiCoder/dsh-agent-teams	多个 Agent 组队协作
xmanrui/dsh-im	接入飞书、微信、钉钉、QQ 等机器人
Han-1413141/dsh-cost-meter	按会话、按模型统计花费

安装方法：dsh plugin --profile web add <npm 包名>，详见插件安装教程。

精选 Skills

Skills 是一个带说明的 SKILL.md 文件夹，放进 ~/.dsh/skills/（全局）或项目里的 .dsh/skills/ 就能用。完整列表见 Skills 安装与使用。

Skill	做什么
tt-a1i/archify	把方案或代码库画成可交互的架构图
anbeime/skill	中文 Skills 商店，打包好直接装
vinvcn/mattpocock-skills-zh-CN	Matt Pocock skills 简体中文版
Jesseovo/last30days-skill-cn	中文互联网近 30 天热点研究

常见报错速查

现象	原因和处理
npx @deepseek-ai/dsh web 很久没反应	npx 在解析大量依赖。耐心等，或改用桌面版 / 全局安装，见安装卡住
打开网页显示 403	用 localhost 打开会被拒，改用 http://127.0.0.1:3080
输入框是灰的，发不了消息	还没选工作区，点 Choose workspace
DeepSeek API request ... failed	网络或代理问题，或 Key 无效，见报错排查
UNKNOWN_MODEL / MISSING_CREDENTIAL	模型 ID 没加到服务商的模型列表 / Key 没保存，见配置模型
--host 0.0.0.0 被拒绝	官方有意禁止，改用具体的局域网 IP
Output token limit reached	单次输出达到上限，不是上下文满了，调大对应线路的 maxTokens

更多见 常见报错排查。

FAQ

DeepSeek Harness 是免费的吗？

dsh 软件本身免费开源（MIT）。但它要调用大模型才能干活，模型调用按你所用服务商的价格计费。官方文档没有提到免费额度。

用 dsh 需要 DeepSeek 账号吗？

不需要。填一个 DeepSeek API Key 就能用；也可以选择用 DeepSeek 账号在浏览器里授权登录。

国内能用 dsh 吗？

能。默认连接的 DeepSeek 官方 API 国内直连。安装时 npm 下载慢，可以用国内镜像或直接下载桌面版，见安装教程。

dsh 能用 Kimi、GLM、Claude、GPT 等其他模型吗？

能。dsh 内置了 Kimi（moonshotai）、GLM（zai）、OpenAI、Anthropic 等服务商，也可以在 Settings → Models → Add model provider → Custom model API 里添加任何 OpenAI 或 Anthropic 兼容的服务。想用一个 Key 切换多家模型，可以接聚合平台，比如 Orbis（本仓库维护方），配置见接入第三方服务。不知道选哪个模型，可以看 AI Agent 能力排行榜。

dsh 会上传我的数据吗？

默认会：用 DeepSeek 官方 API 时上传会话日志，另有一套遥测对所有用户生效。两者都能关，见 隐私与安全设置。

dsh 和 Claude Code、Codex 有什么区别？

三者都是 AI 编程 / Agent 工具。dsh 开源（MIT）、以插件为核心、默认用 Web 界面，模型默认是 DeepSeek；Claude Code 和 Codex 分别来自 Anthropic 和 OpenAI，以终端为主。想在国内用 Claude Code 和 Codex，可以看我们的另一份指南 Claude Code / Codex 国内使用教程。

Linux 有 dsh 桌面版吗？

官方发布的桌面版目前只有 Windows x64 和 macOS（Apple 芯片 / Intel）。Linux 用 npx 或源码运行 Web 界面。

贡献与收录标准

欢迎推荐插件、Skills 和中文教程，开 Issue 或直接提 PR（改 data/projects.json，再运行 python scripts/render.py）。

收录标准：开源、近两个月内有更新（教程资料不限）、与 dsh 明确相关。不收录：破甲 / 越狱提示词、逆向接口、来源不明的「免 Key 免费模型」、借用他人订阅账号的工具。详见 CONTRIBUTING.md。

星数表格由 GitHub Actions 每周一自动刷新。

License

CC0 1.0：列表和教程内容可自由使用。各项目的版权归其作者所有。

披露：本仓库由 Orbis 团队维护，文中指向 Orbis 的链接带有来源统计参数（UTM），不含邀请返利。