Runtime Map

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

0.5.0-rc.1 是公开测试版（RC）。 首次使用需要一次本地后台配置；换机和升级完整验收仍在进行。 源码与 DSH 插件来自同一版本：GitHub 用于代码与发布包，DSH 市场用于发现和安装。它不是另一套聊天引擎，也不复制聊天历史到 DSH。

能做什么

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

来源覆盖

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

安装与使用

第一次换电脑试装，先看 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 是社区项目，不代表各来源应用的官方产品。