科研技能墙 kee0012/dsh-science-skill

dsh-science-skill

科研技能中心：把散落在磁盘上的技能，变成 DSH 里一面可浏览、可分类、可一键调用的技能墙。

这是一个 DeepSeek Harness 插件，不依赖 Science Agent。装上之后你会得到：技能设置面板、分类标签栏、卡片式技能墙、搜索、卡片内直接改分类、开关、导入与刷新，以及用 /命令 调用技能的能力。

功能特性

左侧栏入口与技能墙

- 侧栏注册一个「技能」入口，点开在本区展开技能墙：顶部是分类标签栏（分类多了会自动排到下一行），下面按 4 列铺开卡片。
- 卡片上有三个彼此独立的目标：点卡片正文打开该技能的详情弹窗；点右上角「召唤」才把它的 /命令 引用插入当前会话的输入框（不新建会话）；点右下角带 ▾ 的分类标签能直接把技能换到别的分类，改完立即重排，设置面板里的同一个技能同步。
- 技能墙用官方 sidebar.panellist 一行入口 + main 一个面板实现。

技能详情与「试试这样用」

- 详情弹窗自上而下是：分类图标、中文名、/命令、「去试试」（等同召唤）、一句简介，然后是「试试这样用」——几条中文示例提问，点任意一条就把这句话插入当前会话的输入框，不会覆盖你后续的编辑。
- 最下面是「技能详情」：该技能 SKILL.md 的原文，等宽、限高、可滚动。
- 中文名、中文简介、分类与示例由你在 DSH 里的默认对话模型在同一次调用里一并生成，不需要给插件单独配模型；模型偶尔没给出示例时只降级为空数组，中文名与分类照常保留。

分类管理与开关

- 分类可创建、改名、删除、排序、恢复默认，并可按名称推荐图标。
- 每个技能可单独开关，开关状态持久化在数据根下。

导入与刷新

- 导入技能目录、校验一个目录能否导入、刷新重新扫描，都在设置面板里完成。
- 重复导入直接覆盖：被替换的旧文件夹直接删除，不再保留任何备份——你选中的那个文件夹就是要用的版本；你在面板里改过的中文名、分类与示例留在记录上，SKILL.md 换成新的。
- 2.0.5 之前的版本会把被替换的文件夹留成 .<id>.old-<时间戳> 备份。旧备份一旦被发现，工具条上会出现「清理旧版本（N）」按钮；点一下就把这些残留删除。重新导入同一个技能时，它自己的旧备份也会顺带清掉。
- 桌面版与 dsh web 都可用。

安装

插件托管在 GitHub（kee0012/dsh-science-skill，未发布到 npm），DSH 支持以 git 依赖方式直接安装：

从 GitHub 安装（推荐，日常使用；拉取默认分支最新提交）
dsh plugin --profile desktop add github:kee0012/dsh-science-skill

安装后需要重启 DSH，新的服务端代码与 client bundle 才会生效。

使用

导入技能

1. 打开 设置 → Science Skill，在「技能默认目录」里指定一个目录（只接受绝对路径，留空＝未设置）。
2. 点「+ 添加目录」选择要导入的技能文件夹，确认分类即可。指定了默认目录时，导入的技能一律装到那里；未指定则回落到数据根下的 skills。
3. 技能已经躺在目录里但没被登记？点「刷新」重新扫描：插件会把它们登记进目录记录，并为从未命名过的技能生成中文名、中文简介与示例。

技能目录要求

- 每个技能是一个子目录，内含 SKILL.md。
- SKILL.md 的 frontmatter 必须有 name: 与 description:；name 要能当 kebab-case 标识用（小写字母、数字、单连字符）。
- 子目录名可以随便起，不要求等于 name——不合规的目录名用 frontmatter 的 name 当记录标识，插件不重命名、不移动你的文件夹。

调用技能

- 在技能墙上点卡片的「召唤」，或打开详情弹窗点「去试试」，该技能的 /命令 引用就会被插入当前会话的输入框，回车发送即可。
- 也可以直接在输入框里敲 / 加技能标识调用。

技能目录规则与数据存放

技能根如何解析

- 只加载你在「技能默认目录」里设定的那一个目录，可以用 skillDirs 配置追加额外的根。
- 未设定时回落到 <dataRoot>/skills，以及 $DSH_AGENTS_HOME（缺省 ~/.agents）下的 skills。
- 插件同时以提供者身份接入内核技能注册表，把暴露的目录限定为你选定的那一个，因此面板上显示的技能就是模型能加载的技能；内核没有这个注册表时插件照常工作，只是退化为「仅面板可见」。

登记规则

- 目录名本身合规时，直接用它当记录标识（/命令 另按 frontmatter 的 name 走）。
- 目录名不合规（带大写、空格、点、中文）时，用 frontmatter 的 name 当记录标识，并记住真实文件夹名。
- 两个文件夹声明了同一个 name 时，先扫到的收录，后一个跳过并说明「技能标识已被占用」。
- 点号开头的子目录视为导入残留，一律忽略；既没有合规目录名、SKILL.md 里也没有合规 name 的文件夹会被跳过并给出原因。
- 不再被扫描的旧记录会被排除出索引，但记录文件保留——把默认目录指回去就回来了。

不动你的文件

- 登记只写数据根下的记录，不复制、不修改、不删除技能目录里的任何东西；已有记录也原样保留（只增不改）。

数据放在哪里

数据根按顺序解析：插件配置的 dataRoot（相对路径按 process.cwd() 解析）→ $DSH_HOME → ~/.dsh。数据根下会用到：

| 路径 | 作用 |
| catalog/data/<id>.json | 每个技能一条元数据（中文名、简介、分类、命令、示例提问） |
| catalog/index.json | 聚合索引，面板读它 |
| catalog/categories.json | 分类表，数组顺序就是面板顺序 |
| catalog/schema.json | 记录结构校验；缺失时从插件自带 schema 播种一次 |
| skill-gate.json | 全局技能开关（{"pinned": {"<name>": true}}） |
| skill-import.json | 技能默认目录（{"defaultSkillDir": "<绝对路径>"}，空串＝未设置） |

配置

- id: science-skill

name: dsh-science-skill
config:
enabled: true # false 时不注册任何路由 dataRoot: '' # 缺省走 $DSH_HOME
skillDirs: [] # 追加的技能根（相对路径按 dataRoot 解析）
naming: true # 导入技能时用默认模型起中文名；关掉则只做规则推断

HTTP 接口

全部挂在 /api/dsh-science-skill 下。读接口返回 JSON，写接口收 JSON body。

| 方法 | 路径 | 作用 |
| GET | /skills | 技能列表（含中文名、简介、分类、/命令、示例提问） |
| GET | /skills/detail?id= | 单个技能的展示字段 + 示例 + SKILL.md 原文（上限 20000 字符，超出带 truncated；id 非法 400、不存在 404） |
| POST | /skills/refresh | 重新扫描：登记新技能、重建索引，并为「从未命名或没有示例」的技能启动回填（3 条并发） |
| GET | /import-settings | 技能默认目录（未设置时为空串） |
| POST | /import-settings | 设/清技能默认目录：{defaultSkillDir}（只接受绝对路径或空串） |
| GET | /skills/validate?path= | 校验一个技能目录能不能导入 |
| POST | /skills/import | 导入技能目录：{path, overwrite?, category?}；不带 overwrite 时同名技能返回 400 already exists，应答含 overwritten 与「已覆盖更新」文案 |
| POST | /skills/update | 改展示信息与分类：{id, displayName?, displaySummary?, category?} |
| POST | /skills/delete | 删除技能（internal 共享包拒绝删除） |
| GET | /categories | 分类表 |
| GET | /categories/suggest?label= | 按名称推荐图标 |
| POST | /categories/create｜rename｜delete｜reorder｜restore | 分类增删改序与恢复默认 |
| GET | /catalog | 聚合索引原文 |
| GET | /skill-gate/state?sessionId= | 该会话的激活集合与全局开关 |
| POST | /skill-gate/pin | 改全局开关：{name, enabled} |
| POST | /skill-gate/session | 推某会话的激活集合：{sessionId, names[]} |

兼容性

- 需要 DSH ^0.2.0-rc.1：宿主半边只依赖 ctx.webServer，客户端半边使用官方插槽与 slots / sessions / conversation / remote / locale / inputTriggers 服务。
- 零运行时 npm 依赖，离线机器也能装起来。
- 可选：内核提供 skillGate 挂点时，面板里的开关会真正影响模型可见的技能目录；没有该挂点时插件照常工作，开关只记录状态。

已知限制

- 技能最终能否被模型加载，仍由 DSH 内核决定。同名技能存在多个来源时，按内核的优先级规则胜负，面板上显示的不一定是最终生效的那一份。
- 插件只读写数据根，不接管技能发现，也不 patch 内核。

反馈与贡献

问题、建议与 Pull Request 都欢迎：Issues。

许可证

MIT