329db944ff
排查发现进度数字三套互相矛盾:总览/现状基线/主台账历史段=147/86、agent-specs=100/127、module-reality=233/0。核机械真值:覆盖 JSON summary=233/233 completed/0 needs(每 op 带 testFiles 证据 + P1rApiCoverageReportTest 校验 summary 自算防手工拨)。⚠️ JSON generatedAt=2026-05-25 未随内容刷新(手工维护痕迹),已在文档标注以 summary+testFiles 为准。
修正:① 总览(我上轮新建,误抄过时台账)147/233→233/233、各域 full、接口门≠端到端两口径分清、定位为人读封面(权威以台账/JSON为准);② 主台账 头部加机械源口径声明(233/0)+门禁中→满+验收债标已清零;③ 现状基线降级为 2026-06-13 历史快照(顶部时效横幅+性质去SSOT);④ AGENTS序2/module-reality 改引用;⑤ agent-specs/.agent 注记历史数字;⑥ meta-schema review 回指 execution v0.2 已证伪地基(待决策提案);⑦ design-docs/00 加'设计≠进度';⑧ dev-baseline 申明旧 SSOT 自称失效。
确立单一真实源:设计=design-docs;进度=进度总账(叙述)+覆盖JSON(机械);人读=项目功能与进度总览(封面)。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
178 lines
13 KiB
Markdown
178 lines
13 KiB
Markdown
# Muse 项目功能与进度总览
|
||
|
||
> **定位(权威边界)**:本页是**进度台账的人读封面**(给人一眼看全局)。**进度的机械唯一源 = 覆盖门 JSON [`p1r-api-coverage.json`](superpowers/reports/p1r-api-coverage.json)(由 `P1rApiCoverageReportTest` 校验);叙述权威 = 主台账 [`进度总账.md`](mvp/进度总账.md)**。本页数字为 **2026-06-20 口径快照**,如与机械源/主台账冲突,**以后者为准、不以本页为准**。
|
||
> **两个口径别混**:① **接口覆盖门**(机械)=每个 HTTP 端点是否有"真实 PG IT + testFiles 证据";② **整体完成度**(多维评估)=含前端/跨 BC 集成。覆盖门 100% **≠** 产品可用(对抗复盘 R4:禁用单一% 当可用度)。
|
||
> **图例**:✅ 完成并验证 · 🟡 部分/进行中 · 🔴 缺失或受阻 · ⚪ 设计上暂关闭 · — 不适用
|
||
|
||
---
|
||
|
||
## 一、一眼看全局
|
||
|
||
| 维度 | 状态 |
|
||
|---|---|
|
||
| **整体完成度(估)** | **~76%** |
|
||
| 后端业务实现 | **~80%**(真实端到端逻辑,无桩) |
|
||
| 前端用户端 muse-studio | **~30%**(AI 候选链断、知识/市场生产端 UI 缺) |
|
||
| 前端管理端 muse-admin | 较完整(meta 治理、市场审核、系统权限均真实) |
|
||
| 接口覆盖门(机械口径) | **233/233 通过(100%)**——每条带 testFiles 证据 + 门禁校验;⚠️ **接口门 100% ≠ 端到端可用**(故整体仍 ~76%) |
|
||
| 跨 BC 集成 | 偏低(多处 facade 仍 Unavailable) |
|
||
|
||
**一句话**:Muse 是一套**真实、高质量的后端实现**,配**诚实的验证门**,但**用户端前端严重欠缺**。"AI 绝不黑箱改稿、须用户复核"的目标后端已具备(`mergeBlockSuggestion` 已证),但卡在用户可见层(studio 从不调该端点)。非空壳、非假完成——是待补前端 + 跨 BC 接线的真实工程。
|
||
|
||
**三大风险(须优先)**
|
||
1. 🔴 **前端 AI 候选链断裂**:后端 Accept Suggestion 就绪,studio 从不调 `suggestion-merges` → 用户层无法复核接受 AI 候选。
|
||
2. 🔴 **跨 BC facade 仍 Unavailable**:meta 影响预览、account 的 New-API/FileService/Market 投影 → meta 发布链运行期受阻;account 21/33 端点返 `*_UNAVAILABLE`。
|
||
3. 🔴 **前端用户端大面积缺口**:知识工作台缺 2/3、市场生产端 0 UI、个人中心仅 ~21% 有 UI。
|
||
|
||
---
|
||
|
||
## 二、模块进度表
|
||
|
||
| 模块 | 完成度 | 后端 | 前端 studio | 前端 admin | 接口门(机械) | 关键风险/缺口 |
|
||
|---|:---:|:---:|:---:|:---:|:---:|---|
|
||
| **AI 编排** (ai) | 72% | ✅ 真实 | 🟡 全 MSW | — | 41/41 | New-API 真端到端未验;grant/runtime 物理隔离仅最小 ArchUnit |
|
||
| **作品/正文** (content) | 82% | ✅ 真实 | 🔴 候选链断 | — | 51/51 | **Accept Suggestion 前端缺**;EditorPage 仍 demo 壳 |
|
||
| **知识库** (knowledge) | 72% | ✅ 真实 | 🟡 ~1/3 UI | — | 59/59 | 工作台缺 2/3;recheck/outbox worker ⚪默认关 |
|
||
| **市场** (market) | 82% | ✅ 真实 | 🔴 生产端无 UI | ✅ 真实 | 32/32 | 发布/handoff/申诉**生产者 UI 缺**(草稿保存已通) |
|
||
| **元引擎/治理** (meta) | 82% | ✅ 真实 | 🟡 用户端引擎缺 | ✅ 真实 | 16/16 | **影响预览 Unavailable → 发布链运行期阻塞**;facade-api 契约未建 |
|
||
| **事件/SSE** (events) | 88% | ✅ 真实 | 🟡 统一客户端未接 | — | 1/1 | `connectEventStream` 仅自测、无组件消费 |
|
||
| **账户/会员** (member) | 68% | ✅ 真实 | 🔴 ~21% UI | 🟡 受限桩 | 33/33 | 21 端点无 UI;New-API/FileService facade Unavailable |
|
||
| **平台底座** (gateway/system/infra…) | 80% | ✅ 真实 | ✅ 真实 | ✅ 真实 | — | 网关运行期转发未验(Nacos);pay/bpm/mp/report ⚪默认隐藏、0 覆盖 |
|
||
| **整体** | **~76%** | **~80%** | **~30%** | 良好 | **233/233** | 前端用户端缺口 + 跨 BC 集成偏低 |
|
||
|
||
> **接口门(机械口径)**:每个 HTTP 端点须 MockMvc + 真实 PostgreSQL IT + Flyway + 覆盖 JSON 的 `testFiles` 证据锚点,且无 catch_all/generic/sse_placeholder/missing/blocked。**当前 233/233 全通过**(机械源:[覆盖 JSON](superpowers/reports/p1r-api-coverage.json),经 `P1rApiCoverageReportTest` 校验 summary 自算防手工拨 + testFiles 指向真实测试源)。
|
||
> ⚠️ **接口门 ≠ 完成度列**:完成度含前端/跨 BC,故同模块可"接口门 full 但完成度 72%"。⚠️ 覆盖 JSON 的 `generatedAt=2026-05-25` 未随内容刷新(手工维护痕迹),以 summary + testFiles 锚点为准,不以该时间戳为准。
|
||
|
||
---
|
||
|
||
## 三、系统功能清单 × 状态
|
||
|
||
> 功能名取自 `design-docs/产品-02*` 规范。后端/前端分列,讲清"后端强、前端弱"的真实分布。
|
||
|
||
### 1. 管理员控制台(admin console) — 后端 ✅ / 前端 admin 大体 ✅
|
||
*规范:产品-02B*
|
||
|
||
| 功能 | 后端 | 前端 admin | 备注 |
|
||
|---|:---:|:---:|---|
|
||
| 元结构定义与版本管理(字段/可见性/发布回滚) | ✅ | ✅ | meta 16 端点 100% 对齐;detail.vue 1123 行 |
|
||
| 影响预览(迁移影响范围) | 🔴 | 🟡 | facade 恒 Unavailable;admin 读侧显示 0 affected |
|
||
| 系统级智能体与功能编排 | ✅ | 🟡 | 后端链路完整;部分 owner 计数硬编码 0 |
|
||
| 全局知识库授权 | ✅ | 🟡 | 后端就绪 |
|
||
| 质量门控与效果观测 | 🟡 | 🟡 | 评估作业已起,LLM-judge 深度待明 |
|
||
| 市场审核与治理(审核/下架/召回/申诉) | ✅ | ✅ | index.vue 1166 行生产级;IT 全绿 |
|
||
| 用户/角色/权限/数据范围 | ✅ | ✅ | 继承 yudao,真实 |
|
||
| New-API 网关用户与用量 | 🟡 | 🟡 | 桩待真 New-API provider |
|
||
| 任务治理 / 日志审计 / 平台配置 | ✅ | ✅ | append-only 审计 + 配置版本化 |
|
||
|
||
### 2. 用户工作区与作品工作台(content) — 后端 ✅ / 前端 🔴
|
||
*规范:产品-02C*
|
||
|
||
| 功能 | 后端 | 前端 studio | 备注 |
|
||
|---|:---:|:---:|---|
|
||
| 我的作品(列表/新建/导入) | ✅ | ✅ | WorkspacePage 接真 `/works` |
|
||
| 写作台·章节编辑 + IndexedDB 自动保存 | ✅ | 🟡 | MuseEditor 真实;EditorPage 仍 demo 壳(workId/blockId/revision 硬编码) |
|
||
| **写作台·AI 候选生成 + 接受(原样/改后/丢弃)** | ✅ | 🔴 | **后端 mergeBlockSuggestion 严格就绪,studio 从不调** → 候选链断 |
|
||
| 作品规划台(设定/大纲/世界/角色/文风) | ✅ | 🟡 | 后端就绪;FE 部分 |
|
||
| 知识与一致性(草稿确认/修正/冲突检查) | ✅ | 🔴 | 后端就绪;FE 无确认/修正组件 |
|
||
| 导入解析(上传/按章确认→知识草稿) | ✅ | 🟡 | 后端状态机完整 |
|
||
| 导出交付(范围/格式/授权校验) | ✅ | 🔴 | 后端就绪(下载凭证校验);FE 无工作流 |
|
||
| 记录与用量 / 作品设置 | ✅ | 🟡 | 后端就绪 |
|
||
|
||
### 3. 智能体工作台(ai) — 后端 ✅ / 前端 🟡(多为 MSW)
|
||
*规范:产品-02D*
|
||
|
||
| 功能 | 后端 | 前端 studio | 备注 |
|
||
|---|:---:|:---:|---|
|
||
| 智能体列表 / 新建 | ✅ | ✅ | agent-create e2e 1/1 真实单租户落库 |
|
||
| 配置型 / 工作流型编辑 | ✅ | 🟡 | DEV 走 MSW |
|
||
| 试用与评估(沙盒) | ✅ | 🟡 | 后端就绪 |
|
||
| 槽位兼容 / 作品槽位替换(预检) | ✅ | 🟡 | 后端就绪;FE 真替换未完 |
|
||
| 已安装与授权 / 发布准备 / 运行记录 | ✅ | 🟡 | 后端就绪 |
|
||
|
||
### 4. 知识库工作台(knowledge) — 后端 ✅ / 前端 🟡(~1/3)
|
||
*规范:产品-02E*
|
||
|
||
| 功能 | 后端 | 前端 studio | 备注 |
|
||
|---|:---:|:---:|---|
|
||
| 知识库列表 / 资料管理导入 | ✅ | 🟡 | 后端 59 端点最完整 |
|
||
| 处理状态与失败恢复 | ✅ | 🔴 | RAGFlow 真 HTTP + SSRF 防护 |
|
||
| 知识图谱可视化 | ✅ | ✅ | 读真 Canonical 实体/关系;e2e 8/8 |
|
||
| 知识来源绑定 + 读回面板 | ✅ | ✅ | 2026-06-19 写→读→端点→FE 闭环;vitest 50/50 |
|
||
| 草稿确认/忽略/recheck | ✅ | 🔴 | 后端就绪;**FE 无 hook** |
|
||
| 实体/关系 CRUD / 发布工作流 | ✅ | 🔴 | 后端就绪;**FE 无 UI** |
|
||
| recheck 真校验 / outbox worker | ⚪ | — | 默认关闭,待运维配置 |
|
||
|
||
### 5. 市场(marketplace) — 后端 ✅ / 前端:消费端 ✅、生产端 🔴
|
||
*规范:产品-02F*
|
||
|
||
| 功能 | 后端 | 前端 studio | 备注 |
|
||
|---|:---:|:---:|---|
|
||
| 市场发现/浏览 | ✅ | ✅ | 消费端 |
|
||
| 资产获取与授权(install 仅 agent/kb) | ✅ | ✅ | work 强制只读、排除可装 |
|
||
| 发布者控制面(草稿/提交/审核/上架) | ✅ | 🔴 | **草稿保存已通(e2e 8/8),其余生产者 UI 缺** |
|
||
| Handoff 一次性令牌 | ✅ | 🔴 | 后端就绪(仅存 SHA256);FE 0 |
|
||
| 申诉(提交/补充/撤回/状态) | ✅ | 🔴 | 后端 IT 全绿;FE 无 |
|
||
| 市场审核治理(管理端) | ✅ | ✅(admin) | 见 §1 |
|
||
|
||
### 6. 个人中心(account/member) — 后端 ✅ / 前端 🔴(~21%)
|
||
*规范:产品-02G*
|
||
|
||
| 功能 | 后端 | 前端 studio | 备注 |
|
||
|---|:---:|:---:|---|
|
||
| 账户总览 | 🟡 | 🟡 | 部分诚实占位(emailVerified/mfaEnabled 硬编 false) |
|
||
| 个人资料 / 安全登录 / 偏好通知 | 🟡 | 🔴 | session 吊销未接 session service |
|
||
| Token 与用量总览 | ✅ | ✅ | `/account/usage` 真接 |
|
||
| 权益与配额 | ✅ | ✅ | `/account/entitlements` 真接 |
|
||
| 授权/购买/安装绑定/发布记录 | ✅ | 🔴 | 后端 IT 全绿;**~15 端点无 UI(MSW)** |
|
||
| New-API 绑定 / 配额申请 / 导出下载 | 🟡 | 🔴 | facade Unavailable;FileService 字节投递未接 |
|
||
|
||
### 7. 跨切 / 基础能力(infra) — 后端 ✅ 为主
|
||
*规范:产品-02、架构*
|
||
|
||
| 能力 | 状态 | 备注 |
|
||
|---|:---:|---|
|
||
| 身份认证与会话(权限版本/自动降权/step-up) | ✅ | |
|
||
| 权限与数据范围(分层/菜单/操作/数据域) | ✅ | BcBoundaryArchTest 0 违例 |
|
||
| AI 编排与上下文(组装/授权过滤/质量门控) | ✅ | grant/runtime 完全物理隔离 🟡仅最小 ArchUnit(P2) |
|
||
| 知识双轨模型(Shadow/Canonical/Archive) | ✅ | 源状态校验 stale guard |
|
||
| 实时事件与通知(SSE) | 🟡 | 后端✅;统一客户端 `connectEventStream` 未被组件消费 |
|
||
| 导出与备份(授权/格式/下载审计分层) | 🟡 | 后端排队 fail-closed;FE 缺 |
|
||
| 计费与配额 / New-API 对账 | 🟡 | facade Unavailable 待真 provider |
|
||
| 多租户/账户隔离 / 统一 API 契约/幂等 | ✅ | commandId 幂等 + 乐观锁 |
|
||
| 网关路由 | 🟡 | 配置完成;运行期转发未验(Nacos/服务发现) |
|
||
| 平台底座(system/infra/pay/bpm/mp/report) | ✅/⚪ | 8 模块真实;pay/bpm/mp/report 默认隐藏、0 运行覆盖 |
|
||
|
||
---
|
||
|
||
## 四、待办表(按优先级)
|
||
|
||
| 优先级 | 待办 | 所属 | 阻塞原因 |
|
||
|:---:|---|---|---|
|
||
| 🔴 高 | **接通 AI 候选接受链**:studio EditorPage/AIPanel→真 `suggestion-merges`,WorkspacePage 挂 AIPanel/CandidatePanel | content/studio | 仅前端未接;后端已证 |
|
||
| 🔴 高 | **知识工作台补 2/3 UI**:草稿确认/忽略/recheck、实体关系 CRUD、发布工作流 | knowledge/studio | 仅前端未接 |
|
||
| 🔴 高 | **市场生产端 UI**:发布工作流、handoff、申诉提交/追踪、许可详情 | market/studio | 仅前端未接 |
|
||
| 🔴 高 | **个人中心补 UI**:安全事件/导出下载/New-API绑定/配额申请/购买授权记录(~15 端点) | member/studio | 部分前端未接 + 部分 facade Unavailable |
|
||
| 🔴 高 | **meta 影响预览 facade 真实化**:解 publish/activate/rollback/deprecate 运行期阻塞 + 建 facade-api 契约 | meta(+content/knowledge/ai) | 跨 BC 地基不存在(见下) |
|
||
| 🟡 中 | **网关运行期转发验证**:Nacos/服务发现接线 + 首跑 | platform | 待服务发现配置 |
|
||
| 🟡 中 | **AI grant/runtime 完全物理包隔离**(ADR 承诺,现仅最小 ArchUnit) | ai | 排期 P2 |
|
||
| 🟡 中 | **统一 SSE 客户端接入 UI**:`connectEventStream` 接业务组件 | events/studio | 仅前端未接 |
|
||
| 🟡 中 | recheck 真外部校验 + outbox worker 启用 | knowledge | 默认关,待运维/外部源配置 |
|
||
| 🟡 中 | 平台基线 Schema 纳入 Flyway(现为 yudao 静态 dump) | platform | 历史基线未版本化 |
|
||
| ⚪ 外部依赖 | New-API 真端到端验收;FileService 字节投递;调用归属外部源 | ai/member | 待外部服务可用 |
|
||
| ⚪ 受阻 | 实时全栈 e2e(含 knowledge-bindings spec 已写未跑) | studio | PG 宿主 100.64.0.8 离线 |
|
||
| 🟦 待决策 | **meta-schema 用量投影方向**:评审证伪地基(破坏字段集生产者 + schema_key 来源均须从零建),须人类定"全量+字段级+全真实"还是回退 Content-only+计数优先 | meta | 见 [执行版 v0.2](agent-specs/2026-06-20-meta-schema用量投影-execution.md) §九 |
|
||
|
||
---
|
||
|
||
## 五、文档地图(权威 vs 摘要 vs 归档)
|
||
|
||
| 类别 | 位置 | 说明 |
|
||
|---|---|---|
|
||
| **设计 SSOT(唯一)** | `design-docs/`(33 篇) | 设计意图单一事实源(要建成什么,**≠已实现**),实现反向对齐它 |
|
||
| **进度 SSOT·叙述(唯一)** | `docs/mvp/进度总账.md` | 逐任务流水(权威但密);本文是其人读封面 |
|
||
| **进度 SSOT·机械** | `docs/superpowers/reports/p1r-api-coverage.json` | 接口覆盖门机械源(当前 233/233),经 `P1rApiCoverageReportTest` 校验 |
|
||
| **本文(人读封面)** | `docs/项目功能与进度总览.md` | 功能清单 + 进度 + 待办;**权威以上两者为准,本页为口径快照** |
|
||
| **现状基线(历史)** | `docs/agent-specs/2026-06-13-...基线.md` | **2026-06-13 历史快照**(已降级、非 SSOT),仅作现状考古 |
|
||
| **历史过程文档** | `docs/archive/` | 已完成阶段工作文档(P0冻结/复盘/P1R解锁等)归档 |
|
||
| **早期基线归档** | `docs/dev-baseline/` | 早期 dev-baseline 历史 |
|