1. 项目概述一个Rust写的Google Gemini命令行工具如果你和我一样日常喜欢在终端里干活同时又需要频繁地和Google Gemini以前叫Bard打交道那么一个趁手的命令行工具绝对是效率神器。今天要聊的这个bard-rs项目就是一个用Rust写的、功能纯粹但足够好用的Gemini CLI客户端。它的核心卖点非常直接让你能在终端里和Gemini对话并且能实时把完整的聊天记录保存成Markdown文件。对于需要记录AI对话过程、整理思路或者生成文档的开发者、写作者或者研究者来说这个功能简直是刚需。我最初发现它是因为受够了在浏览器和编辑器之间来回切换的麻烦。写代码时突发的灵感问题或者需要快速验证一个概念打开浏览器、登录、等待页面加载……一套流程下来思路可能都断了。而bard-rs把这一切简化到了终端里就像调用一个本地命令一样自然。它基于Rust生态意味着安装简单一个cargo install命令的事运行高效而且由于Rust的内存安全和无运行时开销作为常驻后台的小工具也非常稳定可靠。这个工具适合所有习惯命令行工作流的开发者无论是系统管理员、后端工程师还是数据科学家。你不需要复杂的图形界面不需要关心网络请求的细节只需要一个有效的会话Cookie就能获得一个持续、可记录的AI对话伙伴。接下来我会带你从零开始完整地走一遍安装、配置、使用和深度定制的流程并分享一些我实际使用中积累的配置技巧和避坑经验。2. 核心功能与设计思路解析2.1 为什么选择命令行交互CLI在图形化应用和Web界面大行其道的今天为什么还要为一个AI模型专门做一个CLI工具这背后其实有非常实际的工程考量。首先集成性与自动化是CLI的天然优势。你可以轻松地将bard-rs嵌入到Shell脚本、Makefile或者CI/CD流水线中。想象一下在代码构建完成后自动调用Gemini分析日志或者用脚本批量向Gemini提问并收集回答CLI是实现这类工作流无缝衔接的最佳载体。其次极致的轻量与高效。一个CLI工具没有GUI的渲染开销不依赖复杂的浏览器环境通常只有几MB大小。bard-rs编译后的二进制文件非常小巧启动几乎是瞬间完成。这对于需要频繁、快速交互的场景至关重要比如调试代码时快速询问一个错误信息或者写作时随时查询一个概念的准确定义。最后对终端工作流的尊重。对于深度终端用户来说手指不离键盘是最高效的状态。bard-rs支持的所有操作——输入问题、重置会话、查看其他回答、退出——都可以通过键盘完成并且聊天记录直接以Markdown格式保存与使用vim、nano编辑文档或者用pandoc转换格式的流程完美契合。这种“不离场”的体验是Web界面无法提供的。2.2 实时Markdown保存不仅仅是记录bard-rs最让我眼前一亮的功能是-p或--path参数带来的实时Markdown保存。这不仅仅是一个“记录”功能它彻底改变了与AI协作的方式。工作原理当你启动CLI并指定一个保存路径后工具会在你发送第一条消息时立即在指定目录下创建一个Markdown文件。文件名通常由你的第一条消息生成例如你输入“解释一下Rust的所有权”它会创建gemini_解释一下Rust的所有权.md。随后你与Gemini的每一轮对话包括你的提问和Gemini的回答都会实时追加到这个文件中。这意味着对话结束的同时一份结构清晰的文档已经生成完毕。设计价值上下文永久化浏览器对话一旦关闭或刷新历史记录可能就难以完整追溯。而本地Markdown文件提供了永久的、可版本控制的对话记录。你可以用git管理不同阶段的对话回溯思路演变。即时的知识整理对话的过程就是知识构建的过程。生成的Markdown文件可以直接作为笔记、博客草稿或项目文档的一部分省去了后期从聊天记录中复制、粘贴、排版的繁琐步骤。离线归档与搜索所有对话内容都保存在本地你可以用grep、ripgrep或任何文本搜索工具快速检索历史对话中的关键信息即使在没有网络的环境下也能查阅。这个功能的设计体现了开发者对“工具服务于工作流”的深刻理解。它不是一个噱头而是一个能切实提升生产效率的核心特性。2.3 会话管理与会话Cookie机制要使用Google Gemini的API非官方目前绕不开的就是获取浏览器中的会话Cookie。bard-rs采用了与许多第三方工具类似的方案使用__Secure-1PSID和__Secure-1PSIDTS这两个Cookie来模拟已登录的用户会话。为什么是这两个Cookie__Secure-1PSID这是核心的身份标识Cookie包含了你的登录会话信息。没有它服务端无法识别你的身份请求会被拒绝。这也是bard-rs必须要求的参数。__Secure-1PSIDTS这是一个时间戳或会话安全令牌用于增强请求的安全性防止会话被滥用。在某些情况下它不是必须的但提供它能使会话更稳定减少被风控系统中断的可能。安全与隐私考量 这里必须强调一个重要原则这些Cookie等同于你的账户密码。任何人获取了你的__Secure-1PSID都可以在有效期内以你的身份访问Gemini。因此绝对不要将包含Cookie的.env文件提交到公开的代码仓库如GitHub。在共享的服务器或虚拟机上使用时要格外小心。定期清理不再需要的.env文件。bard-rs提供了多种方式来传递这些敏感信息从直接命令行参数到环境变量文件.env平衡了便利性与安全性。对于个人日常使用配合.gitignore忽略.env文件并使用.env来管理是最佳实践。3. 从零开始的安装与配置实战3.1 环境准备安装Rust工具链bard-rs是基于Rust的所以第一步是搭建Rust开发环境。别担心这个过程在主流操作系统上都非常简单。对于macOS和Linux用户 打开终端直接运行官方提供的安装脚本。这是最推荐的方式它会自动处理所有依赖和路径配置。curl --proto https --tlsv1.2 -sSf https://sh.rustup.rs | sh安装过程中它会提示你选择安装方式直接按回车选择默认选项1即可。安装完成后你需要重启终端或者手动运行source $HOME/.cargo/env来让CargoRust的包管理器和rustcRust编译器生效。对于Windows用户 访问 rust-lang.org 下载并运行rustup-init.exe。安装程序会引导你完成整个过程并自动配置好环境变量。建议在安装时选择使用 “Visual Studio C Build Tools”因为Rust的某些依赖需要它。验证安装 安装完成后在终端里运行以下命令如果都能正确显示版本号说明环境就绪。rustc --version cargo --version3.2 获取Google Gemini会话Cookie这是使用bard-rs前最关键的一步。我们需要从浏览器中提取那两个关键的Cookie。详细步骤打开浏览器使用Google Chrome浏览器其他基于Chromium的浏览器如Edge、Brave理论上也可以但Chrome是最稳妥的选择。访问Gemini在地址栏输入https://gemini.google.com/并访问。确保你已经登录了你的Google账户。打开开发者工具快捷键按下F12键或者CtrlShiftI(Windows/Linux) /CmdOptionI(macOS)。菜单方式在浏览器右上角点击三个点 - 更多工具 - 开发者工具。定位到Application面板在开发者工具窗口的顶部有一排标签页如Elements, Console, Sources等找到并点击“Application”。如果没看到可能需要点击图标展开更多标签。查找Cookie在左侧的导航树中依次展开“Storage”-“Cookies”。点击https://gemini.google.com这个域名。右侧会显示该站点下所有的Cookie列表。复制关键值在列表中寻找名为__Secure-1PSID的Cookie双击其“Value”字段全选并复制CtrlC/CmdC。这个值是必须的。再寻找名为__Secure-1PSIDTS的Cookie同样复制其“Value”。这个值虽然不是强制但强烈建议一并获取它能显著提高会话稳定性。注意Cookie的值是一长串看似乱码的字符务必完整复制不要遗漏开头或结尾的任何字符。它们通常以类似a1234567890abcdef...的形式出现。3.3 安装bard-rs的两种方式有了Rust环境和Cookie就可以安装工具本身了。方式一通过Cargo直接安装推荐这是最简单快捷的方式Cargo会自动从 crates.ioRust的官方包仓库下载、编译并安装。cargo install bard-rs如果你想强制更新到最新版本可以加上-f参数cargo install bard-rs -f安装完成后直接在终端输入bard-rs命令就可以使用了。二进制文件通常会被安装到$HOME/.cargo/bin目录下这个目录应该已经在你的系统PATH环境变量中了。方式二从源码编译安装如果你想体验最新的开发版功能或者希望对项目有所贡献可以从GitHub克隆源码进行编译。# 1. 克隆仓库 git clone https://github.com/Alfex4936/Bard-rs # 2. 进入项目目录 cd Bard-rs # 3. 以发布模式进行编译优化执行速度 cargo build --release编译完成后可执行文件bard-rs在Windows上是bard-rs.exe会出现在target/release/目录下。你可以把它移动到系统PATH包含的目录如/usr/local/bin或者直接通过绝对路径来运行例如./target/release/bard-rs。3.4 配置管理使用.env文件避免重复输入每次运行都输入一长串Cookie既麻烦又不安全命令历史可能被记录。bard-rs支持使用.env文件来管理配置这是最优雅的方式。创建.env文件在你的工作目录比如~/gemini_chats下创建一个名为.env的文件。cd ~/gemini_chats touch .env编辑.env文件用你喜欢的文本编辑器如vim,nano,code打开这个文件填入以下内容# 将YOUR_ACTUAL_PSID_VALUE替换为你复制的 __Secure-1PSID 的值 PSIDYOUR_ACTUAL_PSID_VALUE # 将YOUR_ACTUAL_PSIDTS_VALUE替换为你复制的 __Secure-1PSIDTS 的值可选但推荐 PSIDTSYOUR_ACTUAL_PSIDTS_VALUE # 设置默认的聊天历史保存目录可选 GEMINI_HISTORY./重要格式提醒每行一个键值对格式为KEYVALUE。等号两边不要有空格例如PSIDabc123是正确的PSID abc123可能导致解析错误。值不需要用引号包裹。将.env加入.gitignore至关重要的一步在你的项目根目录或用户全局的.gitignore文件中确保添加了.env防止不慎将包含敏感Cookie的文件提交到公开仓库。echo .env .gitignore现在你只需要在包含.env文件的目录下运行bard-rs它就会自动读取配置无需任何额外参数既安全又方便。4. 核心使用技巧与命令详解4.1 启动与基础对话配置好.env文件后使用变得极其简单。基本启动 在你的工作目录下直接运行bard-rs如果.env文件不在当前目录你可以用-e参数指定bard-rs -e /path/to/your/.env启动后你会看到终端提示符变成You:这时就可以开始输入你的问题了。输入完成后按回车稍等片刻等待网络请求和模型响应Gemini的回答就会显示在Gemini:后面。启用Markdown保存 如果你希望保存对话记录在启动时加上-p参数并指定一个目录bard-rs -p ./或者如果你已经在.env文件中设置了GEMINI_HISTORY./那么直接运行bard-rs也会自动保存。保存的文件名基于你的第一条消息所有对话内容会实时追加。4.2 内置命令高效管理对话流bard-rs内置了几个以!开头的命令用于管理对话状态熟练使用它们能极大提升效率。!reset重置当前会话。这会清空CLI工具内存中的对话历史上下文但不会删除已经保存到Markdown文件中的内容。相当于开始一个全新的话题。当你觉得AI的回答开始偏离主题或者想切换到一个完全不相关的问题时使用这个命令。!exit或CtrlC优雅退出程序。输入!exit或按下键盘上的CtrlC组合键程序会正常终止。如果启动了Markdown保存功能它会确保最后的内容都已写入文件。!show显示其他候选回答。Gemini模型在生成回答时内部可能会产生多个备选响应。默认情况下CLI只显示它认为最好的一个。输入!show可以查看上一条你的提问所对应的其他几个备选回答。这对于写作或需要多角度参考时非常有用。4.3 高级参数与组合用法除了基础用法bard-rs提供了一些参数来应对更复杂的场景。手动指定Cookie临时使用 如果你不想创建.env文件或者临时使用另一个账号可以直接通过命令行参数传递Cookie。bard-rs --psid “你的__Secure-1PSID值” --psidts “你的__Secure-1PSIDTS值”这里使用了长参数名--psid和--psidts对应的短参数是-s和-t。强制显示多候选回答 如果你希望每次提问后都自动显示多个候选回答以供选择可以在启动时加上-m参数。bard-rs -m这样每次Gemini回复后都会像执行了!show命令一样列出其他答案。参数组合示例 一个完整的组合命令可能长这样它指定了自定义的.env文件路径、启用多答案显示、并设置聊天记录保存到当前目录bard-rs -e ~/config/gemini.env -m -p ./5. 实战场景与应用案例5.1 场景一辅助编程与代码调试作为开发者这是我使用bard-rs最频繁的场景。当遇到一个模糊的错误信息或不确定如何实现某个功能时直接在终端里提问。操作流程在项目目录下启动bard-rs -p ./docs/ai_chats这样所有技术问答都会保存到项目的docs/ai_chats文件夹方便后续整理进项目文档。直接粘贴错误信息You: 我在Rust里编译时遇到这个错误error[E0382]: use of moved value: vec。我的代码是let vec1 vec![1,2,3]; let vec2 vec1; println!({:?}, vec1); 请问问题出在哪Gemini会解释所有权移动的规则并给出修正方案。整个问答过程被实时记录在gemini_我在Rust里编译时遇到这个错误.md中。如果解释不够清晰可以用!show看看其他角度的解释或者继续追问。优势问答记录直接保存在项目目录与代码上下文关联后期回顾或分享给团队成员时非常方便无需再从浏览器历史里翻找。5.2 场景二内容创作与大纲生成对于写作者或博主可以用它来快速生成文章大纲、润色段落或寻找灵感。操作流程在写作专用目录启动bard-rs。输入指令You: 帮我生成一篇关于“Rust并发编程中Arc和Mutex的使用场景与区别”的技术博客大纲要求包含引言、核心概念对比、代码示例、常见陷阱和总结。根据生成的大纲可以针对每一个小节继续深入提问例如You: 针对“常见陷阱”这一节请详细列出3个开发者在使用ArcMutexT时最容易犯的错误并给出每个错误的示例和避免方法。所有的问答构成了文章的初稿和素材库保存的Markdown文件稍作整理即可成为正式的草稿。5.3 场景三学习与研究中的概念厘清学习新知识时难免会遇到难以理解的概念。可以将其作为一个交互式的学习伙伴。技巧利用!reset命令来隔离不同主题的对话。例如先学习“Rust生命周期”问几个问题后用!reset清空上下文再开始学习“异步编程”避免之前的对话干扰新话题的讨论。每个独立的话题都会因为第一条消息的不同而生成独立的Markdown文件知识归档自然清晰。6. 常见问题排查与解决方案实录即使按照步骤操作你也可能会遇到一些问题。下面是我在长期使用中遇到的一些典型情况及其解决方法。6.1 错误“SNlM0e not found. Check your cookies.”这是最常见的一个错误意味着工具无法从你提供的Cookie中提取出必要的SNlM0e令牌。根本原因你提供的__Secure-1PSIDCookie值可能已经失效、格式不正确或者对应的登录会话状态异常。解决步骤按顺序尝试彻底清除浏览器Cookie并重新登录打开Chrome开发者工具 (F12) -Application标签 -Storage-Cookies。右键点击https://gemini.google.com这个域名选择Clear。这将删除该站点所有Cookie。完全关闭并重启Chrome浏览器。重新访问https://gemini.google.com确保系统提示你登录然后完整地登录你的Google账号。再次按照3.2节的步骤获取全新的__Secure-1PSID和__Secure-1PSIDTS值。更新你的.env文件或命令行参数使用新的Cookie值。检查Cookie的完整性确保你复制的__Secure-1PSID值是完全的没有遗漏开头或结尾的字符。它通常是一串很长的、包含数字、字母和符号的字符串。确保在.env文件中PSID后面直接紧跟Cookie值中间没有空格。尝试使用__Secure-1PSIDTS如果你之前只使用了__Secure-1PSID请务必同时获取并配置__Secure-1PSIDTS。在很多情况下缺少这个令牌会导致认证失败。验证网络环境确保你的网络可以正常访问https://gemini.google.com。某些网络环境可能对Google服务有访问限制。6.2 错误dotenv无法读取.env文件当你使用-e .env参数或让程序自动查找.env文件时可能会遇到错误提示找不到有效的PSID键。原因.env文件的格式或编码不正确。解决方案避免使用echo直接创建在Linux/macOS的Shell中使用echo PSIDvalue .env可能会引入换行符或编码问题。最好使用文本编辑器vim,nano来创建和编辑.env文件。检查文件格式确保文件是纯文本格式并且每行都是KEYVALUE的格式行末没有多余的空格。检查文件路径使用-e参数时确保提供的路径是准确的。可以使用绝对路径来避免歧义如-e /home/user/projects/gemini/.env。6.3 对话历史Markdown文件没有生成启动了-p参数但目录下没有找到任何.md文件。排查步骤检查路径权限确保你指定的目录如./存在并且当前用户有在该目录的写入权限。可以尝试用一个绝对路径的、你有明确写权限的目录如-p /tmp或-p ~/Documents。检查第一条消息文件是在你发送第一条消息之后才创建的。如果你启动后什么都没输入就退出了自然不会生成文件。文件以第一条消息命名例如gemini_hello.md。查看程序输出启动时如果指定了-p程序通常会有一行日志输出提示它将把历史保存到哪里。注意观察启动时的提示信息。检查.env中的GEMINI_HISTORY如果你依赖.env中的GEMINI_HISTORY变量请确认该变量已正确设置且路径有效。6.4 程序响应慢或无响应可能原因及对策网络问题Gemini的API服务器可能在国外网络延迟是主要因素。可以尝试在网络状况较好的时段使用。会话过期/限流单个会话长时间使用或频繁请求可能被风控。尝试使用!reset命令开启一个新会话或者完全退出程序等待几分钟再重新启动。模型负载Gemini服务本身可能遇到高负载导致响应变慢。这通常是暂时的。7. 安全使用指南与最佳实践鉴于Cookie的高度敏感性遵循安全最佳实践至关重要。隔离配置与环境为bard-rs创建一个专用的工作目录例如~/gemini_workspace。将.env文件仅放置于此目录下。在该目录下初始化一个git仓库并确保.gitignore文件的第一行就是.env。这样可以将你的代码、生成的对话记录进行版本管理同时绝对隔离敏感信息。谨慎处理命令行历史避免在命令行中直接使用--psid参数输入Cookie因为Shell历史如~/.bash_history或~/.zsh_history会记录这些命令。始终坚持使用.env文件。如果必须临时使用命令行参数可以在命令前加一个空格如果Shell配置了HISTCONTROLignorespaceBash会忽略该命令但这并非所有Shell的默认配置最保险的还是用文件。定期更新CookieGoogle的会话Cookie有一定有效期。如果某天发现bard-rs无法工作了第一个排查步骤就是按照6.1的方法重新获取并更新.env文件中的Cookie值。理解工具的限制bard-rs是一个非官方工具它依赖于逆向工程得到的接口。这个接口可能随时因Google官方的改动而失效。因此它更适合作为个人效率工具不建议用于构建任何商业或关键业务系统。功能上它可能无法支持Gemini Web界面的所有特性如上传文件、多模态交互等。这个工具在我日常的开发和学习工作中已经成为了一个不可或缺的助手。它把强大的AI能力无缝地嵌入了我最熟悉的工作环境——终端。那种需要查资料时不用跳出思维流的感觉极大地保护了注意力的连续性。当然依赖非官方接口总有一些不稳定性但对于一个能如此显著提升单兵作战效率的工具来说这点风险是完全可以接受的。如果你也生活在终端里强烈建议花十分钟配置一下它可能会成为你今年装过最值得的“小”工具之一。