Gemini CLI 是 Google 推出的原生命令行智能体（AI Agent），它能像真正的助手一样，直接在你的电脑上读写文件、执行命令、甚至联网调研。
—
一、 环境准备
在安装之前，请确保你的电脑已安装 Node.js（建议版本 $v18+$）。
—
二、 安装与激活
1. 全局安装
打开 PowerShell，输入以下命令：
PowerShell
npm install -g @google/gemini-cli
2. 身份验证
安装完成后，需要关联你的 Google 账号以获取免费配额：
PowerShell
gemini login
操作：浏览器会自动弹出，点击“授权”即可。看到 Logged in successfully! 后返回终端按下 r 重启。
—
三、 联动 Obsidian：核心操作流程
1. 进入工作区（关键步骤）
不要在默认的 C:\Users\用户名 下运行。你必须 cd 进入你的笔记文件夹：
PowerShell
cd "D:\你的笔记库路径\Obsidian\MyVault"
gemini
2. 授权目录信任
首次进入新文件夹，Gemini 会询问是否信任。
3. 理解安全确认弹窗
当你要求 Gemini 修改文件时，它会显示 Diff（差异对比）：
—
四、 实用指令集（中英对照）
笔记基础管理（读与找）
列出文件并总结
- 指令：List all .md files in this folder and give me a brief summary of each.
- 中文：列出当前文件夹下所有的 .md 文件，并简要总结每个文件的内容。
查找特定内容的笔记
- 指令：Find all notes that mention “Artificial Intelligence” and list their filenames.
- 中文：找到所有提到“人工智能”的笔记，并列出它们的文件名。
阅读并解释特定笔记
- 指令：Explain the core concepts in @filename.md in simple Chinese.
- 中文：用简单的中文解释 @文件名.md 里的核心概念。
自动化整理（写与改）
批量添加标签
- 指令：Scan all notes. If a note discusses “Cooking”, add the tag #recipe at the end.
- 中文：扫描所有笔记。如果笔记讨论的是“烹饪”，请在末尾添加 #食谱 标签。
提取待办事项
- 指令：Extract all unchecked tasks (starting with - [ ]) from my recent notes and save them to Todo_List.md.
- 中文：从我最近的笔记中提取所有未完成的任务（以 - [ ] 开头），并保存到 Todo_List.md。
自动修正格式
- 指令：Format all headers in @note.md to follow standard Markdown style and ensure there is a space after #.
- 中文：格式化 @笔记.md 中的所有标题，使其符合标准 Markdown 风格，并确保 # 后面有空格。
知识库增强（调研与联动）
联网补充信息
- 指令：Search for the latest news about Gemini 2.5 and append the findings to @AI_Notes.md.
- 中文：搜索关于 Gemini 2.5 的最新消息，并将发现的内容追加到 @AI笔记.md 后面。
建立笔记关联（双链）
- 指令：Analyze the relationship between @NoteA.md and @NoteB.md, then add a link between them with a reason.
- 中文：分析 @笔记A.md 和 @笔记B.md 之间的逻辑关系，然后在它们之间添加双向链接（[[ ]]）并说明原因。
生成思维导图大纲
- 指令：Create a Mermaid mindmap outline based on the content of @project.md.
- 中文：根据 @项目.md 的内容，生成一个 Mermaid 语法的思维导图大纲。
系统控制指令（斜杠命令）
这些是控制 Gemini CLI 本身的特殊指令：
- /help：显示帮助菜单。
- /model：切换模型（比如从 Pro 换到 Flash 以节省额度）。
- /stats：查看当前的请求配额使用情况。
- /exit：安全退出当前 AI 会话。
- /clear：清除当前窗口的对话记录（但不影响文件）。
—
五、 配额与模型管理
Gemini CLI 提供了极其慷慨的免费额度，但仍有上限：
模型选择：
- Gemini Pro：逻辑最强，但每日请求数有限（适合复杂创作）。
- Gemini Flash：（首选） 速度极快，配额极高，适合日常笔记处理。
切换模型：在界面输入 /model 即可切换。
查看进度：输入 /stats 查看今日已用额度。
—
六、 常见问题排查（FAQ）
