dsh-autodetect 0.1.0 → 0.2.0

package/README.md

@@ -8,6 +8,7 @@
 <p align="center">
   <a href="https://github.com/Xiaoph123/dsh-autodetect"><img src="https://img.shields.io/badge/DeepSeek-Harness%20Web-4b6bfb" alt="DeepSeek Harness Web"></a>
   <a href="https://www.npmjs.com/package/dsh-autodetect"><img src="https://img.shields.io/npm/v/dsh-autodetect" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/dsh-autodetect"><img src="https://img.shields.io/npm/dm/dsh-autodetect" alt="npm downloads"></a>
   <a href="https://github.com/Xiaoph123/dsh-autodetect/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT license"></a>
 </p>
 
@@ -33,48 +34,27 @@ Windows 工具链里，`.bat`、`.cmd`、`.ini`、`.vbs` 和 `.ps1` 经常混用
 
 ### 推荐：通过 npm 包安装
 
-先确认已安装 Node.js、Python 3.10+ 和 DeepSeek Harness Web。发布到 npm 后，推荐直接执行这一条命令：
+当前 TypeScript 版本 `0.2.0` 已发布到 [npm](https://www.npmjs.com/package/dsh-autodetect)。它不再需要 Python；先确认已安装 Node.js 和 DeepSeek Harness Web，然后推荐直接执行这一条命令：
 
 ```powershell
-dsh plugin --profile web install dsh-autodetect --replace --yes
+dsh plugin --profile web add dsh-autodetect
 ```
 
 `dsh` 会从 npm 获取 `dsh-autodetect`，并把它注册到 **Harness Web 官方侧边栏**。安装或更新后重启 Harness Web。
 
-如果你的 `dsh` 版本不支持从 npm 包名解析，也可以先下载包再使用本地目录：
+如果你的 `dsh` 版本不支持从 npm 包名解析，可以先下载包再使用本地目录：
 
 ```powershell
 npm install dsh-autodetect
-dsh plugin --profile web install .\node_modules\dsh-autodetect --replace --yes
+dsh plugin --profile web add .\node_modules\dsh-autodetect
 ```
 
-> 如果当前版本的 `dsh` CLI 不接受 npm 包名，请使用兼容方式：
->
-> ```powershell
-> git clone https://github.com/Xiaoph123/dsh-autodetect.git
-> dsh plugin --profile web install .\dsh-autodetect --replace --yes
-> ```
-
 ### 开发链接安装
 
 ```powershell
 git clone https://github.com/Xiaoph123/dsh-autodetect.git
 cd dsh-autodetect
-dsh plugin --profile web install . --link --replace --yes
-```
-
-### Python 依赖
-
-插件后端需要 `charset-normalizer`：
-
-```powershell
-py -3 -m pip install -r requirements.txt
-```
-
-如果 Harness 使用的不是默认 Python，可以指定：
-
-```powershell
-$env:AUTODETECT_PYTHON = 'C:\Path\To\python.exe'
+dsh plugin --profile web add .
 ```
 
 ## 使用
@@ -91,7 +71,7 @@ $env:AUTODETECT_PYTHON = 'C:\Path\To\python.exe'
 插件由两个部分组成：
 
 - **Node.js Host**：注册 `/autodetect/api/read` 和 `/autodetect/api/write`，执行会话工作区校验、SHA-256 并发检查和备份。
-- **Python Codec Helper**：读取原始字节，检测编码、BOM 和换行格式，并按元数据原子写回。
+- **TypeScript Codec**：使用 Node.js Buffer 和 `iconv-lite` 读取原始字节，检测编码、BOM 和换行格式，并按元数据原子写回。
 
 客户端通过 Harness 官方 Sidebar slots 注册文件标签页，只匹配 `dsh-resource://file/**` 下的目标扩展名。
 
@@ -99,17 +79,17 @@ $env:AUTODETECT_PYTHON = 'C:\Path\To\python.exe'
 
 ```text
 dsh-autodetect/
-├─ lib/
-│  ├─ index.js             # Host 路由和 Python Helper 调用
-│  └─ client.js            # Harness 官方 Sidebar 文件标签页
-├─ python/
-│  └─ autodetect_codec.py  # 编码检测、读取和写入
+├─ src/
+│  ├─ host/                 # Node.js Host 路由与会话工作区校验
+│  ├─ codec/                # TypeScript 编码检测、读取和写入
+│  └─ client/               # Harness 官方 Sidebar 文件标签页
+├─ lib/                     # 构建后的 JavaScript 文件
 ├─ tests/
-│  ├─ test_codec.py        # 编码与文件写入测试
+│  ├─ codec.test.mjs       # 编码与文件写入测试
 │  └─ test_package.mjs     # npm 元数据和 README 回归测试
 ├─ cordis.patch.yml        # DSH Web 插件挂载配置
 ├─ package.json
-├─ requirements.txt
+├─ tsconfig.json
 └─ README.md
 ```
 
@@ -121,9 +101,9 @@ npm run pack:check
 node --check lib\index.js
 ```
 
-`npm run pack:check` 会检查最终 npm 包内容，不会把 `node_modules`、Python 缓存或备份文件打进去。
+`npm run pack:check` 会检查最终 npm 包内容，不会把 `node_modules`、源代码、测试、缓存或备份文件打进去。
 
-## 发布
+## 维护者发布
 
 维护者登录 npm 后执行：
 
@@ -132,6 +112,8 @@ npm login
 npm publish --access public
 ```
 
+当前公开包地址：<https://www.npmjs.com/package/dsh-autodetect>
+
 发布新版本前先更新 `package.json` 中的版本号，并运行：
 
 ```powershell
@@ -150,9 +132,9 @@ npm publish --access public
 
 这是 SHA-256 并发保护触发。重新打开文件、确认内容后再保存，避免覆盖其他程序的修改。
 
-### Python 依赖找不到
+### 旧版本为什么需要 Python？
 
-使用 Harness 实际调用的 Python 解释器安装 `requirements.txt`，必要时设置 `AUTODETECT_PYTHON`。
+`0.1.x` 是历史 Python 版本；从 `0.2.0` 开始，编码检测和文件写回已经迁移到 TypeScript/Node.js，不再需要 Python 或 `charset-normalizer`。
 
 ## 许可证
 
@@ -160,4 +142,4 @@ npm publish --access public
 
 ## 反馈与贡献
 
-欢迎通过 [GitHub Issues](https://github.com/Xiaoph123/dsh-autodetect/issues) 提交问题。反馈时请注明 Harness Web 版本、Node.js/Python 版本，以及是否使用了官方侧边栏宿主。
+欢迎通过 [GitHub Issues](https://github.com/Xiaoph123/dsh-autodetect/issues) 提交问题。反馈时请注明 Harness Web 版本、Node.js 版本，以及是否使用了官方侧边栏宿主。