会话上下文面板 yusufameri/dsh-t3-session-ui

dsh-t3-session-ui

T3 Code 为 DeepSeek Harness 打造的会话上下文 UX：一个会话行上下文块、provider/model 标签、一个状态胶囊、一条按会话的头部上下文条，以及一条谱系面包屑——全部位于 DSH 已有的界面中，未向 composer 添加任何内容。

| 实况：会话行悬停卡片 | 实况：Settings 行 |
| 真实 DSH 窗口中的悬停卡片，承载真实宿主值 | DSH Settings 内该插件的偏好行 |

| 悬停卡片（渲染） | 状态阶梯 |
| 会话行悬停卡片 | 状态层级循环切换 |

| 头部条与谱系 | Settings 行（渲染） | 浅色主题 |
| 头部上下文条与谱系面包屑 | 偏好行 | 浅色主题下的悬停卡片 |

关于这些图片。 前两张是安装了该插件的真实 DSH 0.2.0-rc.1 实例的实况截图——其中的值（Shimas's MacBook Pro、default-workspace、standard、 ask）各自来自不同的真实 Host 探测，而非测试夹具。其余为组件渲染：由测试夹具数据驱动该插件的真实组件，并配以具有代表性的主题 token 表，用于新实例没有 git 仓库、没有子代理、也没有长对话可展示的场景。
assets/README.md 介绍了这些渲染及其重新生成命令； tools/live-cdp.mjs 驱动实况截图。

致谢

本插件实现的信息层级属于 T3 Code：会话行悬停卡片、状态阶梯、provider/model 行，以及带压缩操作的上下文窗口环，均为其所有。T3 Code 以 MIT 协议开源；本移植版保持相同的形态，并将底层数据替换为 DeepSeek Harness 的数据。请支持原项目。

它添加了什么

每个界面都从本包自有的 Host 半部分读取一个按会话的上下文包。Host 无法读取的事实会被省略而非伪造，因此位于 git 工作树之外的会话就干脆没有分支行。

| 界面 | 位置 | 显示内容 |
| 行悬停卡片 | sidebar.session.row.hover | 状态、机器、工作区、分支（+ 脏标记）、工作树、model · provider、代理预设、父会话、委派深度、审批策略、上下文用量，以及错误行 |
| 行标签 | sidebar.session.row.leading | 将 model 作为该行的前导单元格，并带一个状态点 |
| 行悬停操作 | sidebar.workspaces.session.row.action | 复制上下文包，位于随附的归档和固定按钮旁边 |
| 头部条 | conversation.session.header.utilities | 状态、模型、分支、工作区、审批策略、子代理数量、预设、委派深度 |
| 头部面包屑 | conversation.session.header.lineage | 复现会话标题，并添加父级、预设和深度标签 |
| 设置行 | settings.general.item | 插件在 DSH 设置中的自身偏好行——各界面报告哪些事实，以及一个机器标签覆盖项 |
| 复制操作 | conversation.session.header.actions | 将整个上下文包复制为 JSON |
| 行菜单项 | sidebar.workspaces.session.menu.item | 将上下文复制为 JSON、复制分支名称、复制工作目录 |

状态阶梯

阶梯在 Host 上按 T3 Code 的优先级顺序解析：

| 阶梯 | DSH 如何报告 |
| 待审批 | approval/request 瀑布流被括在 next() 两侧，因此该阶梯恰好在人类正在决策时点亮 |
| 等待输入 | user-questions/request 瀑布流，以相同方式括起 |
| 工作中 | api-session/status 存活事件，加上会话日志中一个打开的 turn/start |
| 错误 | 失败的 turn/end，或在回合之外引发的 api-session/error |
| 子代理工作 | ctx.subagents.listChildren(sessionId) |
| 就绪 | 以上皆无 |

审批和输入是进程本地的而非持久的，这就是为什么它们从瀑布流而非会话日志中读取：一个包裹 next() 的监听器精确地知道一个询问已悬置多久。

显示设置

这些偏好项位于 DSH 自己的设置面板中，作为 General 部分的一行，并按浏览器存储在 dsh.t3-session-ui.prefs.v1 下：每个事实一个开关（机器、工作区、分支、模型、预设、审批、上下文），以及一个机器标签覆盖项，其优先级高于 Host 美化后的主机名。它们刻意保留在浏览器端——它们只改变此插件的渲染，且必须无需 Host 往返即可工作，而一个 Host 由每个已连接的浏览器共享。

编辑器中没有添加任何内容。 早先的一个修订版在那里放了一个上下文窗口环；它已被移除，因为输入区域是用于输入的，而会话事实属于会话界面。该环过去显示的令牌详情现在出现在悬停卡的上下文行中（42% · 83k/200k），而压缩上下文是会话行 ... 菜单中的一项，运行 DSH 自己的 /compact 命令；此插件从不重新实现压缩。

安装

dsh plugin --profile desktop add dsh-t3-session-ui

或者从检出目录安装，无需构建步骤：

dsh plugin --profile desktop add /path/to/dsh-t3-session-ui

移除该捆绑包会注销每个席位，并恢复先前的编辑器工具栏，不留任何残留。

工作原理

此 UI 显示的事实无法从浏览器访问——机器身份是一次 node:os 调用，而 sessions、tokenMeter、approval 和 compaction 不带有 @Remote 接口，因此 Client 半边无法通过 ctx.remote。因此 Host 这一半只提供一个带围栏的 JSON RPC 路由：

POST /t3session/api/hostFacts -> 机器标识，无需会话 POST /t3session/api/sessionContext -> { sessionId } -> 上下文包 POST /t3session/api/compact -> { sessionId } -> 运行 /compact

该路由被围栏限制在回环地址（加上部署声明为可信的任何 authority），拒绝跨站浏览器标记，并在存在 Origin 时要求其匹配。因此浏览器页面可以用一个普通的相对 fetch 访问它，与 dsh-better-sidebar 和 @michengai/dsh-codex-ui 使用的是同一座桥。

各项事实的来源：

| 事实 | 来源 |
| 机器标签 | os.hostname()，美化处理（Shimas-MacBook-Pro.local → Shima's MacBook Pro），可由配置或显示设置覆盖 |
| 工作目录、预设、父会话、委派深度 | Session.header |
| 提供方、模型、上下文窗口大小 | Session.requestContext() |
| 分支、脏状态、工作树 | 在会话自己的目录中运行 git，缓存 5 秒 |
| 已用 token | ctx.tokenMeter.measure(session) |
| 存活状态和待处理的询问 | api-session/status、api-session/error，以及 approval/request / user-questions/request 瀑布流 |
| 子代理扇出 | ctx.subagents.listChildren(sessionId) |
| 审批策略 | ctx.approval.overrideOf(session) |

配置

该插件从 bundle patch 中读取一个可选设置：

- id: t3-session-ui
name: 'dsh-t3-session-ui'
config:
machineLabel: "Shima's MacBook Pro" # 可选；默认为美化后的主机名

其他所有内容都是按浏览器区分的显示偏好，在 DSH Settings 中该插件的行内设置。

开发

纯 ESM，无构建步骤。Client 这一半由 DSH 的客户端模块加载器按原样加载，因此编辑 client.js 会在下次页面加载时生效。

pnpm install
pnpm test # 101 个测试

测试套件无需 DSH 即可运行，覆盖三个层次：

- test/host.test.js —— host 辅助函数，包括真实的临时 git 仓库（干净、脏、仅未跟踪、分离 HEAD、链接工作树）。
- test/route.test.js —— 真实的 apply() 针对伪造的 Cordis 上下文运行，调用 HTTP 处理器并对其线上输出进行断言。这一层之所以存在，是因为未被 await 的探测会序列化为 {}，而任何检查处理器内存中对象的测试都无法发现这一点。
- test/client.test.js —— Client 这一半通过打桩的 window.__ModuleLoader__ 加载，并针对一个 fixture bundle 渲染为静态标记。

发布

0.1.1 修复了 0.1.0 引入的一个缺陷：若干 Host 探测未被 await，导致 provider、model、contextWindow、turn、token 计数以及整个机器标识在线上序列化为 {}。上面新增的路由级测试层可确保该故障模式不会重现。

要求

- DSH 0.1.5-rc.1 或更新版本
- Node.js 20+

许可证 MIT。移植的设计来自 T3 Code，同样采用 MIT 许可证。