前言¶
DeepSeek Harness (DSH) 采用“一切皆插件”的理念，将功能模块化。在智能体开发与调试过程中，管理会话轨迹、Prompt、MCP 配置以及修复 sessionlog 往往需要在不同界面间切换，操作链路较长。
dsh-context-console 是一个面向 DSH 的完整上下文工作台插件。它将原本分散的会话轨迹展示、Prompt/Skill/MCP/Tools 分类管理、缓存观察、消息锻造和 sessionlog 修复整合在同一个工作台中。该插件是 dsh-assistant-message-forge 的正式继任者，继承了其消息锻造能力、RPC 兼容层和原有数据目录，并在此基础上增加了新的上下文管理功能。
核心功能¶
插件提供以下工作区能力：
- 轨迹砖块墙：展示 user、assistant、reasoning、tool call/result、request header 等会话事件。支持展开、过滤以及行内编辑。
- 分类管理：双栏管理 Prompt、Skill、MCP 与 Tools。支持拖拽上线/下线，以及选择 Prompt 插入位置。
- 缓存与历史：跟踪 request header 变化、cache read token 和管理动作。数据持久化到 SQLite 历史流。
- 模拟消息：支持注入 Assistant、User、Tool Call、Tool Result 或原始 JSON 事件。
- 消息锻造：保留草稿、提供详细上下文卡片、支持 surface replace，具备导入识别与直接注入能力。
- 会话修复：识别 JSONL/Zstandard sessionlog。采用“后写分支覆盖 + 官方 crash closer + Session.create 校验”策略创建修复子会话。此过程绝不改写源日志文件。
- 子代理轨迹：识别 subagent tool call/result，并在可获得子会话 ID 时嵌套展示其轨迹。
安装与启用¶
通过 Corepack 调用 pnpm 安装插件：
corepack pnpm dsh plugin --profile web add dsh-context-console
如果当前正在使用 dsh-assistant-message-forge（消息锻造台），建议一次性完成替换，避免两个插件注册相同的兼容 RPC：
corepack pnpm dsh plugin --profile web remove dsh-assistant-message-forge
corepack pnpm dsh plugin --profile web add dsh-context-console
安装完成后，原有 $DSH_HOME/assistant-message-forge/ 数据会直接复用，无需转换。安装后需重启 DSH 以加载插件。
兼容版本¶
DSH 当前处于快速、破坏性演进阶段，安装前请核对兼容版本表：
| 插件发布通道 | DSH 基线 | 兼容承诺 |
|---|---|---|
npm latest（当前正式发布插件） |
dsh-v0.1.1-rc.2 |
已验证维护基线 |
npm next 候选 |
dsh-v0.1.5-alpha.1 |
适配 Session Log V3 |
| 后续 DSH 正式版 | 尚未发布 | 待发布并完成验证后声明兼容 |
注：开发版不会覆盖 npm latest。alpha.5 依赖按 0.1.5-alpha.1 精确锁定，继续使用 snapshotEvents()、SessionSeq 和 SessionLogOffset。
环境要求：
* Node.js：^22.19.0 || >=24.0.0
* pnpm：建议通过 Corepack 调用（版本 11.7.0）。
数据与安全边界¶
插件运行时涉及的数据存储位置如下：
- Context Console 配置：
$DSH_HOME/context-console/manifest.json - 历史与缓存事件：
$DSH_HOME/context-console/history.sqlite - 继承的草稿与上下文记录：
$DSH_HOME/assistant-message-forge/
安全与权限说明：
* RPC 复用 DSH Connection 的 Host/Origin 栅栏和浏览器认证，插件不再维护独立授权策略。
* MCP 配置可能包含环境变量或请求头；导出状态前应自行检查敏感字段。
* sessionlog 修复只创建带 parentSession 的新会话，不覆盖或截断来源文件。
* 正在执行、存在未闭合 turn 的会话会拒绝消息注入和 surface replace。
总结¶
dsh-context-console 适合需要在 DSH 环境下深度管理会话上下文、调试 Prompt 逻辑或修复日志文件的开发者。它提供了从轨迹查看、资源管理到消息注入和日志修复的一站式操作入口。如需查看源码、提交问题或核对版本完整性，可访问插件目录或 GitHub 仓库。
