1.2 KiB
1.2 KiB
构建与入口
人类默认从 / 进入；Agent 从 /agent 或 /agent/index.md 读取 text/markdown 索引，根目录 /llms.txt 提供发现链接。索引复用技能目录，技能继续使用 /skills/<id>/SKILL.md 和现有子文档 URL，避免复制文档。
ces-control 必须预装 Docker、Compose，并允许 Runner 访问持久 Docker daemon。CI 只检查环境，不安装系统包、不启停主机服务。当前服务器没有 buildx，先继续使用 daemon 自带层缓存；不要直接粘贴依赖 GitHub cache 服务的 type=gha 参数。后续若换 Docker daemon 或清理缓存，会重新冷构建。
Dockerfile 显式复制构建输入；根 Markdown 和 docs 不再使应用构建层失效。push 和 PR 对纯文档改动使用 paths，但 public 下的 Markdown 属于产品资源，必须构建部署。新添根级构建配置时，需同步 Dockerfile COPY。仍保留类型检查、单元测试、smoke 与完整隔离栈集成测试。
当前页面为 Next.js SSR 与编译组件，改 TSX 仍需 next build。把 HTML 的 COPY 移到最后不能避免编译。独立挂载静态文件会破坏镜像版本与回滚的一致性；只有真正独立、无需编译的内容才适合后续拆成单独发布渠道。