26 lines
2.0 KiB
Markdown
26 lines
2.0 KiB
Markdown
# 架构文档（architecture/）
|
||
|
||
面向架构与研发。
|
||
|
||
| 文档 | 用途 |
|
||
| --- | --- |
|
||
| [overview.md](./overview.md) | 分层、数据流、仓库地图 |
|
||
| [harness.md](./harness.md) | 门禁权力矩阵（与代码一一对应） |
|
||
| [modules.md](./modules.md) | 可重生 moduleId 登记 |
|
||
| [rag.md](./rag.md) | RAG：导入 / 嵌入 / 混合检索 / 生成式问答 / Skill 消费 / 工艺模板库 |
|
||
| [skills.md](./skills.md) | 外部算法排产 Skill 与中性 DTO / Skill 管理台 |
|
||
| [desktop.md](./desktop.md) | 桌面/Web 双形态、~/.aps 目录、开发与打包命令 |
|
||
| [database.md](./database.md) | SQLite 主数据库：schema / world 投影 / 数据包 / 导入 profile |
|
||
| [dialog.md](./dialog.md) | 对话入口已下线：Pi 唯一语义入口与工具参数边界 |
|
||
| [fallback.md](./fallback.md) | Pi Agent 主入口：封闭参数 schema、只读分析、P0/P2/P3 门禁、审计 |
|
||
| [auth-tenancy.md](./auth-tenancy.md) | 登录闸门、租户隔离、项目成员权限与用户系统适配 |
|
||
|
||
## 本轮跨层边界
|
||
|
||
- `fallback_lane._PRIMARY_TOOL_PARAM_SCHEMAS` 为已登记工具提供封闭参数契约；`_validate_tool_params()` 拒绝未知字段、错误类型、非法枚举或范围，未单独登记参数的工具使用 `_OPEN_PARAMS_SCHEMA`。
|
||
- `analyze_project_deep(..., apply=False)` 与 `analyze_work_dir(..., apply_sql=False)` 只做预览；`workflow._stage_pending_adoption()` 把 `pendingAdoption` 冻结为 P2 `import.commit` 确认卡，批准后才写入。
|
||
- `mesh.resume_goal_after_confirmation()` 在审批后恢复 Goal；网关接入失败不阻断确认结果，`MeshPanel.tsx` 展示 `AWAITING_APPROVAL` / `confirmationIds`。
|
||
- SOP 控制台经 `/api/sop/compilable` 读取候选，`postSopStage(sessionId, assetId)` 调 `/api/sop/stage`，由 `compile_sop_by_asset(kb_assets, asset_id)` 生成 P2 `sop.apply` 确认卡。
|
||
|
||
蓝图全文：[../../plan.md](../../plan.md)（目标态多，落地以本目录 + `algorithm/` 为准）
|