Skip to content

README.md

Latest commit

 

History

History
211 lines (158 loc) · 4.71 KB

README.md

File metadata and controls

211 lines (158 loc) · 4.71 KB

opencode-setup

一键配置 OpenCode 环境，集成 oh-my-openagent、GSD 工作流和完整的 Agent 生态。

curl -fsSL https://raw.githubusercontent.com/Liber1917/opencode-setup/main/setup-opencode.sh | bash

或克隆后运行：

git clone https://github.com/Liber1917/opencode-setup.git
cd opencode-setup
./setup-opencode.sh

特性

  • Bun 运行时 — 无需预装 Node.js，自动安装 Bun，避免跨平台 PATH 问题
  • oh-my-openagent — 10 个 Agent + 8 个 Category 的模型路由
  • GSD 工作流 — 项目全生命周期管理
  • 零假设 — 不依赖任何预装工具（除 curl 和 git）

安装效果

~/.config/opencode/
├── opencode.json           ←  Provider + 插件配置（oh-my-openagent + superpowers）
├── oh-my-openagent.json    ←  Agent 模型路由
├── node_modules/           ←  oh-my-openagent + superpowers 插件
├── get-shit-done/          ←  GSD 工作流（自动克隆）
└── skills/                 ←  技能链接库

~/.claude/
└── settings.json           ←  Hooks 配置

使用方式

标准安装

curl -fsSL https://raw.githubusercontent.com/Liber1917/opencode-setup/main/setup-opencode.sh | bash

安装脚本会自动：

  1. 检测已有配置并备份
  2. 生成 opencode.json / oh-my-openagent.json / Claude settings
  3. 安装 Bun 运行时（如未安装）
  4. 通过 Bun 安装 OpenCode
  5. 安装 oh-my-openagent 插件
  6. 安装 GSD 工作流

自定义路径

export OPENCODE_CONFIG_DIR=/custom/path/opencode
export CLAUDE_CONFIG_DIR=/custom/path/claude
./setup-opencode.sh

备份

./backup-opencode-config.sh

配置

API 密钥

nano ~/.config/opencode/opencode.json
{
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "sk-your-key-here",
        "baseURL": "https://api.anthropic.com"
      }
    }
  }
}

使用 DeepSeek（Anthropic 兼容接口）：

{
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "sk-your-deepseek-key",
        "baseURL": "https://api.deepseek.com/anthropic"
      }
    }
  }
}

模型路由（可选）

oh-my-openagent 使用源码内置的默认模型 + 回退链，开箱即用。

如需自定义，编辑 ~/.config/opencode/oh-my-openagent.json，为 agent 添加 model 字段：

{
  "agents": {
    "oracle": {"model": "deepseek/deepseek-v4-flash"},
    "explore": {"model": "deepseek/deepseek-v4-flash"},
    "sisyphus-junior": {"model": "deepseek/deepseek-v4-flash"}
  }
}

不设 model = 使用内置默认，优先级：

agent model > category model > 用户 fallback_models > 源码内置回退链 > OpenCode 默认

Agent 一览

Agent 职责
hephaestus 构建与实现
oracle 架构、调试、高难度推理
librarian 外部文档、OSS 代码搜索
explore 代码库模式发现
multimodal-looker PDF/图片分析
prometheus 规划与策略
metis 预规划顾问
momus 计划评审
atlas 知识管理
sisyphus-junior 专注任务执行

Category 一览

Category 适用场景
visual-engineering 前端、UI/UX、CSS
ultrabrain 复杂逻辑、算法
deep 自主问题解决
artistry 创意/非常规方案
quick 单文件简单修改
unspecified-low 低难度杂项
unspecified-high 高难度杂项
writing 文档、写作

GSD 工作流

GSD (Get Shit Done) 提供完整的项目生命周期管理：

命令 功能
/gsd-new-project 初始化项目
/gsd-plan-phase 创建执行计划
/gsd-execute-phase 带原子提交的执行
/gsd-progress 进度跟踪
/gsd-help 全部命令列表

常见问题

node: not found

原因：在 WSL 中运行了 Windows npm 安装的 opencode。

解决：用 Bun 在 WSL 内重新安装：

# 确保在 WSL 内执行
curl -fsSL https://bun.sh/install | bash
source ~/.bashrc
bun install -g opencode-ai

插件不生效

重启 OpenCode 会话后生效。

GSD 克隆失败

git clone https://github.com/OpenAgentsInc/gsd.git ~/.config/opencode/get-shit-done

"未检测到 OpenCode 环境"

在 OpenCode 终端会话内运行命令。

环境要求

  • curl（安装 Bun 用）
  • git（安装 GSD 用）
  • 网络连接

Bun 和 OpenCode 由脚本自动安装。

文件清单

文件 说明
setup-opencode.sh 统一安装脚本（推荐）
backup-opencode-config.sh 配置文件备份

License

MIT