GenericAgent 官方入口：自进化 AI Agent 框架部署指南

搜索“GenericAgent 官网”时，最危险的不是找不到页面，而是先看到一个名字很像、下载按钮也很醒目的第三方站点。GenericAgent 的官方入口可以用两个锚点交叉确认；它没有为任何相似域名、代装脚本或二次打包自动背书。

入口鉴别只看两个锚点

第一个是 GitHub 仓库 lsdefine/GenericAgent，源码、提交历史、安装文档、Issues 与 MIT 许可证都在这里。第二个是项目站点 gaagent.ai，页面上的 GitHub 按钮应回到同一个仓库。域名拼写、仓库所有者或跳转目标有一项对不上，就不要输入 API Key，也不要下载可执行文件。

可靠入口不是“页面看起来像官网”，而是站点、仓库和源码历史能互相印证。

项目站点负责说明，仓库负责落地

官方站点适合快速了解 9 个原子工具、分层记忆、Agent Loop 与演示案例。真正部署时，仓库更重要：你能查看当前命令、依赖范围和代码差异，也能在升级前保留自己的 mykey.py、memory/ 与 skills/。若只从展示页复制命令，却不核对对应提交，页面更新与本地代码版本可能错位。

部署方式要跟运行位置配对

本地桌面部署能利用真实登录态和文件系统，失败时也最可能碰到权限、端口与防火墙问题。服务器部署更容易持续运行，却不天然拥有你的浏览器会话；把桌面能力描述直接照搬到服务器，会得到一个能推理、却摸不到目标界面的 Agent。

远程脚本之前，多做一次安全判断

当前官方中文安装文档提供一键脚本，也提供可审查的源码安装路径。受控电脑或团队环境里，更稳妥的做法是从官方仓库克隆、建立隔离环境、检查依赖后再运行。若一定使用远程脚本，先读取脚本内容、确认下载域名和写入位置；把管道下载的内容直接交给 shell，失败时可能不只是安装中断，还可能改动你没有预期的目录。

API Key 只写进本地 mykey.py，不要提交到 Git，也不要在安装求助截图中露出。升级时使用 git fetch、git pull 后重装依赖，优先保留本地记忆与技能目录。直接删掉旧目录重装，会把 GenericAgent 最有价值的个人工作流一并清空。

验收不是“网页能打开”

1. 仓库所有者、项目站点和跳转目标一致；
2. Python 版本落在支持范围，依赖位于隔离环境；
3. 能导入 agent_loop，能读出当前 Git 提交；
4. 前端启动后只授予测试目录和测试账号；
5. 第一次任务能留下可复核结果，失败时没有越界修改。

把这组核验留在部署记录里。下次看到新域名、新安装包或“官方增强版”时，不需要凭页面设计猜真假，沿着两个锚点重新走一遍就够了。