AMAS 调参管理后台 —— 实施记录与运营手册
自适应记忆与算法系统（AMAS）的"运营级"调参工作台，使非作者也能基于数据安全地调整参数； 必要时由 LLM（默认 DeepSeek）综合数据给出调参建议、可经审批或灰度自动应用。
全景架构
┌────────────────────────────────────────────────────────────────────┐
│ 前端（SolidJS / Tailwind） │
│ │
│ ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │
│ │ /admin/amas- │ │ /admin/amas- │ │ /admin/amas- │ │
│ │ config │ │ metrics │ │ advisor │ │
│ │ Tier-A / 分节 / │ │ C1 延迟时序 │ │ pending / history│ │
│ │ JSON 三 Tab + │ │ C2 版本对比 │ │ approve / reject │ │
│ │ Preset + 版本 │ │ C3 异常表盘 │ │ 成本面板 │ │
│ │ 抽屉 + Diff + │ │ C4 用户状态分布 │ │ │ │
│ │ 回滚 │ │ │ │ │ │
│ └──────────────────┘ └──────────────────┘ └──────────────────┘ │
│ │
│ /admin/settings → 「AMAS 调参自动化」分区（灰度开关 + 阈值） │
└────────────────────────────────────────────────────────────────────┘
│ HTTPS + Bearer admin JWT
┌─────────────────────────────────▼──────────────────────────────────┐
│ 后端（Rust / Axum） │
│ │
│ /api/admin/amas/config (GET / PUT) │
│ /api/admin/amas/config/versions (GET / GET/:hash) │
│ /api/admin/amas/config/versions/:hash/restore (POST) │
│ /api/admin/amas/metrics (GET，snapshot) │
│ /api/admin/amas/metrics/timeseries (GET) │
│ /api/admin/amas/anomalies (GET) │
│ /api/admin/amas/user-state/distribution (GET) │
│ /api/admin/amas/compare (GET) │
│ /api/admin/amas/monitoring (GET，原始事件列表) │
│ /api/admin/amas/suggestions (GET / POST/:id/approve / │
│ POST/:id/reject / │
│ POST/explain / GET/spend) │
│ /api/admin/settings (GET / PUT —— 含 auto-apply) │
└──────────────────────────┬───────────────────┬─────────────────────┘
│ │
▼ ▼
┌─────────────────────────┐ ┌────────────────────────┐
│ SQLite (r2d2 pool) │ │ Worker: llm_advisor │
│ ────────────────────── │ │ ────────────────────── │
│ amas_config_versions │ │ 每 20 分钟 │
│ amas_tuning_suggestions │ │ 收集 evidence → │
│ engine_monitoring_events│ │ DeepSeek → 解析 patch │
│ algorithm_metrics_daily │ │ → 白名单守卫 │
│ system_settings (auto) │ │ → 入 suggestions 表 │
└─────────────────────────┘ │ → 满足条件灰度自动应用 │
└────────────────────────┘数据库
amas_config_versions —— 配置版本快照
| 列 | 类型 | 备注 |
|---|---|---|
| id | INTEGER PK AUTOINCREMENT | |
| version_hash | TEXT UNIQUE | 16 hex；DefaultHasher(serde_json)，与 engine_monitoring_events.config_version 同算法 |
| snapshot_json | TEXT | 完整 AMASConfig JSON |
| author_admin_id | TEXT | 人工写入则是 admin id；自动应用则为 worker:llm_advisor |
| source | TEXT CHECK IN (manual, llm_suggested, llm_auto) | |
| note | TEXT NULLABLE | 例如 restore from <hash> / approve suggestion#42 |
| parent_version_hash | TEXT NULLABLE | 上一个版本 hash（线性链） |
| created_at | TEXT RFC3339 |
amas_tuning_suggestions —— LLM 建议
| 列 | 类型 | 备注 |
|---|---|---|
| id | INTEGER PK AUTOINCREMENT | |
| created_at | TEXT RFC3339 | |
| based_on_version_hash | TEXT | 建议生成时的运行配置 hash |
| patch_json | TEXT | {"memoryModel.baseDesiredRetention":0.85, ...} |
| rationale | TEXT | LLM 用中文给出的理由 |
| evidence_json | TEXT | 喂给 LLM 的指标摘要 |
| status | TEXT CHECK IN (pending, approved, rejected, superseded, expired, auto_applied) | |
| decided_by / decided_at / decision_note | 决策审计 | |
| cost_usd / tokens_input / tokens_output / confidence | 计量 |
system_settings —— 灰度自动应用开关（PR-6 加 3 列）
sql
amas_auto_apply_enabled INTEGER DEFAULT 0 -- 默认关闭
amas_auto_apply_max_per_day INTEGER DEFAULT 1 -- 日额度
amas_auto_apply_min_confidence REAL DEFAULT 0.8三档运营模式
模式 1：仅建议（推荐主路径）
amas_auto_apply_enabled = false- LLM advisor 产出的所有建议落
pending - 管理员在
/admin/amas-advisor看每条建议的 Diff + rationale + cost，逐条批准 / 拒绝 - 批准时自动新建
source=llm_suggested的 config version
模式 2：灰度自动应用
amas_auto_apply_enabled = true+ 每日额度 + 最低置信度- llm_advisor 在生成建议后，额外判断：
- 仅含 1 个 patch 字段（避免一次性大改）
- confidence ≥
amas_auto_apply_min_confidence - 当日 auto_applied 数 <
amas_auto_apply_max_per_day
- 满足时直接写
source=llm_auto的 config version + suggestions 状态auto_applied - 否则落 pending
模式 3：仅解释（不产生 patch）
- 在 Tier-A / 分节 / JSON 任一参数旁点 "问 AI"
- 后端
POST /api/admin/amas/suggestions/explain同步调 DeepSeek - 返回 80 字内的人话解释；不入 suggestions 表，不影响配置
白名单（Tier-A 11 维）
仅这 11 个参数允许通过 LLM 渠道修改（人工渠道可改全部 295 参数）：
| Path | min_safe | max_safe |
|---|---|---|
| memoryModel.w[0..3] | 见 src/amas/tuning_whitelist.rs | 初始稳定性 |
| memoryModel.w[8/9/10] | 稳定性增长 | |
| memoryModel.w[15/16] | Hard/Easy 评级 bonus | |
| memoryModel.baseDesiredRetention | 0.75 | 0.95 |
| memoryModel.maxIntervalDays | 30 | 365 |
任何越界或非白名单 path 都会让 advisor 把建议 status 改为 rejected 并写明原因。
LLM provider 配置（环境变量）
dotenv
LLM_ENABLED=true # 默认 false
LLM_MOCK=false # 设 true 跑端到端，不消耗实际 token
LLM_API_URL=https://api.deepseek.com # OpenAI 兼容协议
LLM_API_KEY=sk-...
LLM_MODEL=deepseek-reasoner # advisor 主路径；hover 可换 deepseek-chat
LLM_TIMEOUT_SECS=60
LLM_DAILY_COST_CAP_USD=1.0 # 超限当天 advisor 跳过
LLM_INPUT_PRICE_PER_MTOK_USD=0.55 # DeepSeek 当前价格
LLM_OUTPUT_PRICE_PER_MTOK_USD=2.19
ENABLE_LLM_ADVISOR_WORKER=true # cron 调度开关SSE 事件扩展（PR-7 D4）
SseEvent 枚举新增 NewLlmSuggestion { suggestion_id }，便于前端 advisor 页实时刷新（前端订阅）。
验证清单
| 类别 | 命令 | 期望 |
|---|---|---|
| 后端 lib | cargo test --lib | 221 passed |
| 后端集成 | cargo test | 全套 passed |
| 前端 | pnpm -C frontend test | 347 passed |
| LLM mock 端到端 | LLM_ENABLED=true LLM_MOCK=true ENABLE_LLM_ADVISOR_WORKER=true cargo run → 等 cron tick → GET /api/admin/amas/suggestions?status=pending | 看到一条 mock pending |
影响与边界
- ✅ 不动 AMAS 核心算法（mdm / ensemble / heuristic）
- ✅ 不动用户端 UI / 不动用户侧 AMAS 调用
- ✅ 现有 amas_config.toml 兼容；新写入仍走 atomic rename + version 表同步
- ✅ DefaultHasher 16 hex 哈希算法对齐，确保 monitoring_events.config_version 与 amas_config_versions.version_hash 互相 JOIN
- ✅ pre-existing
pt_sameday_recursive_consistency与实际 mdm.rs 实现不匹配，修复测试对齐"线性插值"语义 - ⚠️ 自动应用模式默认关闭；启用前建议先观察至少 7 天的 pending 流
- ⚠️ DeepSeek prompt caching 自动按前缀去重，但 Tier-A 白名单变更会破坏缓存