# 给不懂代码的人看的说明

一页纸讲完这个插件做什么、不做什么、会碰你什么、出错怎么退。全文没有一行代码。

## 一句话

它让 AI 能"翻开" asar 和 zip 这类打包文件，看里面有什么、某个文件写了什么、哪个文件里提到了某个词。**只看，不改。**

（asar 是 Electron 桌面应用打包自己代码用的格式；zip 就是常见的压缩包。）

## 它能做三件事

1. **列清单** —— 告诉我这个包里有哪些文件、各有多大。
2. **读一个文件** —— 把其中某个文件的内容读出来；太大就截断，并明确说明截断了。
3. **搜内容** —— 在这个包的所有文本文件里搜一个词或一句话，告诉我哪个文件、第几行命中。

## 它不做什么（这部分比上面重要）

- **不写、不改、不删任何文件**。整份代码只以只读方式打开文件，没有任何写文件的调用。
- **不联网**。不下载、不上传、不向外发送任何东西。
- **不改你的配置**。不动 DeepSeek Harness 的设置、插件列表、会话记录，也不碰你的笔记库。
- **不装别的东西**。零依赖，只用 Node 自带的两个模块，没有安装脚本——不存在"装的时候偷偷跑点东西"的环节。
- **不常驻**。没有后台进程，没有定时任务。你不调用它，它什么都不做。

## 它可能出的问题（也一并说清）

- 包很大时（比如上百 MB），搜内容要花几秒到几十秒；默认搜到 64 MB 就停，并在结果里写明"提前停止"。这是预算到了，不是它骗你说搜完了。
- 只认 asar 和 zip。其它格式（tar、7z、加密压缩包、ZIP64 格式）会**直接报错**，不会假装成功。
- 压缩包里用老编码（非 UTF-8）存的文件名，可能显示成乱码。
- 按字节截断中文时，可能把一个汉字切成半个，显示成乱码字符。

## 你怎么自己确认（不用懂代码）

三种办法，从快到慢：

1. **双击仓库根目录的 `verify.bat`**。它会跑完 17 项测试，最后打印"通过 17 / 失败 0"。你只需要看最后那个结论行——这一步把"作者说没问题"变成"你亲眼看见"。
2. **看这个仓库在 GitHub 上的绿勾**。每次代码有改动，GitHub 会自动重跑同一套测试，结果以徽章形式显示在仓库首页。
3. **问四个问题**。对任何 AI 写的东西都适用，不需要任何技术背景：
   - 它会不会改我的文件、删我的东西？
   - 它联网吗？把什么发出去了？
   - 它依赖谁？会不会顺手装一堆我看不懂的？
   - 我怎么退回去？

## 怎么装、怎么卸

装（把 `<profile>` 换成你在用的 profile，比如 `desktop` 或 `web`）：

```
dsh plugin --profile <profile> add github:XHXnb123/dsh-plugin-archive-reader
```

装完**完全重启** DeepSeek Harness 才生效（刷新页面不算）。

卸：

```
dsh plugin --profile <profile> remove dsh-plugin-archive-reader
```

重启即可，卸载不会留下东西。仓库删掉或转为私有，就等于从所有插件目录下架。

## 一句话的局限

这份说明是插件的作者写的，**不是第三方安全审计**。它能说明的是：这个插件是只读的、不联网的、零依赖的。被任何目录收录都不代表有人替你审计过它。