滚熊博客

🎯 OpenCode插件系列: workspace

·IDE

类型：Bundled Multi-Agent Harness（插件集成包）

1. 这是什么扩展？

opencode-workspace 是一个完整的集成包，包含16个组件，共同构成了一个完整的AI开发编排系统。

想象一下，它就像一个"打包套餐"——只需安装一次，你就能得到：

  • 🔌 6 个插件
  • 🧠 3 个 MCP 服务器
  • 🤖 4 个智能体（agents）
  • 🎨 4 个技能（skills）
  • 💬 1 个命令
  • ⚙️ 权限边界 和 智能体沙箱

这是 oh-my-opencode 的替代品，但采用不同的哲学：

  • OmO → 专注于多模型编排
  • Workspace → 专注于与 OpenCode Free Models 的结构化角色分工

2. 在什么情况下使用？

在以下情况下使用：

  • ✅ 完整的现成系统，无需单独安装每个插件
  • ✅ 支持 OpenCode Free Models（默认配置）
  • ✅ 有组织的架构，包含编排器（plan、build）和专家
  • ✅ 默认的权限设置（安全优先）
  • ✅ 现成的 MCPs：Context7（文档）、Exa（搜索）、GitHub Grep
  • ✅ OCX 集成——他们的包管理器，便于更新
  • ✅ 可自定义的配置文件——可以修改和创建自己的配置

完整组件列表：

类别 组件 功能
插件 `workspace-plugin` 管理计划 + 智能体规则注入
插件 `background-agents` 异步委托系统
插件 `notify` 完成时的操作系统通知
插件 `worktree` Git worktree 隔离
插件 `@tarquinen/opencode-dcp` 差分上下文修剪
插件 `@franlol/opencode-md-table-formatter` Markdown 表格格式化
技能 `plan-protocol` 实现规划指南
技能 `code-review` 代码审查方法论
技能 `code-philosophy` 内部逻辑哲学（五定律）
技能 `frontend-philosophy` 视觉/UI 哲学（五支柱）
智能体 `researcher` 外部研究（只读 + MCP）
智能体 `coder` 实现（完整文件 + bash）
智能体 `scribe` 文档编写（仅写入）
智能体 `reviewer` 代码审查（只读 + git）
命令 `review` `/review` 斜杠命令
MCP `context7` 库文档搜索
MCP `exa` 网络搜索用于研究
MCP `gh_grep` GitHub 代码搜索

架构：

┌─────────────────────────────────────────────────┐
│              编排器                          │
│         ┌─────┐         ┌─────┐                │
│         │plan │         │build│                │
│         └──┬──┘         └──┬──┘                │
└────────────┼───────────────┼────────────────────┘
             │               │
     ┌───────┴───────┐   ┌───┴───┐
     ▼       ▼       ▼   ▼      ▼      ▼
┌───────┐ ┌────────┐ ┌─────┐ ┌─────┐ ┌──────┐
│explore│ │research│ │coder│ │scribe│ │review│
└───────┘ └────────┘ └─────┘ └─────┘ └──────┘
                  专家

3. 如何使用？

第1步：安装 OCX

OCX 是他们的包管理器。如果没有安装：

# 从 OCX 仓库
# [<https://github.com/kdcokenny/ocx>](<https://github.com/kdcokenny/ocx>)

第2步：安装 Workspace

# 一次性设置
ocx init --global
# 安装 KDCO workspace 配置（仅限 OpenCode Free Models）
ocx profile add ws --source tweak/p-1vp4xoqv --from [<https://tweakoc.com/r>](<https://tweakoc.com/r>) --global
# 启动
ocx oc -p ws

替代方法（直接安装，无需配置）：

ocx add kdco/workspace --from [<https://registry.kdco.dev>](<https://registry.kdco.dev>)

自定义配置：

你可以在 TweakOC 中打开 harness 进行自定义：

https://tweakoc.com/h/kdco-workspace

默认权限：

范围 设置
Global `webfetch: deny` — 没有直接的网络获取
`plan` 只读编排器，通过 `task` 委托
`build` 只读编排器，通过 `task` 委托
`explore` 只读专家，仅限文件系统和 git
`researcher` 只读，仅限 MCP 工具
`coder` 完整文件 + bash 访问权限
`scribe` 仅文件写入，**没有 bash**
`reviewer` 只读 + git 检查

日常使用

# 使用 workspace 配置启动 OpenCode
ocx oc -p ws
# 在 OpenCode 中使用常规命令
# /review - 用于代码审查
# 编排器（plan、build）会自动使用专家

4. 什么时候使用？

在以下情况使用：

  • ✅ 想要完整的解决方案，无需单独安装每个插件
  • ✅ 偏好OpenCode Free Models（Gemini Free）
  • ✅ 需要有组织的架构，角色清晰（计划者、编码者、审查者）
  • ✅ 在多个项目上工作，需要精确的权限控制
  • ✅ 关心安全性（权限默认设置经过仔细检查）
  • ✅ 想要现成的 MCPs（Context7、Exa、GitHub Grep）
  • ✅ 喜欢OCX 配置文件系统，便于在不同环境间切换

不要在以下情况使用：

  • ❌ 不想依赖 OCX 包管理器
  • ❌ 想要细粒度控制每个单独的插件
  • ❌ 已经使用 oh-my-opencode（智能体重叠）
  • ❌ 使用付费模型，不需要免费配置

⚠️ 重要注意事项

Workspace 与 Oh My OpenCode 对比：

方面 OmO Workspace
哲学 多模型编排 基于角色的结构化
模型 Claude/Kimi/GPT/Gemini OpenCode Free Models
智能体 Sisyphus、Hephaestus 等 plan、build、coder、scribe
包管理器 npm OCX
权限 灵活 默认严格

仓库结构：

拥有自己的代码：

bundle 中的每个文件都与 repo 同步。你可以：

  • Fork 该 repo
  • 修改智能体
  • 调整技能
  • 为你的工作环境自定义

免责声明：

这个项目不是来自 OpenCode 团队的官方项目，与 SST OpenCode 没有任何关联。

许可证：MIT

🔗 有用链接