@aa2246740/dsh-skillhub

dsh plugin --profile web add @aa2246740/dsh-skillhub

<div align="center">

🧩 dsh-skillhub

为 DeepSeek Harness (dsh) 打造的本地技能与 MCP 服务统一开关管理插件

已包含编译产物；普通使用无需 pnpm、本地构建或 DSHX。





[特性亮点](#-特性) • [一键安装](#-安装) • [使用指南](#-使用说明) • [传导机制](#-开关传导规则) • [常见问题](#-常见问题)

</div>

---

📖 简介

dsh-skillhub 是专为 DeepSeek Harness 设计的本地技能与 MCP 统一开关管理面板。

它能自动扫描并列出磁盘上已有的所有 Skills（~/.agents/skills 与 $DSH_HOME/skills）以及运行中的 MCP 工具服务，提供 全局 (Global) / 本项目 (Project) / 本对话 (Chat) 三层独立开关控制与智能向下传导能力。

无需手动修改配置，安装后自动挂载，纯可见性控制，绝不修改或删除任何原始磁盘文件。

---

✨ 特性

• ⚡ 一键即用：严格遵循 DSH 官方 Bundle 规范，一行命令自动挂载，无需繁琐接线。
• 🗂️ 本地技能即插即用：自动读取 Agent 目录与 DSH 目录技能，原生安全，不增删改磁盘文件。
• 🎯 三层作用范围：全局设置机器默认值、项目管理工程级偏好、单对话按需微调，互不干扰。
• 🔄 智能向下传导：全局操作同步覆盖所有层，项目操作同步所属对话，对话临时覆盖，新会话自动继承。
• 🔌 MCP 服务联动支持：独立的 MCP 页签，按服务动态隐藏/暴露工具，进程常驻。
• 🎨 原生细节融合：切换作用范围时保留列表；开关保存后自动重新加载 / 技能补全，桌面端也无需刷新窗口。
• 🚀 开箱即用：main 分支已内置编译产物，用户端免装编译环境、免配置 allowBuilds。

---

📦 安装

支持 DeepSeek Harness 0.2.0-rc.2。GitHub 和 npm 使用同一个包名 @aa2246740/dsh-skillhub，安装时不要设置 npm 别名。

版本对照（装错版本会被 DSH 在启动时整体拒绝，表现为「装了但完全没有入口」）：

DSH 版本 · 可装的插件版本

0.2.0-rc.x · 1.0.4 及以上（推荐最新）

0.1.7-rc.x · 1.0.2（1.0.4+ 不兼容）

0.1.5 · 1.0.1

DSH Studio 桌面 App（推荐）

打开 设置 → 插件 → 添加插件，在“包名或地址”中输入：

@aa2246740/dsh-skillhub@1.0.9

也可安装相同版本的 GitHub 包：

github:aa2246740/dsh-skillhub#v1.0.9

任选一种安装即可。桌面插件管理器会操作 Desktop profile；普通使用不需要 clone、构建或安装 DSHX。安装完成后点击 「立即启用」，或在插件列表打开该插件的启用开关。显示“已安装”但未启用时，设置里不会出现入口。启用后检查 skill&mcp 页面；若管理器明确提示需要重新打开应用，按提示完成。

从 1.0.4 或更早版本迁移

1. 在桌面 设置 → 插件 中移除旧的 dsh-skillhub 或旧版 @aa2246740/dsh-skillhub 安装项。

2. 用上面的包名安装 1.0.6，并点击「立即启用」。不要继续使用 dsh-skillhub@npm:... 别名，也不要保留两份安装。

3. 检查设置中的 skill&mcp 页面和对话输入框上方的「技能」按钮。

技能和 MCP 开关仍保存在 $DSH_HOME/skillhub/，迁移不需要删除该目录，也不需要删除原始技能文件。

Web CLI

dsh plugin --profile web add @aa2246740/dsh-skillhub@1.0.9

旧版 Web 用户先用 dsh plugin --profile web remove dsh-skillhub 移除旧别名项；若旧项使用带作用域的包名，则移除 @aa2246740/dsh-skillhub 后再安装。以安装器返回的应用结果为准处理生效步骤。

Web 命令只作用于 web profile，不能给桌面 App 安装插件。

---

📖 使用说明

1. 全局管理（设置页）

打开 DSH 设置 → 找到 skill&mcp 页面：

• 浏览本机所有已安装的技能与 MCP 服务。
• 支持单个开关、文件夹/分组批量开关，以及右上角「全部开启 / 全部关闭」。
• 全局调整将作为所有项目与会话的默认生效值。

2. 项目与会话即时调控（输入框上方）

在对话输入框上方点击 「技能」 胶囊按钮：

• 弹出轻量快捷面板，自由切换 「本对话」 与 「本项目」。
• 支持快捷搜索技能、一键复制 /<skill-name> 命令。
• 切换无闪烁，调整后模型下一次回复立即按新配置生效。

---

⚙️ 开关传导规则

操作层级 · 影响范围 · 说明

全局 (Global) · 全局 + 所有项目 + 所有对话 · 统一设定基准，覆盖旧选项（重复设同值也同步）

本项目 (Project) · 当前项目 + 该项目下所有对话 · 仅作用于本项目，不影响其他项目及其会话

本对话 (Chat) · 仅当前对话 · 临时调整，不影响其他会话

新建继承 · 自动向下继承 · 新建项目继承全局状态；新开会话继承所属项目状态

---

🔄 升级与卸载

桌面端在 设置 → 插件 中升级或卸载。首次从旧包名迁移时，按上面的迁移步骤操作。

Web 用户使用：

# 更新
dsh plugin --profile web add @aa2246740/dsh-skillhub@1.0.9

# 卸载
dsh plugin --profile web remove @aa2246740/dsh-skillhub

---

❓ 常见问题

<details>

<summary><b>Q: 安装后刷新页面没有出现插件功能？</b></summary>

A: 先按上面的版本对照确认插件版本与 DSH 版本匹配——不匹配时 DSH 会在启动时整行拒绝该插件，界面上什么都看不到，重启也不会恢复。再确认安装到了当前使用的 Desktop 或 Web profile（第三方启动器的「整合包」默认装进独立 profile，需要切到那份 profile 运行），并且已点击「立即启用」或打开插件开关（部分启动器在插件报错后会自动关闭开关，升级 DSH 后需手动重新打开），再查看插件管理器的加载结果。npm 1.0.4 的包名与前端注册名不一致，即使用旧说明中的别名安装，DSH 也可能跳过前端入口。请按迁移步骤换成 1.0.6，直接使用 @aa2246740/dsh-skillhub@1.0.9。若仍缺少入口，请提供 DSH 版本、安装地址及管理器错误文字；反复刷新不会修复包名错误。

</details>

<details>

<summary><b>Q: 为什么开启了某个 Skill，输入框输入 <code>/</code> 没有立刻补全？</b></summary>

A: SkillHub 保存开关后，会通过官方 Cordis 生命周期重新挂载技能补全插件，清掉其旧目录缓存。重新打开 / 即可看到新列表，不需要 Cmd+R、F5 或重启桌面端。也可点击技能面板右上角“更多操作 → 刷新 / 补全”手动重试。模型下一次请求使用新设置；已经读入历史的技能正文不会被删除。

</details>

<details>

<summary><b>Q: 关闭某个 Skill 后，为什么当前会话模型似乎还记得？</b></summary>

A: 关闭技能会立刻阻止后续向模型提供该技能的定义，但如果此前该技能的内容已经被读取进当前对话的上下文历史中，该轮会话中已读内容不会被篡改。新开一个会话即可彻底清空。

</details>

---

开发与发布检查

源码构建使用 DSHX 的外部插件构建器，DSHX_HARNESS 指向安装了 DSHX 的官方 dsh-v0.2.0-rc.2 checkout。构建仅读取目标平台信息，输出保存在本插件目录。

pnpm install --frozen-lockfile --ignore-workspace --config.auto-install-peers=false
pnpm test
pnpm pack

prepack 校验包名、bundle 模块名和编译后的前端注册名；不一致时拒绝打包。发布时直接使用这个包，不要再改写包名。隔离加载回归运行方式见 tests/package-loader-runtime.test.mjs。

📄 License

MIT © aa2246740