动作架 AhaCrazy/dsh-action-hub

Action Hub

DSH 的标准智能体技能库：同一份 SKILL.md，既能当模型可调用的技能，也能只当你能调用的命令。

本文把技能和命令统称为动作。可用范围只决定动作在哪个项目里可见、可调用，不写进 SKILL.md。

English · 更新日志 · DeepSeek Harness

核心理念

- 文件即标准：每个条目就是一个标准目录 SKILL.md + 资源文件，不生成 action.json，不往 frontmatter 里塞插件私有字段。
- 模式在本地：Command / Skill 是同一文件的两种本机使用方式，切换不改文件、不复制正文。
- 命令零上下文：默认不注册给模型，只在动作面板里由你主动调用。
- 技能可被模型调用：只有你显式切换后才会进入模型目录；切换会显示上下文成本。
- 项目范围：每个条目可以只允许在指定项目使用；范围存本地，不随分享包走。
- 全局分组：任意分组可标记为所有工作区通用，新工作区无需配置即可继承。
- 开箱即用：新安装默认带一个全局 Common 分组，其中已预置 skill-import-assistant。
- 项目级屏蔽：项目可以屏蔽继承来的分组或动作，而不影响其他工作区。
- 导入零转换：网上下载的 SKILL.md 目录/ZIP 原样导入，导出也是原样标准目录。

使用

面板

Alt + A（macOS ⌥ + A）或输入框工具行按钮打开：

- 中文名、描述、标签、正文均可搜索；
- 每行显示 [Command] / [Skill] 与范围；
- 命令：无参数插入引用 chip，有参数插入展开后的正文；
- 技能：插入技能正文；智能体仍可按需自行调用，但 Action Hub 管理的条目不会出现在 / 菜单；
- Enter / Tab 插入，Ctrl/⌘ + Enter 发送。

管理

Ctrl + Alt + A（macOS ⌘ + ⌥ + A）或管理页：

- 新建/编辑标准技能（name 必须是 kebab-case）；
- 切换命令 / 技能；
- 配置「所有项目」或勾选指定项目；
- 导入文件夹/ZIP，导出单条或整库。

导入任意标准技能

导入目录必须包含 SKILL.md：

my-skill/
SKILL.md
...资源文件

name: my-skill
description: 一句话说明何时使用

正文……

导入后默认是命令。需要在动作列表右键菜单中切换为技能，模型才能自行调用；切换前会提示上下文成本。

数据

~/.dsh/dsh-action-hub/
library/<skill-name>/
SKILL.md # 唯一事实源，标准格式 ...资源 state.json # 本机状态：mode / scope / category / pin / usage / 全局分组 / 项目屏蔽

- 不创建 action.json；
- 从 5.x 升级时，旧 actions/ 会归档到 backup-v5-test-，新库为空，不做兼容迁移；
- 分享包只包含标准技能目录，不包含 state.json，因此模式/范围/分类不会随包分享。

分组与项目范围

- 动作可以属于多个分组（例如 Common、AgilityDog、漫剧）；
- 分组对话框可以直接勾选该分组包含的动作，不必逐个编辑动作；
- 分组可以包含其他分组（如 Art 包含 Figma），自动继承子分组全部动作；环引用按合并后的整个集合生效；
- 项目在「项目范围」里勾选分组，并可单独追加个别动作；
- 新动作默认不属于任何分组，需要手动加入；可在分组右键菜单中把任意分组设为新工作区默认分组；
- 任意分组可标记为「全局」：该分组及其子分组的动作对所有工作区生效，无需逐个配置，新增工作区也会直接可用；
- 项目可以屏蔽继承来的分组或动作（灰叉），不必取消全局；直接勾选的分组/动作优先于屏蔽；
- 未配置的新项目默认只使用已设置的「新工作区默认分组」；未设置时没有任何分组可用；
- 面板会识别当前项目，当前不可用的动作会标灰并拒绝插入；
- 会话 cwd 在项目子目录时，按最近的已登记项目根匹配；
- 范围判断由服务商、命令注入点和面板共用；
- 未知项目或损坏状态按已设置的新工作区默认分组处理；未设置时仅内置动作可用。

全局分组

在 Action 分组 中右键任意分组，选择 设为所有工作区通用。分组名旁会出现 全局 徽标。

首次安装（没有旧 state.json）时，插件会默认创建一个名为 Common 的全局分组，并把内置动作 skill-import-assistant 放进去。因此新用户装好插件后，新工作区无需配置就能看到它。已有 state.json 的用户不会被自动改写。

- 该分组及其子分组里的所有动作自动对所有工作区可用；
- 新建工作区、未配置工作区都会直接继承，不需要逐个配置；
- 全局分组可以随时右键 取消所有工作区通用；
- 项目仍然可以追加自己的分组和动作，全局分组是「保底可用」，不是排他范围。

项目级屏蔽

打开 项目可用范围 后，分组和 Action 有三种状态：

| 状态 | 含义 | 点击后 |
| 蓝勾 | 当前项目直接选中 | 取消直接选中 |
| 灰勾 | 通过全局/父分组继承可用 | 变成灰叉，在当前项目屏蔽 |
| 灰叉 | 当前项目主动屏蔽 | 恢复继承 |

规则：

- 屏蔽分组会连同其子分组一起屏蔽；
- 屏蔽 Action 只影响该 Action；
- 直接选择优先于屏蔽：在全局分组被屏蔽后，仍可单独勾选其中某个子分组或 Action 来重新启用；
- 要屏蔽一个已经蓝勾的分组，先取消直接选中，再把它从灰勾切成灰叉；
- 内置 Action 是基线权限，默认始终可用；如要排除某个内置 Action，请在 Action 列表里直接把它切成灰叉。分组级屏蔽不改变内置 Action 的基线权限。

优先级从高到低：

1. 项目直接选中的 Action；
2. 项目直接选中的分组及其子分组；
3. 全局分组或父分组继承来的权限；
4. 项目级屏蔽。

示例：把 Common 设为全局后，在 P2 中屏蔽 Common，P2 不再显示 Common 的 Action；其他工作区不受影响。若只想在 P2 恢复其中一条 Action，直接在 P2 的 Action 列表里勾选该条即可。

开发

npm install
npm test

客户端由 src/client/.js 拼接为 client.js；Host 入口 index.js，标准文档解析在 skill-doc.js。

限制

- 原生 / 菜单按 ASCII name 搜索，中文搜索请用 Action 面板；
- Skill 目录变化会让模型目录整体重发一次；切换前请留意成本提示；
- 当前版本不提供 agent/preset 级范围。