sandai plugin maintenance

SandAI 插件源码维护与验证

本页面向插件维护者，保存公开插件源码的同步与验证入口。管理员安装包的最小步骤见 SandAI README，对应公开版本和统一应用候选的区别见 版本更新。本页描述公开插件形态，不是未发布统一应用载荷的操作指南。

边界

安装前，宿主必须已安装 SandIAM。SandIAM 负责身份、application、environment、workload client、 credential、service grant 与访问审计；SandAI 仅消费已验证的上下文，并负责模型、能力路由、私有文件、 解析、任务、用量和来源追溯。

SandAI 的主应用开发、演示和生产运行归独立 SandAI 工作区；本目录仅维护开源插件包及其 SandAdmin 安装验证。发布前必须在可丢弃的 PostgreSQL SandAdmin 宿主完成 uninstall -> install -> update -> uninstall 生命周期和真实 API/管理端验收。

修改必须先落在权威仓库，再受控同步到验证宿主；同步后，从权威源码执行 tools/check-sandadmin-export.sh，确认验证副本与源码一致：

printf '已同步的 SandAdmin 宿主根目录：'
IFS= read -r SANDADMIN_ROOT
if [ -z "$SANDADMIN_ROOT" ]; then
  printf '宿主根目录不能为空。\n' >&2
  exit 1
fi
printf '正在检查已同步副本与源码是否一致……\n'
SANDADMIN_ROOT="$SANDADMIN_ROOT" bash tools/check-sandadmin-export.sh

输入由宿主管理员提供，应为含 plugins/sand-ai/ 的宿主根目录。脚本未设置该变量时使用维护者本机路径 /Users/code/project/sandadmin；该默认值不适用于其他机器。退出码为 0 并显示 SandAI plugin source and SandAdmin export are identical. 才表示副本一致；缺目录或存在差异会失败。脚本不安装或同步文件。该文件一致性检查不代替 PostgreSQL 生命周期、真实 API 或管理端验收。

返回 Wiki 首页。