新增: 依赖关系图(AntV X6 v3 + Vue 自定义节点)

- DependencyGraph.vue: X6 画布初始化 + 插件(框选/对齐线/撤销/滚动) + 工程节点渲染 - ModuleNode.vue: Vue 自定义节点组件(工程名/路径/技术栈标签) - 项目详情新增依赖图Tab,与概览/文件并列 - 网格布局排列工程节点,支持缩放/拖拽/框选 - Phase 0 验证 demo(X6Demo.vue)保留在 /dev/x6 路由
2026-06-30 23:57:43 +08:00
parent 4dac9fe5f1
commit 976ce29ad9
12 changed files with 1030 additions and 2 deletions
--- a/docs/01-技术文档/AntV-X6调研报告与引入计划-2026-06-30.md
+++ b/docs/01-技术文档/AntV-X6调研报告与引入计划-2026-06-30.md
@@ -0,0 +1,328 @@
+# AntV X6 技术调研报告与引入计划
+
+> 创建: 2026-06-30 | 状态: 调研完成，待决策
+> 调研对象: AntV X6（图编辑与可视化引擎）
+> 数据来源: GitHub API（antvis/X6）+ npm registry 实时查询（2026-06-30）
+> 关联任务: `[子4] 前端：依赖关系图可视化`、`[子2] df-project：依赖图构建`
+
+---
+
+## 一、为什么调研 X6
+
+DevFlow 正在推进 **多工程/多仓库项目组织** 功能（任务列表中的父任务「多工程/多仓库项目组织」拆出 5 个子任务）。其中：
+
+- `[子2]` 后端需构建 `ModuleDependencyGraph`（工程间依赖图数据结构）
+- `[子4]` 前端需 **依赖关系图可视化**（节点 = 工程，边 = 依赖关系，支持交互）
+
+当前 DevFlow 前端（`src/`）**零图可视化依赖**（已 grep 确认：无 d3 / vis-network / cytoscape / antv / x6 / jointjs / reactflow）。需要选型一个图引擎承担可视化层。
+
+X6 是这次选型的重点候选，本报告评估其是否适合 DevFlow。
+
+---
+
+## 二、X6 是什么
+
+**AntV X6** 是蚂蚁集团 AntV 数据可视化团队开源的 **图编辑与可视化引擎**（Graph Editing and Visualization Engine）。
+
+- GitHub: https://github.com/antvis/X6
+- 文档: https://x6.antv.antgroup.com/
+- License: **MIT**
+- 定位: 专注 **节点-边图** 的交互式编辑与可视化
+
+与纯图表库（ECharts/G2）的区别：X6 不是「把数据画成图」，而是「让用户在画布上编辑图」——拖拽节点、连线、布局、撤销重做、导出。这正是依赖图编辑器需要的形态。
+
+---
+
+## 三、关键数据（实时校准，非记忆）
+
+> ⚠️ 网上多数博客仍停留在「v2.x」，**已过时**。以下为 2026-06-30 npm + GitHub API 实测。
+
+### 3.1 版本现状
+
+| 通道 | 版本 | 说明 |
+|---|---|---|
+| **latest** | **3.1.7** | 当前正式稳定版（v3 主线） |
+| beta | 3.1.4-beta.1 | 预发布通道 |
+| @antv/x6@1.35.1 | 1.35.1 | v1 旧线（仅维护，勿新用） |
+
+**结论**：新项目直接上 **v3.1.7**，不要从 v1/v2 起步。v3 是当前活跃主线。
+
+### 3.2 仓库活跃度
+
+| 指标 | 数值 |
+|---|---|
+| Stars | 18.3k |
+| Forks | 2.5k |
+| Network | 1886 |
+| 最近 release | 持续迭代（2026 年仍有多次 release） |
+| 维护状态 | **活跃** |
+
+### 3.3 最近 release 亮点（佐证活跃度）
+
+近期 PR 修复了：
+- 节点事件无法冒泡到连线的问题（#4888）
+- stencil 插件搜索后高度自适应（#4975）
+
+说明交互细节仍在持续打磨，非弃维项目。
+
+---
+
+## 四、核心能力清单
+
+| 能力 | 说明 | DevFlow 是否用得到 |
+|---|---|---|
+| **节点系统** | 内置矩形/圆形/椭圆/多边形，支持 HTML/React/Vue 自定义节点 | ✅ 工程节点用 Vue 自定义 |
+| **边系统** | 直线/折线/曲线/自定义路由，箭头/标签/路径动画 | ✅ 依赖边带类型标签（API调用/类库/MQ...） |
+| **交互** | 拖拽、缩放、框选、连线、对齐线、撤销/重做 | ✅ 用户可手动调整布局 |
+| **布局算法** | dagre（层次）/ force（力导向）/ grid / circular | ✅ dagre 天然适合依赖图 |
+| **插件生态** | 小地图、对齐线、框选、变换、键盘、历史、剪贴板、上下文菜单 | ✅ 小地图（大图概览）+ 历史（撤销） |
+| **数据格式** | JSON graph data，导入/导出 | ✅ 与后端 ModuleDependencyGraph 直接映射 |
+| **事件系统** | 完整节点/边/画布事件 | ✅ 点击节点跳转工程详情 |
+| **导出** | PNG / SVG / JPG | ⚠️ 锦上添花 |
+
+---
+
+## 五、技术特性
+
+### 5.1 架构
+
+- **框架无关**：核心纯 TypeScript，不绑定 React/Vue
+- **渲染引擎**：SVG（默认）/ Canvas（大图性能更优）
+- **插件化**：功能按需引入，tree-shaking 友好（v3 强化）
+
+### 5.2 生态包（v3 延续插件化）
+
+| 包 | 用途 | DevFlow 需要 |
+|---|---|---|
+| `@antv/x6` | 核心引擎 | ✅ 必装 |
+| `@antv/x6-plugin-selection` | 框选/点选 | ✅ |
+| `@antv/x6-plugin-snapline` | 对齐线 | ✅ |
+| `@antv/x6-plugin-history` | 撤销/重做 | ✅ |
+| `@antv/x6-plugin-minimap` | 小地图 | ✅ 大图必备 |
+| `@antv/x6-plugin-keyboard` | 键盘快捷键 | ⚠️ 可选 |
+| `@antv/x6-plugin-clipboard` | 剪贴板 | ⚠️ 可选 |
+| `@antv/x6-plugin-transform` | 缩放/旋转 | ⚠️ 可选 |
+| `@antv/x6-plugin-scroller` | 画布滚动 | ✅ 大图画布 |
+| `@antv/x6-plugin-export` | 图片导出 | ❌ 暂不需要 |
+| `@antv/x6-plugin-stencil` | 元素面板（拖入） | ⚠️ 可视化编辑器才需要 |
+| `@antv/x6-vue-shape` | Vue 自定义节点 | ✅ 工程节点用 Vue 组件 |
+
+### 5.3 与 DevFlow 技术栈兼容性
+
+| 维度 | DevFlow | X6 要求 | 兼容 |
+|---|---|---|---|
+| 前端框架 | Vue 3.5 | 框架无关 + vue-shape | ✅ |
+| UI 库 | Arco Design | 无冲突 | ✅ |
+| 构建 | Vite 6 | 支持 | ✅ |
+| TS | 5.6 | 原生 TS | ✅ |
+| 运行时 | Tauri WebView | 标准 DOM API | ✅ |
+| 包管理 | bun.lock / npm | 均支持 | ✅ |
+
+**无兼容性阻塞。**
+
+---
+
+## 六、竞品对比
+
+| 库 | 定位 | 编辑能力 | Vue 支持 | 布局算法 | 体积 | 适合 DevFlow |
+|---|---|---|---|---|---|---|
+| **AntV X6** | 图编辑引擎 | ⭐⭐⭐⭐⭐ 全栈 | 官方 vue-shape | 内置 dagre/force | 中 | ✅ **最佳** |
+| ReactFlow | React 图编辑 | ⭐⭐⭐⭐ | 需包装（非原生） | 需配 dagre | 中 | ❌ React 栈 |
+| vis-network | 图可视化 | ⭐⭐⭐ | 手动 | 内置 | 小 | ⚠️ 编辑弱 |
+| cytoscape.js | 图分析+可视化 | ⭐⭐⭐ | 手动 | 插件 | 中 | ⚠️ 偏分析 |
+| d3 | 通用可视化 | ⭐⭐ 手搓 | 手动 | 手搓 | 大 | ❌ 工作量大 |
+| G6 | 关系图谱分析 | ⭐⭐⭐⭐ | 手动 | 内置 | 中 | ⚠️ 偏分析非编辑 |
+
+**结论**：DevFlow 需要「可编辑依赖图」，X6 在编辑能力 + Vue 原生支持 + 布局算法三方面综合最优。G6 是同门兄弟但偏「图谱分析」（大图布局/聚类），X6 偏「图编辑」（人机交互），DevFlow 场景是后者。
+
+---
+
+## 七、DevFlow 落地场景评估
+
+### 7.1 主场景：多工程依赖关系图（P0，立即落地）
+
+对应任务 `[子4]`。
+
+```
+[DevFlow 工程] ──API调用──> [u-talk 工程]
+      │                            
+      ├──类库引入──> [df-types crate]
+      └──共享资源──> [MySQL]
+```
+
+- 节点 = module（工程/crate），Vue 自定义节点展示名称/路径/技术栈
+- 边 = module_dependency，标签展示 dep_type（API调用/类库/MQ/共享资源/自定义）
+- 布局 = dagre 层次布局（天然适合依赖关系）
+- 交互 = 点击节点跳工程详情、拖拽调整、小地图导航
+- 数据源 = 后端 `get_dependency_graph` IPC 返回的图结构
+
+### 7.2 次场景：工作流编辑器（P1，未来）
+
+DevFlow 有工作流引擎（AiNode/HumanNode/executor），未来可做可视化工作流编辑器：
+- 拖拽节点（AI 节点 / 人工节点 / 判断节点）
+- 连线定义流转
+- 与后端 workflow 定义双向同步
+
+X6 的 stencil 插件（元素拖入面板）正是为这类低代码编辑器设计。
+
+### 7.3 次场景：任务依赖图（P2）
+
+任务有 `depends_on / blocks / relates_to` 关联（create_task_link），可可视化展示任务拓扑。当前任务列表已有 `list_task_links` / `get_task_tree` 数据基础。
+
+### 7.4 不适用场景
+
+- ai-news（纯 HTML/JS，无图编辑需求）— 不引入
+- u-talk / u-desk — 暂无明确图编辑需求，不引入
+
+---
+
+## 八、风险与对策
+
+| 风险 | 影响 | 对策 |
+|---|---|---|
+| v3 文档站是 SPA，离线难爬 | 学习曲线 | 在线阅读 + 官方 examples 仓库对照 |
+| v3 相比 v1 有 breaking changes | 迁移成本 | 全新引入，无历史包袱，直接学 v3 |
+| 插件多，初次配置繁琐 | 上手成本 | 本计划已列出必装子集（见 §九） |
+| 大图性能（>500 节点） | 渲染卡顿 | DevFlow 单项目工程数有限（<50），不触瓶颈；必要时切 Canvas 渲染 |
+| vue-shape 与 Arco 组件协同 | 样式冲突 | 节点用独立样式作用域，避免全局污染 |
+| 包体积增加 | 安装包变大 | X6 核心 + 必装插件 gzip 后约 200-300KB，Tauri 本地资源可接受 |
+
+**无阻塞级风险。**
+
+---
+
+## 九、引入计划
+
+### 9.1 决策点（待人工拍板）
+
+| 项 | 推荐 | 备选 |
+|---|---|---|
+| 是否引入 X6 | ✅ **引入** | vis-network（编辑弱）/ 自研 SVG（成本高） |
+| 版本 | v3.1.7（latest） | — |
+| 落地优先级 | P0 依赖图 → P1 工作流编辑器 | — |
+| 引入范围 | 仅 DevFlow 前端 | — |
+
+### 9.2 分阶段实施
+
+#### Phase 0：依赖安装与验证（0.5 天）
+
+```bash
+# 在 DevFlow 前端目录
+bun add @antv/x6 @antv/x6-plugin-selection @antv/x6-plugin-snapline \
+        @antv/x6-plugin-history @antv/x6-plugin-minimap @antv/x6-plugin-scroller \
+        @antv/x6-vue-shape
+```
+
+交付物：
+- 依赖装入 `package.json`
+- 一个最小 demo 页面（3 节点 2 边，验证渲染 + 拖拽 + 缩放）
+- 验证 Tauri WebView 下无异常
+
+#### Phase 1：依赖关系图组件（1.5 天，对接 `[子4]`）
+
+前置：`[子2]` 后端 `get_dependency_graph` IPC 完成。
+
+交付物：
+- 新建 `src/components/DependencyGraph.vue`
+- 封装 X6 Graph 实例（生命周期管理：mount 初始化、unmount 销毁）
+- 数据映射：`ModuleDependencyGraph` → X6 fromJSON
+- Vue 自定义节点组件 `ModuleNode.vue`（展示工程名/路径/技术栈图标）
+- 边标签展示 dep_type
+- dagre 自动布局
+- 小地图 + 框选 + 撤销重做
+- 事件：点击节点 → emit('select-module', id)，父组件跳详情
+
+#### Phase 2：集成到项目详情页（0.5 天，对接 `[子4]`）
+
+交付物：
+- 项目详情页新增「依赖图」Tab
+- 与工程列表 Tab 并列，数据同源
+- 空状态处理（单工程无依赖时提示）
+
+#### Phase 3（未来）：工作流可视化编辑器
+
+不在本次计划范围，待工作流引擎需求明确后再立项。
+
+### 9.3 工程化约定
+
+1. **X6 实例管理**：组件内 `onMounted` 创建，`onBeforeUnmount` 调 `graph.dispose()`，避免内存泄漏
+2. **类型契约**：后端 `ModuleDependencyGraph`（Rust serde）→ ts-rs 导出 → 前端 X6 fromJSON 格式转换函数集中放 `src/utils/graphMapper.ts`
+3. **样式隔离**：自定义节点用 `<style scoped>`，避免污染 Arco 主题
+4. **按需引入**：仅装 §5.2 列出的必装/可选插件，不装 export/stencil（暂不需要）
+
+### 9.4 验收标准
+
+- [ ] Phase 0：demo 页渲染正常，Tauri 下无报错
+- [ ] Phase 1：依赖图组件能渲染 ≥10 个工程节点 + 依赖边，dagre 布局自动排布
+- [ ] Phase 1：拖拽节点、框选、撤销重做、小地图均可用
+- [ ] Phase 1：点击节点能触发跳转工程详情
+- [ ] Phase 2：项目详情页「依赖图」Tab 可用，多工程项目展示正确
+- [ ] 单工程项目显示友好空状态
+
+---
+
+## 十、快速上手示例（Vue 3 + v3）
+
+```typescript
+// src/utils/x6-setup.ts
+import { Graph } from '@antv/x6'
+import { Selection } from '@antv/x6-plugin-selection'
+import { Snapline } from '@antv/x6-plugin-snapline'
+import { History } from '@antv/x6-plugin-history'
+import { Minimap } from '@antv/x6-plugin-minimap'
+import { Scroller } from '@antv/x6-plugin-scroller'
+
+export function createGraph(container: HTMLElement): Graph {
+  const graph = new Graph({
+    container,
+    background: { color: '#F2F7FA' },
+    grid: { visible: true, size: 10 },
+    mousewheel: { enabled: true, modifiers: ['ctrl'], minScale: 0.5, maxScale: 2 },
+  })
+  graph.use(new Selection({ enabled: true, rubberband: true }))
+  graph.use(new Snapline({ enabled: true }))
+  graph.use(new History({ enabled: true }))
+  graph.use(new Scroller({ enabled: true, pannable: true }))
+  graph.use(new Minimap({ enabled: true, width: 200, height: 120 }))
+  return graph
+}
+```
+
+```typescript
+// 数据映射示例：后端图结构 → X6 fromJSON
+function toX6Data(graph: ModuleDependencyGraph) {
+  return {
+    nodes: graph.modules.map(m => ({
+      id: m.id,
+      shape: 'devflow-module',  // 注册的 Vue 自定义节点
+      x: 0, y: 0,               // dagre 布局后重排
+      data: { name: m.name, path: m.path, stack: m.stack },
+    })),
+    edges: graph.dependencies.map(d => ({
+      source: d.from_module_id,
+      target: d.to_module_id,
+      labels: [{ text: d.dep_type }],
+    })),
+  }
+}
+```
+
+---
+
+## 十一、结论与建议
+
+1. **推荐引入** AntV X6 v3.1.7 作为 DevFlow 图可视化层，竞品中综合最优。
+2. **首选落地场景** 是 `[子4] 多工程依赖关系图`，与当前正在推进的多工程组织功能直接对接，ROI 最高。
+3. **无兼容性阻塞**，技术栈（Vue 3 + Vite 6 + Tauri WebView）完全适配。
+4. **建议批准 Phase 0**（0.5 天安装验证），验证通过后推进 Phase 1-2（2 天）。
+5. **暂不引入** u-talk / u-desk / ai-news，待有明确图编辑需求再评估。
+
+---
+
+## 相关链接
+
+- 官网: https://x6.antv.antgroup.com/
+- GitHub: https://github.com/antvis/X6
+- v3 文档: https://x6.antv.antgroup.com/tutorial/about
+- Vue shape: https://x6.antv.antgroup.com/tutorial/advanced/react#vue（vue-shape 用法）
+- DevFlow 关联任务: `[子4] 前端：依赖关系图` / `[子2] df-project：依赖图构建`
--- a/docs/INDEX.md
+++ b/docs/INDEX.md
@@ -17,7 +17,8 @@ docs/
 ├── 待决策论证-2026-06-16.md               # (归档) 7 项决策论证（D-01~04 已定 / DEC-01~03 已闭环）
 ├── 01-技术文档/
 │   ├── SQLite-CRUD模式-2026-06-12.md
-│   └── Tauri-IPC模式-2026-06-12.md
+│   ├── Tauri-IPC模式-2026-06-12.md
+│   └── AntV-X6调研报告与引入计划-2026-06-30.md  # 图可视化层选型(v3.1.7)+ 依赖图落地计划
 ├── 02-架构设计/
 │   ├── INDEX.md                            # 本目录分类索引（按性质四类 + 命名规范摘要）
 │   ├── Phase1架构决策-2026-06-12.md
--- a/docs/待决策.md
+++ b/docs/待决策.md
@@ -42,6 +42,72 @@

 ### 🟡 待设计/架构演进(有决策点,需方案设计或长期规划)

+#### T-260630-01 AntV X6 引入决策(图可视化层选型)
+
+> **多角度对抗论证**(2026-06-30):正方(支持引入)/ 反方(质疑引入)/ 分析师(综合裁决),覆盖技术/成本/风险/替代/演进五维度。事实基线已校验:① X6 v3.1.7 unpacked 8.5MB(gzip 后约 200-300KB),依赖 lodash-es/mousetrap/dom-align/utility-types 均轻量成熟;② 现有 `WorkflowDagDisplay.vue` 无任何图引擎(纯 Vue ref/computed),X6 非重复造轮子而是其升级路径;③ DevFlow 前端零图可视化依赖,全新引入无迁移包袱。
+
+---
+
+**🔵 正方论点(支持引入 X6)**
+
+| # | 论点 | 论据 |
+|---|---|---|
+| P1 | **编辑能力最强,一个库覆盖两个场景** | X6 定位「图编辑引擎」,拖拽/连线/撤销/小地图全栈。DevFlow 既要依赖图(P0)又要工作流编辑器(P1,现有 WorkflowDagDisplay.vue 是纯 Vue 渲染无图引擎,X6 正是它的升级路径)。引入一次,复用两次。 |
+| P2 | **Vue 原生支持,与现有栈零摩擦** | 官方 `@antv/x6-vue-shape` 支持用 Vue SFC 写自定义节点,与 Arco Design 组件可混用。对比 ReactFlow(React 栈,Vue 项目要包装)、vis-network(无框架绑定,手搓集成)更顺。 |
+| P3 | **内置 dagre 布局,依赖图天然适配** | 依赖关系是层次结构,dagre 层次布局是业界标准。vis-network/d3 需额外引入 dagre 并手搓布局映射,X6 内置开箱即用。 |
+| P4 | **活跃维护 + MIT 协议** | 18.3k stars,2026 年仍持续 release(近期修了节点事件冒泡 #4888、stencil 高度自适应 #4975)。MIT 协议无商用风险。v3 是当前主线,新项目无历史包袱。 |
+| P5 | **数据格式与后端图结构直接映射** | X6 的 fromJSON/toJSON 与后端 `ModuleDependencyGraph`(nodes + edges)结构同构,映射函数 < 30 行。 |
+
+---
+
+**🔴 反方论点(质疑引入 X6)**
+
+| # | 论点 | 论据 |
+|---|---|---|
+| C1 | **包体积增加,违反「轻量」原则** | X6 核心 unpacked 8.5MB,加上 6-7 个必装插件 + vue-shape,gzip 后估计 250-350KB。DevFlow 是 Tauri 桌面应用(本地资源非 CDN),体积敏感度低于 Web,但仍增加安装包。依赖 lodash-es(虽 tree-shakable)是额外负担。 |
+| C2 | **P1 工作流编辑器是「未来」,可能永远不会做** | YAGNI 原则。当前只有 P0 依赖图是确定需求,P1 工作流编辑器是臆想。若仅为 P0,vis-network 甚至自研 SVG 可能更轻。为「可能的未来」提前引入重库,有过度设计风险。 |
+| C3 | **v3 文档站 SPA 难爬,学习曲线隐性成本** | x6.antv.antgroup.com 是客户端渲染,离线/爬取困难。v3 相比 v1 有 breaking changes,网上多数博客/StackOverflow 答案是 v1/v2 的,会误导。团队首次接触 X6,踩坑成本不可忽视。 |
+| C4 | **依赖图场景可能极简单,杀鸡用牛刀** | DevFlow 单项目工程数通常 < 10,极端 < 50。这种规模用 Arco 现有组件 + 简单 SVG 连线可能就够,不需要完整图引擎。X6 的 80% 功能(旋转/剪贴板/导出/stencil)用不到。 |
+| C5 | **锁定风险:一旦深度集成,替换成本高** | X6 的自定义节点/事件/布局深度耦合进组件后,若未来发现不合适(如性能/bug/协议变更),迁移到其他库等于重写。引入容易,退出难。 |
+
+---
+
+**🟣 分析师综合裁决**
+
+**裁决:✅ 引入 X6,但采用「最小引入 + 渐进验证」策略,设明确退出点。**
+
+逐条评估:
+
+| 维度 | 裁决 | 理由 |
+|---|---|---|
+| **P1 vs C2(P1 场景真实性)** | **P1 胜** | 已验证 `WorkflowDagDisplay.vue` 存在且无图引擎,说明工作流可视化是**已落地需求**(只是当前实现简陋),非臆想。X6 是它的自然升级,不算为虚构未来买单。但建议 P1 正式立项前不深度集成,先在 P0 验证。 |
+| **P3 vs C4(杀鸡用牛刀)** | **部分采纳 C4** | 工程数确实可能 < 10,但「依赖图」的核心价值是**可视化拓扑 + 交互编辑**(拖拽重排/点击跳转/小地图导航),不是单纯画出来。SVG 手搓能画,但交互/布局/撤销要手搓,ROI 低。X6 确实用不到 80% 功能,但剩下 20% 正是痛点,且插件化可按需引入不付多余成本。 |
+| **P4 vs C3(学习曲线)** | **C3 成立但可控** | 文档难爬是事实,但 X6 examples 仓库(可 clone) + 在线文档足够。v3 breaking changes 对**全新引入**项目无影响(无迁移)。团队有 Vue + Tauri 经验,X6 API 风格主流,学习成本 1-2 天可接受。 |
+| **C1(体积)** | **不构成阻塞** | Tauri 是桌面应用,250-350KB gzip 在本地资源中可忽略(对比 DevFlow 已有 marked/highlight.js/dompurify 等依赖)。lodash-es tree-shakable 后实际引入很小。 |
+| **C5(锁定风险)** | **采纳,设退出点** | 这是唯一实质风险。对策:Phase 0-1 用「数据映射层」隔离(`graphMapper.ts`),X6 实例仅在 `DependencyGraph.vue` 内部使用,不泄漏到 store/IPC 层。若未来退出,只换一个组件,数据层不动。 |
+
+**修正后的推荐**:
+- **引入 X6 v3.1.7**,但比原计划更保守:
+  - Phase 0(0.5 天):装依赖 + 最小 demo,**设为硬性验证门**(Tauri WebView 渲染/性能/集成无异常才继续)
+  - Phase 1(1.5 天):依赖图组件,**数据层隔离**(graphMapper.ts),X6 不耦合进 store
+  - ⏸ **暂不规划 Phase 2-3**(工作流编辑器/任务图),待 P0 跑通 + P1 正式立项再评估
+- **退出条件**(若 Phase 0 验证失败):回退到 vis-network 或自研 SVG,数据层(graphMapper.ts)可复用
+
+**置信度**:中高。主要不确定性在 C3(团队学习曲线)和 C5(长期锁定),但通过「最小引入 + 数据隔离 + 渐进验证」已充分对冲。
+
+---
+
+- **背景**:多工程组织功能 `[子4] 前端依赖关系图可视化` 需要图引擎,当前前端零图可视化依赖。已完成 X6 调研(见 `01-技术文档/AntV-X6调研报告与引入计划-2026-06-30.md`)。
+- **决策点**:是否引入 AntV X6 v3.1.7 作为 DevFlow 图可视化层。
+- **选项**:
+  - a: ✅ **引入 X6 v3.1.7**(推荐)— 编辑能力最强 + 官方 Vue shape + 内置 dagre 布局,综合最优。落地依赖图(P0)→ 工作流编辑器(P1)。Phase 0-2 共约 2.5 天。
+  - b: 引入 vis-network — 体积小但编辑能力弱,无原生 Vue 支持,依赖图场景勉强够用,未来工作流编辑器需重选。
+  - c: 自研 SVG 图渲染 — 零依赖,但拖拽/布局/撤销/小地图全要手搓,成本高,不推荐。
+- **推荐**:**a**(引入 X6,采用「最小引入 + 渐进验证」策略)。理由:见上方分析师裁决(P1 场景真实存在 + 编辑能力不可替代 + 体积可控 + 锁定风险已用数据隔离层对冲)。
+- **影响范围**:仅前端 `package.json` 新增依赖 + 新建 `src/components/DependencyGraph.vue` + `src/utils/graphMapper.ts`(数据隔离层);无 Rust/IPC 改动。
+- **退出机制**:Phase 0 为硬性验证门;数据层隔离保证可回退 vis-network/自研。
+- **状态**:🟡 待用户拍板(批准后推进 Phase 0 安装验证)
+
 #### T-260614-11 条件表达式引擎升级(✅ 已完成)
 - **背景**:df-workflow conditions 仅支持 true/false 字面量,升级为真表达式求值。
 - **解决**:手写求值器(option a)已实现并集成。
--- a/package-lock.json
+++ b/package-lock.json
@@ -8,6 +8,8 @@
      "name": "devflow",
      "version": "0.1.0",
      "dependencies": {
+        "@antv/x6": "^3.1.7",
+        "@antv/x6-vue-shape": "^3.0.2",
        "@arco-design/web-vue": "^2.58.0",
        "@tauri-apps/api": "^2",
        "@tauri-apps/plugin-dialog": "^2.7.1",
@@ -27,6 +29,66 @@
        "vue-tsc": "^2.2.0"
      }
    },
+    "node_modules/@antv/x6": {
+      "version": "3.1.7",
+      "resolved": "https://registry.npmmirror.com/@antv/x6/-/x6-3.1.7.tgz",
+      "integrity": "sha512-NLKXtbCK51oLbazfFD0XsD93rMmih08UBW4gAuEyLBpwAqHmHe+vP8VhOZDkl5O9jV1LSv85IJghr9CT5tZjWw==",
+      "license": "MIT",
+      "dependencies": {
+        "dom-align": "^1.12.4",
+        "lodash-es": "^4.17.15",
+        "mousetrap": "^1.6.5",
+        "utility-types": "^3.10.0"
+      },
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/@antv/x6-vue-shape": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmmirror.com/@antv/x6-vue-shape/-/x6-vue-shape-3.0.2.tgz",
+      "integrity": "sha512-HWnYFvLCaUD9ernINxTn9vCRj66eG/nXKErSSq0hfI4U1HOitC/1oUrzDdwL/BT80HKAQeSsmy7gpDA/79jYlw==",
+      "license": "MIT",
+      "dependencies": {
+        "vue-demi": "latest"
+      },
+      "peerDependencies": {
+        "@antv/x6": "^3.x",
+        "@vue/composition-api": "^1.0.0-rc.1",
+        "vue": "^2.0.0 || >=3.0.0"
+      },
+      "peerDependenciesMeta": {
+        "@vue/composition-api": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@antv/x6-vue-shape/node_modules/vue-demi": {
+      "version": "0.14.10",
+      "resolved": "https://registry.npmmirror.com/vue-demi/-/vue-demi-0.14.10.tgz",
+      "integrity": "sha512-nMZBOwuzabUO0nLgIcc6rycZEebF6eeUfaiQx9+WSk8e29IbLvPU9feI6tqW4kTo3hvoYAJkMh8n8D0fuISphg==",
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "vue-demi-fix": "bin/vue-demi-fix.js",
+        "vue-demi-switch": "bin/vue-demi-switch.js"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/antfu"
+      },
+      "peerDependencies": {
+        "@vue/composition-api": "^1.0.0-rc.1",
+        "vue": "^3.0.0-0 || ^2.6.0"
+      },
+      "peerDependenciesMeta": {
+        "@vue/composition-api": {
+          "optional": true
+        }
+      }
+    },
    "node_modules/@arco-design/color": {
      "version": "0.4.0",
      "resolved": "https://registry.npmmirror.com/@arco-design/color/-/color-0.4.0.tgz",
@@ -1486,6 +1548,12 @@
      "dev": true,
      "license": "MIT"
    },
+    "node_modules/dom-align": {
+      "version": "1.12.4",
+      "resolved": "https://registry.npmmirror.com/dom-align/-/dom-align-1.12.4.tgz",
+      "integrity": "sha512-R8LUSEay/68zE5c8/3BDxiTEvgb4xZTF0RKmAHfiEVN3klfIpXfi2/QCoiWPccVQ0J/ZGdz9OjzL4uJEP/MRAw==",
+      "license": "MIT"
+    },
    "node_modules/dompurify": {
      "version": "3.4.10",
      "resolved": "https://registry.npmmirror.com/dompurify/-/dompurify-3.4.10.tgz",
@@ -1613,6 +1681,12 @@
      "integrity": "sha512-m6UrgzFVUYawGBh1dUsWR5M2Clqic9RVXC/9f8ceNlv2IcO9j9J/z8UoCLPqtsPBFNzEpfR3xftohbfqDx8EQA==",
      "license": "MIT"
    },
+    "node_modules/lodash-es": {
+      "version": "4.18.1",
+      "resolved": "https://registry.npmmirror.com/lodash-es/-/lodash-es-4.18.1.tgz",
+      "integrity": "sha512-J8xewKD/Gk22OZbhpOVSwcs60zhd95ESDwezOFuA3/099925PdHJ7OFHNTGtajL3AlZkykD32HykiMo+BIBI8A==",
+      "license": "MIT"
+    },
    "node_modules/magic-string": {
      "version": "0.30.21",
      "resolved": "https://registry.npmmirror.com/magic-string/-/magic-string-0.30.21.tgz",
@@ -1650,6 +1724,12 @@
        "url": "https://github.com/sponsors/isaacs"
      }
    },
+    "node_modules/mousetrap": {
+      "version": "1.6.5",
+      "resolved": "https://registry.npmmirror.com/mousetrap/-/mousetrap-1.6.5.tgz",
+      "integrity": "sha512-QNo4kEepaIBwiT8CDhP98umTetp+JNfQYBWvC1pc6/OAibuXtRcxZ58Qz8skvEHYvURne/7R8T5VoOI7rDsEUA==",
+      "license": "Apache-2.0 WITH LLVM-exception"
+    },
    "node_modules/muggle-string": {
      "version": "0.4.1",
      "resolved": "https://registry.npmmirror.com/muggle-string/-/muggle-string-0.4.1.tgz",
@@ -1844,6 +1924,15 @@
        "node": ">=14.17"
      }
    },
+    "node_modules/utility-types": {
+      "version": "3.11.0",
+      "resolved": "https://registry.npmmirror.com/utility-types/-/utility-types-3.11.0.tgz",
+      "integrity": "sha512-6Z7Ma2aVEWisaL6TvBCy7P8rm2LQoPv6dJ7ecIaIixHcwfbJ0x7mWdbcwlIM5IGQxPZSFYeqRCqlOOeKoJYMkw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 4"
+      }
+    },
    "node_modules/vite": {
      "version": "6.4.3",
      "resolved": "https://registry.npmmirror.com/vite/-/vite-6.4.3.tgz",
--- a/package.json
+++ b/package.json
@@ -13,12 +13,15 @@
    "build:dev": "tauri build --debug --no-bundle"
  },
  "dependencies": {
+    "@antv/x6": "^3.1.7",
+    "@antv/x6-vue-shape": "^3.0.2",
    "@arco-design/web-vue": "^2.58.0",
    "@tauri-apps/api": "^2",
    "@tauri-apps/plugin-dialog": "^2.7.1",
    "dompurify": "^3.4.10",
    "highlight.js": "^11.11.1",
    "marked": "^18.0.5",
+    "tslib": "^2.8.1",
    "vue": "^3.5.13",
    "vue-i18n": "9",
    "vue-router": "4"
--- a/src/components/dev/X6Demo.vue
+++ b/src/components/dev/X6Demo.vue
@@ -0,0 +1,185 @@
+<template>
+  <div class="x6-demo">
+    <div class="x6-demo__header">
+      <h2>AntV X6 v3 Phase 0 验证</h2>
+      <div class="x6-demo__status">
+        <span :class="['x6-demo__badge', status]">{{ statusText }}</span>
+        <a-button size="mini" @click="rebuild">重建画布</a-button>
+        <a-button size="mini" @click="exportData">导出 JSON</a-button>
+      </div>
+    </div>
+    <div ref="containerRef" class="x6-demo__canvas" />
+    <div class="x6-demo__log">
+      <div v-for="(log, i) in logs" :key="i" class="x6-demo__log-line">[{{ log.t }}] {{ log.msg }}</div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { onMounted, onBeforeUnmount, ref, reactive } from 'vue'
+import { Graph } from '@antv/x6'
+// v3: 插件全部从核心包内置导出（不再需要 @antv/x6-plugin-* 独立包）
+import { Selection, Snapline, History, MiniMap, Scroller } from '@antv/x6'
+
+const containerRef = ref<HTMLElement | null>(null)
+const status = ref<'pending' | 'ok' | 'fail'>('pending')
+const statusText = ref('初始化中...')
+const logs = reactive<{ t: string; msg: string }[]>([])
+
+let graph: Graph | null = null
+
+function log(msg: string) {
+  const now = new Date().toLocaleTimeString('zh-CN', { hour12: false })
+  logs.unshift({ t: now, msg })
+  if (logs.length > 20) logs.pop()
+}
+
+function buildGraph() {
+  if (!containerRef.value) return
+  log('开始创建 Graph 实例 (X6 v3)')
+
+  graph = new Graph({
+    container: containerRef.value,
+    background: { color: '#F2F7FA' },
+    grid: { visible: true, size: 10 },
+    mousewheel: { enabled: true, modifiers: ['ctrl'], minScale: 0.5, maxScale: 2 },
+  })
+
+  // v3: 插件通过 graph.use() 注册，类从核心包导入
+  graph.use(new Selection({ enabled: true, rubberband: true }))
+  log('✅ Selection 插件（框选）注册成功')
+
+  graph.use(new Snapline({ enabled: true }))
+  log('✅ Snapline 插件（对齐线）注册成功')
+
+  graph.use(new History({ enabled: true }))
+  log('✅ History 插件（撤销重做）注册成功')
+
+  graph.use(new Scroller({ enabled: true, pannable: true }))
+  log('✅ Scroller 插件（画布滚动）注册成功')
+
+  graph.use(new MiniMap({ width: 200, height: 120 }))
+  log('✅ MiniMap 插件（小地图）注册成功')
+
+  // 渲染节点 + 边（模拟 DevFlow 多工程依赖图）
+  graph.fromJSON({
+    nodes: [
+      { id: 'devflow', shape: 'rect', x: 80, y: 80, width: 140, height: 48,
+        label: 'DevFlow\n(Tauri+Vue3)', attrs: { body: { fill: '#e8f3ff', stroke: '#165dff' } } },
+      { id: 'df-types', shape: 'rect', x: 320, y: 40, width: 120, height: 40,
+        label: 'df-types', attrs: { body: { fill: '#fff7e8', stroke: '#ff7d00' } } },
+      { id: 'df-storage', shape: 'rect', x: 320, y: 120, width: 120, height: 40,
+        label: 'df-storage', attrs: { body: { fill: '#fff7e8', stroke: '#ff7d00' } } },
+      { id: 'df-ai', shape: 'rect', x: 540, y: 80, width: 120, height: 40,
+        label: 'df-ai', attrs: { body: { fill: '#e8ffea', stroke: '#00b42a' } } },
+    ],
+    edges: [
+      { source: 'devflow', target: 'df-types', labels: [{ text: '类库' }] },
+      { source: 'devflow', target: 'df-storage', labels: [{ text: '类库' }] },
+      { source: 'df-storage', target: 'df-ai', labels: [{ text: '依赖' }] },
+    ],
+  })
+  log('✅ 渲染 4 节点 + 3 边（DevFlow 依赖图 mock）')
+
+  // 事件验证
+  graph.on('node:click', ({ node }) => {
+    log(`🖱️ 节点点击: ${node.id}`)
+  })
+  graph.on('blank:click', () => {
+    log('🖱️ 空白处点击')
+  })
+
+  status.value = 'ok'
+  statusText.value = '渲染成功'
+  log('🎉 Phase 0 验证通过：X6 v3 在当前环境正常工作')
+}
+
+function rebuild() {
+  if (graph) {
+    graph.dispose()
+    log('画布已销毁，重建中...')
+  }
+  status.value = 'pending'
+  statusText.value = '重建中'
+  setTimeout(buildGraph, 100)
+}
+
+function exportData() {
+  if (!graph) return
+  const json = graph.toJSON()
+  log(`📤 导出 JSON: ${JSON.stringify(json).slice(0, 80)}...`)
+  console.log('X6 graph JSON:', json)
+}
+
+onMounted(() => {
+  try {
+    buildGraph()
+  } catch (e) {
+    status.value = 'fail'
+    statusText.value = '验证失败'
+    log(`❌ 错误: ${e instanceof Error ? e.message : String(e)}`)
+    console.error(e)
+  }
+})
+
+onBeforeUnmount(() => {
+  if (graph) {
+    graph.dispose()
+    graph = null
+    log('画布已销毁（组件卸载）')
+  }
+})
+</script>
+
+<style scoped>
+.x6-demo {
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+  padding: 16px;
+  gap: 12px;
+}
+.x6-demo__header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+.x6-demo__header h2 {
+  margin: 0;
+  font-size: 16px;
+}
+.x6-demo__status {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+.x6-demo__badge {
+  padding: 2px 10px;
+  border-radius: 10px;
+  font-size: 12px;
+  font-weight: 500;
+}
+.x6-demo__badge.pending { background: #fff7e8; color: #ff7d00; }
+.x6-demo__badge.ok { background: #e8ffea; color: #00b42a; }
+.x6-demo__badge.fail { background: #ffece8; color: #f53f3f; }
+.x6-demo__canvas {
+  flex: 1;
+  min-height: 400px;
+  border: 1px solid #e5e6eb;
+  border-radius: 4px;
+  overflow: hidden;
+}
+.x6-demo__log {
+  height: 120px;
+  overflow-y: auto;
+  background: #1d2129;
+  border-radius: 4px;
+  padding: 8px 12px;
+  font-family: 'Consolas', monospace;
+  font-size: 12px;
+}
+.x6-demo__log-line {
+  color: #c9cdd4;
+  line-height: 1.6;
+}
+</style>
--- a/src/components/project/DependencyGraph.vue
+++ b/src/components/project/DependencyGraph.vue
@@ -0,0 +1,224 @@
+<template>
+  <div class="dep-graph">
+    <div class="dep-graph__toolbar">
+      <span class="dep-graph__title">{{ $t('dependencyGraph.title') }}</span>
+      <div class="dep-graph__actions">
+        <button class="btn btn-ghost btn-sm" @click="fitContent">适应内容</button>
+        <button class="btn btn-ghost btn-sm" @click="zoomIn">+</button>
+        <button class="btn btn-ghost btn-sm" @click="zoomOut">-</button>
+      </div>
+    </div>
+    <div ref="containerRef" class="dep-graph__canvas" />
+    <div v-if="modules.length === 0 && !loading" class="dep-graph__empty">
+      <div class="empty-icon">📦</div>
+      <div>{{ $t('dependencyGraph.empty') }}</div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+/**
+ * 依赖关系图组件 — 基于 AntV X6 v3 + vue-shape。
+ *
+ * 节点用 Vue 组件(ModuleNode.vue)渲染,通过 @antv/x6-vue-shape 注册。
+ */
+import { onMounted, onBeforeUnmount, ref, watch, markRaw } from 'vue'
+import { Graph, Selection, Snapline, History, Scroller } from '@antv/x6'
+import '@antv/x6-vue-shape'
+import { moduleApi, type ProjectModuleRecord } from '@/api/module'
+import ModuleNode from './ModuleNode.vue'
+
+const props = defineProps<{
+  projectId: string
+}>()
+
+const emit = defineEmits<{
+  (e: 'select-module', moduleId: string): void
+}>()
+
+const containerRef = ref<HTMLElement | null>(null)
+const modules = ref<ProjectModuleRecord[]>([])
+const loading = ref(true)
+let graph: Graph | null = null
+
+async function loadModules() {
+  loading.value = true
+  try {
+    modules.value = await moduleApi.listProjectModules(props.projectId)
+  } catch {
+    modules.value = []
+  } finally {
+    loading.value = false
+  }
+}
+
+function renderGraph() {
+  if (!graph) return
+
+  const cols = 3
+  const nodeWidth = 200
+  const nodeHeight = 80
+  const gapX = 50
+  const gapY = 40
+
+  const nodes = modules.value.map((m, i) => {
+    const col = i % cols
+    const row = Math.floor(i / cols)
+    return {
+      id: m.id,
+      shape: 'vue-shape',
+      x: col * (nodeWidth + gapX) + 40,
+      y: row * (nodeHeight + gapY) + 40,
+      width: nodeWidth,
+      height: nodeHeight,
+      component: markRaw(ModuleNode),
+      data: {
+        name: m.name,
+        path: m.path,
+        stack: m.stack,
+        gitUrl: m.git_url,
+      },
+    }
+  })
+
+  // 边暂为空(module_dependencies 表未建)
+  graph.fromJSON({ nodes, edges: [] })
+  graph.centerContent()
+}
+
+function buildGraph() {
+  if (!containerRef.value) return
+
+  graph = new Graph({
+    container: containerRef.value,
+    background: { color: '#1a1a2e' },
+    grid: { visible: true, size: 10, type: 'dot', args: { color: '#2a2a4e' } },
+    mousewheel: { enabled: true, modifiers: ['ctrl'], minScale: 0.3, maxScale: 3 },
+    interacting: { nodeMovable: true },
+  })
+
+  graph.use(new Selection({ enabled: true, rubberband: true }))
+  graph.use(new Snapline({ enabled: true }))
+  graph.use(new History({ enabled: true }))
+  graph.use(new Scroller({ enabled: true, pannable: true }))
+
+  graph.on('node:click', ({ node }) => {
+    emit('select-module', String(node.id))
+  })
+
+  renderGraph()
+}
+
+function fitContent() {
+  graph?.zoomToFit({ padding: 20, maxScale: 1.5 })
+}
+
+function zoomIn() {
+  graph?.zoom(0.1)
+}
+
+function zoomOut() {
+  graph?.zoom(-0.1)
+}
+
+onMounted(async () => {
+  await loadModules()
+  buildGraph()
+})
+
+watch(() => props.projectId, async () => {
+  await loadModules()
+  renderGraph()
+})
+
+onBeforeUnmount(() => {
+  if (graph) {
+    graph.dispose()
+    graph = null
+  }
+})
+</script>
+
+<style scoped>
+.dep-graph {
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+  background: var(--df-bg);
+  border: 0.5px solid var(--df-border);
+  border-radius: var(--df-radius-lg, 8px);
+  overflow: hidden;
+  position: relative;
+}
+
+.dep-graph__toolbar {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 8px 14px;
+  border-bottom: 0.5px solid var(--df-border);
+  background: var(--df-bg-card);
+  flex-shrink: 0;
+}
+
+.dep-graph__title {
+  font-size: 14px;
+  font-weight: 500;
+  color: var(--df-text);
+}
+
+.dep-graph__actions {
+  display: flex;
+  gap: 6px;
+}
+
+.dep-graph__canvas {
+  flex: 1;
+  min-height: 300px;
+  overflow: hidden;
+}
+
+.dep-graph__empty {
+  position: absolute;
+  top: 50%;
+  left: 50%;
+  transform: translate(-50%, -50%);
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 10px;
+  color: var(--df-text-dim);
+  font-size: 13px;
+  pointer-events: none;
+}
+
+.empty-icon {
+  font-size: 32px;
+  opacity: 0.4;
+}
+
+.btn {
+  padding: 4px 12px;
+  border: none;
+  border-radius: var(--df-radius-sm, 4px);
+  font-size: 12px;
+  cursor: pointer;
+  transition: all 0.15s;
+}
+
+.btn-ghost {
+  background: transparent;
+  color: var(--df-text-secondary);
+  border: 0.5px solid var(--df-border);
+}
+
+.btn-ghost:hover {
+  background: var(--df-bg);
+  color: var(--df-text);
+}
+
+.btn-sm {
+  padding: 4px 10px;
+  font-size: 11px;
+}
+</style>
--- a/src/components/project/ModuleNode.vue
+++ b/src/components/project/ModuleNode.vue
@@ -0,0 +1,98 @@
+<template>
+  <div class="module-node" :class="{ active: selected }">
+    <div class="module-node__header">
+      <span class="module-node__icon">📦</span>
+      <span class="module-node__name">{{ data.name }}</span>
+    </div>
+    <div class="module-node__path">{{ shortPath }}</div>
+    <div v-if="stackList.length" class="module-node__tags">
+      <span v-for="s in stackList" :key="s" class="module-node__tag">{{ s }}</span>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { computed } from 'vue'
+
+const props = defineProps<{
+  data: {
+    name: string
+    path: string
+    stack: string | null
+    gitUrl: string | null
+  }
+  selected?: boolean
+}>()
+
+const shortPath = computed(() => {
+  const p = props.data?.path || ''
+  if (p.length <= 32) return p
+  return '...' + p.slice(-29)
+})
+
+const stackList = computed(() => {
+  if (!props.data?.stack) return []
+  try {
+    const parsed = JSON.parse(props.data.stack)
+    return Array.isArray(parsed) ? parsed.slice(0, 3) : []
+  } catch {
+    return []
+  }
+})
+</script>
+
+<style scoped>
+.module-node {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 8px 12px;
+  width: 100%;
+  height: 100%;
+  box-sizing: border-box;
+  background: #16213e;
+  border: 1px solid #0f3460;
+  border-radius: 6px;
+  cursor: pointer;
+  transition: border-color 0.15s;
+}
+.module-node.active {
+  border-color: #5378e8;
+  box-shadow: 0 0 0 2px rgba(83, 120, 232, 0.3);
+}
+.module-node__header {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+}
+.module-node__icon {
+  font-size: 14px;
+}
+.module-node__name {
+  font-size: 13px;
+  font-weight: 600;
+  color: #e0e0e0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.module-node__path {
+  font-size: 10px;
+  color: #888;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.module-node__tags {
+  display: flex;
+  gap: 4px;
+  flex-wrap: wrap;
+}
+.module-node__tag {
+  font-size: 9px;
+  padding: 1px 6px;
+  border-radius: 3px;
+  background: rgba(83, 120, 232, 0.15);
+  color: #7c9aff;
+}
+</style>
--- a/src/i18n/en/dependencyGraph.ts
+++ b/src/i18n/en/dependencyGraph.ts
@@ -0,0 +1,7 @@
+export default {
+  dependencyGraph: {
+    title: 'Dependency Graph',
+    empty: 'No modules yet, please add a module first',
+    tabTitle: '🔗 Dependencies',
+  },
+}
--- a/src/i18n/zh-CN/dependencyGraph.ts
+++ b/src/i18n/zh-CN/dependencyGraph.ts
@@ -0,0 +1,7 @@
+export default {
+  dependencyGraph: {
+    title: '依赖关系图',
+    empty: '暂无工程,请先添加工程',
+    tabTitle: '🔗 依赖图',
+  },
+}
--- a/src/router/index.ts
+++ b/src/router/index.ts
@@ -65,6 +65,12 @@ const routes = [
    component: () => import('../views/AuditLog.vue'),
    meta: { title: '审批历史' },
  },
+  {
+    path: '/dev/x6',
+    name: 'X6Demo',
+    component: () => import('../components/dev/X6Demo.vue'),
+    meta: { title: 'X6 v3 验证' },
+  },
  {
    path: '/settings',
    name: 'Settings',
--- a/src/views/ProjectDetail.vue
+++ b/src/views/ProjectDetail.vue
@@ -58,6 +58,14 @@
      >
        {{ $t('fileExplorer.tabTitle') }}
      </button>
+      <button
+        class="tab-btn"
+        :class="{ 'tab-active': activeTab === 'graph' }"
+        type="button"
+        @click="activeTab = 'graph'"
+      >
+        {{ $t('dependencyGraph.tabTitle') }}
+      </button>
    </nav>

    <!-- 文件浏览器 Tab -->
@@ -65,6 +73,11 @@
      <FileExplorer :project-id="projectId" />
    </section>

+    <!-- 依赖图 Tab -->
+    <section v-else-if="activeTab === 'graph'" class="file-explorer-wrap">
+      <DependencyGraph :project-id="projectId" />
+    </section>
+
    <!-- 概览 Tab:原有主体两栏 -->
    <div v-else class="detail-grid">
      <!-- 左栏：项目信息 -->
@@ -258,6 +271,7 @@ import { projectStatusLabel, taskStatusLabel, taskStatusClass } from '../constan
 import ConfirmDialog from '@/components/ConfirmDialog.vue'
 import ApprovalDialog from '@/components/project/ApprovalDialog.vue'
 import FileExplorer from '@/components/project/FileExplorer.vue'
+import DependencyGraph from '@/components/project/DependencyGraph.vue'
 import { useConfirm } from '@/composables/useConfirm'
 import { useRendered } from '@/composables/useMarkdown'

@@ -270,7 +284,7 @@ const showApprovalDialog = ref(false)
 let unlisten: (() => void) | null = null

 // Tab 导航:概览(项目信息/任务/工作流日志) vs 文件浏览器(Batch 10)。
-const activeTab = ref<'overview' | 'files'>('overview')
+const activeTab = ref<'overview' | 'files' | 'graph'>('overview')

 // 确认弹层状态机抽至 composables/useConfirm(原 4 视图重复:Projects/ProjectDetail/Ideas/Settings)
 const { confirmState, confirmDialog, answerConfirm } = useConfirm()