帮助
三溪缩影使用帮助
安装、压缩、解压、看图、命令行和批量部署。
安装
- 双击下载好的 ThreebrookPack-版本-win-x64.msi。只装给当前用户，不弹管理员确认，程序在 %LOCALAPPDATA%\Programs\三溪缩影。
- 装好后资源管理器的右键菜单里多出三溪缩影的几项。Windows 11 的右键菜单默认折叠，它们在“显示更多选项”里。
- 菜单、文件类型名和界面跟随 Windows 显示语言（中文或英文）；查看器里也可以在“视图”菜单里切换语言。
软件还没有做代码签名。如果 Windows 提示“已保护你的电脑”，点“更多信息”，再点“仍要运行”。这台电脑以前为所有用户装过旧版本时，双击会提示先在“设置 › 应用”里卸载旧版本，或者用管理员命令行加 ALLUSERS=1 升级，见批量部署。
压缩
- 文件夹：右键文件夹 › “三溪缩影 压缩（打成 .iisz 包）” › 点“开始压缩”。在文件夹旁边生成“文件夹名.iisz”，子文件夹一起打进去。
- 单张图像：右键 BMP、TIFF 或 RAW › “三溪缩影 压缩”。在旁边生成“文件名.iis”。
- 可以同时选中几个文件夹或几张图像一起压缩，它们会放进同一个窗口处理。
- 默认保留原文件，和 ZIP 一样。勾选“压缩并核对后删除原文件”，包写好、逐个核对一致后才删；被占用、只读或压缩后被修改过的原文件不删。
- JPG、PNG 等压不小的文件原样放进包里，不会变大。包名已存在时生成“名字 (2).iisz”，不覆盖。
没有文件头的 RAW
相机直接存的 .raw 只有像素数据，没有宽高信息。三溪缩影会自动识别宽、高和像素格式（Mono8 / 10 / 12 / 16，以及 Mono10p、Mono12p、Mono12Packed 打包格式），按图像压缩。
识别只影响压缩比，不影响正确性：照样逐字节还原。想指定参数，在 .raw 旁边放一个同名的 .json 文件，例如 A01.raw 旁边的 A01.json：
{ "width": 2448, "height": 2048, "pixel_format": "Mono12p" }
查看器里打开 RAW 时如果显示得不对，点“宽高或格式不对？手动输入…”填参数。
解压
- 右键 .iisz 或 .iis › “三溪缩影 解压到此处”。.iisz 解出原来的文件夹，同名文件夹已存在时解到“名字 (2)”，不和原有文件混在一起；.iis 还原成旁边的原文件，原文件已存在时跳过。
- 右键一个文件夹 › “三溪缩影 解压其中的 .iis / .iisz”：把文件夹（含子文件夹）里的 .iis 全部还原、.iisz 全部解开。
- 每个文件都核对 SHA-256，修改时间也一并还原。核对不一致时报错，不留下文件。
看图
- 资源管理器切到“中图标”或“大图标”：.iis 显示图片本身，.iisz 显示前 4 张图的拼图，右下角带包图标。
- 双击 .iisz：像文件夹一样浏览，点图像就能看；“全部解压到此处”解出整个包，单张可以“另存为原文件”。
- 双击 .iis：直接看图，“另存为原文件”还原这一个文件。
- 查看器也能打开普通的 BMP、TIFF、RAW、PNG、JPEG：滚轮缩放、16 位窗宽窗位、按 Bayer 排列预览彩色、像素值读数。
- 浅色 / 深色跟随 Windows，也可以在“视图”菜单里选“外观：浅色 / 深色”（只对这次打开有效，不保存设置）。
命令行
安装后 iis-cli 在任何命令提示符里都能用，适合写批处理或计划任务：
| 命令 | 作用 |
|---|---|
| iis-cli pack D:\图像\批次1 | 打包成 D:\图像\批次1.iisz；加 --delete 核对后删除原文件 |
| iis-cli unpack 批次1.iisz | 解到包旁边；-o 目录 指定位置 |
| iis-cli list 批次1.iisz | 列出包里的文件 |
| iis-cli verify 批次1.iisz --deep | 完整校验：在内存里还原并核对 SHA-256，不写文件 |
| iis-cli compress 图像.bmp | 单个文件压缩成 图像.bmp.iis |
| iis-cli restore 目录 -r -o 输出目录 | 把 .iis 还原成原文件 |
命令行的提示信息目前只有中文。
批量部署
同一个 MSI 有两种装法：
| 装法 | 命令 | 程序位置 |
|---|---|---|
| 只装给当前用户（默认） | msiexec /i ThreebrookPack-版本-win-x64.msi /qn /l*v install.log | %LOCALAPPDATA%\Programs\三溪缩影 |
| 装给所有用户（管理员） | msiexec /i ThreebrookPack-版本-win-x64.msi /qn ALLUSERS=1 /l*v install.log | C:\Program Files\三溪缩影 |
- 可选参数 INSTALLFOLDER="D:\三溪缩影\" 指定程序目录，以后升级沿用。
- 退出码：0 成功；3010 成功但需要重启；1603 失败（看安装日志）；1638 已装了其他版本。装给所有用户时 1625 或日志里的权限错误，说明没有用管理员身份运行。
- 升级：直接安装新版本的 MSI，装法和程序目录沿用上次的。不能降级，要降级先卸载。
- 静默卸载：msiexec /x ThreebrookPack-版本-win-x64.msi /qn
- 不需要另装 VC++ 运行库或 .NET，没有后台服务，不需要授权文件。
卸载之后
- 在“设置 › 应用 › 三溪缩影”卸载。卸载只删除程序、右键菜单、文件关联、缩略图、开始菜单项和 PATH 里的程序目录，不碰任何图像、.iis 和 .iisz 文件。
- .iisz 是标准 ZIP 包（只存不压），任何解压软件都能打开。压不小的文件在包里就是原文件；“文件名.iis”可以用开源解码器 iis-decode（BSD-3-Clause）还原。建议把程序目录里的 iis-decode.exe 和压缩包放在一起备份。
- 重新安装三溪缩影后照常使用。
还有问题
写信到 support@threebrook.com，说一下 Windows 版本、三溪缩影版本（查看器的“帮助 › 关于三溪缩影”）、遇到的情况。如果是某类图像压不好或打不开，可以说明格式、位深和尺寸；请不要发送涉及客户保密的图像。