@ever-works/gemini-plugin (英语)
将生成工作委托给 双子座CLI。单个双子体 CLI 会话在临时工作空间内自主处理网络搜索、内容创建和文件生成.
说明: 这是双子座 国 际 输油管。 为了双子座 AI 供应商 (聊天完成/通过 Generative Language API 嵌入),参见
@ever-works/google-plugin。 。 。 .
插件元数据
| 外地 | 数值 |
|---|---|
| 身份证 | gemini |
| 类别 | pipeline |
| 能力 | pipeline, (中文(简体) ), form-schema-provider |
| 作者 | 永远工作团队 |
| 许可证 | AGPL-3.0 导弹 |
| 内建 | 对 |
| 可自动启用 | 没有 |
管道步骤
该插件运行了6个相继步骤 :
| {\fn方正粗倩简体\fs12\an8\1cHFFFF00\b0} | 步骤 | 说明 | 可选 |
|---|---|---|---|
| 1个 | 设置双子座 CLI | 通过 npm 安装/控制双子座 CLI 并解析认证 | 没有 |
| 2个 | 准备背景 | 创建临时工作空间、种子现有项目和元数据 | 没有 |
| 3个 | 生成项目 | 将双子体 CLI 作为 JSON 文件进行研究和生成项目 | 没有 |
| 页:1 | 收集结果 | 读取生成的 JSON 文件返回到管道结果 | 没有 |
| 页:1 | 抓取屏幕截图 | 对生成的项目进行截图( 通过截图提供者) | 对 |
| 6个 | 清理 | 删除临时工作空间 | 对 |
步骤3,a 分类学观察者 监视新项目文件的工作空间并保存 _meta/ 实时同步分类文件(类别,标签,品牌). 按项目报告进展情况.
认证
提供双子座 API 密钥来自 谷歌AI工作室 在插件设置中 (apiKey 页:1.
此插件不重用主机双子星 CLI 登录状态 ~/.gemini/。 。 。 .
身份证明必须来自 Ever Works 用户设置, 所以每个用户都会保存孤立的认证 .
运行时段还采用了孤立的每用户双子座/配置工作,而不是机器用户的家.
设置
| 设置 | 类型 | 范围 | 说明 |
|---|---|---|---|
apiKey | 字符串 | 用户 | 双子座 API 密钥( 密钥, 支持 env var) PLUGIN_GEMINI_API_KEY(中文(简体) ) |
model | 字符串 | 用户 | 生成模型( 默认 ): gemini-2.5-flash(中文(简体) ) |
version | 字符串 | 隐藏 | 要安装的双子座 CLI 版本( 默认 ): latest(中文(简体) ) |
支持的模式
- 双子座 2.5 闪光 (默认) - 200k 上下文
- 双子座2.5 Pro - 200公里背景
- 双子座2.0闪光 - 200公里背景
表单Schema
插件提供了一个用户格式,有两个可配置字段:
| 外地 | 类型 | 默认 | 验证 | 说明 |
|---|---|---|---|---|
target_items | 编号 | 第50条 | 1 -500 (中文(简体) ) | 要生成的新项目的目标数量 |
capture_screenshots | 布尔 | 虚假 | - 说吧 | 获取生成项目的截图 |
提示系统
提示通过一个即时外观(如:Langfuse)来管理. 当找不到外部提示时,硬码默认被作为倒置.
提示键 :
gemini.system- 系统即时模板gemini.user- 用户提示模板
两者都支持工作环境、现有项目、类别、标签和品牌的可变替代.
二进制管理
插件将双子座 CLI 运行到 npx数字 :
- 用途
npx --yes @google/gemini-cli - 支持将版本接通
@google/gemini-cli@<version> - 默认版本 :
latest
处理错误
- 非零退出代码:作为软警告处理. 如果物品仍在生产中,结果就会成功,并附有警告.
- 空结果: 如果双子座完成而未产生任何有效的项目JSON文件,则会与 CLI 输出节选一起出错以进行调试.
- 隐蔽的秘密编号:
getRealSecret帮助在使用证书前过滤出 UI 占位符值 .
项目结构
src/
gemini.plugin.ts # Main plugin class (IPlugin, IPipelinePlugin, IFormSchemaProvider)
types.ts # Step IDs, constants
steps.ts # Pipeline step definitions
form-schema.ts # Form fields, groups, validation
prompt-keys.ts # Prompt facade keys
index.ts # Public exports
prompt/
system-prompt.ts # Default prompts and variable builders
utils/
binary-manager.ts # CLI installation via npm
pipeline-helpers.ts # State management, auth resolution, progress reporting
process-runner.ts # Gemini CLI subprocess execution
workspace-manager.ts # Workspace I/O (create, seed, read, cleanup)
screenshot-capture.ts # Screenshot facade integration
taxonomy-sync.ts # Merge new categories/tags/brands into _meta files
taxonomy-watcher.ts # Filesystem watcher for live taxonomy sync
platform.ts # Platform detection helpers
发展
# Build
pnpm build
# Type-check
pnpm type-check
# Run tests
pnpm test
# Watch mode
pnpm test:watch
# Coverage
pnpm test:coverage
解决问题
| 症状 | 可能的原因是 | 修补 |
|---|---|---|
世代从不开始/留在 0% | gemini 未选择此工程的运行中的管道插件 | 打开工作 插件 → pipeline 能力和设置 gemini 作为活动管道;或 设置为全球管道默认 设置 — 插件 |
步骤失败 No AI / search / screenshot provider configured | 管道依赖于无法启用或没有证书的能力插件 | 启用并配置工作或全球匹配能力插件( AI 提供者、 搜索、 截图、 内容提取器) |
| 步骤输出看起来错误/ 通用 | Form-field 调制未设置; 使用与工程域不符的默认管道 | 打开 生成表单 为工作设置特定域(类别、目标关键词、源 URL),并重运行受影响的步骤 |
子进程错误 : command not found | Gemini Generator 运行 API 主机上未安装 CLI | 在 API 主机上安装双子增殖器 CLI 并确保它启用 PATH; 通过运行验证 which <cli> 发射的同一枚炮弹 pnpm dev:api |
| 认证 / 设备- 自动流动站 | 上游 IDE / 浏览器中从未确认设备自动代码 | 重运行设备自动流出 设置 – 插件 – 遗传 – 连接,然后在代码到期前在上游服务中填写提示 |
| 主机重启后管道无法恢复 | 检查站没有继续存在(今天只有标准管道维持检查站) | 取消被卡住的运行并重新触发生成; 因为生产可靠性更可取 standard-pipeline |
文档
许可证
AGPL-3.0 导弹