前言¶
AI 在長任務中最常見的浪費是空跑：同一個探針腳本換個名字反覆跑，失敗的命令原樣重試，一兩個小時裏一次文件都沒改。插件通過鉤子監控這些行爲，命中後強制 AI 對照最初目標進行自我審查，決定是繼續、換方法還是彙報。
安裝¶
DeepSeek Harness¶
插件頁支持直接粘貼 Git 倉庫地址安裝。本倉庫同時是一個 cordis bundle，通過 tools/result / session/event 事件觀察行爲節奏，經 agent.inject() 注入提醒，無需 Python。
ZCode¶
需要系統可用 python 命令（3.8+）。若可執行名不同，修改 hooks/hooks.json 中的 4 處 python 即可。
核心功能¶
觸發檢測¶
插件註冊四個會話鉤子，不攔截任何工具調用，僅觀察：
1. 完全相同命令重複：最近 5 條命令中有 3 條原樣相同。
2. 相似命令：歸一化後最近 5 條中有 3 條相同（抹去文件名序號）。
3. 超長零產出：會話持續超過 25 分鐘且無文件修改。
4. 調用密集零產出：自上次提醒以來 30 次調用期間無文件修改。
5. 失敗循環：工具連續失敗 3 次。
本地時鐘錨點¶
AI 估不準耗時。空閒運行期間，鉤子注入真實本地時間，要求 AI 凡是涉及耗時預估和彙報都以真實時鍾爲準。間隔從 5 分鐘起步並逐次倍增（5→10→20→40，封頂 60）。
獨立審查者¶
空跑提醒觸發時，用獨立上下文調一次 LLM 審查者。輸出嚴格 JSON 判定（on-track / drifting / stuck）。DSH 端默認開啓（複用會話 llm 服務），ZCode 端默認關閉（需配置 llm_api_key）。
第三通道¶
將審查整體搬出宿主，由獨立進程輪詢。默認關閉，因爲它消耗用戶自己的 API 額度。僅在升級階梯末檔（同一會話第 3 次提醒仍未改善）且顯式配置後投遞。
斜槓命令¶
/lookup-review—— 手動觸發一次完整的「抬頭」自我審查。/lookup-status—— 查看插件對當前會話的監控統計與判定。/lookup-config—— 查看 / 修改閾值配置。/lookup-watch—— 管理第三通道的獨立審查 watcher。
配置與文件¶
配置文件路徑：~/.zcode/ai-look-up. 或 <項目>/.zcode/ai-look-up.。
配置項優先級：內置默認 ← 項目配置 ← 環境變量。
雙端差異¶
| 能力 | ZCode (Python) | DeepSeek Harness (JS) |
|---|---|---|
| 觸發檢測 | ✅ | ✅ |
| 本地時鐘錨點 | ✅ | ✅ |
| 獨立審查者 | 需配 key (默認關) | 複用會話 (默認開) |
| 第三通道 | ✅ | ✅ |
| 狀態存儲 | 落盤 | 內存 (重啓即丟) |
| LLM 配置 | 生效 | 不讀取 (模型跟隨會話) |
注意事項¶
- Python 要求：ZCode 端必須安裝 Python 3.8+；DSH 端無需 Python。
- API 配置：
llm_api_key/llm_api_base/llm_model/llm_timeout_sec只在 ZCode 端生效。 - 第三通道：默認關閉，顯式開啓會消耗用戶 API 額度。
- 狀態持久化：DSH 端狀態在內存，宿主重啓即丟失。
