@etby-studio/dsh-commands
用于 DeepSeek Harness 用户界面的文件系统斜杠命令发现
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @etby-studio/dsh-commands@0.2.0Commands 以 @etby-studio/dsh-commands 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →English | 中文
Filesystem slash-command discovery for DeepSeek Harness UIs.
This plugin registers one slash command per Markdown file under <dshHome>/commands, mirroring the user-root layout of the skill discovery in @deepseek-ai/dsh-skill-filesystem. The filename stem is the command name, the YAML frontmatter supplies the description, and the body is the instruction executed when the command runs. A host watcher keeps registrations in sync with the directory: adding, editing, or deleting a command file updates the registry without a restart, and the registry's own commands/change event refreshes live discovery UIs.
It is a plugin for the DeepSeek Harness command registry (ctx.commands, @deepseek-ai/dsh-commands).
From npm:
dsh plugin add @etby-studio/dsh-commands
Developing locally (the build output lib/ is gitignored; build it first after cloning):
pnpm run build
dsh plugin add /path/to/dsh-commands
The package declares dsh.bundle.patch (cordis.patch.yml), so dsh plugin add installs it as a
profile layer and that layer inserts the plugin row itself — no manual cordis.patch.yml edit.
Do not also add the row to $DSH_HOME/profiles/<name>/cordis.patch.yml: a second insert of the
same id is a duplicate Loader entry.
dsh plugin add refuses packages without dsh.bundle, and DSH loads a bundle only when every
@deepseek-ai/dsh-* peer range matches the runtime version, so this release targets
dsh 0.2.0-rc.2 (peers ^0.2.0-rc.2).
After boot, any *.md file in <dshHome>/commands becomes a slash command (dshHome defaults to $DSH_HOME or ~/.dsh).
Each command is one Markdown file; the filename stem (without .md) is the command name, lowercased ASCII with letters, digits, _, or -, matching parseCommand():
---
description: Execute the plan
---
## Steps
1. Review the plan
2. Create a task list
description (required) — shown in command discovery UI.Invalid files (missing frontmatter, empty description, invalid name, empty body) are skipped with a warning and never registered.
The handler never implicitly submits to the model. On /name [args] it reads the current body and steers one user message to the receiving agent:
/go <description> → body + blank line + <description>).$ARGUMENTS placeholder in the body is substituted with the arguments instead.The body is re-read at every execution, so file edits take effect without a restart.
File commands are low priority: when a plugin has already registered the same name, the file is skipped with a warning and the programmatic registration wins (no backfill while it lives).
Existing roots are watched with Chokidar (realpathed anchor, depth: 1, awaitWriteFinish stability). A missing root is probed from the nearest existing ancestor with fs.watchFile, so creating ~/.dsh/commands later still attaches. Root deletion unregisters everything and reverses to the probe; recreation rescans. commands/change is emitted by the registry itself.
| Field | Default | Meaning |
|---|---|---|
dshHome | $DSH_HOME or ~/.dsh | Config root; scans commands under it. |
commandDirs | [] | Extra command roots scanned after <dshHome>/commands. |
watch | true | Watch command roots for registry updates. |
watchUsePolling | false | Use Chokidar polling instead of native events. |
watchStabilityThresholdMs | 200 | Stable-write window for Chokidar events. |
watchPollIntervalMs | 100 | Polling/stability and missing-path probe interval. |
watchFollowSymlinks | true | Follow symbolic links while watching roots. |
pnpm install
pnpm run build # tsc → lib/
pnpm run typecheck
pnpm run test # 30 tests: discovery, watcher, real Loader composition
@deepseek-ai/* packages are peer dependencies resolved from the dsh installation at runtime; the tests run against the published npm releases (currently dsh 0.2.0-rc.2).
MIT