切换手册章节
从添加插件到确认它真的在运行
同事发来一个插件，先问清楚手里拿到的是什么：一个 npm 包名、一份源码、一个市场索引，还是一个只含 SKILL.md 的技能文件夹。它们去不同入口。
本篇目录 6 节
01
根据收到的材料选择入口
| 收到什么 | 应放在哪里 | 检查要点 |
|---|---|---|
| npm 包名或带版本的包名 | “插件 → ＋ 添加插件”，填入作者 README 中的包标识。 | 只填命令最后那个包标识，不用粘前面的 dsh plugin 命令。团队复用可指定相同版本。 |
| Git 仓库安装地址 | “添加插件”的同一个输入框，填写作者给的安装地址。 | 核对仓库所有者和目标版本、提交。仓库页的浏览地址、某个文件预览页和作者的安装地址可能不同。 |
| 本地插件目录 | 同一输入框填运行 Harness 的主机上可读的绝对路径。 | 目录应包含该插件的 package.json 并声明 Harness 组合包；源码仓库有多个包时，以作者给的包根为准。 |
| .tgz / .tar.gz 插件归档 | 在同一输入框提供相应归档的本地绝对路径或支持的下载 URL。 | RC5 只把这两种后缀识别为插件归档。普通源码 ZIP 应先解压，再按作者说明选择实际插件包目录。 |
| 插件市场索引的 JSON 链接 | 打开“实验性插件 → 更多 → 自定义插件市场”，到“发现 → 添加索引源”填写。 | 索引列出可以安装的插件和版本。补充索引本身不会安装其中的任何插件。 |
| 只有一个 SKILL.md 的资料文件夹 | 按技能安装课程复制到项目或个人技能目录。 | SKILL.md 装的是工作规则；把技能文件夹当成组合包提交，会因缺少插件包声明而被拒绝。 |
02
把包安装进当前工作台
- 在目标工作台点“插件 → ＋ 添加插件”。点旁边的小箭头会看到“安装第三方插件”，它打开同一对话框。有创造模式时，另一个“让 Agent 创建插件”会打开创作会话。
- 填作者提供的准确标识，核对安装源，点“安装”。管理器先检查输入，再显示从来源得到的信息和安装进度。用 Git 或归档安装时，部分信息要拉取后才能判定；遇到要求允许依赖构建脚本时先核对相关包。
- 安装结束查看实际推荐或安装到的版本。要马上使用就点“立即启用”；直接关掉完成页面，插件可保持已安装但关闭。
- 回到列表，点进新卡片检查组件状态。如果提示需要重启，按提示重启对应宿主；仅刷新浏览器不能替代宿主重启。最后按作者说明找它新增的按钮、工具或能力，运行一次最小操作核对。
03
用“发现”浏览团队分享的市场
- 按前表路线打开自定义插件市场。RC5 没有预设市场索引，初次打开“发现”时列表可以为空。
- 从维护索引的同事或项目取得可信的 HTTPS 索引 URL。添加后可通过名称、作者或标签找到目标插件，打开条目查看兼容版本。
- 点“安装”后核对确认框里的实际安装来源。npm 条目看包名和注册表，Git 条目看仓库、提交和目录。确认后仍要走正常的安装与启用流程。
04
区分关闭、卸载和重启
| 看到什么 | 怎样处理 |
|---|---|
| 只想暂时不用某项功能 | 关闭它的组合包开关，依赖仍保留。若只想停用其中某一项，点进已开启组合包，在允许切换的组件行操作。 |
| 想移除外部安装的包 | 打开详情选择卸载并确认。RC5 随安装提供的可选组合包只提供启停，没有外部包那样的卸载操作。 |
| 开关已开，但找不到功能 | 进详情看实际组件是运行中、关闭还是失败。再核对插件是为哪个模式、哪个配置或哪种系统提供的；宿主要求重启时再重启。 |
| 同一台电脑的 Web UI 里有，桌面里没有 | Web 与桌面分别使用 web、desktop 配置。到你实际使用的那个工作台检查，不要把两边安装视作自动同步。 |
05
遇到安装错误时，先看哪一步失败
| 表现 | 下一次操作 |
|---|---|
| “找不到包”或不是组合包 | 核对包名、大小写、版本和目录层级。仓库根未必就是插件包根；普通资料 ZIP 或裸 SKILL.md 不能直接作为插件安装。 |
| 注册表连接超时 | 打开“查看安装详情”，核对请求的域名。如失败来自注册表，可用“更换安装源”选择可信镜像，再重试。 |
| Git 仓库或归档的地址连不上 | 从运行 Harness 的主机核对该地址能否访问。换 npm 镜像不会替你取到原始 Git 仓库；有作者提供的发布包时可用它的真实来源。 |
| 界面关闭或没有收到安装结果 | 通过“查看安装任务”返回本次运行。若状态不明，先“核对安装状态”或刷新列表，确认已有记录再决定是否重试。 |
| 安装完成，组件显示异常 | 展开组件或安装详情看错误和兼容性提示。修复前可先关闭组合包；记录当前客户端版本和错误文本。 |
06
把可复现的安装方式发给同事
打开组合包详情，在组件列表下找“来源信息”，记录完整包名、已装版本及实际来源。随包提供的功能会标“内置”。再写清使用的是 desktop 还是 web、必须启用的组件、成功时看到哪个入口。
如果你装的是本机目录，对方电脑通常没有相同的绝对路径。把有权分享的包、仓库或固定版本发给对方，让对方在自己的主机按对应入口安装。单发一张开关截图，无法确定他装的是不是同一版。
开发者也可以查看 CLI 的插件列表。桌面端须用打包应用的 dsh（Windows 为 dsh.cmd）：先启动桌面一次完成初始化，完全退出，再执行下方 desktop 命令；普通 Web 配置用 web。更改后重新打开相应工作台核对。
dsh plugin --profile desktop list
dsh plugin --profile web list来源与延伸阅读
配套资料
知识库与演示素材
知识库附录含录屏分镜。练习包里的 INDEX.md 可按题目查找会议简报、只读目录核对、Cordis 报销回执，以及门店销售和团队练习。