WorkBuddy通过双向增量同步、本地只读缓存+写时直连、离线操作队列与状态快照回滚、终端身份绑定与变更溯源链、内存映射式文档协作视图五大机制实现云端与本地协同。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
WorkBuddy实现云端与本地协同，依赖于数据实时同步机制与本地缓存策略的深度耦合。以下是其协同原理的具体展开：
一、双向增量同步机制
系统在本地修改数据后，仅将变更部分（如字段值、时间戳、操作类型）打包上传至云端，云端校验冲突后下发差异更新至其他终端，避免全量传输带来的延迟与带宽消耗。
1、本地数据库记录每次写入的操作日志，包含唯一操作ID、表名、主键、旧值哈希、新值哈希及时间戳。
2、客户端定时发起同步请求，携带本地最新操作ID作为游标，向云端查询该ID之后的所有变更记录。
3、云端比对各终端操作时间戳与版本向量，自动合并无冲突变更，对冲突项标记为待人工确认状态并推送到所有相关终端。
二、本地只读缓存+写时直连策略
界面层始终从本地SQLite数据库读取数据，保障响应速度；所有写操作则绕过缓存，直接通过加密信道提交至云端API，由服务端完成持久化与广播分发。
1、应用启动时加载最近7天高频访问数据集（含文档元信息、任务列表、联系人摘要）至本地只读缓存区。
2、用户点击“保存文档”时，前端序列化内容、生成ETag，并调用HTTPS POST接口提交至/cloud/v2/documents/commit。
3、云端返回201状态码及全局唯一document_id后，本地缓存立即更新对应条目的ETag与更新时间，但不重载全文内容。
三、离线操作队列与状态快照回滚
网络中断期间，所有用户操作被暂存为原子化指令队列，并伴随本地状态快照；恢复连接后，队列按时间序逐条重放，快照用于验证每步执行结果一致性，异常则触发整队列回滚。
1、检测到网络不可达时，系统自动启用离线模式，所有增删改操作写入本地WAL日志文件而非主数据库。
2、每5分钟或每10次操作后，生成一次轻量级状态快照，仅包含关键表主键集合与校验和，存储于独立加密分区。
3、联网后启动重放引擎：依次提交队列指令，每次提交后比对云端返回的状态哈希与本地快照哈希，任一不匹配即终止同步并清除当前队列。
四、终端身份绑定与变更溯源链
每个安装实例拥有硬绑定设备指纹（含TPM芯片标识、MAC地址哈希、首次激活时间），所有云端存储的变更记录均附带该指纹签名，确保操作可追溯、不可伪造。
1、首次启动时，客户端调用/sys/v1/device/bind接口，上传经RSA-2048签名的设备凭证包。
2、后续每次数据提交，请求头中强制携带X-Device-Signature字段，值为当前操作内容与设备指纹拼接后的HMAC-SHA256摘要。
3、云端验证签名有效性后，将设备指纹哈希写入变更记录的device_fingerprint_hash字段，并建立该哈希与用户账号的多对一映射关系。
五、内存映射式文档协作视图
多人编辑同一文档时，服务端不传输完整副本，而是将文档解析为结构化节点树，客户端通过mmap方式将共享内存页映射至本地进程空间，仅同步光标位置、选区范围与节点属性变更。
1、打开文档时，客户端向/cloud/v2/docs/{id}/mapping请求内存映射配置，获取节点树根地址、页大小及访问密钥。
2、调用mmap系统调用，将远程共享内存页挂载至本地虚拟地址空间，起始地址由云端统一分配以避免冲突。
3、用户输入字符时，前端直接修改对应内存页中的UTF-8字节序列，变化通过page fault机制触发内核通知云端，仅上报偏移量与字节长度。
