前言¶
在 DSH 里长时间对话后，上下文会不断变长：早期轮次仍占模型窗口，又未必每次都需要逐字保留。整段清空或只靠记忆类插件，有时要么丢细节，要么不好精确到「这一段」。compact-region（局部压缩）面向的是另一类需求：选定对话里连续的一段显轮次，用当前会话模型生成可编辑摘要，再以检查点卡片替换该区间；原文仍留在会话日志，但不再进入后续普通对话与模型上下文。
下面介绍该插件的定位、能力与在 DSH 中的安装与使用方式。事实以 GitHub 仓库 README 为准；维护者为 Asdika-36086，社区目录分类为「记忆」，插件版本为 0.2.0，许可证 MIT。
这是什么¶
compact-region 是 DSH 的 Web Client 插件，以组合包（bundle）方式分发：package.json 中 dsh.bundle.patch 指向 cordis.patch.yml，dsh.client 声明客户端入口。一句话：把用户选中的连续显轮次总结成一张检查点卡片，应用后卡片留在上下文中，被替换的原文仍可在存档中查看。
开发与测试环境为 DSH 0.2.x；其他版本未在资料中验证。插件在 DSH 进程内运行，安装前建议浏览源码与 LICENSE，并按自身环境评估模型调用时的数据与隐私策略。
核心功能¶
资料中可核实的能力如下：
- 区间选择：在普通轮次旁进入选择模式，用连续显轮次（含普通轮次与已有检查点卡片）划定范围；不能只单独选一个检查点卡片，再次压缩需与相邻轮次一并选中。
- 模型摘要：用当前会话所选模型，基于截至所选范围结束位置的可见上下文生成摘要，并展示可编辑预览。
- 应用或放弃：预览后可「应用」（用检查点卡片替换区间）、「重新生成」或「取消」；应用前可人工修改摘要。
- 存档与查看：被替换内容不删会话日志事件；可通过卡片展开摘要，或通过「查看对话记录」在右侧面板浏览原文。
- 多语言：随插件提供中文与 English；可在「插件 → 局部压缩」卡片上切换；自定义语言 JSON 可放在
<DSH 主目录>/compact-region/langs/。
已知限制（README 明确写出）：以完整显轮次为选择单位，不支持任意消息级切割；摘要由模型生成，不能保证完整准确；正在运行的轮次不能压缩；隐藏展示依赖客户端 DOM，可能影响滚动与定位。
安装与启用¶
本插件需通过 DSH 插件管理器安装，不要手动复制文件。要求：DSH 自带插件页且支持 Web Client 插件。
方式一：Web 界面（推荐）¶
- 打开 DSH，进入左侧 插件 页。
- 在安装输入框填入仓库地址或本地插件目录绝对路径，例如：
https://github.com/Asdika-36086/compact-region
- 确认安装并等待依赖完成，在列表中启用
compact-region。 - 若界面未出现压缩按钮，重启一次 DSH。
方式二：命令行¶
先确认当前 DSH CLI 是否支持 install：
dsh plugin --help
若帮助信息中包含 install，再执行：
dsh plugin install https://github.com/Asdika-36086/compact-region
否则使用 Web 界面方式。
验证¶
打开任意对话，鼠标移到普通轮次上，旁侧应出现 ⤵ 压缩。若无，检查插件页中是否已启用。
典型用法¶
按 README 中的可复现流程操作：
- 打开要整理的对话，并确保会话已选择可用模型。
- 在某个普通轮次旁点击 ⤵ 压缩，从该轮次进入选择模式。
- 点击轮次或压缩卡片选择连续范围；点击范围外轮次会扩展中间选中项；再次点击可取消单项。
- 在选择面板上点击 压缩，等待当前模型生成摘要并查看预览。
- 核对或编辑摘要后选择 应用、重新生成 或 取消。
选择模式中按 Esc 或点 取消 可退出。压缩完成后可展开卡片查看摘要；重要事实、路径、命令和待办请在应用前人工核对。
适用场景与注意¶
适合谁：需要在长会话中保留结论、又想把中间过程从模型上下文中「收起来」的 DSH 用户；希望用检查点串联、并可随时回看原文存档的开发者。
使用注意：
- 应用检查点会追加替换事件，被选区间不再进入后续模型上下文；生成摘要时会向当前模型服务发送截至范围结束处的可见上下文，请按服务商隐私政策评估内容。
- 未激活的旧会话可读轮次与存档；生成摘要与应用检查点要求会话处于激活状态。
- 插件以 DSH 当前进程权限运行；社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系。
开发侧可在插件目录用 Node.js（engines.node >= 22.19.0）运行 npm test，测试不启动 DSH、不调用真实模型。
结尾¶
compact-region 把「局部总结 + 检查点替换」做成对话内的显式操作：连续轮次可选、摘要可编、原文可存档。适合在 DSH 0.2.x 环境中做上下文治理时按需压缩中间段落，而不是整会话一刀切。
- 社区目录：https://www.skillhub.cn/plugins/Asdika-36086/compact-region
- 源码与文档：https://github.com/Asdika-36086/compact-region
