跳至主要內容

Gemini AI 助手配置指南

2026/2/4AI工具开发指南GeminiGoogleAI Agent配置指南大约 4 分钟...

本文档专门说明如何配置 Google Gemini AI 助手以遵循本项目规范。

📋 前置阅读

在配置 Gemini 之前，请先阅读：

🔧 Gemini 配置方法

配置方式：User Rules / Memory

Gemini 通过 User Rules 或 Memory 机制加载项目规范。

步骤 1: 打开 Gemini 设置

  1. 访问 Gemini 界面
  2. 找到设置选项
  3. 定位到 "Memory" 或 "Custom Instructions" 部分

步骤 2: 添加项目规范

将本文档的内容（或 AGENTS.md 的内容）复制到配置中：

项目名称: OmniStackHub
项目类型: VuePress 2.x 知识库
主要技术: Vue 3 + Vite + vuepress-theme-hope

文档规范:
1. 所有 Markdown 文件必须包含 frontmatter
2. 使用 title 字段定义标题，正文从 H2 开始
3. 标题前后必须有空行
4. 代码块必须指定语言类型

配置文件规范:
1. 使用 CommonJS 格式 (module.exports)
2. 2 空格缩进，单引号字符串
3. 更新侧边栏时同步更新导航栏

详细规范请参考: docs/ai/agents/AGENTS.md

步骤 3: 保存设置

保存后，Gemini 会在每次对话时自动加载这些规范。

✅ 验证配置是否生效

方法 1: 检查系统提示

Gemini 的系统提示中会显示加载的 user_rules：

<user_rules>
<MEMORY[GEMINI.md]>
...
</MEMORY[GEMINI.md]>
</user_rules>

方法 2: 询问项目信息

你能告诉我这个项目的主要技术栈是什么吗？

期望回答: VuePress 2.x、Vue 3、Vite、vuepress-theme-hope

方法 3: 测试文档创建

帮我创建一个新的文档文件

检查 Gemini 是否:

  • ✅ 自动添加 frontmatter
  • ✅ 包含 title、date、category、tag
  • ✅ 从 H2 开始使用标题
  • ✅ 代码块指定语言类型

方法 4: 测试配置修改

帮我在侧边栏添加一个新分类

检查 Gemini 是否:

  • ✅ 同时更新 navbar 和 sidebar
  • ✅ 使用正确的格式（2 空格、单引号）
  • ✅ 添加注释说明

🎯 Gemini 特有优势

1. 自动上下文理解

Gemini 可以自动理解项目结构，无需每次都重复说明。

2. 持久化记忆

通过 Memory 功能，规范会在所有对话中持续生效。

3. 多模态支持

可以上传截图或文件，Gemini 会根据项目规范分析。

💡 使用技巧

引用项目文件

在对话中可以直接引用项目文件：

请查看 docs/.vuepress/config.js 并帮我添加新的侧边栏配置

批量操作

可以要求 Gemini 一次性完成多个相关任务：

帮我创建一个关于 Docker 的文档，并更新侧边栏配置

验证和测试

可以要求 Gemini 验证修改：

请检查刚才的修改是否符合项目规范

� 常见问题

Q1: Gemini 没有遵循规范怎么办？

解决方法:

  1. 检查 Memory/User Rules 是否正确配置
  2. 尝试重新加载对话
  3. 在对话中明确提醒："请遵循项目规范"
  4. 引用具体的规范文档："请参考 AGENTS.md 中的规范"

Q2: 如何更新已配置的规范？

步骤:

  1. 修改 docs/ai/agents/GEMINI.md 或 AGENTS.md
  2. 更新 Gemini 的 Memory/User Rules
  3. 开始新对话以应用新规范

Q3: Gemini 的建议与其他 AI 工具不一致？

原因: 不同工具对规范的理解可能有差异

解决方法:

  1. 确保所有工具使用相同的规范文档
  2. 在规范中使用更明确的描述
  3. 提供具体的代码示例

📚 相关资源

� 配置示例

完整的 Gemini Memory 配置

---
项目: OmniStackHub
类型: VuePress 2.x 技术知识库
---

## 技术栈
- VuePress 2.x
- Vue 3
- Vite
- vuepress-theme-hope

## 文档规范
1. 必须包含 frontmatter (title, date, category, tag)
2. 正文从 H2 (##) 开始
3. 标题前后保留空行
4. 代码块必须指定语言

## 配置规范
1. CommonJS 格式 (module.exports)
2. 2 空格缩进
3. 单引号字符串
4. 更新 sidebar 时同步更新 navbar

## 重要提醒
- 标题前后必须有空行（MD022）
- 不要在正文中使用 H1 标题
- 内部链接使用相对路径
- 文件命名使用小写字母和连字符

详细规范: docs/ai/agents/AGENTS.md

创建日期: 2026-02-03
最后更新: 2026-02-04
维护团队: OmniStack