← Back to home@aa2246740

dsh-skillhub

DSH manager for user Skills already on disk in Agent home and DSH home

Stars
22
Language
JavaScript
Created
Aug 27, 2026
Updated
Oct 4, 2026
Skills
GitHub repo

Introduction

🧩 dsh-skillhub

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

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

GitHub Release DeepSeek Harness License GitHub stars

特性亮点 • 一键安装 • 使用指南 • 传导机制 • 常见问题

📖 简介

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 Studio 桌面 App（推荐）

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

@aa2246740/dsh-skillhub@1.0.5

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

github:aa2246740/dsh-skillhub#v1.0.5

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

从 1.0.4 或更早版本迁移

  1. 在桌面 设置 → 插件 中移除旧的 dsh-skillhub 或旧版 @aa2246740/dsh-skillhub 安装项。
  2. 用上面的包名安装 1.0.5，并点击「立即启用」。不要继续使用 dsh-skillhub@npm:... 别名，也不要保留两份安装。
  3. 检查设置中的 skill&mcp 页面和对话输入框上方的「技能」按钮。

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

Web CLI

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

旧版 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.5

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

❓ 常见问题

Q: 安装后刷新页面没有出现插件功能？

A: 先确认安装到了当前使用的 Desktop 或 Web profile，并且已点击「立即启用」或打开插件开关，再查看插件管理器的加载结果。npm 1.0.4 的包名与前端注册名不一致，即使用旧说明中的别名安装，DSH 也可能跳过前端入口。请按迁移步骤换成 1.0.5，直接使用 @aa2246740/dsh-skillhub@1.0.5。若仍缺少入口，请提供 DSH 版本、安装地址及管理器错误文字；反复刷新不会修复包名错误。

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

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

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

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

开发与发布检查

源码构建使用 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