2.3 KiB
Tabularium working agreements
-
本仓库专门维护 Endor 文档与制图脚本。支持本地开发；CI/CD 仅在 main 使用现有 ces-control Runner，验证通过后自动部署；工作分支与 PR 不运行 CI，确认 Runner 不构成扩大触发范围的授权。不得修改其他项目、共享 Runner 配置或清理共享 Docker 缓存。
-
Web 技术栈为 TypeScript、React、Tailwind CSS、Next.js Pages Router；不要切换到 App Router。
-
使用 pnpm 管理 JavaScript workspace，使用 uv 管理
tools/figures的 Python 项目，保留两套锁文件。 -
文档正文、目录元数据与修订记录以站点现有 SQLite 数据库为唯一权威源，使用文档 API 或 docs 管理工具直接更新；不得把新正文、目录 JSON、数据库文件或日常内容快照提交到仓库。历史 Git 文档只用于显式的一次性迁移，不作为运行时种子。Python 图形源码放在
tools/figures/src/endor_figures，可复现的 SVG 输出放在apps/docs/public/figures。 -
编辑已有文章时优先使用章节 API：先读取章节目录与内部摘要，据此选择需要读取正文的章节，再提交单章或多章操作。摘要缺失时先读对应正文并补充；修改观点前必须核对该章原文，检查读取版本与提交 revision 一致。摘要只写入内部章节数据，不放入网页正文、目录摘要或 Git；改写正文时同步更新摘要。完整操作与 Python 客户端用法见 README 的「先读摘要，再按章节编辑」。
-
未确认的架构提议明确标注为草案，不能表述为现有实现。
-
本地开发与预览只监听
127.0.0.1。部署容器监听0.0.0.0:3000，服务器入口默认 18135，可通过独立 production.env 配置。 -
对 gitea.entroia.com 仅使用 codex-bot，提交身份为 Codex Bot codex-bot@gitea.entroia.local。SSH 使用隔离配置：
ssh -F /dev/null -o IdentitiesOnly=yes -i /Users/zzyang/.codex/credentials/gitea-entroia/codex_entroia_ed25519 -p 22222。 -
每个可验证阶段完成后提交并推送当前远程分支；远程尚未创建时保留本地提交并说明原因。不借用其他账户、不强推。
-
构建按输入内容摘要复用已验证镜像。pnpm、uv、Next.js 缓存按 main/PR 隔离并持久保留；部署与回退只使用
--no-build。