@justsilver/opencode-team 0.2.0 → 0.2.1
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 +129 -126
- package/LICENSE +20 -20
- package/README.md +116 -116
- package/package.json +1 -1
- package/plugin/opencode-team/team-agents.ts +7 -4
- package/plugin/opencode-team/view/dashboard.tsx +889 -889
- package/plugin/opencode-team/view/model.ts +501 -501
package/CHANGELOG.md
CHANGED
|
@@ -1,126 +1,129 @@
|
|
|
1
|
-
<!-- 职责:用户可见版本变更历史;不写:完整实现、安装与发版流程。 -->
|
|
2
|
-
|
|
3
|
-
# Changelog
|
|
4
|
-
|
|
5
|
-
格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/),
|
|
6
|
-
版本号遵循[语义化版本](https://semver.org/lang/zh-CN/)。
|
|
7
|
-
|
|
8
|
-
## [Unreleased]
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
-
|
|
24
|
-
|
|
25
|
-
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
-
|
|
34
|
-
|
|
35
|
-
-
|
|
36
|
-
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
-
|
|
47
|
-
|
|
48
|
-
-
|
|
49
|
-
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
-
|
|
75
|
-
-
|
|
76
|
-
|
|
77
|
-
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
1
|
+
<!-- 职责:用户可见版本变更历史;不写:完整实现、安装与发版流程。 -->
|
|
2
|
+
|
|
3
|
+
# Changelog
|
|
4
|
+
|
|
5
|
+
格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/),
|
|
6
|
+
版本号遵循[语义化版本](https://semver.org/lang/zh-CN/)。
|
|
7
|
+
|
|
8
|
+
## [Unreleased]
|
|
9
|
+
|
|
10
|
+
## [0.2.1] - 2026-11-18
|
|
11
|
+
|
|
12
|
+
### Changed
|
|
13
|
+
|
|
14
|
+
- `/team` 从两级选择菜单升级为 Agent Team Dashboard:左侧 Agent 列表、右侧详情面板、
|
|
15
|
+
底部快捷键栏,统一展示 Orchestrator 与所有可见子代理。
|
|
16
|
+
- 详情展示角色说明、模型来源、Variant、权限摘要与只读 System Prompt,提示词直接完整显示。
|
|
17
|
+
- Dashboard 搜索框改为常驻、默认聚焦,直接输入即过滤;移除 `/`、`Ctrl+F` 搜索模式与顶部/底部
|
|
18
|
+
搜索提示,单字母快捷键不再触发命令,恢复原生改为 `Ctrl+R`。
|
|
19
|
+
- 模型配置改为 Dashboard 内的自定义 JSX 视图:按 Provider 分组展示模型,支持直接输入搜索、
|
|
20
|
+
`←`/`→` 与 `Tab` 区域切换、动态 Variant;有 Variant 时先选思考等级再按 `Enter` 保存,
|
|
21
|
+
保存后停留在配置页。
|
|
22
|
+
- 模型目录加载失败或为空时,打开模型配置前会重新同步一次;保存仍由服务端校验。
|
|
23
|
+
- 模型与变体保存继续复用 `setAgentModel` RPC、存储与错误处理;清除团队覆盖后回到 Agent 配置
|
|
24
|
+
或 OpenCode 原生选择。
|
|
25
|
+
- 精简 Dashboard 左侧重复角色信息,详情区优先展示当前模型与来源。
|
|
26
|
+
- 面板明确区分原生、继承、自定义模型状态;主代理模型仍只读展示,不写团队覆盖。
|
|
27
|
+
- QA / Reviewer 增加 `subagent * deny`,成为不再派生下级子代理的叶子子代理;`question` 拒绝保持不变。
|
|
28
|
+
- 统一 Dashboard 与模型配置的配色:只使用宿主主题 token;所有可选列表统一为抬升表面 +
|
|
29
|
+
强调色左指示条的选中样式,不再使用整行主操作色填充;状态色按原生/继承、自定义、拒绝、
|
|
30
|
+
询问、允许固定语义。
|
|
31
|
+
- 强化模型配置的 Provider 分组:主题强调色标题、过滤后模型数量、组间低对比度分隔线与缩进层级,
|
|
32
|
+
搜索时保留分组结构并隐藏空分组。
|
|
33
|
+
- 精简 Dashboard 列表与权限区:仅自定义模型显示第二行模型信息,允许规则改为中性色,
|
|
34
|
+
当前模型卡片使用强调色左边条。
|
|
35
|
+
- 界面快捷键提示统一为大写 `ESC`。
|
|
36
|
+
- `/team` 打开期间的成功、错误、警告与普通提示改为 Modal 内状态栏,不再使用可能被宿主
|
|
37
|
+
弹窗层遮挡的 Toast;错误常驻并支持换行展示,普通状态自动收起。
|
|
38
|
+
- 清除团队模型覆盖前在 Modal 内显示确认条,`Enter` 确认、`ESC` 取消,不打开第二个宿主弹窗。
|
|
39
|
+
- Dashboard 左侧 Agent 的模型行与模型配置中的完整引用行改为按词换行,长 Provider 与模型名
|
|
40
|
+
不再被截断省略。
|
|
41
|
+
|
|
42
|
+
### Added
|
|
43
|
+
|
|
44
|
+
- 模型配置搜索框与 OpenCode `/model` 一致默认聚焦,直接输入即过滤,保留 Backspace、Delete、
|
|
45
|
+
粘贴与宿主输入法编辑;`j`/`k`/`r`/`/` 作为普通字符输入,恢复原生改为 `Ctrl+R`,`ESC` 返回。
|
|
46
|
+
- 模型列表按 `Enter` 时若模型提供 Variant,先切换到思考等级面板,确认等级后再保存;
|
|
47
|
+
保存或恢复成功后停留在当前配置页,不自动跳回 Dashboard。
|
|
48
|
+
- 新增 `←`/`→` 区域切换;无 Variant 时自动停留在模型列表,搜索后选中项落到可见模型。
|
|
49
|
+
- 异步保存/恢复完成后才更新反馈;关闭 Modal 后丢弃对已销毁组件的状态写入。
|
|
50
|
+
- 详情、Agent 列表、模型列表与 Variant 面板显示常驻主题滚动条,避免内容可滚动却无从发现。
|
|
51
|
+
- 支持键盘导航、内容滚动、Agent 搜索与窗口尺寸变化;窄终端自动切换单栏,低高度使用紧凑行。
|
|
52
|
+
- System Prompt 缺失时明确说明宿主未提供,不生成或伪造提示词;权限摘要按最后命中规则计算,
|
|
53
|
+
并明确不是权限沙箱。
|
|
54
|
+
|
|
55
|
+
### Removed
|
|
56
|
+
|
|
57
|
+
- 移除 Dashboard 的 `/ 搜索` 入口提示与 `P` 完整提示词页;搜索框和完整提示词都在原视图内直接使用。
|
|
58
|
+
|
|
59
|
+
## [0.2.0] - 2026-11-17
|
|
60
|
+
|
|
61
|
+
### Changed
|
|
62
|
+
|
|
63
|
+
- 项目与 npm 包更名为 `opencode-team` / `@justsilver/opencode-team`,插件 ID、RPC ID 与
|
|
64
|
+
命令入口统一为 `opencode-team`。
|
|
65
|
+
- 全局子代理模型策略改为按 Agent ID 精确匹配;未配置的 Agent 继续使用 OpenCode 原生选择,
|
|
66
|
+
主代理模型始终由 OpenCode 选择。
|
|
67
|
+
- `/subagent-model` 整合为 `/team`:先选 Agent,再选模型与变体;每个 Agent 都可单独恢复原生选择。
|
|
68
|
+
|
|
69
|
+
### Added
|
|
70
|
+
|
|
71
|
+
- 使用官方 `ctx.agent.transform` 动态注册 Orchestrator Primary Agent,并新增 QA、Reviewer 子代理;
|
|
72
|
+
复用内置 `general`、`explore`,安装后无需手工创建 Agent 文件。
|
|
73
|
+
- 插件只给 QA / Reviewer 注入 `question * deny`,子代理不得直接向用户提问:
|
|
74
|
+
- Orchestrator 不追加权限规则,保留向用户提问能力。
|
|
75
|
+
- QA / Reviewer 除 `question` 外,其余权限继承 OpenCode 默认与用户配置。
|
|
76
|
+
- General、Explore 保持内置定义,插件不修改。
|
|
77
|
+
- 用户配置在插件之后合并,可覆盖 `question` 拒绝或收紧其他权限。
|
|
78
|
+
- 用正式角色提示词替换占位:Orchestrator 负责任务编排、委派与交付;QA 负责独立验收设计与执行;
|
|
79
|
+
Reviewer 负责独立审查并输出证据化结论。
|
|
80
|
+
- 职责边界改由 System Prompt 约束:Orchestrator 优先编排、简单任务可直接执行并协调并发写入
|
|
81
|
+
与共享文件冲突;QA 独立设计、编写及执行验收测试且不迎合实现修改标准;Reviewer 默认只审查报告,
|
|
82
|
+
确需直接修复时区分审查结果与后续修改。
|
|
83
|
+
- 保留现有客观验证机制;子代理自我声明不视为测试通过。权限测试覆盖无规则注入、用户配置覆盖、
|
|
84
|
+
`edit/write/patch` 共用动作、会话权限、saved rules 与子会话场景。
|
|
85
|
+
- 旧版插件同时加载时检测冲突并停止覆盖,避免两份策略互相覆盖。
|
|
86
|
+
- 旧版插件仍加载时通过其 RPC 导入原全局模型到当前所有子代理,并记录一次性迁移标记;
|
|
87
|
+
迁移完成后提示移除旧插件并重启。
|
|
88
|
+
|
|
89
|
+
### Migration
|
|
90
|
+
|
|
91
|
+
- 先安装新包并保留旧包加载,打开一次 `/team` 完成旧全局模型导入,再移除旧包并完全重启。
|
|
92
|
+
- 旧包已移除时不再读取其独立存储命名空间;需要在 `/team` 重新选择 Agent 模型。
|
|
93
|
+
- 旧包 `@justsilver/opencode-subagent-model` 的 npm 弃用操作尚未执行,计划见 [README](README.md#从旧版插件迁移)。
|
|
94
|
+
|
|
95
|
+
## [0.1.2] - 2026-11-11
|
|
96
|
+
|
|
97
|
+
### Changed
|
|
98
|
+
|
|
99
|
+
- 弹窗标题改为两行:第一行说明这是全局的当前选择,第二行单独显示当前模型与变体,
|
|
100
|
+
不再把信息挤在一行里。
|
|
101
|
+
|
|
102
|
+
## [0.1.1] - 2026-11-10
|
|
103
|
+
|
|
104
|
+
### Fixed
|
|
105
|
+
|
|
106
|
+
- 选择弹窗标题不再重复显示同一模型(可读名称与 `provider/model#variant` 同时出现),
|
|
107
|
+
模型不可用时才回显原引用。
|
|
108
|
+
- 选择弹窗加宽,标题与「名称 — 完整引用」不再挤成多行。
|
|
109
|
+
|
|
110
|
+
## [0.1.0] - 2026-11-10
|
|
111
|
+
|
|
112
|
+
### Added
|
|
113
|
+
|
|
114
|
+
- 独立插件:`/subagent-model` 全局模型与变体选择、持久策略、执行前强制覆盖。
|
|
115
|
+
- 工具成功返回末尾告知本次强制模型,保留前台/后台、并发与失败边界。
|
|
116
|
+
- server / TUI / RPC 三入口与 npm 包形态,无运行时依赖。
|
|
117
|
+
|
|
118
|
+
### Migration
|
|
119
|
+
|
|
120
|
+
- 从 providers 迁移时不自动继承旧设置:先停用旧覆盖,再在本插件重新选择一次模型,
|
|
121
|
+
见[独立迁移计划](docs/extraction-plan.md)。
|
|
122
|
+
|
|
123
|
+
## [0.1.0-beta.0] - 2026-11-10
|
|
124
|
+
|
|
125
|
+
### Added
|
|
126
|
+
|
|
127
|
+
- 从 providers 中独立出 `/subagent-model`:全局模型与变体选择、持久策略、执行前强制覆盖。
|
|
128
|
+
- 工具成功返回末尾告知本次强制模型,保留前台/后台、并发与失败边界。
|
|
129
|
+
- 独立 server / TUI / RPC 入口与 npm 包形态,无运行时依赖。
|
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 YIN
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 YIN
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
21
|
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,116 +1,116 @@
|
|
|
1
|
-
<!-- 职责:使用者的安装、团队用法、按 Agent 模型配置、迁移与疑难解答;不写:内部实现、发版流程、完整设计契约。 -->
|
|
2
|
-
|
|
3
|
-
# opencode-team
|
|
4
|
-
|
|
5
|
-
给 OpenCode V2 提供零配置的多 Agent 团队:Orchestrator、QA、Reviewer 开箱即用,
|
|
6
|
-
并可按 Agent 单独指定子代理模型与变体。可选择当前目录可用的任意聊天模型,不依赖供应商插件。
|
|
7
|
-
|
|
8
|
-
## 安装
|
|
9
|
-
|
|
10
|
-
```bash
|
|
11
|
-
opencode plugin add @justsilver/opencode-team
|
|
12
|
-
```
|
|
13
|
-
|
|
14
|
-
预发布版用 `@justsilver/opencode-team@next`。
|
|
15
|
-
|
|
16
|
-
安装后**完全退出并重新启动** OpenCode,server 与 TUI 入口都在启动时加载。
|
|
17
|
-
也可以从本地源码目录加载:在 `plugins` 里给插件目录的绝对路径,
|
|
18
|
-
例如 `{ "package": "<仓库>/plugin/opencode-team" }`。两种方式同一个插件 ID,不要同时启用。
|
|
19
|
-
|
|
20
|
-
## 团队 Agent
|
|
21
|
-
|
|
22
|
-
安装后自动获得:
|
|
23
|
-
|
|
24
|
-
- `Orchestrator`(主代理):按需调度、协调子代理并完成最终交付;可以直接执行任务。
|
|
25
|
-
它不会自动变成默认主代理,用 OpenCode 的 Agent 切换选择它,或在配置中设置
|
|
26
|
-
`default_agent: "orchestrator"`。
|
|
27
|
-
- `QA`(子代理):独立设计、编写及执行验收测试并报告证据;不迎合实现修改验收标准;
|
|
28
|
-
修改生产代码需明确授权。
|
|
29
|
-
- `Reviewer`(子代理):默认只审查和报告;可做针对性验证但不替代 QA 验收;
|
|
30
|
-
修改生产代码需明确授权。
|
|
31
|
-
- 继续复用内置 `general`、`explore`;不重复实现已有能力,也不修改它们的权限。
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
- Orchestrator 不追加权限规则。
|
|
36
|
-
- QA / Reviewer 除 `question` 外,其余权限继承 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#主代理知情边界)。
|
|
76
|
-
|
|
77
|
-
System Prompt 与权限:
|
|
78
|
-
|
|
79
|
-
- 提示词来自宿主当前生效的 Agent 定义,只读;General 等没有独立 System Prompt 的 Agent
|
|
80
|
-
会明确显示“宿主未提供”,插件不会生成或补全内容。
|
|
81
|
-
- 权限摘要按宿主合并后的规则计算,只是效果摘要,不代表权限沙箱;需要硬限制时请在
|
|
82
|
-
`opencode.json` 配置对应 Agent 权限。
|
|
83
|
-
|
|
84
|
-
当前版本不提供 Agent 创建、删除、重命名或 Prompt 编辑。
|
|
85
|
-
|
|
86
|
-
## 从旧版插件迁移
|
|
87
|
-
|
|
88
|
-
旧包为 `@justsilver/opencode-subagent-model`,使用独立的存储命名空间与全局模型策略。
|
|
89
|
-
新插件无法直接读取旧命名空间,因此需要旧插件仍在加载时完成交接:
|
|
90
|
-
|
|
91
|
-
1. 保留旧包配置,先安装 `@justsilver/opencode-team` 并完全重启 OpenCode。
|
|
92
|
-
2. 打开一次 `/team`。若检测到旧插件,会提示冲突与迁移结果;若提示迁移失败,确认旧插件已加载后重新打开一次。
|
|
93
|
-
3. 旧全局模型会导入到当前 location 中所有非主代理 Agent(含自定义子代理);旧设置为空时只记录迁移结果。
|
|
94
|
-
其他项目独有的自定义 Agent 不在当前列表中,需要在那个项目打开 `/team` 重新选择。
|
|
95
|
-
4. 移除旧包配置,完全重启 OpenCode。
|
|
96
|
-
5. 打开 `/team` 调整个别 Agent 的模型或恢复原生选择。
|
|
97
|
-
|
|
98
|
-
如果先移除了旧包再启动新插件,旧值仍在旧命名空间中,但官方插件 API 无法跨命名空间读取;
|
|
99
|
-
本插件不会直接访问数据库。此时直接在 `/team` 重新选择即可。
|
|
100
|
-
|
|
101
|
-
旧 npm 包的弃用(`npm deprecate`)尚未执行;待 `@justsilver/opencode-team` 发布并验证可安装后,
|
|
102
|
-
再执行弃用并补迁移提示。当前版本不发布或弃用任何包。
|
|
103
|
-
|
|
104
|
-
## 疑难解答
|
|
105
|
-
|
|
106
|
-
| 现象 | 处理 |
|
|
107
|
-
|---|---|
|
|
108
|
-
| 找不到 `/team` | 确认插件已加载,且安装后完全重启过 OpenCode |
|
|
109
|
-
| 提示旧插件冲突 | 按迁移步骤先打开 `/team` 完成导入,再移除旧包并重启 |
|
|
110
|
-
| 提示团队 Agent 注册失败 | 按面板中的具体错误排查;旧宿主可升级 OpenCode。已存在的子代理仍可配置模型 |
|
|
111
|
-
| 提示功能不可用 | 当前宿主缺少工具钩子,或钩子注册失败;不会假装保存成功 |
|
|
112
|
-
| 当前模型不可用 | 切到可用模型或恢复原生选择;不会静默换成其他模型 |
|
|
113
|
-
| 命令重复或覆盖冲突 | 检查是否同时启用了旧包、本地目录和 npm 两份 |
|
|
114
|
-
|
|
115
|
-
开发与发布见 [CONTRIBUTING.md](CONTRIBUTING.md),设计契约见[策略](docs/team-policy.md)与
|
|
116
|
-
[团队 Agent](docs/team-agents.md)。
|
|
1
|
+
<!-- 职责:使用者的安装、团队用法、按 Agent 模型配置、迁移与疑难解答;不写:内部实现、发版流程、完整设计契约。 -->
|
|
2
|
+
|
|
3
|
+
# opencode-team
|
|
4
|
+
|
|
5
|
+
给 OpenCode V2 提供零配置的多 Agent 团队:Orchestrator、QA、Reviewer 开箱即用,
|
|
6
|
+
并可按 Agent 单独指定子代理模型与变体。可选择当前目录可用的任意聊天模型,不依赖供应商插件。
|
|
7
|
+
|
|
8
|
+
## 安装
|
|
9
|
+
|
|
10
|
+
```bash
|
|
11
|
+
opencode plugin add @justsilver/opencode-team
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
预发布版用 `@justsilver/opencode-team@next`。
|
|
15
|
+
|
|
16
|
+
安装后**完全退出并重新启动** OpenCode,server 与 TUI 入口都在启动时加载。
|
|
17
|
+
也可以从本地源码目录加载:在 `plugins` 里给插件目录的绝对路径,
|
|
18
|
+
例如 `{ "package": "<仓库>/plugin/opencode-team" }`。两种方式同一个插件 ID,不要同时启用。
|
|
19
|
+
|
|
20
|
+
## 团队 Agent
|
|
21
|
+
|
|
22
|
+
安装后自动获得:
|
|
23
|
+
|
|
24
|
+
- `Orchestrator`(主代理):按需调度、协调子代理并完成最终交付;可以直接执行任务。
|
|
25
|
+
它不会自动变成默认主代理,用 OpenCode 的 Agent 切换选择它,或在配置中设置
|
|
26
|
+
`default_agent: "orchestrator"`。
|
|
27
|
+
- `QA`(子代理):独立设计、编写及执行验收测试并报告证据;不迎合实现修改验收标准;
|
|
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#主代理知情边界)。
|
|
76
|
+
|
|
77
|
+
System Prompt 与权限:
|
|
78
|
+
|
|
79
|
+
- 提示词来自宿主当前生效的 Agent 定义,只读;General 等没有独立 System Prompt 的 Agent
|
|
80
|
+
会明确显示“宿主未提供”,插件不会生成或补全内容。
|
|
81
|
+
- 权限摘要按宿主合并后的规则计算,只是效果摘要,不代表权限沙箱;需要硬限制时请在
|
|
82
|
+
`opencode.json` 配置对应 Agent 权限。
|
|
83
|
+
|
|
84
|
+
当前版本不提供 Agent 创建、删除、重命名或 Prompt 编辑。
|
|
85
|
+
|
|
86
|
+
## 从旧版插件迁移
|
|
87
|
+
|
|
88
|
+
旧包为 `@justsilver/opencode-subagent-model`,使用独立的存储命名空间与全局模型策略。
|
|
89
|
+
新插件无法直接读取旧命名空间,因此需要旧插件仍在加载时完成交接:
|
|
90
|
+
|
|
91
|
+
1. 保留旧包配置,先安装 `@justsilver/opencode-team` 并完全重启 OpenCode。
|
|
92
|
+
2. 打开一次 `/team`。若检测到旧插件,会提示冲突与迁移结果;若提示迁移失败,确认旧插件已加载后重新打开一次。
|
|
93
|
+
3. 旧全局模型会导入到当前 location 中所有非主代理 Agent(含自定义子代理);旧设置为空时只记录迁移结果。
|
|
94
|
+
其他项目独有的自定义 Agent 不在当前列表中,需要在那个项目打开 `/team` 重新选择。
|
|
95
|
+
4. 移除旧包配置,完全重启 OpenCode。
|
|
96
|
+
5. 打开 `/team` 调整个别 Agent 的模型或恢复原生选择。
|
|
97
|
+
|
|
98
|
+
如果先移除了旧包再启动新插件,旧值仍在旧命名空间中,但官方插件 API 无法跨命名空间读取;
|
|
99
|
+
本插件不会直接访问数据库。此时直接在 `/team` 重新选择即可。
|
|
100
|
+
|
|
101
|
+
旧 npm 包的弃用(`npm deprecate`)尚未执行;待 `@justsilver/opencode-team` 发布并验证可安装后,
|
|
102
|
+
再执行弃用并补迁移提示。当前版本不发布或弃用任何包。
|
|
103
|
+
|
|
104
|
+
## 疑难解答
|
|
105
|
+
|
|
106
|
+
| 现象 | 处理 |
|
|
107
|
+
|---|---|
|
|
108
|
+
| 找不到 `/team` | 确认插件已加载,且安装后完全重启过 OpenCode |
|
|
109
|
+
| 提示旧插件冲突 | 按迁移步骤先打开 `/team` 完成导入,再移除旧包并重启 |
|
|
110
|
+
| 提示团队 Agent 注册失败 | 按面板中的具体错误排查;旧宿主可升级 OpenCode。已存在的子代理仍可配置模型 |
|
|
111
|
+
| 提示功能不可用 | 当前宿主缺少工具钩子,或钩子注册失败;不会假装保存成功 |
|
|
112
|
+
| 当前模型不可用 | 切到可用模型或恢复原生选择;不会静默换成其他模型 |
|
|
113
|
+
| 命令重复或覆盖冲突 | 检查是否同时启用了旧包、本地目录和 npm 两份 |
|
|
114
|
+
|
|
115
|
+
开发与发布见 [CONTRIBUTING.md](CONTRIBUTING.md),设计契约见[策略](docs/team-policy.md)与
|
|
116
|
+
[团队 Agent](docs/team-agents.md)。
|
package/package.json
CHANGED
|
@@ -17,8 +17,11 @@ export interface TeamAgentDefinition {
|
|
|
17
17
|
readonly permissions: readonly PermissionRule[]
|
|
18
18
|
}
|
|
19
19
|
|
|
20
|
-
//
|
|
21
|
-
const
|
|
20
|
+
// QA and Reviewer are leaves: the primary Orchestrator owns user interaction and further delegation.
|
|
21
|
+
const LEAF_SUBAGENT_PERMISSIONS: readonly PermissionRule[] = [
|
|
22
|
+
{ action: "question", resource: "*", effect: "deny" },
|
|
23
|
+
{ action: "subagent", resource: "*", effect: "deny" },
|
|
24
|
+
]
|
|
22
25
|
|
|
23
26
|
export const TEAM_AGENTS: readonly TeamAgentDefinition[] = [
|
|
24
27
|
{
|
|
@@ -37,7 +40,7 @@ export const TEAM_AGENTS: readonly TeamAgentDefinition[] = [
|
|
|
37
40
|
"Independent quality assurance agent. Designs and executes acceptance and regression tests against requirements and contracts, investigates failures, and independently verifies fixes. Production code changes require explicit authorization.",
|
|
38
41
|
mode: "subagent",
|
|
39
42
|
system: QA_PROMPT,
|
|
40
|
-
permissions:
|
|
43
|
+
permissions: LEAF_SUBAGENT_PERMISSIONS,
|
|
41
44
|
},
|
|
42
45
|
{
|
|
43
46
|
id: "reviewer",
|
|
@@ -46,7 +49,7 @@ export const TEAM_AGENTS: readonly TeamAgentDefinition[] = [
|
|
|
46
49
|
"Independent code reviewer. Primarily reviews source code for correctness, architecture, and risks, using targeted verification when needed. Reports evidence-based findings without replacing QA acceptance testing. Production code changes require explicit authorization.",
|
|
47
50
|
mode: "subagent",
|
|
48
51
|
system: REVIEWER_PROMPT,
|
|
49
|
-
permissions:
|
|
52
|
+
permissions: LEAF_SUBAGENT_PERMISSIONS,
|
|
50
53
|
},
|
|
51
54
|
]
|
|
52
55
|
|