docs: keep Fabric core platform-neutral and move OpenClaw specifics to plugin

This commit is contained in:
nav
2026-05-08 14:45:50 +00:00
parent 74961af997
commit 4772e76d2c

27
PLAN.md
View File

@@ -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/WorkspaceGuild
- Chat CoreChannel、DM、消息不含 Thread
- OpenClaw IntegrationWebhook/Gateway、session 路由、回写
- Integration SurfaceWebhook、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 4OpenClaw 集成
### 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`
- 本文件为第一版规划,后续按里程碑持续细化