OpenCode API Skill（完整版 v3.0）

通过 HTTP API 调用已启动的 OpenCode Server，使 OpenClaw 可向 OpenCode 分配 code review、代码分析、编码任务等工单。

📚 目录索引

如需了解某一主题的详细内容，请查阅对应的 reference 文件：

1. 快速开始

Sub-agent import（推荐）

import sys
sys.path.insert(0, "C:/Users/admin/.openclaw/workspace/skills/opencode-api/scripts")
from opencode_task import run_opencode_task, OpenCodeAPI

# 单次任务
result = run_opencode_task(
    prompt="请用繁体中文对以下代码进行 code review：ndef foo(): pass",
    model="minimax/MiniMax-M2.7",
    reasoning="high",
)
print(result.text)
print(result.session_id)
print(result.ok)

# 多轮对话
client = OpenCodeAPI(auto_start=True)
sid = client.create_session(title="PR Review")
r1 = client.send_message("请 review...", session_id=sid, model="minimax/MiniMax-M2.7")
r2 = client.send_message("第三点再详细点", session_id=sid)

CLI

python scripts/opencode_task.py --prompt "请帮我分析这个函数" --model minimax/MiniMax-M2.7 --reasoning high

2. Scripts 总览

3. 模型速查

查询可用模型：client.get_providers()

4. 思考深度（reasoning）

5. 派工上下文模板（Minecraft-translate 专用）

当向 OpenCode 派工时，必须在 prompt 中附上以下内容：

项目基本信息

重要文件夹对照

minecraft_translator_flet/
├── app/                          # Flet UI 主程序
│   ├── views/                    # View 组件
│   ├── icon_reader.py            # ZIP icon reader（含 LRU cache）
│   └── icon_index.py             # Icon 索引建立
├── translation_tool/             # 核心 CLI 工具
│   ├── core/                     # 翻译引擎（lm_translator, kubejs, ftb...）
│   ├── plugins/                  # 插件（ftbquests, kubejs, md...）
│   └── utils/                    # 共用工具（jar_browser.py, cache_shards.py...）
├── tests/                        # pytest 测试（需 venv）
├── docs/                          # 开发文档（SOP、AI_WORKFLOW_MANUAL...）
├── .icon_cache/                  # JAR icon 缓存
└── .venv/                        # Python 虚拟环境（依赖在此）

禁止假设

典型派工 prompt 示例

你是一个专业的 Python 开发者，帮我对此 PR 进行 code review。

## 项目背景
- 工作目录：`C:UsersadminDesktopminecraft_translator_flet`
- 主要语言：Python 3.12 + Flet 0.82.x
- 测试：`cd` 进入项目目录后，用 `.venvScriptspython.exe -m pytest` 执行

## 任务
请用繁体中文 review 此 PR 的变更：
[此处粘贴 PR 内容或 diff]

## 审查重点
1. 是否有破坏性变更未告知
2. 测试覆盖是否足够
3. 错误处理是否完整
4. 代码风格是否一致（建议使用 ruff formatter）
5. 是否存在安全疑虑
6. **Schema 新增字段 → 确认有对应实作读取**（见 `references/review-checklist.md`）
7. **Pattern matching 函数 → 提供边界条件测试**（见 `references/review-checklist.md`）
8. **常量/函数定义 → 确认没有被取代后遗留**（见 `references/review-checklist.md`）
9. **改动范围 → 只涵盖需修改的部分，无关代码不受影响**

## 输出格式
最后列出：
- ✅ 建议保留的优点
- ⚠️ 需要修改的问题（附文件:行号）
- 💡 改进建议

请用繁体中文回复，并在结尾列出你修改了哪些文件。

6. 触发关键字对照

依赖

# opencode_task.py：无外部依赖（标准库）
# opencode_client.py：pip install requests
# SDK 进阶功能（如 event subscribe）：pip install requests sseclient