跳转到内容

功能

功能

这些功能会让你觉得它们早该存在。一旦用过,就回不去了。

Ralph Loop / /ulw-loop

自引用循环。不完成不停止。

Ralph Loop 是 ultrawork 背后的引擎。激活时:

  1. 代理执行一个任务周期
  2. 检查是否真正全部完成
  3. 如果没有,循环回去继续
  4. 重复直到每个子任务都被验证完成

这就是 ultrawork 不会半途而废的原因。循环强制完成。

激活方式:

  • ultraworkulw — 自动 Ralph Loop
  • /ulw-loop — 显式循环激活

Todo Enforcer

代理空闲了?系统把它拉回来。

Todo Enforcer 监控任务进度。当代理完成一个子任务且没有排队的任务时,它不会停下来 — 系统会拉取下一个待办事项并强制代理继续。

你的任务必定完成,毫无疑问。

Comment Checker

注释中没有 AI 水话。代码读起来像资深工程师写的。

Comment Checker 拒绝低质量的 AI 生成注释:

  • 明显重复代码的注释(// increment i by 1 对应 i++
  • 不提供任何信息的样板 JSDoc
  • 可以适用于任何函数的通用文档字符串

/init-deep

在整个项目中自动生成分层的 AGENTS.md 文件:

project/
├── AGENTS.md              ← 项目级上下文
├── src/
│   ├── AGENTS.md          ← src 专用上下文
│   └── components/
│       └── AGENTS.md      ← 组件专用上下文

代理自动读取相关上下文。零手动管理。对 token 效率和代理性能都很有帮助。

运行:

/init-deep

会话工具

列出、读取、搜索和分析会话历史:

操作功能
列出显示所有会话及其元数据
读取加载之前会话的完整上下文
搜索跨会话记录搜索
分析从过去的工作中提取模式和洞察

会话恢复

从以下情况自动恢复:

  • 会话错误和崩溃
  • 上下文窗口限制(自动截断和恢复)
  • API 故障(自动重试并退避)

你的工作在 interruption 后仍然存活。系统从停下的地方继续。

Think 模式

增强的推理能力。启用后,代理在响应前花费更多计算资源进行规划与分析。

适用于:

  • 复杂的架构决策
  • 多步骤调试
  • 需要深度分析的任务

文件提示词

在代理配置中使用 file:// 语法从文件加载提示词:

{
  "agents": {
    "oracle": {
      "prompt_append": "file://.opencode/prompts/oracle-custom.md"
    }
  }
}

这让你可以将代理指令作为版本控制的文件管理,而不是内联 JSON 字符串。

Doctor 命令

内置诊断:

bunx oh-my-opencode doctor

检查:

  • opencode.json 中的插件注册
  • 配置文件有效性
  • 模型可用性和 API 密钥访问
  • 环境和依赖状态

出问题时先运行这个。

模型回退

配置回退模型,当服务提供商宕机时任务不会失败:

{
  "fallback_models": {
    "default": ["claude-opus-4-6", "kimi-k2.5"],
    "hephaestus": [
      "gpt-5.4",
      { "model": "claude-opus-4-6", "reasoning_effort": "high" }
    ]
  }
}

支持在同一数组中混合纯模型字符串和逐回退配置对象。

模型设置

代理-模型匹配已内置到安装过程中。每个代理默认使用最适合其角色的模型:

代理默认模型原因
Sisyphusclaude-opus-4-6 / kimi-k2.5 / glm-5强大的编排和规划能力
Hephaestusgpt-5.4深度自主推理
Prometheusclaude-opus-4-6 / kimi-k2.5 / glm-5访谈和规划
专家因类别而异基于类别的路由

详见 安装指南 了解模型设置详情。

后续步骤

  • 代理系统 — 代理如何使用这些功能
  • 工具 — 驱动代理的开发者工具
  • 配置 — 配置回退、hooks 等