yulongbai-nov/dsh-agent-control-plane--packages-session-tree ↗★ 0
dsh-session-tree
Independent session lineage browser for DeepSeek Harness rc.5
Other repositories with this package name
Install
npx -p @deepseek-ai/dsh dsh plugin --profile web add 'github:yulongbai-nov/dsh-agent-control-plane#6254de3e0c2d87af0d3fa68a895590e30e1bcdb9&path:packages/session-tree'README
Read the full README ↗独立会话树(rc.5 实验包)
Community plugin, not affiliated with DeepSeek Harness.
这是 独立主面板增量,不是常驻在侧栏里的树。侧栏「会话树」入口打开主面板;选择会话后切回会话,展开状态在页面运行期间保留。原生 Workspace 列表和页头 subagent 目录都不改。未安装、未在运行中的 GUI 实测,暂不能宣称完整通过 R7/R8 或可直接部署。
能做什么
- 用根作用域
useSessions/useSessionStatus/useWorkspaces展示根会话、当前目录投影和归档状态。每次展开调用ctx.sessions.refreshProjections(id);只请求被展开的层。子节点按各层values.subagentCatalog构建,打开时给ctx.uiWorkspace.openSession({parentSessionId, childSessionId, mode})传该层直接父 ID。收起父节点时只清理当前可见且允许展开的已展开后代,不穿过歧义、迁移、unknown/external 等不可展开边界,也不影响其他根;不可见或受阻节点遗留的展开状态保留,未来目录恢复后可能重新出现。再次进入主面板保留当前展开状态。 - 会话列表/投影由 rc.5 共享 store 实时更新;根列表删除后不再显示,目录成员由宿主目录为准,不假定可从摘要是否缺席推断子节点被删除。归档 ID 来自 Workspace 集合,显示为归档并禁止打开,与原生 Workspace 浏览器一致。缺少可靠运行基线的目录 fallback 行显示「状态未知」,不把未知当作完成或空闲;正常结束状态只在有可用运行基线和
subagentTiming.lastTurnCompleted时显示。此处的归档是 Workspace Session 归档,不是尚未实现的 Team 成员归档。 - 非歧义的 migration-required 节点可打开但不可展开;external 条目不可导航;目录读取失败提供重试。
idle的空目录只是可能过期的缓存提示,仍可展开以读取;只有状态为ready且目录明确为空时才视为叶子。idle且无目录按未加载处理;缓存的非空目录仍可显示。已请求但宿主仍无响应时显示加载中并保留重试入口;ready但无目录显示投影不可用,不伪装成空列表。已存在的投影若状态缺失或无效则提示「目录状态未知」并可重试,不把空缓存当作确定叶子,也不展示或导航其缓存子项;缓存仍参与保守冲突预扫,状态恢复为ready后重新显示。已知idle非空、loading和error的缓存显示行为不变;无论缓存状态如何,宿主仍负责最终身份与权限验证。refreshProjections()在宿主内部会合并 in-flight 请求,重试不会强制中断卡住的请求;面板为每个可见节点的刷新与重试跟踪当前意图,收起时撤销相应当前可见非歧义行的错误意图而不取消宿主请求,过期结果不覆盖新意图。面板刷新调用在微任务中发起,尚未发出的旧意图会跳过;这些竞态仅用替身模拟,不声称 rc.5 已发生该问题或验证真实 React 时序。 - 在当前快照中,从可见根沿已缓存的已知模式目录预扫(包括尚未展开的目录,不触发新加载);同父重复、跨父重复、根 ID 又作为子 ID 或祖先环被标为「身份存在歧义」,受影响行不能导航、展开或修改共享头像偏好。错误/加载态保留的旧目录也保守参与冲突检查,可能产生暂时性误报,并不证明当前真实身份有冲突;后续快照更新时重新计算。未加载或无法到达的目录不在检查范围,因此无提示不等于全局唯一或已授权;宿主仍负责身份、权限与导航校验。行键独立于 session ID,用于区分重复出现位置和键盘焦点。按 session ID 索引的摘要、目录、错误和本地偏好只读取自身属性,特殊名称如
__proto__不借用原型值;自身 getter 仍按原规则读取,本面板不保证抵御恶意 getter、Proxy 或受破坏的运行环境,也不声称宿主会产生此类 ID。 - 仅本原型的保守策略:子目录条目的模式为 unknown、缺失或无效时不导航、不展开并提示「模式未知」。rc.5 官方允许使用 unknown 地址打开只读历史,并在获取身份前禁用续聊;本原型的额外限制不声称是官方硬约束。unknown/external 行仍可修改按 ID 保存的本地头像偏好,只有身份歧义行禁用该选择。
- 六张内置头像来自已提供的 mock。手动选择单会话类型优先,其次按可能可见的 role、agentPreset、标题关键词推断,未知回退组长图;不会声称 rc.5 目前对所有会话暴露 Agent Spec、工具集或模型。可在面板选择本地静态 PNG 替换某个类型(文件及 Base64 还原后的 PNG 字节 ≤180000、宽高各 ≤2048,建议 144×144),也可恢复默认;APNG 与含
iCCP、zTXt、iTXt的 PNG 不受支持。保存前先检查有界 chunk 结构和尺寸,再等待宿主Image.decode()成功且输出尺寸一致;校验不检查 CRC、不代表完整 PNG 规范验证或恶意解码器安全保证,重复快速选择仍可能触发多个并行原生解码。会话类型和自定义图片存在当前浏览器 localStorage,清除站点数据会丢失,不与其他设备同步。旧图片不符合新上限或结构策略时显示内置图,符合预筛但渲染失败时按该次已提交版本回退内置图;不自动删除原存储,其他类型操作也保留旧值及未知字段。若现有头像存储不可读取、JSON 损坏、为数组或非对象,则显示默认且拒绝覆盖,需用户自行处置原数据;key 不存在可正常保存。对可解析对象也采用保守往返门禁:仅忽略字符串外空白后,原文必须与重新序列化结果一致,否则拒绝写入并保留原文,以免大数、重复键等在其他类型操作时丢失。此策略也可能拒绝合法但格式不同的旧数据,如1.0、非规范转义或整数键重排;通过门禁的写入仍可能重新排版,不保证原始字节格式。存储不可用/满时提示且不伪报保存成功。同一组件实例中,不同类型的异步成功写入合并,同类型以后一次选图或重置为准;即使新操作读/写失败,旧 pending 也不会复活,失败重置保留此前已保存头像。组件的 layout-effect 清理会使在途读取代次失效,避免随后回调写存储或状态;layout 清理与 passive 清理分离、StrictMode 清理/重挂载及旧实例迟到回调仅通过可控替身模拟,真实浏览器时序和 GUI 尚未验证。此客户端仅面向宿主浏览器,不宣称 SSR 支持。头像操作之间以最新意图决定状态提示;会话打开、刷新或头像偏好等其他通知不参与此顺序,可能被迟到的有效头像提示覆盖。跨组件实例、标签页及其他进程不做同步或冲突保证。 - 树提供方向键、Home/End、Enter/Space 和可 Tab 到的行内头像选择;扁平树为每行标注层级与同级位置,鼠标点击展开箭头后焦点返回树行。不可打开的行名称明确标示该状态,打开按钮原生禁用;只有身份歧义且行内所有操作均禁用时整行标为
aria-disabled,避免误标仍可操作的展开或头像控件。目录变化卸载直接聚焦的行时,通过 DOM ref 卸载回调记录原行,再在提交后仅当焦点确因移除而落到 body 时恢复到唯一移动行或仍可见的最近祖先;行内控件和树外焦点不会触发恢复。该行为已用真实 Chromium 和 rc.5 使用的生产版 React 配合合成宿主验证;完整 DSH GUI、键盘/屏幕阅读器及 React 开发版 StrictMode 的 effect 重放仍未验证。 - 本面板不提供在右侧栏打开按钮。 rc.5 的右侧栏只绑定当前屏幕上的会话;独立主面板激活时没有可用的会话 surface,直接打开会抛错。主会话导航返回
void,不承诺等到右栏挂载或历史完成,不能安全地链式打开。可先打开会话,再使用原生页头的子代理目录及其右侧栏入口。
运行和检查
无需安装依赖,Node 24 即可:
node packages/session-tree/build.mjs --check
node --test packages/session-tree/test/*.test.mjs
从本目录执行也可以:npm test。修改 client.template.js 或 avatars/*.png 后执行 node packages/session-tree/build.mjs 生成 client.js,再运行检查。原图是可编辑资源,生成产物把它们嵌入 ModuleLoader 单 JS,避免假设 profile 包的静态资源有公开 URL;--check 对比生成字节,防止模板与入口不一致。正式分发只需 package.json files 中列出的运行产物。
Host 侧已有只读冒烟:使用本机安装版 Electron 的 ELECTRON_RUN_AS_NODE=1 和 app.asar 内 Cordis,new Context().plugin(await import('./index.js')) 成功。测试通过真实的 client.js ModuleLoader factory,但 React hooks 和宿主服务是测试替身,不等价于真实宿主端到端测试。rc.5 uiWorkspace.openSession 返回 void,内部负责导航和历史加载;插件可提示同步异常,测试中的 Promise 拒绝处理仅为防御其他实现,不能保证捕获 rc.5 内部异步失败。注册、会话导航、权限错误和 UI 样式仍需真实 GUI 验证;只能在先证明安全隔离且用户批准的独立环境验收,不使用既有 GUI 或真实 profile。
package.json 遵循已安装 rc.5 插件的 dsh.bundle.patch、dsh.client.inject、exports["./client"] 和浏览器 window.__ModuleLoader__.load 约定。host apply 空实现;browser 唯一 require 是 host 注入的 react。版本门故意限定 rc.5,不使用兼容豁免。原型已提交、未安装,也未改真实 profile/app.asar。未来 GUI 验收仅在先证明安全隔离且用户批准的独立环境进行,不使用既有 GUI 或真实 profile;不承诺热更新。
主题和语言的实际依赖
- 运行时需要 rc.5 的官方
locale服务和--dsw-alias-*主题变量;manifest 的dsh.client.inject用于激活排序,客户端inject要求对应服务可用。插件按官方协议在所属ctx.effect注册中英字典并在卸载时释放,主面板通过 slot 的locale注入翻译函数;侧栏标签用locale.bind动态读取。宿主会话标题、模型和宿主错误是外部数据,不由插件翻译。 - CSS 仅引用安装版 rc.5 已存在的语义 alias(焦点使用
brand-primary、状态分别使用state-idle/business/success/warn-primary),透明及继承不是固定色;没有颜色 fallback。组件内 `` 随面板卸载,不修改全局样式。缺少官方主题或未来 token 改名会导致样式缺失,不能用单测证明两种主题的对比度或布局一致性。 - 测试使用与 rc.5 协议对应的 locale/slot 替身,覆盖中英渲染、重新注册及卸载,不等同于真实 GUI 的实时语言切换验证。受本任务“不安装、不改 profile”的限制,现有 GUI 无法加载此改动;浅/深色与 Plugin Manager 并排、Tab/方向键/屏幕阅读器、切语言和控制台 slot crash 均未验证,须在先证明安全隔离且用户批准的独立环境检查,不使用既有 GUI 或真实 profile。
实验性谱系共享接口
dsh-session-tree/lineage(源码)仅导出 catalogOf、buildRows、navigationTarget;这是供后续集成评估的实验性、不稳定 API,可能随版本调整,不提供单独的兼容保证。模块不依赖 React、DOM 或 Node 内建;build.mjs 将同一源码嵌入自包含客户端,既有主面板继续消费它,不要求浏览器额外模块加载。现有 UI、筛选和目录状态策略未因抽取改变,Node 替身中直接导入模块与客户端工厂使用相同 fixture 对照,不等同真实宿主验证。
不得把它当作原生 Workspace 的筛选、授权或安全导航机制。 buildRows 仍是主面板的根会话筛选,不实现原生工作区分组、搜索、固定、排序、归档筛选或显示水位,也不保证缓存范围外的身份唯一、权限与来源。未来候选 fork 应在原生逻辑选定、排序并限定可见根后再谨慎接入树展示,先核对跨工作区冲突与数据来源,保留宿主权限检查和直接父地址;不能直接用此函数替代官方根列表,也不能把未发现冲突当授权。接口抽取不构成侧栏 fork 或 R7 完成。
自动回归中的构建 CLI 测试会在系统临时目录新建一个 dsh-session-tree-test-* 合成副本,并打印其路径;为避免未经授权删除,不自动清理,重复运行会累积。副本只含包源码和六份短小合成文件,不涉及用户会话、真实 profile 或 GUI。构建会在写入前用 Node 的脚本语法解析检查模板和生成物,不执行待解析脚本;该检查不能证明浏览器运行时兼容或安全。关于 import.meta.main,本机验证的是 Node 24.22.1;为缺少该属性的运行时提供真实路径对比 fallback,24.0/24.1 仅模拟未实机验证。
真侧栏树:CR-003 决策与差距
独立主面板不是 R7 的最终交付。 rc.5 的 sidebar.panellist 是导航图标列表,其同 ID 的 main 是独占主面板,不是能嵌入持续可见树的侧栏内容。当前尚无已验证的 single-slot 无损组合方式;选择以版本锁定的小范围 Workspace UI fork 作为候选,若上游提供可组合 slot 则优先复用。该 fork 尚未实现或验证,不得静默替换现有组件。要在聊天期间持续显示真侧栏树,可以:
- 维护兼容版本的 Workspace UI fork/替换:在现有
sidebar.workspaces单席内保留原生排序、分组、归档、权限与水位线,再把 subagent 目录渲染到根行下。体验最接近 mock,但涉及较大的 rc 更新及回归维护。 - 增加上游正式的侧栏 list/嵌套 slot,让独立插件填充原生 Workspace 下方或每个会话行下;这需要 upstream 提供能力,外部插件不能单方面新增已被宿主渲染的 slot。直接抢占
sidebar.workspaces会遮蔽原面板,不是无损组合,不建议静默采用。
尚未实现自动任务标题、Team 成员归档、树内完整原生菜单/删除动作、按工作区筛选、用户指定图案逐会话覆盖、统一 Agent Spec/工具集判定、模型读取以及虚拟化;这些不是本独立增量已经交付的功能。头像自定义策略与存储位置也和 spec 草案的 profile 资源覆盖不同。显示树以根为 level 1,最多显示 128 层;到达上限的非叶节点标明「达到显示深度上限」并禁止继续展开,不能代表无后代。它不限制已有缓存目录预扫的宽度,也未实现虚拟化或 Host 级递归预算;典型验收为根加三级。
Real React focus regression (component integration, not DSH E2E)
test/focus-browser.integration.cjs exercises the shipped client artifact in headless Chromium with real React 18.3.1 from the exact pinned rc.5 frontend asset and synthetic Host adapters. It checks conflict removal, reparenting, ref reattachment on rerender, external/child-control focus, intentional body focus, and empty roots, with and without a StrictMode wrapper. The pinned production React build does not exercise development-only StrictMode effect replay. The fixture uses React's synchronous commit to make mutations reproducible; it does not run DSH's full GUI or verify the four separately skipped simulated fixtures.
For an explicitly provisioned test environment, set PLAYWRIGHT_PATH to Playwright's module directory, CHROMIUM_PATH to its compatible browser executable, and REACT_BUNDLE_PATH to a local copy of the installed rc.5 dsh-web-frontend/dist/assets/index-BXV-oxvX.js asset. The script checks the bundle SHA-256 before extracting React; mismatches fail closed. Run node test/focus-browser.integration.cjs from any directory. It launches a fresh temporary browser profile, denies page network requests, and uses only synthetic data. Browser startup may require appropriate OS sandbox permissions; these measures do not establish a full isolation proof.