memind_adm/docs/103-realignment-plan-2026-06-26.md

memind_adm 103 收口方案（2026-06-26）

当前判断

memind_adm 是三个仓库里最需要继续做“差异回收”的一个。

已确认：

1. 103 运行目录：/Users/john/Project/memind_adm
2. 103 目录仍是 Git 工作树，但存在大量工作区漂移。
3. 本地 test-memindadm 与 103 的主要分叉集中在用户详情、空间额度、套餐同步、启动装配。

当前高价值差异

线上独有

• server/llm-provider-loader.mjs

说明：

线上仍保留一层 provider 加载包装逻辑，本地主线已经切到共享实现。

本地主线独有

• server/plan-sync.mjs
• 用户详情空间字段相关前后端改动
• 生产发布规则与 release-prod.sh

说明：

这部分更像你现在真正想推进的新主线能力，不应该被线上旧装配回压掉。

双方都改了

• server/app.mjs
• server/bootstrap.mjs
• server/index.mjs
• src/admin/pages/BillingPage.tsx
• src/admin/pages/UserDetailPage.tsx
• src/admin/pages/UsersPage.tsx
• src/api/client.ts
• src/types.ts

收口目标

把 memind_adm 从“线上和本地双向分叉”收口成：

1. 本地 test-memindadm 是唯一源码真相。
2. 103 不再保留未回收的独立逻辑分叉。
3. 用户详情、空间额度、套餐同步、共享用户体系都以本地主线为准。

具体执行步骤

第一步：锁定必须保留的本地主线能力

这一组应默认保留：

1. 用户详情页独立拉取
2. spaceQuotaBytes
3. spaceUsedBytes
4. spaceReservedBytes
5. spaceAvailableBytes
6. 计划同步与同步结果展示

原因：

这组能力与近期真实需求直接相关，不应为了回收线上旧逻辑而退回。

第二步：单独审查线上独有装配逻辑

重点只看：

• server/llm-provider-loader.mjs

审查目标：

1. 它是否只是旧兼容层
2. 它是否包含线上必需但本地没吸收的行为

处理原则：

1. 如果只是兼容包装，就把必要逻辑回收到本地主线并删除分叉。
2. 如果确有线上必需行为，就先吸收进本地主线，再发布。

第三步：不要再把线上旧代码当默认正确答案

103 这里的作用只有两个：

1. 证明线上曾经这样跑过
2. 提供必须回收的旧逻辑证据

它不是：

1. 后续开发主线
2. 可继续直接修代码的地方

第四步：做第一次本地主线收口发布

1. 在本地完成必要逻辑吸收。
2. 整理成最小 commit。
3. 用 bash scripts/release-prod.sh 发布到 103。
4. 发布后验证：
   • http://127.0.0.1:8085/health
   • http://127.0.0.1:5174/
   • 真实登录
   • /admin-api/users
   • 用户详情页
   • 空间字段展示与更新

何时算收口完成

满足以下条件即可视为完成：

1. server/llm-provider-loader.mjs 的必要行为已被明确处理
2. 空间额度与用户详情逻辑只在本地主线维护
3. 最近一次线上版本来自本地发布包
4. 共享用户体系与后台业务路径验收通过