# Muse 1.0.0 RC 发布说明

> 日期：2026-06-27
> 状态：RC 候选。本文只记录发布决策需要的事实、边界、复跑命令和回滚策略；详细 Epic 证据见 [1.0.0-真验证清单](1.0.0-真验证清单.md)。

## 1. 结论

Muse 1.0.0 线 A 已具备最小可用闭环：作品写作、AI 真生成、候选采纳/拒绝、知识库绑定/上传/检索、市场发现/安装/handoff、账户用量与配额扣减、Admin 基础治理、MetaSchema 字段预校验均有 fresh 真验证证据。

本次 RC 不把 skipped、mock-only、台账门禁计为 passed。GraphRAG attribution、Studio D0-fork UI 物化用例、Admin Playwright e2e、pay/report/bpm/mp 等明确不纳入 1.0.0 线 A 通过项。

## 2. 线 A 已闭环

- Content：写作、自动保存、AI suggestion 采纳归档、改后合并、Block revision 历史最小读面。
- AI：Agent 创建/编辑/版本/归档、槽位 bind/unbind、真 New-API 生成、SSE done、候选采纳/拒绝。
- Knowledge：自建 KB、资料上传、作品绑定、主动检索、no_dataset 可见治理提示、AI 生成消费知识上下文。
- Market：资产浏览/详情/收藏/发布草稿/审核/申诉、agent handoff 物化、KB 召回触达已物化 installed_ref。
- Member：AI 生成预扣/扣减/释放、usage record、attribution job、quota request worker、New-API 管理口 Real facade。
- Admin：system 管理员状态/角色治理、AI 配置关键写命令、market restored 分支真 PG。
- Meta：动态字段值预校验、从空 schemaKey 新建草稿、schema 生命周期真 PG。

## 3. Fresh 验证

- 后端本地层：`bash muse-cloud/scripts/run-p1r-verification.sh local`，61/0F/0E/0S。
- 后端 real-PG：`bash muse-cloud/scripts/run-p1r-verification.sh real-pg`，194/0F/0E/0S，真实 PostgreSQL `_test` 库。
- 后端 external-live：`bash muse-cloud/scripts/run-p1r-verification.sh external-live`，server live 8/0F/0E/0S，module live 4/0F/0E/1S。
- 后端 package：`mvn -B package --file pom.xml`（`muse-cloud`），61 reactor modules SUCCESS。
- Studio：`tsc -b --force` 通过；ESLint 0 errors / 1 既有 warning；Vitest 27 files / 119 tests passed；Playwright MSW-off 全量 61 tests = 60 passed / 1 skipped。
- Admin：`@vben/web-antd typecheck` 通过；Vitest 50 files / 347 tests passed。

## 4. 已知边界

- GraphRAG attribution live IT 未配置独立 opt-in，当前 honest skipped，不计为线 A passed。
- `market-install-kb-retrieval.spec.ts` D0-fork UI 物化用例仍 `test.fixme`，后端 D0-fork/KB handoff/召回已有真 PG 与 e2e 切片证据。
- Admin 未跑 Playwright e2e；本轮覆盖为 typecheck + Vitest + 后端真 PG。
- Quality eval 执行器、完整导入/导出向导、高级版本 diff、偏好/通知、安全写操作、撤权独立入口后置线 B。
- pay/report/bpm/mp 仍不纳入 1.0.0 线 A。
- Meta impact preview 的生产 owner usage contributor 仍要求 all-real；本轮 Meta lifecycle IT 的 `VERIFIED_ZERO` 只证明状态机和装配门。
- 当前 Node v26.3.0 超出 Admin package engines 推荐范围，但本轮 typecheck/Vitest 已通过；发布流水建议使用 package engines 声明的 Node 版本。

## 5. 复跑命令

```bash
cd muse-cloud
bash scripts/run-p1r-verification.sh local
bash scripts/run-p1r-verification.sh real-pg
bash scripts/run-p1r-verification.sh external-live
mvn -B package --file pom.xml
```

```bash
cd muse-studio
./node_modules/.bin/tsc -b --force
./node_modules/.bin/eslint .
./node_modules/.bin/vitest run
set -a && . "$HOME/.config/muse-repo/infra.env" && set +a
env -u HTTP_PROXY -u HTTPS_PROXY -u ALL_PROXY -u http_proxy -u https_proxy -u all_proxy ./node_modules/.bin/playwright test
```

```bash
cd muse-admin
pnpm -F @vben/web-antd run typecheck
pnpm test:unit
```

## 6. 回滚策略

- 后端按 Epic/模块回滚，优先回滚最近变更；涉及 Flyway 的已应用迁移不做 destructive rollback，采用前向修复。
- 前端回滚按 Studio/Admin 独立包回滚；Playwright global setup 夹具变更若导致环境污染，先禁用对应 e2e 并复位 fixture，再决定代码回退。
- 外部服务异常不回滚业务代码；先按 `external-live` 层复跑并确认 New-API/RAGFlow health，再判断是否为外部波动。
- 凭据、生产库写入、DDL 仍走人类闸门；P1r real-PG 只允许 `_test` 库。