跳转到内容

消息中心

开发中

消息中心是 cikio 的统一消息基础设施(跨项目,与 authserver 同级), 承载「用户收到的消息」:当前为系统通知,规划中包含私信。从设计第一天起就按多项目接入来做。

项 值
线上地址 https://message.cikio.cn
部署单元 Cloudflare Worker cikio-message
技术栈 后端 Hono + Workers;管理端 React 19 + Vite + Tailwind 4(作为 Worker 静态资源)
存储 Cloudflare D1 数据库 cikio-messages(binding DB),表 messages / preferences
仓库位置 monorepo message/

所有接口以 /api 为前缀。

方法 路径 用途
GET /api/health 健康检查
GET /api/inbox/messages 收件箱消息列表
GET /api/inbox/conversations 会话列表
GET /api/inbox/messages/:id 单条消息详情
POST /api/inbox/messages/:id/read 标记已读
POST /api/inbox/messages/:id/unread 标记未读
POST /api/inbox/messages/:id/archive 归档
POST /api/inbox/messages/:id/unarchive 取消归档
POST /api/inbox/read-all 全部标记已读
GET /api/inbox/unread-count 未读数
POST /api/ingest/messages 投递消息(供其他服务调用)
GET / PUT / DELETE /api/preferences 消息偏好设置

界面侧有两个页面:收件箱 / 与设置 /settings。

迁移文件在 message/migrations/,用 drizzle-kit 生成,通过 wrangler d1 migrations apply 应用。