wooo/ewoooc
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
3fca720fa156099ae3b8cb20afdfaa7ea77dbee5
ewoooc/docs/adr/README.md
OoO 390c32b05d
All checks were successful
CD Pipeline / deploy (push) Successful in 2m45s
Details
feat(p21): Caller × Context 動態 Model Router + ADR-034 
Operation Ollama-First v5.0 / Phase 21 — 動態路由治理

services/llm_model_router.py (160+ 行)
- 純規則引擎，零 LLM 成本（Python lambda predicate）
- 6 caller × 12 條路由規則：
  • sales_copy: 短文 < 100 字 → gemma3:4b / 長文 → llama3.1:8b
  • hermes_analyst: gap > 20% 或銷量 < -50% → qwen3:14b / 預設 hermes3
  • aider_heal: diff > 200 行 → qwen2.5-coder:32b / 預設 7b
  • openclaw_qa: query > 200 字或 multi_turn → qwen3:14b / 預設 qwen2.5:7b-instruct
  • ppt_vision: minicpm 不健康 → llava / 預設 minicpm-v
  • ea_engine: require_chain_of_thought → deepseek-r1:14b / 預設 Gemini
- feature flag MODEL_ROUTER_ENABLED 預設 OFF（向下相容）
- 失敗安全：predicate 例外 skip 到下一條

tests/test_llm_model_router.py (18 tests 全綠)
- T1 flag OFF 不路由
- T2 sales_copy 短/長文路由
- T3 hermes 簡單/複雜 SKU
- T4 aider_heal 簡單/重構
- T5 ppt_vision 主備援
- T6 ea_engine CoT 路由
- T7 predicate 例外容錯
- T8 utility 函數

ADR-034 — Caller × Context 動態 Model Router
- 6 caller 路由規則對應表
- 5 段否決方案（LLM-based / hardcode / 配置檔 / 統一升級）
- Phase 21.2-21.6 戰略性遷移計畫
- V1-V3 驗收 SQL（caller 整合後 model 分布觀察）

關聯：Primary + Secondary 兩台 GCP 已備齊 10 模型（67GB 對稱）支援所有
路由規則；caller 整合可分階段進行（Phase 21.2-21.5）。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 10:54:12 +08:00

6.0 KiB
Raw Blame History

Architecture Decision Records (ADR)

本目錄記錄 EwoooC（原 MOMO Pro System）的所有重大架構決策。 專案範圍：momo-pro-system 目錄（不含 AWOOOI / WOOO AIOps SaaS Platform） 遵循本專案的 Codex 工作規則：AGENTS.md（入口）+ CONSTITUTION.md（紅線）+ ADR（決策）+ Memory（輕量索引）

編號規則

  • 格式：ADR-XXX-kebab-case-title.md
  • 編號連續遞增，已撤銷的 ADR 保留編號（標記 Status: Superseded by ADR-YYY）

狀態

狀態 說明
Proposed 提案中，尚未實作
Accepted 已批准，正在實作或已實作
Deprecated 已被取代，但保留歷史
Superseded 被新 ADR 完全取代

索引

ADR 標題 狀態 日期
001 三 Agent 自主學習分工（Hermes/NemoTron/OpenClaw） Accepted 2026-04-18
002 pgvector 作為唯一 KM 向量庫 Accepted 2026-04-18
003 Embedding 本地化到 Ollama 主機 Accepted 2026-04-18
004 NemoTron 配額耗盡 fallback 至 Hermes Rule-based Accepted 2026-04-18
005 KM 品質分數加入時間衰減 Accepted 2026-04-18
006 專案正名 MOMO Pro System → EwoooC Accepted 2026-04-18
007 AI 學習雙寫規範（DB + KM 同步寫入） Accepted 2026-04-18
008 正式運行環境確認 — 188 Docker Compose(非 110 K3s) Accepted 2026-04-18
009 Embedding Retry Queue 持久化（DB-backed） Accepted 2026-04-19
010 EwoooC Gitea CI/CD Pipeline（Gitea Actions + Docker Compose） Accepted 2026-04-19
011 跨專案資源隔離與 Container 管理原則（188 多專案共存邊界） Accepted 2026-04-19
012 Agent Action Ladder（AI Agent 事件介入與自動修復三級信任邊界 L0/L1/L2/L3） Accepted 2026-04-19
013 AIOps 自動修復閉環架構（七步閉環 + SSH Jump Executor） Accepted 2026-04-19
014 PPT 簡報系統 V2 — 原生圖表 + 9 種報告類型 Accepted 2026-04-20
015 Telegram Bot 完整菜單系統恢復 Accepted 2026-04-20
016 daily_sales cache fingerprint（gunicorn 多 worker 一致性） Accepted 2026-04-29
017 模組化收尾路線圖（Phase 3f） Accepted 2026-04-29
018 四 AI Agent 自動化控制面（Hermes/NemoTron/OpenClaw/ElephantAlpha） Accepted 2026-04-29
019 Telegram Bot Agentic Conversation Layer（菜單→Agent 決策統一入口） Accepted 2026-05-02
020 Code Review 全自動修復政策（局部覆寫 ADR-012 HITL） Accepted 2026-05-02
021 EA HITL Pre-fetch + 競價告警必填金額影響量化 Accepted 2026-05-03
022 PPT v3 — 暖紙風 + matplotlib 專業圖表 + 模板版本快取 Accepted 2026-05-02/03
023 PPT 系統 Wave 1 擴展 — 廠商 / 期間回顧 / 品類深度 / 客戶分析（8 種新報表） Accepted 2026-05-03
024 PPT 系統 Wave 2 — 檔期前瞻 / 多活動比較 + bcg/growth 廢除 Accepted 2026-05-03
025 PPT 系統 Wave 3 — 新品 30 天追蹤 + 市場情報週報 Accepted 2026-05-03
026 PPT 系統 — 價格彈性報告 + 完整戰役收尾路線圖 Accepted 2026-05-03
027 Primary Ollama 遷移至 GCP 高效能主機（v5.0 戰役後追加附錄：三主機架構 / 4 fallback 鏈 / 廢止 188 Ollama） Accepted 2026-05-03
028 LLM 路由統一準則 — Ollama-First 五大支柱（補述 ADR-027） Accepted 2026-05-03
029 Hermes-First 雙塔分工（戰術主塔 / 戰略副塔，Gemini 月支出 -23%） Accepted 2026-05-03
030 Frontier 多供應商策略（Anthropic + Google + OpenRouter；Phase 7 Code Review 升 Claude Opus 4.7） Accepted 2026-05-03
031 MCP 自建 Stack（postgres + omnisearch + firecrawl + filesystem；含 Owen 護欄 #2 Firecrawl 2g 限制） Accepted 2026-05-04
032 RAG 自主學習迴圈 — Distiller + PromotionGate + 反饋環（Phase 11） Accepted 2026-05-03
033 RAG 治理三護欄 — Promotion Gate / Firecrawl 資源 / BGE-M3 一致性（Owen v5.0 鐵律） Accepted 2026-05-03
034 Caller × Context 動態 Model Router（短文 gemma3 / 複雜 SKU qwen3:14b / 重構 coder:32b） Accepted 2026-05-04

規範

  1. 任何重大架構決策（影響三條產品線之一、改動資料結構、引入新依賴）必須建 ADR
  2. 每份 ADR 包含：Context（背景）→ Decision（決策）→ Alternatives Considered（替代方案）→ Consequences（後果）
  3. 建立後同步更新：本 README 索引、相關 SOT 文件、docs/memory/README.md（若有新的長期記憶入口）
Reference in New Issue View Git Blame Copy Permalink