# 原生 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 提交提取源码与资源。