mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-17 21:08:05 +00:00
docs(i18n): add English translations for 8 missing documents
Translated files: - AI Swarm Collaboration (overview + detailed technical doc) - Lessons Learned the Hard Way - OpenCode CLI Configuration - Four Phases x Twelve Principles Methodology - Canvas Whiteboard-Driven Development - Polymarket Link Format Specification - Polymarket Arbitrage Complete Guide Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
This commit is contained in:
tukuaiai
co-authored by
factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
parent
59821fffa1
commit
fab5041494
@@ -0,0 +1,187 @@
|
||||
# OpenCode CLI Configuration
|
||||
|
||||
> Free AI programming assistant, supporting 75+ models, no credit card required
|
||||
|
||||
OpenCode is an open-source AI programming agent that supports terminal, desktop applications, and IDE extensions. Free models can be used without an account.
|
||||
|
||||
Official website: [opencode.ai](https://opencode.ai/)
|
||||
|
||||
---
|
||||
|
||||
## Installation
|
||||
|
||||
```bash
|
||||
# One-click installation (recommended)
|
||||
curl -fsSL https://opencode.ai/install | bash
|
||||
|
||||
# Or use npm
|
||||
npm install -g opencode-ai
|
||||
|
||||
# Or use Homebrew (macOS/Linux)
|
||||
brew install anomalyco/tap/opencode
|
||||
|
||||
# Windows - Scoop
|
||||
scoop bucket add extras && scoop install extras/opencode
|
||||
|
||||
# Windows - Chocolatey
|
||||
choco install opencode
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Free Model Configuration
|
||||
|
||||
OpenCode supports multiple free model providers that can be used without payment.
|
||||
|
||||
### Option 1: Z.AI (Recommended, GLM-4.7)
|
||||
|
||||
1. Visit [Z.AI API Console](https://z.ai/manage-apikey/apikey-list) to register and create an API Key
|
||||
2. Run the `/connect` command, search for **Z.AI**
|
||||
3. Enter your API Key
|
||||
4. Run `/models` and select **GLM-4.7**
|
||||
|
||||
```bash
|
||||
opencode
|
||||
# After entering, type
|
||||
/connect
|
||||
# Select Z.AI, enter API Key
|
||||
/models
|
||||
# Select GLM-4.7
|
||||
```
|
||||
|
||||
### Option 2: MiniMax (M2.1)
|
||||
|
||||
1. Visit [MiniMax API Console](https://platform.minimax.io/login) to register and create an API Key
|
||||
2. Run `/connect`, search for **MiniMax**
|
||||
3. Enter your API Key
|
||||
4. Run `/models` and select **M2.1**
|
||||
|
||||
### Option 3: Hugging Face (Multiple Free Models)
|
||||
|
||||
1. Visit [Hugging Face Settings](https://huggingface.co/settings/tokens/new?ownUserPermissions=inference.serverless.write&tokenType=fineGrained) to create a Token
|
||||
2. Run `/connect`, search for **Hugging Face**
|
||||
3. Enter your Token
|
||||
4. Run `/models` and select **Kimi-K2-Instruct** or **GLM-4.6**
|
||||
|
||||
### Option 4: Local Models (Ollama)
|
||||
|
||||
```bash
|
||||
# Install Ollama
|
||||
curl -fsSL https://ollama.com/install.sh | sh
|
||||
|
||||
# Pull a model
|
||||
ollama pull llama2
|
||||
```
|
||||
|
||||
Configure in `opencode.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"$schema": "https://opencode.ai/config.json",
|
||||
"provider": {
|
||||
"ollama": {
|
||||
"npm": "@ai-sdk/openai-compatible",
|
||||
"name": "Ollama (local)",
|
||||
"options": {
|
||||
"baseURL": "http://localhost:11434/v1"
|
||||
},
|
||||
"models": {
|
||||
"llama2": {
|
||||
"name": "Llama 2"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Core Commands
|
||||
|
||||
| Command | Function |
|
||||
|:---|:---|
|
||||
| `/models` | Switch models |
|
||||
| `/connect` | Add API Key |
|
||||
| `/init` | Initialize project (generate AGENTS.md) |
|
||||
| `/undo` | Undo last modification |
|
||||
| `/redo` | Redo |
|
||||
| `/share` | Share conversation link |
|
||||
| `Tab` | Toggle Plan mode (plan only, no execution) |
|
||||
|
||||
---
|
||||
|
||||
## Let AI Handle All Configuration Tasks
|
||||
|
||||
The core philosophy of OpenCode: **Delegate all configuration tasks to AI**.
|
||||
|
||||
### Example: Install MCP Server
|
||||
|
||||
```
|
||||
Help me install the filesystem MCP server and configure it for opencode
|
||||
```
|
||||
|
||||
### Example: Deploy GitHub Open Source Project
|
||||
|
||||
```
|
||||
Clone the https://github.com/xxx/yyy project, read the README, and help me complete all dependency installation and environment configuration
|
||||
```
|
||||
|
||||
### Example: Configure Skills
|
||||
|
||||
```
|
||||
Read the project structure and create an appropriate AGENTS.md rules file for this project
|
||||
```
|
||||
|
||||
### Example: Configure Environment Variables
|
||||
|
||||
```
|
||||
Check what environment variables the project needs, help me create a .env file template and explain the purpose of each variable
|
||||
```
|
||||
|
||||
### Example: Install Dependencies
|
||||
|
||||
```
|
||||
Analyze package.json / requirements.txt, install all dependencies, and resolve version conflicts
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Recommended Workflow
|
||||
|
||||
1. **Enter project directory**
|
||||
```bash
|
||||
cd /path/to/project
|
||||
opencode
|
||||
```
|
||||
|
||||
2. **Initialize project**
|
||||
```
|
||||
/init
|
||||
```
|
||||
|
||||
3. **Switch to free model**
|
||||
```
|
||||
/models
|
||||
# Select GLM-4.7 or MiniMax M2.1
|
||||
```
|
||||
|
||||
4. **Start working**
|
||||
- First use `Tab` to switch to Plan mode, let AI plan
|
||||
- Confirm the plan before letting AI execute
|
||||
|
||||
---
|
||||
|
||||
## Configuration File Locations
|
||||
|
||||
- Global config: `~/.config/opencode/opencode.json`
|
||||
- Project config: `./opencode.json` (project root)
|
||||
- Auth info: `~/.local/share/opencode/auth.json`
|
||||
|
||||
---
|
||||
|
||||
## Related Resources
|
||||
|
||||
- [OpenCode Official Documentation](https://opencode.ai/docs/)
|
||||
- [GitHub Repository](https://github.com/opencode-ai/opencode)
|
||||
- [Models.dev - Model Directory](https://models.dev)
|
||||
Reference in New Issue
Block a user