DSH Context 上下文全景透视与多Agent日志面板

DSH Context 上下文全景透视与多Agent日志面板

dsh-context·v1.2.0·tools

dsh-context 是一站式 DeepSeek Harness 上下文可视化与管理插件。提供独立的 Context 看板、浏览器、侧边栏与 /context 指令。深度透视 Token 构成与来源分布,追踪多轮对话的上下文演进、压缩与剪枝(Pruning)历史,并全景整合多 Agent 团队的会话日志与任务委派记录。

上下文可视化 · Token透视 · 剪枝追踪 · 多Agent看板 · Harness工具

GitHub版本下载
快速安装与集成
bash
dsh plugin --profile web add bowenliang123/dsh-context

项目简介

在现代以 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 官方插件命令一键挂载:

bash
# 官方 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 宿主进程即可立即生效。在交互过程中,你可以通过以下方式使用:

bash
# 查看当前会话的上下文统计概览
/context

# 唤出独立可视化仪表盘窗口
/context open

# 检查最近一次上下文剪枝或压缩的差量报告
/context diff

# 手动触发一次当前会话的上下文清理与无用工具输出剪枝
/context prune

配置指南

在项目根目录或 Harness 配置文件中创建 dsh.context.config.yml 即可完成高级自定义:

yaml
# 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。