工作区图谱 · Workspace Atlas 0.2.0
DeepSeek Harness 原生插件，用可拖动的气泡管理工作区与会话。左下角选择工作区和筛选条件，右侧查看详情并执行原生操作。
工作区图谱演示
安装
已验证 DeepSeek Harness 0.2.1-rc.4 / 0.2.1-rc.5 的隔离 Web 宿主，开发依赖固定为当前 npm latest rc.5（2026-11-03 核对）。桌面使用同一个客户端入口，记忆读取走宿主 /api Remote 与 Connection，支持 Electron 的 IPC 通道；不依赖 localhost 地址或 Web 记忆卡片接口。无 HTTP 服务的原生进程内通道测试已通过，真实 Electron 窗口尚未实测。
安装到实际使用的 profile；Web 与桌面的插件版本分别管理。以下示例使用 web：
npx @deepseek-ai/dsh@0.2.1-rc.5 plugin --profile web add github:qrxf/dsh-workspace-graph#v0.2.0
安装后，在 Harness 侧栏点击 工作区图谱。如果当前配置未开启插件热重载，重启对应的 Harness 实例。
桌面安装将命令中的 --profile web 改为 --profile desktop；若使用自定义 profile，填写其实际名称。不要仅升级 Web 后就假定桌面也已升级。宿主最低支持 rc.4；独立的 alpha 发行通道不在本轮兼容承诺内。
仓库包含构建产物，安装不需要自行编译。宿主侧的官方 dsh-typert-protocol 运行依赖随安装解析，不需要额外的 API 密钥。
使用
- 大气泡为工作区，小气泡为会话，线条表示真实所属关系。
- 首次进入时，当前对话位于画布正中心；没有当前对话时适应全部节点。面板重新进入保留本次运行的视角，后续状态变化不会自动移镜。
- 初次进入仅显示工作区和宿主实际选中的当前会话；单击工作区展开/收起，可同时展开多个工作区。当前会话不受筛选或收起影响，以“当前”和白色外圈标记。
- 状态可以多选，同维度取“或”；时间、频率和状态之间取“且”。工作区保留为导航锚点，无匹配会话时显示说明。
- 普通拖动沿父子连线柔性牵引，远端会有滞后；按住 Ctrl 可单独自由拖动气泡，仍会碰撞并推动接触的气泡。支持拖动中切换 Ctrl。碰撞尺寸在原有基础上增加 25%，画面圆球大小不变。指针停止约 120ms 或松手后，绳子约 1.2 秒逐渐变硬；普通拖动大致恢复原来的相对树形并保留一部分变形和整体位移，Ctrl 的自由重排成为新布局。
- 工作区和会话按真实层级生成向四周分散的树状布局，小气泡从父圆周外侧向外展开；拖动与展开都保留碰撞。连线连接气泡圆周，并随位置实时更新。点击、展开、悬停保持视角不变，顶部“适应画布”给筛选面板留出空间。
- 并行运行、等待回应和宿主当前会话保留可见，越过折叠、分页和筛选限制；“当前”和“工作中”分别标注。当前标记来自本窗口宿主的 mainView 保留集合，不能据此推断其他窗口中的当前焦点。
- 运行中以蓝色、等待回应以金色显示非常明亮的多层光晕，呼吸低谷仍保持高亮；新结果以绿色发光。“当前”白色外圈保留，当前会话正在工作时仍使用对应状态色，空闲时使用冰蓝色。光晕位于圆球外侧，文字保持清晰；开启“减少动态效果”后保留静态发光。
- 展开“主题与动态效果”可选颜色、输入 HEX、恢复默认并减少动态效果，也遵循系统减少动态偏好。深工作区、展开更深、浅会话与运行标识相互独立。
- 会话详情可本地置顶和编辑短概括；已移除悬停/聚焦时的环绕文字与自动移镜。
- 嵌套工作区按宿主目录路径连接到最近的父工作区，并显示“子工作区”标记。分支会话使用宿主
parentId 连接来源圆周，优先向树的外侧分布；筛选或分页隐藏来源时，会保留必要的来源链作为上下文。拖动不改变真实归属。
- 拖动气泡调整位置；拖动背景平移，滚轮缩放；顶部可适应画布、重排并撤销。
- 左下角选择工作区，按状态、类型和归档情况筛选；顶部搜索工作区名称、路径或会话标题。
- 搜索也匹配会话目录与手动概括，右侧结果不受折叠和图谱分页限制。点击结果临时显示会话和来源链并定位，可返回定位前视角；搜索结果仍遵循所选时间、状态和归档条件。“清除筛选”切换到全部时间，“恢复默认视图”恢复近期偏好并收起工作区。
- 顶部全局状态按钮显示等待回应、运行中、新结果的互斥计数，可直接列出并定位会话；活动会话越过当前筛选时显示“筛选外活动”。列表视图每批显示 50 条结果，缩小图谱时隐藏次要文字。
- 单击查看详情，双击打开；详情提供新建会话、工作区重命名、会话归档和恢复。
- 默认隐藏空白会话、子代理会话和归档会话，实际当前会话除外。工作区展开后先显示 20 个会话，可在详情中继续展开。
- 运行中会话的归档遵循 Harness 限制；本插件不自动停止正在进行的工作。
拖拽只改变图谱位置，不移动文件、不改变工作目录或会话所属。不读取会话正文，不调用模型；可选摘要提供方契约见 调查与接入边界，没有真实自动概括插件接入。记忆详情按下节规则按需读取。
工作区记忆与读取关系
0.2.0 对接 dsh-continual-evolve 0.19.3 的中央 SQLite 数据库，只负责展示，记忆创建、提取、修改与遗忘仍由原插件处理。
- 紫色有向虚线：读取方 → 记忆来源方。同一方向的多条记忆合并；双方互相读取时显示两个方向。线连接工作区圆周并随拖动更新，不参与树布局、绳索牵引或真实归属。
- 工作区详情显示项目记忆与可见的全局共享记忆、来源、类型、正文读取次数和最近读取时间；点击“查看正文”才加载正文。“刷新记忆”可手动更新，图谱打开期间也会每 15 秒更新元数据。
- 连线依据
memory_usage 的按 ID 正文读取记录，结合全局记忆的 origin_workspace 或确切的来源会话所属工作区。仅仅拥有记忆、命中检索或收到索引注入不会连线；未知来源、自身读取和同 ID 本地记忆遮蔽全局的情况也不会产生跨工作区线。
- 原插件没有完整的逐次读取来源快照。图谱按现有记忆来源＋累计读取记录解析，不能还原已删除记忆或来源变更前的完整历史。被筛选隐藏的端点不会被强制展开，因此可见线数可能少于总关系数。
- 宿主从
$DSH_HOME/evolve/memory.db 读取；未设置时为 ~/.dsh/evolve/memory.db。客户端不能指定数据库或文件路径。使用 SQLite readOnly 与 query_only，不创建数据库、不迁移结构、不修改记忆或读取计数。
- 记忆接口仅允许当前宿主的 owner，受限远程身份不会获得记忆内容。详情和正文不保存到浏览器本地存储或图谱备份。缺少数据库、SQLite 支持或兼容结构时显示提示，基础图谱继续使用。
不需要为图谱另行安装或复制记忆插件；若希望产生新的记忆和读取记录，需要在使用的宿主/profile 中启用原记忆插件。同一 DSH_HOME 下的 Web/桌面可读取同一中央记忆库；不同 DSH_HOME 的数据独立。
默认使用“近期”筛选，也可切换到全部时间；已有明确保存的筛选继续保留。“近期”按宿主持久消息活动时间不超过 7 天计算。“常用”按最近 30 天从本图谱主动打开至少 5 次计算，同会话间隔不足 30 分钟不重复计数。缺少既往访问历史时从本版本开始观察；记录不足显示“使用记录积累中”，不会把悬停、刷新或自动恢复计为打开。原生侧栏的打开来源尚无可靠人工操作事件，因此不计入这个图谱本地指标。
布局保存
位置和视角在本次应用运行内保留，切换面板后继续使用；刷新页面、重新启动或重新初始化插件后，所有气泡恢复默认布局，首次视角重新适配。旧版持久坐标与视角不再自动恢复。筛选、主题、动态偏好、置顶、手动概括和本地使用记录继续保存于当前浏览器，使用稳定的原生对象 ID 区分同名对象。重新进入从折叠态开始，活动会话继续显示。
布局不会自动同步至其他浏览器或设备。同一浏览器来源使用独立命名空间；不同 profile 的工作区 ID 保持各自身份，但“全部”视角和筛选可能共用浏览器偏好。
现代浏览器使用 Web Locks 和修订号协调持久设置写入。各窗口布局独立，拖动不写入 localStorage，也不覆盖另一窗口的位置；持久设置更新继续同步。存储被禁用、已满或损坏时显示提示，也可以保存已存原文以便排查。
顶部“备份与恢复”始终可用，可导出完整本地设置和当前布局，或选择最多 5 MB 的 JSON 备份，预览后确认替换。导入先校验格式并检测其他窗口的更新；写入失败保留当前数据。导入的坐标仍只在本次运行保留，概括、置顶、主题、使用记录和筛选持久保存。备份可能包含工作区路径、概括和使用记录，请按需要保管。
顶部“重置布局”只重排位置。存储异常时的“清除全部本地数据”会清除概括、置顶、主题、使用记录、筛选和布局，界面会明确提示并要求确认。
快速远拖后松手，普通拖动继续保留柔性和部分变形；极端拖动的保留变形最多为原连线长度的 20%，避免中心气泡被留在子气泡环的外侧。Ctrl 自由拖动继续保留用户摆放的结果和碰撞。
开发与验证
Node.js 22.19+（项目实际验证使用 Node 24）。
npm ci
npm test
npm run typecheck
npm run build
npm run demo
独立演示使用清楚标注的示例数据，与插件共用同一个界面。浏览器测试自行启动临时演示服务：
npx playwright install chromium
npm run test:browser
补充回归：node tests/rope-edge-browser.mjs 测量圆周端点，node tests/ctrl-drag-browser.mjs 验证自由拖动与碰撞，node tests/runtime-layout-browser.mjs 验证并行当前会话与重启重置，npm run test:flex 验证软绳和停止恢复。node tests/summary-edge-browser.mjs 验证边缘聚焦，node tests/lifecycle-browser.mjs 验证键盘及资源释放，npm run test:performance 测量 10/50/100 个真实节点帧间隔，node tests/physics-benchmark.ts 单独测量物理计算。PowerShell 设置 $env:BROWSER_CHANNEL='msedge' 可使用系统 Edge，缺录屏依赖时设置 $env:WG_SKIP_VIDEO='1'。最新验证见 布局与交互记录。
真实宿主集成测试使用临时 DSH_HOME、合成工作区及独立端口，不使用真实用户的会话或密钥。先设置 DSH_CLI 为已安装 dsh 的 lib/bin.js，再执行：
npm run test:native
npm run test:interactions 顺序运行导航、千级目录、首次居中、密集环松手、圆周连线、Ctrl/柔性拖动、运行布局、隐藏层级与生命周期回归；npm run test:catalog 测量 1,000／5,000 条会话的投影。CI 自动执行两者以及 npm run test:memory；版本标签或手动触发运行 DSH rc.4 / rc.5 的隔离原生验证矩阵。npm run test:transport 在构建后验证无 HTTP 服务的原生 Connection/Gateway 通道。慢速冷启动可设置 DSH_BOOT_TIMEOUT_MS=180000。本轮记录见 0.2.0 验证，此前记录见 导航与恢复验证。
测试覆盖：所属关系、状态优先级、过滤后的坐标保留、归档显示、分批展开、损坏存储、保存冲突、拖拽后刷新、筛选、搜索和恢复会话。完整验证记录见 docs/verification.md。
结构
src/client.tsx Harness 原生页面与侧栏入口
src/adapter.ts 原生工作区/会话快照转换
src/model.ts 图谱投影、所属关系与筛选
src/layout.ts 浏览器布局存储、校验与冲突处理
src/GraphPage.tsx 画布、筛选面板与详情
src/styles.css 深蓝气泡界面
src/host.ts owner-only 原生记忆 Remote 服务
src/memory-store.ts continual-evolve SQLite 只读适配
src/memory.ts 记忆契约与展示连线投影
src/MemoryDetails.tsx 按需加载的记忆详情
scripts/build.mjs ModuleLoader 客户端打包
React、ReactDOM 使用宿主提供的实例；React Flow 随客户端打包，宿主 Remote 协议为明确声明的官方运行依赖。没有增加模型工具、模型调用或自动任务；文件系统接触限于读取既有记忆数据库。禁用插件时服务注册项、刷新计时器与样式随生命周期移除。
License
MIT。随客户端打包的第三方许可见 dist/THIRD_PARTY_LICENSES.txt。
A native draggable workspace/session graph for DeepSeek Harness, with bright status-colored halos, evidence-based directed memory links and on-demand read-only memory details. Tested Web hosts: DSH 0.2.1-rc.4 and rc.5. Native in-process transport verified; an actual Electron window has not been smoke-tested. No extra model calls or API key required.
