组件管理列表（Component Registry）

September 19, 2026 · View on GitHub

本文件是 dsh-widgets-plugin 仓库的组件登记册：仓库里每一个组件、发布包、插槽注册点、 构建产物、依赖关系与维护要求的唯一清单。新增或修改组件时，请同步更新本表（总览 → 明细 → 插槽 → 产物 → 维护清单），发布前按第 7 节过一遍。

术语约定：

  • 组件：一个可独立识别的最小可交付单元（服务、Provider、挂件、设置页、bundle）。
  • 包：发布到 npm 的容器（@dsh-plugins/*），一个包可含多个组件。
  • 插槽（slot）：Harness 浏览器端/宿主的扩展点（shell.overlay、settings.section、remote、webServer）。

1. 组件总览

#组件类型所属包呈现位置一句话说明
1balance 能力缝隙（Host）能力缝隙@dsh-plugins/balanceHost 服务ctx.balance（BalanceRuntime）：绑定提供商路由，应答 balance/query、balance/list Remote
2balance Remote 挂载（Client）客户端服务@dsh-plugins/balanceclient remote 服务把生成的 balance Remote（balance/query + balance/list）挂进 client 的 remote
3余额厂商 Provider ×5Host 插件@dsh-plugins/balanceHostdeepseek / moonshot / openrouter / siliconflow / new-api 五个真实余额查询
4不支持厂商占位 ×5Host 插件@dsh-plugins/balanceHostopenai / anthropic / google / xai / mistral 的「无公开余额接口」占位
5余额设置 Web 后端Host Web 路由@dsh-plugins/balance/_dsh/balance/settings设置页的 GET 快照（脱敏）与 POST 持久化
6余额看板挂件 BalanceWidgetWeb 挂件@dsh-plugins/balanceshell.overlay（order 100）浮动余额看板：视口内拖动/角吸附/缩放/折叠过渡、滚动金额、趋势箭头、单/多账户视图；面板/胶囊/悬停提示为液态玻璃材质（与彩虹流光输入框同一配方）
7余额供应商配置面板 BalanceSettingsWeb 配置弹窗@dsh-plugins/balancewidgets.config（管理器「配置」弹窗）管理 balance 设置分区的用户绑定（provider/vendor/凭据/baseURL）
8BalanceController + useBalance客户端数据层@dsh-plugins/balance注入 hook跟随当前 session + model，固定 30s 轮询刷新，暴露 refresh()
9balance 视图 store客户端状态@dsh-plugins/balance注入 store缩放 / 吸附 / 折叠视图状态（createBalanceViewStore）
10字典 NS balance客户端 i18n@dsh-plugins/balanceclient localezh / en 双语文案
11Token 暴击挂件 TokenCritWidgetWeb 挂件@dsh-plugins/client-ui-token-critshell.overlay（order 50）透明可拖动/缩放的 token 用量计数器 + 暴击动效 + 设置面板
12会话监控看板 SessionMonitorWidgetWeb 挂件@dsh-plugins/client-ui-session-monitorshell.overlay（order 90）列出运行中/空闲/本轮完成的会话（子代理默认过滤、可配置时间范围默认 1h），完成一轮主动弹提醒（按状态配色：完成/待处理/出错/中止/阻塞/token 上限等，可自动消失或需确认），点击行一键跳转；任务进度显示（有任务在执行的会话带动画进度条 + 「第 N 轮 · 正在执行 <工具>」/子代理/后台任务标签，工具与轮次由 Host 半折叠；目标模式会话升级为确定进度条「目标 第 X/Y 轮」，读 projectionValues.goal 实时百分比）；未读 inbox 徽标（头部 + 收起胶囊，5s 轮询 /notifications，点击跳最新未读会话并标记已读）；可收起为胶囊、拖角缩放；面板/胶囊/提醒条为液态玻璃材质（与彩虹流光输入框同一配方）
13会话监控 Host 半 + 状态路由 + 通知 inboxHost 插件 + Web 路由@dsh-plugins/client-ui-session-monitor/_dsh/session-monitor/status 等 9 条路由监听 turn/end 记录结束原因（completed/aborted/blocked/error/max-tokens/interrupted）+ tool/call→tool/result 折叠每会话执行中的工具（tools 表）+ 累计轮次（rounds 表），浏览器半 3s 轮询取回；另把会话事件折叠为持久化通知 inbox（审批/回答/计划/出错/阻塞/token 上限/完成一轮/子代理完成等，已读状态存 Host，桌面与网页共享）
14会话监控配置面板 SessionSettingsWeb 配置弹窗@dsh-plugins/client-ui-session-monitorwidgets.config（管理器「配置」弹窗）提醒开关/关闭方式/秒数/音效/提醒范围与列表显示选项 + 「桌面端会话监控」开关（默认关，打开时经 dsh-smon:// 拉起桌面应用并开始监控，关闭后桌面挂件暂停），localStorage 持久化
15卡片容器 CardContainerWidgetWeb 挂件@dsh-plugins/client-ui-card-containershell.overlay（order 20）浮动容器面板：多分组（顶部分组标签 + ⋯ 管理菜单），托盘列出可停靠挂件，拖入网格即停靠（影子条目隐藏浮窗）、渲染紧凑卡片视图；卡片实时换位（ghost 跟随 + 其余让位，拖出网格=移出）、键盘可达（Enter/空格移出、方向键排序）、触屏常显、列数可配、状态持久化；面板/卡片/胶囊/分组菜单为液态玻璃材质（与彩虹流光输入框同一配方）
16卡片容器控制器 CardContainerController客户端数据层@dsh-plugins/client-ui-card-container注入 hook多分组停靠（groups/active 持久化，旧单列表自动迁移）+ 可用托盘投影，注册/释放 priority -2 停靠影子，针对 overlay 台账自我修复
17卡片视图Web 卡片视图@dsh-plugins/client-ui-token-crit / client-ui-session-monitor / balancewidgets.card（容器声明子槽，容器无内置卡片）token-crit、session-monitor、balance 各自注册自己的紧凑卡片（priority 0：token 用量 / 忙碌会话数 / 实时余额，见各自包源码）；标准接入规范（WidgetCardProps + 槽级注入面 CardSlotInject，见 WIDGET-DEVELOPMENT.md §2.5）：挂件自己注册进 widgets.card（id = shell.overlay id、priority 默认 0、显示名优先读 shell.overlay 的 label）即渲染，不注册则用占位卡；卡片可声明规格（静态 spec：small 1 列 / medium 2 列 / large 整行）
18卡片容器配置面板 CardContainerSettingsWeb 配置弹窗@dsh-plugins/client-ui-card-containerwidgets.config（管理器「配置」弹窗）列数（自适应/2/3/4）+ 清空停靠/重置，localStorage 持久化
19安装 bundle分发层@dsh-plugins/dsh-widgets-plugincordis.patch.yml一次插入 6 个插件，一键挂载全部组件
20小组件管理页 WidgetManagerSettingsWeb 设置页@dsh-plugins/client-ui-widget-managersettings.section（order 10）实时列出小组件，支持「添加/关闭」，并为带配置的挂件提供「配置」弹窗；未安装挂件提供「安装指引」弹窗（装包命令 + cordis.yml/cordis.patch.yml 挂载行 + 重启提示）；支持非 overlay 组件（configOnly，如 rainbow-flow——启用/停用经 window 事件桥控制其自身开关 store，与工具栏圆点双向同步）
21会话监控桌面快照路由Host Web 路由@dsh-plugins/client-ui-session-monitor/_dsh/session-monitor/sessions把实时会话存储折叠成紧凑 JSON 行（running/title/pending/子代理计数等），tools/rounds 与行级 goal（goal/change 折叠）同车返回（桌面挂件任务/目标进度条数据），桌面挂件 2s 轮询
22会话监控独立挂件页Host 托管的独立 Web 页@dsh-plugins/client-ui-session-monitor/_dsh/session-monitor/widget自包含 HTML（无框架）：「待处理」通知列表（主视图，未读徽标 + 处理/忽略/全部已读 + 级别开关）+ 「会话」列表副 Tab + 完成一轮 toast + 置顶/隐藏/设置，供桌面壳加载
23会话监控桌面悬浮窗壳桌面应用（Tauri 2）desktop/dsh-session-desktopWindows 桌面无边框/透明/置顶/无任务栏小窗 + 托盘（显示/退出），加载挂件页；启动时探测本机 web 服务、外部导航交系统浏览器
24彩虹流光 RainbowFlowGlowWeb 输入框装饰@dsh-plugins/client-ui-rainbow-flowconversation.input.left（order 99）整个输入框通透玻璃 + 呼吸彩虹光晕（无边框）：开关开启时输入卡变通透玻璃面板（两段白色玻璃渐变（淡光穿过玻璃）+ 卡片 ::before 轻磨砂层 blur(5px) saturate(1.35)——轻模糊让背后内容清晰、强增饱和让背后色彩透出发光；上下边缘各一条 1px 细反光线（box-shadow inset，顶部亮 0.40 / 底部柔 0.26）让玻璃边缘有存在感、无大片高光弧，--rf-glass-* token 主题感知亮/暗两套调色板，伪元素方案避免破坏 fixed Tooltip）——无可见环带/边框，唯一边缘装饰是 一圈贴合卡片圆角的彩虹柔光（16 方向 box-shadow + mix-blend-mode: screen 加色混合——每方向一个纯彩虹色相（间隔 22.5°、完整色轮：红→橙→黄→绿→青→蓝→紫→粉，两两之间有中间色），小偏移 7px + 宽 blur 34px 让每个色相与左右相邻色都重叠成平滑连续彩虹渐变（完全无分段）（普通堆叠会混成单色脏团）；box-shadow 天然在元素外侧（卡片内部完全干净、输入框从不被染色）且跟随 border-radius（光晕沿卡片圆角弯折，mask 挖环做不到会切直角）；发光层精确对齐卡片边缘（.glow inset 5px = flow 外扩量，border-radius 22px = 卡片圆角 27−5，阴影峰值正好落在卡片边缘上）；所有阴影 spread 0（正 spread 会在边缘切出全强度核心 = 可见的「内部轮廓」亮线；spread 0 让 blur 承担全部衰减、峰值在边缘向内外双向渐变）+ 柔和 inset 内发光（读起来像卡片本身发光）；screen 混合让颜色在深色页面上保持亮丽鲜明（普通混合会塌成暗影）；亮色主题回退 normal 混合 + 低 alpha），像呼吸一样脉动：rAF 循环积分呼吸相位，每帧只写两层（暖彩虹 .glow + 冷蓝紫 .glowCool）的 opacity（0.18↔0.38 纯明暗呼吸）——刻意不用 scale（缩放会让发光层边缘脱离未缩放的卡片、峰值时重新露出内部轮廓；光晕层始终钉在卡片边缘，2.1 倍亮度落差表现「光随呼吸扩张」）——合成器友好（静态 box-shadow 层只栅格化一次，无重栅格化），呼吸频率由 token 速率驱动（5s↔1s，指数缓动平滑过渡、相位不跳）；另加 CSS hue-rotate 色相缓慢流动（48s/圈：8 方向位置不变、每个色相漂移成下一个——红→橙→黄→…→粉→红，几何不动；prefers-reduced-motion 冻结）；心情感知色调 = 双层交叉淡化（思考/工具调用时 mood 因子缓动到 1，opacity 从暖层移到冷层——纯 opacity 动画）；不支持 mix-blend-mode: screen 的浏览器回退普通混合（变暗但完整）
25彩虹流光开关 RainbowFlowToggleWeb 输入框控制@dsh-plugins/client-ui-rainbow-flowconversation.input.left（order 100）输入框工具行左端液态玻璃质感彩虹小圆点开关（半透明渐变 + blur + 高光，开/关持久化 localStorage），右上角状态点随会话运行变绿
26发送/停止按钮美化 RainbowFlowSendWeb 输入框控制@dsh-plugins/client-ui-rainbow-flowconversation.input.right（order 150）对输入框主操作发送/停止按钮做液态玻璃图标美化 + 动态效果：conversation.input.right 探针把按钮有效状态镜像到输入卡 data-rf-send，全局样式表给按钮做半透明玻璃面板（白色渐变 + backdrop blur + 顶部高光）透出柔和彩虹 + 细玻璃描边——空闲有草稿时呼吸光晕、运行中彩虹旋转 + 扩散雷达脉冲环；与开关共用开关状态、禁用态不生效、prefers-reduced-motion 冻结动画；选择器锚定 [data-composer-card] + _primary 后缀，harness 升级后仍生效
27彩虹流光配置面板 RainbowFlowSettingsWeb 配置弹窗@dsh-plugins/client-ui-rainbow-flowwidgets.config（管理器「配置」弹窗）可调透明度（40/70/100%）、速度灵敏度（0.5×/1×/1.5×）、思考冷色调开关、命令按类别上色开关（commandColor，默认开）、最新行动彩虹扫字开关（commandSweep，默认开）；另含命令文字颜色——每类命令（shell/read/search/write/edit/code/web/ask/plan/memory/think/other）一个取色器 + 单行恢复默认，写入 --rf-tool-* CSS 变量经 store 持久化到 localStorage（dsh.rnglow.settings），已挂载的光环与已上色的命令卡实时生效
28彩虹流光设置 store settings.ts客户端状态@dsh-plugins/client-ui-rainbow-flow注入 store透明度/速度/冷色调/命令按类别上色（commandColor）/最新行动彩虹扫字（commandSweep）/命令颜色（toolColors，每类一色）的读取/保存/订阅（uSES），与配置面板和光环共享；启用/停用经 window 事件桥与管理页双向同步（dsh.rnglow.manager-toggle / enabled-change，与工具栏圆点同一开关 store）；另含心情感知色调 = 双层交叉淡化（思考/工具调用时 mood 因子缓动到 1，暖层→冷层 opacity 纯动画）、reduced-motion 单帧静态、IntersectionObserver 视口外停 rAF、零重栅格化（静态 box-shadow 层只栅格化一次）
29彩虹流光命令卡上色 toolAccentWeb 输入框装饰（会话记录命令卡）@dsh-plugins/client-ui-rainbow-flow非插槽（MutationObserver + [data-tool]/[data-variant="bash"]/[data-variant="think"] 装饰）会话记录里模型每个工具调用（命令）卡片按工具名启发式分类（shell/read/search/write/edit/code/web/ask/plan/memory/other，另 「Think」思考推理行 data-variant="think" 归入 think 淡紫类别）：卡片左侧亮起对应颜色边条，相关文字也按类别上色——标题用主题感知渐变（background-clip: text）、前导图标类别色、摘要柔和色调、读/写/编辑类文件的路径链接（_fileLink）用纯类别色（悬停显示类别名）；读卡片稳定 data-tool 属性（shell 卡是例外：它由专用卡片组件渲染，只带 data-variant="bash"、没有 data-tool，故按变体归入 shell）→ classify.ts 分类 → data-rf-tool-cat 属性 + ToolAccent.css 上色；不重渲染卡片、不改产品 DOM，harness 升级后仍生效（文字按 CSS-module 本地名后缀 _title/_leading/_summary 选中，同发送按钮 _primary），未知工具归入"命令"默认色；斜杠命令卡（conversation.chat.commandview 的 GenericCommandCard，data-variant="others"、无 data-tool）不在上色范围；每类颜色可按用户配置自定义（把设置里的 toolColors 写成 <html> 内联 --rf-tool-*，覆盖样式表 :root 默认，实时生效）；最新行动（命令/思考）被彩虹扫过（正文除外）（会话里最新的一条——工具卡、shell 卡或 data-variant="think" 思考行，setLatest 在 ROW_SELECTOR 并集里取最晚标 data-rf-latest——其 _title/_summary/_fileLink 被流动的彩虹渐变（background-clip: text）扫过每个字符，输出正文不参与；跟随最新行动持续（read/edit 等秒完的命令也亮，不依赖 running），直到其后出现正文回复（flow-item 结构精确判定，不误判 composer）才熄灭）——纯 CSS、不重渲染 DOM、prefers-reduced-motion 冻结；受 commandSweep 开关控制，经本模块写成 <html> 的 `data-rf-sweep='on'

1–10 全部由 @dsh-plugins/balance 一个包、一个插件行承载（原 balance 缝隙 + balance-vendors + client-ui-balance 三个包已合并）。

2. 发布包清单

7 个包版本号保持一致（当前 0.1.0），全部带 "publishConfig": { "access": "public" }， 包间依赖一律 workspace:*（禁止 link:）。

包版本角色发布内容（files）关键 exports维护来源
@dsh-plugins/balance0.1.0合并后的余额插件（Host 缝隙 + 厂商 + Web 看板）lib.、./invariant、./types、./typert、./remote、./client独立维护（已废弃 harness 同步）
@dsh-plugins/client-ui-token-crit0.1.0Token 暴击挂件（浏览器端，纯 UI）lib.、./client独立维护
@dsh-plugins/client-ui-session-monitor0.1.0会话监控看板（Host 半：turn/end 原因跟踪 + 通知 inbox + 路由；浏览器端看板）lib.、./client独立维护
@dsh-plugins/client-ui-card-container0.1.0卡片容器（浏览器端，纯 UI：声明 widgets.card 子槽、停靠影子，无内置卡片）lib.、./client独立维护
@dsh-plugins/client-ui-rainbow-flow0.1.0彩虹流光（浏览器端，纯 UI：conversation.input.left 注册光环 + 开关）lib.、./client独立维护
@dsh-plugins/client-ui-widget-manager0.1.0小组件管理设置页（浏览器端，纯 UI）lib.、./client独立维护
@dsh-plugins/dsh-widgets-plugin0.1.0可安装 bundlecordis.patch.yml./cordis.patch.yml独立维护

每个包的 package.json 还带 dsh.client 声明（inject 依赖列表 + platform: "web"）， 浏览器产物由该声明被发现。

3. 组件明细

3.1 合并后的余额插件（@dsh-plugins/balance）

  • 包：@dsh-plugins/balance（packages/dsh-balance），一个插件行。
  • Host 入口 src/index.ts：name/inject: ['settings']/Config/apply。 apply() 依次：
    1. new BalanceRuntime(ctx, { requestTimeoutMs }) —— 构造即经 Service 基类 自注册 ctx.balance（绑定提供商路由，应答 balance/query + balance/list 两个 Remote；凭据经 ctx.credentials 或环境变量解析；按路由折叠 trend/delta）。
    2. 注册 PROVIDERS（5 厂商 + 5 占位）与 bindings[] 静态绑定；New API 实例地址由 newApiBaseURL 配置。
    3. 注册 balance 设置分区（BALANCE_SETTINGS_NS，bindingSchema），监听变更实时 对账用户绑定。
    4. 挂 /_dsh/balance/settings Web 后端（BalanceWebBackend，GET 脱敏快照 / POST 乐观并发保存，webServer 缺席时跳过）。
    • 所有注册都是本 fiber 的 effect，卸载级联撤回。
  • 浏览器半 src/client/index.ts：inject = ['remote', 'slots', 'sessions', 'locale'] （不含 remote.balance——由本插件自己 $mount 提供；cordis 会把 声明式 inject 沿 fiber 父链解析，而 $mount 的贡献在旁支 fiber，声明反而会卡死插件， 所以挂载后经 ctx.get('remote.balance') 按 store 直读，不经属性解析）：
    • await ctx.remote.$mount(TYPERT_REMOTE) 先挂 Remote，再注册：
    • shell.overlay，id balance，order 100 → BalanceWidget；store = createBalanceViewStore；locale NS = balance；inject = { hooks: { balance: BalanceController }, refresh }。
    • widgets.config，id balance，order 0 → BalanceSettings（供应商配置面板， 注册进小组件管理声明的 widgets.config 子槽；管理器缺席时自动跳过）。
    • BalanceController：以 ctx.get('remote.balance') 为源，跟随当前会话 + 模型， REFRESH_INTERVAL_MS = 30_000 固定轮询，暴露 refresh()。
    • 当前模型的来源：ctx.modelDirectories（ui-model-selection 的 directoryFor(sessionId).store，即 composer /model 座位显示的同一份状态）。 该服务不属于本插件的声明依赖：不在 dsh.client.inject，也不在 peerDependencies，因为它只在 web app bundle 里随 ui-model-selection 出现。 因此 controller 收的是延迟查找函数（ModelDirectoriesProvider）， 每次绑定 / 对账重新 ctx.get：服务当时缺席、或会话作用域稍后才铸造，都会在 下一次绑定或轮询（≤30s）自愈，而不会把「未选择模型」永久钉在面板上。
    • 视觉：看板面板 / 收起胶囊 / 多账户悬停提示用液态玻璃材质——与 彩虹流光输入框同一配方（165° 半透明白渐变 + blur(5px) saturate(1.35) 磨砂 + 1px 边缘反光 + 柔和投影，--bal-glass-* token 主题感知， prefers-color-scheme: light 换浅色玻璃）。
    • 字典 NS balance（zh / en），经 LocaleNamespaceMap 类型合并声明。
  • 厂商 Provider（src/providers.ts，均继承 BalanceProvider，凭据值不进日志/报错）：
Provider 类厂商端点默认提供商路由默认凭据引用币种
DeepSeekBalanceProviderdeepseekGET https://api.deepseek.com/user/balancedeepseek-officialDEEPSEEK_API_KEYCNY
MoonshotBalanceProvidermoonshotGET https://api.moonshot.cn/v1/users/me/balancemoonshotMOONSHOT_API_KEYCNY
OpenRouterBalanceProvideropenrouterGET https://openrouter.ai/api/v1/creditsopenrouterOPENROUTER_API_KEYUSD
SiliconFlowBalanceProvidersiliconflowGET https://api.siliconflow.cn/v1/user/infosiliconflowSILICONFLOW_API_KEYCNY
NewApiBalanceProvidernew-apiGET {baseURL}/api/user/self（quota ÷ 500000 = USD）new-apiNEW_API_KEYUSD

不支持厂商占位：UnsupportedBalanceProvider ×5（UNSUPPORTED_VENDORS）—— openai / anthropic / google（含 gemini）/ xai / mistral，查询直接拒绝， 看板显示「无公开余额接口」而非「未绑定」。

  • 配置（Config）：requestTimeoutMs（默认 10000）、newApiBaseURL（默认 http://localhost:3000）、bindings[]（provider + vendor + credentialRef 或 credential + 可选 baseURL）。
  • 设置区（src/settings.ts）：BALANCE_SETTINGS_NS = 'balance'（纯字面量，经 SettingsNamespaceInput 校验；@deepseek-ai/dsh-settings 仅 type-only import 拉入 ctx.settings 类型合并）；BalanceSettingsSchema = { bindings[] }；bindingSchema （credential 带 secret role、credentialRef 带 credential-ref role）。
  • Web 后端（src/web.ts）：SETTINGS_ROUTE = '/_dsh/balance/settings'（webServer 精确路由）——GET 返回脱敏快照，POST save（expectedRevision 乐观并发，留空 凭据 = 保留原值）。
  • src/invariant.ts：包级 invariant 伴侣（./invariant 子路径，可选，bundle 不挂载）。
  • 类型面：BalanceProvider、BalanceRuntime、BalanceProviderInfo、 BalanceAccountData、BalanceAccount、BalanceQueryResult、BalanceListResult、 BalanceBindingConfig（./types）、client 面 BalanceController、BalancePhase、 BalanceRemote、BalanceViewState、BalanceWidgetProps、BalanceInject、 BalanceSettingsInjected、BalanceKey、createBalanceViewStore、ModelDirectoriesLike、 ModelDirectoriesProvider（./client 类型面）。
  • 依赖：zod、@deepseek-ai/schemastery、@deepseek-ai/dsh-settings（deps）； @deepseek-ai/cordis、dsh-credentials、dsh-invariants、dsh-typert-protocol、 dsh-api-remotes、dsh-api-session-controller、dsh-client-store、 dsh-client-ui-renderer、dsh-client-locale、dsh-client-ui-layout、 dsh-client-ui-slots、@dsh-plugins/client-ui-widget-manager（type-only，peer）、 react（peer）。
  • 构建：Host → lib/index.js（ESM，外部化，esbuild）；Client → lib/client.js （ModuleLoader CJS + 内联 CSS，Vite library mode，与官方 deepseek-harness 的 Web 工具链一致）。lib/types/** 由 pnpm build 的 tsc 步骤重新生成（tsconfig.build.json，改写 .ts 相对 引用为 .js）；lib/typert.* 为 typert codegen 产物，已提交进 git （仓库无 codegen 工具，无法重建），pnpm build 不重建但会校验其存在。

3.2 Token 暴击挂件（client-ui-token-crit）

  • 包：@dsh-plugins/client-ui-token-crit（packages/dsh-client-ui-token-crit），纯 UI。
  • Host 半（src/index.ts）：空 apply（surface 占位）。
  • Client 半（src/client/index.ts）：inject = ['slots']，注册 shell.overlay，id token-crit，order 50 → TokenCritWidget。
  • 数据来源：标准 useSessions 会话投影 tokenUsage（uncachedInput / output / cacheRead / cacheWrite 分桶）——无 Host RPC、无轮询，运行时响应式推送。 投影键的类型来自 @deepseek-ai/dsh-token-meter/client（TokenUsageProjection， 另含同一族的 contextPressure / contextBreakdown）；SessionProjectionMap 是可合并扩展的空接口，必须 type-only import 拥有该键的包才能让 projectionValues.tokenUsage 有类型（这就是本包新增该 peer 的原因，替代了 过去手写的影子接口 + as 断言）。挂件与卡片的 props 分别按 PropsRuntime<'shell.overlay'> / PropsRuntime<'widgets.card'> 声明， 选择器按 SessionListState 声明。
  • 动效：滚动数字、浮动 input/output 伤害数字、粒子、连击计数、边缘泛光、可选音效； hover 显示设置面板（语言、数字格式/字号、标签、连击、粒子、暴击阈值/比例、音效、泛光）； 位置与缩放写入 localStorage。
  • 依赖：@dsh-plugins/client-ui-card-container（type-only，peer）；@deepseek-ai/cordis、 dsh-client-ui-renderer、dsh-client-ui-layout、dsh-client-ui-slots、 dsh-api-session-controller、dsh-client-ui-session、dsh-token-meter （type-only：投影键与 TokenUsageProjection 的类型来源，不在 dsh.client.inject 里——读的是 Host 推送的投影值，不需要该模块先加载）、react（peer）。

3.3 卡片容器（client-ui-card-container）

  • 包：@dsh-plugins/client-ui-card-container（packages/dsh-client-ui-card-container），纯 UI。
  • Host 半（src/index.ts）：空 apply（surface 占位）。
  • Client 半（src/client/index.ts）：inject = ['slots', 'locale']，注册 shell.overlay，id card-container，order 20 → CardContainerWidget， 并在同一注册中声明 widgets.card 子槽（list，条目 id = 挂件 id， 容器是唯一渲染方）；再注册 widgets.config，id card-container → 配置面板。
  • 停靠机制（controller.ts，CardContainerController，经 inject hooks 暴露 useContainer）：停靠一个挂件 = 向 shell.overlay 注册同 id、priority: -2 的影子条目（list 槽最低优先级胜出；-2 避开 widget-manager 的 -1，同 id 同 priority 会抛错）→ 挂件浮窗停止渲染但插件仍存活；网格用 renderSlot('widgets.card', {}, { only: id, fallback }) 渲染紧凑卡片。 点 × 移出 = dispose 影子，浮窗恢复。停靠顺序持久化到 localStorage （dsh-plugins.card-container.docked）；订阅 shell.overlay 台账，挂件卸载 时自动移除停靠与影子（自我修复）；容器自身被隐藏时释放全部停靠影子 （挂件恢复浮动），重新启用按持久化顺序恢复。
  • 托盘：entriesOfSlot('shell.overlay') 投影当前 enabled（priority ≥ 0、 非自身、未停靠）的挂件为可停靠 chip；名称经内置映射 widgetName 解析（未知 id 回退为原始 id）；chip 可 HTML5 拖拽进网格（text/plain id），也可点击停靠。
  • 网格：CSS grid，gap 12px（间隔一致），列数 auto（auto-fill minmax(170px,1fr)）/ 2 / 3 / 4（设置持久化，配置变更经 window CustomEvent dsh.card-container.settings-changed 通知）；卡片可拖拽排序（move(from,to)）。
  • 卡片视图：widgets.card 为标准、可选的适配器契约（见 WIDGET-DEVELOPMENT.md §2.5）——token-crit、session-monitor、balance 各自在所属包的 client 里注册自己的紧凑卡（priority 0：标准 useSessions 或余额控制器读数据）；容器本包无内置卡片；无卡片视图的挂件 走 renderSlot 的 fallback（通用占位卡）。
  • 面板位置持久化（dsh-plugins.card-container.pos，默认左上 16/96），头部拖动、 「—」收起为胶囊（显示停靠数）、tap 展开（照抄 session-monitor 的拖拽/夹紧模式）。
  • 视觉：面板表面（悬停时）/ 停靠卡片 / 收起胶囊 / 分组管理菜单 / 拖拽幽灵 用液态玻璃材质——与彩虹流光输入框同一配方（165° 半透明白渐变 + blur(5px) saturate(1.35) 磨砂 + 1px 边缘反光 + 柔和投影，--cc-glass-* token 主题感知，prefers-color-scheme: light 换浅色玻璃）。
  • 字典 NS card-container（zh / en），经 LocaleNamespaceMap 类型合并声明。
  • 依赖：@dsh-plugins/client-ui-widget-manager（type-only，peer）；@deepseek-ai/cordis、 dsh-client-ui-renderer、dsh-client-ui-layout、dsh-client-ui-slots、 dsh-client-locale、react（peer）。
  • 构建：Host → lib/index.js（ESM，外部化，空 apply）；Client → lib/client.js （ModuleLoader CJS + 内联 CSS，Vite library mode）。

3.4 安装 bundle（dsh-widgets-plugin）

  • 包：@dsh-plugins/dsh-widgets-plugin（bundles/dsh-widgets-plugin）。
  • dsh.bundle.patch = ./cordis.patch.yml；依赖 6 个 workspace:* 包。
  • cordis.patch.yml 插入顺序：balance（requestTimeoutMs / newApiBaseURL / bindings）→ ui-token-crit → ui-session-monitor → ui-card-container → ui-rainbow-flow → ui-widget-manager。

3.5 小组件管理页（client-ui-widget-manager）

  • 包：@dsh-plugins/client-ui-widget-manager（packages/dsh-client-ui-widget-manager），纯 UI。
  • Host 半（src/index.ts）：空 apply（surface 占位）。
  • Client 半（src/client/index.ts）：inject = ['slots', 'locale']，注册 settings.section，id widgets，order 10 → WidgetManagerSettings（「小组件管理」页）， 并在同一注册中声明 widgets.config 子槽（list，条目 id = 挂件 id）。
  • 列表数据：WidgetManagerController 订阅 shell.overlay 与 widgets.config 台账 （ctx.slots.subscribe + entries），结合内置目录（widgets.ts：balance / token-crit / session-monitor / card-container / rainbow-flow）投影每行的 「已启用 / 已关闭 / 未安装」状态；hasConfig 由 widgets.config 的实时注册推导。目录中余额看板的 packageName 是 @dsh-plugins/balance； WidgetDescriptor.installRowId（默认回退到 overlay id）记录 bundle 挂载行 用的行 id（如 ui-token-crit ≠ token-crit），供安装指引弹窗拼挂载片段。 非 overlay 组件支持（WidgetDescriptor.configOnly，如 rainbow-flow—— 它注册 conversation.input.left/widgets.config 而非 shell.overlay）： 此类组件同样提供启用/停用（经 window 事件桥 dsh.rnglow.manager-toggle 控制其自身开关 store，与工具栏圆点双向同步——dsh.rnglow.enabled-change 事件回传状态），以及「配置」按钮；不参与 overlay 影子机制。
  • 安装指引弹窗：目录里存在但未挂载（registered: false）的小组件，行上显示 「安装指引」按钮（原为禁用的「添加」），点击弹出三步指引——dsh plugin --profile <name> add <package> 装包命令、- insert: 挂载行片段（用 installRowId，附「直接写 cordis.yml 去掉包装」的说明）、重启 dsh web 提示； 挂件一旦真正挂载弹窗自动关闭（registered 翻转即关）。
  • 关闭（禁用）机制：向 shell.overlay 注册同 id、priority: -1 的影子条目 （list 槽单元渲染最低优先级胜者，ui-slots 影子机制）——挂件条目仍存活但不渲染； 影子条目打 registrant: "widget-manager" 标记，随插件 fiber 卸载级联清理。
  • 添加（启用）机制：dispose 影子条目，挂件恢复渲染。
  • 配置弹窗：每行在「已启用且有配置面板」时显示配置按钮；点击后用 renderSlot('widgets.config', {}, { only: 挂件id }) 在独立弹窗中渲染挂件自己的 配置组件（如 BalanceSettings）；挂件被关闭时配置按钮随之隐藏。
  • 持久化：禁用 id 列表写 localStorage（dsh-plugins.widget-manager.disabled）， 启动与台账变化时自动对账。
  • 字典 NS widgets（zh / en），经 LocaleNamespaceMap 类型合并声明。

3.6 会话监控看板（client-ui-session-monitor）

  • 包：@dsh-plugins/client-ui-session-monitor（packages/dsh-client-ui-session-monitor）， Host 半 + 浏览器半（双半插件行）。
  • Host 半（src/index.ts）：监听 session/event 过滤 turn/end，TurnEndStore 维护 per-session 结束原因表（reason.kind：completed / aborted / blocked / error / max-tokens / interrupted，插入序 LRU 上限 100、TTL 5 分钟）， session/disposed 清理；另维护通知 inbox（src/desktop-notifications.ts， NotificationStore：环形缓冲上限 200、已读/已解决 7 天归档，幂等键 (sessionId, kind, round)，持久化到 session-monitor-inbox settings 分区， 1s debounce 落盘 + 停顿时 flush）——事件源：turn/end（reason→kind，round 取 event.data.turn）、approval/asked / approval/decided（resolve）、 session/title（P2 标题变更）、session/created（P2 新会话，子代理跳过）、 子代理最后回合结束（turn 深度归零 → 父会话 subagent 通知）、host 工具调用 检测 question/plan-review（ask_user_question / exit_plan_mode 的 tool/call → tool/result 即等待生命周期，纯桌面可见）+ 网页 relay 幂等备份。
  • sessionMonitorTurnEnd 会话投影（src/turn-end-projection.ts + src/turn-end-types.ts，与上面的内存表并行）：把同一件事实（最新一次 turn/end 的 { reason, at, round }）改成注册进 harness 的 ctx.sessionProjections，于是订阅、按会话水位缓存、持久化检查点 （(sessionId, key, ver, seq, val)，重启后仍在、冷会话也能读）与客户端变更 通知都由框架负责；wire 视图让它随 SessionSummary.projectionValues.sessionMonitorTurnEnd 直达每个浏览器客户端， 网页半因此不必再轮询 status（该路由保留给桌面壳页面，也作为未组合 dsh-session-projection 时的回退）。两处有意的语义差异：round 是日志 累计的 turn/end 次数（不是 Host 启动后从 0 起的计数），且进程没见过的会话 也有值；改状态形状或折叠语义时必须递增 stateVersion。类型面拆到 turn-end-types.ts（只 type-only 引 dsh-session-projection/types），Host 侧 单元才引 zod 与注册表——客户端 bundle 因此不含该模块、也不内联 zod（已验证）。 注册用 ctx.inject(['sessionProjections'], …) 可选挂载，注册随 fiber 卸载撤销。
  • Host 半的路由挂载：经 ctx.inject(['webServer', 'sessions', 'settings']) 可选挂载九条路由（webServer 缺席时跳过；sessions/settings 不注入会抛 "cannot get property without inject"——踩过）：
    • /_dsh/session-monitor/status（GET → { ok, value: { sessions: { id: { reason, at, round } }, tools: { id: { name, at } }, rounds: { id: count } } }）： sessions = turn/end 原因表；tools = 每会话当前正在执行的模型工具（Host 从 tool/call → tool/result 事件折叠，回合结束时清空，取最新打开的调用）； rounds = 每会话累计完成轮次（不 TTL 裁剪，供「第 N 轮」进度文案算进行中 轮次 = count + 1，长回合也准确）；
    • /_dsh/session-monitor/sessions（GET → { ok, value: buildDesktopSnapshot() }）： 桌面快照——src/desktop-snapshot.ts 把实时会话存储折叠成紧凑 JSON 行： sessionId / title / running / blank / updatedAt / lastActive / origin / parentSessionId / pending / subagents（tools / rounds 随快照同车返回， 供桌面挂件的任务进度条使用；goal/change 事件折叠为行级 goal { phase, maxGoalRounds, roundsStarted }，供目标确定进度条）。全部从 ctx.sessions.list() + 事件日志推导，零新增 peer 依赖：running = 最后一个 turn 边界事件 （turn/start 开、turn/end 关）；title = 最后一个 session/title 事件； pending = 最后一条审批审计事件（approval/asked 无配对的 approval/decided，question/plan-review 属客户端瞬时态不入日志故缺席）； subagents = origin==='subagent' && running && parentSessionId===本会话 的 实时计数（与浏览器挂件「子×N」语义一致）；路由带 try/catch，失败回 500 + 错误栈（便于排障）。全部路由均带宽松 CORS（Access-Control-Allow-Origin: * ——桌面壳的 tauri://localhost 启动探测页需要跨源探测）；
    • /_dsh/session-monitor/settings（GET 快照 / POST 替换）：共享设置存储—— src/desktop-settings.ts 用 MONITOR_SETTINGS_NS = 'session-monitor' + MonitorSettingsSchema（镜像客户端 MonitorSettings 全 12 字段，默认值与 网页版 DEFAULT_SETTINGS 一致）注册到 ctx.settings（持久化进 harness settings 文档）。桌面挂件直读直写；网页客户端半镜像同步（见下）。
    • /_dsh/session-monitor/jump（GET / POST）：桌面→网页跳转队列——单槽 { sessionId, at, consumed }、30s TTL；POST {sessionId} 入队、POST {consume:true} 标记已消费、POST {ping:true} Web 端存活心跳（返回 webAlive），GET 返回当前状态。桌面端点行先入队，客户端半消费，桌面端 轮询到 consumed 才不回退浏览器。
    • /_dsh/session-monitor/jump/poll（GET，长轮询）：Web 客户端半把它挂起 直到有跳转（或 25s 超时）——后台标签页的定时器节流不会掐断基于 setInterval 的轮询；有未消费跳转则立即返回，否则 releaseJumpWaiters 在 下一个入队时唤醒。
    • /_dsh/session-monitor/widget（GET → 独立挂件页 HTML）：自包含页面 src/widget-page.html，经 build.mjs 的 esbuild text loader 内联进 Host bundle，无框架无外部资源，配色复刻浏览器挂件。双 Tab 主界面： 「待处理」通知列表（主视图）——2s 轮询 /_dsh/session-monitor/notifications，按级别开关（P0 需要处理： 审批/回答/计划/出错/阻塞/Token 上限；P1 值得看：完成一轮/子代理/中止/中断； P2 信息流默认关）过滤；未读行带 kind 配色 accent 条 + 图标 + P0/P1 标签 + 轮次 + 会话标题 + 相对时间，头部与 Tab 显示未读徽标；行点击/「处理」走 服务端 jump 队列跳转并按 ackOnJump 自动已读，「忽略」单条已读，底部 「全部已读」（POST /notifications/ack），已读/已解决（「已处理」标签）折叠 进「已读 (N)」区；空态「✓ 没有需要处理的事项」；autoAckOnOpen 启动时自动 全部已读。「会话」Tab = 原列表迁入（运行中/空闲/子代理运行中/待审批状态 点、子×N 徽标、相对时间、忙碌豁免的时间窗口过滤（运行中/有子代理/待审批 始终显示，与网页挂件同语义；隐藏数只统计窗口隐藏，busy-only 模式下为 0）、 子代理默认过滤、只显示运行中）， footer 显示「N 运行中 · M 显示」；运行中/子代理执行中的行带任务进度条 （细动画不确定进度条 + 「第 N 轮 · 正在执行 <工具>」/「N 个子代理执行中」， 工具与轮次来自快照同车的 tools / rounds；目标模式的行升级为确定进度条 「目标 第 X/Y 轮」——数据来自行级 goal 字段，暂停/受阻用琥珀/红并常显）； running true→false 边沿检测「完成一轮」toast 不变（按状态配色、共享 notify/sound/notifyMode/autoDismissSec）； 头部可拖拽（Tauri startDragging）、📌 置顶开关（setAlwaysOnTop）、✕ 隐藏 （hide()，托盘「显示挂件」唤回）、⚙ 设置弹窗——共享字段直读直写 Host 设置存储（/_dsh/session-monitor/settings，与网页版实时同步）：完成提醒/ 通知方式/自动消失秒/提示音/只显示运行中/子代理/时间范围/桌面端会话监控（主开关，默认关——打开时经 dsh-smon:// 协议拉起桌面应用：未运行则启动并直接显示窗口、已运行则唤出前台；关闭后本挂件停止一切数据轮询与提醒、盖「已暂停」遮罩，头部与设置仍可用，遮罩上「开启监控」一键恢复，网页侧关闭同样 5s 内生效；网页挂件不受影响）/处理后自动已读/ 打开时自动全部已读；「刷新间隔」与三个级别开关是桌面独有 （dsh.smon.desktop.settings 缓存）；__TAURI__ 缺席时退化为普通浏览器页 （window.open 跳转）。
    • /_dsh/session-monitor/notifications（GET → { ok, value: { seq, unread, notes } }）：通知 inbox 全量快照——记录 { id, sessionId, kind, title, round?, at, ackedAt?, resolved? }（v1 全量 + 客户端签名 diff，不做增量）。
    • /_dsh/session-monitor/notifications/ack（POST { ids } / { sessionId } / { all: true } → { ok, count }）：已读确认，持久化到 inbox 分区。
    • /_dsh/session-monitor/events（POST { sessionId, kind: 'question' | 'plan-review' | 'new-session', state: 'open' | 'closed', title? }）： 网页端 relay（幂等备份）——question/plan-review 已由 host 经工具调用检测 （见上），此端点供网页半在 pendingInteraction 出现/消失边沿冗余上报； host 幂等落库（open 时已有未决记录则 no-op，closed 时 resolve）。
  • Client 半（src/client/index.ts）：inject = ['slots', 'sessions', 'locale']，注册 shell.overlay，id session-monitor，order 90 → SessionMonitorWidget；再注册 widgets.config，id session-monitor，order 0 → SessionSettings（配置弹窗， 管理器缺席时自动跳过）。桌面桥（服务端中转）：① 设置镜像——本地 save （dsh.smon.settings-changed 事件）debounce 300ms POST /_dsh/session-monitor/settings，启动 + 5s 轮询 GET，与 localStorage 有差异才 写入 + 重发事件（网页挂件/配置面板仍只读 localStorage，零改动）； ② jump 消费——1s 轮询 /_dsh/session-monitor/jump，见未消费的 {sessionId, at, consumed:false}（at 大于上次处理）就 ctx.sessions.open + window.focus() + POST {consume:true}，未知会话抛错则不消费（桌面回退）； ③ 启动 URL ?dsh-open=<id> 深链按 0.8s×N 重试选中该会话； ④ interaction relay（幂等备份）——SessionMonitorWidget 在 pendingInteraction （question / plan-review）出现/消失边沿 dispatch dsh.smon.relay window 事件， 本半转发 POST /_dsh/session-monitor/events（open/closed）；host 已能经 ask_user_question / exit_plan_mode 工具调用自行检测这两类 P0（纯桌面可见）， relay 只是冗余兜底（pushInteraction 幂等，不重复入账；approval 由 host 审批 日志直接覆盖，不 relay）。
  • 数据来源：标准 useSessions 全局 prop（SessionListState：ids / byId / current）——无 Host RPC、无轮询，运行时经 host/session-status 帧实时推送 running 状态。
  • 会话列表：过滤 blank（从未开跑的 New Session）行与子代理会话（默认过滤， showSubagents 开关可重新显示）；运行中置顶（呼吸绿点）+ 本轮完成（黄点， 访问后清除）+ 空闲（灰点）排序；每行显示 displayTitle、子代理（仅开启时）/ 当前徽标、等待输入状态（plan-review 单独显示紫色「等待计划评审」，与 question/approval 的通用「等待输入」区分）、相对更新时间；主代理行带**「子×N」徽标**（聚合 origin==='subagent' && running && parentId 的实时计数，N=0 不显示）。
  • 时间窗口过滤：timeWindowMin（默认 60，0=全部）只保留窗口内活跃过的会话； 运行中会话始终显示（updatedAt 只反映创建/最近 prompt，不能据此隐藏正在 工作的长任务）；"最近活跃"取 max(updatedAt, lastActive)——挂件在观察到会话 开始/结束一轮时把时间戳写入 dsh.smon.lastActive（localStorage，25h TTL 裁剪）， 刷新后仍生效；被窗口隐藏的会话数在列表底部淡色提示（hiddenRecent）。过滤与 相对时间由 30s 的 now tick 驱动重算（useSessions 快照只在列表变更时更新， 没有 tick 则超时会话不会随时间被隐藏）。
  • 完成一轮提醒：useEffect 内 diff running true→false 边沿（一次边沿 = 一轮 完成，goal 多轮同样适用）把完成会话放入 pending 队列；3s 轮询 /_dsh/ session-monitor/status（无条件轮询——同一响应同时喂养 turn/end reason 与 进度显示的 tools/rounds，关掉两类通知后进度标签仍刷新）拿到 Host 的 turn/end reason 后由 flushPending 生成 toast（右上堆叠，新的在最上），带「跳转」（ctx.sessions.open(id)，inject 面注入）与「知道了」按钮；Host 缺席（路由 404）或 reason 超时（12s）退回基础 kind。toast 按状态配色（CSS 变量 --toast-accent 驱动左侧色条与标题色）： done（琥珀 ✓ 正常完成）/ interaction（蓝 ✋ 等待输入）/ subagent（紫 ⇄）/ error（红 ✕）/ aborted（灰 ■）/ blocked（橙 ⚠）/ max-tokens（橙 ⇥）/ interrupted（灰 ⏸）； notifyMode: 'auto'（N 秒自动消失，默认 8s，上限 5 条丢最旧）或 'confirm' （需确认才关：同会话新一轮替换旧提醒、未确认不被新提醒挤掉，上限 12 条，超高 滚动）；可选 WebAudio 双音提示音。浏览器通知（browserNotify，默认关）： Notification API 权限 granted 时对每轮完成发系统通知（标题按 kind 区分， tag = dsh-smon:<id> 同会话替换不堆叠，onclick 跳转会话 + focus 窗口）； 权限在配置弹窗勾选时经 requestPermission() 请求，denied 时提示去站点设置。 浏览器通知与挂件 toast 互相独立，且都受子代理/当前会话过滤。
  • 点击跳转：行点击 / toast「跳转」→ ctx.sessions.open(id)，应用立即切会话。
  • 任务进度显示：有任务在执行的会话（running / 有运行中子代理 / 有运行中后台 任务）在行标题下方显示细动画不确定进度条（无百分比信号，扫光动效表示执行中）
    • 一行小字标签：运行中 → 「第 N 轮 · 正在执行 <工具>」（工具名 = Host tools 表随 3s 轮询刷新，取该会话最新打开的 tool/call，tool/result 或回合结束即 清除；轮次 = Host rounds 累计数 + 1，不 TTL 裁剪故长回合准确，Host 缺席退回 挂件自身观测轮次 + 1）；忙碌非运行中 → 「N 个子代理执行中」/「N 个后台任务执行 中」（单个后台任务时显示任务标签如「后台任务 · npm install」）。
  • 任务目标（goal）进度：会话处于目标模式时进度条升级为确定进度—— 读 row.projectionValues.goal（goal 会话投影，随 useSessions 响应式推送， 无 Host RPC；真实类型由 @deepseek-ai/dsh-goal 声明，本包以 loose 形状 读取），roundsStarted / maxGoalRounds 按真实百分比填充（.progressFill， 蓝），标签「目标 第 X/Y 轮」（运行中附工具名「目标 第 X/Y 轮 · 正在执行 <工具>」）；已暂停 / 受阻 的目标改琥珀 / 红色进度条并显示 「目标已暂停 / 目标受阻 · 第 X/Y 轮」，且即使会话不在回合中也显示（值得 一眼看到，不参与忙碌排序）。
  • 未读 inbox 徽标：5s 轮询 /_dsh/session-monitor/notifications，头部与收起胶囊 显示未读数（红色徽标，0 隐藏）；点击 = 处理——跳到最新一条未读会话并 POST /notifications/ack { sessionId } 标记该会话已读（done/title/ new-session 记录不会自动消解，这是网页侧红点消下去的唯一入口；收起胶囊的 徽标同样可点）。记录已读状态经 Host 共享，桌面端已读后网页徽标同步消失。Host 缺席（路由 404）时优雅保持 0。
  • 配置（SessionSettings，读写 localStorage dsh.smon.settings，改后经 window CustomEvent 通知挂件即时生效）：提醒开关、关闭方式、自动消失秒数、提示音、 浏览器通知（含权限状态：已授权 / 被拒 / 待授权）、提醒当前会话开关、 显示子代理开关（默认关）、只显示运行中、时间范围（全部 / 15m / 30m / 1h / 3h / 6h / 24h，默认 1h）、显示完成标记、桌面 inbox 的「处理后自动已读」与 「打开时自动全部已读」；另有重置位置/重置设置。配置依赖提示： 「只显示运行中」开启时时间范围不生效（运行中豁免窗口、空闲被开关藏掉）——配置 面板此时对时间范围做视觉淡化并提示"关掉后立即生效"，值仍可预配置；列表的 「已隐藏 N 个更早的会话」提示只统计时间窗口隐藏数，运行中模式下不显示。
  • 面板位置持久化（dsh.smon.pos），默认右下角（right 16 / bottom 150），拖拽夹紧 视口；缩放持久化（dsh.smon.scale，0.6×–1.6×，拖右下角手柄）；头部「—」收起为 胶囊（显示运行中数量），点胶囊展开（tap 检测，拖动不误触）。
  • 视觉：面板 / 收起胶囊 / 完成提醒条用液态玻璃材质——与彩虹流光输入框 同一配方（165° 半透明白渐变 + blur(5px) saturate(1.35) 磨砂 + 1px 边缘反光 + 柔和投影，--smon-glass-* token 主题感知，prefers-color-scheme: light 换浅色玻璃）。
  • 字典 NS session-monitor（zh / en），经 LocaleNamespaceMap 类型合并声明。
  • 类型面：SessionMonitorWidgetProps、SessionMonitorInject、SessionSettingsInjected、 SessionMonitorKey、MonitorSettings + DEFAULT_SETTINGS / loadSettings / saveSettings（./client 类型面）。
  • 依赖：@dsh-plugins/client-ui-widget-manager（type-only，peer）；zod（deps，投影 状态/线协议 schema）；@deepseek-ai/cordis、 dsh-api-session-controller、dsh-client-ui-renderer、dsh-client-ui-session、 dsh-client-ui-layout、dsh-client-ui-slots、dsh-client-locale、 dsh-session-projection（Host 半投影注册表 + 类型面，peer——可选组合： 缺席时 installTurnEndProjection 不注册，仅保留路由路径）、 dsh-session（Host 半 session/event 类型，peer）、react（peer）。
  • 构建：Host → lib/index.js（ESM，外部化）；Client → lib/client.js （ModuleLoader CJS + 内联 CSS，Vite library mode）。

3.7 彩虹流光（client-ui-rainbow-flow）

  • 包：@dsh-plugins/client-ui-rainbow-flow（packages/dsh-client-ui-rainbow-flow），纯 UI。
  • Host 半（src/index.ts）：空 apply（surface 占位）。
  • Client 半（src/client/index.ts）：inject = ['slots', 'locale']，在 conversation.input.left（ui-conversation 声明的输入框工具行席位， InputZone owner 契约）注册两个条目：
    • id rainbow-flow-glow，order 99 → RainbowFlowGlow：会话运行中时， 输入框卡片四周渲染通透玻璃 + 呼吸彩虹光晕（无边框）—— 整个输入卡变通透玻璃面板（:global([data-composer-card][data-rf-send]) 把产品实心深色背景替换为两段白色玻璃渐变 linear-gradient(165deg, var(--rf-glass-panel-hi)→lo→mid)（淡淡的光穿过玻璃，无人为顶部高光弧）+ isolation: isolate——深色主题下淡白 玻璃让卡片比背景稍亮呈磨砂发白透光，而深灰半透明会与背景融为一体看不出 透明；玻璃材质主题感知：--rf-glass-* token 在 @media (prefers-color- scheme: light) 下切换为高对比浅色玻璃（面板提亮、阴影变深蓝调），按钮图标 同步翻转为深色保证可读；并由卡片 ::before 轻磨砂层（backdrop-filter: blur(5px) saturate(1.35)，position:absolute; inset:0; z-index:-1）轻柔 模糊背后内容——轻模糊让背后内容清晰、强增饱和让背后色彩透出发光 （重 blur 26px 会变成蒙雾墙）；磨砂层放伪元素而非卡片本身，是因为卡片级 backdrop-filter 会成为内部 fixed Tooltip 的 containing block 把气泡打出屏幕，伪元素与内容是 兄弟关系不受影响；卡片 box-shadow = 上下边缘细反光线（inset 0 1px 0 rgba(255,255,255,.40) 顶部亮 + inset 0 -1px 0 rgba(255,255,255,.26) 底部柔）+ 外投影——克制精致、无大片高光弧；关闭开关即移除 data-rf-send 恢复原厂；不支持 backdrop-filter 时仍保留半透明白玻璃）+ 呼吸彩虹光晕（.glow 改为 两层 screen 混合 box-shadow 光晕：暖彩虹层 .glow + 冷蓝紫层 .glowCool，都是16 方向 box-shadow（每方向一个纯彩虹色相、间隔 22.5°： 红→橙→黄→绿→青→蓝→紫→粉，两两之间有中间色；小偏移 7px + 宽 blur 34px 让色相与左右相邻色都重叠成平滑连续彩虹渐变、无分段）+ mix-blend-mode: screen 加色混合——box-shadow 天然在元素外侧（卡片内部完全干净、输入框从不被染色）且跟随 border-radius（光晕沿卡片圆角弯折；mask 挖环做不到——线性渐变 mask 直边会切直角，故弃用）；发光层精确对齐卡片边缘（.glow inset: 5px = flow 外扩量，border-radius: 22px = 卡片圆角 27−5，阴影峰值正好落在 卡片边缘上）；所有阴影 spread 0（正 spread 会在边缘切出 全强度核心 = 可见的「内部轮廓」亮线；spread 0 让 blur 承担全部衰减、峰值 在边缘向内外双向渐变）+ 柔和 inset 内发光（读起来像卡片本身发光）； screen 混合让颜色在深色页面上保持亮丽鲜明 （普通混合会塌成暗影）；亮色主题回退 normal 混合 + 低 alpha：rAF 循环 积分呼吸相位（phase += hz·2π·dt），每帧只写两层的 opacity （0.18↔0.38 正弦脉动，纯明暗呼吸、无 scale——避免缩放露出内部轮廓） 一个 合成器友好属性——静态 box-shadow 层只栅格化一次，零重栅格化； 呼吸频率由 token 速率驱动（见下）；另加 CSS hue-rotate 色相缓慢 流动（48s/圈：8 方向位置不变、每个色相漂移成下一个——红→橙→黄→…→粉→红， 几何不动；prefers-reduced-motion 冻结）；心情感知色调 = 双层交叉淡化 （模型思考/工具调用无输出时 mood 因子缓动到 1，opacity 从暖层移到冷层、 输出时回到 0——纯 opacity 动画，无任何重栅格化）； reduced-motion 渲染单帧静态中间呼吸位（matchMedia change 监听恢复/ 停止）+ IntersectionObserver 视口外停 rAF；不支持 mix-blend-mode: screen 的浏览器回退普通混合（变暗但完整，同样不染色输入）； 层是卡片内的绝对定位元素（inset: -5px，containing block = 卡片的 position:relative），自动跟随卡片高度，无需测量；
    • id rainbow-flow-toggle，order 100 → RainbowFlowToggle：工具行左端 液态玻璃质感彩虹小圆点开关（半透明渐变 + blur + 顶部高光；关闭时圆点 变灰），右上角状态点随 useSession((s) => s.running) 变绿；开关状态经模块级 store + useSyncExternalStore 与光环共享，持久化到 localStorage （dsh.rnglow.enabled，默认开）。
    • 另注册 widgets.config，id rainbow-flow，order 0 → RainbowFlowSettings（src/client/SettingsPanel.tsx）：小组件管理页「配置」 弹窗——透明度（40/70/100%）、速度灵敏度（0.5×/1×/1.5×）、思考 冷色调开关、命令按类别上色开关（commandColor，默认开）、最新行动彩虹扫字开关（commandSweep，默认开），外加命令文字颜色（每类命令 shell/read/search/write/ edit/code/web/ask/plan/memory/think/other 一个取色器 + 单行恢复默认；标签 复用 classify.ts 的 CATEGORY_LABELS 双语，按文档语言取；取色即写入 toolColors）（旧的「云缕数量」旋钮随粒子流效果一起移除：光晕是连续的一整 圈，没有缕数可调）；读写 src/client/settings.ts （RainbowFlowSettings + DEFAULT_SETTINGS / DEFAULT_TOOL_COLORS + loadSettings/saveSettings/subscribeSettings/getSettings，uSES store， toolColors 为 Record<ToolCategory,string>，持久化 dsh.rnglow.settings， 含旧 wisps 键的持久化数据被忽略），已挂载的光环实时生效（透明度缩放呼吸 幅度、速度缩放 rateToDuration 映射、冷色调开关控制暖层→冷层交叉淡化）； 命令颜色经 mountToolAccent() 写成 <html> 内联 --rf-tool-* 覆盖样式表 :root 默认，已上色的命令卡实时变色。
    • 另在 conversation.input.right（order 150）注册 id rainbow-flow-send → RainbowFlowSend：发送/停止按钮液态玻璃美化 + 动态效果——主操作按钮 （空闲=发送箭头、运行中=停止方块）是产品自带 chrome 不是插槽，故探针 组件（display:none 零尺寸 span，经 closest('[data-composer-card]') 定位输入卡）把按钮有效状态镜像到卡片 data-rf-send（off/send/stop， 与 InputBar primaryStops = running && subagent===null 同语义；开关关闭 时移除属性 = 原厂外观），纯全局样式表 src/client/SendButton.css （非 CSS module，免哈希）按 [data-composer-card][data-rf-send=…] button[class*="_primary"]:last-of-type:not(:disabled) 选中按钮： 液态玻璃面板——两层背景（白色高光渐变 linear-gradient(150deg, rgba(255,255,255,.22)→.05→.12) 叠加 conic 彩虹 --rf-palette 透出）+ backdrop-filter: blur(8px) saturate(1.3) + 内高光/细玻璃描边/柔和投影 （box-shadow 叠加，不动原 border:none 以免撑大 34px）；send（空闲有 草稿）呼吸光晕（box-shadow 3s 缓动，含内高光保持）；stop（运行中） 彩虹旋转（@property --rf-btn-angle 注册角度插值，3s linear；不支持 @property 时阶梯旋转回退）+ 扩散雷达脉冲环（::before 白色细环 scale 1→1.5 淡出，1.6s）；hover 提亮滤镜；禁用态（空草稿）:not(:disabled) 跳过；prefers-reduced-motion 冻结全部动画。选择器锚定稳定的 [data-composer-card] 属性 + CSS-module _primary 后缀（哈希前缀随 harness 构建变化、本地名不变），harness 升级后仍生效。
    • 会话命令卡按类型上色（src/client/toolAccent.ts + classify.ts + ToolAccent.css，非插槽、纯 DOM 装饰，始终开启）：会话记录里模型每个 工具调用卡片读取其稳定的 data-tool="<工具名>" 属性（harness ToolRow 自带；shell 卡例外——它由专用卡片组件（tool.call.toolview 的 bash 键）渲染，只带 data-variant="bash"、没有 data-tool，故按变体直接归入 shell 类别）→ classifyTool() 按工具名启发式分类（shell/read/search/write/edit/ code/web/ask/plan/memory/other，首条正则命中即定，含 bash/pwsh/read_file/ apply_patch/web_search/ask_user_question 等常见工具名）→ 一个 MutationObserver（childList + attributes[data-tool,data-variant]，仅写 data-rf-tool-cat/title 这两个不被观察的属性，无自触发）把类别写回卡片， 再由 ToolAccent.css 给卡片上色：左侧亮一条对应颜色的边条，相关 文字也按类别上色——标题用主题感知渐变（background-clip: text， --rf-tool-accent → 主题感知亮端，@supports 同时要求 background-clip 与 color-mix，否则标题回退纯类别色）、前导图标类别色（currentColor）、 摘要行用类别色与 --dsw-alias-label-tertiary 的 color-mix 柔和色调 （保持次级可读；_errorSummary 大写成 _Summary 故不误染错误红）； 读/写/编辑类工具的文件路径是 _fileLink 可点击链接（不是 _summary）， 用纯类别色渲染并 text-decoration-color: currentColor 保下划线（不用渐变， 以免 background-clip: text 吃掉下划线）；文字 按 CSS-module 本地名后缀 _title/_leading/_summary/_fileLink 选中 （同发送按钮 _primary 技巧），悬停 native title 显示类别名——不重渲染卡片、不改动 产品 DOM，harness 升级后仍生效；未知工具归入"命令"默认色。observer 除 [data-tool] 外还识出 「Think」思考推理行（data-variant="think"，模型 的 reasoning 块、非工具卡），归类为新增的 think（淡紫 --rf-tool-think #c084fc）并同款上色。全套 12 色一色一家族、明显可区分（暖色系 绿/黄/橙/棕， 冷色系 蓝→青→靛→紫→淡紫 逐一错开，红色专属 ask，仅 other 为灰）；每类颜色可按用户配置自定义（经 settings.ts 的 toolColors → 本模块写成 <html> 内联 --rf-tool-*，覆盖样式表 :root 默认并实时生效，配置面板「命令文字颜色」编辑）；最新行动（命令/思考）被彩虹扫过（正文除外）（会话里最新的一条——命令卡或 data-variant="think" 思考行，setLatest 在 [data-tool] 与 [data-variant="think"] 的并集取最晚标 data-rf-latest——其 _title/_summary/_fileLink 被 ToolAccent.css 的流动彩虹渐变（background-clip: text）扫过每个字符，输出正文不参与；跟随最新行动持续（read/edit 等秒完的命令也亮），直到其后出现正文回复（flow-item 结构精确判定）才熄灭）——纯 CSS、不重渲染 DOM、prefers-reduced-motion 冻结为静态彩虹；受 commandSweep 开关控制（本模块把设置写成 <html> 的 data-rf-sweep='on'|'off' 门控；setLatest 每次从 DOM 确定性重算 [data-tool]/[data-variant="think"] 并集里最晚一行来标 data-rf-latest，并据 flow-item 结构判定其后方是否出现正文回复（无 sticky 状态，无 textContent 误判）——扫字选择器只用并集标出的 data-rf-latest，故独立于 commandColor 上色开关）。命令上色本身受 commandColor 开关控制（关掉时本模块停止打标签并清除已有 data-rf-tool-cat/title，命令卡恢复原厂外观）。
  • 呼吸节奏随 token 速率：光环组件内 500ms 采样 useChat((c) => c.legacy.partial) （流式输出内容）文本长度增量 → 估算每秒输出 token 数（约 2 字符/token，EMA 平滑） → 映射呼吸周期 5s（慢）↔ 1s（快）——静止时是舒缓的深呼吸、峰值输出时是 轻快的急促呼吸；思考/工具调用间隙平滑回落；运动模型抽在纯 模块 src/client/rate.ts（rateToDuration / rateToSpeed / easeSpeed， 无 DOM 依赖，缓动时间常数 SPEED_EASE_TAU 0.8s）。
  • 呼吸平滑过渡：rAF 循环里呼吸频率以指数缓动（easeSpeed， 1 - exp(-dt/τ)，帧率无关——(exp(-dt/τ))^n = exp(-t/τ)）逼近采样目标 并连续积分呼吸相位（phase += hz·2π·dt），呼吸不跳拍；每帧只写两层 光晕的 opacity（合成器友好，静态 box-shadow 层只栅格化一次，零重栅格化；无 scale——缩放会让发光层边缘脱离 未缩放的卡片、峰值时露出内部轮廓）。不再直接改 animation-duration（那样会 重置动画当前时间、呼吸相位跳变）。
  • 性能：循环按可见性门控（effect deps [on, running]，运动状态存 refs）——开关关闭或会话空闲时不调度任何 rAF 回调，空闲输入框零成本； IntersectionObserver 视口外暂停（输入框滚出视口停 rAF，省电）； 零重栅格化——呼吸与心情感知都只写 opacity/transform，静态 box-shadow 层保持已栅格化；开关/回合切换间呼吸相位与频率经 refs 无缝衔接； 光晕是独立层，逐帧写 opacity/transform 不污染底层输入卡片；彩虹配色收敛到 --rf-palette（光晕/开关圆点/按钮共用）。
  • 运动模型冒烟测试：docs/speed-smoke-test.cjs 用 esbuild 打包真实 源码，断言帧率无关（float-exact）/ 单调收敛无过冲 / 边界钳制（5s..1s）； 运行 node packages/dsh-client-ui-rainbow-flow/docs/speed-smoke-test.cjs。 （旧的 docs/particles-smoke-test.cjs 随粒子流效果一起删除——呼吸光晕是 静态 box-shadow 层，没有粒子几何/运动模型可测。）
  • 降级：不支持 mix-blend-mode: screen 的浏览器回退普通混合（变暗但 完整，同样不染色输入）；不支持 backdrop-filter 的浏览器仍保留半透明 白玻璃（磨砂模糊是增强）；prefers-reduced-motion 下 JS 跳过 rAF 循环、 渲染单帧静态中间呼吸位（matchMedia change 监听实时响应系统设置切换）。
  • 依赖：@deepseek-ai/cordis、dsh-client-ui-renderer、 dsh-client-ui-session / dsh-client-ui-chat（useSession / useChat 会话作用域 标准 prop，peer）、dsh-client-ui-conversation（conversation.input.left/.right 类型合并，peer）、dsh-client-ui-slots、react（peer）。
  • 构建：Host → lib/index.js（ESM，外部化，空 apply）；Client → lib/client.js（ModuleLoader CJS + 内联 CSS，Vite library mode）。

3.8 会话监控桌面悬浮窗壳（desktop/dsh-session-desktop）

  • 不是 npm 发布包：独立 Tauri 2（Rust）应用，位于 desktop/dsh-session-desktop/， 不在 pnpm workspace 内（workspace 只含 packages/*、bundles/*）；仅用 npm 装 @tauri-apps/cli（本地 package-lock.json），产物是 Windows 可执行文件 （src-tauri/target/release/dsh-session-monitor-desktop.exe）。
  • 职责边界：壳只拥有窗口 chrome，不持有任何会话数据/UI 逻辑——
    • 无边框（decorations: false）、透明（transparent: true）、置顶 （alwaysOnTop: true）、无任务栏（skipTaskbar: true）的 320×560 小窗；
    • 启动先加载本地 src-tauri/assets/start.html（frontendDist，tauri://localhost）： 每 2s 跨源探测 http://127.0.0.1:3080/_dsh/session-monitor/sessions （路由带 CORS 才可探测），就绪后跳转挂件页 /_dsh/session-monitor/widget； 连不上 8 次后显示「无法连接 Harness」+ 重试按钮；
    • withGlobalTauri: true + capabilities/default.json（windows: ["main"] + remote.urls: ["http://127.0.0.1:*"]，权限 core:window:allow-start-dragging / allow-set-always-on-top / allow-is-always-on-top / allow-hide / allow-show / allow-set-focus / allow-close / allow-minimize + 无前缀 allow-open-in-browser + core:default）——挂件页经全局 __TAURI__ API 驱动拖拽/置顶/隐藏/打开浏览器；
    • 点击跳转（服务端 jump 队列 + 回退）：桌面与网页跨上下文不共享 localStorage/BroadcastChannel（WebView2 vs 浏览器各是独立存储分区），所以 挂件页行点击先 POST /_dsh/session-monitor/jump {sessionId}（Host 单槽、 30s TTL）——已开着的 Harness 标签页由插件客户端半 1s 轮询取到后 ctx.sessions.open 原位切会话 + window.focus() + POST {consume:true} （不新开窗口）；桌面端 400ms×8 轮询 GET 直到 consumed，否则回退到 自定义命令 open_in_browser（opener crate）打开系统默认浏览器，URL 带 ?dsh-open=<id> 开机深链。ACL 要点（踩过）：Tauri 2 自定义 app 命令在本地 origin（tauri://localhost）默认放行，但从远程 origin （http://127.0.0.1:3080）调用必须过 ACL——build.rs 用 tauri_build::AppManifest::new().commands(&["open_in_browser"]) 自动生成 allow-open-in-browser 权限（产物写 src-tauri/permissions/autogenerated/， 已 gitignore），capability 里以无前缀标识符引用（app ACL 权限不带 key: 前缀）；应用级没有 Builder::on_navigation（那是 plugin::Builder 的 API）， 故用命令而非导航拦截；
    • 托盘（tray-icon feature）：左键单击或菜单「显示挂件」唤回隐藏的窗口， 「退出」结束进程；✕ 只隐藏不退出。菜单第一行是待处理通知计数（灰色 状态行）：挂件页每次 inbox 未读数变化经自定义命令 set_tray_unread 上报， Rust 侧同步更新托盘 tooltip（「会话监控 · N 条待处理」）与该菜单项文本—— 窗口隐藏时也能一眼看到还有几件待处理（命令已加入 build.rs commands(&["open_in_browser", "set_tray_unread"]) 与 capability "allow-set-tray-unread"）。
    • 远程拉起（dsh-smon:// 深链协议）：每次启动（setup）用 reg.exe 在 HKCU 注册 dsh-smon:// URL 协议（URL Protocol 标记 + DefaultIcon + shell/open/command 指向当前 exe 与 %1，幂等、无需安装器、移动/更新 exe 后下次启动自动重注册；注册失败不影响应用本体）；网页配置面板打开「桌面端 会话监控」开关时经隐藏 iframe 导航 dsh-smon://show 交给系统——应用未 运行则由 Windows 启动（std::env::args() 检测到协议参数 → setup 里 show_widget 直接显示窗口，不走「启动即进托盘」），已运行则经 single-instance 插件回调唤出窗口（无需改 webview 导航/ACL）。
  • 构建：desktop/dsh-session-desktop 下 npm i 后 npx tauri build --no-bundle（cargo release + tauri-build 嵌入图标/manifest）； npx tauri icon <png> 从 icon-source.png 再生成全套图标。首编需拉取 crates.io （数百个 crate，10–30 分钟）。运行前提：本机 Harness web 服务 （dsh web，默认 127.0.0.1:3080）+ 会话监控插件 Host 半已挂载。

4. 依赖关系

graph LR
  BUNDLE[@dsh-plugins/dsh-widgets-plugin]
  BALANCE[@dsh-plugins/balance]
  UI_CRIT[@dsh-plugins/client-ui-token-crit]
  UI_SMON[@dsh-plugins/client-ui-session-monitor]
  UI_CARD[@dsh-plugins/client-ui-card-container]
  UI_RF[@dsh-plugins/client-ui-rainbow-flow]
  UI_MANAGER[@dsh-plugins/client-ui-widget-manager]

  BUNDLE --> BALANCE
  BUNDLE --> UI_CRIT
  BUNDLE --> UI_SMON
  BUNDLE --> UI_CARD
  BUNDLE --> UI_RF
  BUNDLE --> UI_MANAGER
  BALANCE -. peer（type-only） .-> UI_MANAGER
  BALANCE -. peer（type-only） .-> UI_CARD
  UI_CRIT -. peer（type-only） .-> UI_CARD
  UI_SMON -. peer（type-only） .-> UI_MANAGER
  UI_SMON -. peer（type-only） .-> UI_CARD
  UI_CARD -. peer（type-only） .-> UI_MANAGER

外部 peer 依赖（Harness 生态，@deepseek-ai/*）：

依赖被谁需要
@deepseek-ai/cordis全部 6 个可运行包
@deepseek-ai/dsh-invariantsbalance（invariant 伴侣）
@deepseek-ai/dsh-credentials / dsh-typert-protocolbalance
@deepseek-ai/dsh-settingsbalance（设置区 + Web 后端）
@deepseek-ai/dsh-api-remotesbalance（client）
@deepseek-ai/dsh-client-ui-renderer全部 6 个客户端包（ctx.slots 的 Context 合并，承接退役的 dsh-client-runtime）
@deepseek-ai/dsh-client-storebalance（defineStore / createSnapshotStore 等 store API）
@deepseek-ai/dsh-token-meterclient-ui-token-crit（type-only：tokenUsage / contextPressure 等投影键与 TokenUsageProjection 的类型来源；读的是 Host 推送的投影值，不需要该模块先加载）
@deepseek-ai/dsh-session-projectionclient-ui-session-monitor（Host 半：ctx.sessionProjections 注册 sessionMonitorTurnEnd 投影单元 + 投影表类型面；可选组合，缺席时该注册跳过）
zodbalance（typert 生成产物）、client-ui-session-monitor（投影 state/wire schema，deps）
@deepseek-ai/dsh-api-session-controllerbalance、client-ui-token-crit、client-ui-session-monitor（ISessions / SessionListState / SessionSummary）
@deepseek-ai/dsh-client-ui-sessionclient-ui-token-crit、client-ui-session-monitor、client-ui-rainbow-flow（会话作用域标准 prop）
@deepseek-ai/dsh-client-ui-chatclient-ui-rainbow-flow（useChat 实时会话快照）
@deepseek-ai/dsh-client-ui-model-selectionbalance（可选：当前模型经 ctx.get('modelDirectories') 延迟读取，不在 inject / peer 里；缺席时看板显示「未选择模型」）
@deepseek-ai/dsh-client-ui-layoutbalance、client-ui-token-crit、client-ui-session-monitor、client-ui-card-container、client-ui-widget-manager（shell.overlay 类型合并）
@deepseek-ai/dsh-client-ui-conversationclient-ui-rainbow-flow（conversation.input.left 类型合并）
@deepseek-ai/dsh-client-localebalance、client-ui-session-monitor、client-ui-card-container、client-ui-widget-manager
@deepseek-ai/dsh-sessionclient-ui-session-monitor（Host 半 session/event 类型）
@deepseek-ai/dsh-client-ui-settingsclient-ui-widget-manager（settings.section）
@deepseek-ai/dsh-client-ui-slotsbalance、client-ui-token-crit、client-ui-session-monitor、client-ui-card-container、client-ui-rainbow-flow、client-ui-widget-manager
reactbalance、client-ui-token-crit、client-ui-session-monitor、client-ui-card-container、client-ui-rainbow-flow、client-ui-widget-manager

5. 构建产物

pnpm build（node scripts/build.mjs）构建，产物全部进 lib/（gitignore，不提交）： Host 半用 esbuild，浏览器半用 Vite library mode（与官方 deepseek-harness 的 Web 工具链一致）：

包Host 产物浏览器产物包装方式
@dsh-plugins/balancelib/index.js（ESM，外部化）lib/client.jsModuleLoader CJS + 内联 CSS（Vite lib mode + CSS Modules）；lib/types/** 由 pnpm build 内嵌的 tsc 步骤从 src 重新生成（js + d.ts + map）；lib/typert.* 为 typert codegen 产物，已提交进 git（仓库内无法重新生成，见 AGENTS.md），pnpm build 不重建
@dsh-plugins/client-ui-token-critlib/index.js（空 apply 壳）lib/client.jsModuleLoader CJS + 内联 CSS
@dsh-plugins/client-ui-session-monitorlib/index.js（Host 半：turn/end 原因跟踪 + 状态/快照/挂件页路由；widget-page.html 经 esbuild text loader 内联）lib/client.jsModuleLoader CJS + 内联 CSS
@dsh-plugins/client-ui-card-containerlib/index.js（空 apply 壳）lib/client.jsModuleLoader CJS + 内联 CSS
@dsh-plugins/client-ui-rainbow-flowlib/index.js（空 apply 壳）lib/client.jsModuleLoader CJS + 内联 CSS
@dsh-plugins/client-ui-widget-managerlib/index.js（ESM，空 apply 壳）lib/client.jsModuleLoader CJS + 内联 CSS
@dsh-plugins/dsh-widgets-plugin—（仅 cordis.patch.yml）——

外部化清单：@deepseek-ai/*、@dsh-plugins/*、zod、react、react/* （client bundle 会内联 zod——ModuleLoader 模块表没有 zod factory，见 scripts/build.mjs 的 EXTERNAL_CLIENT）。

pnpm build 末尾会做 exports 完整性校验：每个 exports 目标文件（default + types 条件） 必须存在，缺失即构建失败（CI 亦如此）——防止「tarball 缺文件但 CI 绿」的静默损坏。

6. 插槽注册汇总

插槽idorder注册方（包）组件
shell.overlaybalance100balanceBalanceWidget
shell.overlaytoken-crit50client-ui-token-critTokenCritWidget
shell.overlaysession-monitor90client-ui-session-monitorSessionMonitorWidget
shell.overlaycard-container20client-ui-card-containerCardContainerWidget（声明子槽 widgets.card）
shell.overlaybalance / token-crit / session-monitorpriority -1（影子）client-ui-widget-managerShadowWidget（禁用时隐藏挂件）
shell.overlay任意已停靠挂件priority -2（影子）client-ui-card-containerShadowWidget（停靠时隐藏浮窗）
settings.sectionwidgets10client-ui-widget-managerWidgetManagerSettings（声明子槽 widgets.config）
widgets.configbalance0balanceBalanceSettings（管理页「配置」弹窗内容）
widgets.configsession-monitor0client-ui-session-monitorSessionSettings（管理页「配置」弹窗内容）
widgets.configcard-container0client-ui-card-containerCardContainerSettings（管理页「配置」弹窗内容）
widgets.configrainbow-flow0client-ui-rainbow-flowRainbowFlowSettings（管理页「配置」弹窗内容）
widgets.cardtoken-crit0client-ui-token-critTokenCritCard（本包自卡，标准 useSessions 读 token 用量）
widgets.cardsession-monitor0client-ui-session-monitorSessionMonitorCard（本包自卡，标准 useSessions 读忙碌会话数）
widgets.cardbalance0balanceBalanceCard（本包自卡，余额控制器 useBalance 读实时余额；槽级注入面 CardSlotInject：useContainer + dock/undock；标准接入规范见 WIDGET-DEVELOPMENT.md §2.5；容器无内置卡片，未注册的挂件走占位卡）
shell.overlaybalance / token-crit / session-monitorlabel thunkbalance / client-ui-token-crit / client-ui-session-monitor各自注册 label（thunk）——卡片容器托盘/卡片头优先读它作为显示名
conversation.input.leftrainbow-flow-glow99client-ui-rainbow-flowRainbowFlowGlow（彩虹流光：呼吸彩虹光晕，明暗脉动节奏随 token 速率）
conversation.input.leftrainbow-flow-toggle100client-ui-rainbow-flowRainbowFlowToggle（开/关开关 + 运行状态点）
conversation.input.rightrainbow-flow-send150client-ui-rainbow-flowRainbowFlowSend（发送/停止按钮液态玻璃美化 + 动态效果，探针把按钮状态镜像到输入卡 data-rf-send）
remotebalance Remote—balance（client 半）balance/query + balance/list
webServer/_dsh/balance/settings—balanceBalanceWebBackend
webServer/_dsh/session-monitor/status—client-ui-session-monitorturn/end 结束原因 + 执行中工具（tools）+ 累计轮次（rounds）（浏览器半 + 桌面挂件轮询）
webServer/_dsh/session-monitor/sessions—client-ui-session-monitor桌面快照 JSON（buildDesktopSnapshot + tools/rounds，桌面挂件轮询）
webServer/_dsh/session-monitor/widget—client-ui-session-monitor独立挂件页 HTML（桌面壳加载；esbuild text loader 内联进 Host bundle）
webServer/_dsh/session-monitor/settings—client-ui-session-monitor共享设置存储（session-monitor settings 命名空间，桌面直读直写 + 网页客户端半镜像）
webServer/_dsh/session-monitor/notifications—client-ui-session-monitor通知 inbox 全量快照（NotificationStore，持久化到 session-monitor-inbox 分区）
webServer/_dsh/session-monitor/notifications/ack—client-ui-session-monitorinbox 已读确认（{ ids } / { sessionId } / { all }）
webServer/_dsh/session-monitor/events—client-ui-session-monitor网页半 interaction relay（question / plan-review open/closed）
webServer/_dsh/session-monitor/jump—client-ui-session-monitor桌面→网页跳转队列（POST 入队/消费/存活心跳，GET 查状态，30s TTL）
webServer/_dsh/session-monitor/jump/poll—client-ui-session-monitor桌面→网页跳转队列长轮询（GET 挂起直到有跳转或 25s 超时，后台标签页轮询不受限）

7. 维护清单

新增组件（按 AGENTS.md 第 4 节与 WIDGET-DEVELOPMENT.md 后）：

  • 在「组件总览」加一行（类型、所属包、呈现位置）
  • 若发布新包：更新「发布包清单」+ 版本号与其余包对齐
  • 若新增插槽注册：更新「插槽注册汇总」（注意 order 冲突）
  • 若新增 Provider：更新 3.1 的厂商表（端点/路由/凭据/币种）
  • 若新增浏览器产物：在 scripts/build.mjs 照抄 client bundle 段落，并更新「构建产物」
  • 若新增带配置的小组件：把配置面板注册进管理器声明的 widgets.config 槽 （ctx.slots.inject('widgets.config', …)，条目 id = 挂件 id），管理页即自动显示 「配置」按钮并在弹窗中渲染
  • 若要在卡片容器里提供自己的紧凑卡片：按 WIDGET-DEVELOPMENT.md §2.5 的 标准适配器规范注册 widgets.card（条目 id = shell.overlay id、priority 默认 0），并在 peerDependencies 加 @dsh-plugins/client-ui-card-container （type-only）；需要占多列时给组件设静态 spec（small/medium/large）； 显示名优先在 shell.overlay 注册 label（thunk）；需要时实现 CardSlotInject（useContainer / undock）；浮窗加「放入容器」按钮可 dispatch dsh.card-container.dock 事件；不注册则容器显示占位卡
  • 若改动 @dsh-plugins/balance 的 Remote 线协议：同步重新生成 lib/typert.* （typert codegen，build.mjs 不重建；仓库内无生成工具，需从上游生成后提交， 见 AGENTS.md 第 3 节）
  • 若重命名/新增余额相关包：同步更新 dsh-client-ui-widget-manager/src/client/widgets.ts 目录里的 packageName
  • 补双语 README + README.i18n.yaml（hash 用 git hash-object 重算）
  • 若改会话监控 Host 半路由/挂件页：改 src/widget-page.html 后 pnpm build 并重启 dsh web；桌面壳行为改动在 desktop/dsh-session-desktop/src-tauri/， 重新 npx tauri build --no-bundle
  • 若改桌面壳与挂件页的通信：同步 capabilities/default.json 权限 （remote.urls 放行 127.0.0.1；新增窗口命令需确认是否要加权限条目）

发布前：

  • pnpm build 让 lib/ 产物跟上（CI 断言 build 后 git 干净）
  • pnpm -r pack 检查 tarball 内容（workspace:* 应被改写为实际版本）
  • 改过 README 则同步双语对 + 更新 README.i18n.yaml
  • 各包版本一致；打 v* tag 触发 publish.yml（需 NPM_TOKEN）

同步（已废弃）：

  • scripts/sync.mjs 已删除，余额源码不再从 deepseek-harness 同步（上游结构已 重构）。上游若有余额改动，需人工搬移并做「三合一」适配（Host apply 合并、client 合并、跨包 import 改相对 import）。

8. 版本与状态

项值
包版本0.1.0（7 包一致）
官方 API 基线@deepseek-ai/* 0.1.5-rc.2（dsh-client-runtime 已退役：ctx.slots 改由 dsh-client-ui-renderer 提供、store API 在 dsh-client-store，见 AGENTS.md「关键现状与坑」）
语言约定根文档中文；包 README 双语对 + README.i18n.yaml hash 凭据
CIinstall → build → pack → git diff 干净（ci.yml）；v* tag 发布（publish.yml）