项目简介
在现代以 DeepSeek 为代表的大语言模型与智能体工程中,长时程、复杂多轮次协作(Long-horizon Agentic Workflows)已成为解决软件重构、端到端研发与系统维护的主流范式。然而,随着智能体自主调用终端沙箱、频繁检索大型代码仓库、多轮次工具交互与多 Agent 协同委派,底层会话上下文(Context)呈现出极高的动态性与复杂性。
在原生控制台或标准聊天面板中,开发者往往只能看到单向滚动的输出,底层的上下文构成完全处于“黑盒状态”:
- Token 消耗不透明:无法直观区分系统提示词、用户提问、工具大文本输出(如测试日志、编译器输出)与思维链思考占用的具体比例;
- 遗忘与退化难以溯源:在长达数十轮的复杂作业中,模型往往因上下文窗口上限而触发自动压缩(Compaction)或剪枝(Pruning),开发者难以得知哪一部分关键上下文被裁减;
- 多智能体流转断层:在主从 Agent 或专家团队(Agent Teams)协作时,各子 Agent 之间的上下文传递、会话日志汇聚与任务委派记录散落在各个终端,排查极其困难。
由开源开发者 bowenliang123 倾力打造的 dsh-context 正是为彻底破解上述痛点而诞生的一站式上下文洞察与管理套件。作为 DeepSeek Harness(dsh)生态中广受好评的核心诊断插件,dsh-context 提供了直观的可视化仪表盘、上下文浏览器、侧边栏集成与交互式 /context 指令集,帮助开发者在全生命周期内洞察上下文的构成分布、演进历程与多智能体协作脉络。
核心特性
1. 全景上下文仪表盘与 Token 来源多维分解
dsh-context 内置实时更新的可视化看板与上下文浏览器。插件深度挂载于 Harness 会话总线,对当前交互轮次的 Token 构成进行像素级细分分析:
- 多维来源染色分解:以清晰的色彩图谱区分系统提示词(System Instructions)、用户指令(User Inputs)、模型思维链(CoT Reasoning Traces)、代码文件与工具执行输出(Tool Results);
- 图片与多模态资产追踪:精准计算会话中附加的架构图、报错截屏及设计稿的多模态 Token 消耗与缓存命中率;
- 上下文窗口利用率预警:动态展示当前模型上下文窗口的安全边际,并在接近临界阈值时通过颜色渐变与通知给出警示。
2. 轮次演进与上下文压缩/剪枝历史追踪
面对长会话中最让人头疼的“模型遗忘指令”问题,dsh-context 记录了每一轮对话(Turn-by-turn)的上下文演进差量:
- 剪枝与压缩事件回溯:完整记录 Harness 内核何时触发了上下文压缩(Compaction)或剪枝(Pruning),并高亮对比被丢弃的消息块与新生成的摘要摘要;
- 上下文寿命分析:直观展示哪些历史工具输出在多轮后仍滞留在上下文中造成“Token 污染”,辅助开发者调整工具输出的截断策略;
- 快照比对与回滚:支持在关键节点保存上下文快照,方便红队测试与基准评测时精确复现特定上下文状态下的模型表现。
3. 多 Agent 团队协同与委派日志全景视图
针对 DeepSeek Harness 支持的多智能体并发与工作流编排(如 Superagent、Research Agent 等),dsh-context 提供了专用的家族会话追踪面板:
- 多 Agent 会话汇聚:自动捕获并结构化聚合父智能体与各派生子智能体(Subagents)的执行日志;
- 任务委派审计(Delegation Briefs):以时间线形式展现任务派发指令、上下文继承关系、执行结果结算卡片与最终合并报告;
- 跨 Agent 消耗核算:清晰展现团队协同中每个独立 Agent 节点的 Token 贡献度与执行效率,帮助优化多智能体调度编排。
4. 开放侧边栏架构与终端交互集成
插件遵循 Harness 的开放插件设计规范,具备极佳的宿主融入体验:
- 双端无缝适配:同时适配官方 Web 管理端(
dsh web)与桌面客户端,在界面右侧提供一键折叠/展开的专用 Context 侧边栏; /context快捷指令集:开发者无需切出终端,即可在聊天输入框键入/context实时打印当前上下文概要或一键调起外部独立看板;- 一键安全脱敏导出:内置单键导出 Markdown/JSON 诊断报告功能,支持自动脱敏敏感环境变量、私钥与密码,便于团队共享与复盘。
快速上手
环境要求与插件安装
dsh-context 支持通过 DeepSeek Harness 官方插件命令一键挂载:
# 官方 Web 端(dsh web)安装插件
dsh plugin --profile web add bowenliang123/dsh-context
# 官方桌面端(desktop profile)安装插件
dsh plugin --profile desktop add bowenliang123/dsh-context
# 直接从 GitHub 仓库源链接安装
dsh plugin add github:bowenliang123/dsh-context
快捷指令与侧边栏调用
安装完成后重启 Harness 宿主进程即可立即生效。在交互过程中,你可以通过以下方式使用:
# 查看当前会话的上下文统计概览
/context
# 唤出独立可视化仪表盘窗口
/context open
# 检查最近一次上下文剪枝或压缩的差量报告
/context diff
# 手动触发一次当前会话的上下文清理与无用工具输出剪枝
/context prune
配置指南
在项目根目录或 Harness 配置文件中创建 dsh.context.config.yml 即可完成高级自定义:
# dsh.context.config.yml
context:
enabled: true
dashboard:
port: 3210
autoOpen: false
theme: "dark"
tracking:
detailedBreakdown: true
trackMultimodal: true
multiAgentLogs: true
pruning:
visualize: true
warnThreshold: 0.85 # 当上下文占用超过 85% 时发出警告
keepLastTurns: 10 # 保护最近 10 轮对话不被激进剪枝
最佳实践
- 排查 Token 异常暴涨:在发现计费或推理延迟激增时,运行
/context定位是否因cat大型日志文件或未经切片的巨型代码文件导致了上下文污染。 - 长会话调试与质量控制:在运行超过 30 轮的重构任务中,开启
visualize观察内核剪枝行为,确保系统关键规范(如不可变设计模式)始终常驻在核心记忆区。 - 多智能体架构性能分析:在多 Agent 协同任务后,导出上下文协同报告,评估哪些子 Agent 的委派上下文过于冗余,进而精简 Agent Prompt。
