|
|
@@ -0,0 +1,218 @@
|
|
|
+# pi agent 底座可行性分析
|
|
|
+
|
|
|
+> 场景技能:`architecture-visualization:evolution-planner`;图源格式:`architecture-visualization:graphviz`
|
|
|
+> 状态:**决策稿,未实施**。目标态节点全部标注 proposed。
|
|
|
+> 日期:2026-11-10 | 配套图源:`docs/design/pi-agent-migration.dot`
|
|
|
+
|
|
|
+## 1. 结论
|
|
|
+
|
|
|
+**可行,且比 dsh 更贴合「二开一套」这个诉求**——但形态与 dsh 方案根本不同:
|
|
|
+
|
|
|
+- **dsh 路线**:加载 dsh 自带的 Web UI,我们写 **React** 插件塞进它的界面。UI 白送,定制受它的插槽/版本约束。
|
|
|
+- **pi 路线**:pi 作为 **headless 子进程**,我们**自己写 Vue agent 窗口**,经 stdio JSONL RPC 驱动。UI 全部自建,但完全掌控、且与既有 Vue3 技术栈一致。
|
|
|
+
|
|
|
+pi 的 RPC 文档开篇即写明用途:「language-independent integrations, process isolation, IDEs, and **custom user interfaces**」(`packages/coding-agent/docs/rpc.md`)。我们要做的正是官方指定场景,不是 hack。
|
|
|
+
|
|
|
+**推荐**:选 pi 做底座,接受「自建 agent 窗口 UI」这一最大成本项。理由是它同时满足四个硬条件:MIT 无商标约束、Windows 原生支持、扩展点是 TypeScript + SKILL.md(与既有资产同构)、核心极小(agent-core 仅 6 个源文件)。
|
|
|
+
|
|
|
+**但必须明确**:换 pi **不能**解决后端退役 AgentScope 的两个难题(embedding 与 Java 侧 LLM 传输),详见 §6。后端清理与选 pi 还是 dsh 无关,可并行推进。
|
|
|
+
|
|
|
+## 2. 证据与置信度
|
|
|
+
|
|
|
+所有 pi 侧结论取自 `earendil-works/pi` **main 分支原始文件**(注意:文档在 `packages/coding-agent/docs/`,**根 `docs/` 不存在**)。
|
|
|
+
|
|
|
+| 事实 | 证据 | 置信度 |
|
|
|
+|---|---|---|
|
|
|
+| MIT、TypeScript、121,112 stars、pushed 2026-11-10 | GitHub API `/repos/earendil-works/pi` | high(本机实测) |
|
|
|
+| `badlogic/pi-mono` 已迁移至同一 repo | GitHub API 301 → repo id 1035029907 | high(子代理实测) |
|
|
|
+| RPC = 长驻子进程 + stdin/stdout JSONL,四族记录,可选 `id` 关联 | `packages/coding-agent/docs/rpc.md` | high(本机实测) |
|
|
|
+| 启动式 `pi --mode rpc --no-session`;TS 侧有导出 `RpcClient`;进程内集成用 SDK | 同上 + `docs/sdk.md` | high |
|
|
|
+| 对话框子协议:`select/confirm/input/editor` → `extension_ui_request`,回 `extension_ui_response`(匹配 id),可带 timeout 由 agent 侧自动兜底 | `docs/rpc-extension-ui.md` | high(本机实测) |
|
|
|
+| RPC 下 `custom()` 返回 undefined、`setTheme()` 失败、footer/header/autocomplete/editor component 全 no-op | 同上 | high(本机实测) |
|
|
|
+| **无内置权限/审批系统** | 根 `README.md:90`「Pi does not include a built-in permission system for restricting filesystem, process, network, or credential access」 | high(本机实测) |
|
|
|
+| **无 sub-agents / plan mode** | 根 `README.md:19` | high(本机实测) |
|
|
|
+| **pi-ai 无 embedding**:`ModelTypeMap` 只有 `chat / image / classifier` | `packages/ai/src/types.ts:915-919` | high(本机实测) |
|
|
|
+| `createReadOnlyTools()` 存在;`ToolName` 含 `powershell` | `packages/coding-agent/src/core/tools/index.ts:204`、`:95` | high(本机实测) |
|
|
|
+| Windows 原生默认 Git Bash,可选 `powershell` 工具;解析序 `shellPath` → `%ProgramFiles%\Git\bin\bash.exe` → … | `docs/windows.md` | high(本机实测) |
|
|
|
+| 读 `AGENTS.md` / `CLAUDE.md` / `AGENTS.override.md`,来自 agent 目录、cwd 及其父目录 | `docs/configuration.md:18,41-45` | high(本机实测) |
|
|
|
+| **先解析 project trust 再加载项目设置与资源** | `docs/how-pi-works.md:49` | high(本机实测) |
|
|
|
+| 项目技能目录 `.pi/skills/`;实现 agentskills.io 规范;另支持 `~/.agents/skills/`、`.agents/skills/`(从 cwd 向祖先找至 repo 根) | `docs/configuration.md:35`、`docs/skills.md:7,61` | high(本机实测) |
|
|
|
+| agent-core `src/` 仅 6 文件(agent-loop/agent/types/proxy/stream-fn/index) | GitHub contents API | high(本机实测) |
|
|
|
+| `apps/p2` 标注 EXPERIMENTAL、「Do not build on it」 | `apps/p2/README.md` 顶部 WARNING | high(本机实测) |
|
|
|
+| v1.5.1(2026-11-09)、lockstep 版本、约周更 | GitHub `/releases` | medium(子代理实测,本人未复核) |
|
|
|
+| pi-web-ui 已删(曾为 Lit3 组件库,非可启动应用);pi-proxy 已删(曾为 CORS 转发器,非 LLM 网关) | commit `b141e1fa24`、`0f98decf65`;npm registry | medium(子代理实测) |
|
|
|
+| **零 Office 能力**(含官方 `badlogic/pi-skills` 集合) | 子代理全树检索 | medium(本人未独立复核) |
|
|
|
+| MCP 支持 stdio + streamable HTTP,**明确拒绝 legacy SSE** | `docs/mcp.md` | medium(子代理实测) |
|
|
|
+| extensions 为 TS 模块,`~/.pi/agent/extensions/` 或 `.pi/extensions/`,`/reload` 热重载 | `docs/extensions.md` | medium(子代理实测) |
|
|
|
+| 会话为 JSONL 树,`--session-dir` / `PI_CODING_AGENT_SESSION_DIR` 可改;workspace 概念 = cwd | `docs/session-format.md`、`docs/sdk.md` | medium(子代理实测) |
|
|
|
+| 新贡献者 issue/PR 默认自动关闭,需 maintainer `lgtm` | `CONTRIBUTING.md` | medium(子代理实测) |
|
|
|
+
|
|
|
+本仓侧结论均为本机 grep/读文件实测,路径行号见各节。
|
|
|
+
|
|
|
+## 3. 现状(current,有证据)
|
|
|
+
|
|
|
+- **agent 编排**:AgentScope `HarnessAgent`,`ai-server/.../module/agent/` 共 28 个子目录;`insight` 独占 25 个文件;45 个文件 import `io.agentscope`。
|
|
|
+- **前端**:`ai-electron/frontend/src/ai/`(aiWorkbench / aiPlugin / aiModel / 聊天组件),经 SSE `/chat/stream` 消费;`/workbench` 入口统一由 `frontend/src/core/router/guard/index.ts:69` 转成开窗。
|
|
|
+- **窗口**:`electron/service/window/smartWindow.ts` 已是独立顶层单例窗口;`electron/config/windowOptions.ts:25` 刻意不设 parent(VS Code Agents window 式)。Electron 侧现仅 window/download/os/setting 四类 service。
|
|
|
+- **案件库**:`cases/{caseId}/db/case.duckdb`(`common/storage/StorageLayout.java:142`);Java 持写锁,外部进程连 read_only 都打不开。
|
|
|
+- **副本机制已存在**:`common/datasource/DuckdbSnapshot.java:58` 用 `ATTACH + COPY FROM DATABASE` + 临时文件原子替换;入口 `CaseDataSourceRegistry.java:244` `exportSnapshot(caseId, target)`;指纹缓存与「失败不回退原库」策略见 `module/agent/python/PythonExecutor.java:685`。
|
|
|
+- **外部解释器已就绪**:`qingjian/system/python/python.exe` = Python 3.14.10 + **duckdb 1.5.6**(本机实测)。
|
|
|
+- **既有技能资产**:`ai-server/src/main/resources/skills/xlsx/SKILL.md`、`skills/report/SKILL.md`。
|
|
|
+- **承重墙(删 AgentScope 会打断)**:`aiclean/match/AiTemplateMatcher.java:16`、`aiclean/index/AiCleanTemplateVectorIndex.java:15`、`dm/ai/FileRecognitionService.java:10`、`knowledge/KnowledgeDocIndexer.java:5`、`knowledge/service/KnowledgeBaseService.java:7`、`plat/service/CaseDataCleanupService.java:4`。
|
|
|
+- **关键缺失**:agent 模块外 grep `OkHttpClient|WebClient|HttpClient|RestTemplate|chat/completions|embeddings` **零命中**——仓内没有任何非 AgentScope 的 HTTP LLM 客户端。
|
|
|
+
|
|
|
+## 4. 目标形态(proposed,未实施)
|
|
|
+
|
|
|
+```
|
|
|
+主窗口 Vue(既有业务界面) agent 窗口 Vue(新建·独立顶层 BrowserWindow)
|
|
|
+ ├─ 案件空间选择器
|
|
|
+ ├─ 模式切换:数据分析 / 通用办公
|
|
|
+ ├─ 消息流 + 工具调用卡片 + 产物预览
|
|
|
+ └─ 审批对话框 ← extension_ui_request
|
|
|
+ ↕ IPC
|
|
|
+Electron 主进程 ── spawn pi --mode rpc --no-session
|
|
|
+ cwd = cases/{id}/ai/pi/{userId}/
|
|
|
+ sessionDir = 同上(按案件+用户隔离)
|
|
|
+ JSONL stdin/stdout,id 关联,回合结束等 agent_settled
|
|
|
+ ↓ 工具
|
|
|
+ read / bash / powershell(分析模式可收窄为只读集)
|
|
|
+ → qingjian/system/python/python.exe + duckdb 只读开副本
|
|
|
+ ↑
|
|
|
+ai-server(Java,保留)── POST /case/pi-workspace
|
|
|
+ 调既有 exportSnapshot 导副本 + 从 PG 导元数据
|
|
|
+ + 生成 AGENTS.md / .pi/skills/ / 返回工作区路径
|
|
|
+```
|
|
|
+
|
|
|
+案件工作区布局(proposed):
|
|
|
+
|
|
|
+```
|
|
|
+cases/{caseId}/ai/pi/{userId}/
|
|
|
+├── AGENTS.md ← pi 自动加载:副本路径、只读约束、python 命令、快照时间
|
|
|
+├── .pi/
|
|
|
+│ ├── extensions/ ← 自建:审批拦截、案件工具、模式装配
|
|
|
+│ └── skills/ ← 按 cwd 解析,避开 .agents/skills 的 repo-root 截断
|
|
|
+│ ├── case-sql/SKILL.md
|
|
|
+│ ├── xlsx/SKILL.md ← 从 ai-server resources/skills 迁移
|
|
|
+│ └── report/SKILL.md ← 同上
|
|
|
+├── data/case.duckdb ← exportSnapshot 副本
|
|
|
+├── data/schema.json ← PG 侧 table_info / ai_clean_template 元数据
|
|
|
+└── outputs/ ← 产物
|
|
|
+```
|
|
|
+
|
|
|
+**为什么不用案件根目录当 cwd**:pi 无内置权限系统(`README.md:90`),工具以启动用户的 OS 权限运行。案件根含原库、`imports/`、`materials/` 原始证据,必须把 cwd 收窄到独立子目录,再叠加自建审批 extension。
|
|
|
+
|
|
|
+**为什么用 `.pi/skills/` 而非 `.agents/skills/`**:后者从 cwd 向祖先发现并**止于 repo 根**(`docs/skills.md:61`);存储根 `./qingjian/data` 物理在仓库工作树内(`.gitignore:39` 忽略但仍在树内),会被截断到 `E:\workspace\zsjz-ai`。`.pi/skills/` 是项目级、按 cwd 解析,不受此影响。
|
|
|
+
|
|
|
+## 5. pi vs dsh 决策矩阵
|
|
|
+
|
|
|
+针对本项目的六个硬需求:
|
|
|
+
|
|
|
+| 需求 | pi | dsh | 判断 |
|
|
|
+|---|---|---|---|
|
|
|
+| 独立顶层 agent 窗口,两窗口互不影响 | 无现成 GUI;**自建 Vue 窗口** + RPC 子进程(官方指定场景) | 现成 Web UI,新 BrowserWindow 顶层加载;**不能 iframe**(拒绝 cross-site + SameSite=Strict) | dsh 省 UI 工;pi 省技术栈切换 |
|
|
|
+| UI 技术栈与既有一致 | **Vue 自由**(RPC 语言无关,只约定 JSONL) | 客户端插件**只能 React**(`dsh.client` + ui-slots) | **pi 胜**(既有前端是 Vue3) |
|
|
|
+| 选择案件空间 | cwd + `--session-dir` 直接映射;无 workspace 注册表需要维护 | `workspace.create({path})` + `session.create({workspaceId})` Remote API | pi 更简单 |
|
|
|
+| 两种模式切换 | **无 preset 概念**,需自建(extension + skill 集 + systemPrompt + 工具集,切换时 respawn 或改配置) | **agent-preset 是会话级原语**,同进程多组合、空白会话可 select | **dsh 胜** |
|
|
|
+| 数据分析(DuckDB 副本) | 无 SQL 工具;`bash`/`powershell` 调自带 python+duckdb;`createReadOnlyTools()` 可收窄 | 同样无 SQL 工具;Windows 上 `run_code` 不可用(standard preset 不含 PTC,python runtime 仅 mac/Linux),只能 `pwsh` | 平手,pi 略优(有只读工具集工厂) |
|
|
|
+| 通用办公(Word/Excel/PPT) | **零内置 Office**,需自建 skill;但既有 xlsx/report SKILL.md 同规范可迁移 | **自带 `skill-office`**(Word/PPT/Excel 工作流 + 文件结构检查) | **dsh 明显胜** |
|
|
|
+
|
|
|
+其他决策因素:
|
|
|
+
|
|
|
+| 因素 | pi | dsh |
|
|
|
+|---|---|---|
|
|
|
+| 许可/品牌 | 纯 MIT,**无商标附加条款** | MIT + `BRAND_GUIDELINES.zh.md` 商标约束(产品名避免全称) |
|
|
|
+| 核心复杂度 | agent-core **6 文件**;但复用 CLI 机制要吃下 coding-agent 265 文件 | Cordis 全插件树,定制面在无稳定性承诺的内部约定上 |
|
|
|
+| 上游节奏 | lockstep 约周更,v1.5.1;无 semver 承诺;durable/p2 Experimental | developer preview,明确声明 breaking change;client 要求 Host version+commit 全等 |
|
|
|
+| 定制可否上游化 | 新贡献者 PR 默认自动关闭 → 定制只能自维护 package/extension | 树外 bundle + `dsh plugin add` 官方支持 |
|
|
|
+| 审批/权限 | **无内置**,须自写 `tool_call` 拦截 extension | base 默认 `workspace-write + ask`,fs-sandbox 只围栏写 |
|
|
|
+| 子代理 | **故意不做**;pi-durable 有但 Experimental | 有 subagent/team |
|
|
|
+| embedding | **不支持**(ModelType 只有 chat/image/classifier) | 未查证 |
|
|
|
+
|
|
|
+## 6. 关键缺口与代价(诚实评估)
|
|
|
+
|
|
|
+1. **UI 全部自建是最大成本项**。pi 只给事件流 + 对话框子协议。会话列表、消息流渲染、工具卡片、审批交互、案件选择器、模式切换、产物预览都要自己写。RPC 下 `custom()`/footer/header/autocomplete/editor component 全不可用,别指望复用它的 TUI 组件。
|
|
|
+2. **通用办公模式要从零建 skill**。pi 零 Office 能力。缓解:既有 `resources/skills/{xlsx,report}/SKILL.md` 与 pi 同为 agentskills.io 规范,可迁移;docx/pptx 需新写。
|
|
|
+3. **pi 不解决 embedding**。`ModelTypeMap` 只有 chat/image/classifier(`packages/ai/src/types.ts:915`)。清洗向量索引与知识库索引所需的文本向量化,pi-ai 帮不上,Java 侧仍须自研或暂留 agentscope embedding 扩展。
|
|
|
+4. **pi 不解决 Java 侧 LLM 传输**。pi-ai 是纯 TS,无 JVM 绑定;pi-proxy 已删除且原本只是 CORS 转发器,不是 OpenAI 兼容服务端。`packages/agent/src/proxy.ts` 是**客户端** streamFn,服务端要自写。所以 `LlmService` 脱 AgentScope 仍须 Java 自研 HTTP 客户端(流式 SSE + 重试 + usage + 三家 provider)。**不建议**让 Java 经 Node sidecar 调 pi-ai:多一跳、且与清洗单并发闸门冲突。
|
|
|
+5. **无权限系统 = 敏感案件数据的裸露风险**。必须自写审批 extension + 只读工具集 + cwd 收窄三重防护。原库因 Java 持锁天然打不开,但副本与 `imports/`、`materials/` 需 explicit 保护。
|
|
|
+6. **功能退化需明确接受**:删掉 AgentScope 的 subagent(9 文件)与后台任务后,pi 默认不补;plan mode 也没有。
|
|
|
+7. **project trust 是隐藏门槛**:pi 先解析项目信任再加载项目设置与资源(`docs/how-pi-works.md:49`)。新建案件工作区首次可能不被信任 → `.pi/skills/` 与 extension 不加载。必须在 S0 验证并设计自动信任策略。
|
|
|
+8. **上游不可依赖**:周更 + 无稳定性承诺 + PR 默认自动关闭 → 锁精确版本,定制全部收敛进自有 pi package,升级整包回归。
|
|
|
+
|
|
|
+## 7. 迁移切片
|
|
|
+
|
|
|
+每片含:保护/解锁的业务路径 + 验证信号 + 可回退性。图源见 `pi-agent-migration.dot`。
|
|
|
+
|
|
|
+### S0 可行性验证(零改动,先做)
|
|
|
+- **动作**:手工导一份案件快照到**仓库外**目录;写 `AGENTS.md` + `.pi/skills/case-sql/SKILL.md`;用最小 RPC 客户端(Node 或 Python)跑 `pi --mode rpc --no-session`,问「这个库里有哪些表」。
|
|
|
+- **保护的业务路径**:不动任何既有代码,清洗/上传/知识库零风险。
|
|
|
+- **验证信号**:① 返回真实表名且与 PG `table_info` 登记一致 ② project trust 不阻断资源加载 ③ 原库确实打不开(预期失败)④ `agent_settled` 能正确判定回合结束 ⑤ 自带 python+duckdb 能被 bash/powershell 调起。
|
|
|
+- **可回退**:完全可回退(纯外部实验)。
|
|
|
+- **未通过则**:停止,回到 dsh 方案或维持现状。
|
|
|
+
|
|
|
+### S1 Electron 载体 + Vue agent 窗口骨架
|
|
|
+- **动作**:新 `piWindow` service(照 `smartWindow.ts` 的单例/bounds 落盘/崩溃重建,**不复用** `/workbench` 单例);主进程 spawn + JSONL 解析 + id 关联 + 生命周期绑窗口;Vue 侧消息流/工具卡片/对话框桥。
|
|
|
+- **保护的业务路径**:主窗口既有业务界面与窗口角色解析(`appWindow.ts`)不受影响。
|
|
|
+- **验证信号**:两窗口互不影响(关主窗口不杀 agent 进程 / 反之);`extension_ui_request` 能渲染成 Vue 对话框并正确回 `extension_ui_response`;渲染进程崩溃后重建;stdin 关闭优雅退出。
|
|
|
+- **可回退**:新增文件为主,入口未切换前可整体摘除。
|
|
|
+
|
|
|
+### S2 案件工作区端点 + 副本 + 元数据 + 技能迁移
|
|
|
+- **动作**:ai-server 新增 `POST /case/pi-workspace`(**新增 controller,不改既有链路**):调 `exportSnapshot` 导副本 + 从 PG 导 `table_info`/`ai_clean_template` 成 schema.json + 生成 AGENTS.md/.pi/skills + 返回路径;迁移既有 xlsx/report SKILL.md。
|
|
|
+- **保护的业务路径**:案件开案/退案/删案、数据上传、清洗执行层全部只读接管,不改其逻辑。
|
|
|
+- **验证信号**:切案后 cwd 与 sessionDir 按 caseId+userId 正确隔离;副本指纹随原库 WAL 变化刷新;导出失败显式报错不回退原库;元数据表清单与 `list_tables` 口径一致。
|
|
|
+- **可回退**:新端点可直接下线;副本目录可删。
|
|
|
+
|
|
|
+### S3 双模式 + 只读工具集 + 审批 extension
|
|
|
+- **动作**:数据分析模式(案件工具 + case-sql skill + 只读集 + 严格审批);通用办公模式(office skill + 可写工具 + 用户选目录,不绑案件)。自建 `tool_call` 拦截 extension。
|
|
|
+- **保护的业务路径**:原始证据数据(原库/imports/materials)不可被模型修改;办公模式不得触达案件数据。
|
|
|
+- **验证信号**:办公模式工具清单里无案件工具;分析模式写操作被 block 并给出原因;越界写(cwd 之外)被拦;审批超时按拒绝收尾。
|
|
|
+- **可回退**:模式装配是配置/extension,可退回单模式。
|
|
|
+
|
|
|
+### S4 抽出共用件到中立模块(后端,与 pi/dsh 选择无关)
|
|
|
+- **动作**:`llm/` 4 类 → `common/llm`;`rag/EmbeddingProvider`+`EmbeddingModelFactory`+`RagProperties`+`WaForensicsSchemaCatalog` → `common/embedding`;`AgentModelFactory`+模型实体/mapper/`/models` controller → `common/model`;`attachment/AttachmentDocIndexer` → `common/docindex`;`RagVectorMapper` 中注明仅供 aiclean 使用的方法一并迁出;前端 `src/ai/views/aiModel`+`ModelFormModal.vue`+`api/modelApi.ts` 抽到中立目录。
|
|
|
+- **保护的业务路径**:AI 清洗模板匹配、清洗向量索引、数据上传文件识别、知识库索引、模型管理选模型。
|
|
|
+- **验证信号**:**行为不变**——清洗侧只改 import 路径;录制现有 LlmService 真实请求/响应 payload,迁移后逐条回放对齐;清洗全链路回归通过。
|
|
|
+- **可回退**:纯移动 + import 改写,可 revert。
|
|
|
+
|
|
|
+### S5 脱 AgentScope(最高风险)
|
|
|
+- **动作**:Java 自研 LLM 传输(流式 SSE + 非流式、重试、usage、dashscope/openai/ollama)与 embedding 三家适配,替换 `io.agentscope.core.model.Model` / `core.embedding.*`。
|
|
|
+- **保护的业务路径**:AI 清洗判定链路(含单并发闸门与 180s 超时重试)、文件识别、知识库向量化。
|
|
|
+- **验证信号**:payload 回放**逐条等价**(不是跑通就算过);单并发与超时重试行为不变;pgvector 召回结果与迁移前一致。
|
|
|
+- **可回退**:保留 agentscope 依赖至验收通过后再摘;此片失败则停在 S4 状态(AgentScope 仅作为 LLM/embedding 库存在)。
|
|
|
+
|
|
|
+### S6 删除编排层 + insight + 前端聊天 UI
|
|
|
+- **动作**:删 `module/agent` 的 service/tools(26)/middleware/intent/followup/subagent(9)/skill(5)/state/memory/prompt/render/registry/usage/analysis/artifact/python(3)/**insight(25)** 及相关 controller/entity/mapper/dto/vo;删前端 `src/ai`(模型管理除外)与 `src/graph/insight` 整目录 + `graph/views/g6Editor/index.vue:548` 的 InsightDrawer 挂载;连带清 `CaseDataCleanupService` 的 agent 清理分支、`KnowledgeBaseService:170` 的 `detachKnowledgeBase`、`StorageLayout.insightWorkspace`、`sql/insight_agent_tables*.sql` 与 `sql/agent_{expert,tool,tool_pack,skill,prompt_python_first}.sql`、pom agentscope 依赖、`agent.*`/`subagent.*`/`analysis.*` 配置段、58 个相关测试。
|
|
|
+- **保留**:`common/datasource/DuckdbSnapshot` + `exportSnapshot`(S2 已在用)、StorageLayout 案件布局、模型管理全链路。
|
|
|
+- **保护的业务路径**:删案清理不留孤儿分支;图谱页去掉研判入口后其余功能正常;清洗/上传/知识库不受影响。
|
|
|
+- **验证信号**:全量编译 + 清理后测试全绿;删案后无残留表/目录引用;`/workbench` 入口经 `router/guard/index.ts:69` 重定向到新 agent 窗口,数据页 CTA 与清洗完成页无需逐个改。
|
|
|
+- **可回退**:此片不可逆,**必须在 S0–S5 全部验收通过后执行**。
|
|
|
+
|
|
|
+### 排序依据
|
|
|
+S0 先做(零风险证伪)→ S1–S3 建立新能力(可回退)→ S4–S5 后端解耦(行为等价验收)→ S6 不可逆删除放最后。S4–S6 与 pi/dsh 选择无关,可与 S1–S3 并行。
|
|
|
+
|
|
|
+## 8. 风险登记
|
|
|
+
|
|
|
+| 风险 | 影响 | 缓解 |
|
|
|
+|---|---|---|
|
|
|
+| 自建 Vue UI 工作量被低估 | S1/S3 延期 | S0 后先做 UI 工作量评估;必要时先只支持单模式 |
|
|
|
+| project trust 阻断资源加载 | 案件技能/extension 不生效,agent 盲查 | S0 必须验证;设计自动信任或显式信任步骤 |
|
|
|
+| 无审批系统导致误写证据数据 | 数据完整性事故 | cwd 收窄 + 只读工具集 + 自建拦截三重防护;S3 验证越界写被拦 |
|
|
|
+| Office 能力从零建 | 通用办公模式不可用 | 先迁既有 xlsx/report;docx/pptx 参照 agentskills.io 规范新写 |
|
|
|
+| S5 自研 LLM 传输行为漂移 | 清洗判定结果变化、批次拖死 | 录制回放逐条对齐 + 单并发/超时行为回归 |
|
|
|
+| pi 周更 breaking change | 升级即坏 | 锁精确版本 + 定制收敛进自有 package + 升级整包回归 |
|
|
|
+| 上游不接受定制 PR | 长期自维护负担 | 从设计上就不依赖上游合入,全部走 extension/package |
|
|
|
+
|
|
|
+## 9. 未验证点(需 S0 收口)
|
|
|
+
|
|
|
+- pi 在 **Windows + Electron 主进程 spawn** 下的实际行为(Git Bash 解析、powershell 工具、路径引号)
|
|
|
+- `--mode rpc` 的完整命令集与 `agent_settled` 语义(`docs/rpc-commands.md`、`docs/json.md` 未逐条读)
|
|
|
+- project trust 的判定与自动化方式
|
|
|
+- 模式切换能否不 respawn(RPC 是否支持运行时改工具集/skill/systemPrompt)
|
|
|
+- 既有 `resources/skills/{xlsx,report}/SKILL.md` 的 frontmatter 与 agentskills.io 规范的字段兼容性
|
|
|
+- pi 会话 JSONL 在多用户/多案件下的隔离与清理策略
|
|
|
+- pi 是否有 compaction(`docs/compaction.md` 存在但未读)以支撑长分析任务
|
|
|
+- Office 零能力这一结论本人未独立复核(子代理全树检索)
|
|
|
+
|
|
|
+## 10. 下一步
|
|
|
+
|
|
|
+先执行 **S0**(零改动、可证伪)。S0 通过后再决定 S1 的 UI 投入规模;S4–S6 后端退役轨道可独立立项并行推进。
|