前言¶
DeepSeek Harness (DSH) 的核心架构基于插件扩展。在进行长会话编码时，Agent 面临上下文窗口有限、工具输出过多、历史信息稀释以及模型难以区分当前工作现场等硬约束。传统的压缩机制往往在窗口即将耗尽时一次性处理，容易同时损失底层细节和全局结构，导致前后表现“判若两人”。
dsh-context-enhancement 是专为 DSH 定制的上下文增强插件，旨在解决单一长会话的上下文管理问题，提供工具要点化、遗忘区压缩和独立会话摘要能力。
核心功能¶
该插件提供以下核心能力：
* 工具要点化：精简工具结果，降低上下文占用。
* 遗忘区压缩：对历史旧内容进行语义压缩。
* 独立会话摘要：生成并维护会话摘要。
* 主线程分区压缩：将对话内容按生命周期划分区域。
* 独立 checkpoint 旁路：后台独立维护任务状态。
* 任务状态 provider：提供任务状态服务。
* 上下文优化页面：Web 界面用于查看和管理状态。
* 工具输出缩减：对工具输出进行裁剪。
安装与启用¶
前置条件¶
- Node.js
^22.19.0 || >=24.0.0 - DeepSeek Harness
0.1.2-rc.1 - 已配置可用的 DSH 模型提供方
- Web 安装模式
安装步骤¶
- 执行安装命令：
dsh plugin --profile web add 'github:chuxindd/dsh-context-enhancement#v0.1.12'
- 重启 Web profile：
dsh --profile web - 打开 Web 界面，新建会话。
- 在 Agent 选择器中选择 上下文增强。
使用与验证¶
安装并启用后，插件会保留 standard、minimal、ptc 和 cordis 等原有模式，同时将 contextual 注册为默认模式。
使用流程如下：
1. 启动 Web profile，打开或新建会话。
2. 在 Agent 选择器中选择 上下文增强。
3. 正常执行任务；任务状态与上下文整理会自动运行，无需手动维护。
4. 打开 上下文优化 页面，查看各能力状态、触发记录和当前任务摘要。点击摘要标题右侧的 编辑 可修改摘要内容（目标、焦点、待办等）。
5. 打开“轨迹”查看压缩、裁剪等详细事件。
注意事项¶
- 测试阶段：本项目目前处于测试阶段，代码由 GPT5.6 Sol 完成。
- 版本兼容：仅兼容 DeepSeek Harness
0.1.2-rc.1。升级 DSH 后需重新验证。 - 数据保留：卸载插件不会删除任务状态文件和 Session 日志。
- 源码导入：运行时不导入未发布的
src/*subpath。
总结¶
该插件通过主线程分区压缩和独立 checkpoint 旁路两套并行机制，帮助 DSH 用户在长会话中保持上下文信息的连贯性和任务状态的持久化，是解决长程编码任务记忆管理问题的实用工具。
