Rust CLI工具bard-rs：终端直连Google Gemini并实时保存Markdown对话

1. 项目概述一个Rust写的Google Gemini命令行工具如果你和我一样日常喜欢在终端里干活同时又需要频繁地和Google Gemini以前叫Bard打交道来回在浏览器和编辑器之间切换、复制粘贴对话内容那感觉确实有点割裂。最近在GitHub上发现了一个叫bard-rs现在项目名更贴切地叫Google Gemini CLI的小工具它完美地解决了这个痛点。简单来说这是一个用Rust编写的命令行界面CLI让你能在终端里直接和Gemini对话并且能实时把完整的聊天记录保存成Markdown文件。对于需要记录AI对话过程、整理思路或者生成文档的开发者、写作者或研究者来说这玩意儿用起来是真顺手。这个工具的核心价值在于它的“无痕”和“可追溯”。你不再需要依赖网页端的聊天历史有时还不稳定所有的对话都以结构清晰的Markdown格式本地保存随用随查还能用git进行版本管理。更关键的是它用Rust实现意味着启动速度快、资源占用小而且单文件二进制分发安装部署极其简单。接下来我就结合自己的使用和折腾经验把这个工具的里里外外、从安装配置到高阶用法以及那些官方文档没明说但实际会遇到的“坑”给你彻底拆解清楚。2. 核心原理与设计思路拆解2.1 为什么是Rust工具选型的底层逻辑作者选择用Rust来重写这个CLI工具而并非直接使用已有的Python版本项目鸣谢了acheong08的Python实现背后有非常实际的工程考量。首先性能与启动速度是关键。CLI工具追求的是即开即用Rust编译出的静态二进制文件几乎没有运行时依赖启动是毫秒级的这对于一个需要频繁调用的交互式工具来说体验提升巨大。相比之下Python脚本启动需要先初始化解释器速度上就有可感知的差异。其次内存安全与并发友好。Rust的所有权系统保证了在并发处理网络请求、用户输入和文件写入时很难出现数据竞争或内存错误。这个工具需要同时监听用户输入、向Gemini API发送请求并接收流式响应、实时写入文件用Rust来实现这种异步IO密集型任务非常自然且可靠。最后是分发便利性。通过cargo install用户可以一键安装得到的是一个独立的可执行文件无需关心Python环境、依赖包版本冲突等问题降低了用户的使用门槛。2.2 会话维持机制Cookie的奥秘与风险提示这个工具最核心也最需要理解的部分就是它的身份认证机制。它没有使用Google官方提供的API Key而是通过模拟浏览器会话使用__Secure-1PSID和__Secure-1PSIDTS这两个Cookie来认证。这是一种“非官方”的逆向工程方式。__Secure-1PSID(必须)这是你的主要会话标识符。它本质上是一个令牌代表了你在gemini.google.com域名下通过浏览器登录后的认证状态。CLI工具在发送请求时携带这个Cookie服务器就会认为请求来自“已登录的浏览器”从而授权访问Gemini服务。__Secure-1PSIDTS(可选但强烈建议)这是一个时间戳令牌用于增强会话的安全性和新鲜度。有些情况下仅凭1PSID可能会触发风控导致“SNlM0e not found”错误。同时提供1PSIDTS能让会话看起来更“正常”提高连接成功率。重要安全提示这两个Cookie等同于你的账户登录凭证。任何人获取了它们都能在工具有效期内冒充你的身份访问Gemini。因此务必像保护密码一样保护它们绝对不要将包含Cookie的.env文件提交到公开的Git仓库。在共享的服务器或虚拟机上使用时需格外谨慎。建议定期清理浏览器Cookie并重新获取以缩短凭证的有效期。这种方式的优势是免费、无需申请API Key且功能上与网页版基本一致。劣势则是依赖于Google未公开的内部接口存在随时被变更或封禁的风险且需要手动获取Cookie步骤稍显繁琐。2.3 实时Markdown保存设计亮点与文件管理策略“实时保存聊天记录为Markdown”是这个工具区别于许多其他AI CLI的杀手级功能。它的设计非常巧妙流式响应与实时写入当Gemini返回回答时工具是流式chunk-by-chunk接收的。它并不是等所有内容都接收完再一次性写入文件而是每收到一小段文本就立即追加到Markdown文件中。这样做有两个好处一是你可以用tail -f之类的命令实时查看文件生成过程二是即使对话中途程序崩溃或网络中断已经收到的部分内容也不会丢失。智能文件命名文件以你的第一条消息来命名例如你输入“如何用Rust解析JSON”它会生成gemini_如何用rust解析json.md。这种命名方式非常直观让你日后翻阅时能快速通过文件名定位到某次对话的主题。文件名中的特殊字符和空格会被处理确保其在所有文件系统上都能安全创建。完整的对话上下文保存的Markdown文件不仅包含AI的回答也完整记录了你的每一次提问并且用清晰的标题层级##代表用户提问###代表AI回答进行格式化。这使得生成的文档本身就是一份结构清晰的QA记录可以直接用于知识库构建或报告撰写。3. 从零开始完整安装与配置指南3.1 环境准备安装Rust工具链由于这是Rust项目首先需要确保你的系统上安装了Rust和其包管理器Cargo。如果你已经安装过可以用rustc --version和cargo --version检查。对于未安装的用户最推荐的方式是通过官方脚本安装它能自动处理路径配置curl --proto https --tlsv1.2 -sSf https://sh.rustup.rs | sh安装过程中选择默认选项1即可。安装完成后需要重启终端或者执行source $HOME/.cargo/env来让环境变量生效。实操心得在某些网络环境下官方脚本可能下载较慢。可以尝试设置Rustup镜像源来加速。例如在运行安装脚本前临时设置环境变量export RUSTUP_DIST_SERVERhttps://mirrors.ustc.edu.cn/rust-static export RUSTUP_UPDATE_ROOThttps://mirrors.ustc.edu.cn/rust-static/rustup然后再执行上述curl安装命令。3.2 两种安装方式详解与对比安装bard-rs有两种主流方式各有适用场景。方式一通过Cargo直接安装推荐大多数用户这是最简单快捷的方式Cargo会自动从 crates.io 下载源码并编译安装。cargo install bard-rs如果你想强制更新到最新版本例如之前安装过旧版可以加上-f参数cargo install bard-rs -f优点一键完成无需关心项目源码和编译过程。Cargo会自动处理依赖并将可执行文件安装到$HOME/.cargo/bin目录下该目录通常已在系统的PATH环境变量中。缺点你无法对源码进行自定义修改。安装的是crates.io上发布的稳定版可能不是GitHub上的最新开发版。方式二从源码编译安装适合开发者或想尝鲜的用户如果你想使用最新的、尚未发布到crates.io的功能或者想阅读、修改源码就需要从GitHub克隆并编译。# 1. 克隆仓库 git clone https://github.com/Alfex4936/Bard-rs cd Bard-rs # 2. 以发布模式进行编译优化 cargo build --release编译完成后可执行文件bard-rs在Windows上是bard-rs.exe会出现在target/release/目录下。后续使用你可以直接运行./target/release/bard-rs或者更规范的做法是将其复制到系统路径下比如sudo cp target/release/bard-rs /usr/local/bin/Linux/macOS。优点可以获得最新的代码功能。便于调试和代码学习。缺点步骤稍多需要本地有完整的编译环境。3.3 关键一步获取并配置会话Cookie这是使用工具前必须完成的认证配置。请严格按照以下步骤操作打开Gemini网页使用Chrome或Edge基于Chromium浏览器访问 https://gemini.google.com 。确保你已经登录了正确的Google账号。打开开发者工具按F12键或者CtrlShiftIWindows/Linux /CmdOptionImacOS。定位到Cookie在开发者工具顶部切换到“Application”应用程序标签页。在左侧导航栏展开“Storage”-“Cookies”。点击列表中的https://gemini.google.com。复制关键值在右侧表格中找到名为__Secure-1PSID的行双击其“Value”字段完整地复制那一长串字符。同样地找到__Secure-1PSIDTS并复制其值。配置Cookie到CLI你有两种方式将Cookie提供给工具方式A命令行参数临时使用每次运行都带上参数。bard-rs --psid YOUR_PSID_VALUE --psidts YOUR_PSIDTS_VALUE方式B环境变量文件推荐安全方便创建一个名为.env的文件注意文件名以点开头内容如下PSIDYOUR_PSID_VALUE PSIDTSYOUR_PSIDTS_VALUE # 如果你想默认保存聊天记录可以加上历史路径 # GEMINI_HISTORY./chat_history然后运行bard-rs时工具会自动在当前目录及其父目录中查找这个文件。你也可以用-e参数指定文件位置bard-rs -e /path/to/your/.env。避坑指南创建.env文件时千万不要使用echo PSIDvalue .env这样的命令。因为value中可能包含!,$等Shell特殊字符会被解析导致写入的内容错误。务必使用纯文本编辑器如VSCode, Vim, Notepad来创建和编辑这个文件确保内容准确无误。4. 核心功能实操与命令详解4.1 基础对话与历史保存配置好Cookie后最基本的启动命令就是直接运行bard-rs。如果当前目录或上级目录存在配置正确的.env文件它会自动加载并进入交互式对话模式。$ bard-rs 用Rust写一个快速排序算法工具会开始流式打印Gemini的回复。同时如果你在.env中设置了GEMINI_HISTORY或者通过-p参数指定了路径它会自动在后台将整个对话包括你的问题和AI的回答保存到以你第一个问题命名的Markdown文件中。-p参数的高级用法-p参数不仅用于开启保存功能还能指定保存的目录和自定义基础文件名。bard-rs -p ./在当前目录下保存文件名为gemini_第一条消息.md。bard-rs -p ~/Documents/gemini_logs/在指定目录保存。bard-rs -p “./logs/$(date %Y%m%d_%H%M%S).md”这是一个利用Shell命令生成带时间戳文件名的技巧。工具会执行$(date ...)这部分生成如./logs/20231027_143022.md的文件名非常适合按会话归档。4.2 内置命令系统高效管理对话在交互式对话中除了输入普通问题你还可以使用几个以!开头的内置命令来管理会话状态!reset重置当前对话上下文。这不会删除已保存的Markdown文件但会清空工具内存中的对话历史。发送此命令后接下来的对话对于Gemini来说就是一个全新的会话它不会记得之前聊过的内容。这在你想开启一个全新话题时非常有用。!exit或CtrlC优雅退出程序。工具会妥善结束所有网络连接和文件写入操作确保最后一部分聊天内容也被完整保存到文件中然后退出。!show显示上一条消息的其他候选回答。Gemini在生成回答时内部可能会产生多个略有差异的版本。使用-m参数启动程序后这个命令可以让你查看AI为你的上一个问题生成的其他备选答案有时能提供不同的思路或表述。4.3 参数组合使用场景示例工具的参数可以灵活组合以适应不同场景快速测试不保存记录bard-rs --psid YOUR_PSID # 或者使用.env文件但覆盖保存路径为空 bard-rs -p “”这种方式适合问一些一次性、无需留存的问题。强制多候选回答并保存bard-rs -e .env -m -p ./archive/-m参数让Gemini在内部生成多个回答虽然最终只流式输出一个结合!show命令可以查看所有候选。-p指定保存目录。使用特定环境配置文件bard-rs -e ~/.config/gemini-cli/prod.env -p ~/Dropbox/GeminiLogs将包含敏感Cookie的.env文件放在安全的、非项目目录的位置并通过绝对路径引用既安全又清晰。5. 故障排查与常见问题实录即使按照步骤操作也可能会遇到一些问题。下面是我在长期使用中遇到的一些典型情况及其解决方法。5.1 错误“SNlM0e not found. Check your cookies.”这是最常见的一个错误根本原因是Gemini服务端无法从你提供的Cookie中解析出有效的会话令牌SNlM0e。系统性排查步骤检查Cookie是否过期浏览器登录的会话是有有效期的。最直接的方法是完全退出你的Google账号在所有设备上然后重新在Chrome中登录gemini.google.com再按前述步骤获取全新的__Secure-1PSID和__Secure-1PSIDTS值。旧Cookie失效是导致此问题的主要原因。验证Cookie获取步骤确保你复制的是https://gemini.google.com域名下的Cookie而不是其他Google域名如google.com下的。值必须完整不能有遗漏或多余的空格。检查.env文件格式用文本编辑器打开你的.env文件确认格式是KEYVALUE且每行一个。确保没有多余的引号如PSID”value”工具期望的是纯文本值。行末也不要有多余的空格。尝试包含PSIDTS如果你之前只配置了PSID请务必加上PSIDTS。在某些网络环境或账号状态下缺少时间戳令牌会导致认证失败。网络环境考量在某些地区或网络下直接访问Gemini服务可能不稳定。虽然本工具不涉及任何非法的网络访问方式但基础的网络连通性是前提。你可以尝试用浏览器直接访问Gemini网页确认服务本身是可用的。5.2 错误程序无响应或立即退出Cookie值包含特殊字符如果使用echo命令创建.env文件Cookie值中的!会被Shell解释为历史命令展开。务必使用文本编辑器创建文件。二进制文件损坏或权限问题如果是源码编译的尝试删除target目录重新编译cargo clean cargo build --release。如果是cargo install安装的尝试强制重装cargo install bard-rs -f。依赖库编译失败在极少数情况下编译依赖的OpenSSL等系统库可能有问题。确保你的系统有基本的开发工具链如build-essentialon Ubuntu,Xcode Command Line Toolson macOS。5.3 功能性问题历史文件未生成或内容不全路径权限问题检查-p参数指定的目录是否存在以及当前用户是否有在该目录的写入权限。可以尝试使用绝对路径如-p /home/user/docs。文件写入冲突如果两次对话的第一条消息完全相同工具会尝试覆盖写入同一个文件。如果前一个对话的文件正被其他进程如文本编辑器打开锁定可能会导致写入失败。确保关闭已打开的Markdown文件。流式写入延迟由于是实时流式写入在AI回答非常长或网络慢时你可能看到文件内容是一段段出现的。这是正常现象。使用!exit或CtrlC正常退出会确保缓冲区内容全部写入文件。5.4 性能与体验优化响应慢Gemini的响应速度主要取决于Google的服务器和你的网络。CLI工具本身开销极小。如果感觉慢可以检查网络连接。终端显示乱码确保你的终端如iTerm2, Windows Terminal, GNOME Terminal使用的是支持UTF-8的编码。在Linux/macOS上可设置export LANGen_US.UTF-8。想使用代理该工具本身不提供代理配置。如果你的网络环境需要可以通过设置系统级的HTTP/HTTPS代理环境变量来实现例如在启动前执行export https_proxyhttp://your-proxy:port export http_proxyhttp://your-proxy:port bard-rs6. 进阶应用集成与自动化脚本这个CLI工具的魅力在于它可以无缝嵌入到你的自动化工作流中。以下是一些进阶思路6.1 与Shell脚本结合批量处理任务假设你有一个包含多个问题的文本文件questions.txt每行一个问题。你可以编写一个Shell脚本让Gemini自动回答所有问题并分别保存。#!/bin/bash # batch_ask.sh while IFS read -r question; do if [[ -n $question ]]; then # 忽略空行 echo 处理: $question # 使用 here-document 将问题传递给 bard-rs并指定输出文件 # 注意这里假设使用.env文件配置cookie且每个问题在新会话中问 bard-rs $question -p ./answers/ /dev/null 21 sleep 2 # 避免请求过于频繁 fi done questions.txt echo “批量处理完成”6.2 作为代码编辑器的辅助工具在VS Code中你可以配置一个任务Task或使用终端插件快速调用bard-rs来解答当前选中的代码问题。选中一段有问题的代码。运行一个自定义脚本该脚本将选中的代码作为问题的一部分例如加上“请解释这段代码”的前缀发送给bard-rs。将回答直接插入到编辑器注释中或打开一个新的预览标签页。这需要一些编辑器扩展开发的知识但思路是通用的将CLI工具作为后端服务通过编辑器前端调用。6.3 构建简单的本地知识库利用其自动生成Markdown的特性你可以很容易地构建一个本地Gemini对话知识库。创建一个专用目录如~/gemini_knowledge_base。将.env文件放在该目录并设置GEMINI_HISTORY./。以后所有在该目录下运行的bard-rs对话都会自动生成Markdown文件保存在这里。使用像Obsidian、Logseq这样的本地笔记软件打开这个目录它们能自动建立文件间的链接和索引形成一个可搜索的私人AI知识库。我个人在实际使用中最深的体会是“本地化”和“文本化”带来的掌控感。所有对话记录都是纯文本Markdown放在自己硬盘里可以用grep搜索用git管理版本彻底摆脱了对云端聊天历史界面的依赖。这个小工具完美体现了Unix哲学——“做一件事并做好”。它没有花哨的UI就是把一件事做到了极致让你在终端里高效、持久地与最强的AI模型之一对话。如果你是一名开发者并且终端是你的主战场那么花十分钟配置一下bard-rs它很可能会成为你未来工作中一个高频且顺手的利器。