Muse 2.0.0 单人版改造 · 一页边界图

目标:单人自用创作工具 —— 外部依赖收敛到 Dify 一个服务,多用户/平台功能整体隔离,先收地基(1a)再打磨体验(1b)。评审版 v0.1 · 2026-07-07 · 详见同名 .md

1外部服务终态:3 个 → 1 个

改造前(1.0.0)
Muse
New-API生成主链 · 导入解析 · 账户配额管理
RAGFlow知识运行时(建库/上传/检索);GraphRAG 生产零调用
DifyAgent 运行时(刚接入,未部署)
yudao 厂商脚手架 ×9gemini/doubao/mj/suno… enable:true + 明文 key 在仓(须显式关停)
改造后(2.0.0 单人版)
Muse
Dify(唯一外部依赖)
chat/workflow:生成主链 + Agent 运行时 chat/workflow:导入全书解析 Datasets API:知识库 上传/索引/检索
模型 provider 配在 Dify 内,上游可指向自有 New-API 网关(对 Muse 透明)。Prompt 组装与知识授权过滤仍在 Muse 侧 —— Dify 只是运行时,不是事实源。
基础设施:PostgreSQL + Redis + Dify · RAGFlow(退役删除) · New-API 直连(代码保留,不再配置) · yudao 脚手架×9(enable→false+启动断言+key 出仓) · gateway/Nacos(不部署)

2功能边界:留什么 / 隔离什么 / 退役什么 / 打磨什么

保留单人创作主线

  • 作品列表 + 写作台(编辑器/章节/AI 候选采纳/版本 diff/导入导出)
  • 智能体工作台(自建 Agent 生命周期、槽位绑定、沙盒试用)
  • 知识库(上传索引、草稿确认、实体关系图谱、授权检索)
  • 元引擎 MetaSchema(admin 定义 → 动态表单)
  • 单账号登录 + 用量观测
  • admin 治理核心(元结构/功能编排/AI 配置/全局知识库/任务/审计)

隔离搁置多用户 / 平台面(代码保留,装配摘除/开关关闭/入口删除)

  • 市场全链(发现/详情/发布/审核/申诉/handoff/物化/召回)—— 后端摘装配
  • member 多用户子域(权益/配额/归因/New-API 绑定/安全深面/偏好通知)—— 既有开关
  • admin:市场治理、用户与权限(muse.ts 隐藏);yudao 用户/角色/租户/会员/支付/公众号/BPM 菜单(菜单数据停用);newapi 页禁写降只读
  • studio:市场 5 路由、个人中心 5 段、市场耦合入口
  • meta 影响预览 all-real(P0-09)、admin e2e(P0-10)划归多用户线

退役不再回来(git 可考古)

  • RAGFlow adapter + live 验收 IT + env 样例(端口中立化为 KnowledgeRuntimeClient)
  • GraphRAG 全部脚手架(生产零调用,零损失)
  • studio 废弃 EditorPage demo 壳
  • 端口上 7 个从未被生产调用的操作

1b 打磨单人主线缺口(按序补齐)

  • P0-11 规划候选生成(后端空桩→真实现,走 Dify)
  • P0-12 AI 文风检查(后端空桩→真实现)
  • P0-06 知识处理失败恢复 UI(基于 Dify indexing-status)
  • P0-03 版本恢复写入(走 Content 写边界+审计)
  • P1-11 SSE 统一客户端接业务组件

3后端装配终态(muse-server 单体)

muse-server(单进程,直服 /app-api 与 /admin-api)
content 作品/正文 ai 编排/生成 knowledge 知识库 meta 元引擎 member(仅登录/资料/用量) system/infra 底座 market(pom 注释摘除) pay / bpm / mp / report(维持不装配)
摘除前置:新增 3 个 fail-closed 兜底 Bean(@ConditionalOnMissingBean)—— MarketHandoffTokenApi→token 无效 · MarketAssetSourceApi→not found · MarketAssetForkApi→false。market 装回时真实现自动优先。member 投影已有 Unavailable 兜底。

4节奏:1a 地基 → 1b 打磨

阶段 1a · 两条线并行(S0 基线与 S2 机制先于 S3 摘除;S1 是 Dify 线前提)
S0坐实并修复现红门禁基线
S1部署 Dify + contract test 钉契约
S2门禁/测试树机制(profile+dormant)
S3market 摘装配(兜底 Bean,原子生效)
S4member/yudao 脚手架/admin 收口
S5studio 前端裁剪
S6知识运行时 Dify adapter(5 操作)
S7S7.0 输出契约裁决 → 生成主链切 Dify
S8导入解析 Dify parser(New-API 退出门)
S9单机 compose + 黄金旅程 smoke
S10文档沉淀(专题-05/ADR/缺口清单订正)
阶段 1b · 逐项独立立项,真后端 e2e 验收
P0-11 规划候选规划台可创建/采纳
P0-12 文风检查可追踪结果
P0-06 知识失败恢复重试/删除/重传
P0-03 版本恢复新 revision+归因审计
P1-11 SSE 接组件任务进度/通知
Dify 迁移线 隔离线 门禁 收口 1b 打磨
1a 验收:local 门禁全绿 · real-PG 全绿 · Dify live 三链真打 · fail-closed 反向证据 · 创作主线 MSW-off e2e 全绿 · 单机 compose 起全栈黄金旅程 smoke · market API 物理 404。