skills: remove obsolete opencode-config (replaced by opencode-plugins)

sync: import skills/, plugins/, memory/ and shared files from origin/main
Add AGENTS.md instructions and allow tracking it
2026-10-13 12:40:06 +08:00 · 2026-10-13 12:38:53 +08:00 · 2026-10-12 21:13:06 +08:00 · 2026-10-12 18:11:41 +08:00
7 changed files with 831 additions and 0 deletions
@@ -20,6 +20,7 @@
 !/plugins/
 !/memory/
 !/.gitignore
+!/AGENTS.md

 # Per-memory hit counters. Derived data: regenerating it costs one recall, and
 # committing it would rewrite the file on every retrieval and create merge
@@ -0,0 +1,23 @@
+# OpenCode 指令配置
+
+## 1. 称呼规范
+
+每次回复时必须称呼用户为 "小帅"。
+
+## 2. 代码文件存放规范
+
+没有既有项目结构时，新生成的辅助代码放到项目根目录的 `.code/` 文件夹，保持项目整洁；已有项目结构及框架要求的文件位置优先。
+
+## 3. 第一性原理与双轨回复
+
+**思维方式**：从原始需求出发，拒绝经验主义和路径盲从，不预设用户目标完全清晰。
+
+- 仅当缺失信息会实质改变目标、范围或结果时提问；其他细节说明合理假设后继续，可独立完成的工作先推进。
+
+**回复结构**：
+
+**直接执行**：始终提供，按当前要求与逻辑给出任务结果。
+
+**深度交互**：涉及方案设计、路径选择或目标定义时，仅当发现目标与方案存在明显错位，或有显著更省时省钱的路径时，简短指出并建议替代方案。纯执行类任务（改变量名、格式调整等）省略此部分。
+
+以上是行为要求，无需在每次回复中固定列出 "直接执行" 和 "深度交互" 两个栏目。
@@ -19,6 +19,7 @@
 | 目录 | 概述 | 条目 |
 |---|---|---|
 | decisions/ | 选 Markdown 因为人类可纠正性和可同步性，检索由插件做而非模型。 | 1 |
+| facts/ | 该目录自身是 git 仓库，只跟踪 skills/ plugins/ memor | 1 |
 | pitfalls/ | unicode61 把整段中文当一个 token，trigram 漏掉两字词，必 | 1 |
 | rules/ | 不可违反的硬规则，常驻 | 1 (1 钉住) |
 <!-- auto:end
@@ -29,8 +30,12 @@

 | 场景 / 触发 | 读哪个文件 | 类型 |
 |---|---|---|
+| ~/.config/opencode 改动 | facts/opencode-config-oc-repo.md | fact |
 | FTS5 | pitfalls/sqlite-cjk-tokenizer.md | fact |
 | memory | decisions/memory-store-format.md | fact |
+| oc 仓库 | facts/opencode-config-oc-repo.md | fact |
+| opencode 配置提交 | facts/opencode-config-oc-repo.md | fact |
+| skills plugins memory 推送 | facts/opencode-config-oc-repo.md | fact |
 | SQLite | pitfalls/sqlite-cjk-tokenizer.md | fact |
 | 中文检索 | pitfalls/sqlite-cjk-tokenizer.md | fact |
 | 为什么用 markdown | decisions/memory-store-format.md | fact |
@@ -0,0 +1,8 @@
+# facts 索引
+
+<!-- auto:begin facts
+
+| 文件 | 概述 | 重点 |
+|---|---|---|
+| opencode-config-oc-repo.md | 该目录自身是 git 仓库，只跟踪 skills/ plugins/ memory/ 三棵树，推送走 SSH 到 xiaoshuai/oc.git。 | 改动 skills/ plugins/ memory/ 后需单独在该目录 commit + push |
+<!-- auto:end
@@ -0,0 +1,15 @@
+---
+id: facts/opencode-config-oc-repo.md
+kind: fact
+summary: 该目录自身是 git 仓库，只跟踪 skills/ plugins/ memory/ 三棵树，推送走 SSH 到 xiaoshuai/oc.git。
+highlight: 改动 skills/ plugins/ memory/ 后需单独在该目录 commit + push
+created: 1791799869835
+updated: 1791799869835
+load_when:
+  - ~/.config/opencode 改动
+  - oc 仓库
+  - opencode 配置提交
+  - skills plugins memory 推送
+---
+
+`~/.config/opencode` 与任何项目仓库无关，是独立仓库：origin = git@git.xsinfo.vip:xiaoshuai/oc.git，分支 main，gitignore 用 `/*` 全忽略再 `!` 放行 skills/ plugins/ memory/（外加 .gitignore、pwsh.cmd、package.json），node_modules 与 memory/**/.state.json 不跟踪。在项目目录里跑 git status 看不到它的改动，必须 cd 过去。HTTPS 推送无凭据必失败，用 SSH。当前有效的提交准则见该仓库 memory/rules/only-commit-fully-tested.md：端到端跑通才提交、禁止 mock 冒充验证。
@@ -0,0 +1,142 @@
+---
+name: find-skills
+description: Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
+---
+
+# Find Skills
+
+This skill helps you discover and install skills from the open agent skills ecosystem.
+
+## When to Use This Skill
+
+Use this skill when the user:
+
+- Asks "how do I do X" where X might be a common task with an existing skill
+- Says "find a skill for X" or "is there a skill for X"
+- Asks "can you do X" where X is a specialized capability
+- Expresses interest in extending agent capabilities
+- Wants to search for tools, templates, or workflows
+- Mentions they wish they had help with a specific domain (design, testing, deployment, etc.)
+
+## What is the Skills CLI?
+
+The Skills CLI (`npx skills`) is the package manager for the open agent skills ecosystem. Skills are modular packages that extend agent capabilities with specialized knowledge, workflows, and tools.
+
+**Key commands:**
+
+- `npx skills find [query]` - Search for skills interactively or by keyword
+- `npx skills add <package>` - Install a skill from GitHub or other sources
+- `npx skills check` - Check for skill updates
+- `npx skills update` - Update all installed skills
+
+**Browse skills at:** https://skills.sh/
+
+## How to Help Users Find Skills
+
+### Step 1: Understand What They Need
+
+When a user asks for help with something, identify:
+
+1. The domain (e.g., React, testing, design, deployment)
+2. The specific task (e.g., writing tests, creating animations, reviewing PRs)
+3. Whether this is a common enough task that a skill likely exists
+
+### Step 2: Check the Leaderboard First
+
+Before running a CLI search, check the [skills.sh leaderboard](https://skills.sh/) to see if a well-known skill already exists for the domain. The leaderboard ranks skills by total installs, surfacing the most popular and battle-tested options.
+
+For example, top skills for web development include:
+- `vercel-labs/agent-skills` — React, Next.js, web design (100K+ installs each)
+- `anthropics/skills` — Frontend design, document processing (100K+ installs)
+
+### Step 3: Search for Skills
+
+If the leaderboard doesn't cover the user's need, run the find command:
+
+```bash
+npx skills find [query]
+```
+
+For example:
+
+- User asks "how do I make my React app faster?" → `npx skills find react performance`
+- User asks "can you help me with PR reviews?" → `npx skills find pr review`
+- User asks "I need to create a changelog" → `npx skills find changelog`
+
+### Step 4: Verify Quality Before Recommending
+
+**Do not recommend a skill based solely on search results.** Always verify:
+
+1. **Install count** — Prefer skills with 1K+ installs. Be cautious with anything under 100.
+2. **Source reputation** — Official sources (`vercel-labs`, `anthropics`, `microsoft`) are more trustworthy than unknown authors.
+3. **GitHub stars** — Check the source repository. A skill from a repo with <100 stars should be treated with skepticism.
+
+### Step 5: Present Options to the User
+
+When you find relevant skills, present them to the user with:
+
+1. The skill name and what it does
+2. The install count and source
+3. The install command they can run
+4. A link to learn more at skills.sh
+
+Example response:
+
+```
+I found a skill that might help! The "react-best-practices" skill provides
+React and Next.js performance optimization guidelines from Vercel Engineering.
+(185K installs)
+
+To install it:
+npx skills add vercel-labs/agent-skills@react-best-practices
+
+Learn more: https://skills.sh/vercel-labs/agent-skills/react-best-practices
+```
+
+### Step 6: Offer to Install
+
+If the user wants to proceed, you can install the skill for them:
+
+```bash
+npx skills add <owner/repo@skill> -g -y
+```
+
+The `-g` flag installs globally (user-level) and `-y` skips confirmation prompts.
+
+## Common Skill Categories
+
+When searching, consider these common categories:
+
+| Category        | Example Queries                          |
+| --------------- | ---------------------------------------- |
+| Web Development | react, nextjs, typescript, css, tailwind |
+| Testing         | testing, jest, playwright, e2e           |
+| DevOps          | deploy, docker, kubernetes, ci-cd        |
+| Documentation   | docs, readme, changelog, api-docs        |
+| Code Quality    | review, lint, refactor, best-practices   |
+| Design          | ui, ux, design-system, accessibility     |
+| Productivity    | workflow, automation, git                |
+
+## Tips for Effective Searches
+
+1. **Use specific keywords**: "react testing" is better than just "testing"
+2. **Try alternative terms**: If "deploy" doesn't work, try "deployment" or "ci-cd"
+3. **Check popular sources**: Many skills come from `vercel-labs/agent-skills` or `ComposioHQ/awesome-claude-skills`
+
+## When No Skills Are Found
+
+If no relevant skills exist:
+
+1. Acknowledge that no existing skill was found
+2. Offer to help with the task directly using your general capabilities
+3. Suggest the user could create their own skill with `npx skills init`
+
+Example:
+
+```
+I searched for skills related to "xyz" but didn't find any matches.
+I can still help you with this task directly! Would you like me to proceed?
+
+If this is something you do often, you could create your own skill:
+npx skills init my-xyz-skill
+```
@@ -0,0 +1,637 @@
+---
+name: mmx
+description: MiniMax CLI (mmx) 技能索引。提供文本生成、语音合成、图像生成、视频生成、音乐生成、网络搜索、视觉理解等 AI 能力的命令行接口。当任务涉及 MiniMax API 调用、内容生成、或需要 AI 多模态能力时使用此技能。
+---
+
+# MiniMax CLI (mmx) Skill
+
+MiniMax AI 多模态命令行工具，整合了 Text Generation、Speech Synthesis、Image Generation、Video Generation、Music Generation、Web Search、Vision 等能力。
+
+## Global Flags
+
+| Flag | 说明 |
+|------|------|
+| `--api-key <key>` | API Key (覆盖其他认证方式) |
+| `--region <region>` | API 区域: `global` (默认) / `cn` |
+| `--base-url <url>` | API Base URL (覆盖 region) |
+| `--output <format>` | 输出格式: `text` / `json` |
+| `--quiet` | 抑制非必要输出 |
+| `--verbose` | 打印 HTTP 请求/响应详情 |
+| `--timeout <seconds>` | 请求超时 (默认: 300) |
+| `--no-color` | 禁用 ANSI 颜色和动画 |
+| `--dry-run` | 显示将要执行的操作但不实际执行 |
+| `--non-interactive` | 禁用交互式提示 (CI/agent 模式) |
+
+## Resource Index
+
+### 1. auth - 认证
+
+| Command | 说明 |
+|---------|------|
+| `auth login` | 通过 OAuth 或 API Key 认证 |
+| `auth status` | 显示当前认证状态和配额快照 |
+| `auth refresh` | 手动刷新 OAuth Token |
+| `auth logout` | 撤销 Token 并清除存储的凭据 |
+
+#### auth login
+
+```
+mmx auth login [--api-key <key>] [--recommend] [--region=global|cn]
+```
+
+- `--api-key <key>` 直接保存 API Key
+- `--recommend` 直接进入 OAuth (可配合 `--region=` 跳过区域选择)
+
+#### auth status
+
+```
+mmx auth status
+```
+
+#### auth refresh
+
+```
+mmx auth refresh
+```
+
+#### auth logout
+
+```
+mmx auth logout [--yes] [--dry-run]
+```
+
+- `--yes` 跳过确认提示
+
+---
+
+### 2. text - 文本生成
+
+| Command | 说明 |
+|---------|------|
+| `text chat` | 发送聊天补全 (MiniMax Messages API) |
+| `text repl` | 启动交互式多轮对话会话 |
+
+#### text chat
+
+```
+mmx text chat --message <text> [flags]
+```
+
+| Flag | 说明 | 默认值 |
+|------|------|--------|
+| `--model <model>` | 模型 ID | `MiniMax-M2.7` |
+| `--message <text>` | 消息文本 (可重复, 前缀 `role:` 设置角色) | - |
+| `--messages-file <path>` | JSON 文件包含消息数组 (`-` 表示 stdin) | - |
+| `--system <text>` | 系统提示词 | - |
+| `--max-tokens <n>` | 最大生成 Token 数 | 4096 |
+| `--temperature <n>` | 采样温度 (0.0, 1.0] | - |
+| `--top-p <n>` | 核采样阈值 | - |
+| `--stream` | 流式响应 (TTY 中默认开启) | - |
+| `--tool <json-or-path>` | 工具定义 (可重复) | - |
+
+**Examples:**
+
+```bash
+mmx text chat --message "What is MiniMax?"
+mmx text chat --model MiniMax-M2.7-highspeed --system "You are a coding assistant." --message "Write fizzbuzz in Python"
+cat conversation.json | mmx text chat --messages-file - --stream
+```
+
+#### text repl
+
+```
+mmx text repl [flags]
+```
+
+| Flag | 说明 | 默认值 |
+|------|------|--------|
+| `--model <model>` | 模型 ID | `MiniMax-M2.7` |
+| `--system <text>` | 系统提示词 | - |
+| `--max-tokens <n>` | 每响应最大 Token 数 | 4096 |
+| `--temperature <n>` | 采样温度 (0.0, 1.0] | - |
+| `--top-p <n>` | 核采样阈值 | - |
+
+**Examples:**
+
+```bash
+mmx text repl
+mmx text repl --model MiniMax-M2.7-highspeed --system "You are a coding assistant."
+```
+
+---
+
+### 3. speech - 语音合成
+
+| Command | 说明 |
+|---------|------|
+| `speech synthesize` | 同步 TTS, 最多 10k 字符 (speech-2.8-hd / 2.6 / 02) |
+| `speech generate` | synthesize 的别名 |
+| `speech voices` | 列出可用的系统声音 |
+
+#### speech synthesize
+
+```
+mmx speech synthesize --text <text> [--out <path>] [flags]
+```
+
+| Flag | 说明 | 默认值 |
+|------|------|--------|
+| `--model <model>` | 模型 ID | `speech-2.8-hd` |
+| `--text <text>` | 要合成的文本 | - |
+| `--text-file <path>` | 从文件读取文本 (`-` 表示 stdin) | - |
+| `--voice <id>` | 声音 ID | `English_expressive_narrator` |
+| `--speed <n>` | 语速倍数 | - |
+| `--volume <n>` | 音量 | - |
+| `--pitch <n>` | 音调调整 | - |
+| `--format <fmt>` | 音频格式: `mp3`, `pcm`, `flac`, `wav`, `pcmu_raw`, `pcmu_wav`, `opus` | `mp3` |
+| `--sample-rate <hz>` | 采样率 | `32000` |
+| `--bitrate <bps>` | 比特率 | `128000` |
+| `--channels <n>` | 声道数 | `1` |
+| `--language <code>` | 语言增强 | - |
+| `--subtitles` | 包含字幕时间数据 | - |
+| `--pronunciation <from/to>` | 自定义发音 (可重复) | - |
+| `--out <path>` | 保存音频到文件 | - |
+| `--stream` | 流式输出原始音频到 stdout | - |
+
+**Examples:**
+
+```bash
+mmx speech synthesize --text "Hello, world!"
+mmx speech synthesize --text "Hello, world!" --out hello.mp3
+echo "Breaking news." | mmx speech synthesize --text-file - --out news.mp3
+mmx speech synthesize --text "Stream" --stream | mpv --no-terminal -
+```
+
+#### speech voices
+
+```
+mmx speech voices [--language <lang>]
+```
+
+| Flag | 说明 |
+|------|------|
+| `--language <lang>` | 按语言过滤声音 (如 `english`, `korean`, `japanese`) |
+
+**Examples:**
+
+```bash
+mmx speech voices
+mmx speech voices --language english
+mmx speech voices --output json
+```
+
+---
+
+### 4. image - 图像生成
+
+| Command | 说明 |
+|---------|------|
+| `image generate` | 生成图像 (image-01 / image-01-live) |
+
+#### image generate
+
+```
+mmx image generate --prompt <text> [flags]
+```
+
+| Flag | 说明 | 默认值 |
+|------|------|--------|
+| `--prompt <text>` | 图像描述 | - |
+| `--aspect-ratio <ratio>` | 宽高比 (如 `16:9`, `1:1`) | - |
+| `--n <count>` | 生成图像数量 | `1` |
+| `--seed <n>` | 随机种子 (相同 seed + prompt = 相同输出) | - |
+| `--width <px>` | 自定义宽度 [512, 2048], 必须是 8 的倍数 | - |
+| `--height <px>` | 自定义高度 [512, 2048], 必须是 8 的倍数 | - |
+| `--prompt-optimizer` | 自动优化提示词 | - |
+| `--aigc-watermark` | 在输出图像中嵌入 AI 生成内容水印 | - |
+| `--subject-ref <params>` | 主体参考 (角色一致性): `type=character,image=path-or-url` | - |
+| `--out <path>` | 保存图像到指定路径 (仅单张) | - |
+| `--response-format <format>` | 响应格式: `url` (下载), `base64` (嵌入) | `url` |
+| `--out-dir <dir>` | 下载图像到目录 | - |
+| `--out-prefix <prefix>` | 文件名前缀 | `image` |
+
+**Examples:**
+
+```bash
+mmx image generate --prompt "A cat in a spacesuit on Mars" --aspect-ratio 16:9
+mmx image generate --prompt "Logo design" --n 3 --out-dir ./generated/
+mmx image generate --prompt "Mountain landscape" --quiet
+mmx image generate --prompt "A castle" --seed 42
+mmx image generate --prompt "Wide landscape" --width 1920 --height 1080
+mmx image generate --prompt "sunset" --prompt-optimizer --aigc-watermark
+mmx image generate --prompt "A cat" --out /tmp/cat.jpg
+mmx image generate --prompt "A cat" --response-format base64
+```
+
+---
+
+### 5. video - 视频生成
+
+| Command | 说明 |
+|---------|------|
+| `video generate` | 生成视频 (T2V/I2V/SEF/S2V) |
+| `video task get` | 查询视频任务状态 |
+| `video download` | 通过 File ID 下载完成的视频 |
+
+#### video generate
+
+```
+mmx video generate --prompt <text> [flags]
+```
+
+| Flag | 说明 |
+|------|------|
+| `--model <model>` | 模型: T2V 用 `MiniMax-Hailuo-2.3`; I2V 用 `MiniMax-Hailuo-2.3` (默认) 或 `MiniMax-Hailuo-2.3-Fast` (需要 `--first-frame`); 有 `--last-frame` 切换到 `Hailuo-02`; 有 `--subject-image` 切换到 `S2V-01` |
+| `--prompt <text>` | 视频描述 |
+| `--first-frame <path-or-url>` | 首帧图像 (本地路径或 URL) |
+| `--last-frame <path-or-url>` | 末帧图像 (需要 `--first-frame`, 启用 SEF 模式) |
+| `--subject-image <path-or-url>` | 主体参考图像 (角色一致性) |
+| `--callback-url <url>` | 完成通知的 Webhook URL |
+| `--download <path>` | 完成后保存视频到文件 |
+| `--no-wait` / `--async` | 立即返回任务 ID，不等待 |
+| `--poll-interval <seconds>` | 轮询间隔 (默认: 5) |
+
+**Video Modes:**
+
+| Mode | 说明 | 模型 |
+|------|------|------|
+| T2V | 文本转视频 | Hailuo-2.3 |
+| I2V | 图像转视频 | Hailuo-2.3 (默认) / Hailuo-2.3-Fast |
+| SEF | 首尾帧插值 | Hailuo-02 |
+| S2V | 主体一致性视频 | S2V-01 |
+
+**Examples:**
+
+```bash
+mmx video generate --prompt "A man reads a book. Static shot."
+mmx video generate --prompt "Ocean waves at sunset." --download sunset.mp4
+mmx video generate --prompt "A robot painting." --async --quiet
+mmx video generate --prompt "Walk forward" --first-frame start.jpg --last-frame end.jpg
+mmx video generate --prompt "A detective walking" --subject-image character.jpg
+```
+
+#### video task get
+
+```
+mmx video task get --task-id <id>
+```
+
+| Flag | 说明 |
+|------|------|
+| `--task-id <id>` | 视频生成任务 ID |
+
+**Examples:**
+
+```bash
+mmx video task get --task-id 106916112212032
+mmx video task get --task-id 106916112212032 --output json
+```
+
+#### video download
+
+```
+mmx video download --file-id <id> --out <path>
+```
+
+| Flag | 说明 |
+|------|------|
+| `--file-id <id>` | 要下载的文件 ID |
+| `--out <path>` | 输出文件路径 |
+
+**Examples:**
+
+```bash
+mmx video download --file-id 176844028768320 --out video.mp4
+```
+
+---
+
+### 6. music - 音乐生成
+
+| Command | 说明 |
+|---------|------|
+| `music generate` | 生成歌曲 (music-2.6 / music-2.5+ / music-2.5) |
+| `music cover` | 基于参考音频生成歌曲的翻唱版本 (music-cover) |
+
+#### music generate
+
+```
+mmx music generate --prompt <text> (--lyrics <text> | --instrumental | --lyrics-optimizer) [--out <path>] [flags]
+```
+
+| Flag | 说明 | 默认值 |
+|------|------|--------|
+| `--prompt <text>` | 音乐风格描述 (最多 2000 字符) | - |
+| `--lyrics <text>` | 带结构标签的歌词 | - |
+| `--lyrics-file <path>` | 从文件读取歌词 (`-` 表示 stdin) | - |
+| `--lyrics-optimizer` | 从 prompt 自动生成歌词 (不能与 `--lyrics` 或 `--instrumental` 共用) | - |
+| `--instrumental` | 生成器乐音乐 | - |
+| `--vocals <text>` | 人声风格, 如 "warm male baritone" | - |
+| `--genre <text>` | 音乐流派, 如 folk, pop, jazz, electronic | - |
+| `--mood <text>` | 情绪, 如 warm, melancholic, uplifting | - |
+| `--instruments <text>` | 要突出的乐器 | - |
+| `--tempo <text>` | 节奏描述, 如 fast, slow, moderate | - |
+| `--bpm <number>` | 精确 BPM | - |
+| `--key <text>` | 调性, 如 C major, A minor | - |
+| `--avoid <text>` | 要避免的元素 | - |
+| `--use-case <text>` | 使用场景, 如 "background music for video" | - |
+| `--structure <text>` | 歌曲结构 | - |
+| `--references <text>` | 参考曲目或艺术家 | - |
+| `--extra <text>` | 额外细化需求 | - |
+| `--model <model>` | 模型: `music-2.6` (默认), `music-2.5+`, `music-2.5` | `music-2.6` |
+| `--output-format <fmt>` | 返回格式: `hex` (默认, 保存到文件) 或 `url` (24h 过期) | `hex` |
+| `--aigc-watermark` | 嵌入 AI 生成内容水印 | - |
+| `--format <fmt>` | 音频格式: `mp3`, `wav`, `pcm` | `mp3` |
+| `--sample-rate <hz>` | 采样率 | `44100` |
+| `--bitrate <bps>` | 比特率 | `256000` |
+| `--stream` | 流式输出原始音频到 stdout | - |
+| `--out <path>` | 保存音频到文件 | - |
+
+**Lyrics 结构标签:**
+
+`[Intro]`, `[Verse]`, `[Pre Chorus]`, `[Chorus]`, `[Interlude]`, `[Bridge]`, `[Outro]`, `[Post Chorus]`, `[Transition]`, `[Break]`, `[Hook]`, `[Build Up]`, `[Inst]`, `[Solo]`
+
+**Examples:**
+
+```bash
+mmx music generate --prompt "Upbeat pop" --lyrics "La la la..." --out summer.mp3
+mmx music generate --prompt "Indie folk, melancholic" --lyrics-file song.txt --out my_song.mp3
+mmx music generate --prompt "Upbeat pop about summer" --lyrics-optimizer --out summer.mp3
+mmx music generate --prompt "Cinematic orchestral, building tension" --instrumental --out bgm.mp3
+mmx music generate --prompt "Upbeat pop" --lyrics "La la la..." --output-format url
+mmx music generate --prompt "Warm morning folk" --vocals "male and female duet, harmonies in chorus" --instruments "acoustic guitar, piano" --bpm 95 --out duet.mp3
+```
+
+#### music cover
+
+```
+mmx music cover --prompt <text> (--audio <url> | --audio-file <path>) [--lyrics <text>] [--out <path>] [flags]
+```
+
+| Flag | 说明 | 默认值 |
+|------|------|--------|
+| `--model <model>` | 模型: `music-cover` (默认) | `music-cover` |
+| `--prompt <text>` | 目标翻唱风格, 如 "Indie folk, acoustic guitar, warm male vocal" | - |
+| `--audio <url>` | 参考音频 URL (mp3/wav/flac, 6s-6min, 最大 50MB) | - |
+| `--audio-file <path>` | 本地参考音频文件 (自动 Base64 编码) | - |
+| `--lyrics <text>` | 翻唱歌词 (省略则通过 ASR 从参考音频提取) | - |
+| `--lyrics-file <path>` | 从文件读取歌词 (`-` 表示 stdin) | - |
+| `--seed <number>` | 随机种子 0-1000000 | - |
+| `--format <fmt>` | 音频格式: `mp3`, `wav`, `pcm` | `mp3` |
+| `--sample-rate <hz>` | 采样率 | `44100` |
+| `--bitrate <bps>` | 比特率 | `256000` |
+| `--channel <n>` | 声道: `1` (单声道) / `2` (立体声, 默认) | `2` |
+| `--stream` | 流式输出原始音频到 stdout | - |
+| `--out <path>` | 保存音频到文件 | - |
+
+**Examples:**
+
+```bash
+mmx music cover --prompt "Indie folk, acoustic guitar, warm male vocal" --audio https://example.com/song.mp3 --out cover.mp3
+mmx music cover --prompt "Jazz, piano, slow" --audio-file original.mp3 --lyrics-file lyrics.txt --out jazz_cover.mp3
+mmx music cover --prompt "Pop, upbeat" --audio https://example.com/ref.mp3 --seed 42 --out reproducible.mp3
+```
+
+---
+
+### 7. search - 网络搜索
+
+| Command | 说明 |
+|---------|------|
+| `search query` | 通过 MiniMax 搜索网页 |
+| `search web` | `search query` 的别名 |
+
+#### search query
+
+```
+mmx search query --q <query>
+```
+
+| Flag | 说明 |
+|------|------|
+| `--q <query>` | 搜索查询字符串 |
+
+**Examples:**
+
+```bash
+mmx search query --q "MiniMax AI"
+mmx search query --q "latest news" --output json
+```
+
+---
+
+### 8. vision - 视觉理解
+
+| Command | 说明 |
+|---------|------|
+| `vision describe` | 使用 MiniMax VLM 描述图像 |
+
+#### vision describe
+
+```
+mmx vision describe (--image <path-or-url> | --file-id <id>) [--prompt <text>]
+```
+
+| Flag | 说明 | 默认值 |
+|------|------|--------|
+| `--image <path-or-url>` | 本地图像路径或 URL (自动 Base64 编码) | - |
+| `--file-id <id>` | 预上传的文件 ID (跳过 Base64 转换) | - |
+| `--prompt <text>` | 关于图像的问题 | `"Describe the image."` |
+
+**Examples:**
+
+```bash
+mmx vision describe --image photo.jpg
+mmx vision describe --image https://example.com/photo.jpg --prompt "What breed is this dog?"
+mmx vision describe --file-id file-123456789 --prompt "Extract the text"
+```
+
+---
+
+### 9. quota - 使用配额
+
+| Command | 说明 |
+|---------|------|
+| `quota show` | 显示 Token Plan 使用情况和剩余配额 |
+
+#### quota show
+
+```
+mmx quota show
+```
+
+**Examples:**
+
+```bash
+mmx quota show
+mmx quota show --output json
+```
+
+---
+
+### 10. config - CLI 配置
+
+| Command | 说明 |
+|---------|------|
+| `config show` | 显示当前配置 |
+| `config set` | 设置配置值 |
+| `config export-schema` | 导出 CLI 命令为 Anthropic/OpenAI 兼容的 JSON 工具模式 |
+
+#### config show
+
+```
+mmx config show
+```
+
+**Examples:**
+
+```bash
+mmx config show
+mmx config show --output json
+```
+
+#### config set
+
+```
+mmx config set --key <key> --value <value>
+```
+
+| Flag | 说明 |
+|------|------|
+| `--key <key>` | 配置键: `region`, `base_url`, `output`, `timeout`, `api_key`, `proxy`, `default_text_model`, `default_speech_model`, `default_video_model`, `default_music_model` |
+| `--value <value>` | 要设置的值 |
+
+**Examples:**
+
+```bash
+mmx config set --key output --value json
+mmx config set --key timeout --value 600
+mmx config set --key proxy --value http://127.0.0.1:7890
+mmx config set --key base_url --value https://api-uw.minimax.io
+```
+
+#### config export-schema
+
+```
+mmx config export-schema [--command "<name>"]
+```
+
+| Flag | 说明 |
+|------|------|
+| `--command <name>` | 仅导出特定命令的模式 (如 `video generate`) |
+
+**Examples:**
+
+```bash
+mmx config export-schema
+mmx config export-schema --command "video generate"
+```
+
+---
+
+### 11. file - 文件存储
+
+| Command | 说明 |
+|---------|------|
+| `file upload` | 上传文件到 MiniMax 存储 |
+| `file list` | 列出已上传的文件 |
+| `file delete` | 删除已上传的文件 |
+
+#### file upload
+
+```
+mmx file upload --file <path> [--purpose <purpose>]
+```
+
+| Flag | 说明 | 默认值 |
+|------|------|--------|
+| `--file <path>` | 文件的本地路径 | - |
+| `--purpose <string>` | 文件用途 (默认: `retrieval`) | `retrieval` |
+
+**Examples:**
+
+```bash
+mmx file upload --file doc.pdf
+mmx file upload --file image.png --purpose vision
+```
+
+#### file list
+
+```
+mmx file list
+```
+
+**Examples:**
+
+```bash
+mmx file list
+mmx file list --output json
+```
+
+#### file delete
+
+```
+mmx file delete --file-id <id>
+```
+
+| Flag | 说明 |
+|------|------|
+| `--file-id <id>` | 要删除的文件 ID |
+
+**Examples:**
+
+```bash
+mmx file delete --file-id 123456789
+```
+
+---
+
+### 12. update - 更新
+
+```
+mmx update
+```
+
+更新 mmx 到最新版本。
+
+---
+
+## Quick Reference
+
+```bash
+# 认证
+mmx auth login --api-key sk-cp-xxxxx
+mmx auth status
+
+# 文本生成
+mmx text chat --message "Hello"
+
+# 语音合成
+mmx speech synthesize --text "Hello" --out hello.mp3
+
+# 图像生成
+mmx image generate --prompt "A sunset" --aspect-ratio 16:9
+
+# 视频生成
+mmx video generate --prompt "A man walking" --async --quiet
+
+# 音乐生成
+mmx music generate --prompt "Upbeat pop" --lyrics "La la" --out song.mp3
+
+# 网络搜索
+mmx search query --q "MiniMax"
+
+# 视觉理解
+mmx vision describe --image photo.jpg
+
+# 查看配额
+mmx quota show
+```
+
+## API Reference
+
+- Text: https://platform.minimaxi.com/docs/api-reference/text-post
+- Speech: https://platform.minimaxi.com/docs/api-reference/speech-t2a-http
+- Image: https://platform.minimaxi.com/docs/api-reference/image-generation-t2i
+- Video: https://platform.minimaxi.com/docs/api-reference/video-generation
+- Music: https://platform.minimaxi.com/docs/api-reference/music-generation
Author	SHA1	Message	Date
opencode-sync	c14f82830f	skills: remove obsolete opencode-config (replaced by opencode-plugins)	2026-10-13 12:40:06 +08:00
opencode-sync	a9b4251158	sync: import skills/, plugins/, memory/ and shared files from origin/main	2026-10-13 12:38:53 +08:00
xiaoshuai	33155181a1	Add AGENTS.md instructions and allow tracking it	2026-10-12 21:13:06 +08:00
xiaoshuai	d03a9f462c	memory: 记下 opencode 配置仓库本身的位置与推送方式新增 facts/opencode-config-oc-repo.md：~/.config/opencode 是独立仓库（oc.git / main / SSH），只跟踪三棵树，改动在项目目录里看不到，必须单独提交。顺带补上 facts 类别的 index.md。 Verified: cd ~/.config/opencode && git status 干净、 git log @{u}..HEAD 为空，push 返回 8dc02b6..2d4df45 之后无新差异。	2026-10-12 18:11:41 +08:00