bootstrap-public/AGENTS.md

原生 Shell 仓库

• 直接在本仓库维护原生 Bash 源码；目标机不需要 Python 载荷或私有仓库。

• install.sh 是 Debian 13 的最小 Komodo 接入；独立 upgrade-debian12-13.sh 由人执行。

• 支持 curl -fsSL URL | bash -s -- 参数；管道模式不能依赖脚本所在目录。交互升级读取 /dev/tty。

• 数据参数按字符串处理，不 eval 或 source 用户配置；不把 API/DNS token、私钥写入公开文件。

• 重跑保留身份。信任、公钥、现有配置冲突先停止；不重置网络、防火墙或已有数据库。

• 所有部署动作在 main 内执行，最后再调用，以免流式下载到一半提前修改机器。

• Caddy 发布由 platform/control/publish.sh 从完整 Git 提交选取白名单文件，生成摘要并切换 current。

• 保留固定提交 URL，日常可用稳定 /install.sh 入口。没有真实域名时只给参数示例。

• 修改脚本运行 Bash 语法和相关隔离测试，真机验证独立记录。

• host-init.sh 仅准备前置条件；host-baseline.sh 管只读检查和受限网络策略，ssh-access.sh 管首次 SSH 联合回退。完整基线标准在 platform/docs/host-baseline.md；未知 sysctl/SSH 配置不静默覆盖，普通节点不保留安装源码，不能用本地检查替代外部 SSH 或真实重启验收。

• 固定资源由 artifacts.lock 登记并存入 vendor/，与源码共同提交；目标机仅从显式 Caddy --assets-url 下载，不回退上游。版本变更同时修改安装器固定版本/摘要并检查；发布从同一 Git 提交提取源码与资源。