refactor: consolidate to single-file plugin, zero npm dependencies

Merge src/index.ts into src/utf8-encoding.ts. Remove @opencode-ai/plugin dependency. The same file now works both as an npm package and as a standalone copy-to-plugins file.

Author: Cle2ment

README.md

@@ -53,6 +53,23 @@ Or with a specific version:
 
 After adding the plugin, restart OpenCode. All subsequent shell commands will use UTF-8 encoding automatically.
 
+## 本地使用（复制即用）
+
+本项目是单文件插件，`src/utf8-encoding.ts` 可以直接复制到 OpenCode 插件目录使用，零依赖：
+
+**PowerShell:**
+```powershell
+Copy-Item src/utf8-encoding.ts $env:USERPROFILE/.config/opencode/plugins/utf8-encoding.ts
+```
+
+**Bash / WSL:**
+```bash
+cp src/utf8-encoding.ts ~/.config/opencode/plugins/utf8-encoding.ts
+```
+
+重启 OpenCode 即生效。无需 `npm install`，无需构建。
+
+`src/utf8-encoding.ts` 仅使用 Node.js 内置模块（`node:fs`, `node:os`, `node:path`），无任何 npm 依赖。
 ## Requirements
 
 - **OpenCode** (any recent version with plugin support)
@@ -75,24 +92,14 @@ npm run typecheck
 npm run dev
 ```
 
-### Local plugin testing
-
-To test locally without publishing, reference the build output in your `opencode.jsonc`:
-
-```jsonc
-{
-  "plugin": [
-    "/path/to/opencode-windows-encoding/dist/index.js"
-  ]
-}
-```
+### 本地开发测试
 
-Or reference the TypeScript source directly:
+直接引用源码即可：
 
 ```jsonc
 {
   "plugin": [
-    "/path/to/opencode-windows-encoding/src/index.ts"
+    "/path/to/opencode-windows-encoding/src/utf8-encoding.ts"
   ]
 }
 ```

package-lock.json

@@ -1,14 +1,14 @@
 {
   "name": "opencode-windows-encoding",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "OpenCode plugin to fix UTF-8 encoding issues in PowerShell on Windows",
   "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/utf8-encoding.js",
+  "types": "./dist/utf8-encoding.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "types": "./dist/utf8-encoding.d.ts",
+      "import": "./dist/utf8-encoding.js"
     }
   },
   "files": [
@@ -34,9 +34,7 @@
     "url": "git+https://github.com/Cle2ment/opencode-windows-encoding.git"
   },
   "license": "AGPL-3.0",
-  "dependencies": {
-    "@opencode-ai/plugin": "^1.17.0"
-  },
+  "dependencies": {},
   "devDependencies": {
     "@types/node": "^22.0.0",
     "tsup": "^8.0.0",

package.json

@@ -1,27 +1,38 @@
-import type { Plugin } from "@opencode-ai/plugin"
+/**
+ * OpenCode Plugin — UTF-8 Encoding Fix for Windows + PowerShell
+ *
+ * 单文件插件，可直接复制到 ~/.config/opencode/plugins/ 使用，无需 npm install。
+ *
+ * 工作原理：拦截所有 bash/shell 工具调用，在命令前注入 PowerShell
+ * UTF-8 编码配置，解决 Windows 下中文/非 ASCII 字符乱码问题。
+ */
+
 import { appendFileSync } from "node:fs"
 import { tmpdir } from "node:os"
 import { join } from "node:path"
 
+// ── 调试日志（写入临时目录） ──
 const LOG = join(tmpdir(), "utf8-plugin.log")
 function flog(msg: string) {
   try { appendFileSync(LOG, `[${new Date().toISOString()}] ${msg}\n`, "utf8") } catch {}
 }
 
-export const Utf8EncodingPlugin: Plugin = async () => {
-  flog("=== LOADED ===")
+// ── PowerShell UTF-8 编码前缀 ──
+const UTF8_ENC =
+  "[Console]::OutputEncoding=[Console]::InputEncoding=[Text.Encoding]::UTF8;$OutputEncoding=[Text.Encoding]::UTF8;"
 
-  function stripSetPrefixes(cmd: string): { prefixes: string; cleanCmd: string } {
-    const m = cmd.match(/^((?:set\s+\w+="[^"]*"\s*&&\s*)+)/)
-    if (m) return { prefixes: m[1], cleanCmd: cmd.slice(m[1].length) }
-    return { prefixes: "", cleanCmd: cmd }
-  }
+/** 提取 opencode 在命令前追加的 set VAR="value" && 前缀 */
+function stripSetPrefixes(cmd: string): { prefixes: string; cleanCmd: string } {
+  const m = cmd.match(/^((?:set\s+\w+="[^"]*"\s*&&\s*)+)/)
+  if (m) return { prefixes: m[1], cleanCmd: cmd.slice(m[1].length) }
+  return { prefixes: "", cleanCmd: cmd }
+}
 
-  const UTF8_ENC = "[Console]::OutputEncoding=[Console]::InputEncoding=[Text.Encoding]::UTF8;$OutputEncoding=[Text.Encoding]::UTF8;"
+export const Utf8EncodingPlugin = async () => {
+  flog("=== LOADED ===")
 
   return {
-    // ── LLM 工具调用 (bash/shell) ──
-    "tool.execute.before": async (input, output) => {
+    "tool.execute.before": async (input: Record<string, unknown>, output: Record<string, unknown>) => {
       const tool = String(input?.tool ?? "")
       flog(`[tool.before] tool="${tool}"`)
 
@@ -39,10 +50,11 @@ export const Utf8EncodingPlugin: Plugin = async () => {
       const { prefixes, cleanCmd } = stripSetPrefixes(cmd)
       flog(`  orig: ${cleanCmd.slice(0, 120)}`)
 
+      // 防止重复注入
       if (cleanCmd.includes("OutputEncoding")) { flog("  skip (idempotent)"); return }
 
       args.command = prefixes + UTF8_ENC + cleanCmd
-      flog(`  INJECTED`)
+      flog("  INJECTED")
     },
   }
 }

src/index.ts

@@ -1,11 +1,10 @@
 import { defineConfig } from "tsup"
 
 export default defineConfig({
-  entry: ["src/index.ts"],
+  entry: ["src/utf8-encoding.ts"],
   format: ["esm"],
   dts: true,
   clean: true,
-  external: ["@opencode-ai/plugin"],
   target: "node18",
   outDir: "dist",
   sourcemap: true,