oh-my-muse/docs/项目功能与进度总览.md

Muse 项目功能与进度总览

定位(权威边界):本页是进度台账的人读封面(给人一眼看全局)。进度的机械唯一源 = 覆盖门 JSON p1r-api-coverage.json(由 P1rApiCoverageReportTest 校验);叙述权威 = 主台账 进度总账.md。本页数字为 2026-06-20 口径快照,如与机械源/主台账冲突,以后者为准、不以本页为准。 1.0.0 交付口径已升级:可闭环路线以 1.0.0-交付计划.md 为准;真验证判据以 1.0.0-真验证清单.md 为准。 三个口径别混:① 接口覆盖门(机械)=端点 coverage/testFiles 台账门;② 真验证层级=local-ci / real-PG / external-live / frontend-e2e / mock-only / skipped;③ 整体完成度(多维评估)=含前端/跨 BC 集成。覆盖门 100% ≠ 产品可用(对抗复盘 R4:禁用单一% 当可用度)。 图例:✅ 完成并验证 · 🟡 部分/进行中 · 🔴 缺失或受阻 · ⚪ 设计上暂关闭 · — 不适用

---

一、一眼看全局

维度	状态
整体完成度(估)	~77%
后端业务实现	~80%(真实端到端逻辑,无桩)
前端用户端 muse-studio	~40%(AI 候选链✅;知识草稿动作/图谱CRUD/发布预检✅、市场许可详情/handoff预检✅、个人中心记录三件套✅;剩 content 正文台、市场发布写端、申诉等)
前端管理端 muse-admin	较完整(meta 治理、市场审核、系统权限均真实)
接口覆盖门(机械口径)	242/242 通过(100%)——每条带 testFiles 证据 + 门禁校验;⚠️ 接口门 100% ≠ 端到端可用(故整体仍 ~77%)
跨 BC 集成	偏低(多处 facade 仍 Unavailable)

一句话:Muse 是一套真实、高质量的后端实现,配诚实的验证门；用户端核心闭环已接通，但按完整产品体验看，知识/市场/个人中心等深面仍有缺口。"AI 绝不黑箱改稿、须用户复核"的目标后端已具备(mergeBlockSuggestion 已证),用户可见层亦已接通(WorkspacePage 2026-06-14 调该端点、e2e 2/2 绿)。非空壳、非假完成——是可按 1.0.0 线 A 继续 RC，但完整产品仍需补深面与跨 BC 接线。

三大风险(须优先)

1. ✅ 前端 AI 候选链已通(2026-06-14 MVP#1,e2e 2/2 绿;2026-06-27 E1 续补):WorkspacePage 挂 AIPanel/CandidatePanel→真 suggestion-merges,五环节(生成→SSE→Diff→采纳→回显)全真后端;真实 AI 生成归 external-live 层显式复跑。
2. 🔴 跨 BC facade 仍有 Unavailable/受限路径:meta 影响预览仍有运行期阻塞；account FileService、部分 New-API/导出深面仍需真实 provider 或更完整前端链路。
3. 🔴 前端用户端深面仍有缺口:知识处理状态/失败恢复、市场发布者深面、个人中心偏好与真实安全能力仍未完整。

---

二、模块进度表

模块	完成度	后端	前端 studio	前端 admin	接口门(机械)	关键风险/缺口
AI 编排 (ai)	80%	✅ 真实	✅ 核心生命周期/运行时真 e2e	—	48/48	Quality eval 本地执行器已补;LLM judge 与 grant/runtime 物理隔离仍后置
作品/正文 (content)	89%	✅ 真实	✅ 候选链/工作台入口/版本历史只读 diff 已接	—	52/52	E1 黄金旅程 MSW-off Playwright 2/2;EditorPage 仍 demo 壳
知识库 (knowledge)	82%	✅ 真实	🟡 检索/绑定/上传/召回阻断已接真后端	—	67/67	E3/E4 真 e2e 已覆盖核心；图谱/发布深面仍薄
市场 (market)	87%	✅ 真实	🟡 消费端+handoff+治理申诉入口已真连，生产端仍薄	✅ 真实	32/32	agent 物化/KB 召回触达已闭环；发布生产者深面仍缺
元引擎/治理 (meta)	82%	✅ 真实	🟡 用户端引擎缺	✅ 真实	16/16	影响预览 Unavailable → 发布链运行期阻塞;facade-api 契约未建
事件/SSE (events)	88%	✅ 真实	🟡 统一客户端未接	—	1/1	connectEventStream 仅自测、无组件消费
账户/会员 (member)	70%	✅ 真实	🟡 安全事件处理/用量权益已接，深面仍缺	🟡 受限桩	33/33	偏好通知/真实改密/2FA/session service 仍缺;New-API/FileService facade Unavailable
平台底座 (gateway/system/infra…)	80%	✅ 真实	✅ 真实	✅ 真实	—	网关运行期转发未验(Nacos);pay/bpm/mp/report ⚪默认隐藏、0 覆盖
整体	~80%	~82%	~40%	良好	242/242	前端用户端深面缺口 + 跨 BC 集成仍需 E5-E7

接口门(机械口径):每个 HTTP 端点须 MockMvc + 真实 PostgreSQL IT + Flyway + 覆盖 JSON 的 testFiles 证据锚点,且无 catch_all/generic/sse_placeholder/missing/blocked。当前 242/242 全通过(机械源:覆盖 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 候选生成 + 接受(原样/改后/丢弃)	✅	✅	WorkspacePage 接通 suggestion-merges 与 suggestions/{id}/reject;E1 已补原样/改后合并、采纳归档与旧知识草稿失效，E2 已补拒绝归档，真实生成归 external-live 层复跑
作品规划台(设定/大纲/世界/角色/文风)	✅	🟡	后端就绪;FE 部分
知识与一致性(草稿确认/修正/冲突检查)	✅	🟡	KnowledgeDraftPanel 已有确认/忽略/重验入口;E1 已补 Content 正文变更后旧草稿 needs_recheck
导入解析(上传/按章确认→知识草稿)	✅	✅	完整上传扫描→AI owner 解析→章节确认→Knowledge Draft 向导已补；支持 txt/md、docx/epub 抽取与 New-API LLM 全书解析，浏览器 MSW-off 全链已真验
导出交付(范围/格式/授权校验)	✅	✅	工作台已补格式/范围选择、任务查询与下载凭证消费；真后端 FileService 下载 e2e 已通过
版本历史与对比	✅	✅	只读历史快照 + 任意两版 diff 已接；恢复/回滚仍后置
记录与用量 / 作品设置	✅	🟡	E1 已补工作台记录入口；账户中心记录面仍按 member 进度推进

3. 智能体工作台(ai) — 后端 ✅ / 前端 ✅(核心生命周期)

规范:产品-02D

功能	后端	前端 studio	备注
智能体列表 / 新建 / 编辑 / 归档	✅	✅	E2 agent-create.spec.ts 真实后端覆盖创建、编辑生成 v2、版本切换、归档版本、归档 Agent
配置型 / 工作流型编辑	✅	🟡	配置型核心生命周期已接真后端；工作流型深编辑仍后置
试用与评估(沙盒)	✅	🟡	后端就绪
槽位兼容 / 作品槽位替换(预检/解绑)	✅	✅	E2 agent-slot-bind.spec.ts 真实后端覆盖替换与解绑落库
已安装与授权 / 发布准备 / 运行记录	✅	🟡	后端就绪

4. 知识库工作台(knowledge) — 后端 ✅ / 前端 🟡(主体已接:草稿动作/图谱CRUD/绑定/发布预检)

规范:产品-02E

功能	后端	前端 studio	备注
知识库列表 / 资料管理导入	✅	🟡	后端 59 端点最完整
处理状态与失败恢复	✅	🔴	RAGFlow 真 HTTP + SSRF 防护
知识图谱可视化	✅	✅	读真 Canonical 实体/关系;e2e 8/8
知识来源绑定 + 读回面板	✅	✅	2026-06-19 写→读→端点→FE 闭环;vitest 50/50
草稿确认/忽略/recheck	✅	✅	忽略/recheck 接通(e2e knowledge-draft-actions 2/2);确认入库见候选链
实体/关系 CRUD	✅	✅	图谱内联编辑实体 + 新建关系(e2e knowledge-entity-crud 2/2)
发布到市场·可发布性预检	✅	✅	源侧 publish-prechecks;诚实呈现 blocked(外部校验器未配置,e2e 1/1)
recheck 真校验 / outbox worker	⚪	—	默认关闭,待运维配置

5. 市场(marketplace) — 后端 ✅ / 前端:消费端 ✅、生产端 🟡

规范:产品-02F

功能	后端	前端 studio	备注
市场发现/浏览	✅	✅	消费端
资产获取与授权(install 仅 agent/kb)	✅	✅	work 强制只读、排除可装
资产详情·许可条款·收藏	✅	✅	详情页全量许可 + 收藏(e2e market-asset-detail 1/1)
发布者控制面(草稿/提交/审核/上架)	✅	🔴	草稿保存已通(e2e 8/8),其余生产者 UI 缺
Handoff 一次性令牌	✅	✅	knowledge/agent/content 三类消费端均已真后端 e2e；E4 补 agent 物化与 KB 召回阻断
申诉(提交/补充/撤回/状态)	✅	✅	独立 /market/appeals 治理与申诉入口已接；管理员执行撤权/召回仍在 admin 侧
市场审核治理(管理端)	✅	✅(admin)	见 §1

6. 个人中心(account/member) — 后端 ✅ / 前端 🟡

规范:产品-02G

功能	后端	前端 studio	备注
账户总览	🟡	🟡	部分诚实占位(emailVerified/mfaEnabled 硬编 false)
个人资料 / 安全登录 / 偏好通知	🟡	🟡	安全事件处理动作已接；偏好通知、真实改密/2FA/session service 会话吊销仍缺
Token 与用量总览	✅	✅	/account/usage 真接
权益与配额	✅	✅	/account/entitlements 真接
授权/购买/安装绑定/发布记录	✅	🟡	购买/授权/发布记录三件套已接(PersonalCenter 真接,e2e account-publish-records 1/1);安装绑定等其余记录仍缺
New-API 绑定 / 配额申请 / 导出下载	🟡	🔴	facade Unavailable;FileService 字节投递未接

7. 跨切 / 基础能力(infra) — 后端 ✅ 为主

规范:产品-02、架构

能力	状态	备注
身份认证与会话(权限版本/自动降权/step-up)	✅
权限与数据范围(分层/菜单/操作/数据域)	✅	BcBoundaryArchTest 0 违例
AI 编排与上下文(组装/授权过滤/质量门控)	✅	grant/runtime 完全物理隔离 🟡仅最小 ArchUnit(P2)
知识双轨模型(Shadow/Canonical/Archive)	✅	源状态校验 stale guard
实时事件与通知(SSE)	🟡	后端✅;统一客户端 connectEventStream 未被组件消费
导出与备份(授权/格式/下载审计分层)	🟡	Content 导出已通；Account 导出/FileService 深面仍受限
计费与配额 / New-API 对账	🟡	AI 用量闭环已通；绑定、配额申请和对账深面仍需补齐
多租户/账户隔离 / 统一 API 契约/幂等	✅	commandId 幂等 + 乐观锁
网关路由	🟡	配置完成;运行期转发未验(Nacos/服务发现)
平台底座(system/infra/pay/bpm/mp/report)	✅/⚪	8 模块真实;pay/bpm/mp/report 默认隐藏、0 运行覆盖

---

四、待办表(按优先级)

优先级	待办	所属	阻塞原因
✅ 完成	AI 候选接受链已接通:WorkspacePage 挂 AIPanel/CandidatePanel→真 suggestion-merges(EditorPage 为废弃演示页,故意不接)	content/studio	2026-06-14 MVP#1;e2e 2/2 绿;E1 已补改后合并、采纳归档、旧知识草稿失效；真实生成归 external-live 层复跑
🟡 部分	知识工作台:忽略/recheck、实体关系 CRUD、发布可发布性预检均已接(2026-06-20);剩处理状态/失败恢复 UI	knowledge/studio	仅前端未接
🟡 部分	市场端:许可详情/收藏、handoff 来源侧预检、治理申诉独立入口、**handoff 令牌消费端 knowledge(P1)+agent(P2)+content(P3 asset_use)三 owner token 红线闭环全覆盖(真后端 e2e;⚠️ market 资产物化维度未接、列独立后续主线)**已接;剩发布工作流深面、素材/附件、版本/审核反馈	market/studio	前端深面 + 附件链路未接
🟡 部分	个人中心:购买/授权/发布记录三件套、安全事件处理动作、用量权益已接;剩偏好通知、真实改密/2FA/session service、New-API绑定/配额申请深面	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:13 spec/30 用例本地活体全绿(2026-06-20,补 7 项 studio UI 缺口后)	studio	PG 恢复→rebuild jar→playwright MSW-off 真跑;非 CI,详见进度总账 §五C
🟦 待决策	meta-schema 用量投影方向:评审证伪地基(破坏字段集生产者 + schema_key 来源均须从零建),须人类定"全量+字段级+全真实"还是回退 Content-only+计数优先	meta	见 执行版 v0.2 §九

---

五、文档地图(权威 vs 摘要 vs 归档)

类别	位置	说明
设计 SSOT(唯一)	design-docs/(33 篇)	设计意图单一事实源(要建成什么,≠已实现),实现反向对齐它
进度 SSOT·叙述(唯一)	docs/mvp/进度总账.md	逐任务流水(权威但密);本文是其人读封面
进度 SSOT·机械	docs/superpowers/reports/p1r-api-coverage.json	接口覆盖门机械源(当前 242/242),经 P1rApiCoverageReportTest 校验
本文(人读封面)	docs/项目功能与进度总览.md	功能清单 + 进度 + 待办;权威以上两者为准,本页为口径快照
现状基线(历史)	docs/agent-specs/2026-06-13-...基线.md	2026-06-13 历史快照(已降级、非 SSOT),仅作现状考古
历史过程文档	docs/archive/	已完成阶段工作文档(P0冻结/复盘/P1R解锁等)归档
早期基线归档	docs/dev-baseline/	早期 dev-baseline 历史