常见问题
关于 DeepSeek Harness (dsh) 插件的安装、兼容性、汉化与选型的 24 个常见问题，答案直接给结论。
🧩 基础认知
- DeepSeek Harness 是什么？
- DeepSeek Harness（简称 dsh）是 DeepSeek 官方的插件框架，用于给 AI 编码助手扩展能力：浏览器自动化、剪贴板、视觉识别、对话工具、UI 组件等都以插件形式挂载。它基于 Cordis 生态，插件以 npm 包或 GitHub 仓库分发。
- dsh 插件和 Cordis 插件是什么关系？
- dsh 底层基于 Cordis 框架，因此大量 Cordis 生态插件在 Harness 中同样可用。本站会标注每个插件的依赖类型（deepseek-harness / cordis / 未知），并用 tier 字段区分「核心插件」与「兼容相关插件」。
- 本站收录了多少个 DeepSeek Harness 插件？
- 目前收录数百个插件（数量持续增长），全部提供中文汉化文档与兼容性验证结论，可按分类、分层（核心/相关）、联网需求、兼容状态筛选，并按综合分或 Star 数排序。
- 这个站的插件数据多久更新一次？
- 每日自动增量抓取。新发现的插件进入「发现」流程，已收录插件定期刷新 Star 数、README、依赖与兼容性验证结果，首页可看到最近更新时间。
⚙️ 安装与使用
- 安装 dsh 插件前需要准备什么？
- 需要先安装 dsh CLI 引擎，并确保 Node 版本满足插件要求（多数插件要求 Node 20 或 22 以上）。本站每个插件页都会给出安装命令与兼容性结论，装前先看结论能省很多事。
- dsh 插件怎么安装？
- 在已安装 dsh CLI 的环境中执行安装命令即可，具体命令在每个插件详情页首屏提供，可一键复制（注意其中 --profile 为 dsh 必需参数，不要省略）。若插件未发布到 npm，则需要源码安装（本站标注为「需源码安装」）。
- 「需源码安装」是什么意思？
- 指该插件未发布到 npm registry、入口或依赖声明缺失、或与当前 dsh 版本不兼容，无法用安装命令直接装。这类插件需要手动克隆仓库、本地构建后挂载，适合有开发经验的用户。
- 怎么卸载或更新 dsh 插件？
- 通过 dsh CLI 的插件管理命令移除或升级即可（命令随 dsh 版本略有差异，以官方文档为准）。本站插件页会显示插件最近一次上游提交时间，可据此判断是否需要更新。
- 提示 command not found: dsh 怎么办？
- 说明 dsh CLI 未安装或未加入 PATH。先安装 dsh 引擎并确认命令行可执行，再安装插件；若仍失败，检查 Node 版本与安装目录权限。
🛡️ 兼容性与汉化
- 兼容性验证是怎么做的？
- 本站对每个插件做静态与 registry 校验：检查 npm 包是否存在、engines.node 是否满足 Node 22、是否声明 @deepseek-ai/dsh 依赖及版本约束、main/exports/bin 入口是否存在。结果分三档：可直接安装 / 装前注意 / 需源码安装，插件页会列出每一项的通过情况。
- 「装前注意」会不会装不上？
- 通常可以安装，只是存在版本约束或入口方面的提醒（例如依赖的 dsh 版本与当前最新版不完全匹配）。安装后建议实际跑一遍核心功能确认。
- 插件的中文文档是人工翻译的吗？
- 由机器翻译引擎自动汉化（DeepSeek 翻译 + 兜底引擎），保留 Markdown 结构、代码、命令与专有名词。质量足够读懂，但参数细节建议对照英文原文确认。
- 「需联网」插件是什么意思？
- 指插件运行时需要访问外网（调用 LLM API、远程协议或需要联网集成）。判断依据来自代码中的网络访问证据，仅供参考，具体以插件文档为准。
🔍 选插件
- 新手推荐先装哪些插件？
- 建议从高频场景入手：浏览器自动化（抓网页、填表单）、剪贴板、文件编辑、终端、对话类工具。按「可直接安装」筛选能快速排除需要折腾的插件。
- 综合分是怎么算出来的？
- 综合 GitHub 数据（Star、Fork、最近维护）与本站用户投票加权得到，兼顾热度与口碑，避免纯 Star 排序导致的新插件埋没。
- 怎么判断一个插件还在维护？
- 看三个信号：最近一次上游提交时间（卡片上有「N 天前更新」）、是否发布到 npm 并有新版本、Issue 是否有人回应。长期未更新且依赖老版本 dsh 的插件慎用。
🧑💻 插件作者
- 怎么提交自己的插件？
- 通过导航栏「提交插件」填写仓库地址，系统会校验仓库可访问性与插件特征，通过后进入收录流程并自动汉化。
- 开发一个 dsh 插件需要什么？
- 需要 Node 环境、了解 Cordis/dsh 插件规范，并在 package.json 中声明 @deepseek-ai/dsh 依赖、入口文件与 engines.node。发布到 npm 后即可被安装命令直接安装，这是提高安装成功率的关键。
- 为什么我的插件没被收录？
- 常见原因：仓库不可访问、未声明 dsh/Cordis 依赖、没有可识别的插件入口、或缺少 README。补齐后再提交通常即可通过。
🏠 关于本站
- 这个站和官方插件市场有什么区别？
- 官方市场以英文原始信息为主；本站额外提供全量中文汉化、逐项兼容性验证结论、综合评分与分类筛选，目标是帮中文用户 5 分钟判断一个插件能不能用、值不值得装。
- 怎么获取每周插件更新？
- 在首页或页脚订阅周报邮箱，每周一封，包含新收录插件、热门插件与精选福利，可随时退订。
- 我可以在公众号或小红书引用本站内容吗？
- 可以，注明来源即可。插件数据每日更新，建议引用时附上插件页链接，方便读者获取最新的安装命令与兼容性结论。