dsh-shell-cmd

DeepSeek Harness（dsh）插件：在输入框输入 /cmd <终端命令>，先执行命令，再把「命令 + 输出」一起发给模型，并让这次输入在对话里以终端卡片渲染，而不是一段纯文本 prompt。

对标 Claude Code 的 !<command> 能力，区别是这里会把命令与输出明确交给模型，并要求模型据此回复。

效果

你： /cmd git status --short

  ⬢ 终端命令  $ git status --short              [完成]
  ┌────────────────────────────────────────────────────┐
  │ M src/App.tsx                                      │
  │ ?? tests/new.test.ts                               │
  └────────────────────────────────────────────────────┘
  M src/App.tsx · ?? tests/new.test.ts        [展开全部 2 行] [复制命令与输出]

模型：当前工作区有 1 个已修改文件和 1 个未跟踪文件……

命令卡片：等宽字体、$ 提示符、状态胶囊（执行中 / 退出码 / 超时 / 取消）、可展开的长输出、复制按钮。
输入提示：输入框草稿进入 /cmd 模式时，下方出现「终端命令模式」提示条。
模型输入：一条 user 消息，正文包含「用户手动执行了此命令」、命令原文、cwd、退出状态与 stdout/stderr。
会话标题：执行 /cmd 时自动用命令本身命名当前会话（例如侧边栏从「未命名」变成 git status --short）。
历史回放：卡片从 command/run + command/done 折叠出的 CommandNode 重建，重开会话/刷新后仍在。

使用

在输入框键入 /，从命令菜单选择 cmd（或直接输入 /cmd ），菜单会显示命令说明与输入提示。
在 /cmd 之后写终端命令，回车提交。命令在当前会话工作目录执行。
命令结束后，模型会自动收到命令与输出并给出回复。

示例：

/cmd ls -la
/cmd git log --oneline -5
/cmd cat package.json
/cmd npm test

行为细节

情况	表现
命令退出码非 0	卡片显示红色 `退出 N` 胶囊；输出照常发给模型（非零退出是结果，不是插件错误）
命令超时	默认 120s 后杀掉进程，卡片显示 `已超时`，输出与超时标记发给模型
执行器报错（如无法启动）	卡片显示错误文本，不会触发模型轮次
输出过长	单流最多读取 256 KiB；卡片与模型文本各自截断到 24k 字符并标注省略量
会话正在运行	命令照常执行；命令消息经 `agent.followup()` 排队，等当前轮次结束再送达
取消	命令执行绑定 UI 请求的取消信号；被取消时不向模型发送任何内容
会话标题	执行前用命令命名当前会话（见下节）

会话标题规则

/cmd 通过 ctx.sessionTitle.rename(session, 命令) 显式命名会话（source: 'user'，会固定标题，之后自动标题不再覆盖）：

当前标题状态	`/cmd` 的行为
还没有标题（新会话、侧边栏「未命名」）	写入命令本身
自动生成的标题（`fallback` / `provider`）	覆盖为命令
本插件之前写入的标题	更新为最新一次命令
用户手动改过的标题（`source: 'user'` 且不是本插件写的）	保持不动，尊重用户命名

命令会先做一行化处理（换行/连续空白折叠为单个空格），最终长度由标题服务的 maxTitleBytes 截断。标题失败（例如被服务拒绝）不影响命令执行。若不需要这个行为，在行配置里加 nameSession: false。

安全说明

/cmd 是人类显式输入的命令，等价于用户自己在终端执行，因此默认不套用模型工具的 sandbox 策略（不传 sandboxPolicy）。它不是模型发起的工具调用；模型只能看到执行结果，不能借此执行命令。

安装

本地目录安装（开发中）：

plugin_manager action=install_bundle target=/Users/lzx/Documents/GitHub/dsh-shell-cmd

安装后 bundle 会写入当前 profile 的 package.json（dsh.profile.bundles）并插入一行 Host 插件：

- insert:
    - id: shell-cmd
      name: dsh-shell-cmd

Host 行 / Client 半端分别是 index.js 与 client.js，由 package.json 的 dsh.bundle.patch 与 dsh.client 声明。

从 Git 仓库安装 / 发布（可复用）

开发时用上面的本地链接安装；需要“推送仓库、并从 GitHub 仓库重装到当前 profile”时用脚本：

scripts/publish-install.sh              # 提交 + push + 用当前 commit 的 GitHub 归档安装 + 校验
scripts/publish-install.sh --dry-run    # 只打印计划
scripts/publish-install.sh --no-push    # 不推送（该 commit 必须已在远端）
scripts/publish-install.sh --profile web --mode git

选项	说明
`--profile <name>`	目标 profile，默认 `$DSH_PROFILE`，否则 `desktop`
`--message <msg>`	自动提交的提交信息
`--mode tarball\|git`	安装源形式：GitHub 归档 URL（默认）或 `github:owner/repo#sha`
`--spec <spec>`	直接指定交给 `dsh plugin add` 的 spec（私有仓库/自定义源）
`--no-push` / `--no-commit` / `--dry-run`	跳过推送 / 跳过自动提交 / 只打印

脚本通过官方 CLI 安装，CLI 会把声明了 dsh.bundle 的包自动写入 dsh.profile.bundles：

dsh plugin --profile "$DSH_PROFILE" add --prefer-offline "https://codeload.github.com/<owner>/<repo>/tar.gz/<sha>"

macOS Desktop 下脚本会自动使用 App 内置的 runtime pnpm（与插件管理器同版本，避免重解析整个 lockfile）；可用 DSH_PNPM 覆盖。前置条件：仓库已配置 origin；默认源要求仓库公开（匿名 tarball），私有仓库用 --spec 传带凭据的 git spec；dsh CLI 在 PATH 上。安装后 Host 模块需在插件页拨动开关或重启 DSH 才生效；只改 client.js 时刷新页面即可。

架构

用户输入 /cmd <cmd>
        │
        ▼
[Host] commands 服务解析并调用 handler
        │  0. ctx.sessionTitle.rename(session, 命令)          ← 侧边栏会话名立即更新
        │  1. ctx.shell.resolve / execute（cwd=会话工作目录，前台等待，带超时与取消）
        │  2. 组装正文：stdout + [stderr] + 状态标记
        │  3. agent.followup(user 消息：命令 + cwd + exit + 输出) ← 模型据此回复
        ▼
[会话日志] session/title + command/run + command/done（均 log-only，不进模型历史）
        │
        ▼
[Client] conversation.chat.commandview，key = "cmd"  →  终端卡片

关键契约：

Host 半端导出 { name, inject, apply }，inject = ['commands', 'shell', 'workingDirectory']；缺失任一服务时插件保持 inactive 而不是抛错。sessionTitle 为可选服务（ctx.get），缺失时只跳过命名。
不静态 import 任何 @deepseek-ai/* 核心包：本地链接安装的插件在工作区内无法解析 dsh 安装内的包。UserMessage 按 createUserMessage() 的等价结构就地构造（id / role / content / source）。
Client 半端是 window.__ModuleLoader__ 的懒工厂 classic script，只能 require('react')，无 JSX；样式经 <style data-plugin-css> 注入并在 ctx.effect 中清理。
卡片注册在 conversation.chat.commandview（按命令名键控、replaceRisk: none 的公开扩展点），不替换任何内置渲染器。
所有颜色走 --dsw-alias-* 主题令牌，明暗主题与主题切换自动跟随。

模型看到的输入（示意）

The user ran the following shell command from the DSH composer (/cmd). Respond to the user
based on the command and its output; the command was not run by you.

$ git status --short
cwd: /Users/me/project
exit: 0

 M src/App.tsx
?? tests/new.test.ts

消息 source.kind = "shell-command"。UI 上它表现为一条默认折叠的“Execution requested”turn-trigger 通知，正文只在用户主动展开时显示——可见的输入表达始终是上方的终端卡片。

可调常量与行配置

index.js 顶部导出：

常量	默认值	含义
`DEFAULT_TIMEOUT_MS`	`120000`	单条命令超时（毫秒）
`DEFAULT_MAX_OUTPUT_CHARS`	`24000`	卡片与模型文本各自保留的最大字符数
`STDOUT_MAX_BYTES`	`262144`	执行器侧单流读取上限

当前版本未导出 Config（避免依赖 schemastery）；apply(ctx, config) 仍会读取行配置中的 timeoutMs / maxOutputChars / nameSession（若 Loader 透传）。

开发与验证

npm run check   # node --check index.js && node --check client.js
npm test        # node --test "tests/**/*.test.mjs"  （Host 半端纯函数、执行路径与会话标题单测）
npm run verify  # check + test

已知边界

卡片渲染只在 Web / Desktop 的 Chat 视图生效；纯文本入口（CLI、ACP、JSON-RPC）没有 slash 命令表面，也就没有 /cmd。
会话全空的“新会话”在第一条命令时可能先记录 command/run 再激活会话；卡片随会话激活出现（与内置命令行一致）。
会话标题一旦由 /cmd 写入即为显式标题（user pin），之后不会再被自动标题改写；不想要这个行为时用 nameSession: false。
输出上限是为了保护会话日志与模型上下文；需要完整输出时请改用重定向到文件再 /cmd cat <file>。
不提供 shell 持久化：每次 /cmd 都是独立的 bash -c 会话，cd 不会跨调用保留。

License

MIT

dsh-shell-cmd

对标 Claude Code 的 !<command> 能力，区别是这里会把命令与输出明确交给模型，并要求模型据此回复。

效果

你： /cmd git status --short

  ⬢ 终端命令  $ git status --short              [完成]
  ┌────────────────────────────────────────────────────┐
  │ M src/App.tsx                                      │
  │ ?? tests/new.test.ts                               │
  └────────────────────────────────────────────────────┘
  M src/App.tsx · ?? tests/new.test.ts        [展开全部 2 行] [复制命令与输出]

模型：当前工作区有 1 个已修改文件和 1 个未跟踪文件……

命令卡片：等宽字体、$ 提示符、状态胶囊（执行中 / 退出码 / 超时 / 取消）、可展开的长输出、复制按钮。
输入提示：输入框草稿进入 /cmd 模式时，下方出现「终端命令模式」提示条。
模型输入：一条 user 消息，正文包含「用户手动执行了此命令」、命令原文、cwd、退出状态与 stdout/stderr。
会话标题：执行 /cmd 时自动用命令本身命名当前会话（例如侧边栏从「未命名」变成 git status --short）。
历史回放：卡片从 command/run + command/done 折叠出的 CommandNode 重建，重开会话/刷新后仍在。

使用

在输入框键入 /，从命令菜单选择 cmd（或直接输入 /cmd ），菜单会显示命令说明与输入提示。
在 /cmd 之后写终端命令，回车提交。命令在当前会话工作目录执行。
命令结束后，模型会自动收到命令与输出并给出回复。

示例：

/cmd ls -la
/cmd git log --oneline -5
/cmd cat package.json
/cmd npm test

行为细节

情况	表现
命令退出码非 0	卡片显示红色 `退出 N` 胶囊；输出照常发给模型（非零退出是结果，不是插件错误）
命令超时	默认 120s 后杀掉进程，卡片显示 `已超时`，输出与超时标记发给模型
执行器报错（如无法启动）	卡片显示错误文本，不会触发模型轮次
输出过长	单流最多读取 256 KiB；卡片与模型文本各自截断到 24k 字符并标注省略量
会话正在运行	命令照常执行；命令消息经 `agent.followup()` 排队，等当前轮次结束再送达
取消	命令执行绑定 UI 请求的取消信号；被取消时不向模型发送任何内容
会话标题	执行前用命令命名当前会话（见下节）

会话标题规则

/cmd 通过 ctx.sessionTitle.rename(session, 命令) 显式命名会话（source: 'user'，会固定标题，之后自动标题不再覆盖）：

当前标题状态	`/cmd` 的行为
还没有标题（新会话、侧边栏「未命名」）	写入命令本身
自动生成的标题（`fallback` / `provider`）	覆盖为命令
本插件之前写入的标题	更新为最新一次命令
用户手动改过的标题（`source: 'user'` 且不是本插件写的）	保持不动，尊重用户命名

安全说明

安装

本地目录安装（开发中）：

plugin_manager action=install_bundle target=/Users/lzx/Documents/GitHub/dsh-shell-cmd

安装后 bundle 会写入当前 profile 的 package.json（dsh.profile.bundles）并插入一行 Host 插件：

- insert:
    - id: shell-cmd
      name: dsh-shell-cmd

Host 行 / Client 半端分别是 index.js 与 client.js，由 package.json 的 dsh.bundle.patch 与 dsh.client 声明。

从 Git 仓库安装 / 发布（可复用）

开发时用上面的本地链接安装；需要“推送仓库、并从 GitHub 仓库重装到当前 profile”时用脚本：

scripts/publish-install.sh              # 提交 + push + 用当前 commit 的 GitHub 归档安装 + 校验
scripts/publish-install.sh --dry-run    # 只打印计划
scripts/publish-install.sh --no-push    # 不推送（该 commit 必须已在远端）
scripts/publish-install.sh --profile web --mode git

选项	说明
`--profile <name>`	目标 profile，默认 `$DSH_PROFILE`，否则 `desktop`
`--message <msg>`	自动提交的提交信息
`--mode tarball\|git`	安装源形式：GitHub 归档 URL（默认）或 `github:owner/repo#sha`
`--spec <spec>`	直接指定交给 `dsh plugin add` 的 spec（私有仓库/自定义源）
`--no-push` / `--no-commit` / `--dry-run`	跳过推送 / 跳过自动提交 / 只打印

脚本通过官方 CLI 安装，CLI 会把声明了 dsh.bundle 的包自动写入 dsh.profile.bundles：

dsh plugin --profile "$DSH_PROFILE" add --prefer-offline "https://codeload.github.com/<owner>/<repo>/tar.gz/<sha>"

架构

用户输入 /cmd <cmd>
        │
        ▼
[Host] commands 服务解析并调用 handler
        │  0. ctx.sessionTitle.rename(session, 命令)          ← 侧边栏会话名立即更新
        │  1. ctx.shell.resolve / execute（cwd=会话工作目录，前台等待，带超时与取消）
        │  2. 组装正文：stdout + [stderr] + 状态标记
        │  3. agent.followup(user 消息：命令 + cwd + exit + 输出) ← 模型据此回复
        ▼
[会话日志] session/title + command/run + command/done（均 log-only，不进模型历史）
        │
        ▼
[Client] conversation.chat.commandview，key = "cmd"  →  终端卡片

关键契约：

Host 半端导出 { name, inject, apply }，inject = ['commands', 'shell', 'workingDirectory']；缺失任一服务时插件保持 inactive 而不是抛错。sessionTitle 为可选服务（ctx.get），缺失时只跳过命名。
不静态 import 任何 @deepseek-ai/* 核心包：本地链接安装的插件在工作区内无法解析 dsh 安装内的包。UserMessage 按 createUserMessage() 的等价结构就地构造（id / role / content / source）。
Client 半端是 window.__ModuleLoader__ 的懒工厂 classic script，只能 require('react')，无 JSX；样式经 <style data-plugin-css> 注入并在 ctx.effect 中清理。
卡片注册在 conversation.chat.commandview（按命令名键控、replaceRisk: none 的公开扩展点），不替换任何内置渲染器。
所有颜色走 --dsw-alias-* 主题令牌，明暗主题与主题切换自动跟随。

模型看到的输入（示意）

The user ran the following shell command from the DSH composer (/cmd). Respond to the user
based on the command and its output; the command was not run by you.

$ git status --short
cwd: /Users/me/project
exit: 0

 M src/App.tsx
?? tests/new.test.ts

可调常量与行配置

index.js 顶部导出：

常量	默认值	含义
`DEFAULT_TIMEOUT_MS`	`120000`	单条命令超时（毫秒）
`DEFAULT_MAX_OUTPUT_CHARS`	`24000`	卡片与模型文本各自保留的最大字符数
`STDOUT_MAX_BYTES`	`262144`	执行器侧单流读取上限

当前版本未导出 Config（避免依赖 schemastery）；apply(ctx, config) 仍会读取行配置中的 timeoutMs / maxOutputChars / nameSession（若 Loader 透传）。

开发与验证

npm run check   # node --check index.js && node --check client.js
npm test        # node --test "tests/**/*.test.mjs"  （Host 半端纯函数、执行路径与会话标题单测）
npm run verify  # check + test

已知边界

卡片渲染只在 Web / Desktop 的 Chat 视图生效；纯文本入口（CLI、ACP、JSON-RPC）没有 slash 命令表面，也就没有 /cmd。
会话全空的“新会话”在第一条命令时可能先记录 command/run 再激活会话；卡片随会话激活出现（与内置命令行一致）。
会话标题一旦由 /cmd 写入即为显式标题（user pin），之后不会再被自动标题改写；不想要这个行为时用 nameSession: false。
输出上限是为了保护会话日志与模型上下文；需要完整输出时请改用重定向到文件再 /cmd cat <file>。
不提供 shell 持久化：每次 /cmd 都是独立的 bash -c 会话，cd 不会跨调用保留。

License

MIT

xx529/dsh-shell-cmd

dsh-shell-cmd

效果

使用

行为细节

会话标题规则

安全说明

安装

从 Git 仓库安装 / 发布（可复用）

架构

模型看到的输入（示意）

可调常量与行配置

开发与验证

已知边界

License

Community comments

xx529/dsh-shell-cmd

dsh-shell-cmd

效果

使用

行为细节

会话标题规则

安全说明

安装

从 Git 仓库安装 / 发布（可复用）

架构

模型看到的输入（示意）

可调常量与行配置

开发与验证

已知边界

License

Community comments