WireCat Google Drive

drive-cli

drive 会将选定的 Google Drive 文件夹导入为本地 Markdown 快照和可搜索文档。它会读取包含所有标签页的 Google Docs，在重命名和移动后仍保留来源身份，并复用 WireCat 共享的关键词搜索和可选的本地嵌入功能。共享标签、笔记、编辑者身份和有证据支撑的记忆会始终附加在导入的文档上。

Drive 使用 Google 官方 Node 客户端。 目前支持的来源：原生 Google Docs 和 Sheets、PDF、docx、xlsx、CSV、TSV，以及上传的 Markdown/TXT。 其他类型和快捷方式会标记为已跳过；不会跟随所选范围以外的快捷方式。

了解它与 gog、Workspace MCP 和 rclone 的比较，以及何时更适合使用其他工具： 与其他工具比较。

安装

使用 Node 22.x 系列中的 22.16+ 版本或 Node 24+ 安装已编译的 CLI。无需从源代码构建：

npm install -g @wirecat/drive-cli
drive --version
drive --help

请参阅安装和连接 Google。从源代码构建适用于贡献者。

drive doctor 无需登录即可显示版本、设置文件、配置档案和路径；drive upgrade 则会使用安装 drive 的包管理器安装较新版本。

drive guide 会列出使用场景，即完成常见任务所需的命令及其顺序；drive commands --json 则提供完整的命令树。对于 Agent，drive skill install 会将 drive 的说明放在 Claude Code、Codex、Gemini CLI 和 OpenClaw 查找的位置（Hermes 使用 --for hermes）；drive personal mcp serve 会提供三个 MCP 工具（搜索、读取、写入）—— --http 会通过浏览器将这些工具提供给 ChatGPT 和 Claude（远程 MCP）——而 DRIVE_READ_ONLY=1 会拒绝所有更改，与 --read-only 的作用相同。

登录并选择文件夹

使用 WireCat 内置的 Google 应用登录。每位用户都会在浏览器中授权自己的账号。Google 对 Drive 权限的审核尚未完成，因此 Google 会先显示“未验证的应用”警告，并将应用的新增用户总数限制为 100 人；请参阅警告及如何继续。 你也可以按照安装指南中的说明创建自己的 Desktop 客户端。连接账号，然后选择一个文件夹：

drive personal session start
drive personal folders add https://drive.google.com/drive/folders/FOLDER_ID
drive personal sync --json

如需设置 Google Cloud 并进行隔离的首次运行，请参阅浏览器登录与实时验证指南。

登录时会打开系统浏览器，并在临时回环端口接收 Google 的回调。 --no-browser 会输出 URL。drive.readonly 授予对整个账号的读取权限；我们选定的文件夹范围会限制摄取内容。同步会读取远程文件。可选的远程管理命令需要使用 session start --grant write 重新登录；历史事件需要使用 session start --grant activity。

凭据使用操作系统密钥环。如果没有密钥环，请明确选择 --credential-storage file；共享助手会写入仅所有者可访问的私有文件。令牌绝不会进入常规配置、输出或诊断信息。可以使用 DRIVE_GOOGLE_CLIENT_ID 和 DRIVE_GOOGLE_CLIENT_SECRET 提供应用设置，以替代内置应用；--client-file 优先级更高。内置 Desktop 客户端身份是公开的应用元数据，与私有用户令牌分开。如果你创建自己的 Desktop 客户端并将其留在 Testing 状态，Google 通常会在七天后结束其登录会话。 Google OAuth 指南、 Drive 权限。

使用 drive work … 切换到另一个账号。每个 Google 账号对应一个本地配置档。drive session list 会列出已配置的配置档。session end 会移除本地登录信息，同时保留缓存数据和配置，因此重新登录后会保留文档标识。

搜索和导出

drive personal search 'budget decision' --json
drive personal search 'budget' --exact --json
drive personal documents list --json
drive personal documents show DOC_ID --json
drive personal documents export DOC_ID --output ./document.md
drive personal status --json
drive commands sync --json

搜索结果包含原始 Google URL。documents show 会包含每个标签页的文本、ID 和标题。原生 Markdown 导出内容会单独保存，与用于索引的全标签页文本分开。 导出不会覆盖已有的目标文件。

语义搜索使用共享的本地文本模型（约 135 MB）。下载一次即可；无需配置档或登录， 所有 WireCat CLI 均可共用：

drive models download e5-small
drive personal sync --embed

Drive 不会自行下载模型；如果模型缺失，会显示提示。--exact 会搜索词语，不使用语义 检索。

保持内容最新

drive personal sync --limit 200 --json
drive personal folders remove FOLDER_ID
drive personal sync --json

批次会在处理前持久化；中断的工作会在下次运行时继续。每处理 25 个文件或每隔 2 秒保存一次进度，因此同步被终止时，最多只需重做这么多工作。所选文件夹的首次遍历会在进行时保存；如果遍历中断，则会从尚未列出的文件夹继续。批次完成后，变更游标才会前进。未完成的发现过程会保留先前的检查点和文档。每个配置档都有心跳锁，可防止同时同步，并能在崩溃后恢复。

确认的移除操作和超出范围的内容会从搜索中移除来源，并删除其快照。 移除最后一个选定文件夹后，下次同步时会将缓存同步为空。对于不受支持、受限和过大的来源，会明确标注覆盖状态。暂时性故障会保持待处理状态； 出现错误的部分同步会以非零状态码退出。重复项通过文档 ID 而非名称区分。

存储与覆盖范围

共享路径辅助程序会在 drive-cli 下选择适合平台的配置、数据和缓存目录。可通过 DRIVE_CONFIG_DIR、DRIVE_STATE_DIR 和 DRIVE_CACHE_DIR 覆盖。快照存储在 profiles/<profile>/documents/<file-id>.md，并附带私有 JSON 元数据和原始 Docs 响应。

文档使用与 Memo、Telegram 和 MAX 相同的本地 WireCat 数据库。导入的文档可与这些工具中的消息和笔记一起搜索。 MESSAGING_STORE 用于选择其他数据库；WIRECAT_STATE_DIR 用于更改默认 WireCat 目录。Google 登录仍相互独立。

升级后首次使用时，Drive 会根据其管理的快照重建旧文档引用，不会从 Google 获取数据。 旧数据库会保留。如果该数据库包含标签、笔记、记忆、事实或关系，Drive 会拒绝让这些内容失去关联：请通过 MESSAGING_STORE 继续使用该文件，直到这些注释完成迁移。

搜索涵盖所有标签页中的正文、嵌套表格和脚注。不包括图片、页眉、页脚、评论和建议的修改。图片资源不会下载。搜索文本与 Google 的原生 Markdown 导出是两种不同的表示形式；如果布局或标签页覆盖范围很重要，请检查导出内容。

每次同步最多读取所选文件夹下的 10,000 个条目，以及 Google 变更源中的最多 10,000 项变更；超过任一上限时，同步会停止，不会丢失任何内容，并会说明后续操作。文本上限为 2,000,000 个字符，快照上限为 50 MiB，并使用有界分页。超大输入会被拒绝，而不是截断。Google 的原生导出还有 10 MB 的独立限制。导出期间发生更改的文档会保持待处理状态，以便重试。

文档知识与远程操作

drive personal tags add DOC_ID project-budget review
drive personal documents list tag:review
drive personal notes add DOC_ID 'Check the assumptions' --title Review
drive personal identities list DOC_ID
drive personal documents context DOC_ID
drive personal facts add DOC_ID 'Budget approved for Q4' --type decision --scope work
drive personal memories add DOC_ID 'Q4 budget, in short' --scope work --kind summary
drive personal memories extract DOC_ID --scope work
drive personal documents history DOC_ID
drive api list service:docs

AI 提取会明确将选定的缓存文本发送到已配置的模型。除非提供 --yes，否则会预览提案；已保存的提案包含来源引文、快照哈希和模型署名。 请使用共享模型设置：models set --provider openai --model MODEL_ID。提供商密钥来自相应的 API 密钥环境变量，绝不会写入常规配置。 来源内容更改和范围移除会将基于来源的记忆标记为过时。用户笔记保留在本地。

生成的 API 共提供 85 个方法：64 个 Drive、17 个 Sheets、3 个 Docs 和 1 个 Activity。便捷命令包括 文件列表、复制和移动，移至垃圾箱与恢复，创建文件夹，创建 Docs 和批量更新，评论， 权限，修订版本和 Shared Drives。默认使用读取授权。JSON API 调用需要显式标志才能执行修改和永久删除；Google 仍会强制执行文件角色和 API 政策。

请阅读知识与 API 命令指南，了解完整示例、 权限、历史记录限制、AI 设置和支持的请求格式。贡献者检查使用隔离的数据源和模拟的提供商请求；请参阅测试指南。