hoanganh8389/bizcity-twin-ai
Make WordPress as an AI operating system, every plugin becomes an agentic tool The "online Claude" vision — natural language → classify → plan → multi-step execution across plugins, zero config
Bizcity Twin AI – 基於 WordPress 的 AI「數位雙生」平台
每個渠道一個大腦 – 本專案將 WordPress 網站轉換為企業的統一、AI 驅動的知識中心。它從多個通訊渠道（Facebook、Zalo、電子郵件、網頁聊天、Telegram、TikTok 等）接收資料，建立一個 知識圖譜（KG）中心，並透過 托管控制平面（MCP） 向大型語言模型助手（Claude、ChatGPT 等）公開資料。核心功能提供共享的「大腦」（身份、KG、記憶、推理、日誌、自動化、權限）。功能透過 插件 擴充，新增領域特定的操作、新的渠道適配器或 UI 視圖，而無需修改核心程式碼。
功能概覽
| 領域 | 核心提供的功能 | 插件如何擴充 |
|---|---|---|
| 渠道網關 | 標準化進出站訊息，與租戶級身份關聯，並路由至 CRM 或推理引擎。 | channel 插件可新增來源（例如 TikTok Webhook）或自訂路由規則。 |
| TwinCRM | 統一收件箱、聯絡人、對話與活動報告。 | act 插件可建立訂單、更新記錄或推送通知。 |
| TwinBrain / MPR | 每回合的多步推理、工具選擇與編排。 | act 插件公開類型化工具（例如「create-invoice」），大腦可呼叫。 |
| KG 中心 | 儲存實體、段落、來源，並提供帶引用的圖搜尋。 | source 插件可將新文件（產品目錄、法律文件、POS 日誌）輸入 KG。 |
| 自動化與排程器 | 使用者設定的工作流程（觸發器、條件、動作）帶審核門檻。 | act/view 插件提供工作流程中使用的具體動作。 |
| MCP | 基於策略的 API，允許外部 LLM（Claude、ChatGPT）在嚴格存取控制下查詢 KG 或呼叫工具。 | 插件可暴露符合相同策略層的額外端點。 |
| TwinShell / Twin GPT | 內建聊天 UI（/gpt/）與內部使用者的管理控制台。 |
view 插件可新增儀表板、報告或自訂管理頁面。 |
核心概念（「三軸」架構）
- 水平軸 – 溝通網關 – 從所有外部渠道收集原始訊息，並標準化為通用資料包。
- 垂直軸 – 專業插件 – 每個插件貢獻一個 領域（銷售、財務、法律、內容等），不重複核心服務。
- 知識圖譜層 – 單一 KG 中心儲存所有事實並附帶來源；大腦透過查詢它取得基於證據的答案。
典型使用情境
| 使用情境 | 流程（簡化） |
|---|---|
| 多渠道銷售助手 | 客戶訊息 → 溝通網關 → TwinCRM 收件箱 → KG（產品 + 客戶上下文） → TwinBrain 選擇回覆工具 →（可選）人工審核 → 透過相同渠道傳送回覆。 |
| 客戶洞察儀表板 | 定期從 CRM/POS 提取資料 → source 插件將段落推入 KG → 分析工具帶引用讀取 KG → view 插件渲染顯示置信度評分的洞察儀表板。 |
| 內部運營機器人（Telegram/Zalo） | 管理員指令 → 溝通網關（區域 2） → 身份驗證 → TwinBrain 執行工作流程（例如產生報告、觸發 CI） → 結果回傳至機器人。 |
| TikTok 內容創作 | 趨勢研究 → KG 基於檢索 → 影片生成工具 → 審核步驟 → TikTok 發佈適配器（新 channel 插件）。 |
技術堆疊
| 組件 | 技術 |
|---|---|
| 平台 | WordPress ≥ 6.0（PHP 7.4+） – 核心為一般 WP 插件，任何 WP 主機皆可執行。 |
| 核心語言 | PHP（物件導向，Composer 管理相依性）。 |
| 知識圖譜 | 儲存在 WP 資料庫；段落被索引以支援快速向量/圖搜尋（平台提供索引與檢索 API）。 |
| LLM 集成 | MCP 抽象化提供者；內建客戶端類別透過 HTTP 與 Claude、OpenAI ChatGPT 等通訊。 |
| CLI / 腳手架 | WP-CLI 命令（wp bizcity make:*, wp bizcity health, wp bizcity plugin lint）。 |
| 日誌與審計 | 帶中央 bizcity_log_index 的 JSONL 檔案；日誌包含來源，但從不包含原始密鑰或 PII。 |
| 自動化 | 核心內建 DAG 工作流程引擎；插件提供宣告輸入、輸出、冪等性、重試策略的模組。 |
專案健康與成熟度
- 版本：1.3.7（由徽章顯示）。
- 授權：GPL-2.0-or-later – 完全開源。
- 文件：詳細的開發者指南（
docs/vibe/README.md）、貢獻指南與公開開發檢查清單。 - 示範實例：提供管理控制台、GPT UI 與 CRM 的即時示範網站（
libedemo.bizcity.vn）。 - 測試：內建 lint（
wp bizcity plugin lint）、診斷工具與「探測」命令，可在狹小沙箱中執行插件以驗證合約。 - 路線圖：持續進行將更多專業功能從核心移出、改進選擇性 KG 攝取，並完成 TikTok 客戶訊息適配器。
快速入門（啟動步驟）
# 1. 在 WordPress 網站上安裝（必須為 6.0+ 且 PHP 7.4+）
cd wp-content/plugins
git clone https://github.com/hoanganh8389/bizcity-twin-ai.git
cd bizcity-twin-ai
composer install # 拉取 PHP 相依性
wp plugin activate bizcity-twin-ai
# 2. 在 WP 管理面板中新增 LLM/API 金鑰（BizCity AI → LLM 設定）。
# 3. 驗證安裝
wp bizcity health --format=json # 健康檢查
wp bizcity sdk-check --format=json # 核心 SDK 相容性檢查
# 4. 建立新插件（範例：客戶洞察）
wp bizcity make:plugin customer-insight --name="Customer Insight"
wp bizcity make:source crm --plugin=customer-insight
wp bizcity make:tool analyze-customer --plugin=customer-insight
wp bizcity make:event insight-created --plugin=customer-insight
wp bizcity make:diagnostic runtime --plugin=customer-insight
# 5. 填寫生成的 TODO 為業務邏輯，然後執行 lint 與 probe
wp bizcity plugin lint customer-insight --json --strict
wp bizcity probe --id=plugins.customer_insight.runtime --format=json
腳手架建立清單、類型合約、診斷與卸載保護，因此開發者只需實作領域特定程式碼即可。
誰可能使用它？
- 已經運行 WordPress 的中小企業或中型企業，希望擁有單一、可審計的 AI「大腦」用於銷售、支援與內部運營。
- 建構客製化 AI 增強 CRM 的開發者 – 可專注於領域插件，同時重用核心的 KG、推理與安全層。
- 需要在向外部 LLM 暴露內部資料時保持嚴格來源（圖引用、JSONL 審計）的 AI 運維團隊。
總結
Bizcity Twin AI 是一個真正的開源平台，結合了 全渠道資料攝取、知識圖譜支援的檢索、LLM 驅動的推理 與 插件優先的可擴展性，建構於 WordPress 之上。它被定位為企業的「數位雙生」，讓開發者在控制資料治理與審計性的同時，建立 AI 驅動的 CRM、銷售、支援與自動化工具。
相關
- 專案
- Dispatch
- 專案
- Dispatch