opencode-gbk-tools 0.1.15 → 0.1.17

package/README.md

@@ -2,7 +2,7 @@
 
 为 OpenCode 提供一套自动识别编码的文本工具，以及面向 `GBK` / `GB18030` 的专用工具。
 
-解决 OpenCode 内置工具难以稳定处理非 UTF-8 文本文件的问题，并让所有 agents 默认优先使用可保留原编码的 `text_*` 工具。
+解决 OpenCode 内置工具难以稳定处理非 UTF-8 文本文件的问题，并通过 plugin 让所有 agents 默认获得这些工具与规则，无需单独切换专属 GBK agent。
 
 ---
 
@@ -17,7 +17,7 @@
 | `gbk_write` | 写入或追加内容到 GBK 文件（`append=true` 支持追加） |
 | `gbk_edit` | 精确替换 GBK 文件中的指定文本块 |
 | `gbk_search` | 在 GBK 文件中搜索关键词，返回行号和上下文 |
-| 本地/全局 plugin 规则 | 给所有 agents 注入“优先使用 `text_*`”的系统提示 |
+| 本地/全局 plugin 规则 | 给所有 agents 注入“优先使用 `text_*`”的系统提示，并统一开放 `gbk_*` 工具 |
 
 ---
 
@@ -27,7 +27,15 @@
 npx opencode-gbk-tools install
 ```
 
-安装完成后**重启 OpenCode**，工具立即生效。
+安装完成后会注册 `opencode-gbk-tools` plugin，由该 plugin 统一向全部 agents 暴露 `text_*` / `gbk_*` 工具与规则。
+
+重启 OpenCode 后，**全部 agents** 都会默认获得：
+
+- `text_read` / `text_write` / `text_edit`
+- `gbk_read` / `gbk_write` / `gbk_edit` / `gbk_search`
+- 对文本文件优先使用 `text_*` 的系统提示
+
+不再需要单独安装或切换专属 `gbk-engine` agent。
 
 ---
 
@@ -41,6 +49,8 @@ npx opencode-gbk-tools install
 npx opencode-gbk-tools uninstall
 ```
 
+卸载后会移除已安装的工具、plugin 与 manifest，所有 agents 恢复为未安装前的默认行为。
+
 ---
 
 ## 工具使用说明
@@ -181,7 +191,7 @@ A：重启 OpenCode。工具在 OpenCode 启动时加载，安装后需要重启
 A：请先安装 Node.js（https://nodejs.org/），版本需要 18 或以上。
 
 **Q：Windows 路径在哪？**
-A：全局安装目录为 `C:\Users\你的用户名\.config\opencode\tools\`
+A：全局安装的 plugin 文件位于 `C:\Users\你的用户名\.config\opencode\plugins\opencode-gbk-tools.js`
 
 **Q：gbk_edit 提示"未找到需要替换的文本"？**
 A：检查 `oldString` 是否包含了行号前缀（如 `"3787: "`），去掉行号前缀后重试。若要在文件末尾追加内容，请使用 `gbk_write [append=true]`。
@@ -195,6 +205,8 @@ A：不要。现在优先用 `mode="insertAfter"` 或 `mode="insertBefore"`，
 
 | 版本 | 说明 |
 |------|------|
+| 0.1.17 | 修复 OpenCode 以 npm plugin 方式加载包时缺少 `./server` 导出导致的插件加载失败问题；补充 `main` 与 `./server` 入口兼容性 |
+| 0.1.16 | 去掉专属 `gbk-engine` agent 安装链路，改为通过 plugin + tools 让全部 agents 统一支持 `text_*` / `gbk_*`；同步更新安装说明 |
 | 0.1.15 | 为 GBK 大文件统一引入行字节索引与流式读/搜/改路径，提升局部编辑、搜索与大块修改时的性能、稳定性与准确性 |
 | 0.1.14 | 重新发布当前稳定产物，核对 `npm pack --dry-run` 输出包含完整 `dist/`，为下一次公开发布提供一致的打包基线 |
 | 0.1.13 | `text_write` 在新文件 + `encoding=auto` 下改为显式报错，不再静默默认 `utf8`；同时优化 `text_read` 流式读取与 `text_edit` 预览生成，减少重复读取 |

package/dist/cli/index.js

@@ -60,10 +60,19 @@ function resolveTargetBase(target, cwd) {
 // src/cli/install.ts
 async function installCommand(args) {
   const targetBase = resolveTargetBase(args.target, args.cwd);
-  const allowedArtifacts = new Set(args.artifacts ?? ["tool", "agent", "plugin"]);
+  const allowedArtifacts = new Set(args.artifacts ?? ["plugin"]);
   const releaseManifest = JSON.parse(await fs3.readFile(path3.join(args.packageRoot, "dist", "release-manifest.json"), "utf8"));
   const selectedArtifacts = releaseManifest.artifacts.filter((artifact) => allowedArtifacts.has(artifact.kind));
   const existingManifest = await loadInstalledManifest(targetBase);
+  const selectedRelativePaths = new Set(selectedArtifacts.map((artifact) => artifact.relativePath));
+  if (existingManifest) {
+    for (const file of existingManifest.files) {
+      if (selectedRelativePaths.has(file.relativePath)) {
+        continue;
+      }
+      await fs3.rm(path3.join(targetBase, file.relativePath), { force: true });
+    }
+  }
   for (const artifact of selectedArtifacts) {
     const targetPath = path3.join(targetBase, artifact.relativePath);
     if (await pathExists(targetPath) && !existingManifest && !args.force) {
@@ -181,7 +190,7 @@ async function setupCommand(args) {
   await fs6.mkdir(configBase, { recursive: true });
   const configPath = await resolveConfigFile(configBase);
   await ensurePluginConfigured(configPath, pluginName);
-  const installResult = await installCommand({ ...args, force: true, artifacts: ["agent", "plugin"] });
+  const installResult = await installCommand({ ...args, force: true, artifacts: ["plugin"] });
   return {
     configPath,
     targetBase: installResult.targetBase

package/dist/plugin/index.js

@@ -18821,26 +18821,30 @@ var text_write_default = tool({
 });
 
 // src/plugin/index.ts
+function createOpencodeGbkHooks() {
+  return {
+    tool: {
+      gbk_read: gbk_read_default,
+      gbk_write: gbk_write_default,
+      gbk_edit: gbk_edit_default,
+      gbk_search: gbk_search_default,
+      text_read: text_read_default,
+      text_write: text_write_default,
+      text_edit: text_edit_default
+    },
+    async "experimental.chat.system.transform"(_input, output) {
+      appendTextToolSystemPrompt(output.system);
+    }
+  };
+}
 var pluginModule = {
   id: "opencode-gbk-tools",
   async server() {
-    return {
-      tool: {
-        gbk_read: gbk_read_default,
-        gbk_write: gbk_write_default,
-        gbk_edit: gbk_edit_default,
-        gbk_search: gbk_search_default,
-        text_read: text_read_default,
-        text_write: text_write_default,
-        text_edit: text_edit_default
-      },
-      async "experimental.chat.system.transform"(_input, output) {
-        appendTextToolSystemPrompt(output.system);
-      }
-    };
+    return createOpencodeGbkHooks();
   }
 };
 var plugin_default = pluginModule;
 export {
+  createOpencodeGbkHooks,
   plugin_default as default
 };