| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106 |
- // 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"];
- }
|