workspace.json 怎样把工作区和会话连起来？

公开图保留字段名和行号，已遮住真实标识。可以先数条目，再对照下文的虚构 JSON 看同一个 ID 怎样连接两处。

1. 先看 global.workspaceIds。截图列出 3 个工作区 ID，它们在数组中的位置决定项目的显示顺序。
2. 再看 tables.workspaces。截图里展开的那条记录以第三个工作区 ID 为键。用这个 ID 对上记录，就能看到它的目录路径和显示标题。表中先写哪条记录不决定左栏顺序。
3. 展开这条记录的 sessionIds。图中从第 22 行到第 36 行，共有 15 个会话 ID。这是一个工作区的归属记录；另外两个工作区要各自按 ID 查找。
4. 回到 global。归档和置顶两个数组均为 []，表示当时这份索引没有标记任何归档或置顶会话。它们和工作区里已经列出的 15 个会话可以同时成立。

实机截图点击图片放大 ⤢

123

部分记录还会有 defaultWorkspaceId，用于识别首次使用时建立的默认项目。pendingMutation 是一次工作区创建或移除尚待完成的内部标记，交由程序在启动时处理。

下方是完整的小例子，可以直接按字段看，无需在电脑上创建文件。周五读书会指向 D:\HarnessDemo\Reading，在这个工作区下显示两场聊天，第二场排在第一场之前。

{
  "unit": { "name": "workspace", "version": 2 },
  "global": {
    "initialized": true,
    "workspaceIds": ["00000000-0000-4000-8000-000000000001"],
    "archivedSessionIds": [],
    "pinnedSessionIds": []
  },
  "tables": { "workspaces": {
    "00000000-0000-4000-8000-000000000001": {
      "path": "D:\\HarnessDemo\\Reading",
      "title": "周五读书会",
      "sessionIds": ["session-demo-two", "session-demo-one"],
      "createdAt": "2026-10-01T01:00:00.000Z",
      "updatedAt": "2026-10-02T08:30:00.000Z"
    }
  } }
}

新登记项目时，createdAt 和 updatedAt 初始相同。若这条记录来自首次整理旧会话，RC5 会取该目录下最新一个已有会话的创建时间来建立记录。用这个日期推算软件安装时间或项目文件夹的生日，可能得到错误结论。

记录着 path，只表明工作区和目录有关联。移动磁盘、移除映射盘后，某些原有归属仍会保留。想确认文件是否存在，就在运行 Harness 的那台机器上用自己的账户打开实际目录。

能否改文件还取决于具体工具、当前沙箱策略和操作系统权限。改 title 只会改显示名称。在索引中登记一个路径，也不会给账号新增磁盘访问权或批准越界写入。

我们在 Linux 临时目录中，用发布的 RC5 工作区、会话与持久化服务登记了一个虚构项目，再依次挂入两个空会话。文件上的顺序为第二个、第一个。给第一个会话置顶再归档后，置顶被清除，归档清单多出一项，两个 ID 的项目内顺序保持原样。只有全局状态改变，这次 workspace 行的 updatedAt 没动。

随后取消归档并移除工作区登记。原目录里的 meeting.txt 内容仍在，持久化服务还列得出两份会话日志。此验证没有登录账号、调用模型或操作 Windows 桌面。

如果只想跟着教学看，用文件管理器打开目录即可。已安装 Node.js 的读者，也可以解压本站的演示素材，在 harness-lab/config-check 目录打开终端。下面两行分开运行，第一行只读随包虚构样本。

样本应显示工作区顺序列表和记录表各有 2 项。样本桌面配置有补丁文件，Web 配置没有。第二行才检查本机当前终端的 DSH_HOME 或默认主目录，不输出项目名称、绝对路径、会话 ID 或正文。

看到“未找到”时，先核对当前操作系统用户、实际数据根和存储实现。要确认插件能用，还要回到对应工作台验证。

node inspect-dsh.mjs --demo
node inspect-dsh.mjs --local