@justsilver/opencode-team 0.2.1 → 0.2.2-beta.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.
Files changed (3) hide show
  1. package/CHANGELOG.md +10 -1
  2. package/README.md +53 -86
  3. package/package.json +4 -4
package/CHANGELOG.md CHANGED
@@ -7,6 +7,15 @@
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.2.2-beta.1] - 2026-11-18
11
+
12
+ ### Changed
13
+
14
+ - 旧包 `@justsilver/opencode-subagent-model` 已在 npm 标记 deprecated(覆盖全部已发布版本),
15
+ 弃用提示指向 `@justsilver/opencode-team`;旧包保留可安装,不撤包。
16
+ - 修复从 npm 安装后面板无响应:`@opentui/*` 的 peer 范围从 `>=0.8.4` 收紧到 `>=0.8.4 <0.9.0`,
17
+ 避免 npm 装到与宿主不兼容的 `0.9.x`;这些 peer 继续保持必装,不能标记为 optional。
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 弃用操作尚未执行,计划见 [README](README.md#从旧版插件迁移)。
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,116 +1,83 @@
1
- <!-- 职责:使用者的安装、团队用法、按 Agent 模型配置、迁移与疑难解答;不写:内部实现、发版流程、完整设计契约。 -->
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 子代理,复用内置 `general`、`explore`。
11
+ - **按 Agent 覆盖模型**:只影响指定的子代理,其余 Agent 继续使用 OpenCode 原生选择。
12
+ - **可视化管理**:`/team` 面板查看角色、模型来源与完整 System Prompt,并直接改模型与变体。
13
+ - **随时可逆**:清除团队覆盖后回到 Agent 配置或 OpenCode 原生选择。
14
+ - **失败可见**:模型不可用或读取失败都明确报错,不静默回退。
15
+
8
16
  ## 安装
9
17
 
10
18
  ```bash
11
19
  opencode plugin add @justsilver/opencode-team
12
20
  ```
13
21
 
14
- 预发布版用 `@justsilver/opencode-team@next`。
22
+ 预发布版用 `@justsilver/opencode-team@next`。安装后**完全退出并重新启动** OpenCode。
23
+
24
+ 也可以从本地源码目录加载:在 `plugins` 里写插件目录的绝对路径,例如
25
+ `{ "package": "<仓库>/plugin/opencode-team" }`;两种方式同一个插件 ID,不要同时启用。
15
26
 
16
- 安装后**完全退出并重新启动** OpenCode,server 与 TUI 入口都在启动时加载。
17
- 也可以从本地源码目录加载:在 `plugins` 里给插件目录的绝对路径,
18
- 例如 `{ "package": "<仓库>/plugin/opencode-team" }`。两种方式同一个插件 ID,不要同时启用。
27
+ ## 快速开始
28
+
29
+ 1. 安装并完全重启 OpenCode。
30
+ 2. 输入 `/` 选择 `/team`,或在命令面板搜索「Agent 团队与模型」。
31
+ 3. 用方向键选一个子代理(如 QA),按 `Enter` 打开模型配置。
32
+ 4. 选择模型;如果该模型有变体,先按 `Enter` 选思考等级,再按 `Enter` 保存。
33
+ 5. 之后 Orchestrator 派发子代理时,被配置的 Agent 会自动使用团队模型。
19
34
 
20
35
  ## 团队 Agent
21
36
 
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 编辑。
37
+ | Agent | 类型 | 职责 |
38
+ |---|---|---|
39
+ | `Orchestrator` | 主代理 | 优先编排,简单任务可直接执行,协调子代理并完成最终交付 |
40
+ | `QA` | 子代理 | 独立设计、编写并执行验收测试;不迎合实现修改验收标准 |
41
+ | `Reviewer` | 子代理 | 默认只审查和报告;必要时做针对性验证,不替代 QA 验收 |
42
+ | `General` | 内置子代理 | 通用多步任务,由 Orchestrator 复用 |
43
+ | `Explore` | 内置子代理 | 代码库探索 |
85
44
 
86
- ## 从旧版插件迁移
45
+ Orchestrator 不会自动成为默认主代理;用 OpenCode 的 Agent 切换选择它,或设置
46
+ `default_agent: "orchestrator"`。QA 与 Reviewer 是叶子子代理,不能提问也不能再派发子代理;
47
+ 其余权限继承 OpenCode 默认值与你的配置,需要硬限制时请配置对应 Agent 权限。
87
48
 
88
- 旧包为 `@justsilver/opencode-subagent-model`,使用独立的存储命名空间与全局模型策略。
89
- 新插件无法直接读取旧命名空间,因此需要旧插件仍在加载时完成交接:
49
+ 角色职责与提示词边界见[团队 Agent](docs/team-agents.md)。
50
+
51
+ ## 团队面板
52
+
53
+ - 搜索框常驻聚焦,直接输入即过滤;方向键选择,`Enter` 打开模型配置,`Ctrl+R` 清除团队覆盖,
54
+ `ESC` 返回或关闭。
55
+ - 模型配置按 Provider 分组,`←`/`→` 与 `Tab` 切换区域和变体,`Enter` 保存,`Ctrl+R` 恢复原生。
56
+ - 模型设置全局共享、重启保留;主代理模型只读,由 OpenCode 会话选择。
57
+ - 窄终端自动切换为单栏布局。
58
+
59
+ 界面细节与键盘契约见 [TUI Dashboard](docs/team-tui.md)。
60
+
61
+ ## 从旧版插件迁移
90
62
 
91
- 1. 保留旧包配置,先安装 `@justsilver/opencode-team` 并完全重启 OpenCode。
92
- 2. 打开一次 `/team`。若检测到旧插件,会提示冲突与迁移结果;若提示迁移失败,确认旧插件已加载后重新打开一次。
93
- 3. 旧全局模型会导入到当前 location 中所有非主代理 Agent(含自定义子代理);旧设置为空时只记录迁移结果。
94
- 其他项目独有的自定义 Agent 不在当前列表中,需要在那个项目打开 `/team` 重新选择。
95
- 4. 移除旧包配置,完全重启 OpenCode。
96
- 5. 打开 `/team` 调整个别 Agent 的模型或恢复原生选择。
63
+ 旧包 `@justsilver/opencode-subagent-model` 使用独立存储命名空间,需要旧插件仍在加载时完成交接:
97
64
 
98
- 如果先移除了旧包再启动新插件,旧值仍在旧命名空间中,但官方插件 API 无法跨命名空间读取;
99
- 本插件不会直接访问数据库。此时直接在 `/team` 重新选择即可。
65
+ 1. 保留旧包配置,安装 `@justsilver/opencode-team` 并完全重启。
66
+ 2. 打开一次 `/team`,按提示完成旧全局模型导入;失败时确认旧插件已加载后重试。
67
+ 3. 移除旧包配置,完全重启。
68
+ 4. 打开 `/team` 按需调整模型或恢复原生选择。
100
69
 
101
- 旧 npm 包的弃用(`npm deprecate`)尚未执行;待 `@justsilver/opencode-team` 发布并验证可安装后,
102
- 再执行弃用并补迁移提示。当前版本不发布或弃用任何包。
70
+ 旧包全部版本已在 npm 标记 deprecated,安装时会提示迁移;旧包保留可安装、不撤包。
103
71
 
104
- ## 疑难解答
72
+ ## 常见问题
105
73
 
106
74
  | 现象 | 处理 |
107
75
  |---|---|
108
76
  | 找不到 `/team` | 确认插件已加载,且安装后完全重启过 OpenCode |
109
- | 提示旧插件冲突 | 按迁移步骤先打开 `/team` 完成导入,再移除旧包并重启 |
110
- | 提示团队 Agent 注册失败 | 按面板中的具体错误排查;旧宿主可升级 OpenCode。已存在的子代理仍可配置模型 |
77
+ | 提示旧插件冲突 | 先按迁移步骤打开 `/team` 完成导入,再移除旧包并重启 |
78
+ | 提示团队 Agent 注册失败 | 按面板中的具体错误排查;旧宿主可升级 OpenCode |
111
79
  | 提示功能不可用 | 当前宿主缺少工具钩子,或钩子注册失败;不会假装保存成功 |
112
- | 当前模型不可用 | 切到可用模型或恢复原生选择;不会静默换成其他模型 |
113
- | 命令重复或覆盖冲突 | 检查是否同时启用了旧包、本地目录和 npm 两份 |
80
+ | 命令或配置重复 | 检查是否同时启用了旧包、本地目录和 npm 两份 |
114
81
 
115
82
  开发与发布见 [CONTRIBUTING.md](CONTRIBUTING.md),设计契约见[策略](docs/team-policy.md)与
116
83
  [团队 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.1",
3
+ "version": "0.2.2-beta.1",
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",
@@ -34,9 +34,9 @@
34
34
  "typecheck": "tsc --noEmit"
35
35
  },
36
36
  "peerDependencies": {
37
- "@opentui/core": ">=0.8.4",
38
- "@opentui/solid": ">=0.8.4",
39
- "solid-js": ">=1.9.12"
37
+ "@opentui/core": ">=0.8.4 <0.9.0",
38
+ "@opentui/solid": ">=0.8.4 <0.9.0",
39
+ "solid-js": ">=1.9.12 <2"
40
40
  },
41
41
  "devDependencies": {
42
42
  "@opencode/client": "^2.3.0",