定位 · Positioning
Nexora Loop 是编排层(What / Who / When):管理项目、环境、工单、机器人等业务对象。OpenClaw 是执行层(How):具体的 CI/CD、Agent runner、自动化任务在 OpenClaw / clawline 里跑。两者通过 API / Webhook 解耦,Loop 只发起意图,OpenClaw 负责把意图变成可观测的执行结果。
本仓库由原 wechat-bot-tickets(cspy 莆阳客服)演进而来,逐步扩展成多项目编排平台。生产 alias 仍叫 cspy(域名、容器、PM2 名都没动),源代码库改名为 nexora-loop。
5 个核心抽象 · Five abstractions
Project
仓库 / 业务线
已有Environment
prod / dev / 自定义
已有Bot
客服 / 工程师机器人
已有Ticket / Task
任务编排单元
⏳Release
部署 / 发布记录
⏳技术栈 · Tech stack
Frontend
Next.js 16(App Router) · React 19 · Tailwind v4 · shadcn/ui · @base-ui/react
Backend
NextAuth(credentials)· Prisma 6 · PostgreSQL · pino · server actions
Integrations
WeChat MP(custom service) · Mattermost WS/REST · Feishu channel · mvp-deployer API
Deploy
单机 docker-compose:app + postgres + caddy · 生产域名 cspy.mvp.restry.cn
Dev tooling
pnpm · vitest · gitnexus(2098 symbols / 3637 relations 索引)· cloudflared 隧道 webhook
Streaming
Mattermost WS client + edge SSE,bot 路由 Clawline relay → MM DM(5-10 切换)
9 周 Milestone · Roadmap
- W1改名 + Project / Environment 模型 + 项目列表
- W2Bot 路由切换 Clawline relay → Mattermost DM
- W3接入 mvp-deployer API,同步 inventory / status,PM2 元信息回写
- W4Next 14→16 / React 18→19 升级 + 三个 chat panel 流式 SSE
- W5Feishu Phase 1 channel + 共享 channel 抽象
- W6Embeddable web chat widget + Admin 面板(Phase 1)
- W7Ticket / Task 抽象上线
- W8Release 抽象 + 部署回放
- W9多租户开放 + 集成 webhook 中心
关键 Commit · Recent activity
从 git log 真实捞的,挑了 feat / fix / refactor 中的关键节点。
| 2026-05-30 | feat | widget Phase 1 — Embeddable web chat widget + Admin 面板 |
| 2026-05-30 | feat | feishu Phase 1 — Feishu channel + 共享 channel 抽象 |
| 2026-05-30 | docs | rewrite deployment guide for generic deploy (no mvp-deployer dependency) |
| 2026-05-14 | docs | split PROJECT_MEMORY.md into .devhub/memory/ + PRD |
| 2026-05-11 | refactor | bots & features chat panels mirror consult-panel streaming model |
| 2026-05-11 | feat | MM SSE endpoint — 流式 WebSocket events 推到前端 |
| 2026-05-11 | refactor | sendAndWait 改用 WS 订阅替代 polling |
| 2026-05-10 | fix | channel-wide idle detection 替代单 post 静默检测 |
| 2026-05-10 | fix | React 19 useFormState → useActionState (4 files) |
| 2026-05-10 | chore | bump next 14→16 · react 18→19 · types + eslint-config-next |
| 2026-05-10 | feat | 切换 bot 路由 Clawline relay → Mattermost DM |
架构亮点 · Architecture highlights
-
编排 / 执行解耦
Loop 不跑 CI、不跑 agent,只发"意图"。具体执行交给 OpenClaw / clawline。这条边界让 Loop 永远轻,执行层换实现不影响业务模型。
-
Bot 路由:Clawline → Mattermost DM
5-10 切换后,bot 间通信走 Mattermost(mm.cn.restry.cn)DM channel。配置读取顺序:DB SystemConfig → env → 默认值,可热切。
-
WS + SSE 双段流
从 Mattermost WS client 订阅事件 → server 边缘 SSE 推到前端三个 chat panel,共享 consult-panel 流式渲染模型,typing indicator 全链路。
-
gitnexus 索引护栏
2098 个 symbol / 3637 关系 / 175 execution flow。所有编辑前强制 gitnexus_impact,HIGH/CRITICAL 必须人确认。这是"派 AI 改代码"敢放手的底气。