Files
bootstrap-public/AGENTS.md

15 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 原生 Shell 仓库
- 直接在本仓库维护原生 Bash 源码;目标机不需要 Python 载荷或私有仓库。
- install.sh 是 Debian 13 的最小 Komodo 接入;独立 upgrade-debian12-13.sh 默认交互执行,已有升级与恢复授权可用 --yes --recovery-confirmed;受限 BIOS/GPT 修复需显式 --repair-bios-boot。
- 支持 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 提交提取源码与资源。