Menghuan1918 5ea2f2d6ec docs(tasks): 工作图打磨的设计文档与真机验证证据；卡片细节两处修正 ...

- 新增 docs/plans/2026-09-27-tasks-graph-polish.md：本轮问答结论、架构与文件、
  关键设计（卡片两段 / 合并活动 / 扫光 / 折叠聚合 / ctx.jobs / 布局与窄栏）、
  移植与丢弃清单、实施偏差记录、验证证据（含 3080 真机逐项目击记录与截图路径）、
  未在真机复现的两项与已知取舍。
- 2026-09-14 图分支设计文档加「本轮打磨」小节指向新文档；README 任务页条目
  与 AGENTS §1/§3.1#4 同步（后台任务改读宿主客户端 ctx.jobs，不再自建回放路由）。
- 卡片两处修正（真机截图暴露）：
  ① 小条的钩子从 `data-state` 改为 `data-card-bar` —— 宿主自己的 primitive 也在
     发 `data-state`（菜单分隔、编辑器等），同名属性让「卡片内恰好一条小条」的
     断言与用户 CSS 都不可靠；
  ② 上段的 mono 行改由新的 `agentIdentity()` 产出（只讲「是谁」），根节点返回空
     —— 原先复用 `agentMeta()` 会把状态词印两遍（徽章下方 + 小条），正是用户
     反馈的「节点内信息太密」。可访问名继续用含状态的 `agentMeta()`。

验证：typecheck / lint 通过；pnpm test 1240 passed / 9 skipped；
挂载 lane 7/7（真实 DSH 0.1.7-rc.2）；3080 真机自测通过（见文档表格）。

(cherry picked from commit 338a54820799c26ab91141e8d98c673b8d474610)

2026-09-27 22:18:49 +08:00

..

e2e

feat: adapt to DSH 0.1.7-alpha.1 and yield the read-only previews

2026-09-22 17:09:08 +08:00

fixtures/aggregate-better-sidebar

fix(bundle): 聚合双挂载自动退让 —— 已有同包名启用挂载时不再挂自己 (#200)

2026-08-18 20:29:14 +08:00

add-plugin-modal.spec.tsx

fix(tests): 补回 add-plugin-modal.spec 缺失的 builtinTabPlugins import

2026-09-03 20:29:50 +08:00

agent-opens.spec.ts

fix(cwd): resolve detached session cwd via persistence index, not host process cwd (#372)

2026-08-27 21:44:04 +08:00

api-surface.spec.ts

chore: v0.12.0-beta.1（版本三处同步，api-surface 测试放行预发布版本号）

2026-08-15 00:28:59 +08:00

assistant-live.spec.ts

feat(dsh): adapt to DSH 0.1.5-alpha.1

2026-09-09 11:15:30 +08:00

breakpoints-react.spec.tsx

fix: recalculate panel geometry on resize

2026-08-21 23:49:13 +08:00

breakpoints.spec.ts

fix: 移动端合并改为底部标签直接并入右侧栏（迁移式，删除双工作台堆叠方案）+ 窄屏断点收紧至 768px（不对齐宿主 1024）

2026-08-12 18:27:28 +08:00

browser-globals.ts

feat: adapt to DSH 0.1.7-alpha.1 and yield the read-only previews

2026-09-22 17:09:08 +08:00

builtins.spec.ts

feat(client): workflow-graph Tasks page with teams board and jobs drawer

2026-09-27 22:18:14 +08:00

bundle-route.spec.ts

feat: yield the terminal and browser to DSH 0.1.6's own sidebar types

2026-09-21 20:35:11 +08:00

center-column-locator.spec.ts

feat(dsh): adapt to DSH 0.1.5-alpha.2

2026-09-09 23:09:48 +08:00

changes-ops.spec.ts

feat: adapt to DSH 0.1.7-alpha.1 and yield the read-only previews

2026-09-22 17:09:08 +08:00

changes-tab.spec.tsx

Merge remote-tracking branch 'origin/main' into feat/changes-md-reading

2026-09-04 14:13:34 +08:00

chunk-artifact.spec.ts

chore: adapt the tasks/workflow/teams work to DSH 0.1.7-rc.1 (rebase onto v0.21.1)

2026-09-27 22:18:19 +08:00

chunk-loader.spec.ts

feat: yield the terminal and browser to DSH 0.1.6's own sidebar types

2026-09-21 20:35:11 +08:00

consumer-types.ts

feat: yield the terminal and browser to DSH 0.1.6's own sidebar types

2026-09-21 20:35:11 +08:00

conversation-draft.spec.ts

fix(conversation): restore the composer caret after the draft insert (#425)

2026-08-29 15:31:13 +08:00

desktop-env.spec.ts

feat(sidebar): 桌面兼容三方案——自动检测(WCO 标准几何)/壳预设/自定义 CSS (#284)

2026-08-21 01:28:17 +08:00

diff-files-collapse.spec.tsx

test(specs): 收敛 28 个组件 spec 的渲染样板到共享 test-utils

2026-09-03 12:04:35 +08:00

diff-fold-expand.spec.tsx

fix(diff): git lens 折叠行接入按需展开，修复点击无反应

2026-09-07 23:51:10 +08:00

diff-highlight.spec.ts

feat(diff): expand syntax highlighting — mjs/cjs/mts/cts, CSS/SCSS/Less, HTML/XML/SVG/Vue, GraphQL, JSONC/JSON5

2026-09-01 23:05:26 +08:00

diff-rows.spec.ts

feat(diff): 折叠行异步展开状态机与内容切片

2026-09-07 23:51:06 +08:00

e2e-host-protocol.spec.ts

feat: adapt to DSH 0.1.2-rc.1 and bump to v0.18.0 (stable)

2026-09-03 17:32:04 +08:00

editor-host.spec.tsx

refactor(shell): retire the plugin's own right panel and free windows

2026-09-09 15:18:06 +08:00

editor-load.spec.ts

feat(editor): 拆分 EditorHost/TextEditor — code/markdown 成为注册 viewer，fs.read 增加 head 字节

2026-08-11 11:16:36 +08:00

editor-refresh.spec.tsx

refactor(shell): retire the plugin's own right panel and free windows

2026-09-09 15:18:06 +08:00

file-icons.spec.tsx

feat(icons): file icons and tab glyphs in color, from the host's own artwork

2026-09-11 15:28:49 +08:00

file-tree-drop.spec.tsx

test(specs): 收敛 28 个组件 spec 的渲染样板到共享 test-utils

2026-09-03 12:04:35 +08:00

file-tree-open-with.spec.tsx

fix(ui): compact context menus + viewport-clamped submenu flip

2026-09-04 20:28:35 +08:00

file-tree-reference-tail.spec.ts

fix(explorer): pin reference affordance to row tail

2026-09-02 10:55:03 +08:00

file-tree-rename-delete.spec.tsx

feat(files): tree rename (inline) + delete (confirmed) + submenu visual tether

2026-09-04 22:08:02 +08:00

file-tree-reveal-scroll.spec.tsx

test(specs): 收敛 28 个组件 spec 的渲染样板到共享 test-utils

2026-09-03 12:04:35 +08:00

file-types.spec.ts

fix: 文件编辑器支持 Vue 与 28 种 legacy 语言语法高亮

2026-08-18 18:05:01 +08:00

frame-batcher.spec.ts

perf(sidebar): 消除开关/拖拽的每帧 React 重渲染

2026-08-22 22:50:13 +08:00

fs-operations.spec.ts

feat(files): tree rename (inline) + delete (confirmed) + submenu visual tether

2026-09-04 22:08:02 +08:00

fs-search.spec.ts

fix(explorer): 文件名搜索跳过 node_modules 等噪声目录

2026-08-23 02:50:37 +08:00

fs-tree-symlink.spec.ts

fix: symlink 探测有界并发 + UNC 标记平台中性化（回应 CR/自审）

2026-08-16 23:35:57 +08:00

fs-tree.spec.ts

fix: symlink 探测有界并发 + UNC 标记平台中性化（回应 CR/自审）

2026-08-16 23:35:57 +08:00

fs-watch.spec.ts

feat: adapt to DSH 0.1.7-alpha.1 and yield the read-only previews

2026-09-22 17:09:08 +08:00

git-spawn.spec.ts

fix(git): 兼容旧版 Git 的 worktree 列表

2026-08-29 15:31:08 +08:00

git-view-worktree.spec.tsx

test(specs): 收敛 28 个组件 spec 的渲染样板到共享 test-utils

2026-09-03 12:04:35 +08:00

git-worktree.spec.ts

test: make five suites Windows-runner clean

2026-09-03 10:42:56 +08:00

git.spec.ts

test: make five suites Windows-runner clean

2026-09-03 10:42:56 +08:00

html-route.spec.ts

fix: symlink 探测有界并发 + UNC 标记平台中性化（回应 CR/自审）

2026-08-16 23:35:57 +08:00

ime-guard.spec.ts

fix: IME 组合期按键守卫 — document capture 拦截，防内联第三方组件劫持方向键（#562）

2026-08-12 01:16:20 +08:00

install-powershell.spec.ts

fix(ci): stop the Windows lane's real timeouts and the mount lane's npm failures

2026-09-11 12:02:41 +08:00

layout-css.spec.ts

perf: tag the center column instead of a :has() selector; stop re-stringifying the editor doc per keystroke

2026-09-01 16:01:34 +08:00

layout-push.spec.ts

refactor(shell): retire the plugin's own right panel and free windows

2026-09-09 15:18:06 +08:00

lazy-chunk.spec.tsx

feat: yield the terminal and browser to DSH 0.1.6's own sidebar types

2026-09-21 20:35:11 +08:00

link-intercept.spec.ts

feat: adapt to DSH 0.1.7-alpha.1 and yield the read-only previews

2026-09-22 17:09:08 +08:00

locales.spec.ts

refactor(tasks): 移植主 Agent 同款合并活动折叠（数据层）

2026-09-27 22:18:35 +08:00

manifest-consistency.spec.ts

chore: adapt the tasks/workflow/teams work to DSH 0.1.7-rc.1 (rebase onto v0.21.1)

2026-09-27 22:18:19 +08:00

markdown-copy-labels.spec.tsx

fix: md 预览代码块复制按钮跟随 DSH i18n（MarkdownText 补传 codeLabels）

2026-08-13 10:26:57 +08:00

markdown-frontmatter.spec.tsx

fix(editor): hide YAML frontmatter in Markdown preview

2026-09-02 23:15:19 +08:00

markdown-html-render.spec.tsx

feat: adapt to DSH 0.1.7-rc.1

2026-09-23 22:24:56 +08:00

markdown-html.spec.ts

feat(editor): Markdown 预览内嵌 HTML 安全渲染 + 目录大纲（TOC）

2026-08-24 12:05:14 +08:00

markdown-images.spec.ts

fix: address Copilot review (9 comments)

2026-08-23 22:02:47 +08:00

markdown-manual-refresh.spec.tsx

refactor(shell): retire the plugin's own right panel and free windows

2026-09-09 15:18:06 +08:00

market-manifest.spec.ts

feat: adapt to DSH 0.1.7-rc.1

2026-09-23 22:24:56 +08:00

md-toc.spec.tsx

test(specs): 收敛 28 个组件 spec 的渲染样板到共享 test-utils

2026-09-03 12:04:35 +08:00

menu-flip.spec.tsx

refactor(shell): retire the plugin's own right panel and free windows

2026-09-09 15:18:06 +08:00

mermaid-blocks.spec.ts

feat(mermaid): Markdown 预览安全渲染 Mermaid 图表（strict 清洗 + 懒加载 chunk + 点击放大） (#164)

2026-08-18 01:22:28 +08:00

mermaid-markdown.spec.tsx

feat: adapt to DSH 0.1.7-rc.1

2026-09-23 22:24:56 +08:00

mermaid-sanitize.spec.ts

feat(mermaid): Markdown 预览安全渲染 Mermaid 图表（strict 清洗 + 懒加载 chunk + 点击放大） (#164)

2026-08-18 01:22:28 +08:00

native-surface.spec.ts

fix(editor): reclaim the nine formats DSH has no preview for

2026-09-23 22:25:19 +08:00

one-dark-palette.spec.ts

refactor(theme): One Dark/Light 语法色板单源化

2026-09-03 19:59:00 +08:00

open-external-client.spec.ts

fix(editor): 在客户端打开 SSH 远程编辑器链接

2026-09-03 10:32:34 +08:00

open-external.spec.ts

fix: preserve Windows explorer reveal selection

2026-09-02 10:27:43 +08:00

open-with-settings.spec.tsx

test(specs): 收敛 28 个组件 spec 的渲染样板到共享 test-utils

2026-09-03 12:04:35 +08:00

open-with.spec.ts

feat(editor): 文件树「在应用中打开」子菜单（外部编辑器/图钉固定/SSH 远端/自定义编辑器） (#334)

2026-08-22 23:19:17 +08:00

orphaned-tab.spec.tsx

feat: yield the terminal and browser to DSH 0.1.6's own sidebar types

2026-09-21 20:35:11 +08:00

panel-host-css.spec.ts

fix(lint): 清零存量 lint 告警并接入 CI / Makefile 门禁

2026-09-03 20:00:08 +08:00

paths.spec.ts

fix(native): meet DSH 0.1.6-alpha.2 guide-id and turn-tail contracts

2026-09-21 20:18:16 +08:00

platform.ts

fix: symlink 探测有界并发 + UNC 标记平台中性化（回应 CR/自审）

2026-08-16 23:35:57 +08:00

plugin-list.spec.ts

feat(i18n): localize plugin catalog names and shell preset desc

2026-09-03 19:59:00 +08:00

plugin-meta.spec.ts

feat(meta): colourise the plugin artwork and say what it actually is

2026-09-23 20:46:11 +08:00

plugin-shape.spec.ts

feat: yield the terminal and browser to DSH 0.1.6's own sidebar types

2026-09-21 20:35:11 +08:00

prefs.spec.ts

feat(client): workflow-graph Tasks page with teams board and jobs drawer

2026-09-27 22:18:14 +08:00

primitives-exports.spec.ts

test: stop shelling out to ripgrep in the icon-export guard

2026-09-23 22:36:05 +08:00

process-activity.spec.ts

refactor(tasks): 移植主 Agent 同款合并活动折叠（数据层）

2026-09-27 22:18:35 +08:00

process-labels.spec.ts

refactor(tasks): 移植主 Agent 同款合并活动折叠（数据层）

2026-09-27 22:18:35 +08:00

redact.spec.ts

fix(redact): keep the credential heuristics off ordinary files

2026-09-06 23:46:46 +08:00

reference-mention.spec.ts

fix(editor): keep file basename in @-reference links

2026-09-03 10:00:13 +08:00

resource-address.spec.ts

feat(dsh): adapt to DSH 0.1.5-alpha.2

2026-09-09 23:09:48 +08:00

sandbox-views.spec.tsx

feat: yield the terminal and browser to DSH 0.1.6's own sidebar types

2026-09-21 20:35:11 +08:00

selection-payload.spec.ts

feat: 预览区划选文字浮窗「添加到对话」（md 预览 + 兜底 code 查看器）

2026-08-13 01:39:59 +08:00

selection-popup.spec.tsx

test(specs): 收敛 28 个组件 spec 的渲染样板到共享 test-utils

2026-09-03 12:04:35 +08:00

service.spec.ts

feat: yield the terminal and browser to DSH 0.1.6's own sidebar types

2026-09-21 20:35:11 +08:00

session-path.spec.ts

fix: 修复 WSL 会话 Linux 路径解析 (#399)

2026-09-02 23:20:17 +08:00

settings-nav-icon.spec.ts

Merge pull request #114 from XuYouo/main

2026-08-16 16:24:28 +08:00

setup.ts

feat(dsh): adapt to DSH 0.1.5-alpha.1

2026-09-09 11:15:30 +08:00

shell-presets.spec.ts

feat(i18n): localize plugin catalog names and shell preset desc

2026-09-03 19:59:00 +08:00

side-card-section-rows.spec.tsx

feat: yield the terminal and browser to DSH 0.1.6's own sidebar types

2026-09-21 20:35:11 +08:00

side-card-section.spec.tsx

feat: yield the terminal and browser to DSH 0.1.6's own sidebar types

2026-09-21 20:35:11 +08:00

sidebar-auto-activation.spec.tsx

refactor(tasks): 后台任务改读宿主客户端 jobs 服务，删除自建三条路由

2026-09-27 22:18:35 +08:00

sidebar-crash.spec.tsx

feat: adapt to DSH 0.1.7-alpha.1 and yield the read-only previews

2026-09-22 17:09:08 +08:00

sidebar-layout-push.spec.ts

refactor(shell): retire the plugin's own right panel and free windows

2026-09-09 15:18:06 +08:00

sidechat-core.spec.ts

feat: adapt to DSH 0.1.7-alpha.1 and yield the read-only previews

2026-09-22 17:09:08 +08:00

sidechat-routes.spec.ts

feat: adapt to DSH 0.1.7-alpha.1 and yield the read-only previews

2026-09-22 17:09:08 +08:00

sidechat-seed-validation.spec.ts

feat: adapt to DSH 0.1.7-alpha.1 and yield the read-only previews

2026-09-22 17:09:08 +08:00

sidechat-transcript.spec.ts

feat: adapt to DSH 0.1.7-alpha.1 and yield the read-only previews

2026-09-22 17:09:08 +08:00

sidechat-view.spec.tsx

feat: adapt to DSH 0.1.7-alpha.1 and yield the read-only previews

2026-09-22 17:09:08 +08:00

smoke.spec.ts

fix(settings): wait for the loader before migrating the retired settings

2026-09-22 17:35:29 +08:00

state.spec.ts

feat: yield the terminal and browser to DSH 0.1.6's own sidebar types

2026-09-21 20:35:11 +08:00

subagent-detect.spec.ts

feat: adapt to DSH 0.1.7-alpha.1 and yield the read-only previews

2026-09-22 17:09:08 +08:00

subagent-jobs-view.spec.tsx

refactor(tasks): 后台任务改读宿主客户端 jobs 服务，删除自建三条路由

2026-09-27 22:18:35 +08:00

subagent-jobs.spec.ts

refactor(tasks): 后台任务改读宿主客户端 jobs 服务，删除自建三条路由

2026-09-27 22:18:35 +08:00

subagent-live-polling.spec.tsx

refactor(tasks): 后台任务改读宿主客户端 jobs 服务，删除自建三条路由

2026-09-27 22:18:35 +08:00

subagent-live-route.spec.ts

refactor(tasks): 移植主 Agent 同款合并活动折叠（数据层）

2026-09-27 22:18:35 +08:00

tab-bar-context-menu.spec.tsx

feat: yield the terminal and browser to DSH 0.1.6's own sidebar types

2026-09-21 20:35:11 +08:00

tab-bar-middle-click.spec.tsx

refactor(shell): retire the plugin's own right panel and free windows

2026-09-09 15:18:06 +08:00

tab-bar-wheel.spec.tsx

refactor(shell): retire the plugin's own right panel and free windows

2026-09-09 15:18:06 +08:00

tab-content-memo.spec.ts

feat: yield the terminal and browser to DSH 0.1.6's own sidebar types

2026-09-21 20:35:11 +08:00

tasks-graph-layout.spec.ts

feat(tasks): 图节点改为双段式卡片 + 折叠聚合 + 窄栏可读性

2026-09-27 22:18:35 +08:00

tasks-model.spec.ts

refactor(tasks): 移植主 Agent 同款合并活动折叠（数据层）

2026-09-27 22:18:35 +08:00

tasks-page.spec.tsx

docs(tasks): 工作图打磨的设计文档与真机验证证据；卡片细节两处修正

2026-09-27 22:18:49 +08:00

team-routes.spec.ts

feat(host): add workflows.list and teams.* sidebar routes

2026-09-27 22:18:14 +08:00

test-utils.ts

test(utils): 新建共享 React 测试工具 setupReactAct / renderRoot

2026-09-03 12:04:24 +08:00

theme.spec.ts

chore: adapt the tasks/workflow/teams work to DSH 0.1.7-rc.1 (rebase onto v0.21.1)

2026-09-27 22:18:19 +08:00

titlebar-strip.spec.ts

feat(sidebar): 桌面兼容三方案——自动检测(WCO 标准几何)/壳预设/自定义 CSS (#284)

2026-08-21 01:28:17 +08:00

trusted-hosts.spec.ts

feat(dsh): adapt to DSH 0.1.5-alpha.1

2026-09-09 11:15:30 +08:00

upload.spec.ts

feat(explorer): upload files into the workspace from the file tree (#239)

2026-08-20 18:28:57 +08:00

wco.spec.ts

feat(sidebar): 桌面兼容三方案——自动检测(WCO 标准几何)/壳预设/自定义 CSS (#284)

2026-08-21 01:28:17 +08:00

workflow-routes.spec.ts

feat(host): add workflows.list and teams.* sidebar routes

2026-09-27 22:18:14 +08:00

workflow-runs.spec.ts

feat(host): add workflows.list and teams.* sidebar routes

2026-09-27 22:18:14 +08:00