@te-river/opencode-team-mode 1.5.7 → 1.5.9

package/docs/installation.md

@@ -14,12 +14,12 @@ An OpenCode plugin that injects a **six-agent development team** (Team Lead, Arc
 
 ### Step 1 — Locate the OpenCode config file
 
-Check, in order:
+**`opencode.jsonc` is the canonical name and OVERRIDES `opencode.json` when
+both exist — always prefer writing the `.jsonc`.**
 
-1. **Project config:** `opencode.json` or `opencode.jsonc` in the current project root.
-2. **Global config:** `~/.config/opencode/opencode.json` (or `.jsonc`) — on Windows typically `C:\Users\<user>\.config\opencode\opencode.json`.
-
-If neither exists, create the global one (`~/.config/opencode/opencode.jsonc`) so the team is available in every project.
+1. **Global config:** `~/.config/opencode/opencode.jsonc` (Windows: `C:\Users\<user>\.config\opencode\opencode.jsonc`) — patch it when present.
+2. If only an `opencode.json` exists in that directory, **migrate**: copy its full content into a new `opencode.jsonc` and add the plugin entry there (leave the original `.json` untouched — the migration guarantees nothing is lost).
+3. If neither exists, create the global `opencode.jsonc` fresh so the team is available in every project.
 
 ### Step 2 — Add the plugin entry
 
@@ -40,6 +40,16 @@ If a `"plugin"` array already exists, append the string to it. If the entry is a
 
 The plugin is resolved and loaded **once at startup**. The user must fully quit and restart OpenCode (Desktop: quit from the tray/menu, not just close the window; CLI: restart the `opencode` process).
 
+### Network note (mainland China)
+
+This guide is served from `raw.githubusercontent.com`, which is often
+unreachable from mainland-China networks. If fetching it fails, retry with
+the mirror prefix — `https://ghproxy.net/` + the same full URL. Both hosts
+are on TeamMode's seeded `tm_webfetch` allowlist, so the governed fetch tool
+can read either. After the plugin is installed and OpenCode restarted, the
+same guide also ships inside the package at
+`<opencode-cache>/packages/@te_river+opencode-team-mode@<version>/docs/installation.md`.
+
 ### Step 4 — Verify
 
 After restart, verify in this order:
@@ -113,12 +123,11 @@ https://raw.githubusercontent.com/Te-River/Opencode-TeamMode/main/docs/installat
 
 ### 第 1 步 — 找到 OpenCode 配置文件
 
-按顺序检查：
+**`opencode.jsonc` 是规范文件名，与 `opencode.json` 并存时以 jsonc 为准——始终优先写 `.jsonc`。**
 
-1. **项目配置：** 当前项目根目录下的 `opencode.json` 或 `opencode.jsonc`。
-2. **全局配置：** `~/.config/opencode/opencode.json`（或 `.jsonc`）——Windows 下通常是 `C:\Users\<用户名>\.config\opencode\opencode.json`。
-
-都不存在时，创建全局配置（`~/.config/opencode/opencode.jsonc`），让团队在每个项目里都可用。
+1. **全局配置：** `~/.config/opencode/opencode.jsonc`（Windows：`C:\Users\<用户名>\.config\opencode\opencode.jsonc`）——存在则直接改它。
+2. 该目录下只有 `opencode.json` 时，**先迁移**：把它的完整内容复制进新的 `opencode.jsonc`，再在 jsonc 里加插件条目（原 `.json` 原样保留——迁移保证什么都不丢）。
+3. 两者都不存在时，新建全局 `opencode.jsonc`，让团队在每个项目里都可用。
 
 ### 第 2 步 — 加入插件条目
 
@@ -139,6 +148,14 @@ https://raw.githubusercontent.com/Te-River/Opencode-TeamMode/main/docs/installat
 
 插件只在**启动时**解析和加载一次。用户需要完全退出并重启 OpenCode（桌面版：从托盘/菜单退出，不是只关窗口；CLI：重启 `opencode` 进程）。
 
+### 网络提示（中国大陆）
+
+本指南托管在 `raw.githubusercontent.com`，中国大陆网络经常无法直达。抓取
+失败时改用镜像前缀重试——`https://ghproxy.net/` + 同样的完整 URL。两个主机
+都在 TeamMode 的 `tm_webfetch` 种子白名单内，受治理的抓取工具可以直读。
+插件装好、OpenCode 重启之后，同一份指南也在包内：
+`<opencode-cache>/packages/@te_river+opencode-team-mode@<版本>/docs/installation.md`。
+
 ### 第 4 步 — 验证
 
 重启后按顺序验证：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@te-river/opencode-team-mode",
-  "version": "1.5.7",
+  "version": "1.5.9",
   "description": "Team collaboration mode plugin for OpenCode Desktop — injects specialized agents (architect, reviewer, implementer, tester, researcher) and team workflow commands into your OpenCode workspace.",
   "type": "module",
   "main": "dist/index.js",