awesome-deepseek-harness-zh

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 ，详见插件安装教程。

精选 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），不含邀请返利。