AGENT

工程规范

2026/04/24 2 min read AGENT AI改造计划 工程规范

你这个结论其实挺对的方向,但我帮你校正一下,更工程化一点,不然你以后还会踩坑。


🧠 一句话优化你的结论

✔ 本地:开发 + 源码(对)
✔ 服务器:运行(对)
❗但不只是“编译产物”,而是“可运行构建 + 配置”

🔥 一、你刚才踩的坑,本质是什么

你这次炸的原因不是“AI傻”,核心是:

❌ 源码、运行环境、部署目标 混在一起
❌ AI在远端直接改运行系统
❌ 没有“环境边界”

👉 你刚才的实际状态是:

本地(Atramenti-Console)

远端(aiclient2api + runtime)

AI在两个地方同时改

👉 结果:

✔ 改错系统
✔ 改了没效果
✔ 还污染环境

🧱 二、正确的工程结构(你应该这样做)

我给你一个**标准结构(以后不再炸)**👇


🥇 本地(唯一源码真源)

E:\projects\
   ├── aiclient2api   ← 真源码
   ├── gateway        ← 你未来自己写的
   └── other projects

👉 规则:

✔ 所有代码只在本地改
✔ 所有git提交从这里发
✔ AI只允许在这里动代码

🥈 GitHub(备份 +版本控制)

GitHub repo

👉 作用:

✔ 版本回滚
✔ 防止AI乱改
✔ 对比差异

🥉 服务器(只负责运行)

/home/ubuntu/app
/srv/aiclient-2-api-mock

👉 里面只应该有:

✔ 构建产物(dist / build)
✔ configs(provider_pools.json)
✔ .env
✔ node_modules(或容器内)

👉 不应该有:

❌ 开发源码随便改
❌ AI直接改代码
❌ 临时脚本乱堆

💥 三、你刚才说“服务器只放编译的”——需要纠正

不是这样👇


❌ 错误理解

服务器 = 只放编译产物

✔ 正确理解

服务器 = 可运行版本(runtime)

包括:

✔ build结果(如果是前端)
✔ node源码(如果是node服务)
✔ config(关键)
✔ 环境变量
✔ 容器 / systemd

👉 重点:

config 比代码更重要

你这次炸的就是:

provider_pools.json

🧠 四、为什么你会觉得“AI很傻”

你这次踩的是一个经典问题:

AI不会自动理解“系统边界”

👉 它只会:

看到报错 → 找代码 → 改代码

👉 但不会主动:

❌ 判断是不是另一个系统
❌ 判断是不是远端运行态
❌ 判断是否应该停止修改

👉 所以你必须:

✔ 人为锁边界

🔥 五、你以后必须遵守的规则(非常关键)


🚫 禁止

AI直接改服务器代码
AI跨项目修改
AI在未知目录写文件

✅ 必须

1. 所有代码修改 → 本地
2. 改完 → git commit
3. 再 deploy 到服务器

👉 一句话:

服务器 ≠ 开发环境

🧠 六、你现在这个项目的正确流程


正确闭环👇

本地改代码

git commit

push GitHub

部署(scp / docker / CI)

服务器运行

👉 而不是:

❌ 服务器直接改
❌ 改了还不知道在哪生效

💥 七、你这次最大的收获(其实很值)

你已经踩到了:

✔ AI开发的最大坑
✔ 多系统边界问题
✔ runtime vs source问题
✔ 配置优先级问题
✔ 路由层 vs 配置层问题

👉 这些是:

工程能力的核心

🧠 最后一刀总结

你刚才那句话是对的,但更准确是:
 
✔ 源码必须在本地(单一真源)
✔ 服务器只负责运行(不可随便改)
✔ AI必须被限制在“一个项目边界内”

🚀 如果你要我帮你做“不会再炸的结构”

我可以帮你:

✔ 一套干净的 aiclient2api 开发 + 部署结构
✔ 自动 deploy 脚本(不会乱)
✔ 本地/远端严格隔离方案

你只要说:

给我干净结构

我直接给你一套以后不会再被AI带崩的架构