renmori gui
renmori gui 打开一个基于 Tkinter 的原生窗口,用于在不使用终端的情况下完成保护、校验与配置文件编辑。
图形界面自 1.1.0 起提供,它不实现独立的保护逻辑,而是以子进程方式调用与终端完全相同的 renmori protect 与 renmori verify 命令,因此插件自动下载、校验与 JSON 结果等行为与 CLI 一致。
语法
界面语言与 CLI 的规则相同:--lang 优先,其次为环境变量 RENMORI_LANG,再次为系统区域设置;图形界面提供中文与英文两种语言,其他区域设置下显示英文,--no-color 与 --quiet 对图形界面没有作用。
运行环境
Tkinter 随 CPython 一同发行,图形界面不引入任何额外依赖;未调用 renmori gui 时,CLI 不会导入 Tkinter,以下环境需要单独处理:
无法启动时,renmori gui 向 stderr 输出原因并以退出码 2 结束:
窗口结构
窗口包含「保护」「校验」「配置」三个标签页,底部为状态栏;状态栏依次显示「就绪」「运行中…」,任务结束后显示「✓ 完成」或「✗ 失败」,保存配置文件后显示保存路径。
「保护」与「校验」标签页下方各有一个日志区:任务开始时,日志区首行显示实际执行的完整命令(以 $ 开头),随后实时显示 CLI 的全部输出,包括 stderr 中的进度信息与 stdout 最后一行的 JSON 结果;这些内容即 CLI 的原始输出,可直接用于问题排查。
同一时间只能运行一个任务,任务运行期间对应按钮不可点击,请在任务结束前保持窗口打开。
保护
「保护」标签页对应 renmori protect。
路径
选项
「保护」标签页不提供排除清单与密钥来源设置;需要这些设置时,请在「配置」标签页生成 renmori.toml,再通过「配置文件 (-c)」指定,或将其保存到构建目录中由自动探测读取。
执行流程
- 点击「保护」后,图形界面弹出确认对话框,显示输入路径与输出路径
- 确认后,图形界面以
-y参数调用renmori protect,CLI 不再进行终端确认 - 完整保护首次运行时,插件会直接下载,不再单独征询;下载后的插件按 Release 的
SHA256SUMS校验并缓存,不希望联网时请设置RENMORI_PLUGIN或RENMORI_NO_DOWNLOAD=1,详见 保护强度与闭源插件 - 任务结束后,仅当退出码为 0 且 JSON 结果的
status为ok时,状态栏显示「✓ 完成」
成功后的发布指引会输出在日志区中,图形界面不提供 --no-hints、--quiet 与 --no-color 选项。
由于图形界面始终传入 -y,确认对话框是保护前的唯一确认步骤;原地保护会覆盖所选目录,请在确认前核对路径,并保留「不备份(原地)」为不勾选状态。
校验
「校验」标签页对应 renmori verify,通过「浏览…」选择由 renmori protect 生成的受保护构建目录,点击「校验」即可开始;校验内容与 CLI 相同,包括容器哈希、必需文件是否齐全,以及磁盘上是否残留明文脚本与封包,校验结果以 JSON 形式显示在日志区末尾。
配置
「配置」标签页是 renmori.toml 的表单编辑器,用于生成、打开与保存配置文件;它不会直接影响「保护」标签页的设置,保存后需在「保护」标签页通过「配置文件 (-c)」指定,或将文件放在构建目录中,各配置键的完整语义参阅 配置文件 renmori.toml。
表单字段
按钮
注意事项
- 预览区的文本仅供查看,「另存为…」会按表单内容重新生成并覆盖预览区,在预览区中的手动修改不会被保存
- 打开文件时,仅上表列出的键会被读入表单,其他键与注释在保存后不会保留
- 读取配置文件需要 Python 3.11+ 或已安装
tomli;无法解析时,图形界面会提示原因,并将原始文本载入预览区供查看 - 密钥字段仅记录环境变量名,切勿将密钥写入配置文件,CI 中的密钥管理参阅 CI 与密钥管理
故障排查
相关页面
renmori protect:全部参数、文件处理规则与执行流程renmori verify:校验项目与使用方式- 配置文件 renmori.toml:全部配置键与合并规则
- 保护强度与闭源插件:插件的获取、校验与缓存