Gemini Web 客户端

通过 Gemini Web 应用程序编程接口进行文本/图像生成。支持参考图像和多轮对话。

脚本目录

重要提示：所有脚本都位于此技能的 scripts/ 子目录中。

代理执行说明：

1. 确定此 SKILL.md 文件的目录路径为 {baseDir}
2. 脚本路径 = {baseDir}/scripts/<脚本名称>.ts
3. 解析 ${BUN_X} 运行时：如果已安装 bun → 使用 bun；如果 npx 可用 → 使用 npx -y bun；否则建议安装 bun
4. 将本文档中的所有 {baseDir} 和 ${BUN_X} 替换为实际值

脚本参考：

同意检查（必需）

在首次使用前，验证用户是否同意使用逆向工程的应用程序编程接口。

同意文件位置：

• macOS： ~/Library/Application Support/baoyu-skills/gemini-web/consent.json
• Linux： ~/.local/share/baoyu-skills/gemini-web/consent.json
• Windows： %APPDATA%\baoyu-skills\gemini-web\consent.json

流程：

1. 检查是否存在 accepted： true 且 disclaimerVersion： "1.0" 的同意文件
2. 如果有效同意存在 → 打印带有 acceptedAt 日期的警告，继续
3. 如果没有同意 → 显示免责声明，通过 AskUserQuestion 询问用户：
   • “是，我接受” → 创建带有 ISO 时间戳的同意文件，继续
   • “否，我拒绝” → 输出拒绝消息，停止
4. 同意文件格式：{"version"：1,"accepted"：true,"acceptedAt"："<ISO>","disclaimerVersion"："1.0"}

偏好设置 (EXTEND.md)

检查 EXTEND.md 是否存在（优先级顺序）：

# macOS, Linux, WSL, Git Bash
test -f .baoyu-skills/baoyu-danger-gemini-web/EXTEND.md && echo "project"
test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-danger-gemini-web/EXTEND.md" && echo "xdg"
test -f "$HOME/.baoyu-skills/baoyu-danger-gemini-web/EXTEND.md" && echo "user"

# PowerShell (Windows)
if (Test-Path .baoyu-skills/baoyu-danger-gemini-web/EXTEND.md) { "project" }
$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }
if (Test-Path "$xdg/baoyu-skills/baoyu-danger-gemini-web/EXTEND.md") { "xdg" }
if (Test-Path "$HOME/.baoyu-skills/baoyu-danger-gemini-web/EXTEND.md") { "user" }

┌──────────────────────────────────────────────────────────┬───────────────────┐
│ 路径 │ 位置 │
├──────────────────────────────────────────────────────────┼───────────────────┤
│ .baoyu-skills/baoyu-danger-gemini-web/EXTEND.md │ 项目目录 │
├──────────────────────────────────────────────────────────┼───────────────────┤
│ $HOME/.baoyu-skills/baoyu-danger-gemini-web/EXTEND.md │ 用户主目录 │
└──────────────────────────────────────────────────────────┴───────────────────┘

┌───────────┬───────────────────────────────────────────────────────────────────────────┐
│ 结果 │ 操作 │
├───────────┼───────────────────────────────────────────────────────────────────────────┤
│ 找到 │ 读取、解析、应用设置 │
├───────────┼───────────────────────────────────────────────────────────────────────────┤
│ 未找到 │ 使用默认设置 │
└───────────┴───────────────────────────────────────────────────────────────────────────┘

EXTEND.md 支持：默认模型 | 代理设置 | 自定义数据目录

使用方法

# 文本生成
${BUN_X} {baseDir}/scripts/main.ts "你的提示词"
${BUN_X} {baseDir}/scripts/main.ts --prompt "你的提示词" --model gemini-3-flash

# 图像生成
${BUN_X} {baseDir}/scripts/main.ts --prompt "一只可爱的猫" --image cat.png
${BUN_X} {baseDir}/scripts/main.ts --promptfiles system.md content.md --image out.png

# 视觉输入（参考图像）
${BUN_X} {baseDir}/scripts/main.ts --prompt "描述这个" --reference image.png
${BUN_X} {baseDir}/scripts/main.ts --prompt "创建变体" --reference a.png --image out.png

# 多轮对话
${BUN_X} {baseDir}/scripts/main.ts "记住： 42" --sessionId session-abc
${BUN_X} {baseDir}/scripts/main.ts "什么数字？" --sessionId session-abc

# JSON 输出
${BUN_X} {baseDir}/scripts/main.ts "你好" --json

选项

模型

身份验证

首次运行会打开浏览器进行谷歌身份验证。Cookie 会自动缓存。

支持的浏览器（自动检测）：Chrome、Chrome Canary/Beta、Chromium、Edge。

强制刷新：使用 --login 标志。覆盖浏览器：使用 GEMINI_WEB_CHROME_PATH 环境变量。

环境变量

会话

会话文件存储在数据目录下的 sessions/<id>.json 中。

包含：id、metadata（Gemini 聊天状态）、messages 数组、时间戳。

扩展支持

通过 EXTEND.md 进行自定义配置。参见偏好设置部分了解路径和支持的选项。