// pi agent 迁移切片与验收门 // 场景技能: architecture-visualization:evolution-planner // 格式技能: architecture-visualization:graphviz // 生成日期: 2026-11-10 // 回答的问题: 迁移怎么切片、每片验收什么、哪片不可逆、两条轨道如何并行 // 证据与置信度: docs/design/pi-agent-feasibility.md §2 §7 // 状态: 全部 target/slice 节点均为 proposed,未实施 // 重新生成: 手工维护本文件;dot -Tsvg pi-agent-migration.dot -o pi-agent-migration.svg digraph pi_migration { rankdir=TB; compound=true; fontname="Helvetica"; node [fontname="Helvetica", fontsize=11, shape=box, style="rounded,filled", fillcolor="#ffffff"]; edge [fontname="Helvetica", fontsize=9]; // ===== 现状(有证据,非 proposed)===== subgraph cluster_current { label="现状 current(本机实测证据)"; style="rounded,dashed"; color="#888888"; fontsize=12; cur_agentscope [label="AgentScope 编排层\nmodule/agent 28 子目录\n45 文件 import io.agentscope", fillcolor="#eeeeee"]; cur_shared [label="共用承重件\nllm / rag / AgentModelFactory\nattachment / RagVectorMapper", fillcolor="#fff3cd"]; cur_consumers [label="非 agent 消费方\nAI清洗模板匹配+向量索引\n上传文件识别 / 知识库索引\n删案清理", fillcolor="#eeeeee"]; cur_vue [label="前端 src/ai(Vue3)\naiWorkbench / aiPlugin / aiModel\n+ src/graph/insight", fillcolor="#eeeeee"]; cur_snapshot [label="副本机制(保留)\nDuckdbSnapshot.export\nCaseDataSourceRegistry:244", fillcolor="#d4edda"]; cur_python [label="自带解释器(实测)\nPython 3.14.10 + duckdb 1.5.6", fillcolor="#d4edda"]; cur_shared -> cur_agentscope [label="同模块内", style=dashed]; cur_consumers -> cur_shared [label="依赖(删除会打断)", color="#cc0000"]; } // ===== 轨道 A:前端 / 载体 ===== subgraph cluster_track_a { label="轨道 A · 新能力(proposed,可回退)"; style="rounded"; color="#0d6efd"; fontsize=12; s0 [label="S0 可行性验证\n零改动 · 仓库外手工实验\npi --mode rpc + AGENTS.md + .pi/skills", fillcolor="#cfe2ff"]; g0 [label="验收门 G0\n表名与 PG 登记一致 / trust 不阻断\n原库打不开(预期)/ agent_settled 可判定", shape=ellipse, fillcolor="#e2f0d9"]; decide [label="G0 通过?", shape=diamond, fillcolor="#fff3cd"]; fallback [label="停止:回 dsh 方案\n或维持现状", fillcolor="#f8d7da"]; s1 [label="S1 Electron 载体 + Vue agent 窗口\n新 piWindow service(不复用 /workbench 单例)\nspawn + JSONL + id 关联 + 对话框桥", fillcolor="#cfe2ff"]; g1 [label="验收门 G1\n两窗口互不影响 / 崩溃重建\nextension_ui_request→Vue→response 回包", shape=ellipse, fillcolor="#e2f0d9"]; s2 [label="S2 案件工作区端点\nPOST /case/pi-workspace(新增 controller)\n副本 + schema.json + 技能迁移", fillcolor="#cfe2ff"]; g2 [label="验收门 G2\ncaseId+userId 隔离 / 指纹刷新\n导出失败不回退原库", shape=ellipse, fillcolor="#e2f0d9"]; s3 [label="S3 双模式 + 只读工具集 + 审批 extension\n数据分析 / 通用办公", fillcolor="#cfe2ff"]; g3 [label="验收门 G3\n办公模式无案件工具 / 写操作被 block\n越界写被拦 / 审批超时按拒绝", shape=ellipse, fillcolor="#e2f0d9"]; s0 -> g0; g0 -> decide; decide -> fallback [label="否", color="#cc0000"]; decide -> s1 [label="是"]; s1 -> g1 -> s2 -> g2 -> s3 -> g3; } // ===== 轨道 B:后端退役(与 pi/dsh 选择无关)===== subgraph cluster_track_b { label="轨道 B · 后端退役 AgentScope(proposed,可与轨道 A 并行)"; style="rounded"; color="#6f42c1"; fontsize=12; s4 [label="S4 抽出共用件到中立模块\ncommon/llm · common/embedding\ncommon/model · common/docindex\n前端模型管理页抽出", fillcolor="#e2d9f3"]; g4 [label="验收门 G4\n行为不变:清洗侧只改 import\n录制 payload 逐条回放对齐", shape=ellipse, fillcolor="#e2f0d9"]; s5 [label="S5 脱 AgentScope(最高风险)\nJava 自研 LLM 流式传输 + embedding 三家适配\npi 不解决此片(无 embedding / 无 JVM 绑定)", fillcolor="#e2d9f3"]; g5 [label="验收门 G5\npayload 逐条等价(非跑通即过)\n单并发闸门 + 180s 超时重试不变\npgvector 召回一致", shape=ellipse, fillcolor="#e2f0d9"]; s6 [label="S6 删除(不可逆)\n编排层 + insight(25) + 前端聊天 UI\n+ 表 + pom 依赖 + 配置段 + 58 测试\n连带清 CaseDataCleanup / detachKnowledgeBase", fillcolor="#f8d7da", color="#cc0000", penwidth=2]; g6 [label="验收门 G6\n全量编译 + 测试全绿 / 删案无残留\n/workbench 经 guard:69 重定向新窗口", shape=ellipse, fillcolor="#e2f0d9"]; s4 -> g4 -> s5 -> g5 -> s6 -> g6; } // ===== 目标态 ===== subgraph cluster_target { label="目标态 target(proposed,未实施)"; style="rounded,dashed"; color="#198754"; fontsize=12; tgt_window [label="agent 窗口 Vue(自建)\n独立顶层 BrowserWindow\n案件选择器 + 模式切换 + 审批对话框", fillcolor="#d1e7dd"]; tgt_pi [label="pi 子进程(headless)\n--mode rpc --no-session\ncwd/sessionDir = cases/{id}/ai/pi/{userId}", fillcolor="#d1e7dd"]; tgt_ws [label="案件工作区\nAGENTS.md + .pi/skills + .pi/extensions\ndata/case.duckdb(副本)+ schema.json + outputs", fillcolor="#d1e7dd"]; tgt_server [label="ai-server(保留)\n副本导出 + PG 元数据 + 模型配置\ncommon/llm + common/embedding(已脱 AgentScope)", fillcolor="#d1e7dd"]; tgt_biz [label="既有业务不回归\n清洗 / 上传 / 知识库 / 图谱(去研判)", fillcolor="#d1e7dd"]; tgt_window -> tgt_pi [label="IPC → JSONL stdin/stdout"]; tgt_pi -> tgt_ws [label="read/bash/powershell 只读副本"]; tgt_ws -> tgt_server [label="副本由持锁进程导出"]; tgt_pi -> tgt_server [label="模型配置 / 元数据"]; } // ===== 跨簇依赖 ===== cur_snapshot -> s2 [label="复用既有 exportSnapshot", style=dashed, color="#198754"]; cur_python -> s0 [label="S0 实测调起", style=dashed, color="#198754"]; cur_shared -> s4 [label="抽出对象", style=dashed, color="#6f42c1"]; cur_vue -> s6 [label="删除对象(模型管理页除外)", style=dashed, color="#cc0000"]; cur_agentscope -> s6 [label="删除对象", style=dashed, color="#cc0000"]; g3 -> tgt_window [label="交付", style=dashed, color="#198754"]; g6 -> tgt_server [label="交付", style=dashed, color="#198754"]; g3 -> s6 [label="前置:S0–S5 全验收通过\n才允许不可逆删除", color="#cc0000", style=bold]; g5 -> s6 [label="前置", color="#cc0000"]; // ===== 待验证未知(不画成确定路径)===== unknown [label="Unknown · 需 S0 收口\nWindows+Electron spawn 行为 / project trust 判定\n模式切换能否不 respawn / RPC 完整命令集\n既有 SKILL.md frontmatter 兼容性", shape=note, fillcolor="#f5f5f5", color="#888888"]; s0 -> unknown [label="暴露", style=dotted, color="#888888"]; }