消息中心
开发中
消息中心是 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 应用。