结论先说
- 新旧两代终端都直接认
GEMINI.md:2026-06-18 起个人账号由 Gemini CLI 迁移到 Antigravity CLI(启动命令agy),官方迁移说明确认本机全局~/.gemini/GEMINI.md、项目内GEMINI.md和AGENTS.md均照常生效。 - 全局与项目文件是拼接叠加,不是二选一:终端从本机全局文件读起,再到仓库根目录,最后读到你当前所在的子目录,越靠近工作目录的指令位置越靠后、针对性越具体。
- 单个规则文件不要写太肥:Antigravity 官方规则引擎对单个
GEMINI.md(展开@导入后)设了24 KB硬上限,超长文档建议按模块拆分并用@路径引入。 - 会话中途改了文件不用关掉重开:在交互终端输入
/memory show或/memory list能核对已挂载的文件,输入/memory refresh(部分版本写作/memory reload)即可当场重新读取。 - 谷歌账号准备与多工具订阅入口:使用 Gemini、Google AI Studio 与 Antigravity 需具备符合地区与年龄要求的个人谷歌账号,缺号可查看本站 谷歌账号购买说明(含带 2FA 的 谷歌邮箱成品号),跨平台付费订阅总览见 AI 会员充值中心。

图:本站根据 Antigravity 官方迁移与规则文档 整理的示意图
本文根据 Google Antigravity 官方文档与 Gemini CLI 命令速查页整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Google 官方网站。
适用于谁
- 在终端使用 Antigravity CLI(
agy)或企业/API 版 Gemini CLI(gemini),不想每次开会话都重复交代技术栈和代码风格的开发者; - 分不清本机全局
~/.gemini/GEMINI.md、仓库根GEMINI.md、子目录文件谁先加载、怎么配合的人; - 改完
GEMINI.md发现当前终端会话没反应,想用/memory命令查看与刷新上下文的人。
一、全局、项目与子目录 GEMINI.md 怎么分工
在终端启动 agy 或 gemini 时,智能体会自动沿目录层级搜集上下文指令文件,并按解析后的真实文件路径做去重处理,确保同一份文件在同一轮对话中不会重复注入:
| 规则层级 | 存放路径 | 生效范围 | 适合写什么 |
|---|---|---|---|
| 本机全局级 | ~/.gemini/GEMINI.md 或 ~/.gemini/config/ | 当前电脑打开的所有仓库 | 固定中文回复、提交信息格式、偏好的包管理器、禁止执行的危险动作 |
| 仓库根目录 | <项目根>/GEMINI.md 或 AGENTS.md | 整个代码库(随 Git 共享给团队) | 项目架构简述、单测与构建命令、分支约定、核心环境变量说明 |
| 子目录局部级 | <子目录>/GEMINI.md(如 apps/web/GEMINI.md) | 该子目录及其下属子目录 | 前端组件命名规范、后端数据库迁移要求、特定微服务接口约定 |
| 模块化规则 | <项目根>/.agents/rules/*.md | Antigravity 工作区常驻或按需触发 | 只有改动特定模块才需要看的专题规范(支持 trigger: model_decision) |
如果你还没完成从旧版 gemini 到新版 agy 的切换,安装与账号支持范围见 Gemini CLI 与 Antigravity CLI 使用对比;如果团队里同时有人用 Cursor、Codex 和 Antigravity CLI,建议把共享规范统一写进根目录 AGENTS.md,跨工具兼容细节可看 AGENTS.md 编写规范与模板。
二、GEMINI.md 怎么写才不容易失效
独立的 GEMINI.md 采用纯 Markdown 编写,不支持顶部 YAML 元数据(只有放进 .agents/rules/*.md 的模块文件才支持配置触发条件)。编写时抓住三条官方边界:
- 指令要具体到可执行的命令:不要只写「注意代码质量」,改成明确的核验指令,例如改完 TypeScript 文件后必须运行对应的类型检查命令。
- 用
@语法做模块化导入:如果仓库里有现成的接口说明或数据库规范,可以在GEMINI.md里用@路径(Antigravity 规则也支持@说明)把外部 Markdown 引进来:
markdown
# 项目开发指令
## 常用构建与验证命令
- 安装依赖:`pnpm install`
- 运行单测:`pnpm --filter api test`
- 类型检查:`pnpm typecheck`
## 编码与安全边界
- 所有接口入参必须经过 schema 校验,禁止使用 `any`。
- 数据库表结构变更必须生成迁移文件,严禁手动改历史迁移脚本。
## 关联子规范
- @./docs/api-error-codes.md
- @./docs/db-migration-checklist.md
- 严控文件体积防截断:在 Antigravity 定制系统里,单个规则文件把
@引用展开后最多保留24,000字节(24 KB),超出部分会按行直接截断;所有常驻规则合计共享20,000Token 预算,超额规则会退化为文件路径指针。因此把最核心的禁令放在前几十行,长篇操作手册改做成按需加载的技能,具体做法见 CLI Skills 技能目录与创建方法。

图:本站根据 Gemini CLI 命令参考页 整理的示意图
三、交互终端里的 /memory 命令怎么用
很多时候刚建好或修改了 GEMINI.md,不确定终端到底读没读进去,或者路径写错了没发现。可以在交互式会话里直接用内置的 /memory 斜杠命令族排查:
- 查看已加载文件清单:输入
/memory list,终端会列出当前会话实际识别到的全局与项目级GEMINI.md路径。如果某份子目录或根目录文件没出现在列表里,先检查文件名大小写(必须全大写GEMINI.md)以及启动终端时的工作目录。 - 核对实际注入的提示词全文:输入
/memory show,终端会打印当前拼接完毕、正在喂给模型的完整上下文指令内容,方便检查@导入有没有展开成功、全局与项目规则有没有自相矛盾。 - 不重启会话热重载规则:在编辑器里改完并保存
GEMINI.md后,回到终端输入/memory refresh(旧版 Gemini CLI 文档中也记作/memory reload),即可重新扫描并载入最新内容。
在 Antigravity CLI(agy)中,各子命令参数会随版本演进更新,首次打开终端可先输入 /help 查看当前客户端内置的斜杠命令全表。若你在使用终端智能体时还没准备好符合地区条件的个人 Google 账号,或想对比其他终端编程订阅,可参考 谷歌账号开通说明 与 四款 AI 编程工具订阅对比,需要搭配 Claude Code 等工具也可在 AI 充值服务总览 查阅。
常见问题
问:全局 ~/.gemini/GEMINI.md 和项目根目录 GEMINI.md 写反了会怎样?
答:两边都会被拼进上下文。如果全局写「一律用 npm」、项目根写「本项目用 pnpm」,模型同时看到两条冲突要求可能会选错。全局文件只放与具体技术栈无关的个人沟通偏好,包管理器和构建脚本一律留给项目级文件。
问:Windows 电脑上的 ~/.gemini/GEMINI.md 具体在哪个文件夹?
答:~ 对应当前登录用户的个人主目录,在 Windows 资源管理器或 PowerShell 里就是 C:\Users\<你的用户名>\.gemini\GEMINI.md。如果 .gemini 文件夹还不存在,手动新建后再放入文件即可。
问:GEMINI.md 和 settings.json 有什么区别?
答:GEMINI.md 是写给大模型读的自然语言提示词与项目背景;settings.json(Antigravity CLI 位于 ~/.gemini/antigravity-cli/settings.json)是给客户端程序读的 JSON 配置项,用来管主题、沙箱开关和默认审批模式,两者不能混写。
问:没有可用的个人谷歌账号,或者同时想开其他主流 AI 会员怎么办?
答:本站提供即买即发的 谷歌邮箱成品号(登录方法见 谷歌账号购买页),同时支持支付宝、微信支付与 AlipayHK 自助充值 ChatGPT Plus、Claude Code 等主流服务,实时价格与质保细则以各商品页说明为准。
相关教程
- Gemini CLI 与 Antigravity CLI 安装登录及迁移说明
- Gemini CLI Skills 技能目录与自定义创建教程
- AGENTS.md 怎么写:多款 AI 编程工具通用规范与模板
- Codex、Claude Code、Cursor 与 Antigravity CLI 对比选型
参考资料
- Antigravity 官方文档:Migrating from Gemini CLI — https://antigravity.google/docs/gcli-migration
- Antigravity 官方文档:Rules & Workflows — https://antigravity.google/docs/rules-workflows
- Antigravity 官方文档:CLI Reference — https://antigravity.google/docs/cli/reference
- Gemini CLI 官方文档:CLI Reference — https://geminicli.com/docs/cli/cli-reference
0 条评论
还没有评论,来抢沙发~