清风输入法高级设置
服务日志级别、一键备份与还原、各类导入导出入口与换机迁移
设置工具的「高级」页只有两块：日志设置与备份与还原。
日志设置
日志级别决定记录多少运行信息。修改后需重启输入法服务生效（功能主菜单 → 重启服务）。
| 级别 | 说明 |
|---|---|
| error | 仅记录错误信息 |
| warn | 记录警告和错误 |
| info | 记录一般运行信息（默认） |
| debug | 记录详细调试信息 |
| trace | 记录最详尽的追踪信息 |
日志目录默认为 %LOCALAPPDATA%\WindInput\logs\，可从功能主菜单的「高级 → 打开日志目录」直接跳过去。
注意 debug / trace 日志的内容
这两级日志可能包含按键、上下文状态等信息。请仅在排障时临时开启，并注意日志文件的保存与分享范围。排查完记得调回 info。
对应配置键是 debug.log_level，见统计与调试。
备份与还原
把整套用户数据打包为 .zip，一键还原。这是换机迁移与重要操作前保底的推荐做法。
创建备份
备份默认包含配置、词库数据、用户方案与主题；两类本机相关数据可选：
| 选项 | 说明 |
|---|---|
| 包含统计数据 | 把输入统计一并打包（默认不含） |
| 包含界面状态 | 把窗口位置等界面状态一并打包（默认不含） |
点「创建」选择保存位置即可，文件名默认带时间戳（如 windinput-backup-20260714-103000.zip）。
从备份还原
- 点「还原」选择备份包，自动读取并显示摘要：来源版本、平台、创建时间与各类条目数量
- 勾选还原范围：配置、词库数据、统计、用户方案、主题、界面状态（默认全选）
- 选择还原策略：
- 合并还原 —— 保留本地已有内容，备份数据并入
- 替换还原 —— 以备份为准覆盖本地数据
两种策略在文件类与数据类上的语义不同：
| 合并还原 | 替换还原 | |
|---|---|---|
| 文件域（配置、方案、主题、界面状态） | 已存在的文件跳过，计入冲突数 | 覆盖同名文件 |
| 数据域（词库、短语、词频、候选调整） | 逐条 upsert 合并 | 先清空该域再导入 |
| 统计 | 已存在的日期跳过 | 先清空再导入 |
还原完成后自动重载配置、重建短语与受影响方案的缓存，无需重启。若界面显示异常，重启输入法即可。
方案包走另一个入口
单个方案的分发包（方案包）不在此处导入，请到方案页用「导入」。备份页选到方案包会提示「该文件不是整机备份包」。
跨平台还原不做自动转换
备份包记录了来源平台，但热键、应用规则里的路径这类平台专属项不会自动转换。从 Windows 的备份还原到 macOS（或反之）时，这些项需要自行复核。
三个导入导出入口
清风输入法有三处导入导出，各管各的，互不通用：
| 入口 | 管什么 | 格式 |
|---|---|---|
| 高级 → 备份与还原 | 全部用户数据 | .zip（带 manifest.toml） |
| 方案 → 导入 / 导出 | 单个方案 + 它引用的词库、字体等资源 | .zip（零层级） |
| 词库 → 导入 / 导出 | 方案词库、快捷短语 | WindDict .wdict.yaml，导入还接受 Rime .dict.yaml 与 TSV |
两种 zip 会互相识别并拒绝
方案包与整机备份都是 .zip，但格式完全不同，各自的导入端都会识别并拒绝对方：备份页选到方案包会提示「该文件不是整机备份包」，方案页选到备份包会提示「该文件是整机备份包或旧格式归档」。
主题的导入在外观页，接受 .toml 文件或 HTTPS 链接。
完整的格式规范、字段含义、合并策略与安全限制见导入与导出。
手工备份漫游目录
漫游目录 %APPDATA%\WindInput\ 是完整自包含的：只要备份该目录，即可保存全部个人化内容（配置、自定义词、主题、方案），不依赖任何注册表项。
%LOCALAPPDATA%\WindInput\ 下只有缓存 / 日志 / 运行状态，可重建，无需备份。目录结构见核心概念 · 数据存在哪里。
删除操作前先备份
词库的删除、清空等操作不可恢复。重要数据建议提前备份。
换机迁移
二选一：
- 用备份包：旧机器创建
.zip备份 → 新机器安装清风输入法 → 在「高级 → 备份与还原」中还原该包 - 手工复制：把旧机器的
%APPDATA%\WindInput\整个目录复制到新机器同一位置即可，不必复制%LOCALAPPDATA%\WindInput\（缓存会自动重建）
命令行
以上操作都可以脚本化：
wind_input backup create D:\bak\wind.zip --stats --state
wind_input backup inspect D:\bak\wind.zip
wind_input backup restore D:\bak\wind.zip --replace --sections config,phrase