前言¶

在 DeepSeek Harness（DSH）里做长会话、大仓库或多模块项目时，上下文迟早会触顶，系统会通过 compaction 把历史压成摘要继续跑。官方 compaction 能保证会话不中断，但摘要本质是「有损索引」，不是完整转录：精确数值、中文表述、架构约束在压缩后容易丢。社区里已有阈值、检查点一类插件，侧重点多在「何时压」；若你更关心「压完还保多少、丢的东西能否补回、项目结构能否再查」，就需要专门面向保真与回查的后端。

下面介绍社区插件 dsh-compaction-fidelity（维护者 TLNing260310，SkillHub 分类：记忆）。它以 Profile Bundle 形式接入 DSH，在压缩前后做确定性指纹与补偿，并把项目架构索引落在工作区 .dsh/compaction-fidelity/ 下，便于压缩后继续检索。

这是什么¶

dsh-compaction-fidelity 是面向 DSH 0.2.0-rc.2 运行时的双语 compaction 后端：在生成摘要的同时做保真诊断（lexical fidelity metrics）、补偿注入，以及项目架构回查锚点。SkillHub 与仓库简介将其概括为「DSH 上下文压缩保真层：跨语言保真指纹、项目架构回查锚点、350K 默认压缩线」，采用 MIT 协议。

当前目录页标注版本 v0.3.1（约一周前更新），GitHub 星标为 0。插件在 SkillHub 上已通过可安装性验证（installability: verified）。DSH 生态主张「一切皆插件」；SkillHub 是社区独立目录站点，与 DeepSeek / 幻方无官方从属关系，安装来源以目录页与仓库文档为准。

核心功能¶

以下能力均来自仓库 README（经 SkillHub API 同步），按职责归纳。

动态压缩线与默认 350K¶

插件提供 256K / 350K / 512K / 800K（官方默认） 等预设，并可在 composer 中设置自定义阈值（文档说明为 256 < value < 800 (K)，K 表示 1000 token，与 DSH ContextMeter 一致）。插件默认压缩线为 350K；在 1M 窗口上 800K 会受官方 80% 窗口线约束。维护者说明 350K 是个人舒适设置，用户可用合法自定义值覆盖。

跨语言保真指纹与补偿¶

压缩前冻结精确值、中文 bigram 与结构；压缩后对比生成摘要，输出 L0–L3 等级。缺失的精确值会写入 fidelity_compensation 块；指标写入 .dsh/compaction-fidelity/fingerprints/。语言策略默认 auto 跟随会话语言；en 模式下模型 prose 用英文，但保留用户原文与精确值。

项目架构索引与回查锚点¶

持久化（可选 Git 版本化）的 .dsh/compaction-fidelity/ 索引包含模块图、架构级文件、命令、schema/迁移锚点等。文件变更后，相关架构邻居/文档/测试会写入 anchors.md 并在下一步注入。工具 compaction-fidelity-brief、compaction-fidelity-lookup 及命令 /compaction-fidelity brief、lookup 用于压缩后按结构回查。

架构刷新与作用域管理¶

受 AOCI 思路启发的架构刷新门控：支持 status / refresh、作用域注册、Git 与内容哈希变更检测等。可通过 architecture include|exclude 管理 glob 规则，配置存于 architecture-scopes.json。

运行时总开关与后端关系¶

安装 bundle 即启用整套能力；移除则恢复内置 DSH preset。会话内可用 /compaction-fidelity on|off 切换。README 明确：本包在 BasicCompactionEngine 子类中 override summarize()，是带可观测层的 compaction 后端，而非被动观察者；与 dsh-compaction-pro 等同时占用 compaction 服务行的组合 尚未验证，不应假定安全。

安装与启用¶

安装前请自行审阅 GitHub 仓库 源码、cordis.patch.yml 与 MIT 许可证。插件以 当前 dsh 进程权限 运行，会读写工作区 .dsh/compaction-fidelity/ 并在 bundle 中 patch 内置 preset 的 compaction 行。

README 写明适配 DSH Desktop 2.0.17（捆绑运行时 0.2.0-rc.2），推荐安装 v0.3.1 标签。Desktop 侧示例：

dsh plugin --profile desktop add 'github:TLNing260310/dsh-compaction-fidelity#v0.3.1'
dsh plugin --profile desktop remove dsh-compaction-fidelity

若使用 CLI Web profile，将 desktop 换为 web。SkillHub 针对该插件给出的 web profile 安装计划（固定 commit）为：

dsh plugin --profile web add github:tlning260310/dsh-compaction-fidelity#b417924e5086d055139e5fd54d0607aa9afc1af2

安装后按 profile 重启 DSH，例如 dsh --profile web，并确认插件行已挂载且无启动错误。bundle 会为 preset-standard、preset-cordis、preset-ptc、preset-minimal 等注入 dsh-compaction-fidelity/engine；新会话使用 patch 后的 preset，已在跑的会话仍保留原有组合树。

可选：仓库提供 手动、会修改本机 DSH 安装 的 CJK token 计量补丁脚本，安装 bundle 时不会自动执行，也非加载 bundle 所必需；仅在确认与当前 DSH 版本兼容后再考虑使用。

典型用法¶

查看状态与调整压缩线¶

/compaction-fidelity status
/compaction-fidelity threshold 350k
/compaction-fidelity language auto

初始化索引与架构检查¶

/compaction-fidelity init
/compaction-fidelity reindex
/compaction-fidelity architecture status
/compaction-fidelity architecture check <scope>

压缩后回查¶

/compaction-fidelity brief
/compaction-fidelity lookup <query>
/compaction-fidelity anchors <file>

保真校准（需积累样本）¶

查看校准摘要或从工作区内 JSON 导入已验证样本：

/compaction-fidelity calibration summary
/compaction-fidelity calibration import trusted-samples.json

每个语言组满 8 个样本后可出校准等级；混合中英文会话使用 mixed:<dominant> 分组，避免污染纯 zh/en 统计。

适用场景与注意¶

适合谁： 使用 DSH Desktop、会话很长、仓库大或多模块、工作流以中文或中英双语为主、且工具调用导致上下文快速膨胀的开发者。

使用注意：

1. 与仅调阈值/检查点的插件不同，本插件 替换 summarization 后端；请勿与未验证可共存的 compaction 后端叠装。
2. 全局注入预算 injectionMaxTokens 默认 16000（CJK 感知）；触发截断时 prompt 会记录 <compaction_fidelity_injection_budget>。
3. README 列出的已知边界包括：校准与下游 QA 的相关性尚未测量、锚点权重仍为固定值等；生产使用前建议在小范围会话中观察指纹与补偿行为。
4. 安装前核对 peer 依赖（如 @deepseek-ai/dsh@0.2.0-rc.2）与本地 DSH 版本是否一致。

结尾¶

dsh-compaction-fidelity 把 compaction 摘要当作有损索引，用跨语言指纹、补偿块和本地文本索引，在长会话里尽量保住精确事实与项目架构可回查性；默认 350K 压缩线可在 composer 中按文档规则调整。进一步了解可访问 SkillHub 目录页与 GitHub 仓库：

• 目录页：https://www.skillhub.cn/plugins/TLNing260310/dsh-compaction-fidelity
• GitHub：https://github.com/TLNing260310/dsh-compaction-fidelity