Mindo 本地小助手 · 安装与使用说明
（Windows / macOS，2026-10-22 第一版；2026-10-23 补充浏览器本地网络授权说明）

〇、先看这里：第一次打开可能被拦（点「允许」就行）
  双击启动时，Windows 可能弹「Windows 已保护你的电脑」或杀毒软件弹「是否允许运行」。
  这是正常的：我们没买数字签名证书，系统对"不认识"的程序都会问一次。
  · 会看到的名字只有三个：启动小助手.bat、node.exe、sharp-win32-x64.node（图片加速用）
  · 处理：Windows Defender 点「更多信息」→「仍要运行」；
          360 / 火绒 点「允许程序运行」/「允许」。
  · 大多数杀毒软件会记住这次选择，以后不再问。
  · 如果点了「阻止」或者文件直接不见了：去杀毒软件的「隔离区 / 恢复区」把文件恢复，
    再把解压出来的整个文件夹加入信任（白名单），重新双击启动。
  · 还不行：打开本地页面 http://127.0.0.1:5199/ ，点「复制诊断信息」发给技术支持。

一、它是什么
  本地小助手只在这台电脑上运行，负责选择资料保存位置、读写本地文件、生成 Excel、
  打开文件/所在文件夹。资料不上传到任何服务器；网站只负责账号与授权。

二、Windows（Windows 10/11，64 位）
  1. 下载 MindoHelper-1.0.2-Windows-x64.zip。
  2. 右键压缩包 →「全部解压缩」；不要直接在压缩包里双击。解压后是一个
     MindoHelper-1.0.2-Windows-x64 文件夹，里面的文件要放在一起，不要只复制一个文件。
  3. 双击「启动小助手.bat」。
     · 如果出现「Windows 已保护你的电脑」：点「更多信息」→「仍要运行」。
     · 会打开一个黑色控制台窗口并保持不关；随后自动打开本地工作台
       http://127.0.0.1:5199/ 。若浏览器没自动打开，手动访问这个地址。
  4. 在本地工作台页面上找到「配对令牌」，点复制。
  5. 打开 https://外贸工作台.top 并登录；再打开直达链接
     https://外贸工作台.top/?connect=1 ——会自动跳到首页步骤条「② 连接本地保存位置」。
     （也可点首页引导条的「连接本地小助手」，或自己进「设置」页。）
     粘贴令牌后点「连接本地小助手」。
     · 浏览器会问「是否允许访问本地网络 / 此设备上的其他应用和服务」→ 点「允许」。
       如果点了「屏蔽」：点地址栏左侧的网站图标 → 网站设置 → 允许本地网络访问，再回网站点「重试连接」。
  6. 点「选择保存位置」，选中你平时放产品、报价、订单资料的文件夹。确认后
     四个模块才会打开；页面只显示文件夹名，不显示完整路径。
  7. 停止：关闭那个黑色控制台窗口即可。写入文件时不要突然关窗口。

三、macOS（Apple 芯片 / Intel 都可用）
  1. 下载 MindoHelper-1.0.2-macOS-universal.zip，双击解压。
  2. 双击「启动小助手.command」。
     · 如果提示「无法打开，因为无法验证开发者」：右键该文件 →「打开」→ 再点「打开」。
     · 如果仍被拦：打开“终端”，执行（把路径换成你解压后的文件夹）：
         xattr -dr com.apple.quarantine "/路径/MindoHelper-1.0.2-macOS"
       然后再双击。
     · 会打开一个终端窗口并保持不关；随后自动打开 http://127.0.0.1:5199/ 。
  3. 复制本地工作台页面上的「配对令牌」。
  4. 打开 https://外贸工作台.top 并登录；再打开直达链接
     https://外贸工作台.top/?connect=1 ——会自动跳到首页步骤条「② 连接本地保存位置」。
     （也可点首页引导条的「连接本地小助手」，或自己进「设置」页。）
     粘贴令牌后点「连接本地小助手」。
     · 浏览器会问「是否允许访问本地网络 / 此设备上的其他应用和服务」→ 点「允许」。
       如果点了「屏蔽」：点地址栏左侧的网站图标 → 网站设置 → 允许本地网络访问，再回网站点「重试连接」。
  5. 点「选择保存位置」，选中资料文件夹；确认后四个模块打开。
  6. 停止：关闭终端窗口，或在该窗口按 Control+C。

四、常见问题
  · 控制台提示「端口 5199 被其他程序占用」：
    说明已经有一个小助手/其他程序占着这个端口。先关掉另一个小助手窗口再启动；
    需要查是谁占用时：
      Windows：netstat -ano | findstr :5199
      macOS  ：lsof -nP -iTCP:5199 -sTCP:LISTEN
  · 双击了两次：第二份不会重复启动，只会再打开一次本地页面；保留一个控制台窗口即可。
  · 网站显示「还没有连接本地小助手」：先确认控制台窗口还开着、地址能打开；再到
    本地页面复制当前的配对令牌重新粘贴。换过安装包或换过电脑后需要重新配对。
  · 换电脑/换文件夹：资料在你自己选的文件夹里；换电脑时把该文件夹一起带过去，
    在新电脑上重新选一次保存位置即可。
  · 换电脑要验证码：一个账号同一时间只能用在一台电脑上。在新电脑上第一次连上时，
    要填一次发到「账号绑定邮箱」的验证码；填完旧电脑会自动停用，但资料不会被改动。
    换回来也一样要一次验证码——这是有意的，防止一个账号被多人共用。
    换完之后旧电脑就别再改东西了：两台各有一份文件夹，改动不会互相同步，也没法合并。
    压缩包在 Windows 上建议用 7-Zip 解压，自带解压偶尔会把中文文件名弄乱。
  · 杀毒软件提示 node.exe：这是随包附带的 Node 官方运行时（版本见文件夹内
    runtime\NODE-VERSION.txt），需要允许它运行，否则小助手起不来。
  · 图片打开很慢：打开本地页面 http://127.0.0.1:5199/ 看「运行自检」里的「图片加速」。
    显示「不可用」说明图片加速组件没加载成功（多半被杀毒拦了），功能不受影响，只是慢一点；
    按上面〇的做法恢复文件即可。
  · 遇到任何打不开/没反应：先打开本地页面点「运行自检」，六项里哪项是「异常」就按后面的
    「处理」做；还不行点「导出诊断包」，把那个 txt 发给技术支持（里面不含你的文件内容）。

五、文件放在哪
  · 业务资料：只在你选择的「保存位置」文件夹里。
  · 图片预览小图（缩略图）：为了让图片列表打开更快，小助手会另外存一套缩小版预览图，
    位置在小助手自己的目录（Windows：%APPDATA%\MindoHelper\thumb-cache；
    macOS：~/Library/Application Support/MindoHelper/thumb-cache），
    **不在你的资料文件夹里、也不进备份**。删掉它会自动重建，不影响原图。
  · 运行日志：同一目录下的 logs\，保留 7 天，只记录错误码与工作区内的相对路径，
    不记录你的文件内容。
  · 小助手自己的设置（端口、配对令牌、保存位置）：
      Windows：%APPDATA%\MindoHelper\config.json
      macOS  ：~/Library/Application Support/MindoHelper/config.json
    这个文件只在本机，权限仅当前用户可读；不要把它发给别人。
  · 卸载：先关闭小助手，删除解压出来的整个文件夹即可；业务资料不会被删除。
    如需彻底清除设置，再删除上面那个 MindoHelper 配置文件夹。

六、这一版的已知限制
  · 安装包未做代码签名：Windows SmartScreen / macOS Gatekeeper 首次打开会有提示，
    按上面的方法放行即可。
  · Windows 版是 64 位；macOS 版同时带 Apple 芯片与 Intel 两种运行时。
  · 固定使用本机 127.0.0.1:5199，只监听本机，不会对局域网开放。
  · 不做开机自启、自动更新；需要新版本时重新下载解压覆盖（先关掉旧窗口）。
    文件名里的数字就是版本号，换新版本请用文件名最大的那个。
  · 需要联网登录网站；小助手本身不联网，也不会改系统防火墙。
