deepseekplugins

DeepSeek Harness plugin

dsh-command-opt

DSH 命令优化插件：Tab/Enter 补全命令名、参数格式引导与提示弹框、tool 开启会话（subagent）补丁、空对话命令输出修复

Workflow & Automation
Jump to install

Source facts

Repository
csiroqa/dsh-command-opt
Latest update
Aug 13, 2026
Category
Workflow & Automation
GitHub stars
2
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/csiroqa/dsh-command-opt
Plugin: dsh-command-opt
Author: csiroqa

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer4 files
README.mdSource · read only
README language

dsh-command-opt

![CI](https://github.com/csiroqa/dsh-command-opt/actions/workflows/ci.yml)

DeepSeek Harness（DSH）的命令优化插件：Tab/Enter 补全命令名、参数格式引导与提示弹框、tool 开启会话（subagent）补丁、空对话命令输出修复。

English: README.en.md

功能

  • Tab/Enter 补全：composer 中键入 /前缀 后按 Tab（或菜单高亮时按 Enter），按当前会话命令目录补全——草稿任意位置可用；前缀优先、无前缀命中回退菜单同款模糊打分，最近使用过的命令置顶；多匹配先补最长公共前缀，再按 Tab 轮转候选；菜单 ↑↓ 高亮优先，Tab 与 Enter 都补全为选中的命令
  • 参数格式引导：行首补全到带参数位的命令时直接进入 claim，参数格式（input hint）幽灵文本与输入对齐；claim 阶段按 Tab 轮转参数选项（hint 的 | 枚举，如 /plan off|message）
  • 命令提示弹框：conversation.input.overlay 槽位、与内置菜单同锚点同风格——输入命令参数时始终显示弹框并固定在对应命令下，高亮当前待填参数（多参数命令如 /schedule 输入参数后提示不再消失）；内置菜单未展示时兜底显示候选（命令后跟参数而非说明）
  • tool 开启的会话（subagent）补丁：内置命令目录对 subagent 返回空，导致此类对话"没有选项"、无法执行 /archive 等操作——本插件目录直连宿主，提示弹框照常显示命令选项；回车时完整命令直接执行；会话头部注册"操作"菜单（归档 / 复制会话 / 定位父会话）
  • 空对话命令输出修复：空会话中执行 /命令 后输出正常渲染、头部选项按钮出现、不再被"新对话"复用扫描当作空会话合并
  • 目录缓存：键入 / 即预热、commands/change 与 agent-preset/selected 事件主动失效、TTL 兜底、同会话并发去重、会话删除时剪枝

配置

安装后，cordis.patch.yml 的 command-opt insert 行支持以下可选 config（注意：dsh 固有逻辑——浏览器半区收不到 patch config，默认值内置在代码里，修改 config 不会改变浏览器行为）：

键默认说明
tabCompletetrueTab/Enter 补全命令名
hintPopuptrue命令提示弹框（conversation.input.overlay）
subagentPatchtruetool 开启的会话（subagent）补丁
blankEngagetrue空对话命令输出修复
catalogTtlMs15000命令目录缓存 TTL（毫秒）

安装

前置：Node.js >= 22、pnpm、本机 deepseek-harness 源码检出（依赖以 link: 指向 ../deepseek-harness）。

git clone https://github.com/csiroqa/dsh-command-opt.git
cd dsh-command-opt
pnpm install
pnpm build

# 安装进 web profile（link: 指向本目录）
dsh plugin --profile web add link:$(pwd)        # POSIX
dsh plugin --profile web add link:D:\path\to\dsh-command-opt   # Windows

重启 dsh web，浏览器 Ctrl+F5 硬刷新。

使用

1. 输入 / + 前缀，按 Tab 补全命令名（多候选先补公共前缀，再按 Tab 轮转；↑↓ 选中后 Tab/Enter 补全选中项）

2. 行首补全到带参数位的命令（如 /schedule）后直接进入参数位：幽灵提示显示参数格式，Tab 轮转 | 枚举选项，输入参数全程提示弹框常驻

3. 在 tool 开启的会话中：回车直接执行 /archive 等命令，头部"操作"菜单提供归档 / 复制会话 / 定位父会话 4. 空会话里执行命令后：输出正常渲染、选项按钮出现、不会被下一次"新建对话"复用

兼容性

  • 平台：Windows / macOS / Linux（Node >= 22）——三平台构建与冒烟测试经 GitHub Actions CI 验证
  • 针对 DSH 0.1.0-rc.5+ 源码检出开发验证；依赖 dsh-client-runtime 的公开面，少量内部面（会话激活的 handleBlank/promptAttempted、列表摘要的 recordMutation）以运行时特性检测保护，缺失时静默降级
  • 已知限制：空对话激活是浏览器侧行为，宿主 summary 仍报 blank，刷新页面后该会话会从列表消失（直到有真实 turn）；浏览器半区收不到 patch config，默认值内置在代码
  • 构建产物：tsdown（host 半区 lib/index.js + browser 半区 lib/client.js，标准 window.__ModuleLoader__.load 闭包工厂格式）

安全说明

  • 插件只在本机页面上生效，不涉及网络监听
  • 插件代码以 link: 指向本仓库目录安装，改动源码后重新构建（pnpm build）并硬刷新即可生效

许可与使用声明

MIT License（见 [LICENSE](LICENSE)）。

欢迎任何人使用、修改、引用、或把本项目收录进自己的插件合集，只需：

  • 保留 LICENSE 文件与版权声明
  • 标明出处（本仓库链接）

相关

Back to searchOpen GitHub repository

More related plugins

View category