OpenCode 中文教程

English

简体中文

English

简体中文

Appearance

v1.1.48: Skills Invokable as Slash Commands ​

Release Date: January 31, 2026

One-Line Summary ​

This update allows Skills to be directly invoked as slash commands and supports custom model configuration file paths, greatly improving flexibility.

New Feature: Skills as Slash Commands ​

What was updated? ​

Now you can directly invoke Skills through slash commands in TUI without manually entering "load skill xxx".

What are Skills? ​

Skills is OpenCode's skill system that allows AI to gain domain-specific knowledge and workflows, such as code auditing, translation, documentation generation, etc.

How to use? ​

Type / in TUI to see all available Skills. Select a Skill to invoke it directly.

Examples:

/zhiliang    # Invoke code quality audit Skill
/anquan      # Invoke security audit Skill
/fanyi       # Invoke translation Skill

👉 Related Tutorial: Skill Basics

New Feature: Custom Model Configuration File Path ​

What was updated? ​

Now you can specify a custom model configuration file path through the OPENCODE_MODELS_PATH environment variable.

What's it for? ​

  • Teams can share unified model configuration
  • Convenient to use different model configurations in different environments
  • Supports version control for model configuration

How to use? ​

bash
# Set custom model configuration path
export OPENCODE_MODELS_PATH=/path/to/your/models.json

# Start OpenCode
opencode

New Feature: Copilot Reasoning Token Support ​

What was updated? ​

Added a dedicated Provider for Copilot that can properly handle Copilot's reasoning tokens.

What are the benefits? ​

  • Copilot users can more accurately track token usage
  • Reasoning token statistics are more precise

Previous Situation ​

grep and ripgrep operations would follow symbolic links by default, potentially including unexpected files in search results.

Current Status ​

By default, symbolic links are no longer followed, making search results more predictable. If you need to follow symbolic links, you can specify manually.

Bug Fixes ​

OpenAI Compatible API thinking Parameter ​

Fixed the format issue with the thinking parameter when using OpenAI-compatible API, now using snake_case (thinking) instead of camelCase.

Bash Permission Handling ​

Fixed handling of redirect statements in bash permission checks.

Devstral Model Ordering ​

Ensured Mistral ordering fixes also apply to Devstral model.

Should You Upgrade? ​

SituationRecommendation
Want to invoke Skills via slash commands✅ Highly recommended
Using Copilot✅ Recommended upgrade
Need custom model configuration✅ Recommended upgrade
Everything working fineCan wait for next time

Upgrade command:

bash
opencode upgrade

Technical Details (Skippable) ​

Click to expand full update list

Core ​

  • Sync changes
  • Allow specifying custom models file path via OPENCODE_MODELS_PATH environment variable
  • Ensure models configuration is not empty before loading
  • Make skills invokable as slash commands in the TUI
  • Don't follow symbolic links by default in grep and ripgrep operations
  • Prevent parallel test runs from contaminating environment variables
  • Ensure Mistral ordering fixes also apply to Devstral
  • Add Copilot-specific provider to properly handle reasoning tokens (@SteffenDE)
  • Respect OPENCODE_MODELS_URL environment variable in build process (@bbartels)
  • Use snake_case for thinking parameter with OpenAI-compatible APIs (@Chesars)
  • Bump AI SDK packages
  • Ensure ask question tool isn't included when using acp
  • Handle redirected statement treesitter node in bash permissions (@pschiel)
  • Remove special case handling for Google Vertex Anthropic provider in response generation (@MichaelYochpaz)
  • Exclude chat models from textVerbosity setting

Desktop ​

  • Revert transitions, spacing, scroll fade, and prompt area updates
  • Add session actions tests (@neriousy)
  • Refactored tests and added project tests (@neriousy)

Thank you to 7 community contributors:

@neriousy:

  • refactor(app): refactored tests + added project tests (#11349)
  • test(app): session actions (#11386)

@MichaelYochpaz:

  • refactor(provider): remove google-vertex-anthropic special case in ge… (#10743)

@pschiel:

  • fix: handle redirected_statement treesitter node in bash permissions (#6737)

@IdrisGit:

  • docs: update agents options section to include color and top_p options (#11355)

@Chesars:

  • fix(provider): use snake_case for thinking param with OpenAI-compatible APIs (#10109)

@bbartels:

  • feat(build): respect OPENCODE_MODELS_URL env var (#11384)

@SteffenDE:

  • feat(opencode): add copilot specific provider to properly handle copilot reasoning tokens (#8900)

← Back to Changelog