Files
ewoooc/docs/adr
OoO 3ea7004a6f refactor(p4)+docs(p5+p6): Meta 降頻 + LOCKED-GEMINI + ADR-028/029
Phase 4 A10 — OpenClaw 雙塔重劃
- run_scheduler.py: Meta 自審 cron 6h → 每日 12:00(月省 2.25M Gemini, +20% 達標)
- scheduler.py: 移除 icaim 內 2 處 inline meta 觸發
- openclaw_strategist 抽 _push_report_with_charts (call×3) + _collect_mcp_intel (call×2)
- 行數目標 -25% 未達(4 報告函數結構差異大,A10 採保守抽出避險)
- 主戰果:Meta 降頻月呼叫 300 → 30(-90%)

Phase 5 — 5 處 LOCKED-GEMINI 註解(涵蓋鎖定 7 場景)
- services/mcp_collector_service.py:32 (場景 #1: Google Search Grounding)
- services/openclaw_strategist_service.py:40 (場景 #2/3/4: 週/月/年報)
- services/code_review_pipeline_service.py:46 (場景 #5: 100K+ token diff)
- services/elephant_alpha_orchestrator.py:88 (場景 #6: EA HITL)
- routes/openclaw_bot_routes.py:98 (場景 #7: PPT 簡報)

Phase 6 A12 — 憲法級 ADR 三份
- ADR-028「LLM 路由統一準則」(269 行)
  - 5 大支柱:三主機級聯 / Ollama 優先 / 雙塔分工 / Gemini 鎖 7 場景 / 可觀測性
  - 8 個 provider 白名單(DB CHECK 對齊)
  - 30+ caller 名單分「已實作 / 規劃中」
- ADR-029「Hermes-First 雙塔分工」(222 行)
  - 12 項職責重劃表 + A7/A8/A10 落地對照
  - Gemini 月支出 -23.5%(critic 第 3 輪 B5 算術修正)
- ADR-027 附錄(+69 行)
  - 三主機架構(Primary/Secondary/Fallback)
  - 4 條獨立 fallback 鏈
  - 廢止「188 Ollama」概念
- README 索引更新

A11 critic 第 3 輪修補:5 BLOCKER 全清
- B1: 行數 1831 → 2677 (含 baseline 對照)
- B2: 場景 #4 行號 759/1267 → 1102/1628 + annual 不存在註明
- B3: 虛構 caller 改實存(ea_hitl_prefetch → ea_engine 等)
- B4: 白名單三層對齊(DB 8 = ADR 8 = token_report 補 ollama_secondary)
- B5: KPI 算術 50→38 = -23.5% 重核

services/telegram_templates.py: A5 daily_token_report() 函數
services/mcp_collector_service.py: 加 LOCKED-GEMINI 註解
services/elephant_alpha_orchestrator.py: 加 LOCKED-GEMINI 註解

103/103 unit test 全綠(zero regression)

Operation Ollama-First v5.0 / Phase 4 A10 + Phase 5 + Phase 6 A12

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-03 23:06:08 +08:00
..

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 PipelineGitea Actions + Docker Compose Accepted 2026-04-19
011 跨專案資源隔離與 Container 管理原則188 多專案共存邊界) Accepted 2026-04-19
012 Agent Action LadderAI 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 fingerprintgunicorn 多 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

規範

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