跳到正文
dsh-market 浏览插件 GitHub EN

PerryLink/dsh-composer-history

Web 作曲器终端风格输入历史：边缘优先的方向键召回并精确还原草稿与光标、浏览器本地持久化历史、Ctrl+R 反向搜索，以及滑动上下文感知；0.5.0 再加智能输入层——跨会话片段库（/save、/load）、带变量的提示词模板、复用洞察与压缩摘要高亮。

Star 数 ★ 6 分类 UI 增强 收录于 2026-08-15 npm dsh-composer-history

安装

在 DeepSeek Harness 里通过 dsh-market 安装

dsh plugin --profile web add dshmarket

或使用命令行

dsh plugin --profile web add dsh-composer-history

装任何插件都等于在你的机器上跑第三方代码，权限和你本人一样大——能读你的文件、用你的凭据、访问网络。请先审阅源码，并尽量锁定 commit（github:owner/repo#sha）。

README

⌨️ dsh-composer-history

DeepSeek Harness Web GUI 作曲器的终端式输入历史。

像在终端里一样按 ↑ —— 你打到一半的草稿不会丢。

English · 简体中文 · Español · Português · हिन्दी

Compatibility

Surface Status
Harness DeepSeek Harness 0.1.0-rc.6
Node ^22.19.0 || >=24.0.0
Platforms 仅 Web GUI（客户端插件；浏览器本地存储；无网络、无原生代码）
Model 任意（不发模型请求 —— 纯 UI 行为）

What you get

dsh-composer-history 把终端的输入历史搬进 DeepSeek Harness Web GUI 作曲器：

  1. 边缘优先的方向键召回 —— 裸 ↑/↓ 先移动光标；只有当光标位于首行/末行时才触发历史召回。首次召回暂存 {draft, caret}，回到最新一条（或按 Esc）时两者精确还原 —— 从不被清空。
  2. 持久化历史 —— 每条已发送消息追加到有界的浏览器本地存储，刷新页面、跨会话仍可召回。
  3. 反向搜索 —— Ctrl+R（可配置）在合并的历史、片段与模板上打开查询覆盖层。
  4. 智能输入层 —— /save//load 片段、带 {{workspace}}/{{session}}/{{draft}} 变量的提示词模板，以及浏览器本地的复用洞察。
  5. 感知滑动上下文 —— 压缩摘要以 [compacted] … 条目加入召回与搜索，每次压缩弹出带一键 /compact 填入的短暂通知。

纯 UI 行为：不产生会话事件、不改 agent-loop、不发模型请求。召回的文本只进入普通作曲器草稿；只有你按下 Enter 才会到达模型。

Quick start

# 1. install the bundle into your profile
dsh plugin --profile web add "github:PerryLink/dsh-composer-history#main"

# or from npm (published releases)
dsh plugin --profile web add dsh-composer-history

# 2. restart and verify the row
dsh --profile web --dump-config | grep -A3 'id: composer-history'

Install & uninstall

npm 包自带构建产物；源码 checkout 须先构建（pnpm run build）—— 客户端包检查会拒绝未构建的 bundle 启动。

  • git 渠道（最新 main）：dsh plugin --profile web add "github:PerryLink/dsh-composer-history#main"。
  • npm 渠道（已发布版本）：dsh plugin --profile web add dsh-composer-history。
  • tarball 渠道：在本仓库执行 pnpm pack，然后 dsh plugin --profile web add ./dsh-composer-history-<version>.tgz。
  • 卸载：dsh plugin --profile web remove dsh-composer-history（或从 profile patch 中移除该行）。

Configuration

所有可调项都是 Schemastery Config 字段（可从 cordis.yml 与 settings 文档修改）。按 id 的覆盖会替换整行 —— 重新列出你需要的每个键。非法枚举值会响亮地中止整个 dsh 启动。

Key Default Meaning
recallWithDraft 'save' 召回模式（save / gate）：save 在召回前暂存非空草稿；gate 仅空草稿才召回（Claude/Codex 式门控）
restoreOnEscape true Esc 结束浏览时还原暂存的草稿
edgeMode 'logical' 边缘判定模式（logical / visual）：按 \n 行，或按测量出的折行
enableCtrlAlias true 让 Ctrl+↑/↓ 与裸方向键行为一致
restoreCaret true 回到底部 / Esc 时同时还原暂存的光标
upKey 'ArrowUp' 向上召回的 KeyboardEvent.key；'' 表示禁用
downKey 'ArrowDown' 走向更新 / 还原的 KeyboardEvent.key；'' 表示禁用
escapeKey 'Escape' 退出浏览的 KeyboardEvent.key；'' 表示禁用
maxHistory 500 召回条目上限（保留最新）；0 = 不限
includeKinds ['user'] 允许进入历史的会话节点 kind（加入 'steering' 以包含 steer 消息）
historyScope 'session' 历史范围（session / workspace）：workspace 把其他已列表会话的用户消息排在当前会话之前
persistHistory true 把已发送消息追加到浏览器本地存储
maxPersisted 200 持久化条目上限；0 = 不限
enableSearch true 启用 Ctrl+R 反向搜索覆盖层
searchKeys ['Ctrl+R'] 打开搜索的组合键规格（修饰键 Ctrl/Alt/Meta/Shift + 键名）；非法规格会使浏览器 fiber 响亮失败
searchCaseSensitive false 搜索匹配是否区分字母大小写
includeCompactionSummaries true 把 [compacted] … 检查点摘要纳入召回与搜索
showCompactionNotice true 压缩检查点落地时显示短暂通知
compactCommandText '/compact' 通知中"Compact now"按钮填入作曲器的斜杠命令；'' 隐藏该按钮
enableSnippets true 启用片段库（/save、/load、搜索面板选取）
maxSnippets 200 最大存储片段数；0 = 不限
enableTemplates true 启用提示词模板库（插入时填充变量）
enableInsights true 启用复用洞察提示（本地使用统计）
insightMinUses 2 复用提示显示前的最少使用次数
enableCompactionHighlight true 在搜索面板中给 [compacted] … 摘要加醒目徽标

Tools & surfaces

Surface Kind Notes
ArrowUp keybinding 边缘优先的 ↑/↓ 召回 —— 暂存 {draft, caret}，回到底部或按 Esc 时两者精确还原
Ctrl+R keybinding 在合并的历史、片段与模板上打开反向搜索覆盖层
/save command 把当前草稿存为带名称与标签的片段
/load command 在光标处插入已保存的片段
templates UI 提示词模板以 JSON 文档导出/导入（仅显式点击触发）
composer-history settings namespace 把解析后的配置带进浏览器半边

Keybindings

Key State Behavior
↑ IDLE，光标在首行 暂存 {draft, caret}，填入最新条目，光标到末尾（无历史 → 放行）
↑ BROWSING，光标在首行 走向更早条目；在最旧一条按住不动（拦截，无任何变更）
↑ 光标不在首行 完全放行（浏览器移动光标）
↓ IDLE 始终放行（普通光标移动）
↓ BROWSING，光标在末行 走向更新条目；到最新一条 → 还原 savedDraft + savedCaret → IDLE
↓ 光标不在末行 完全放行
Esc BROWSING（restoreOnEscape: true） 还原 savedDraft + savedCaret → IDLE，拦截
Esc 其他情况 放行（菜单/弹窗的 Escape 语义不受影响）
Ctrl+↑/↓ enableCtrlAlias: true 与裸方向键一致
searchKeys chord 作曲器聚焦、plain 阶段、无菜单/选区/IME 打开反向搜索；浏览结束，当前显示的文本成为草稿
Shift/Alt/Meta+方向键、IME、选区 任意 始终放行

upKey/downKey/escapeKey/searchKeys 可以重命名上表按键；修饰键策略（以及搜索组合键的精确修饰键匹配）不变。搜索覆盖层内：↑/↓ 移动匹配选择（选中行自动滚入可见区域）、Enter 填充、Esc 取消、点击选中、点击面板外取消；匹配到的子串在每行中高亮显示。

Reverse search

  • 打开：作曲器聚焦且输入处于 plain 阶段时按下 searchKeys 组合键（此时 Ctrl+R 也会拦截浏览器的页面刷新——按键只在作曲器内被消费）。
  • 过滤：对合并历史（当前会话 + 持久化 + 工作区条目）做子串匹配；是否区分大小写由 searchCaseSensitive 决定；匹配到的子串在每行中高亮。
  • 选中：Enter 填充草稿并把光标移到末尾——与普通召回同一条 setDraft 写路径。召回文本只有在你随后按 Enter 时才会到达模型。
  • 取消：Esc 或点击面板外；草稿不被触碰。

Smart input layer

在终端式历史之上，三套浏览器本地库把作曲器变成可复用的输入面。下面的所有内容都存于 localStorage（键 dsh.composer-history.snippets.v1、.templates.v1、.insights.v1），绝不触碰网络，每个开关都是 Config 字段。

片段（跨会话命令库）

/save ship-check --tag=release,ops
check the build, run the smoke suite, tag the release        ← 草稿其余部分就是片段
/save ship-check                                             → "snippet saved: ship-check"
/load ship-check                                             → 片段填入作曲器
Ctrl+R → 搜索面板在历史旁列出片段（绿色徽标 = 名称）
  • /save <名字> 消费这次 Enter，把草稿（去掉命令那一行）以 kebab-case 名称（可带标签）存下，并清空作曲器。没有可保存的内容 → 弹出错误通知，命令绝不发送。
  • /load <名字> 在光标处插入片段（整段替换、光标到末尾）并计一次使用。
  • 作用域：带工作区 cwd 保存的片段是工作区作用域；不带的是全局。maxSnippets 限定库大小；同名保存会替换。
  • 插件从不发送：每次填入都落在普通草稿里，Enter 永远属于你。

带变量的提示词模板

模板是带 {{variable}} 占位符的存储提示词文本。搜索面板以紫色徽标列出；选中一条会从实时会话填充变量并插入结果。内置变量：{{workspace}}（会话的 cwd）、{{session}}（会话 id）、{{draft}}（当前草稿）。引用未知变量的模板会响亮失败并列出缺失项 —— 半填充的提示词比报错更糟。

模板库通过面板的 Export templates / Import templates 按钮以 JSON 文档（composer-templates-v1）导出/导入 —— 是显式的用户操作；插件从不自行写文件。

复用洞察

每条新提交的用户消息（以及每次片段加载）都会以精确文本为键写入一条浏览器本地使用记录。当你输入时，一旦草稿匹配到至少在 insightMinUses（默认 2）个会话里用过的提示词，作曲器下方的小提示就会显示 used M× in N sessions · 在 N 个会话里用过 M 次。用 enableInsights 开关；统计只包含去重后的文本与计数器。

压缩摘要高亮

Ctrl+R 给 [compacted] … 摘要加琥珀色徽标（历史不加徽标），片段绿色、模板紫色 —— 面板的来源一眼可见。用 enableCompactionHighlight 开关。

Sliding context

harness 核心给每个 dsh 会话提供滑动上下文窗口 —— 与 Claude Code 和 Codex 同款的工作流：当会话接近模型的上下文上限（或提供方回报溢出）时，harness 会自动压缩 —— 更早的轮次被总结为留在会话记录中的 compaction 检查点标记，模型只保留摘要加上最近的尾部，会话继续；/compact 可随时手动触发同样的压缩，标记在记录中渲染为可展开的"上下文已压缩"行。

dsh-composer-history 把作曲器接入这个工作流，让上下文窗口滑动时你的输入历史一条不丢：

  • 召回跨压缩留存 —— 被遮蔽的轮次仍留在会话快照里，↑ 依旧能走过检查点前后你发送过的每一条消息。
  • 摘要加入历史 —— 每个检查点的摘要文本以 [compacted] … 条目进入 ↑ 召回和 Ctrl+R 搜索（开关：includeCompactionSummaries），模型不再逐字看到的上下文仍然一键可达。
  • 压缩通知 —— 页面打开期间有检查点落地时，底部弹出短暂通知（Claude Code 的"自动压缩会话…"时刻），附摘要片段和一键填入 /compact 按钮（showCompactionNotice、compactCommandText）；填入只进普通草稿，只有你按 Enter 才发送。
  • 搜索计数 —— Ctrl+R 面板新增实时的 N entries / N matches 状态行，长条目限两行显示。

压缩本身（阈值、摘要模型、/compact）由 harness 核心的 compaction 插件负责 —— 本插件只观察客户端快照已经暴露的检查点标记，因此不需要任何 agent-loop 或模型请求改动。

Permissions & data

  • 权限：插件在其 workshop manifest 中声明 browser:local-storage —— 仅此而已。无网络、无子进程、无会话事件。
  • 数据：四个浏览器本地 localStorage 键 —— dsh.composer-history.v1（已发送消息历史）、dsh.composer-history.snippets.v1（片段文本 + 标签 + 使用计数）、dsh.composer-history.templates.v1（模板文本）、dsh.composer-history.insights.v1（去重提示词文本 + 每会话使用计数）。全部有界、仅同源可读、绝不上传；损坏载荷静默重置。
  • 模型可见 ⟺ 你按 Enter：召回文本、片段加载、模板填充、/compact 填入都只进普通作曲器草稿。在你按下 Enter 之前，任何内容都不会到达模型。

Security boundaries

  • 仅 UI，从不执行强制。 插件只编辑作曲器草稿；沙箱、审批与会话系统仍是执行权威，绝不接管或绕过任何命令或工具。
  • 内容不出浏览器。 历史、片段、模板与洞察都活在 localStorage 里；什么都不上传，也不发模型请求或网络调用。
  • 响亮失败。 非法枚举值中止整个 dsh 启动；非法搜索组合键使浏览器 fiber 失败 —— 错误配置绝不静默降级。
  • 处处有界。 maxHistory、maxPersisted、maxSnippets 限定保留条目；损坏或外来的载荷静默重置。
  • 放行路径零副作用。 插件仅在 plain 输入阶段拦截，对斜杠菜单、命令弹窗、IME 组合、文本选区与修饰键组合一律放行。

Known limitations

  • 逻辑行 vs 视觉行。 默认 logical 按 \n 判定（一条自动折行的长消息算一行）；visual 通过隐藏 mirror（每次边缘检查 O(行数·log n) 二分，按草稿/宽度 memoize）测量真实折行。mirror 测量需要真实布局引擎 —— 纯 span 数学已单测覆盖。
  • 持久化历史按浏览器隔离。 存储位于某一 origin 的 localStorage，不在浏览器或机器间同步。损坏载荷静默重置。
  • 撤销栈包含召回事务。 每次填充/还原都是输入机撤销日志里的一条 setDraft 事务；Ctrl+Z 会一步步退回召回。精确化需要上游暴露 edit-range。
  • 召回 /xxx 条目后按 Enter 走正常的命令 claim/adjudication 路径（符合预期，且 Enter 从不被拦截）。
  • 菜单/弹窗与非 plain 阶段永远优先；提交发送与会话切换都会重置为 IDLE。
  • 引用 chip（U+FFFC 占位符）随召回/还原的草稿文本一起保留。
  • historyScope: 'workspace' 读取其他已列表会话的实时装配；装配尚未物化的会话暂时没有贡献。
  • 搜索覆盖层是纯 DOM（无 React 依赖）；最多渲染 maxHistory 条匹配。
  • 压缩感知是观察性的。 安装前（或会话切换前）已落地的检查点绝不触发通知；摘要事件落在已加载窗口之外的检查点不产生 [compacted] … 条目（summary: null）。
  • 通知的"Compact now"按钮只把配置的命令文本填入草稿 —— 发送仍由你的 Enter 决定。
  • 片段、模板与洞察是浏览器本地的。 名称用 kebab-case（1..64 字符）；标签上限 8 × 32 字符。模板变量从实时会话解析；{{draft}} 是选取时刻的草稿。

Development

pnpm install           # node ^22.19 || >=24
pnpm run build         # tsc build + tsdown bundle (lib/)
pnpm run typecheck     # tsc --noEmit (src + tests)
pnpm test              # vitest run
pnpm run test:watch    # vitest watch
pnpm run test:coverage # vitest run --coverage
pnpm run check:readmes # README consistency gate
pnpm run verify:pack   # pack-surface check

Topics

deepseek-harness · dsh · dsh-plugin · web-gui · input-history · keyboard-shortcuts · compaction · sliding-context · typescript

Contributors

  • @PerryLink — 创建者与维护者：边缘优先的方向键召回、持久化历史、反向搜索、滑动上下文感知、片段库、提示词模板、复用洞察，以及 dsh.bundle / dshWorkshop manifest。

PerryLink DSH Plugin Family

本项目是 PerryLink 维护的 15 个 DeepSeek Harness 插件之一。如果这个对你有用，其余的很可能同样有用：

Plugin One-liner
dsh-mcp-panel Read-only MCP runtime panel: /mcp command + Settings tab with status, tools and errors
dsh-doublecheck Engineering-discipline guard: requirements grill, test gates, adversary review
dsh-background-agents Durable background child agents with a Web UI sidebar, messaging and interrupt
dsh-lsp-actions LSP diagnostics, formatting, completion, code actions and rename over language servers
dsh-output-styles Claude Code outputStyles-equivalent runtime style switching
dsh-checkpoint-rewind Claude Code /rewind-equivalent: snapshots, session forks, one-shot restore
dsh-permission-rules Claude Code-style declarative allow/deny/ask permission rules with audit
dsh-auto-review Second-model auto-review on the approval chain, fail-closed by default
dsh-memento Approval-gated cross-session memory: ctx.memory seam + SQLite + memory tool
dsh-skill-pack-security Security-audit skill pack: secret scan, dependency and supply-chain review
dsh-session-pin Pin sessions in the Web sidebar with durable ordering
dsh-composer-history Terminal-style input history for the web composer: arrows, Ctrl+R search
dsh-github GitHub PR/issues integration for DSH, every write gated by approval
dsh-plugin-guide Plugin-development knowledge base as an on-demand agent skill
dsh-claude-move Migrate Claude Code sessions, memory, skills and CLAUDE.md into DSH

License

Apache License 2.0 © 2026 dsh-composer-history contributors

内容来自项目 README（GitHub）↗