encoding-aware-fs 0.1.5 → 0.1.7

package/README.md

@@ -11,8 +11,9 @@ AI 编码助手默认所有文件都是 UTF-8 编码，在读写 GB18030/GBK/GB2
 - **自动编码检测** — 读取文件时自动识别原始编码（GB18030/GBK/GB2312），返回 UTF-8 给 AI 工具
 - **透明回写** — 写入时自动将 UTF-8 内容转换回文件的原始编码
 - **行尾保持** — 检测并保持文件原有的 CRLF/LF 行尾格式，编辑后不会改变
+- **目录级编码规则** — 通过 glob 模式为不同目录指定不同编码（如 `openspec/**` 用 UTF-8，`legacy/**` 用 GBK）
 - **三个 MCP 工具**：`read_file`、`write_file`、`edit_file` — 替代内置文件操作工具
-- **一键安装/卸载** — 支持 Claude Code 和 OpenCode
+- **一键安装/卸载** — 支持 Claude Code 和 OpenCode，交互式配置编码规则
 
 ## 安装
 
@@ -41,6 +42,25 @@ npx encoding-aware-fs uninstall
 1. **读取时**：通过 BOM 和启发式算法检测文件编码，解码为 UTF-8 返回
 2. **写入/编辑时**：先读取原文件检测编码和行尾风格，在 UTF-8 下完成操作，写入前转回原编码并还原行尾格式
 
+## 项目配置
+
+项目根目录的 `.encoding-converter.json` 控制编码行为：
+
+```json
+{
+  "sourceEncoding": "GB18030",
+  "confidenceThreshold": 0.8,
+  "overrides": [
+    { "pattern": "openspec/**", "sourceEncoding": "UTF-8" },
+    { "pattern": "legacy/**", "sourceEncoding": "GBK" }
+  ]
+}
+```
+
+- `sourceEncoding`：检测不确定时的默认编码，也用于新建文件
+- `confidenceThreshold`：自动检测的最小置信度（0-1）
+- `overrides`：可选的目录级编码规则数组，每条规则包含 `pattern`（glob 模式）和 `sourceEncoding`；多个规则匹配时，最具体的模式优先
+
 ## 开发
 
 ```bash

package/dist/index.js

@@ -29555,7 +29555,21 @@ function registerEditFile(server2, config3, allowedDirectories) {
         originalEncoding = resolvedSourceEncoding;
       }
       const utf8Content = isGBEncoding(originalEncoding) ? decodeToUtf8(buffer, originalEncoding) : buffer.toString("utf-8");
-      const modifiedContent = applyEditsToContent(utf8Content, args.edits);
+      let modifiedContent;
+      try {
+        modifiedContent = applyEditsToContent(utf8Content, args.edits);
+      } catch (editError) {
+        const message = editError instanceof Error ? editError.message : String(editError);
+        return {
+          content: [{
+            type: "text",
+            text: `Error: ${message}
+
+To fix this: call read_file with path "${args.path}" to get the current file content, then retry the edit with the exact text from the file. Do NOT use the built-in Edit tool \u2014 always use encoding-aware-fs MCP tools.`
+          }],
+          isError: true
+        };
+      }
       const diff = createUnifiedDiff(utf8Content, modifiedContent, args.path);
       if (!args.dryRun) {
         const finalContent = restoreLineEndings(modifiedContent, originalLineEnding);
@@ -29978,8 +29992,9 @@ overrides: ${existingConfig.overrides.length} rule(s)` : ""}`,
     confidenceThreshold = existingConfig.confidenceThreshold ?? 0.8;
     overrides = existingConfig.overrides ?? [];
   } else {
-    sourceEncoding = await clack2.text({
+    sourceEncoding = await clack2.autocomplete({
       message: "Default source encoding",
+      options: ENCODING_OPTIONS,
       initialValue: "GB18030"
     });
     if (clack2.isCancel(sourceEncoding)) {
@@ -30019,8 +30034,9 @@ overrides: ${existingConfig.overrides.length} rule(s)` : ""}`,
         clack2.cancel("Cancelled");
         process.exit(0);
       }
-      const encoding = await clack2.text({
+      const encoding = await clack2.autocomplete({
         message: `Source encoding for ${pattern}`,
+        options: ENCODING_OPTIONS,
         initialValue: "UTF-8"
       });
       if (clack2.isCancel(encoding)) {
@@ -30104,7 +30120,7 @@ async function runInstaller() {
   await promptEncodingConfig(cwd);
   clack2.outro("\u5B89\u88C5\u5B8C\u6210\uFF01\u8BF7\u91CD\u542F Claude Code / OpenCode \u4EE5\u751F\u6548");
 }
-var fs10, path6, import_child_process2, import_util6, clack2, execFileAsync;
+var fs10, path6, import_child_process2, import_util6, clack2, ENCODING_OPTIONS, execFileAsync;
 var init_installer = __esm({
   "src/installer.ts"() {
     "use strict";
@@ -30114,6 +30130,15 @@ var init_installer = __esm({
     import_util6 = require("util");
     clack2 = __toESM(require("@clack/prompts"));
     init_config_io();
+    ENCODING_OPTIONS = [
+      { value: "GB18030", label: "GB18030 (\u4E2D\u6587\u9ED8\u8BA4)" },
+      { value: "GBK", label: "GBK" },
+      { value: "GB2312", label: "GB2312" },
+      { value: "UTF-8", label: "UTF-8" },
+      { value: "Big5", label: "Big5 (\u7E41\u4F53\u4E2D\u6587)" },
+      { value: "Shift_JIS", label: "Shift_JIS (\u65E5\u6587)" },
+      { value: "EUC-KR", label: "EUC-KR (\u97E9\u6587)" }
+    ];
     execFileAsync = (0, import_util6.promisify)(import_child_process2.execFile);
   }
 });

package/dist/server.js

@@ -28746,7 +28746,21 @@ function registerEditFile(server2, config3, allowedDirectories) {
         originalEncoding = resolvedSourceEncoding;
       }
       const utf8Content = isGBEncoding(originalEncoding) ? decodeToUtf8(buffer, originalEncoding) : buffer.toString("utf-8");
-      const modifiedContent = applyEditsToContent(utf8Content, args.edits);
+      let modifiedContent;
+      try {
+        modifiedContent = applyEditsToContent(utf8Content, args.edits);
+      } catch (editError) {
+        const message = editError instanceof Error ? editError.message : String(editError);
+        return {
+          content: [{
+            type: "text",
+            text: `Error: ${message}
+
+To fix this: call read_file with path "${args.path}" to get the current file content, then retry the edit with the exact text from the file. Do NOT use the built-in Edit tool \u2014 always use encoding-aware-fs MCP tools.`
+          }],
+          isError: true
+        };
+      }
       const diff = createUnifiedDiff(utf8Content, modifiedContent, args.path);
       if (!args.dryRun) {
         const finalContent = restoreLineEndings(modifiedContent, originalLineEnding);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "encoding-aware-fs",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Encoding-aware file operations MCP Server for AI tools working with GB18030 projects",
   "main": "dist/server.js",
   "bin": {