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,只监听本机,不会对局域网开放。 · 不做开机自启、自动更新;需要新版本时重新下载解压覆盖(先关掉旧窗口)。 文件名里的数字就是版本号,换新版本请用文件名最大的那个。 · 需要联网登录网站;小助手本身不联网,也不会改系统防火墙。