# ============================================================
# AgentDock 适配器 · Goose（Linux 基金会 AAIF / Block）（Wave 3）
# 数据依据：调研底稿 agent-cli-survey-2026-08-24.md + 架构 §3.3
# 注意：配置 YAML；Windows 路径差异 %APPDATA%\Block\goose\config\；密钥默认进系统钥匙串。
# ============================================================
id: goose
name: Goose
name_zh: Goose
vendor: Linux 基金会（AAIF）
status: available
adapter_version: 1.1.0
license: Apache-2.0

platforms:
  windows:
    architectures: [x64]
    notes: 官方 download_cli.ps1；配置位于 %APPDATA%\Block\goose\config\
  linux:
    distributions: [ubuntu]
    architectures: [x64]

official:
  homepage: https://block.github.io/goose/
  docs: https://block.github.io/goose/docs/
  allowed_hosts: [github.com, api.github.com, raw.githubusercontent.com, block.github.io]

runtime_deps: []

install:
  preferred: official_script
  channels:
    - id: official_script
      platforms: [windows]
      script:
        url: https://raw.githubusercontent.com/aaif-goose/goose/main/download_cli.ps1
        kind: powershell_irm
      elevate: never
      post_checks: [detect]
    - id: official_script
      platforms: [linux]
      script:
        url: https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh
        kind: bash_pipe
      elevate: never
      post_checks: [detect]
    - id: github_release
      platforms: [windows, linux]
      package: goose
      elevate: never
      post_checks: [detect]

detect:
  executable: goose
  version_args: ["--version"]

update:
  method: self_update_cmd
  command: [goose, update]
  source:
    kind: github
    repo: aaif-goose/goose

uninstall:
  method: manual_delete
  command: []
  keep_config_default: true

authorization:
  modes:
    - mode: api_key
      env_keys: [ANTHROPIC_API_KEY, OPENAI_API_KEY]
      notes_zh: 各家模型 API Key（密钥默认进系统钥匙串）；另有订阅 ACP 接入

# 配置机制（调研底稿 Goose 章节）：YAML。密钥默认进系统钥匙串，不写入 config.yaml。
# 按平台选型（引擎按 files[].platforms 过滤当前平台）：
#   Windows  -> %APPDATA%\Block\goose\config\config.yaml（比旧版多一层 config\）
#   Linux    -> ~/.config/goose/config.yaml
configuration:
  files:
    - path: "%APPDATA%\\Block\\goose\\config\\config.yaml"
      format: yaml
      scope: user
      platforms: [windows]
    - path: "~/.config/goose/config.yaml"
      format: yaml
      scope: user
      platforms: [linux]
  environment:
    - key: ANTHROPIC_API_KEY
      sensitive: true
      maps_to_field: api_key
  fields:
    - id: GOOSE_PROVIDER
      label_zh: 默认 Provider
      group: common
      help_zh: 官方键 GOOSE_PROVIDER（如 anthropic / openai / databricks / ollama 等）
      required: false
      sensitive: false
      type: string
      storage: file
      docs_url: https://block.github.io/goose/docs/
    - id: GOOSE_MODEL
      label_zh: 默认模型
      group: common
      help_zh: 官方键 GOOSE_MODEL，默认模型
      required: false
      sensitive: false
      type: string
      storage: file
      docs_url: https://block.github.io/goose/docs/
    - id: api_key
      label_zh: API Key
      group: auth
      help_zh: 存入系统钥匙串（Goose 密钥本就默认进系统钥匙串，不写入 config.yaml）
      required: false
      sensitive: true
      type: string
      storage: keyring
      docs_url: https://block.github.io/goose/docs/

diagnostics:
  - rule_id: path.not_installed
  - rule_id: path.not_in_path
  - rule_id: version_conflict.multiple_copies
  - rule_id: config.corrupt

documentation:
  quickstart_zh: 安装后配置 provider 与 API Key，运行 `goose` 进入会话，或用 `goose -p "提示词"` 无头执行。
  install_zh: Windows 用官方 download_cli.ps1；Ubuntu 用官方 download_cli.sh。备选 GitHub Releases 二进制 / brew / deb。
  auth_zh: ① API Key：各家模型 Key（Anthropic/OpenAI 等），密钥默认进系统钥匙串；② 订阅 ACP（Agent Client Protocol）接入。
  commands:
    - cmd: goose
      desc_zh: 启动交互式会话
    - cmd: goose -p "提示词"
      desc_zh: 无头单次执行
    - cmd: goose configure
      desc_zh: 交互式配置 provider/模型
    - cmd: goose --version
      desc_zh: 显示版本号
  params:
    - param: -p / --print
      desc_zh: 无头模式执行后退出
    - param: --provider
      desc_zh: 指定 provider
    - param: --model
      desc_zh: 指定模型
    - param: --version
      desc_zh: 显示版本号
  updated_at: "2026-08-25"
  risks_zh:
    - 安装 URL 与配置路径已按官方与调研底稿核对（aaif-goose 仓库；Windows 为 %APPDATA%\Block\goose\config\config.yaml，Linux 为 ~/.config/goose/config.yaml）
    - Windows 配置路径比旧版多一层 config\（%APPDATA%\Block\goose\config\），引擎按 files[].platforms 选型
    - 密钥默认进系统钥匙串，AgentDock 与之对齐，不把 Key 写入 config.yaml
    - extensions / profiles 等高级配置本表单不覆盖，以官方文档为准