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