From 73ec83ab20e4f7f748fd4f7c126cd417f73b7da1 Mon Sep 17 00:00:00 2001 From: lili Date: Sat, 20 Jun 2026 02:50:00 -0700 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=96=B0=E5=A2=9E=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=E5=8A=9F=E8=83=BD=E4=B8=8E=E8=BF=9B=E5=BA=A6=E6=80=BB=E8=A7=88?= =?UTF-8?q?(=E4=BA=BA=E8=AF=BB=E5=85=A8=E5=B1=80=E5=85=A5=E5=8F=A3)=20+=20?= =?UTF-8?q?AGENTS=20=E4=BB=BB=E5=8A=A1=E5=89=8D=E5=BF=85=E8=AF=BB=E6=8C=87?= =?UTF-8?q?=E9=92=88?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 合成自 design-docs 功能规范 + 主台账/现状基线/.agent/git:看板(整体~76%、后端~80%、前端studio~30%、覆盖门147/233) + 模块进度表 + 功能清单×状态(7域~64功能) + 待办表(按优先级+阻塞原因) + 文档地图。AGENTS 任务前必读加序0指针。 Co-Authored-By: Claude Opus 4.8 (1M context) --- AGENTS.md | 1 + docs/项目功能与进度总览.md | 176 +++++++++++++++++++++++++++++++++++++ 2 files changed, 177 insertions(+) create mode 100644 docs/项目功能与进度总览.md diff --git a/AGENTS.md b/AGENTS.md index 189764bb..53c0535e 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -54,6 +54,7 @@ oh-my-muse/ | 序 | 文档 | 作用 | |---|---|---| +| 0 | [`docs/项目功能与进度总览.md`](docs/项目功能与进度总览.md) | **人读全局**:功能清单 + 进度表 + 待办表(一眼看全局;详细流水仍在 `mvp/进度总账.md`) | | 1 | [`.agents/rules/verification-and-anti-false-green.md`](.agents/rules/verification-and-anti-false-green.md) | **脊柱规则**:完成=机械验证、机械门禁优先、反假绿 | | 2 | `docs/agent-specs/2026-06-13-项目目标与模块现状基线.md` | 项目目标 + 模块**真实**现状(避免重复探索) | | 3 | `docs/agent-specs/2026-06-13-目标达成对抗复盘.md` | 失控根因(假绿)与重定路径 | diff --git a/docs/项目功能与进度总览.md b/docs/项目功能与进度总览.md new file mode 100644 index 00000000..f1a921bf --- /dev/null +++ b/docs/项目功能与进度总览.md @@ -0,0 +1,176 @@ +# Muse 项目功能与进度总览 + +> **用途**:给人阅读的单一全局视图——系统有哪些功能、做到哪一步、还差什么。 +> **更新**:2026-06-20 · **维护**:每次重大里程碑后刷新(详细流水仍在 [`docs/mvp/进度总账.md`](mvp/进度总账.md),本文是其人读摘要)。 +> **数据源**:`docs/mvp/进度总账.md`(主台账) + `docs/agent-specs/2026-06-13-项目目标与模块现状基线.md`(现状基线) + 各模块 `.agent` + git log + 覆盖门 JSON。 +> **图例**:✅ 完成并验证 · 🟡 部分/进行中 · 🔴 缺失或受阻 · ⚪ 设计上暂关闭 · — 不适用 + +--- + +## 一、一眼看全局 + +| 维度 | 状态 | +|---|---| +| **整体完成度(估)** | **~76%** | +| 后端业务实现 | **~80%**(真实端到端逻辑,无桩) | +| 前端用户端 muse-studio | **~30%**(AI 候选链断、知识/市场生产端 UI 缺) | +| 前端管理端 muse-admin | 较完整(meta 治理、市场审核、系统权限均真实) | +| 内部验证覆盖门 | **147/233 操作通过(63%)**(86 项多为"码在、待认证") | +| 跨 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 | — | 24/41 | New-API 真端到端未验;grant/runtime 物理隔离仅最小 ArchUnit | +| **作品/正文** (content) | 82% | ✅ 真实 | 🔴 候选链断 | — | 35/51 | **Accept Suggestion 前端缺**;EditorPage 仍 demo 壳 | +| **知识库** (knowledge) | 72% | ✅ 真实 | 🟡 ~1/3 UI | — | 24/59 | 工作台缺 2/3;recheck/outbox worker ⚪默认关 | +| **市场** (market) | 82% | ✅ 真实 | 🔴 生产端无 UI | ✅ 真实 | 28/32 | 发布/handoff/申诉**生产者 UI 缺**(草稿保存已通) | +| **元引擎/治理** (meta) | 82% | ✅ 真实 | 🟡 用户端引擎缺 | ✅ 真实 | 16/16 | **影响预览 Unavailable → 发布链运行期阻塞**;facade-api 契约未建 | +| **事件/SSE** (events) | 88% | ✅ 真实 | 🟡 统一客户端未接 | — | 1/1 | `connectEventStream` 仅自测、无组件消费 | +| **账户/会员** (member) | 68% | ✅ 真实 | 🔴 ~21% UI | 🟡 受限桩 | 12/33 | 21 端点无 UI;New-API/FileService facade Unavailable | +| **平台底座** (gateway/system/infra…) | 80% | ✅ 真实 | ✅ 真实 | ✅ 真实 | — | 网关运行期转发未验(Nacos);pay/bpm/mp/report ⚪默认隐藏、0 覆盖 | +| **整体** | **~76%** | **~80%** | **~30%** | 良好 | **147/233** | 前端用户端缺口 + 跨 BC 集成偏低 | + +> 覆盖门"操作"=单个 HTTP 端点,须 MockMvc + 真实 PostgreSQL IT + Flyway V1–V21 + 覆盖 JSON 证据锚点、且无 catch_all/generic/sse_placeholder/missing/blocked 才算通过。86 项"待验证"多为"码已在、门未认证",非缺实现。 + +--- + +## 三、系统功能清单 × 状态 + +> 功能名取自 `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 篇) | 产品/架构/前后端/流程的单一事实源,实现反向对齐它 | +| **详细主台账** | `docs/mvp/进度总账.md` | 逐任务流水(权威但密),本文是其人读摘要 | +| **现状基线** | `docs/agent-specs/2026-06-13-项目目标与模块现状基线.md` | 各模块现状权威细节(被各 `.agent` 引用) | +| **本文(人读入口)** | `docs/项目功能与进度总览.md` | 功能清单 + 进度 + 待办,给人看全局 | +| **历史过程文档** | `docs/archive/` | 已完成阶段的工作文档(P0冻结/复盘/P1R解锁等),归档留存 | +| **早期基线归档** | `docs/dev-baseline/` | 早期 dev-baseline 历史 |