安装、备份与文件核对
现在
偶尔用
截至 11 月 4 日 · 项目源码和只读核对

更新主题时留下原先版本,避免影响自己安装的其他主题。

当前情况:两份主题文件都和源码一致(11 月 4 日 09:10 只读核对通过),不用重装;更新会保留旧文件,但恢复旧版仍需明确选择备份。

项目源码:公开仓库

安装、备份与文件核对
现在
偶尔用
截至 11 月 4 日 · 项目源码和只读核对

更新主题时留下原先版本,避免影响自己安装的其他主题。

当前情况:两份主题文件都和源码一致(11 月 4 日 09:10 只读核对通过),不用重装;更新会保留旧文件,但恢复旧版仍需明确选择备份。

项目源码:公开仓库

这项功能怎样使用

用途与实际影响

为什么需要它

整个 themes 目录可能还有其他主题,直接覆盖或清空很容易误伤;同名 Verdant 文件也可能有手工修改。

举个实际例子

把主题更新为当前版,但留下旧的 Verdant。脚本比较摘要,有差异就先复制到 old-themes,随后只更新两份专属 CSS。

最后我会得到什么

得到安装与核对报告,能找到旧文件备份;恢复旧版需要明确选择备份并恢复,脚本没有独立 restore 命令。

这项功能怎样使用

用途与实际影响

为什么需要它

整个 themes 目录可能还有其他主题,直接覆盖或清空很容易误伤;同名 Verdant 文件也可能有手工修改。

举个实际例子

把主题更新为当前版,但留下旧的 Verdant。脚本比较摘要,有差异就先复制到 old-themes,随后只更新两份专属 CSS。

最后我会得到什么

得到安装与核对报告,能找到旧文件备份;恢复旧版需要明确选择备份并恢复,脚本没有独立 restore 命令。

结果怎么看
正常时

两份本项目主题文件都与当前源版本一致。11 月 4 日核对就是这样。

发现问题时

旧版本与当前版不同时先留备份,再逐份更新并核对;verify 报不一致就重跑 install。

入口不可用或证据不足时

找不到默认主题目录时请本人指定;目录不可写则说明原因,不清空其他主题。

结果怎么看
正常时

两份本项目主题文件都与当前源版本一致。11 月 4 日核对就是这样。

发现问题时

旧版本与当前版不同时先留备份,再逐份更新并核对;verify 报不一致就重跑 install。

入口不可用或证据不足时

找不到默认主题目录时请本人指定;目录不可写则说明原因,不清空其他主题。

从哪里开始

运行 python tools/install_theme.py install,可用 --theme-dir 指定 Typora 主题目录;随后运行 python tools/install_theme.py verify 并在 Typora 切换检查。

需要准备什么
  • 是否安装或核对 Verdant Mint
  • 使用非默认主题目录时给出目标目录
从开始到拿到结果
1比较原有文件
只看本项目文件的摘要与差异,不覆盖无关主题。
2备份再安装
差异旧版先留备份,新文件再原子替换。
3核对安装与显示
verify 查文件;Typora 中仍要手动选择和看页面,想撤回需用对应备份。
从哪里开始

运行 python tools/install_theme.py install,可用 --theme-dir 指定 Typora 主题目录;随后运行 python tools/install_theme.py verify 并在 Typora 切换检查。

需要准备什么
  • 是否安装或核对 Verdant Mint
  • 使用非默认主题目录时给出目标目录
从开始到拿到结果
1比较原有文件
只看本项目文件的摘要与差异,不覆盖无关主题。
2备份再安装
差异旧版先留备份,新文件再原子替换。
3核对安装与显示
verify 查文件;Typora 中仍要手动选择和看页面,想撤回需用对应备份。
技术实现与依据(一)

这里保留实现、关键条件、精确入口、历史记录和验证结果。

2026-11-04 verify:两份 CSS 都和源码一致,verified=true;本次没有重装(10 月 11 日那次共享 CSS 不一致、verified=false)

关键规则与设计选择
1
默认目录来自 Windows APPDATA/Typora/themes,也接受明确 --theme-dir。
2
不触碰无关主题、程序、注册表或许可。
3
verify 只读;安装成功和当前选中主题分别判断。
当前怎样实现
  • install_theme.py 只管 verdant-mint.css 和 verdant/base.css 两份文件,对每份算源码和安装摘要,不同则 backup_existing 到 old-themes 的对应子目录并使用时间戳后缀。现在还留着一份 2026-08-02 07:02 的共享样式备份,不是这次新增的。
  • atomic_copy 先写同目录临时文件,copy2 后 os.replace;verify 返回 typora-theme-pack.install.v1 和逐文件 matches。脚本只有 install 和 verify 两个动作,没有 restore。
技术实现与依据(一)

这里保留实现、关键条件、精确入口、历史记录和验证结果。

2026-11-04 verify:两份 CSS 都和源码一致,verified=true;本次没有重装(10 月 11 日那次共享 CSS 不一致、verified=false)

关键规则与设计选择
1
默认目录来自 Windows APPDATA/Typora/themes,也接受明确 --theme-dir。
2
不触碰无关主题、程序、注册表或许可。
3
verify 只读;安装成功和当前选中主题分别判断。
当前怎样实现
  • install_theme.py 只管 verdant-mint.css 和 verdant/base.css 两份文件,对每份算源码和安装摘要,不同则 backup_existing 到 old-themes 的对应子目录并使用时间戳后缀。现在还留着一份 2026-08-02 07:02 的共享样式备份,不是这次新增的。
  • atomic_copy 先写同目录临时文件,copy2 后 os.replace;verify 返回 typora-theme-pack.install.v1 和逐文件 matches。脚本只有 install 和 verify 两个动作,没有 restore。
技术实现与依据(二)
1
定位明确主题目录
2
逐文件比对摘要
3
差异旧版先备份
4
原子替换本项目文件
5
verify 核对
  • 导出菜单和项目路径绑定:项目搬家后要重跑 configure_typora_menu.py;菜单启动器每次按 PCConfig 登记读取 Python。开发配置备份仍登记了 Typora 的整个用户配置目录(含主题、旧主题备份和菜单配置)。
执行流程
技术实现与依据(二)
1
定位明确主题目录
2
逐文件比对摘要
3
差异旧版先备份
4
原子替换本项目文件
5
verify 核对
  • 导出菜单和项目路径绑定:项目搬家后要重跑 configure_typora_menu.py;菜单启动器每次按 PCConfig 登记读取 Python。开发配置备份仍登记了 Typora 的整个用户配置目录(含主题、旧主题备份和菜单配置)。
执行流程
名词和入口
本模块用到的名词
名词意思
幂等安装重复执行同一版本不会要求用户清空目录。
专业定义

只动自己的两份 CSS,替换前保留旧版

名词和入口
本模块用到的名词
名词意思
幂等安装
意思:
重复执行同一版本不会要求用户清空目录。
专业定义

只动自己的两份 CSS,替换前保留旧版

出问题时

解决什么

每个文件原子替换,不代表两份文件是一次整体事务;中断后可再次运行安装与 verify 收敛。

边界
  • 默认目录为 Windows 路线;显式目录不等于完整跨平台产品验收。
  • 没有自动激活主题或专门回滚命令。
失败与恢复
  • 写入中断或两文件不一致: 保留可用旧版/备份,按逐文件结果重跑收敛。
出问题时

解决什么

每个文件原子替换,不代表两份文件是一次整体事务;中断后可再次运行安装与 verify 收敛。

边界
  • 默认目录为 Windows 路线;显式目录不等于完整跨平台产品验收。
  • 没有自动激活主题或专门回滚命令。
失败与恢复
  • 写入中断或两文件不一致: 保留可用旧版/备份,按逐文件结果重跑收敛。
依据与来源
真实入口
  • 精确安装与核对
如何验证
  • 2026-11-04 09:10 只读 verify:退出 0、verified=true;verdant-mint.css 源和已装都是 e6931a680015dd427aa9981ba201858a31359f8415a5e06a07d48baefc934cae,verdant/base.css 都是 29465c7a5bdd2f3a671561949ad754569df3ea0bb8e97806374e281a826ed8b9;profile.data 当前主题指向 verdant-mint.css,这和 verify 结果是两件事。这次没有重装,说不清是哪天装齐的;Typora 实际画面也没有看。
  • 2026-10-11 16:31 只读 verify:入口 CSS 源码与已装 SHA-256 一致,共享 CSS 不一致,verified=false;这是当时的状态。没有重装、恢复或清理备份。
  • 隔离安装测试确认无关主题保留(历史);该测试仍在源码里,2026-09-29 01:51 GitHub 自动测试日志显示它通过,这次没有运行。开发配置备份和新电脑恢复这次也没有执行。
与其他模块的关系

负责文件到位,编辑器负责选择并加载主题。

依据与来源
真实入口
  • 精确安装与核对
如何验证
  • 2026-11-04 09:10 只读 verify:退出 0、verified=true;verdant-mint.css 源和已装都是 e6931a680015dd427aa9981ba201858a31359f8415a5e06a07d48baefc934cae,verdant/base.css 都是 29465c7a5bdd2f3a671561949ad754569df3ea0bb8e97806374e281a826ed8b9;profile.data 当前主题指向 verdant-mint.css,这和 verify 结果是两件事。这次没有重装,说不清是哪天装齐的;Typora 实际画面也没有看。
  • 2026-10-11 16:31 只读 verify:入口 CSS 源码与已装 SHA-256 一致,共享 CSS 不一致,verified=false;这是当时的状态。没有重装、恢复或清理备份。
  • 隔离安装测试确认无关主题保留(历史);该测试仍在源码里,2026-09-29 01:51 GitHub 自动测试日志显示它通过,这次没有运行。开发配置备份和新电脑恢复这次也没有执行。
与其他模块的关系

负责文件到位,编辑器负责选择并加载主题。

复制 AI 续作说明

项目:安装、备份与文件核对;仓库:wlyaaaaa/typora-theme-pack;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

把“目标”换成这次要做的事,整段复制给 AI。