dsh-inject

dsh-inject 是一个用于管理模型上下文的 DSH 插件：在模型请求前对指定角色的消息做关键词/正则替换，并按会话启用多个上下文预设；还可以在会话当前位置插入构造回合。

安装

npm install dsh-inject

把 dsh-inject 加入 profile 的 dsh.profile.bundles。

核心语义

• 只改请求，不改会话：自动替换发生在发给模型的请求副本上；会话记录和界面显示的原始消息保持不变。
• 默认关闭：任何会话一开始都没有启用预设。
• 会话级：/inject 的启用状态只作用于当前会话。
• 零副作用：启用状态是进程内状态，不写入会话日志；关掉预设等于从未启用。
• 会话级状态在进程重启后重置为默认关闭。

配置（设置页 → Inject）

设置页可以建立任意多个预设，每个预设包含两部分：

1. 自动替换：多条规则，每条可选「关键词」或「正则」，填写替换文本，并勾选生效角色：用户 / 助手 / 工具返回。
2. 开头构造回合：放进请求最前面的消息，角色可选 系统 / 助手 / 用户 / 工具。

另外可维护构造回合模板，供现场 dialog 与 /inject-turn 复用。

命令

/inject                        查看当前会话启用了哪些预设
/inject on <预设名...>          启用（可一次多个）
/inject off <预设名...>         关闭
/inject clear                  关闭本会话全部预设
/inject-turn                   打开「插入构造回合」窗口
/inject-turn <模板名>           把模板内容排进下一次请求
/inject-turn <JSON 数组>        现场构造，如 [{"role":"user","text":"..."}]

现场注入 dialog

在输入框输入 /inject-turn 回车即可打开（不需要点任何按钮）：

• 现场增删消息与角色；
• 「载入模板…」载入已保存的模板；
• 填模板名后「保存为模板」写回配置；
• 「插入到当前位置」把内容排进下一次模型请求，不写入会话记录；
• Esc 关闭。

这是通过客户端命令装饰实现的：/inject-turn 的裸调用在客户端打开窗口，带参数时仍由宿主命令处理。

Keysmith 兼容与默认包含项

dsh-inject 原生兼容并默认预置 Keysmith（Keysmith Switch / codex-keysmith）规则体系：

• 默认预设：内置 Keysmith: Unrestricted 预设，包含其标志性的本地执行模式系统规约（Local execution mode active）及常用敏感词/边界词中性化替换规则；在未配置时作为默认包含项。
• 格式直接适配：规则对象直接兼容 Keysmith 格式（{ "from": "...", "to": "..." }），自动映射为 pattern、replacement 并绑定至用户输入（targets: ["user"]）。
• 一键导入：设置页提供「导入 Keysmith 规则」入口，支持一键批量解析粘贴的 Keysmith 规则包或规则数组。
• 安全保护机制：对以 / 开头的斜杠命令以及 <system-reminder>、<command-name> 等系统注入标签自动跳过改写，避免误伤系统指令或命令参数。

已知限制

• 未在界面上标记被替换的片段（原文照旧显示）。
• tool 角色的构造消息会转成带「工具返回」标记的用户上下文，避免出现没有对应工具调用的悬空 tool result。
• 现场 dialog 依赖 webServer 与 connection 服务；缺失时命令的参数形式仍可用，但窗口内插入会失败。
• 会话级启用状态是进程内的：重启后回到默认关闭。