feat: add agent-guided installer

2026-08-14 15:16:43 +00:00
parent 45ee1ed2b8
commit 298f7f530f
7 changed files with 694 additions and 0 deletions
@@ -18,6 +18,14 @@ MCP 不保存公共业务账号，也不需要部署一个多人共用的远程
 - 可通过浏览器访问目标 NocoBase
 - 管理员已为用户配置所需的 NocoBase 角色与数据权限

+## 推荐：链接驱动的 Agent 安装
+
+正式发布后，优先把对应 Release Tag 下的 [`INSTALL.md`](../INSTALL.md) 不可变链接交给用户。该入口不是 Codex 专用插件：任何能够读取链接、执行本机终端并结构化修改 MCP 客户端配置的 Agent，都可以按协议完成安装。确定性工作由 `scripts/agent_install.py` 处理；Agent 负责识别操作系统与客户端、解释变更、备份并合并客户端配置；用户本人完成 OAuth 登录。
+
+发布方必须保证安装 Agent 能读取链接和相同版本的代码。当前仓库为 private 时，用户需要已经连接有仓库权限的 GitHub 账号；面向普通外部用户的一条链接安装，则必须公开该版本的 `INSTALL.md` 与发布物，或放到用户 Agent 可认证访问的分发渠道。不要把开发分支链接当作交付链接。
+
+这个通用流程默认使用 stdio，因此不需要后台服务或本机 MCP Bearer Token。Linux systemd/HTTP 方式只用于确有附件上传需求的高级场景。
+
 ## 首次安装

 ```bash