跳转到内容
cikioCIKIO 文档

开发文档

面向在 cikio 生态里写代码的人。本分区只承载对外可见的开发资料：结构、约定、命令与已知的坑。 各子项目的内部设计文档（如 ccu/DESIGN.md、forum/DESIGN.md）仍留在各自目录，不搬进来。

子项目开发说明

Section titled “子项目开发说明”

每个子项目一篇，统一覆盖：技术栈与版本、目录分层、本地开发、数据库迁移、构建与部署、必须遵守的约束。

Monorepo 总览workspace 布局、常用命令、依赖放行、CI 与上线口径。
认证服务Hono + better-auth 的身份中心：分层、迁移、OIDC 与安全约束。
CCUAstro 7 SSR 主站：分层铁律、运行时绑定、D1 迁移与部署。
消息中心Hono Worker + React SPA：双进程本地开发、接口与迁移。
论坛Astro 7 站点：按域拆分的 schema、权限判定与跨站复用。
共享包开发@cikio/* 源码直出包的写法、测试与维护约定。
文档站开发本站的内容与代码分离、校验规则、构建与部署。

仓库结构

Section titled “仓库结构”

cikio 的代码集中在一个 pnpm workspace 仓库 cikio-monorepo：

  • 文件夹cikio-monorepo/ (pnpm workspace 根)
    • 文件夹shared/ (共享包 @cikio/*)
      • 文件夹packages/
        • …
    • 文件夹authserver/ (统一认证中心)
      • …
    • 文件夹ccu/ (CCU 主站)
      • …
    • 文件夹message/ (消息中心)
      • …
    • 文件夹forum/ (社区站)
      • …
    • 文件夹docs/ (本站)
      • 文件夹content/
        • …
      • 文件夹src/
        • …
    • 文件夹dev-docs/ (仓库内部开发文档，不对外)
      • …
    • pnpm-workspace.yaml
    • package.json

各子项目保留自己的 package.json、wrangler.toml 与源码结构，可独立类型检查、构建与部署； dev-docs/ 是仓库内部的设计稿与迁移说明，不参与构建、不部署。

常用命令

Section titled “常用命令”

在仓库根目录执行：

终端窗口
pnpm install          # 安装全部子项目依赖
pnpm typecheck        # 递归对所有子项目做类型检查
pnpm build            # 递归对所有子项目执行构建


pnpm --filter docs dev                        # 启动本站本地预览
pnpm --filter cikio-ccu run dev               # 起某个子项目的开发服务器
pnpm --filter cikio-ccu run deploy            # 部署某个子项目

其他开发资料

Section titled “其他开发资料”