实验性功能汇总

OpenCode 的实验性功能正在积极开发中，可能随时变更。本页汇总所有可用的实验性功能及其启用方式。

---

什么是实验性功能？

实验性功能是 OpenCode 团队正在开发的新特性，在正式发布前供用户提前体验和反馈。

特点：

• 功能可能不完善
• API 可能随时变更
• 部分功能需要额外依赖

启用原则：

• 按需启用，不需要全开
• 遇到问题可以先关闭
• 关注更新日志了解变化

---

快速启用

方式一：一键启用全部

# macOS / Linux：添加到 ~/.zshrc 或 ~/.bashrc
export OPENCODE_EXPERIMENTAL=true

# 然后重新加载
source ~/.zshrc

方式二：按需启用单个功能

# 只启用你需要的功能
export OPENCODE_EXPERIMENTAL_LSP_TOOL=true
export OPENCODE_EXPERIMENTAL_PLAN_MODE=true

---

实验性功能列表

🌐 网络搜索

变量	说明	相关教程
OPENCODE_ENABLE_EXA	启用 websearch 工具，让 AI 能搜索互联网	5.23 网络搜索与获取

启用方式：

export OPENCODE_ENABLE_EXA=true

使用场景：

• 查询最新的技术文档和 API 用法
• 搜索错误信息的解决方案
• 了解库的最新版本特性

Zen 用户

如果你使用 OpenCode Zen 托管模型，websearch 已经自动启用，无需配置。

---

🔧 LSP 增强

变量	说明	相关教程
OPENCODE_EXPERIMENTAL_LSP_TOOL	启用 LSP 工具（跳转定义、查找引用等）	5.19 LSP 代码智能
OPENCODE_EXPERIMENTAL_LSP_TY	启用实验性 ty Python 服务器（替代 pyright）	5.19 LSP 代码智能

启用方式：

export OPENCODE_EXPERIMENTAL_LSP_TOOL=true
export OPENCODE_EXPERIMENTAL_LSP_TY=true

使用场景：

• 让 AI 能执行「跳转到定义」「查找所有引用」等 LSP 操作
• Python 项目使用更快的类型检查器

---

📋 工作流增强

变量	说明	相关教程
OPENCODE_EXPERIMENTAL_PLAN_MODE	启用计划模式（plan/build 分离）	3.1 规划与构建

启用方式：

export OPENCODE_EXPERIMENTAL_PLAN_MODE=true

使用场景：

• 大型重构任务：先让 AI 调研并生成计划，审核后再执行
• 不确定最佳方案：先规划多套方案，选择后再动手
• 需要人工审核：计划文件可以保存、分享、迭代

新增工具：

• plan_enter：切换到计划模式
• plan_exit：计划完成，询问是否切换到构建模式

---

🎨 界面与交互

变量	说明
OPENCODE_EXPERIMENTAL_ICON_DISCOVERY	自动发现项目图标（显示在界面）
OPENCODE_EXPERIMENTAL_MARKDOWN	启用实验性 Markdown 渲染组件
OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT	禁用 TUI 中选中文本自动复制

启用方式：

export OPENCODE_EXPERIMENTAL_ICON_DISCOVERY=true
export OPENCODE_EXPERIMENTAL_MARKDOWN=true

---

⚡ 性能与格式化

变量	说明	相关教程
OPENCODE_EXPERIMENTAL_OXFMT	启用 oxfmt 格式化器（Rust 编写，高性能）	5.18 代码格式化器
OPENCODE_EXPERIMENTAL_FILEWATCHER	为整个目录启用文件监视器
OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER	禁用文件监视器

启用方式：

export OPENCODE_EXPERIMENTAL_OXFMT=true

使用 oxfmt 的前置条件：

• 项目 package.json 中有 oxfmt 依赖
• 启用实验性标志

---

⏱️ 超时与限制

变量	类型	说明
OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS	number	Bash 命令默认超时（毫秒）
OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX	number	LLM 响应最大输出 token 数

示例：

# 设置 bash 超时为 2 分钟
export OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS=120000

# 限制 LLM 输出最多 8192 token
export OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX=8192

---

opencode.json 中的 experimental 配置

除了环境变量，opencode.json 中也有 experimental 字段，用于配置另一类实验性功能：

{
  "experimental": {
    "batch_tool": true,           // 启用批量操作工具
    "openTelemetry": true,        // 启用 OpenTelemetry 链路追踪
    "disable_paste_summary": true, // 禁用粘贴大段文本自动摘要
    "continue_loop_on_deny": true, // 工具被拒绝时继续思考
    "primary_tools": ["tool1"],   // 仅限 Primary Agent 使用的工具
    "mcp_timeout": 30000          // MCP 请求超时（毫秒）
  }
}

字段	说明
batch_tool	启用批量工具，一次执行多个操作
openTelemetry	启用 OpenTelemetry，用于性能监控和链路追踪
disable_paste_summary	粘贴大段文本时不自动生成摘要
continue_loop_on_deny	当用户拒绝工具调用时，Agent 继续思考而不是中断
primary_tools	指定仅限 Primary Agent 使用的工具列表
mcp_timeout	MCP 请求的全局超时时间（毫秒）

---

完整配置示例

以下是一个「全功能」实验性配置示例，你可以按需复制：

# ═══════════════════════════════════════════════════════════════
# OpenCode 实验性功能配置
# 添加到 ~/.zshrc 或 ~/.bashrc，然后 source 一下
# ═══════════════════════════════════════════════════════════════

# 一键启用所有实验性功能（下面这些单独开关会自动被包含）
# export OPENCODE_EXPERIMENTAL=true

# ───────────────────────────────────────────────────────────────
# 网络搜索（需要 Exa API，或使用 Zen 托管模型自动启用）
# ───────────────────────────────────────────────────────────────
export OPENCODE_ENABLE_EXA=true           # 启用 websearch 工具

# ───────────────────────────────────────────────────────────────
# LSP（语言服务器协议）增强
# ───────────────────────────────────────────────────────────────
export OPENCODE_EXPERIMENTAL_LSP_TOOL=true  # 启用 LSP 工具
export OPENCODE_EXPERIMENTAL_LSP_TY=true    # 启用实验性 ty Python 服务器

# ───────────────────────────────────────────────────────────────
# 界面与交互
# ───────────────────────────────────────────────────────────────
export OPENCODE_EXPERIMENTAL_MARKDOWN=true         # 实验性 Markdown 渲染
export OPENCODE_EXPERIMENTAL_ICON_DISCOVERY=true   # 自动发现项目图标

# ───────────────────────────────────────────────────────────────
# 工作流增强
# ───────────────────────────────────────────────────────────────
export OPENCODE_EXPERIMENTAL_PLAN_MODE=true  # 启用计划模式

# ───────────────────────────────────────────────────────────────
# 性能与格式化
# ───────────────────────────────────────────────────────────────
export OPENCODE_EXPERIMENTAL_OXFMT=true      # 启用 oxfmt 格式化器

# ───────────────────────────────────────────────────────────────
# 超时与限制（可选）
# ───────────────────────────────────────────────────────────────
# export OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS=120000
# export OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX=8192

---

常见问题

启用后没有效果？

1. 确认已重新加载配置：

   source ~/.zshrc  # 或 source ~/.bashrc

2. 确认已重启 OpenCode：环境变量在进程启动时读取

3. 确认变量已设置：

   env | grep OPENCODE

功能不稳定？

实验性功能可能存在问题：

• 查看 更新日志 了解最新变化
• 遇到问题可以先关闭对应的功能
• 在 GitHub Issues 反馈

如何关闭某个功能？

移除或注释掉对应的环境变量即可：

# export OPENCODE_EXPERIMENTAL_PLAN_MODE=true  # 注释掉就关闭了

---

相关资源

• CLI 环境变量参考 - 所有环境变量的完整列表
• 配置选项参考 - opencode.json 配置详解
• 更新日志 - 了解功能变化