dsh-composer-history · DSH Hub

$ 你打了半句话，按 ↑
        └─ 草稿被暂存，最新一条历史填入输入框
$ ↑ ↑ … 走到更旧        $ ↓ ↓ … 走回最新
        └─ 最旧处 hold（拦截但不修改）      └─ 再按一次 ↓：你的草稿回来了，
                                              光标也停在原来的位置
$ 任何时刻按 Esc → 立即复原，浏览结束

cd Project/Plugins/dsh-composer-history
pnpm install
pnpm run typecheck && pnpm run build && pnpm run test   # 全绿：94/94

构建插件（见上）。

在 $DSH_HOME/profiles//cordis.patch.yml 注册。行 name 必须用裸包名：浏览器图行 id 就是这串字符串，而客户端 bundle 在构建期内嵌的加载 id 与之一致。

# 追加在 bundle 层之后
- insert:
    - id: composer-history
      name: dsh-composer-history
      config:
        recallWithDraft: save     # 'save' | 'gate'
        restoreOnEscape: true
        edgeMode: logical         # 'logical' | 'visual'
        enableCtrlAlias: true
        restoreCaret: true

裸行还必须出现在 profile 的解析器清单里——host Loader 从 profile 目录的 node_modules 解析它：

$DSH_HOME/profiles//package.json：

{
  "name": "dsh-profile-",
  "private": true,
  "dependencies": {
    "dsh-composer-history": "file:D:/deepseek-harness/Project/Plugins/dsh-composer-history"
  },
  "dsh": {
    "profile": {
      "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app"]
    }
  }
}

在 profile 目录执行 pnpm install，然后：
```
dsh --profile  --port 3080
```

字段	类型	默认	说明
`recallWithDraft`	`'save' \| 'gate'`	`'save'`	`save`：非空草稿先暂存再召回；`gate`：仅空草稿允许召回（对齐 Claude/Codex 门控）
`restoreOnEscape`	`boolean`	`true`	BROWSING 中按 Esc 复原暂存草稿
`edgeMode`	`'logical' \| 'visual'`	`'logical'`	按 `\n` 逻辑行判定边缘，或按 mirror 实测折行判定
`enableCtrlAlias`	`boolean`	`true`	Ctrl+↑/↓ 与裸方向键同义
`restoreCaret`	`boolean`	`true`	回到底部/Esc 复原时一并恢复暂存光标

按键	状态	行为
↑	IDLE，光标在首行	暂存 {草稿, 光标}，填入最新一条，光标移到末尾（无历史则放行）
↑	BROWSING，光标在首行	更旧一条；到最旧处 hold（拦截但不修改）
↑	光标不在首行	完全放行（浏览器移动光标）
↓	IDLE	一律放行（普通光标移动）
↓	BROWSING，光标在末行	更新一条；已在最新 → 复原 `savedDraft` + `savedCaret` → IDLE
↓	光标不在末行	完全放行
Esc	BROWSING（`restoreOnEscape: true`）	复原 `savedDraft` + `savedCaret` → IDLE，拦截
Esc	其他	放行（菜单/弹层的 Esc 语义不受影响）
Ctrl+↑/↓	`enableCtrlAlias: true`	与裸方向键同义
Shift/Alt/Meta+方向键、IME 组合、有选区	任意	一律放行

基线：本机检出 D:\deepseek-harness（client 包 lib/types 构建于 2026-08-13）；client 包 0.1.0-rc.5（npm 最新为 0.1.0-rc.6，rc.5 未发布）；@deepseek-ai/cordis 4.0.1；@deepseek-ai/schemastery 3.18.1。
InputState 相位（实读 packages/client/ui-conversation/src/client/input/contract.ts）：'plain' | 'adjudicating' | 'claimed' | 'submitting'，另含 draft/draftRev。写草稿唯一通道是 ctx.conversation.input.for(actx).setDraft(text)。
客户端插件元数据字段是嵌套 dsh.client（packages/client/modules 的 resolveMeta 读 pkg.dsh.client）：放错位置会被静默丢出 boot 图，无报错。
vendored cordis 已更名 @deepseek-ai/cordis：类型导入一律 type-only；实测 lib/client.js 零 cordis 运行时导入（无任何 require( 调用）。
浏览器 boot 不向插件传 config（boot 图只含 {id, url, rev, inject, immediately}）：浏览器半用 schema 默认值；cordis.yml 的 config: 由 host Loader 按同一 schema 校验。实测 recallWithDraft: bogus 使整个启动中止：failed to apply loader entry composer-history … $.recallWithDraft expected "save" | "gate" but got "bogus"。
改源码后必须重新 build 再启动：启动校验读 lib/client.js，未构建直接拒绝；浏览器也只拉到构建产物。
只依赖官方包已导出符号：跨包读状态只用 @deepseek-ai/dsh-client-* 包 /client 入口导出的类型与服务；把 inputTriggers 服务断言为 InputTriggerService 是社区通行做法（本插件以 type-only 导入 + ctx.get('inputTriggers') as InputTriggerService | undefined 实现，注释说明理由）。
客户端 bundle 契约：CJS 工厂包裹 window.__ModuleLoader__.load({ id, factory })，平台模块（react、cordis、slots 等 + @deepseek-ai/dsh-client-runtime/client 豁免）保持外部化，其余依赖内联；本插件运行时零外部依赖，tsdown 配置按该清单防御性声明。
外部插件类型检查：npm 无 rc.5，经 tsconfig paths 指向本机检出 packages/client/*/lib/types/client/index.d.ts + skipLibCheck；更新检出后需重跑 typecheck。
profile 文件必须无 UTF-8 BOM（readProfileManifest 直接 JSON.parse；实测 BOM 导致 Unexpected token '\uFEFF' 启动失败）。

dsh-composer-history

安装

说明文档

⌨️ dsh-composer-history

✨ 亮点

🎬 使用体验

🚀 快速开始

📦 安装

⚙️ Config

🎹 键位表

✅ 验证方法

🔬 兼容基线（本机实测，2026-08-13）

⚠️ 已知边界

🏷️ 话题与生态

📄 License