摘要dsh-compact-button是一款纯客户端的 DSH Web 插件在上下文计量面板中提供「压缩上下文」与「新建会话」两个按钮将手动敲/compact命令简化为一次点击。插件与/compact完全同通道、零侵入支持状态实时反馈、中英文切换与防连点锁定。本文介绍其核心功能、npm/源码两种安装方式、使用步骤、常见问题排查及已知限制适配 DSH 0.1.1-rc.2MIT 协议开源。长对话把上下文窗口撑爆每次都要手动输入/compact命令本文带你上手 DSH 生态中的dsh-compact-button插件——在上下文计量面板里放两个按钮一键压缩历史、一键新建会话纯客户端零侵入。一、背景长会话的上下文焦虑用过 DeepSeek HarnessDSH做长任务的同学大概率都遇到过这个场景对话越跑越长token 占用一路飙升上下文窗口快满了得停下来手动敲/compact把早期历史压成摘要敲完命令还得等结果手忙脚乱想新开一个会话继续又得去侧边栏点半天。dsh-compact-button就是为了解决这个痛点而生的——它在 DSH Web 的上下文计量面板里直接放了两个按钮按钮作用 压缩上下文点击即向当前会话提交/compact把较早对话历史压缩成摘要 新建会话点击即在同一 workspace 中开启新会话并跳转过去适配 DSH 版本0.1.1-rc.2MIT 协议开源。二、核心功能一览1. 一键压缩与/compact完全同通道按钮点击后调用的是session.command(/compact)和你手敲命令走的是完全相同的通道。压缩结果照常以命令行形式出现在对话流里没有任何特殊行为也不会引入额外的副作用。2. 状态实时反馈按钮文案会随提交状态自动流转4 秒后自动回到待命状态面板保持清爽状态中文English含义待命压缩上下文Compact context可点击提交中压缩中…Compacting…正在向会话提交命令已提交已提交压缩Compaction submitted命令已被接纳结果见对话流未匹配命令未匹配Command not matched当前 composer 没有可提交命令的会话失败提交失败Submission failed提交命令时出错3. 中英文实时切换i18n 字典注册在compactButton命名空间下跟随 DSH 全局语言设置实时切换无需重启。4. 一键新建会话在压缩按钮右侧并排一个「新建会话」按钮点击调用workspaces.startSession()在当前会话所在的 workspace 中开启新会话并跳转。点击后约 1.5 秒内锁定防止误连点。5. 零侵入纯客户端Host 半边为空apply无任何宿主行为槽位不存在时按钮安静地不渲染不影响平台其余部分插件自带cordis.patch.yml安装后自动追加挂载条目无需手动编辑 profile。三、安装教程前置条件已装好 DSHdsh web能正常运行Node.js ≥ 20pnpm ≥ 10。方式一从 npm 安装推荐dsh plugin--profilewebadddsh-compact-buttonlatest方式二从源码安装调试本地改动时使用# 1. 克隆并构建gitclone https://github.com/shyuan-hub/dsh-compact-button.gitcddsh-compact-buttonpnpminstallpnpmbuildpnpmpack# 生成 dsh-compact-button-0.2.0.tgz# 2. 通过 file: 通道安装dsh plugin--profilewebaddfile:你的本地目录/dsh-compact-button-0.2.0.tgz调试时也可以用link:通道改完代码pnpm build 重启dsh web即可生效dsh plugin--profilewebaddlink:克隆目录绝对路径安装后必做装完重启dsh web再硬刷新浏览器Cmd/Ctrl Shift R即可生效。仅硬刷新浏览器不够必须重启服务。无需手动编辑 profile 的package.json本包声明了dsh.bundle.patchdsh plugin add会自动把它追加进dsh.profile.bundles。四、按钮怎么用输入框composer旁的上下文圆环点击展开就是「上下文计量面板」两个按钮并排放在里面左侧「压缩上下文」点击即提交/compact文案随状态流转4 秒后自动复位右侧「新建会话」点击即在当前 workspace 开新会话并跳转1.5 秒防连点锁定。压缩结果会以命令行形式正常出现在对话流中和手敲命令的体验完全一致。五、常见问题排查现象原因与解决面板里看不到按钮上下文计量面板必须声明conversation.context.actions子槽位。确认平台补丁已应用后硬刷新浏览器点击后显示「命令未匹配」当前 composer 没有可提交命令的会话切换到有活跃会话的页面再试安装 / 改动后没生效必须重启dsh web仅硬刷新不够重启后再硬刷新页面六、已知限制依赖平台为上下文计量面板声明conversation.context.actions子槽位需随附补丁槽位缺失时按钮不渲染压缩按钮只负责提交/compact压缩的接纳与执行语义由 Host 侧command-compact插件拥有状态提示 4 秒后自动复位不提供压缩进度展示新建会话按钮沿用部署默认的 agent 预设与权限设置若当前会话用的是非默认预设新会话不会自动沿用client 侧session.create不暴露预设/权限选择。七、总结dsh-compact-button是一个小而美的 DSH Web 客户端插件核心价值就一句话把/compact命令从手动敲变成点一下。纯客户端、零侵入、Host 半边为空与/compact完全同通道无副作用状态反馈 i18n 防连点细节到位如果你经常在 DSH Web 上跑长任务上下文窗口总是提心吊胆这个插件值得装一下。npm 一行命令搞定重启即生效。项目地址github.com/shyuan-hub/dsh-compact-buttonnpm 包dsh-compact-buttonLicenseMIT · Built for the DeepSeek Harness ecosystem