前言¶
DSH 的斜杠命令注册方式是代码级调用 ctx.commands.register(),而技能生态文档里常见的 /xxx 语法往往是别的客户端专用——技能装好了,命令还是敲不出来。hzh5021/dsh-research-commands 用来补上这个桥。
它是什么¶
这是一个 DSH 工作流插件。维护者是 hzh5021。它维护一张「命令 → 技能目录」的表,敲命令时去用户技能根目录里读对应的 SKILL.md,剥掉 YAML frontmatter,把技能正文和你在命令后面补的那句话拼成一条 user 消息注入当前会话,让模型照着那个技能跑。
核心功能¶
- 注册十五条斜杠命令:
/idea、/novelty、/figure、/polish、/review、/cite、/read、/poster、/slides、/paper、/exp、/analyze、/lit、/respond、/html。 - 每条命令映射一个技能:从
~/.dsh/skills/<技能目录>/SKILL.md或~/.agents/skills/<技能目录>/SKILL.md读取对应SKILL.md。 - 自动剥离 YAML frontmatter,注入两段文本:
## My request:你在命令后面写的参数(没写就提示模型先问你)。## Skill instructions (<技能>):SKILL.md的正文(frontmatter 已剥)。- 技能正文超过 120,000 字符时截断,并在末尾标注
[truncated: SKILL.md exceeded 120000 characters]。 - 技能不存在时返回错误提示:
Skill "<技能>" was not found under ~/.dsh/skills or ~/.agents/skills.。 - 依赖宿主暴露
agent.steer,否则报错;依赖宿主提供commands注册表。 - 不使用外部依赖,只用 Node 内置模块。
安装与启用¶
官方安装命令:
dsh plugin add hzh5021/dsh-research-commands
也可以手工四步:
- 把包放到
~/.dsh/plugins/dsh-research-commands/。 - profile 的
package.json里dependencies加一条(本机口径):"dsh-research-commands": "file:../../plugins/dsh-research-commands",并在 profile 的node_modules/下留一个同名联接。 - 同一份
package.json的dsh.profile.bundles里加上"dsh-research-commands"。 - 重启 DSH。
插件行由本包自己的 cordis.patch.yml 插进 profile 花名册;profile 的 cordis.yml 是生成物,不要手改。
典型用法¶
装好后重启,在对话里敲命令,例如:
/lit:读research-lit的SKILL.md,把技能正文注入为 user 消息,模型按技能流程做文献综述。/novelty:读novelty-check的SKILL.md,模型按查新流程操作。/review:读nature-reviewer的SKILL.md,模型按审稿流程给出意见。/respond:读nature-response的SKILL.md,模型按回复意见流程撰写回复。
命令名后面可以跟参数,如 /paper [课题方向],这些参数会拼接成 ## My request 部分。
适用场景与注意¶
适合已安装相应技能、需要通过斜杠命令快速触发技能流程的研究与写作场景。
注意:
- 插件以当前 DSH 进程权限运行;安装前应检查源码与许可证。
- 依赖宿主暴露 agent.steer,否则命令无法启动。
- 技能根目录写死,没有配置项;技能必须安装在 ~/.dsh/skills 或 ~/.agents/skills 下。
- 命令表固定十五条,删一条、加一条都要改代码。
- 注入的是技能说明书的正文,不是执行结果;技能要什么输入、产出什么,由技能自己决定。
短结尾¶
dsh-research-commands 把已装技能变成斜杠命令,让技能说明书直接进会话,无需再翻文档或切换工具。需要的话可以到目录页和 GitHub 了解更多。
- 目录页:https://www.skillhub.cn/plugins/hzh5021/dsh-research-commands
- GitHub:https://github.com/hzh5021/dsh-research-commands