endef 2.0.0 → 2.0.1

package/README.md

@@ -2,7 +2,7 @@
 
 `endef` 是一个纯 Node.js 的文件旁路转换工具。
 
-它适合这样的场景：某些常见源码或文本后缀的文件在系统读取、复制、粘贴、编辑器打开时出现乱码或异常，但通过 Node.js 脚本读取仍然正常。`endef` 会先把目标文件内容写到同目录的 `.endef` 副本里，再把 `.endef` 副本内容刷回原文件，并删除临时副本。
+它适合这样的场景：某些常见源码或文本后缀的文件在系统读取、复制、粘贴、编辑器打开时出现乱码或异常，但通过 Node.js 脚本读取仍然正常。`endef` 会先把目标文件内容写到同目录的 `.endef` 副本里，再删除原文件，并把 `.endef` 副本重命名回原文件名。
 
 示例：
 
@@ -20,7 +20,7 @@ README.md -> README.md.endef -> README.md
 - 默认旁路后缀为 `.endef`
 - `en` 默认转换所有匹配后缀的文件
 - `en --marker` 可以只转换命中 marker 的文件，marker 支持数组配置，也支持 CLI 手动指定多个
-- `de` 会把 `.endef` 内容写回原文件，并删除 `.endef` 临时副本
+- `de` 会删除原文件，并把 `.endef` 临时副本重命名回原文件名
 - `pack` 会把恢复后的目录打包成 `.tar.gz`
 - 不引入生产依赖
 
@@ -66,7 +66,7 @@ endef en /path/to/project --marker E-SafeNet --marker BadText
 endef en /path/to/project --marker E-SafeNet,BadText
 ```
 
-把 `.endef` 副本刷回原文件，并删除 `.endef`：
+删除原文件，并把 `.endef` 副本重命名回原文件名：
 
 ```bash
 endef de /path/to/project
@@ -107,11 +107,11 @@ endef all [directory] [options]
 
 `en` 会扫描目标目录，把匹配后缀的文件读取出来，并写成同目录的 `.endef` 副本。
 
-`de` 会扫描目标目录中的 `.endef` 文件，把副本内容写回原文件，然后删除 `.endef` 副本。这个命令会直接修改文件，请在执行前确认目录和备份策略。
+`de` 会扫描目标目录中的 `.endef` 文件，删除对应的原文件，然后把 `.endef` 副本重命名回原文件名。这个命令会直接修改文件，请在执行前确认目录和备份策略。
 
 `pack` 会按当前配置扫描当前目录，把没有被 `excludeDirs` 排除的文件打包成 `.tar.gz`。如果输出文件已存在，会直接覆盖。
 
-`all` 会按顺序执行 `en`、`de`、`pack`，适合确认配置后一次性完成旁路转换、写回和打包。
+`all` 会按顺序执行 `en`、`de`、`pack`，适合确认配置后一次性完成旁路转换、重命名恢复和打包。
 
 ## 参数
 
@@ -222,19 +222,13 @@ endef en . --marker E-SafeNet --marker BadText
 file.ext.endef
 ```
 
-写回：
+删除原文件后重命名为：
 
 ```text
 file.ext
 ```
 
-然后删除：
-
-```text
-file.ext.endef
-```
-
-如果 `file.ext` 已经存在，会被 `.endef` 副本内容覆盖。这个行为符合工具的核心假设：原文件可能已经被异常内容污染，而 `.endef` 是通过旁路读取保存出来的可恢复内容。
+如果 `file.ext` 已经存在，会先被删除，然后由 `.endef` 副本重命名得到新的 `file.ext`。这个行为符合工具的核心假设：原文件可能已经被异常内容污染，而 `.endef` 是通过旁路读取保存出来的可恢复内容。
 
 ## 打包策略
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "endef",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Recover text and source files through safe .endef sidecar copies.",
   "bin": {
     "endef": "bin/main.js"

package/src/de.js

@@ -30,26 +30,39 @@ async function restoreFiles(directory, options = {}) {
   })
 
   await Promise.all(tasks)
-  console.log(`Done. restored=${stats.restored}, deleted=${stats.deleted}, failed=${stats.failed}`)
+  console.log(`Done. restored=${stats.restored}, removed=${stats.removed}, renamed=${stats.renamed}, failed=${stats.failed}`)
   return stats
 }
 
 async function restoreOne(filePath, config, stats) {
   const targetPath = filePath.slice(0, -config.suffix.length)
-  const data = await fs.readFile(filePath, 'utf8')
+  const targetExists = await exists(targetPath)
 
-  await fs.writeFile(targetPath, data, 'utf8')
-  await fs.rm(filePath, { force: true })
+  await fs.rm(targetPath, { force: true })
+  await fs.rename(filePath, targetPath)
 
   stats.restored += 1
-  stats.deleted += 1
+  if (targetExists) {
+    stats.removed += 1
+  }
+  stats.renamed += 1
   console.log(`Restored: ${filePath} -> ${targetPath}`)
 }
 
+async function exists(filePath) {
+  try {
+    await fs.access(filePath)
+    return true
+  } catch (error) {
+    return false
+  }
+}
+
 function createStats() {
   return {
     restored: 0,
-    deleted: 0,
+    removed: 0,
+    renamed: 0,
     failed: 0
   }
 }