dsh-input-history
适用于 DSH web composer 的独立方向键输入历史记录：每个已发送的提示词（按 Enter 或点击发送按钮，在任意会话或工作区中）都会持久化到 ~/.dsh/input-history.json 中的一个全局环形缓冲区（默认 100 条，可覆盖），并可通过 ↑/↓ 即时调取
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-input-history@0.2.0Input History 以 dsh-input-history 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
输入框 ↑/↓ 输入历史 独立插件，DeepSeek Harness (DSH) Web。
从 dsh-file-mention 拆分而来：每次发送（回车或点发送按钮，任意会话/工作区）都同步落库到一份全局历史环，↑/↓ 按键时同步读取，召回即时且完整——不做任何异步历史 RPC、没有失效刷新，彻底消除「历史不全/时有时无」的问题。
| 能力 | 说明 |
|---|---|
| 发送落库 | 输入框每次发送都同步记录：回车（捕获阶段 keydown，含 IME/trigger 菜单/锁定态守卫）与点发送按钮（点击后校验草稿被清空，即平台 commitSend 已执行）两条路径全覆盖 |
| 附件也记录 | 一条发送如实记录文本 + 图片 + 文件引用：草稿文本保留，待发送文件胶囊（dsh-file-upload）以 @token 引用形式、草稿图片以 [图片: 文件名] 标记形式并入同一条历史；图片-only/空文本发送不再被丢弃 |
| 原生召回 | ↑/↓ 召回时把历史原样恢复成输入框原生样式：文本进文本框、图片恢复成真实缩略图附件、文件引用恢复成待发胶囊（[图片: …]/@token 标记只留在历史文本里，不会堆进输入框）；仅当前页面会话内有效，重启后图片退化（文件 @token 文本仍保留） |
| 全局共享 | 历史环不绑定会话/工作区，任意会话、任意工作区共用一份；合并时折叠旧版 <file> 块回 @路径、跳过空白、连续重复只留一条 |
| ↑/↓ 导航 | 空输入框按 ↑ 召回上一条已发送 prompt；↑/↓ 在历史间移动；↓ 越过最新条恢复原始草稿；手动编辑自动退出浏览态；trigger 菜单打开时按键让位给菜单 |
| 持久化 | 历史环的耐久副本落在 DSH home 下的 input-history.json（$DSH_HOME 覆盖，默认 ~/.dsh/input-history.json），通过宿主半的围栏 API /input-history/api 读写（原子写：tmp+rename，并发写串行化）。localStorage 只作同步缓存（瞬时召回），启动时与宿主文件做一次并集合并（宿主序在前、本地独有条目追加在后），宿主落后时回写补齐 |
DSH Web 桌面端每次启动都在随机回环端口上提供服务（例如 127.0.0.1:64414），而 localStorage 以源（host+port）为作用域——端口一变，旧源的历史就「没了」。因此历史环的耐久副本必须落在宿主进程管理的用户目录文件里（~/.dsh/input-history.json），重启、换端口、清 localStorage 都不会丢。
dsh plugin --profile web add /path/to/dsh-input-history
dsh.bundle.patch 声明会让 CLI 自动把本包追加进 profile 的 bundles：宿主半挂载 /input-history/api 围栏路由并管理 ~/.dsh/input-history.json，客户端半负责记录、导航与启动时对账。然后重启 DSH 桌面应用并刷新页面。零运行时依赖，无 peer / 构建要求。
卸载：dsh plugin --profile web remove dsh-input-history。
开发迭代：改完代码运行 scripts/deploy.sh（同步 lib 到 profile 安装目录）后重启。
历史环上限默认 100 条；可在浏览器 console 里覆盖（下次发送生效，删除该键恢复默认）：
localStorage.setItem("dsh-input-history:history-limit", "200")
上限也会随每次写入持久化进宿主文件；重启后若未设置本地覆盖，会自动沿用宿主文件里的上限（否则换端口后上限会因 localStorage 丢失而重置回 100）。
┌ composer (ui-conversation, 不改) ─────────────────────────────┐
│ Enter keydown（window 捕获）→ 守卫（IME/菜单/锁定/忙碌） │
│ → recordFullSend：文本 + 待发胶囊 + 图片 Files → 落库 │
│ 发送按钮 click（捕获）→ 快照草稿+图片+待发胶囊 → 校验清空 │
│ → recordCaptured(快照) │
│ ↑/↓ keydown（捕获）→ loadHistory() 同步读全局环 │
│ → historyNav 纯函数 → applyRecall： │
│ 原生召回 = 原文本 setDraft + 图片重建附件 + 胶囊回 rail │
│ 内存附件表：Map<历史条目文本, {text, files, imageFiles}> │
│ （仅本页面会话；重启后清空 → 退化为文本召回） │
│ 发送捕获：imageIds → conversation.draftImages() 取 File/文件名│
│ 待发胶囊：window.__dsh_file_upload_pending__.chipsOf(session)│
│ 召回回写：window.__dsh_file_upload_pending__.setChips(...) │
│ 启动对账 → GET 宿主环 → 并集合并 → 本地落后则回写宿主 │
│ 每次落库 → 防抖 300ms 回写宿主（页面卸载 keepalive 兜底） │
│ 启动 warm → 一次性合并当前会话历史 prompt + 迁移旧键 │
└──────────────────────────────────────────────────────────────┘
│ 宿主半 (index.js)：围栏 POST 路由
│ history.read -> 读 ~/.dsh/input-history.json
│ history.write -> 校验/截断/上限 -> tmp+rename 原子写
▼
~/.dsh/input-history.json ← 耐久副本
window.__ModuleLoader__.load 约定注册，不 require 任何模块（纯逻辑，无 React），规避 externals 漂移，无需打包器。/api 网关一致的浏览器信任围栏（回环 Host 或 webRuntime.trustedHosts + 同源标记），POST-only、JSON 体上限 1MB。@token，dsh-file-mention 已在草稿文本里；dsh-file-upload 待发胶囊经其 window.__dsh_file_upload_pending__ 钩子读取/回写）与图片（[图片: 文件名] 标记）都并入历史入口。@token 保留、可重发；图片只剩 [图片: 文件名] 标记，不可重建）data-composer-card），DSH 前端大版本变更时需适配sessions.history RPC（尽力而为，失败则从空环开始累积，不影响发送落库与 ↑/↓ 导航）window.__dsh_file_upload_pending__ 钩子（chipsOf 读取 / setChips 回写）；该插件缺席或尚未挂载时，待发文件引用退化为不记录（草稿文本照常记录）node --test test/*.test.js
26 个用例：客户端（块折叠、图片/待发文件合成、历史状态机、历史环落库、上限覆盖/损坏容错、旧键迁移、prompt 提取（含图片）、并集合并、宿主 API 调用、启动对账幂等）+ 宿主（路径解析、环归一化、文件原子读写、路由与围栏、并发写串行化、插件形状）。