3.8 KiB
开发交接
入口与验证
先阅读根目录 AGENTS.md。工作区四个 crate 的边界必须保持，内核无数据库／HTTP 依赖。用户明确禁止本地测试，不在本机运行检查／冒烟脚本，也不为此下载依赖。指定的远端验证环境是 ces-control；CI 在 Docker 中运行 sh scripts/check.sh、python3 scripts/smoke.py 和真实 PostgreSQL 集成测试。正式持久部署选择 PostgreSQL。检查记录见 validation.md。
核心 API 示例在 aster-core/src/lib.rs，由 rustdoc 实际编译执行。公开语义测试在 aster-core/tests/runtime.rs；伪造句柄仅在私有堆单元测试中构造，禁止为测试添加公开非法构造器。
存储测试用 tempfile 隔离文件，关闭池后重开，验证独立连接生命周期中的持久化。内存测试验证克隆共享、独立 store 隔离、特殊字符参数绑定、更新／缺失键。PostgreSQL 失败测试用只监听但不处理协议的本地 TCP socket，检验真实连接超时和不降级；成功测试显式 ignore，需要用户提供专用测试库。
尚未运行的冒烟脚本用于跨进程调用 CLI、启动 HTTP 宿主、探测真实 TCP 端点、发送 SIGTERM 并确认正常退出。它只创建临时目录，不改 .env，不操作外部服务器。端口通过临时绑定选择，释放后启动间存在很小的端口竞争窗口；在指定验证环境中若冲突，可重试整个脚本。
依赖使用 Cargo.lock。此前编译器为 1.91.1；更换依赖后须在指定环境检查 MSRV 和容器构建版本。核心测试无需数据库，但 Cargo 首次依赖解析仍可能访问注册表；不要因此在本机恢复下载或测试。
下一阶段建议
- 先约定对象字段与方法查找规则、宿主调用的参数／返回值和错误边界，补语义测试。
- 在 core 内构建最小、可测的执行循环，输入先用手写指令，继续不做解析器和渲染器。
- 根据执行栈、对象图、宿主持有引用确定 GC 根集；如需回收槽位，升级代际／间接句柄模型并补陈旧句柄测试。
- 对外部对象、浏览器能力、配额与取消建立最小接口，以实际需求驱动，不预先堆砌空 trait。
- 需要升级元数据 schema 时引入可追踪的迁移；若要求 VM 快照，另行定义持久身份与格式，不能直接序列化现有句柄。
Git 状态与后续远程
origin 为用户提供的 ssh://git@gitea.entroia.com:22222/Zayden-Jung/endorphin-aster-vm.git。仓库级 author 和隔离 SSH 命令已配置；不得复制其他身份或猜测 owner。发布 CI/CD 需要提交、推送并跟踪远端结果；遵守 AGENTS.md 的授权及中文逐文件报告要求。初始开发阶段记录与后续部署记录在 validation.md 中分开说明。
远端 CI 与部署
scripts/ci-ces-control.sh 构建 Dockerfile 的 ci 阶段，创建专属网络与临时 PostgreSQL，再依次运行 workspace 检查、显式 PostgreSQL 测试、SQLite／宿主端到端冒烟。Docker daemon 为 legacy builder，工作流显式设置 DOCKER_BUILDKIT=0；没有依赖 buildx。远端内存约 1.7 GiB，Rust 单任务编译、调试构建不生成 debug 信息。
scripts/deploy-ces-control.sh 仅部署已经构建的 SHA 镜像；使用文件锁防止并行切换生产版本，第一次自动生成服务器密码文件，后续保留。Compose 固定项目名，独占 PostgreSQL 数据目录，与其他项目隔离。部署通过健康检查和真实元数据写入／读取后才切换 current；失败时尝试恢复上一版健康 Compose，不删除数据库或镜像。
更换应用容器不应重建密码或清理数据目录。PostgreSQL major 版本升级与 schema 变更须另外计划迁移；禁止把应用镜像回退当作数据库回退。修改此链路后，验证必须继续放在 ces-control，不要恢复本机依赖下载。