科研技能命令桥 hzh5021/dsh-research-commands

dsh-research-commands

把已装的 research skills 变成斜杠命令：敲一下，对应的 SKILL.md 就作为一条 user 消息进会话。

它做什么

DSH 的斜杠命令只能用代码注册（ctx.commands.register()），丢文件注册不出来；而不少技能生态文档里写的 /xxx 语法是别的客户端专用的——技能装好了，命令还是敲不出来。这个插件把这段桥补上：它维护一张「命令 → 技能目录」的表，敲命令时去用户技能根目录里读对应的 SKILL.md，剥掉 YAML frontmatter，把技能正文和你在命令后面补的那句话拼成一条 user 消息注入当前会话，模型照着跑那个技能。

一共十五条：

| 命令 | 技能 | 说明 |
| /idea | idea-discovery | 找idea全流程 |
| /novelty | novelty-check | 查新 |
| /figure | nature-figure | 论文配图 |
| /polish | nature-polishing | 论文润色 |
| /review | nature-reviewer | 模拟审稿 |
| /cite | citation-audit | 审查引用 |
| /read | nature-paper-xray | 精读论文 |
| /poster | paper-poster-html | 做海报 |
| /slides | paper-slides | 做PPT |
| /paper | paper-writing | 写论文全流程 |
| /exp | experiment-plan | 实验计划 |
| /analyze | analyze-results | 分析结果 |
| /lit | research-lit | 文献综述 |
| /respond | nature-response | 审稿意见回复 |
| /html | render-html | 渲染HTML |

它只负责把技能说明书送到模型眼前；技能在不在、跑不跑得动，取决于你装了什么。

装

dsh plugin add hzh5021/dsh-research-commands

手工四步：

1. 把包放进 ~/.dsh/plugins/dsh-research-commands/。
2. profile 的 package.json 里 dependencies 加一条（本机口径："dsh-research-commands": "file:../../plugins/dsh-research-commands"），并在 profile 的 node_modules/ 下留一个同名联接。
3. 同一份 package.json 的 dsh.profile.bundles 里加上 "dsh-research-commands"。
4. 重启 DSH。

插件行由本包自己的 cordis.patch.yml 插进 profile 花名册；profile 的 cordis.yml 是生成物，不要手改。

配置

无配置项。命令表、技能根目录、大小上限都写在代码里。

技能按顺序在两个根目录里找：

1. ~/.dsh/skills/<技能目录>/SKILL.md
2. ~/.agents/skills/<技能目录>/SKILL.md

先找到哪个用哪个。

怎么工作

- 只声明 inject = ["commands"]：命令注册表是这个插件唯一需要的宿主服务。
- 十五条命令各自用 ctx.effect(function* () { yield ctx.commands.register({...}) }) 注册，effect 名字形如 research-command-<cmd> lifecycle。
- 每条命令的 input.hint 是给命令面板显示的参数提示（例如 [论文目录或 PDF]、[idea 或方法描述]）。
- 找不到技能时返回 { kind: "error", text: "Skill \"<技能>\" was not found under ~/.dsh/skills or ~/.agents/skills." }。
- 宿主没有 agent.steer 时返回错误，明说这条命令起不来，而不是静默失败。
- 注入的消息形状和宿主 createUserMessage 的输出同形（{ role, content, source }），在本地构造以避免 import 宿主包：@deepseek-ai/* 是宿主提供的 peerDependencies，npm 上发布的那个版本跟真正在跑的对不上，引进来会拉进第二份内核。只用 Node 内置模块。
- 注入正文分两段：## My request（你在命令后面写的那句；没写就提示模型先问你）和 ## Skill instructions (\<技能>\)（SKILL.md 的正文，frontmatter 已剥）。
- 单条技能正文超过 120,000 字符会截断，并在末尾标 [truncated: SKILL.md exceeded 120000 characters]，防一个病态文件把一轮撑爆。
- 命令名刻意短，且都避开了宿主内置的 /model、/plan、/compact、/permission、/export、/file。

边界

- 依赖你已经把对应技能装在 ~/.dsh/skills 或 ~/.agents/skills 下；没装就只会回一句「找不到」。
- 技能根目录写死，没有配置项。
- 需要宿主暴露 agent.steer；没有就报错。
- 送到模型眼前的是技能说明书的正文（已剥 frontmatter），不是执行结果；技能要什么输入、产出什么，由技能自己决定。
- 这十五条命令是固定的一张表：删一条、加一条都要改代码。
- 只用 Node 内置模块（node:fs/promises、node:os、node:path）。

冒烟测试

这个包没有自带 test/。手工验法：装好重启，敲 /lit 之类，看它有没有去读对应的 SKILL.md、有没有把「技能找不到」说清楚（故意敲一个没装的技能名就能看到那条错误）。

功能 — 注册十五个斜杠命令（/idea、/novelty、/figure、/polish、/review、/cite、/read、/poster、/slides、/paper、/exp、/analyze、/lit、/respond、/html）。这些命令从 ~/.dsh/skills 或 ~/.agents/skills 读取对应技能的 SKILL.md，去掉其中的 YAML frontmatter，再把正文作为用户消息注入，让模型执行该技能。

安装 — 执行 dsh plugin add hzh5021/dsh-research-commands，或者把包放进 ~/.dsh/plugins/dsh-research-commands/，在配置档 package.json 中注册（dependencies + dsh.profile.bundles），然后重启 DSH。

配置 — 无；命令表和技能根目录都写死在代码里。

要求 — DSH 需暴露 commands 和 agent.steer，并且技能本身已安装在两个技能根目录之一；Node 18+；无外部依赖。

许可 — MIT。

MIT 许可。