From 83645eaadf7e411083f9dff81ea85fce5f357e06 Mon Sep 17 00:00:00 2001 From: OoO Date: Wed, 13 May 2026 09:29:48 +0800 Subject: [PATCH] =?UTF-8?q?=E8=A8=98=E9=8C=84=20Claude=20=E7=9B=A4?= =?UTF-8?q?=E9=BB=9E=E9=A9=97=E8=AD=89=E7=B5=90=E6=9E=9C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/memory/README.md | 1 + .../claude_inventory_validation_20260513.md | 37 +++++++++++++++++++ 2 files changed, 38 insertions(+) create mode 100644 docs/memory/claude_inventory_validation_20260513.md diff --git a/docs/memory/README.md b/docs/memory/README.md index 78a27cb..850e420 100644 --- a/docs/memory/README.md +++ b/docs/memory/README.md @@ -23,6 +23,7 @@ | `code_modularization_inventory_20260430.md` | Python 大檔盤點、分層規範與拆分工作項目 | 新增功能、拆大檔、審查是否違反模組化治理時 | | `schema_inventory_baseline.md` | DB 表分類與 drift 基線 | 要收斂 migration / ORM / raw SQL 真相時 | | `frontend_v3_handoff_20260512.md` | 前端 V3 守門落地、正式部署、UI/UX 響應式缺口與接續順序 | 新 session 接續前端 V3 全站 UI/UX、手機版確認、`/daily_sales` 或 `/edm` 修正與部署時 | +| `claude_inventory_validation_20260513.md` | Claude Code V1/V2 盤點逐項驗證、已修項與不可盲動清單 | 接續盤點整改、判斷某項是否仍是阻擋、避免重複清已修項時 | ## 關聯 Guide diff --git a/docs/memory/claude_inventory_validation_20260513.md b/docs/memory/claude_inventory_validation_20260513.md new file mode 100644 index 0000000..86d5bd2 --- /dev/null +++ b/docs/memory/claude_inventory_validation_20260513.md @@ -0,0 +1,37 @@ +# Claude Code 盤點驗證記憶（2026-05-13） + +> 用途：接續 V1/V2 全棧盤點整改時，先看這份，避免把已修或已過期的項目重複當成阻擋。 + +## 已驗證並修補 + +- `rag_query_log.saved_call`：已改為只有高信心 RAG 命中且跳過 LLM 時寫 `true`，並補測試。 +- `ai_calls.rag_hit`：logger API 原本可寫但缺回歸測試；已補 `set_rag_hit(True)` 寫入測試。 +- 舊 `SSH_JUMP_* / SSH_TARGET_*`：Python caller 已不存在；已從 `config.py` 與 `.env.example` 範例移除，執行路徑以 `ELEPHANT_ALPHA_JUMP_*` 為準。 +- `filesystem-mcp`：`MCP_BASE_HOSTS` 與 health check 已存在；已補 `ops_diagnostics` 唯讀工具白名單，並測試 `read_file` 可通、`write_file` 被拒。 +- Telegram `cat_` callback：主 OpenClaw route 不是問題；polling bot helper 的預設 `cat` 才是潛在漏 handler。已改預設為既有 handler `trend` 並補測試。 + +## 已驗證為已修或過期 + +- migration / ORM：`032` 已入庫，`033` host label、`034` embedding_signature、`035` business baseline、`036` incidents 雙欄、`037` action_plans guardrails 均已存在。 +- `migrations/031` 權限已是 `644`。 +- `app.py` 的 `SYSTEM_VERSION` 已從 `config.py` import，app 內只留版本註解。 +- V2 提到的 `app.py` 死 import 與 `scheduler.py import schedule` 已不成立；`app.py` 仍使用 `schedule.run_pending()` 等呼叫。 +- Cron 盲區清單多數已補 `_notify_scheduler_failure()`；ROI 月報已避開 09:00 改 09:05，AI smoke 已是 09:10。 +- 0-byte `database/momo*.db` 迷惑檔已不存在；真實 SQLite 僅在 `data/momo_database.db`。 +- `.gitignore` 已涵蓋 `.claude/worktrees/`、`.tmp_*`、`MOMO Pro/`、uploads/screenshots。 +- `cache_service.py` 已成為 `cache_manager.py` 的相容 shim，`_SALES_CACHE_TTL` 單一來源有測試鎖住。 + +## 不可盲動 + +- `services/agent_actions.py` 的 0 靜態 caller 不代表可刪，需先確認 LLM/agent 動態 dispatch registry。 +- `logo_circle.svg` / `logo_navbar.svg` / `logo_transparent.png` 不能只因 runtime `rg` 無引用就刪；設計文件仍規劃品牌頁、登入頁、錯誤頁使用。 +- 多個永遠 OFF feature flag 屬產品/上線策略決策，不應在清債時直接全部改 ON 或刪除。 +- `ai_calls.rag_hit` 不等同 `rag_query_log.saved_call`：跳過 LLM 的 RAG 命中應記在 `rag_query_log.saved_call`；有實際 LLM 呼叫且 caller 明確用了 RAG context 時才適合標 `ai_calls.rag_hit`。 + +## 本輪已推 commits + +- `36d0e5d` 標記 RAG 命中節省 LLM 呼叫 +- `20cab6e` 補上 RAG hit logger 回歸測試 +- `6817f64` 移除舊 SSH jump 設定殘影 +- `44eb369` 補上 MCP filesystem 唯讀白名單 +- `2068a37` 修正 Telegram 分類按鈕預設 callback