lili 5acb2503b5 feat(studio): 补齐深面入口

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-28 08:26:47 -07:00

6.2 KiB

Raw Blame History

Muse 1.0.0 RC 发布说明

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

0. RC 基线

RC tag：v1.0.0-rc.1
基线提交：3585219 feat(mvp): 收束1.0.0线A交付闭环
记录时间：2026-06-27 11:05 PDT
分支：dev/1.0.0

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. mini-desktop 部署

部署时间：2026-06-27 11:20-11:28 PDT。
入口：mini-desktop 实际 SSH 入口为 root@100.64.0.7（hostname minione-ubuntu-desktop）。
RC 目录：/opt/muse-rc1。
端口：后端 48081，Studio 4175，Admin 4176；保留既有 48080/4173/4174 上其它项目进程。
运行依赖：已安装 OpenJDK 21；Redis 使用 mini 本机 127.0.0.1:6379 受控实例，密码来自 /root/.config/muse-repo/infra.env，只监听 loopback；PostgreSQL 仍连 100.64.0.8:5433/muse_slice_live。
前端反代：scripts/deploy/mini-desktop/static-proxy.mjs 负责静态文件与 /app-api、/admin-api 反代到 127.0.0.1:48081。
Smoke：后端 GET /app-api/muse/agents、/works、/knowledge-bases 均返回 code=0；http://100.64.0.7:4175/ 与 http://100.64.0.7:4176/ 均 HTTP 200；经 Studio 端口反代 /app-api/muse/works 返回 code=0；经 Admin 端口反代 /admin-api/muse/ai/agents 返回 code=0。
部署修正：远端默认缺 Java 21 与 Redis；apt update 受既有 Docker 源 GPG key 缺失影响，但直接安装 Ubuntu openjdk-21-jre-headless、redis-server 成功。/actuator/health 在当前应用被业务 404 包装成 HTTP 200，不作为健康证据。

5. 已知边界

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。
完整导入向导已在 RC 后补到上传扫描→AI owner 解析→章节确认→Knowledge Draft 链路，并继续补齐 New-API LLM 全书深解析、docx/epub 抽取、_test real-PG V34+ 回归和浏览器 MSW-off 全链 e2e。偏好/通知、真实改密/2FA/session service 会话吊销仍后置线 B。Quality eval 本地确定性执行器、版本历史只读 diff、导出范围/凭证下载 UI 与真实 FileService 下载 e2e、账户安全事件处理动作、市场治理/撤权申诉独立入口已在 RC 后补；真实评估集管理/LLM judge、版本恢复/高级回滚仍后置。
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 版本。

6. 复跑命令

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

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

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

7. 回滚策略

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

6.2 KiB Raw Blame History Unescape Escape