npm installation for DSH 0.2.0-rc.2

This npm distribution uses the existing @aa2246740/dsh-skillhub package. Install it under the original dsh-skillhub alias so the bundled Cordis module and client IDs keep resolving correctly.

In the official Desktop plugin manager, enter:

dsh-skillhub@npm:@aa2246740/[email protected]

For Web:

dsh plugin --profile web add dsh-skillhub@npm:@aa2246740/[email protected]

The runtime files match the dsh-skillhub v1.0.4 release. Only the npm package name, publish configuration, and this installation note differ.

🧩 dsh-skillhub

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

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

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

📖 简介

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

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

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

✨ 特性

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

📦 安装

DSH Studio 桌面 App（推荐）

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

github:aa2246740/dsh-skillhub#v1.0.4

桌面端插件管理器负责 Desktop profile 和内置包管理器。本发布已包含编译产物；普通使用不需要 clone、构建或安装 DSHX。若应用提示刷新或重新打开，请按提示完成。

Web CLI

dsh plugin --profile web add github:aa2246740/dsh-skillhub#v1.0.4

这条官方 CLI 命令只写入 web profile，不能修改 Desktop App 的 profile。对于已经运行的 Web Host，请重新打开该 Host 一次，再刷新网页；不要用这条命令给桌面 App 安装。

📖 使用说明

1. 全局管理（设置页）

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

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

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

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

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

⚙️ 开关传导规则

| 操作层级 | 影响范围 | 说明 | |---|---|---| | 全局 (Global) | 全局 + 所有项目 + 所有对话 | 统一设定基准，覆盖旧选项（重复设同值也同步） | | 本项目 (Project) | 当前项目 + 该项目下所有对话 | 仅作用于本项目，不影响其他项目及其会话 | | 本对话 (Chat) | 仅当前对话 | 临时调整，不影响其他会话 | | 新建继承 | 自动向下继承 | 新建项目继承全局状态；新开会话继承所属项目状态 |

🔄 升级与卸载

更新至最新版本

dsh plugin --profile web add github:aa2246740/dsh-skillhub#v1.0.4

卸载插件

dsh plugin --profile web remove dsh-skillhub

❓ 常见问题

A: DSH 插件在服务启动时编排 Context 树。请在运行 DSH 的终端按 Ctrl + C 停止，然后重新运行 dsh web 启动即可。

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

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

📄 License

MIT © aa2246740