@justsilver/opencode-team 0.2.1 → 0.2.2-beta.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +10 -1
- package/README.md +52 -62
- package/package.json +6 -1
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,15 @@
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [0.2.2-beta.0] - 2026-11-18
|
|
11
|
+
|
|
12
|
+
### Changed
|
|
13
|
+
|
|
14
|
+
- 旧包 `@justsilver/opencode-subagent-model` 已在 npm 标记 deprecated(覆盖全部已发布版本),
|
|
15
|
+
弃用提示指向 `@justsilver/opencode-team`;旧包保留可安装,不撤包。
|
|
16
|
+
- 修复从 npm 安装后面板无响应:`@opentui/core`、`@opentui/solid`、`solid-js` 改为 optional
|
|
17
|
+
peerDependencies,npm 不再把宿主运行时副本装进插件目录。
|
|
18
|
+
|
|
10
19
|
## [0.2.1] - 2026-11-18
|
|
11
20
|
|
|
12
21
|
### Changed
|
|
@@ -90,7 +99,7 @@
|
|
|
90
99
|
|
|
91
100
|
- 先安装新包并保留旧包加载,打开一次 `/team` 完成旧全局模型导入,再移除旧包并完全重启。
|
|
92
101
|
- 旧包已移除时不再读取其独立存储命名空间;需要在 `/team` 重新选择 Agent 模型。
|
|
93
|
-
- 旧包 `@justsilver/opencode-subagent-model` 的 npm
|
|
102
|
+
- 旧包 `@justsilver/opencode-subagent-model` 的 npm 弃用在新包安装验证后执行,步骤见 [README](README.md#从旧版插件迁移)。
|
|
94
103
|
|
|
95
104
|
## [0.1.2] - 2026-11-11
|
|
96
105
|
|
package/README.md
CHANGED
|
@@ -1,10 +1,19 @@
|
|
|
1
|
-
<!--
|
|
1
|
+
<!-- 职责:使用者的项目介绍、特性、安装、快速开始、日常使用、迁移与疑难解答;不写:Agent 规则、权限与策略实现、开发发版流程、设计契约。 -->
|
|
2
2
|
|
|
3
3
|
# opencode-team
|
|
4
4
|
|
|
5
5
|
给 OpenCode V2 提供零配置的多 Agent 团队:Orchestrator、QA、Reviewer 开箱即用,
|
|
6
6
|
并可按 Agent 单独指定子代理模型与变体。可选择当前目录可用的任意聊天模型,不依赖供应商插件。
|
|
7
7
|
|
|
8
|
+
## 特性
|
|
9
|
+
|
|
10
|
+
- **零配置团队**:安装即获得 Orchestrator 主代理,以及 QA、Reviewer 两个子代理;复用内置
|
|
11
|
+
`general`、`explore`,不需要手写 Agent 文件。
|
|
12
|
+
- **按 Agent 覆盖模型**:只对指定 Agent ID 的子代理生效;没配置的 Agent 继续使用 OpenCode 原生选择。
|
|
13
|
+
- **可视化管理**:`/team` 面板查看角色、模型来源、权限摘要与完整 System Prompt,并在面板内改模型与变体。
|
|
14
|
+
- **随时可逆**:清除团队覆盖后回到 Agent 配置或 OpenCode 原生选择。
|
|
15
|
+
- **失败可见**:模型不可用、存储损坏或读取失败都明确报错,不静默回退。
|
|
16
|
+
|
|
8
17
|
## 安装
|
|
9
18
|
|
|
10
19
|
```bash
|
|
@@ -17,72 +26,52 @@ opencode plugin add @justsilver/opencode-team
|
|
|
17
26
|
也可以从本地源码目录加载:在 `plugins` 里给插件目录的绝对路径,
|
|
18
27
|
例如 `{ "package": "<仓库>/plugin/opencode-team" }`。两种方式同一个插件 ID,不要同时启用。
|
|
19
28
|
|
|
29
|
+
## 快速开始
|
|
30
|
+
|
|
31
|
+
1. 安装并完全退出、重新启动 OpenCode。
|
|
32
|
+
2. 输入 `/` 选择 `/team`,或在命令面板搜索「Agent 团队与模型」。
|
|
33
|
+
3. 用方向键选一个子代理(如 QA),按 `Enter` 打开模型配置。
|
|
34
|
+
4. 选择模型;如果该模型有变体,先按 `Enter` 选思考等级,再按 `Enter` 保存。
|
|
35
|
+
5. 之后 Orchestrator 派发子代理时,被配置的 Agent 会自动使用团队模型。
|
|
36
|
+
|
|
20
37
|
## 团队 Agent
|
|
21
38
|
|
|
22
|
-
|
|
39
|
+
| Agent | 类型 | 职责 |
|
|
40
|
+
|---|---|---|
|
|
41
|
+
| `Orchestrator` | 主代理 | 优先编排,简单任务可直接执行,协调子代理并完成最终交付 |
|
|
42
|
+
| `QA` | 子代理 | 独立设计、编写并执行验收测试;不迎合实现修改验收标准 |
|
|
43
|
+
| `Reviewer` | 子代理 | 默认只审查和报告;必要时做针对性验证,不替代 QA 验收 |
|
|
44
|
+
| `General` | 内置子代理 | 通用多步任务,由 Orchestrator 复用 |
|
|
45
|
+
| `Explore` | 内置子代理 | 代码库探索 |
|
|
23
46
|
|
|
24
|
-
-
|
|
25
|
-
它不会自动变成默认主代理,用 OpenCode 的 Agent 切换选择它,或在配置中设置
|
|
47
|
+
- Orchestrator 不会自动成为默认主代理;用 OpenCode 的 Agent 切换选择它,或设置
|
|
26
48
|
`default_agent: "orchestrator"`。
|
|
27
|
-
-
|
|
28
|
-
|
|
29
|
-
- `Reviewer`(子代理):默认只审查和报告;可做针对性验证但不替代 QA 验收;
|
|
30
|
-
修改生产代码需明确授权。
|
|
31
|
-
- 继续复用内置 `general`、`explore`;不重复实现已有能力,也不修改它们的权限。
|
|
32
|
-
|
|
33
|
-
插件给 QA / Reviewer 注入 `question * deny` 与 `subagent * deny`,让它们成为不向用户提问、也不再派生下级子代理的叶子子代理:
|
|
34
|
-
|
|
35
|
-
- Orchestrator 不追加权限规则。
|
|
36
|
-
- QA / Reviewer 除 `question`、`subagent` 外,其余权限继承 OpenCode 默认与用户配置。
|
|
37
|
-
- General、Explore 保持内置定义,插件不修改。
|
|
38
|
-
- 职责边界由 System Prompt 约束:
|
|
39
|
-
- Orchestrator 优先编排,简单任务可直接执行,协调并发写入与共享文件冲突,
|
|
40
|
-
整合子代理结论并对最终交付负责。
|
|
41
|
-
- QA 独立设计、编写及执行验收测试,不迎合实现修改验收标准;生产代码修复交由实现代理,
|
|
42
|
-
自身修复后不得自验。
|
|
43
|
-
- Reviewer 默认只审查和报告;可做针对性验证但不替代 QA 的独立验收;
|
|
44
|
-
确需直接修复时,明确区分审查结果与后续修改。
|
|
45
|
-
- 这不是权限沙箱;需要硬限制时请在 `opencode.json` 配置对应 Agent 权限。
|
|
46
|
-
- 项目/全局 Agent 配置在插件之后合并,可以收紧或放开权限。
|
|
47
|
-
|
|
48
|
-
详细职责、合并顺序与客观验证要求见[团队 Agent](docs/team-agents.md#system-prompt-职责)。
|
|
49
|
-
|
|
50
|
-
## Agent Team Dashboard
|
|
51
|
-
|
|
52
|
-
在输入框输入 `/`,选择 `/team`,或在命令面板搜索「Agent 团队与模型」。
|
|
53
|
-
|
|
54
|
-
- 左侧列出团队 Agent:Orchestrator、General、Explore、QA、Reviewer,以及自定义子代理;
|
|
55
|
-
每行显示状态(原生 / 继承 / 自定义),自定义模型额外显示当前模型。
|
|
56
|
-
- 右侧显示角色说明、当前模型、权限摘要和只读 System Prompt;提示词直接完整展示。
|
|
57
|
-
- 顶部搜索框常驻并默认聚焦,直接输入即过滤;方向键选择,`Enter` 打开模型配置,
|
|
58
|
-
`Ctrl+R` 清除团队覆盖,`ESC` 返回或关闭。
|
|
59
|
-
- 模型配置在同一视图内按 Provider 分组展示模型,搜索框默认聚焦、直接输入即过滤;
|
|
60
|
-
`←`/`→` 与 `Tab` 区域切换、Variant;有 Variant 时先按 `Enter` 选择思考等级,再按 `Enter`
|
|
61
|
-
保存;保存后停留在配置页,取消不修改已有配置;
|
|
62
|
-
`Ctrl+R` 恢复原生/清除团队覆盖。
|
|
63
|
-
- 保存结果、错误和恢复确认都在当前面板内显示,不再弹出可能被遮挡的宿主 Toast。
|
|
64
|
-
- 窄终端会自动切换为列表/详情或模型/Variant 单栏,低高度使用紧凑行。
|
|
65
|
-
|
|
66
|
-
模型规则:
|
|
67
|
-
|
|
68
|
-
- 设置按 Agent ID 精确匹配;未配置的 Agent 继续使用 OpenCode 原生选择。
|
|
69
|
-
- 主代理(包括 Orchestrator)的模型始终由 OpenCode 会话选择,面板只读展示。
|
|
70
|
-
- 在模型配置中按 `Ctrl+R` 会删除团队覆盖;如果该 Agent 在 `opencode.json` 配置了模型,
|
|
71
|
-
则回到该 Agent 配置。
|
|
72
|
-
- 设置在同一 OpenCode 服务端数据库下全局共享,重启后保留;保存后对后续调用生效。
|
|
73
|
-
- 命中策略时,无论调用方是否显式指定其他模型,启动与续接调用都会被覆盖。
|
|
74
|
-
- 模型不可用或存储读取失败时明确报错,不静默回退。
|
|
75
|
-
- 子代理启动确认末尾附本次模型标记;格式与边界见[策略契约](docs/team-policy.md#主代理知情边界)。
|
|
49
|
+
- QA 与 Reviewer 是叶子子代理:不能向用户提问,也不能再派发下级子代理。
|
|
50
|
+
- 其余权限继承 OpenCode 默认值与你在 `opencode.json` 中的配置;要加硬限制请配置对应 Agent 权限。
|
|
76
51
|
|
|
77
|
-
|
|
52
|
+
角色职责与提示词边界见[团队 Agent](docs/team-agents.md)。
|
|
78
53
|
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
-
|
|
82
|
-
|
|
54
|
+
## 团队面板
|
|
55
|
+
|
|
56
|
+
- 左侧列出团队 Agent 与自定义子代理,每行显示状态:原生、继承或自定义;自定义额外显示当前模型。
|
|
57
|
+
- 右侧显示角色说明、当前模型、权限摘要与只读 System Prompt;提示词完整展示,不提供编辑。
|
|
58
|
+
- 搜索框常驻并默认聚焦,直接输入即过滤;方向键选择,`Enter` 打开模型配置,`Ctrl+R` 清除团队覆盖,
|
|
59
|
+
`ESC` 返回或关闭。
|
|
60
|
+
- 模型配置按 Provider 分组:`←`/`→` 与 `Tab` 切换区域和变体,`Enter` 选择并保存,
|
|
61
|
+
`Ctrl+R` 恢复原生;保存结果与错误都显示在当前面板内。
|
|
62
|
+
- 窄终端自动切换为列表/详情或模型/Variant 单栏。
|
|
63
|
+
|
|
64
|
+
使用规则:
|
|
65
|
+
|
|
66
|
+
- 设置按 Agent ID 精确匹配,在同一 OpenCode 服务端数据库下全局共享,重启后保留。
|
|
67
|
+
- 主代理(包括 Orchestrator)的模型始终由 OpenCode 会话选择,面板只读展示。
|
|
68
|
+
- 清除团队覆盖后,如果该 Agent 在 `opencode.json` 配了模型,会回到该配置。
|
|
69
|
+
- 子代理启动确认末尾会附本次生效的模型标记,便于确认策略是否生效。
|
|
83
70
|
|
|
84
71
|
当前版本不提供 Agent 创建、删除、重命名或 Prompt 编辑。
|
|
85
72
|
|
|
73
|
+
界面细节与键盘契约见 [TUI Dashboard](docs/team-tui.md)。
|
|
74
|
+
|
|
86
75
|
## 从旧版插件迁移
|
|
87
76
|
|
|
88
77
|
旧包为 `@justsilver/opencode-subagent-model`,使用独立的存储命名空间与全局模型策略。
|
|
@@ -98,8 +87,8 @@ System Prompt 与权限:
|
|
|
98
87
|
如果先移除了旧包再启动新插件,旧值仍在旧命名空间中,但官方插件 API 无法跨命名空间读取;
|
|
99
88
|
本插件不会直接访问数据库。此时直接在 `/team` 重新选择即可。
|
|
100
89
|
|
|
101
|
-
旧 npm
|
|
102
|
-
|
|
90
|
+
旧 npm 包已在 registry 标记 deprecated:`@justsilver/opencode-subagent-model` 的全部版本安装时
|
|
91
|
+
都会提示迁移到 `@justsilver/opencode-team`。旧包保留可安装、不撤包,已经锁定旧版本的项目仍可重装。
|
|
103
92
|
|
|
104
93
|
## 疑难解答
|
|
105
94
|
|
|
@@ -111,6 +100,7 @@ System Prompt 与权限:
|
|
|
111
100
|
| 提示功能不可用 | 当前宿主缺少工具钩子,或钩子注册失败;不会假装保存成功 |
|
|
112
101
|
| 当前模型不可用 | 切到可用模型或恢复原生选择;不会静默换成其他模型 |
|
|
113
102
|
| 命令重复或覆盖冲突 | 检查是否同时启用了旧包、本地目录和 npm 两份 |
|
|
103
|
+
| 面板能打开但按键、搜索、点击都不生效 | 插件目录被装进了自带的 `solid-js` / `@opentui/*` 副本,与宿主运行时冲突;升级到修复后的版本即可,不要手动补装这些依赖 |
|
|
114
104
|
|
|
115
|
-
开发与发布见 [CONTRIBUTING.md](CONTRIBUTING.md)
|
|
116
|
-
[团队 Agent](docs/team-agents.md)。
|
|
105
|
+
开发与发布见 [CONTRIBUTING.md](CONTRIBUTING.md),Agent 协作规范见 [AGENTS.md](AGENTS.md),
|
|
106
|
+
设计契约见[策略](docs/team-policy.md)与[团队 Agent](docs/team-agents.md)。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@justsilver/opencode-team",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.2-beta.0",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "Zero-config multi-agent team for OpenCode V2: Orchestrator, QA, Reviewer, and per-agent subagent model/variant policy",
|
|
6
6
|
"license": "MIT",
|
|
@@ -38,6 +38,11 @@
|
|
|
38
38
|
"@opentui/solid": ">=0.8.4",
|
|
39
39
|
"solid-js": ">=1.9.12"
|
|
40
40
|
},
|
|
41
|
+
"peerDependenciesMeta": {
|
|
42
|
+
"@opentui/core": { "optional": true },
|
|
43
|
+
"@opentui/solid": { "optional": true },
|
|
44
|
+
"solid-js": { "optional": true }
|
|
45
|
+
},
|
|
41
46
|
"devDependencies": {
|
|
42
47
|
"@opencode/client": "^2.3.0",
|
|
43
48
|
"@opencode/plugin": "^2.3.0",
|