Runtime Map

把 DeepSeek Harness、Codex / 本地 Work、ChatGPT 和 WorkBuddy 的会话入口放在同一张关系地图里。目录跟随原生应用，画布由你组织，状态只显示有依据的观察结果。

当前为公开测试版（RC）。 DSH 插件 0.5.0-rc.1 首次使用需一次本地后台配置；独立网页版 Web 0.5.0-rc.1 解压后通过启动脚本运行。换机和升级完整验收仍在进行。GitHub 发布源码与运行包，DSH 市场提供插件发现与安装。两种方式都不复制原生聊天历史，也不提供另一套聊天引擎。

选择运行方式

方式	安装与运行	数据
DSH 插件 0.5.0-rc.1	插件 Release、新机安装	保存在 DSH 对应存储域
独立网页版 Web 0.5.0-rc.1	网页运行包、启动说明，无需 DSH	独立保存到本机 .runtime-map/web，不自动与 DSH 同步

两种宿主复用同一套画布 UI、规则、可信状态读取及 Skill 命令。独立网页版当前未接入 DSH 原生会话来源；其他来源边界见下表及网页版说明。

能做什么

• 原生目录只读同步，支持项目、清单、会话及后台辅助会话过滤。
• 主画布与命名子画布共享节点坐标和关系；子画布只限定成员及视图。
• 多选整批移动、撤销/重做、四向折叠、搜索、来源筛选、全局置顶和卡片列表。
• 统筹用虚线，委派与复核用实线；连接端点和关系可编辑。
• “需要我介入”集中展示可信的待决定状态和未查看结果。
• 从地图返回原生应用。进入地图收起 DSH 外层导航，离开恢复；尊重手动展开。
• 两个内置 Skill：来源接入与目录同步、地图编辑。聊天里改地图无需重启 DSH。
• 首次配置完成后，打开地图会启动本地后台；异常恢复有重试退避，端口冲突不强行结束其他程序。

来源覆盖

来源	目录	运行状态	查看确认
DSH 原生	原生会话与工作区接口	原生运行及等待状态	原生可见/已读信号及地图确认
Codex / 本机 Work	本机 App Server + Desktop 元数据	本机原生事件日志；支持压缩记录与长行增量读取	有身份匹配的原生未读→已读证据时同步；否则手动确认
WorkBuddy	本机数据库的稳定只读副本	需另装附属观察插件；等待真实 Hook 事件	地图内手动确认
云端 ChatGPT / 云端 Work	已核验的本机目录缓存、置顶与显式登记；非全账号同步	未接入	不推断云端已读

来源失联、事件过期或证据不足时显示“未接入 / 来源不可用 / 未知”，不靠最后更新时间、进程存在或标题猜测工作状态。状态和目录覆盖是两件事，能看到一个入口不代表能实时观察它。详细边界

安装与使用

第一次换电脑试装，先看 Windows 新机安装。

首版针对 Windows + DSH Desktop 0.2.0-rc.2 + Node 24.2 或以上；当前基线使用 Node 24.21。其他 DSH / 系统版本未经兼容性验收。

1. 阅读 安装说明，安装预构建插件并完成一次本地后台配置。
2. 打开 Runtime Map，点“同步目录”。未安装或未授权的来源会保留明确提示。
3. 从左侧目录选择会话加入画布；标题处可切换画布，创建与分组在“我的画布”。
4. 先选卡片，再拖动顶端手柄；Shift 框选、Ctrl 多选。端口负责连线，正文用于选择/详情，“打开”返回原应用。
5. 在 DSH 中让 AI 使用地图 Skill，先读现状与预览，按谈定的方案保存并回读。

示例请求：

同步已接入应用的目录，告诉我哪些来源失败。不要改现有画布和连线。

读取当前地图，先给我一个“本周执行入口”画布方案。只用已经存在的会话；关系不确定先不连。等我确认后再保存。

两个 Skill 的触发范围、脚本入口和撤销流程见 Skill 使用说明。本插件不提供跨应用原生续聊，也不自动发送测试消息。

数据与安全

原生应用是会话及执行状态的真源。Runtime Map 保存导航登记、画布、连线和查看回执，不修改原生聊天历史。状态读取会扫描原生日志中的事件字段；WorkBuddy 目录读取会创建临时数据库副本，副本可能含原库其他表，查询仅投影元数据并在结束后清理。

本地后台只监听回环地址；Skill 通道使用本机随机令牌。不要公开连接描述文件、目录导出、日志、数据库或自己的截图。仓库与发布包不含个人画布、原生历史、账号或令牌。数据边界

开发与发布

源码 src/，构建产物 lib/，目录后台 backend/server/，两个 Skill 在 skills/，附属状态观察器在 integrations/。当前发布包带有预构建前端和后台；前端 React 由 DSH 提供。

node build.mjs
node scripts/check.mjs
node --test test/*.test.mjs release-test/*.test.mjs
node --test backend/test/*.test.mjs
node scripts/release-audit.mjs

涉及真实 DSH SDK 的四个包需另行提供，见 开发说明。隔离检查、已安装版本的正常聊天验证和新机安装验收分别报告，互不替代。

• 架构与不变量
• 发布流程与 DSH 市场
• 候选验收清单
• 已知限制
• 更新记录

项目代码采用 MIT；第三方库和来源标识另见 THIRD_PARTY_NOTICES。Runtime Map 是社区项目，不代表各来源应用的官方产品。