[Bug] Unlink 模型来源映射后被 auto-associate 机制立即重建

[panzeyu2013]

版本

main 分支当前提交

影响范围

Service

环境信息

桌面端 / 服务端均受影响

两种表现（同一根因）

表现一：Unlink 后映射被立即重建

复现步骤：

1. 在账号池中添加至少一个活跃账户（或绑定一个聚合 API）
2. 打开模型管理页面，进入任意模型的「路由」弹窗
3. 在「已关联来源」中，对任意一个映射点击 Unlink
4. 观察映射列表

实际结果： 映射被删除后立刻重新出现（新建的映射使用新 ID，enabled=true）。从 UI 上看映射从未消失过。

表现二：账户限流恢复后已禁用的映射被重置启用

链路：

账户被限流 → status 变为 "limited" / "unavailable"
  → 下一次 bootstrap:
      sync_openai_account_source_models_with_options() [apikey_models.rs:483]
        → 第 493 行: .filter(|account| account.status == "active")
        → 该账户被排除
        → 第 513 行: prune_stale_openai_account_source_routes()
            → delete_model_source_routes_for_source()
                → DELETE FROM model_source_mappings WHERE source_id=?
                → DELETE FROM model_source_models   WHERE source_id=?

账户恢复后 → status 变为 "active"
  → auto_associate_source_models:
      existing_source_platform_mappings 为空（已被 prune 删除）
      → 创建新映射 enabled=true  ← 已 disabled 的映射被重置启用

统一根因

场景	触发方式	丢失的用户偏好
Unlink 后重建	手动 Unlink → 映射删 → bootstrap 重建	"我不想用这个来源"
限流恢复后重启用	账户不可用 → prune 删除映射 → 恢复后重建	"这个模型我已禁用"

根源：用户意图（unlink / disable）仅存储在 model_source_mappings 行中，而 auto_associate_source_models + prune_stale_* 机制会无条件物理删除这些行并重建。系统缺少墓碑机制来区分「从未关联过」和「用户主动解除过」。

关键代码位置

• apikey_models.rs:493 — 仅 status == "active" 参与，"limited"/"unavailable" 与 "banned"/"disabled" 同等处理
• apikey_models.rs:513 — 非 active 账户路由全部物理删除，不区分临时/永久
• apikey_models.rs:821-922 — auto_associate_source_models() 仅检查 DB 中是否已存在映射，不感知用户意图
• model_sources.rs:327-346 — delete_model_source_routes_for_source() 硬删除两表，不保留偏好

bootstrap 调用时机（共 7 处）

• 路由 RPC (apikey/modelRouting) — apikey_models.rs:443-444
• 每次代理请求 — proxy.rs:188, 191, 194, 195
• 候选账号筛选 — candidates.rs:49

[panzeyu2013]

解决方案：新增 model_source_mapping_preferences 墓碑表

在 model_source_mappings / model_source_models 之外引入独立的用户意图存储层，使 auto-associate 和 prune 机制感知"用户主动 unlink/disable"的意图。

表结构

CREATE TABLE model_source_mapping_preferences (
    source_kind     TEXT NOT NULL,
    source_id       TEXT NOT NULL,
    upstream_model  TEXT NOT NULL,
    preference      TEXT NOT NULL CHECK (preference IN ('unlinked', 'disabled')),
    updated_at      INTEGER NOT NULL,
    PRIMARY KEY (source_kind, source_id, upstream_model)
);

写入点（7 处）

#	位置	触发	偏好操作
W1	delete_managed (RPC)	用户 Unlink	写入 'unlinked'，然后 DELETE 映射
W2	save_managed	用户保存映射	enabled=false → INSERT OR REPLACE 'disabled'；true → DELETE 偏好
W3	delete_account	账户永久删除	DELETE preferences WHERE source_kind='openai_account' AND source_id=?
W4	delete_aggregate_api	API 永久删除	DELETE preferences/mappings/models（补齐原缺失的 mappings/models 级联）
W5	upsert_discovered_model_source_models	API 下架模型（stale）	DELETE 对应 preference
W6	delete_model_source_routes_for_source (prune 路径)	source 暂时不可用	不级联 — 偏好跨 prune 存活
W7	sync_* (特定 source_id 不可用)	用户请求同步已知不可用 source	DELETE preferences — 确定性清理

读取点（1 处）

#	位置	操作
R1	auto_associate_source_models	批量预加载偏好表 → 循环内 match：'unlinked' → continue；'disabled' → enabled=false；未命中 → enabled=true

关键设计决策

1. RPC 增强：delete_managed 除 id 外额外接收 sourceKind/sourceId/upstreamModel，前端已持有这些数据。避免反查映射（消除"映射已被 prune 删除"的竞态），偏好写入走 keys 直写路径。

2. auto_associate 批量预加载：一次 list_model_source_mapping_preferences(source_kind, source_id) 构建 HashMap，循环内 O(1) 匹配，避免 N 次 SQL 查询。

3. 'unlinked' 和 'disabled' 的优先级：save_managed 的 INSERT OR REPLACE 语义下，后者覆盖前者（用户从 unlink 改为 disable = 主动改变意图）；delete_managed 写入 'unlinked' 也会覆盖 'disabled'（删除 = 更强的意图）。

4. delete_aggregate_api 补齐：原函数仅删除 3 张 API 相关表，未级联 model_source_mappings 和 model_source_models。改为事务版本，补齐与 delete_account 一致的 3 层级联（preferences + mappings + models）。

改动文件（共 10 个）

新增  crates/core/migrations/064_model_source_mapping_preferences.sql

修改  crates/core/src/storage/mod.rs                    # struct + migration 注册
修改  crates/core/src/storage/model_sources.rs          # 表创建 + 4 CRUD + stale 追加
修改  crates/core/src/storage/accounts.rs               # 加偏好级联
修改  crates/core/src/storage/aggregate_apis.rs          # 重写(事务+3级联)
修改  crates/service/src/apikey/apikey_models.rs         # delete/save/auto_associate + W7
修改  crates/service/src/rpc_dispatch/apikey.rs          # RPC 参数扩展

修改  apps/src/lib/api/account-client.ts                 # 传参扩展
修改  apps/src/hooks/useManagedModels.ts                  # 签名扩展
修改  apps/src/app/models/page.tsx                        # 调用点传完整 mapping

四个问题的覆盖

问题	保护层
① Unlink 后重建	W1 → 写入 'unlinked' → R1 swallow
② Disabled 被限流重置	W2 → 写入 'disabled' → W6 跨 prune 存活 → R1 以 enabled=false 重建
③ API 模型变更残留	W5 stale 清理时同步删除偏好
④ 孤儿累积	W3 账户删除 + W4 API 删除（含补齐）级联清理