什麼是 OpenClix？

OpenClix 是一個革命性的開源框架，旨在將行動應用程式的留存與互動自動化直接帶到使用者裝置上。它摒棄了傳統上過度依賴後端的平台，倡導本機優先、原始碼優先的理念。這意味著所有互動邏輯——例如新手引導提示、連勝提醒和重新參與流程——都由設定檔 (JSON) 驅動，並完全在裝置上執行，無需持續的後端連線或專有 SDK 鎖定。

其核心使命是賦予開發者 100% 的控制權來管理他們的留存工具。透過提供清晰、可審核且可分支的基礎，OpenClix 確保了透明度和可預測性。此外，它特意設計為AI 代理程式友善 (AI Agent Friendly)，具有明確的介面和清晰的編輯點，允許進階使用者或 AI 代理程式 (如 OpenClaw 或 Claude Code) 安全地讀取、修改和擴展互動規則，而不會危及系統穩定性。

核心功能亮點

本機優先執行 (Local-First Execution)： 所有互動邏輯都在裝置上執行，核心功能無需後端基礎設施或託管控制平面。這極大地減少了延遲和營運開銷。
原始碼優先與可自訂 (Source-First & Vendorable)： 使用者將 OpenClix 客戶端程式碼直接整合到他們的儲存庫中 (in-repo)，允許對每個整合細節進行完整檢查和審核。
設定驅動邏輯 (Config-Driven Logic)： 互動規則透過簡單的外部 config.json 檔案進行管理，這些檔案透過事件掛鉤 (event hooks) 與應用程式事件連接，無需重新部署程式碼即可快速迭代。
代理程式友善設計 (Agent-Friendly Design)： 具有明確的資料夾結構、清晰的綱要和文件化的編輯點，使 AI 代理程式能夠安全地修改和擴展留存策略變得簡單容易。
零摩擦/零依賴 (No Friction / No Dependencies)： 在無需 API 金鑰、驗證或依賴專有 SDK 執行環境的情況下運行，遵循 MIT/寬鬆的開源精神。
邏輯透明化： 由於原始碼已納入使用者儲存庫，邏輯完全可審核，確保了完全的透明度。

如何使用 OpenClix

開始使用 OpenClix 的重點在於快速整合和本機迭代：

安裝技能 (Install Skills)： 首先將核心 OpenClix 技能新增到您的專案環境中 (例如，使用 npx skills add openclix/openclix)。
自訂原始碼 (Vendor Source)： 將 OpenClix 客戶端程式碼直接整合到您的應用程式原始碼樹中。此步驟確保您擁有程式碼並可以檢查整合的各個方面。
連接設定與事件 (Connect Configuration & Events)： 在設定 JSON 檔案中定義您的互動規則 (該檔案可透過 HTTPS 提供或本機打包)。將特定的應用程式事件 (如使用者登入、工作階段開始或功能使用) 與設定中定義的相應規則連接起來。
觸發本機流程 (Trigger Local Flows)： 設定完成後，OpenClix 會在本地執行邏輯，根據定義的規則和即時應用程式事件觸發本機通知或應用程式內訊息等動作。由於規則執行的原因可以在本機查看，除錯也變得更簡單。

使用情境

獨立開發者與新創公司： 在一個衝刺 (sprint) 內快速啟動必要的使用者留存功能，如新手引導序列或每日連勝，從而繞過企業級互動平台所需冗長的設定流程。
進行實驗的產品團隊： 在投入資源建構完整的、可擴展的後端互動系統之前，安全地測試不同互動訊息或時機策略的有效性。
管理多個客戶的代理商： 在各種客戶應用程式中重複使用標準化、經過驗證的互動基礎。可預測的交接和 in-repo 原始碼模式簡化了客戶的導入和維護。
AI 輔助開發： 團隊若利用 AI 編碼助手，可以安全地將互動規則的修改和擴展委託給代理程式，因為明確的介面可以防止系統發生災難性故障。
高隱私性應用程式： 對於將資料主權和最小化外部依賴視為關鍵的應用程式，OpenClix 提供了強大的互動工具，且無需將使用者活動資料傳送給第三方控制平面。

常見問題 (FAQ)

Q：這是一個通知函庫還是完整的平台？ A：OpenClix 是一個靈活的框架，提供互動的邏輯引擎。它在本地處理決策制定和流程協調。雖然它可以觸發本機通知，但它不是一個管理推播基礎設施或集中式分析的完整堆疊平台。

Q：我需要後端或推播基礎設施才能使用 OpenClix 嗎？ A：對於核心功能 (運行設定驅動的邏輯和觸發本機動作)，則不需要後端。您只需要一種機制來傳遞初始的 config.json 檔案，該檔案可以透過任何標準 HTTPS 端點提供或直接打包。

Q：我該如何傳遞 openclix-config.json？ A：您可以透過將設定檔直接打包到應用程式原始碼中 (確保最大速度和離線能力)，或從安全的 HTTPS 端點擷取它 (允許在不發布應用程式商店版本的情況下進行遠端更新)。

Q：AI 代理程式真的可以安全地修改它嗎？ A：是的，安全性是核心設計原則。OpenClix 使用明確的介面、清晰的綱要和定義明確的編輯點。這種結構允許 AI 代理程式對設定或邏輯擴展進行有針對性、可審核的修改，而不會破壞底層框架。

Q：OpenClix 什麼時候足夠用，什麼時候我才需要完整的互動平台？ A：當您優先考慮核心流程的控制權、透明度和本機執行時，OpenClix 是理想選擇。如果您需要集中式的 A/B 測試儀表板、複雜的跨平台協調，或基於數百萬使用者彙總資料的超大規模即時區隔，您可能才需要一個完整的平台。

OpenClix