From 4772e76d2c90b8174d472f695ec1e3731525080a Mon Sep 17 00:00:00 2001 From: nav Date: Fri, 8 May 2026 14:45:50 +0000 Subject: [PATCH] docs: keep Fabric core platform-neutral and move OpenClaw specifics to plugin --- PLAN.md | 27 +++++++++++++++------------ 1 file changed, 15 insertions(+), 12 deletions(-) diff --git a/PLAN.md b/PLAN.md index 1f84797..a67558e 100644 --- a/PLAN.md +++ b/PLAN.md @@ -1,17 +1,16 @@ # Fabric 项目规划 v0.1 ## 1. 项目目标 -**Fabric**:一个可自部署的类 Discord 聊天系统,核心目标是提供稳定、低摩擦的 **Agent 沟通渠道**,并对 OpenClaw 友好。 +**Fabric**:一个可自部署的类 Discord 聊天系统,核心目标是提供稳定、低摩擦的沟通渠道。 ### MVP 成功标准 - 支持多人频道聊天 + 私聊 -- 支持接入 OpenClaw Agent 并在频道内对话 - 支持基础权限与审计日志 - 提供 Docker Compose 一键部署 - 单机可稳定服务 50~200 并发在线(MVP 目标) ## 2. 项目定位(一句话) -> 一个可自部署、类 Discord 的实时聊天系统,原生支持 OpenClaw/Agent 双向协作。 +> 一个可自部署、类 Discord 的实时聊天系统;本体保持平台中立,通过插件生态对接外部系统。 ## 3. MVP 必要功能 1. **账号与组织** @@ -26,12 +25,11 @@ 3. **实时通信** - WebSocket 实时消息推送 - 在线状态、输入中、消息同步 -4. **OpenClaw 集成(核心差异化)** - - Agent 绑定与配置 - - 可配置路由:频道消息 -> OpenClaw session - - 消息回写与工具状态展示 - - “工具调用卡片”与审批流(approve/reject) - - Webhook + Gateway 双模式(MVP 先做 Webhook) +4. **插件友好设计(本体中立)** + - 本体不内置 OpenClaw 专属逻辑 + - 提供稳定事件模型(消息创建/编辑/删除、成员事件、权限变更) + - 提供清晰 API 边界(鉴权、幂等、分页、速率限制、错误码) + - 为外部插件保留扩展点(Webhook、Bot Token、Outbound 回调) 5. **权限与审计** - 基础角色(admin/member) - 审计日志(关键操作留痕) @@ -48,15 +46,17 @@ - `Fabric.Backend` - Auth/Workspace(Guild) - Chat Core(Channel、DM、消息;不含 Thread) - - OpenClaw Integration(Webhook/Gateway、session 路由、回写) + - Integration Surface(Webhook、Bot Token、扩展回调) - Permission & Audit - `Fabric.Frontend` - 工作区/频道 UI - 消息流、输入框、回复/编辑/删除/@ - - Agent 状态与工具卡片展示 + - 平台中立 UI(不内置 OpenClaw 专属交互) - `Fabric.OpenclawPlugin` - OpenClaw 侧适配与路由配置 - 会话映射、回执状态、错误处理 + - 工具调用卡片与审批流(approve/reject) + - Webhook + Gateway 双模式(MVP 先做 Webhook) - `Fabric.Desktop` - Desktop 客户端壳(后续) - `Fabric.Android` @@ -75,10 +75,11 @@ - WebSocket 推送 - 在线状态、输入中、消息同步 -### Week 4:OpenClaw 集成 +### Week 4:插件集成(在 `Fabric.OpenclawPlugin`) - Agent 绑定配置 - 消息路由与回写 - 工具状态卡片(running/success/error) +- approve/reject 审批流 ### Week 5:权限与运维 - 角色权限(admin/member) @@ -102,4 +103,6 @@ ## 8. 当前状态 - 所有仓库已创建为 Public - `Fabric.*` 已作为子模块挂载到 `Fabric` +- 本体保持平台中立:不包含 OpenClaw 专属业务逻辑 +- OpenClaw 相关能力集中在 `Fabric.OpenclawPlugin` - 本文件为第一版规划,后续按里程碑持续细化