dsh-compact-button
在 DSH Web 的上下文计量面板里放一个「压缩上下文」按钮——点击即向当前会话提交
/compact，把较早的对话历史压缩成摘要，为后续对话腾出上下文空间。
English: a one-click Compact context button for the DSH Web context meter panel.
输入框（composer）旁的上下文圆环展开后就是「上下文计量面板」，按钮就在里面
📑 目录
✨ 功能一览
- 🔘 一键压缩：长对话不断吃掉上下文窗口，以前得手动敲
/compact——现在按钮就放在你随时能看到的上下文面板上，一眼看到快满了，点一下即可 - 🔁 同一条命令通道：和手敲
/compact走的是完全相同的通道（session.command('/compact')），压缩结果照常以命令行形式出现在对话流里，无特殊行为 - 📊 状态实时反馈：按钮文案随提交状态流转（待命 → 提交中 → 已提交 / 未匹配 / 失败），4 秒后自动回到待命，面板保持清爽
- 🌏 多语言：跟随 DSH 的语言设置，中文 / 英文实时切换
- 🪶 零侵入：纯 client 半边插件（host 半为空 apply）；槽位不存在时按钮安静地不渲染，不影响平台其余部分
🚀 安装
前置：已装好 DSH（dsh web 能正常运行），Node.js ≥ 20、pnpm ≥ 10。
# 1. 构建并打包
git clone https://github.com/shyuan-hub/dsh-compact-button.git && cd dsh-compact-button
pnpm install && pnpm build
pnpm pack # 生成 dsh-compact-button-0.1.0.tgz
# 2. 通过 dsh plugin 一键安装（file: 通道）
dsh plugin --profile web add "file:<你的本地目录>/dsh-compact-button-0.1.0.tgz"
装完重启 dsh web，再硬刷新浏览器（Cmd/Ctrl+Shift+R）即可生效。
✅ 无需手动编辑 profile 的
package.json：本包声明了dsh.bundle.patch，dsh plugin add安装后会自动把它追加进dsh.profile.bundles。🔧 调试本地改动时，可改用 link 通道：
dsh plugin --profile web add "link:<克隆目录绝对路径>"，之后每次pnpm build+ 重启dsh web即可生效。
常见问题📦 插件自带 bundle patch（
cordis.patch.yml）：装入 profile 后，启动时会由它自动插入本插件的挂载条目，无需手动编辑 profile 的cordis.patch.yml；若聚合包已挂载本插件，该条目会自动退让，避免重复挂载。
| 现象 | 原因与解决 |
|---|---|
| 面板里看不到按钮 | 上下文计量面板必须声明 conversation.context.actions 子槽位（见下方「平台补丁」）。确认补丁已应用后硬刷新。 |
| 点击后显示「命令未匹配」 | 当前 composer 没有可提交命令的会话。切换到有活跃会话的页面再试。 |
| 安装 / 改动后没生效 | 本插件需要重启 dsh web 才能生效（仅硬刷新浏览器不够），重启后再硬刷新页面。 |
🔩 依赖平台补丁：上下文计量面板的
conversation.context.actions子槽位由平台补丁声明（随附的平台补丁已应用）。若该槽位不存在，按钮不会渲染，插件其余部分不受影响。
🖱️ 按钮怎么用
按钮位于上下文计量面板（composer 旁的上下文圆环，点击展开）里，文案会随点击状态变化：
| 状态 | 中文 | English | 含义 |
|---|---|---|---|
| 待命 | 压缩上下文 | Compact context | 可点击，点击即提交 /compact |
| 提交中 | 压缩中… | Compacting… | 正在向会话提交命令 |
| 已提交 | 已提交压缩 | Compaction submitted | 命令已被接纳，压缩结果见对话流 |
| 未匹配 | 命令未匹配 | Command not matched | 当前 composer 没有可提交命令的会话 |
| 失败 | 提交失败 | Submission failed | 提交命令时出错 |
状态会在 4 秒后自动回到「待命」。
🔧 工作原理
- 平台扩展点：
@deepseek-ai/dsh-client-ui-conversation的 ContextMeter 面板声明子槽位conversation.context.actions（conversation.composer.bar的 children，kind: list）。 - client 半边：通过
slots.inject等待平台声明后，把CompactButton注册进该槽位；点击调用session.command('/compact')——与手敲/compact完全同一条通道（接纳语义由 Host 的 command-compact 插件拥有，压缩结果以命令行形式出现在对话流中）。 - Host 半边：空
apply，无宿主行为。 - i18n：字典注册在
compactButton命名空间（zh/en），跟随 DSH 语言设置实时切换。
构建产物 / Artifacts
| 文件 | 通道 |
|---|---|
lib/index.js |
Host 半边（空 apply，无宿主行为） |
lib/client.js |
官方 profile 通道（bundle id = 包名 dsh-compact-button） |
lib/client-registry.js |
插件注册表通道（bundle id = manifest id dsh-external/dsh-compact-button） |
🛠️ 开发与构建
pnpm install
pnpm typecheck # tsc --noEmit
pnpm build # rm -rf lib && tsdown → lib/index.js + lib/client.js + lib/client-registry.js
pnpm watch # tsdown --watch
架构：单 npm 包、host/client 双半结构——host（src/index.ts）为空 apply；client（src/client/index.tsx）注册 CompactButton 到槽位并处理状态流转与 i18n。插件按 DSH 官方规范组织（无 default 导出、双 client bundle），运行期不依赖 npm / checkout（@deepseek-ai/* 由 web profile 提供）。
⚠️ 已知限制
- 依赖平台为上下文计量面板声明
conversation.context.actions子槽位（需随附补丁）；槽位缺失时按钮不渲染 - 按钮只负责提交
/compact，压缩的接纳与执行语义由 Host 侧 command-compact 插件拥有 - 状态提示 4 秒后自动复位，不提供压缩进度展示
No comments yet. Be the first to write one.