English | العربية | বাংলা | Português (Brasil) | Bosanski | Dansk | Deutsch | Español | Français | Ελληνικά | Italiano | 日本語 | 한국어 | Norsk | Polski | Русский | ไทย | Türkçe | Українська | Tiếng Việt | 简体中文 | 繁體中文

# openclaw-cc-camouflage 用於 OpenClaw 的配套維護插件，幫助驗證 not-claude-code-emulator 狀態。此套件不是上游專案的分支。它提供明確工具，沒有自動鉤子。 ## 這是什麼 `openclaw-cc-camouflage` 是一個維護插件，可以： - 在任何操作之前驗證模擬器的存在和健康狀況 - 報告狀態並提供診斷指導 - 為未來的修補操作提供虛設常式實作它在安裝過程中不會自動套用修補程式。所有變更都需要明確呼叫工具。 ## 先決條件和安裝順序安裝順序很重要。在此插件可以運作之前，您必須準備好以下內容： 1. **`not-claude-code-emulator`**（提交 `5541e5c`） - 提供 Anthropic 相容介面的訊息執行階段 - 透過 npm 安裝：`npm install -g not-claude-code-emulator` - 或複製到 `~/github/not-claude-code-emulator` 2. **`openclaw-cc-camouflage`**（此套件） - 最後安裝，在模擬器存在之後設定環境變數： ```bash export OC_CAMOUFLAGE_EMULATOR_ROOT="$HOME/github/not-claude-code-emulator" ``` 或使用備援路徑： ```bash export OC_CAMOUFLAGE_EMULATOR_FALLBACK_PATHS="/opt/emulator:$HOME/.local/share/emulator" ``` ## 可用工具此插件公開四個明確工具。它們不是自動鉤子。 ### `status` 報告模擬器安裝的目前狀態。 ```bash bun run status ``` 輸出格式為機器可讀： ``` emulator=present emulator_version=5541e5c emulator_path=/Users/you/github/not-claude-code-emulator install_mode=local-folder support=supported ``` 結束代碼 0 表示正常。結束代碼 1 表示需要注意某些問題。 ### `doctor` 根據目前狀態提供診斷指導。 ```bash bun run doctor ``` 這會檢查檔案並報告可執行的後續步驟。它不會安裝、修補或修改任何內容。只會讀取和報告。 ### `patch_apply` 將修補程式套用到目標（目前是為未來擴充預留的虛設常式）。 ```bash bun run patch:apply ``` 在目前版本中，這會驗證環境，但不會修改任何對等狀態。未來版本可能會使用回復標記實作實際的修補。 ### `patch_revert` 還原先前套用的修補程式（目前是為未來擴充預留的虛設常式）。 ```bash bun run patch:revert ``` 在目前版本中，這會驗證環境，但不會修改任何對等狀態。未來版本可能會使用回復標記實作實際的還原。 ## 為什麼自動鉤子僅用於驗證此插件中的自動鉤子僅限於驗證和詮釋資料。它們不會自動套用修補程式，因為： 1. 在沒有明確使用者意圖的情況下修改對等方違反了最小驚訝原則 2. 修補失敗需要人工審查，而不是靜默重試 3. 回復需要明確同意才能還原狀態當偵測到漂移時，鉤子會發出警告。由您決定要套用、還原或保持環境不變。 ## 平台支援 | 平台 | 狀態 | 備註 | |----------|--------|-------| | macOS | 支援 | 主要桌面環境 | | Linux | 支援 | 相同的固定上游固定裝置 | | Windows | 支援 | 支援基於磁碟機代號和反斜線的外掛程式探索 | ## 相容性金絲雀要檢查與固定目標的漂移： ```bash bun run compat:canary ``` 這是一個唯讀檢查，可在不修改任何內容的情況下驗證固定裝置完整性和上游參考。它在固定的受支援目標上以 0 結束。 ## 文件 - `docs/install.md` - 先決條件和安裝步驟 - `docs/compatibility.md` - 相容性邊界 - `docs/support-matrix.md` - 鎖定的固定裝置版本 - `docs/non-goals.md` - 明確超出範圍的項目 ## 開發 ```bash # 安裝相依性 bun install # 類型檢查 bun run typecheck # 執行測試 bun run test:unit bun run test:integration # 針對固定裝置驗證修補程式 bun run verify:patches # 檢查發布安全性 bun run check:publish-safety ``` ## 授權 MIT