Workspace Hub
给 DSH 一个顶层工作区中枢：跨工作区总览 + 每个工作区的共享任务板、会话/子会话、开发服务器状态与规则/上下文/技能。DSH（DeepSeek Harness）标准 bundle：Host 服务 + Agent 工具 + Web 面板。
GitHub: tyxt-zvid/dsh-workspace-hub · 完整安装、首次使用与 FAQ 见 GUIDE.md。
市场：ZVID Plugins · 索引：index.json · 在 DSH Plugins → Discover → Add index source 粘贴索引地址，即可搜索并安装 Workspace Hub。
所有工作区首页
「所有工作区」：跨区注意力、正在运行、环境状态与工作区卡片；点卡片进入某个工作区。
界面
| 工作区概览 | 任务 |
|---|
| 工作区概览 | 任务 |
| 注意力队列 → 正在运行 → 环境 | 快速捕获、分组、行内编辑、运行条 |
| 对话 / 子会话 | 工作区设置（亮色） |
|---|
| 对话 | 设置 |
| 子会话行内发消息、中断、关闭/重开 | 规则链 / 上下文 / 技能，独立保存 |
命令面板 ⌘K | 派发 sheet |
|---|
| 命令面板 | 派发 |
| 跨区搜索任务/会话、切换工作区 | 新建对话或已有对话，可附补充说明 |
功能一览
- 概览（工作台首页）：注意力队列（阻塞 / 可能卡住 / 执行结束待确认 / 子会话未读 / 环境异常）+ 正在运行 + 环境状态，一屏回答「现在怎么样」。
- 任务板（工作区共享）：跨会话创建/更新/派发任务；快速捕获、状态筛选与分组、行内编辑/备注、6 秒删除撤销；并发安全（锁 + 每任务 CAS + 租约）；派发可新建会话或交给已有会话。
- 对话：工作区全部主会话 + 子会话树；子会话行内发消息/中断/关闭/重开，显示已关闭与未读。
- 工作区设置：继承规则链 + 可编辑工作区 AGENTS.md、中枢托管 CONTEXT.md、新建 .dsh/skills 技能（独立保存 + 未保存状态）。
- Agent 工具：
workspace_task、subchat，任何会话可用；数据通路新增聚合快照 hub.snapshot。
安装（使用者）
要求：DSH 0.2.1-rc.x（见 engines.dsh）。
方式 0（推荐 · 市场）：
- DSH 打开 Plugins → Discover → Add index source；
- 粘贴市场索引：https://raw.githubusercontent.com/tyxt-zvid/zvid-plugins/main/index.json（市场仓库：tyxt-zvid/zvid-plugins）；
- 在市场下拉选择 ZVID Plugins / ZVID 插件市场，搜索 Workspace Hub，点 Install。
方式 A（Desktop，会话内，离线 tarball）：
plugin_manager({ action: 'install_bundle', target: '/abs/path/dsh-workspace-hub-0.2.1.tgz' })
target 也可为本地目录、git 地址或 npm 包名/版本。
方式 B（CLI）：
dsh plugin --profile desktop add /abs/path/dsh-workspace-hub-0.2.1.tgz
安装后刷新页面；主界面标题栏左侧会出现「中枢」按钮。
打包分发（作者）
npm pack --pack-destination dist # 生成 tarball（按 files 过滤）
# 对方：plugin_manager install_bundle target=/abs/dist/<tarball>.tgz
发布到 npm：把 name 改成自己的 scope、同步 cordis.patch.yml 行名、去掉 "private": true，然后 npm publish --access public。详见 GUIDE.md。
功能细节
1. 同一个工作区，跨会话共享的任务板
- 任务板物理位置：
<workspace>/.dsh/workspace-hub/tasks.json，因此同一工作区目录下打开的任何会话都读写同一块板；DSH 重启、会话冷启动后仍在。
- 任务字段：
id / title / detail / status(todo|doing|blocked|done|cancelled) / priority / revision / assignee / dispatch / notes。
- 并发安全：
- 进程内按板文件串行（一个 FIFO）；
- 跨进程
<file>.lock（PID 所有权、退避、崩溃持有者可接管、超时显式失败，绝不降级为无锁写）；
- 锁内重新读取 + 每任务
revision 的 compare-and-set（expectedRevision）；
- claim 带 15 分钟租约，持有者更新会续租，崩溃会话不会永久占坑；
- 提交采用
temp wx → fsync → rename → fsync 目录，读方无锁且永远看不到半截 JSON；
- 损坏的板不会被覆盖：读取/写入都显式报错。
- 派发（dispatch）：把任务交给一个对话执行。
- 不传
sessionId：在当前工作区新建一个会话并发送任务提示词；
- 传
sessionId：把任务提示词投递给该会话（冷会话会被自动 resume，然后运行一个新 turn）。
- 派发前先写入
dispatch.requestId（write-ahead），重试幂等；失败会回滚任务归属并记录原因。
- 任务所有权：
claim 表示"本会话自己干"，dispatch 表示"交给别的会话干"；两者都会把任务置为 doing 并记录会话。
2. 单会话内的 sub chat（生命周期由主对话管理）
- 每个 sub chat 是一个独立的持续对话（真实 child session），有自己的上下文与 turn，settle 之后仍可继续发消息。
- 生命周期：
- 主对话 turn 结束：sub chat 不受影响；
- 主对话 Agent 被销毁 / 插件卸载：宿主侧确定性地 drain 该主对话名下的 resident sub chats（
agent.ctx.effect 在 parent 仍注册时执行，因此授权有效）；
- 主会话归档：框架自身的 archive admission 会级联停止其活动；
- Host 重启：sub chat 列表来自 parent 的 durable catalog，可冷读；面板可继续列出，发送时会冷 resume；
- 显式
close：drain resident child + 持久化 closed 标记（可 reopen）。
- Agent 侧工具可以
list / create / send / interrupt / close / reopen；面板同样通过 Host 服务调用。
- 子会话的回复以
subagent-settled 通知形式回到主对话（框架行为），面板 list 也会展示每个 sub chat 的最新回复。
- 只有主对话（depth 0、非 subagent origin）可以创建/管理 sub chat；子会话自身不能继续嵌套创建。
模型侧工具
| 工具 | 用途 |
|---|
workspace_task | list / get / create / update / claim / release / dispatch / delete；跨会话任务板。 |
subchat | list / create / send / interrupt / close / reopen；当前对话的 sub chat。 |
dev_server | start / status / stop；按工作区的 servers.json 起停开发服务器。 |
工具对全部 Agent 全局注册（root 级），随插件卸载而消失。
工作区中枢（顶层功能，跨工作区）
中枢是 DSH 的顶层场所，不是某个工作区的附属面板，也不创建任何会话、不能像对话一样被删除。
信息架构
侧边栏常驻入口 → 所有工作区首页 → 工作区 Console；All 用 hub.overview，下钻用 hub.snapshot。
- 入口：侧边栏常驻「工作区中枢」（
sidebar.panellist，与日程等平级）；标题栏「中枢 / Hub」按钮是快捷方式——打开中枢并定位到当前会话所属工作区。
- 全局只有一个面板（
main key workspace-hub），首页是「所有工作区」：跨区注意力队列、正在运行、工作区卡片与全局状态条；点卡片或注意力项进入该工作区的 Console。
- 工作区是中枢内部的一个维度：任务板、会话、环境、规则仍按工作区隔离存储；中枢只提供统一入口与跨区聚合，不改变并发/租约/CAS 语义。
- 面包屑「所有工作区 / 名称」可返回 All；工作区视图头部可切换工作区；选中工作区、All 筛选与滚动状态全局持久化。
- 旧版本曾为每个工作区创建「工作区中枢」会话；升级后 Host 会自动把这些会话归档、删除
hub.json 映射（一次性迁移），中枢不再占用会话行。
Web 面板（Console）
中枢是一个全局面板：默认进入「所有工作区」总览，选中工作区后进入该工作区的 Console（头部 + 状态条 + 三个主视图 + 设置），不是四个并列标签页：
- 所有工作区：全局状态条（工作区/进行中/待办/阻塞/环境）、跨区「需要你处理」与「正在运行」、工作区卡片网格（任务计数/会话/环境/更新时间）；点卡片 drill-in。
- 概览：需要你处理（每条带可解释原因与一个主操作）→ 正在运行（任务 + 执行会话 + 最近活动）→ 环境（逐台服务器启动/停止/打开）。空态有下一步行动，加载用骨架，同步中断保留旧数据并提示。
- 任务：快速捕获（
Enter 创建、Tab 展开详情）、状态筛选/分组/搜索、行内展开编辑标题/详情/优先级与追加备注、查看运行条、派发 sheet（新建对话或已有对话，可附补充说明）、删除 6 秒撤销。已取消任务可筛选；已完成默认折叠。
- 对话：工作区全部主会话 + 子会话树；子会话行内发消息、中断、关闭/重开；「显示已关闭」开关、未读徽标；可把任意会话设为新建子会话的父会话。
- 工作区设置（头部 ⚙）：规则链（继承顺序、来源、字节数、是否可编辑）、CONTEXT.md、技能列表/新建；每个表单独立保存、显示未保存状态，
⌘S 保存。
- 命令面板
⌘K：新建任务/子会话、启动服务器、打开设置、刷新、所有工作区/切换工作区，以及任务/会话模糊搜索（All 视图下跨区列出，执行时自动定位工作区）。
- 键盘（仅面板内）：
⌘K 命令面板 · n 捕获 · / 搜索 · j/k 行焦点 · ↵ 展开 · x 完成 · e 编辑 · d 派发 · g o/t/c 切换视图 · Esc 关闭浮层。
- 数据通路：同源认证 JSON 路由
POST /workspace-hub/api/<method>，先过 ctx.connection.requestRejection(req)（Host/Origin 防篡改 + 浏览器签名 Cookie 认证），失败即拒绝。All 视图用 hub.overview（一次返回全部工作区的任务板/会话计数/服务器 cheap summary），进入工作区后用 hub.snapshot（含真实服务器探测）；4 秒轮询、页面隐藏暂停、失败指数退避。hub.snapshot 不可用时自动回退到旧的 context + tasks.list + hub.sessions 三连。
- 写操作是行级乐观更新：只锁当前行，失败按行回滚；CAS 冲突就地提示并给出「采用最新/重试」；不再整页禁用、不再使用
window.confirm。
- 面板只依赖 React 与主题 token（
--dsw-alias-*），不 import 任何 Harness Client 包；视觉使用 6 档字号、发丝线、单一主色，暗/亮主题自动成立。
工作区开发服务器（界面状态 + 工具）
Web 游戏一类的工作区需要先起本地服务器才能看页面。中枢把这个状态直接放到界面上，不占用任何快捷键：
- 标题栏状态胶囊：当前工作区声明了服务器时，主界面标题栏（「中枢」按钮旁）出现一个「服务器」胶囊：状态点在全部就绪时为绿色、有进程在运行/启动中为琥珀色、全部停止为灰色、启动失败为红色，右侧数字是
就绪数/总数（如 1/1）。没有配置服务器的工作区不显示。
- 点胶囊打开中枢的面板并展开环境 popover（不再有独立的服务器标签页）。
- 环境区（概览底部 / 状态条「环境 n/n」）：逐条列出声明的实例，显示状态（已就绪 / 启动中 · 已 N 秒 / 已停止 / 外部运行 / 启动失败）、启动命令、工作目录与 URL，并提供 启动 / 停止 / 打开 / 查看日志尾。停止只结束中枢自己拉起的进程，不碰你手动在终端里起的服务；外部实例标注「外部运行」且不提供停止。
- 状态随聚合快照每 4 秒刷新一次，页面隐藏时暂停；启动中是行级 pending，不阻塞其它服务器/任务操作。
- 插件卸载 / 禁用时，中枢会结束自己启动的全部进程，不会留下占端口的孤儿。
自动识别（默认，无需配置文件）：工作区没有 servers.json 时，中枢会从项目文件推断服务器——界面上标「自动识别」，写配置即覆盖：
- 依次检查
dev / develop / play / serve / start / preview 等 package.json 脚本，跳过 build/test/electron 之类任务；
- 端口来源：脚本参数（
--port、-p、PORT=、文件名后的端口）、vite.config.* 里的 port、被 node 执行的服务器文件里的 DEFAULT_PORT = N / process.env.PORT || N / listen(N)，最后用框架默认端口（Vite 5173、Next/Nuxt 3000、Angular 4200、Astro 4321、webpack-dev-server 8080…）；
- 健康检查：服务器文件里出现
/api/health 或 /health 就用它，否则用 /；
dev 之外若有 server / api / backend 脚本，会识别为第二个实例；- 包管理器按
packageManager 字段或 lockfile 选择 npm / pnpm / yarn / bun；
- 没有
package.json 时，只接受根目录唯一的 serve.mjs / server.mjs（且真的调用 listen）。
不想要自动识别时，写 {"version": 1, "servers": []} 显式关闭；想自定义命令/端口/多实例时写完整配置（显式配置永远优先）。monorepo 子包、脚本里算出来的端口这些推断不到的，也直接写配置。
声明文件：<workspace>/.dsh/workspace-hub/servers.json（工作区本地、可随仓库备份）。
{
"version": 1,
"servers": [
{
"name": "请神 · Layer 1",
"command": "node layer1/server.mjs",
"cwd": ".",
"url": "http://127.0.0.1:4180/",
"health": "http://127.0.0.1:4180/api/health",
"readyTimeoutMs": 20000
}
]
}
| 字段 | 必填 | 说明 |
|---|
name | 否 | 服务器名（默认 server-N），dev_server 的 names 用它选择 |
command | 二选一 | shell 风格命令行（支持单/双引号）；跨平台项目建议用 argv |
argv | 二选一 | 参数数组，例如 ["node", "layer1/server.mjs"] |
cwd | 否 | 相对工作区根目录，默认 .；不允许逃出工作区 |
url | 否 | 启动成功后要打开的地址；也作为默认健康检查地址 |
health | 否 | 就绪探测地址（HTTP 2xx 视为就绪）；默认取 url |
readyTimeoutMs | 否 | 等待就绪的上限，默认 20000，限制在 1–120 秒 |
url / health 只接受 http(s)。进程通过 Host 的 subprocess 服务启动：command 的第一个词按宿主 PATH 解析（macOS Desktop 的 PATH 含 nvm/homebrew），stdout/stderr 各保留 64KB 供失败时回显；判定失败时返回退出码与输出尾部。
在其他工作区启用
插件和界面是 profile 级的（装一次、所有工作区共享）。大多数情况什么都不用做：打开该工作区的会话，「中枢」旁会自动出现「服务器」胶囊——中枢已从 package.json 自动识别出 dev/start 脚本、端口和健康检查（标「自动识别」）。
只有自动识别不准或需要多实例时，才在该工作区根目录写 .dsh/workspace-hub/servers.json 覆盖（显式配置优先；写空 servers 数组可关闭识别）。
常用配置写法：
| 项目类型 | command | url / health |
|---|
极简静态服（如 serve.mjs） | node serve.mjs | http://127.0.0.1:4173/ + /health |
| Vite / Next / webpack dev | npm run dev | 首页（Vite 对 / 返回 200 即可），readyTimeoutMs 给 30000 |
| 前后端两个进程 | servers 数组写两条 | 各自 URL，可单独启停 |
| 需要固定端口/环境变量 | 在项目里加 npm script（如 "dev:local": "HOST=127.0.0.1 vite --port 5179"），command 调它 | 当前配置格式不直接支持 env |
注意：每个工作区各用各的端口，避免多个工作区同时运行时撞端口。
本机 games/vw-flower（4173）与 games/tyler-diver（Vite 5179）已删除示例配置，现在完全依赖自动识别——打开这两个工作区仍会看到同样的「自动识别」实例。
同一个操作也暴露为模型工具，Agent 在需要起服务器看页面时可以直接调用：
| 工具 | 用途 |
|---|
dev_server | start / status / stop，可选 names；与服务器页签走同一条 Host 实现 |
安装
plugin_manager({ action: 'install_bundle', target: '/absolute/path/to/this/directory' })
bundle 的 cordis.patch.yml 插入一行 workspace-hub；Client 侧 dsh.client 在页面加载时注册面板。安装后页面会自动收到模块图更新（首次安装经 HMR 生效）。
验证状态
已在当前 Desktop profile 实测（2026-10-20 / 2026-10-21）：
- 安装：
install_bundle → application: applied，Host 行 include:workspace-hub → fiberPhase: active；workspace_task / subchat 出现在调用方 schema 中。
- 中枢为工作区级功能：不再创建任何会话。
main 槽位为全部 8 个注册工作区各注册一个 workspace-hub:<workspaceId> 面板（occupant 均 active: true），面板固定绑定该工作区。
- 全局入口移除：
sidebar.panellist 中不再有 workspace-hub，也不再有全局 main key；入口是 conversation.header.leading（single，原先为空）上的「中枢」按钮，occupant active: true，无会话时也可见、跟随当前工作区。
- 旧中枢会话迁移：升级后 Host 自动归档旧版本创建的两个「工作区中枢」会话（
workspace.json.archivedSessionIds 已含 session-269c86b6-…、session-eb3ecbb4-…）并删除对应 hub.json；现在 .dsh/workspace-hub/ 只剩 tasks.json / subchats.json，不再有中枢会话行。
- 安全边界：未认证
POST /workspace-hub/api/hub.catalog → 401；伪造 Origin → 403。
- 任务板：
create → list → claim → update(note, done) → delete 全部通过；CAS 冲突、已认领、损坏板保护、并发 claim 单赢家在 node test/core.test.mjs 中覆盖（全通过）；持久文件位于 .dsh/workspace-hub/tasks.json，无 .lock/.tmp 残留。
- 会话枚举兼容性修复：本 profile 的
sessionController.list() 返回 { items: SessionSummary[] } 而不是裸数组；sessionRows() 同时接受数组、{items}、{ok,value} 三种形状，并已加入回归断言。
- 跨会话派发：任务派发到新建会话（
session-5fe3bda9-…），该会话收到提示词后自行 update 任务为 done 并写入 note，证明跨会话读写同一块板。
- 子会话：
create（回复 SUBCHAT_OK）→ list → close → reopen → send（冷恢复后回复 RESUMED）→ close 全部通过；回复以 subagent-settled 通知回到主对话。
- 未验证：面板的像素级视觉表现（本会话无浏览器控制），仅验证了槽位注册与数据通路；面板在亮/暗主题下的实际观感需要在页面上人工确认。
- 开发服务器（2026-10-21）：界面版（无快捷键）。
node test/servers.test.mjs 覆盖配置解析/校验、真实进程启动→就绪→复用→停止→卸载、外部进程识别、可执行文件缺失；node test/client-ui.test.mjs 验证 Client apply 不抛错、header/sidebar/overlay 槽位注册保持、且不再调用快捷键服务或注册快捷键命令。插件重装（remove + install）后：POST /workspace-hub/api/servers.status 未认证返回 401（路由已加载）；dev_server 出现在调用方工具 schema 中（Host 代码已生效）；旧版快捷键 toast 的 shell.overlay occupant 消失（新 Client 代码已生效）。用独立会话实测 Host 路径：dev_server start → ， 返回 ， 确认 node 监听 4180， → ， → ，结束 为 。
如何新建子会话
三种方式，任选其一：
- 侧边栏（推荐）：hover 任意主对话的会话行 → 点尾部的 子会话图标 / “+” 打开浮层 → 点 「新建子会话」 → 填写可选标题与首条消息 → 创建。首条消息会立即投递给子会话并开始它自己的 turn。
- 看板面板：标题栏「中枢」→「子会话」标签页 →「新建子会话」。
- 直接让助手创建：在主对话里说“新建一个子会话，让它……”，助手会调用
subchat 工具的 create 动作。
要求：主对话当前必须是 live（打开该会话即可）；子会话创建后可在侧边栏浮层、看板子会话页里查看最新回复、发送消息、中断或关闭。
侧边栏里的子会话
DSH 的左侧会话列表按设计过滤 origin === "subagent"，且没有“追加子行”的扩展点；因此插件采用官方的增量槽位，把子会话挂在主对话行上：
sidebar.session.row.leading：空闲主对话行的 16px 前导位显示子会话图标（常驻，不必 hover；运行中的行由框架状态点占用该格）。点击同样打开浮层列表。sidebar.workspaces.session.row.action：主对话行 hover 时出现「子会话 N」徽标（只有存在打开的子会话才出现）。- 点击徽标打开
shell.overlay 里的框架级菜单：列出该主对话的打开子会话（运行中/空闲状态点），点击任意一项通过 uiWorkspace.openSession(childId) 直接打开该子会话（自动解析 subagent 地址）。
sidebar.session.row.hover：行 hover 卡片中额外列出前 4 个子会话，便于扫一眼。- 目录数据来自
POST /workspace-hub/api/subchats.catalog（当前工作区的打开子会话，5 秒轮询；关闭的不显示）。
限制：shipped 侧边栏没有可插入的行级列表槽位，因此子会话不是“始终可见的缩进行”，而是主对话行上的入口 + 浮层列表；要变成真正的常驻缩进行只能整体替换 shipped 侧边栏，成本高且易随版本失效，故未采用。
工作区级规则 / 技能 / 上下文
「工作区」页签管理的是工作区本地的能力，绝不写用户全局文件：
| 能力 | 落点 | 生效方式 |
|---|
| 工作区规则 | <workspace>/AGENTS.md（可编辑） | 框架在下一次请求或会话 resume 时重新读取指令链；不是实时 watch |
| 工作区上下文 | <workspace>/.dsh/workspace-hub/CONTEXT.md（中枢托管，可编辑） | 以 agent-scoped system prompt section 注入该工作区会话；保存后活动会话下一轮生效，新会话立即生效 |
| 工作区技能 | <workspace>/.dsh/skills/<name>/SKILL.md（可新建） | 技能 provider watch 目录，下一个模型 step 进入 catalog；名称校验 kebab-case、frontmatter 自动生成 |
页签同时只读展示继承链（用户全局 ~/.dsh/AGENTS.md、~/.agents/AGENTS.md → 项目根 → 当前目录的 AGENTS.md/CLAUDE.md 与 .local 覆盖层）以及会话可见技能目录（来源、模型/用户可调用面、源文件路径）。
边界：全局规则/技能不在中枢编辑；CONTEXT.md 只对工作区目录相同的会话注入（主会话与其子会话）；规则文件保存后若当前会话没有新的文件操作/resume，可能仍使用上一版指令。
子会话 ↔ 主会话的交互语义
子会话是真实 Session（框架层 origin="subagent"、parentSession=主会话、delegationDepth=父+1），不是主会话的子上下文；插件只补“行记录（标题/所属/closed）+ 帮助方法”。
三条消息通道：
- 父 → 子（主动）：
startActivation({delivery:'parent'}) 创建并立即返回 childId，首条 prompt 以 queue 投递给子会话启动第一轮；后续用 subagents.prompt（queue=新一轮 / steer=当前 step 边界）或 interrupt（只停当前 turn，可继续）。
- 子 → 父（显式）：只有 resident continuable child 能发给直接父，落地为一条 user message（
Agent <childId> sent a message: …）；发送不结束子自己的 turn。
- 框架 → 父（自动结算）：每个 activation 在子 idle、无 pending inbox、无未结算后代后结算一次，向父会话追加一条
subagent-settled notice（stopReason 摘要等）。父闲时会唤醒新一轮；通知条数 = activation 数。
隔离与共享：父看不到子的 reasoning/step/tool/token 流，spawn 子看不到父对话；共享 workspace/cwd/权限根/preset（子不能扩权）。读子会话内容只能读子会话日志，或在 UI 中通过 {parentSessionId, childSessionId, mode} 子会话地址打开（本插件已改为显式地址打开）。
生命周期：父 turn 结束 ≠ 子结束；子 idle 后 activation 释放、Session 持久，再发消息即冷恢复；父 Agent 销毁时框架不自动回收 resident 子会话，本插件在 agent.ctx.effect 中 drain；主会话归档会级联停止后代；Host 重启后 catalog 可读、发送时冷恢复。默认 maxDepth=1（子不能再建子）、每 activation 树最多 8 个活跃子。
need-to-know 降噪（默认启用）：主会话的 agent/pre-step 会过滤结算通知——普通完成（stopReason=completed）不再进入主对话、也不会唤醒主对话；失败 / 被中断 / max-tokens / refusal / 异常结束仍会进入主对话（这些才需要主对话处理）。子会话的最新回复可随时用 subchat list 或看板查看。历史已写入日志的通知无法改写，但从此不再增长。
对产品行为的直接含义：面板“发送”只返回 messageId（最新回复靠轮询）；创建/发送要求主会话 live；每条结算通知都是主对话里的真实 user message、会占 context；侧边栏不显示子会话是框架过滤（origin === 'subagent'），所以入口只能挂在主对话行上；close 是 drain + 标记，不是删除。
限制与已知取舍
- 同一工作区文件被多个 Host 进程同时写入时，跨进程锁在本机有效；网络文件系统上的多 Host 并发不受支持（与 DSH 自带 atomic-write 的限制一致）。
- 面板数据是轮询快照（4s），不是推送；一次操作后会立即刷新。
- sub chat 的每一次后续 turn 都会以
subagent-settled 通知主对话（框架无公开开关）；这是"由主对话管理"的代价，也是其可观察性来源。
- sub chat 创建/发送要求主对话 Agent 当前是 live 的（打开该会话即可）；冷父会话需要先打开。
- 面板无法直接打开 child 会话的完整 transcript（DSH 对 subagent 会话使用专用地址），因此面板展示最新回复而非完整对话。
- 不写入 profile，不依赖
@deepseek-ai/* 导入（避免 profile 里可能存在的旧版本 hoist 造成版本错配）。
- 中枢会话是真实普通会话：会占用一个会话行、可在侧边栏重命名/归档；插件不会删除它。已有但从未使用过的工作区不会在安装时被批量创建中枢，首次打开该工作区时才创建。
- 若中枢会话被手工删除，映射仍保留；可通过
POST /workspace-hub/api/hub.ensure（{workspaceId}）重建，或删除对应 hub.json 等待下一次 reconcile。
布局
| 文件 | 作用 |
|---|
index.js | Host 插件入口：注册工具、父会话生命周期钩子、Web 桥。 |
lib/store.js | 任务板持久化：FIFO、跨进程锁、fsync 原子替换、解析校验。 |
lib/tasks.js | 纯任务操作（CAS/租约/派发 write-ahead）。 |
lib/hub.js | 工作区解析、任务服务、会话枚举与派发。 |
lib/subchats.js | sub chat 服务：创建/列表/发送/中断/关闭/重开与父会话清理。 |
lib/hubs.js | 每工作区中枢会话的自动创建、目录与映射（hub.json）。 |
lib/tools.js | workspace_task 与 subchat 工具 schema 与执行。 |
lib/bridge.js | 同源认证 JSON 路由。 |
client.js | 按工作区注册的看板面板、中枢会话入口与子会话侧边栏项。 |
locale/*.json | 插件显示元数据。 |
