dsh-command-opt/cordis.patch.yml at master · csiroqa/dsh-command-opt · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
# @dsh-external/dsh-command-opt bundle patch: inserts its plugin row into the
# profile roster. Install with:
#   dsh plugin --profile web add link:<this-directory>
#
# The single row mounts BOTH halves: the host placeholder (engine entry) and
# the browser side (Tab/Enter 补全 + 命令提示弹框 + subagent 补丁 +
# 空对话命令输出修复, via the dsh.client declaration in package.json).
#
# config 详解（全部可选）：
#
# 注意：dsh 固有逻辑 —— 浏览器半区收不到 patch 的 config（manifest 行与
# 浏览器端 loader.create 均不携带 config，patch config 只到达 host 半区）。
# 因此本插件的默认值内置在代码（src/client/index.ts 的 Config），
# 下方 config 仅为 host 半区扩展与文档展示保留，修改它不会改变浏览器行为。
#
#   tabComplete     Tab/Enter 补全命令名（默认 true）：composer 中键入
#                   '/前缀' 后按 Tab（或菜单高亮时按 Enter），按当前会话
#                   命令目录补全——草稿任意位置可用（词边界规则与内置
#                   slash 菜单一致：草稿起始/空白/标点之后，URL 除外），
#                   不做 inline 过滤（内置菜单会把带参数位的命令从 inline
#                   候选滤掉、空即自关，本插件在任意位置给出全部候选）。
#                   匹配：前缀优先，无前缀命中回退菜单同款模糊打分；
#                   最近使用过的命令置顶；唯一匹配直接补全，多匹配先补
#                   最长公共前缀，再按 Tab 轮转候选。菜单高亮优先：↑↓
#                   选中的命令就是 Tab/Enter 的补全目标（Enter 在 token
#                   已是选中命令时交还 composer 回车执行/claim）。行首
#                   补全到带参数位的命令时直接进入 claim：参数格式
#                   （input hint）幽灵文本与输入对齐；claim 阶段按 Tab
#                   轮转参数选项（hint 的 '|' 枚举，如 /plan off|message）。
#                   无匹配时给出引导 notice。
#   subagentPatch   tool 开启的会话（subagent）补丁（默认 true）：内置
#                   命令目录对 subagent 返回空（ui-commands 刻意过滤），
#                   菜单与回车仲裁不可用，导致此类对话"没有选项"、
#                   无法执行 /archive 等操作——本插件目录直连宿主，
#                   提示弹框照常显示命令选项；回车时完整命令直接执行
#                   （成功消费 token），部分命令先补全；并在会话头部
#                   注册"操作"菜单（仅 subagent 会话显示）：归档
#                   （/archive）、复制会话、定位父会话——内置头部动作
#                   对 subagent 会话全部渲染 null，头部原本没有按钮。
#   hintPopup       命令提示弹框（默认 true）：conversation.input.overlay
#                   槽位（与内置 slash 菜单同一浮动锚点、同风格，不被
#                   默认 UI 遮挡）。输入命令参数时始终显示弹框并固定在
#                   对应命令下：claim 阶段显示参数模板（命令后的"说明"
#                   位置改为参数 input hint，高亮当前待填参数，如
#                   /schedule 的 'list | add <cron> <提示词...> | …'——
#                   输入参数后提示不再消失）；plain 阶段在内置菜单未
#                   展示时兜底显示候选（inline 过滤 / 菜单关闭场景）。
#   blankEngage     空对话命令输出修复（默认 true）：在空会话（blank）
#                   中执行 /命令 后，宿主仍把会话判为 blank（命令节点不
#                   翻转 blank，见 harness apiproxy 的 blank 推导），会话
#                   视图被隐藏导致命令输出不可见、头部无选项按钮、且
#                   "新对话"的复用扫描会把该会话当作空会话合并——插件
#                   检测到"纯命令节点会话"时激活会话（翻转会话端与
#                   列表摘要的 blank，与首次发送同路径的 engaged 变更），
#                   使输出正常渲染、选项按钮出现、不再被新对话复用；
#                   摘要被宿主刷新刷回 blank 时自动重武装。
#   catalogTtlMs    命令目录缓存 TTL（毫秒，默认 15000；commands/change
#                   与 agent-preset/selected 事件会主动失效对应条目）
- insert:
    - id: command-opt
      name: '@dsh-external/dsh-command-opt'
      config:
        tabComplete: true
        hintPopup: true
        subagentPatch: true
        blankEngage: true
        catalogTtlMs: 15000