Repository navigation
v0.15.10 — 初始同步、文档增量与账户安全
·
377 commits
to master
since this release
v0.15.10 — 初始同步、文档增量与账户安全
这一版把账户同步从「登录就自动全量对账」改成显式的初始同步 + 增量对账:登录后先建立一次同步状态,之后每次同步只拉云端变化、只推本地改动。同时收紧了三处写权限——定义与快照只由 PC 写、只读实例不参与账户操作、手机端只拉不推。
不登录、不点同步的用法保持原样:任务、批量、档案都还在本机。
⚠️ 不兼容变动与升级指引
登录后不再自动同步,必须先「初始同步」
- 现象: 登录账户后「立即同步」不可用、60 秒自动同步也不跑,直到点过一次「初始同步」。
- 原因: 同步状态必须先显式建立,避免新实例一登录就静默上传或拉取。
- 如何调整: 点一次「初始同步」即可,此后照常。
初始同步在云端已有数据时会备份并替换本地三件套
- 现象: 本地的
users/、profile.db、profile.yaml以及yysls/play_styles.json等会话级同步文档,会被移入config/session/_backup-initialsync-<时间戳>/,随后以云端数据为准重建。 - 原因: 云端是唯一权威;本机已有数据与云端同名时,不允许两边各留一份。
- 如何调整: 无需操作。被移走的本地数据仍在备份目录,可手工找回。云端为空时不会备份,改为直接上传本地并创建初始快照。
「清除同步」现在会清空云端
- 现象: 该按钮会清空云端的定义、用户、文档、总览账本与快照(账号与登录态保留),需要密码确认;此前版本只清本地进度。
- 原因: 需要一条「彻底清空远端、重新开始」的路径。
- 如何调整: 清空后回到未建立状态,点「初始同步」重新播种即可,不必重新登录。
新实例不再自动创建 default 用户
- 现象: 全新实例打开后没有用户,状态栏提示先创建用户或登录账户。
- 原因: 去掉「没有用户就默认造一个 default」的行为。
- 如何调整: 在「用户管理」创建用户;或登录后点「初始同步」把云端用户拉回本地。
只读实例禁用账户管理
- 现象: 同一安装目录的第二个实例(窗口标题带
[只读实例])里,「通用 → 账户管理」是灰的,不会自动登录,也不做任何同步。 - 原因: 登录态与同步状态只归主实例;两个进程同时读写同步水位会互相覆盖。
- 如何调整: 无需操作。只读实例里的文档、便利贴、装备方案等改动,主实例下一轮同步会自动发现并上传。命令行
--read-only同样适用。
手机端只拉不推定义与快照
- 现象: 手机不再把
profile.yaml上传云端,也不能创建总览快照;云端没有快照时提示「请先在 PC 端完成初始同步后继续」。 - 原因: 手机上的定义是离线包副本,上行会把云端定义回退成旧版;快照必须代表全网基线,只能由 PC 建立。
- 如何调整: 无需操作。定义改动在 PC 端做,手机同步时自动拉取。
头像同步暂停
- 现象: 头像不再随账户同步上传或下载。
- 原因: 头像同步正在重新设计,本版先停用。
- 如何调整: 无需操作。本地与云端已有的头像数据都保留不动。
会话文件改为首次使用时创建
- 现象:
config/session/yysls/play_styles.json等文件不再在启动时生成空文件,而是第一次用到对应功能时才创建。 - 原因: 启动即建空文件会被同步当成「本地有改动」,可能把空内容推上云端覆盖真实数据。
- 如何调整: 无需操作。
✨ 新增功能
初始同步
- 云端为空时:上传定义、名册、文档,并用本地总览数据创建初始快照,一步完成播种。
- 云端已有数据时:先把本地用户目录、总览库、定义与会话文档备份到
config/session/_backup-initialsync-<时间戳>/,再拉取云端四通道。 - 该按钮与「清除同步」互斥占同一个位置:未建立时显示初始同步,建立后显示清除同步。
数据同步页
- 同步表固定四行:定义 / 用户 / 文档 / 总览,实时显示上行、下行与失败数。
- 只有「总览」行有「创建快照」按钮,其余三行留白——快照只服务总览回放。
- 页面高度不再随状态文字出现或消失而跳动。
账户自助服务
- 账户管理对话框右上角新增「自助服务…」,在浏览器打开自助操作页:导出数据、清除数据、注销账号。
- 「清除数据」为新增能力:清空云端全部同步数据(名册、文档、定义、账本、快照、分享链接),保留账号与登录态,供重新做一次初始同步。
云端被清空后自动复位
- 云端数据被清空(网页、另一台 PC 或管理员操作)后,本机下次同步会识别到服务端的明确空状态,自动退回「未建立」并提示点「初始同步」。
- 判定只认服务端显式返回的空状态标记;网络或鉴权失败一律按「未知」处理,不会误清本机同步状态。
文档增量同步
- 云端为每个文档维护递增修订号,客户端记录已看到的修订水位与本地改动集合:
没有变化时一次轻量请求即结束;只有一端变化时只传变化的部分;两端都变才做全量对比并按时间裁决。
离线包可声明不携带总览数据
- PC 云端模式下发的配置包不再包含总览库与定义(
manifest.profile=false),手机总览改由账户同步更新;安装端会校验声明与包内容一致,旧包缺省按携带处理。
🔧 修复
- 全新实例登录同步拉不到任何用户: 下行不再要求本地先有该用户,云端用户会直接创建到本地并纳入名册。
- 本地
profile.yaml缺失时不从云端拉取: 现在缺失会拉回并重载定义(初始同步备份后依赖此路径)。 - 名册有名字但本地缺资料文件会上传空资料: 会把云端真实属性冲成空对象;现在缺文件的行直接跳过,只从云端补回。
- 定义改动后云端定义不跟随: 以前只在本地文件变化时才核对云端,云端被旧版本回推后永远发现不了;现在每次同步都核对云端 sha。
- 便利贴每轮重复上传: 加密迁移钩子的判断条件写反,云端已是密文时仍反复重推;现在只在云端还是明文时才重推。
- 「清除同步」不清远端: 改为真正清空云端数据并回读确认。
- 总览快照落地慢: 逐条写入改为按用户批量事务,千余条从分钟级降到秒级。
- 文档与头像逐份请求慢: 改为批量拉取(文档每批 20 份、头像每批 10 个),并限制单个头像不超过 1 MB。
- 桌面端凭据降级: 系统凭据库不可用时不再把刷新令牌明文写进
config/session,改为明确报错;凭据与账号状态文件也已加入忽略列表。
📦 重构
- 文档通道由「每轮全量对账」改为「修订号增量 + 本地改动集合」。
- 头像退出同步通道,保留数据。
- 同步水位与签名集中存放在
config/session/account.json,由主实例独占写入。 - 定义与快照改为 PC 独占写权限,底层做硬门禁。
📚 文档
- 无独立文档变更;本版的行为变化已在发布说明与界面文案中体现。
📝 变更统计
- 相对 v0.15.9 共 27 个开发/维护提交,另有 1 个发布准备提交。
- 除
docs/外 37 个文件变更(含版本号三处),新增 1829 行、删除 268 行;
docs/2 个文件,新增 131 行、删除 1 行。 - 按发布流程本地执行
add_content_version --check、Ruff、mypy 与全量 pytest
(QT_QPA_PLATFORM=offscreen);云端 Windows/Android 构建、签名核验与产物核验
由发布流水线执行,结果通过执行反馈报告。
⚠️ 免责声明
本项目仅供学习与技术研究使用。使用自动化工具操作游戏可能违反相关游戏的用户协议,
由此产生的后果由使用者自行承担。升级前请备份个人配置与数据库。
📄 许可证
PolyForm Noncommercial License 1.0.0 — 非商业使用许可