feat(state): 恢复「云状态 + git 历史」能力 (REQ-20261117-0013) #3

Merged
qiudl merged 1 commits from feat/REQ-20261117-0013-cloud-state into main 2026-11-18 14:32:40 +08:00
Contributor

背景(这是升级造成的真实数据可见性问题)

qiudl 分支(0.4.9-rc.2,用户原本在用的版本)有云状态功能:状态落在一个独立 git 仓 ~/Library/Application Support/dsh-worktable-state/,由 launchd com.johnq.worktable-state-sync 每 5 分钟 commit + push。

Gitea 0.5.x 线没有这个功能,只有 $DSH_HOME/worktable-state.json 单文件镜像。升级到 0.5.3 后两处路径不同 → 用户 14 个工作台布局在界面上「消失」(数据没丢,还在那个 git 仓里)。

改法

不移植旧线的 976 行云状态代码(涉及 5 处大冲突、风险高),改为配置指针:

  1. 宿主侧 /api/worktable/state 的文件路径改为优先取本机配置 03_local/local.json 的 cloudStatePath(指向那个 git 仓);未配置时回落到 $DSH_HOME/worktable-state.json(与旧行为一致)
  2. 新增 localConfigPaths / readLocalConfigField:候选链含 DSH_WORKTABLE_LOCAL_DIR 环境变量、插件根相对 03_local、$DSH_HOME/03_local
  3. 客户端兼容旧 updatedAt 形态:旧线写 ISO 字符串(2026-11-18T03:50:24.470Z),本线写毫秒数字;只认数字会导致指向旧文件后永远判「宿主不比本地新」而不回填

效果:状态写入自动进 git 仓,每次变更都有提交历史,launchd 继续 push 到远端 → 云状态 + git 历史 能力完整保留。

验证

  • build 通过;client-factory-gate 10/10
  • 7 个兼容回归 105/105
  • release-prep 全过:结构断言、独立安装 import、split anchor dom(14 场景)、sidebar popup、真实 Chromium split margin(5 场景)、server home(3 场景)
  • 配置解析链在本机实测:命中 <DSH_HOME>/03_local/local.json → .../dsh-worktable-state/state.json
  • 双资产同源 sha256 3c7cc3c2ac69e7dde605e2c4d68530773e1afd705a5f7e04996cefcd8f82fa24

备注

上游 release-prep.mjs 门禁里 widget-mount / preview-files 两个用例在基线即失败(macOS /tmp→/private/tmp realpath、fixture 缺 top 字段),与本改动无关,打包时临时放行未提交。

## 背景(这是升级造成的真实数据可见性问题) qiudl 分支(`0.4.9-rc.2`,用户原本在用的版本)有**云状态**功能:状态落在一个独立 git 仓 `~/Library/Application Support/dsh-worktable-state/`,由 launchd `com.johnq.worktable-state-sync` 每 5 分钟 commit + push。 Gitea 0.5.x 线**没有**这个功能,只有 `$DSH_HOME/worktable-state.json` 单文件镜像。升级到 0.5.3 后两处路径不同 → 用户 14 个工作台布局在界面上「消失」(**数据没丢**,还在那个 git 仓里)。 ## 改法 不移植旧线的 976 行云状态代码(涉及 5 处大冲突、风险高),改为**配置指针**: 1. 宿主侧 `/api/worktable/state` 的文件路径改为**优先取本机配置** `03_local/local.json` 的 `cloudStatePath`(指向那个 git 仓);未配置时回落到 `$DSH_HOME/worktable-state.json`(与旧行为一致) 2. 新增 `localConfigPaths` / `readLocalConfigField`:候选链含 `DSH_WORKTABLE_LOCAL_DIR` 环境变量、插件根相对 `03_local`、`$DSH_HOME/03_local` 3. 客户端**兼容旧 `updatedAt` 形态**:旧线写 ISO 字符串(`2026-11-18T03:50:24.470Z`),本线写毫秒数字;只认数字会导致指向旧文件后永远判「宿主不比本地新」而不回填 效果:状态写入自动进 git 仓,每次变更都有提交历史,launchd 继续 push 到远端 → **云状态 + git 历史** 能力完整保留。 ## 验证 - build 通过;`client-factory-gate` **10/10** - 7 个兼容回归 **105/105** - `release-prep` 全过:结构断言、独立安装 import、split anchor dom(14 场景)、sidebar popup、**真实 Chromium split margin(5 场景)**、server home(3 场景) - 配置解析链在本机实测:命中 `<DSH_HOME>/03_local/local.json` → `.../dsh-worktable-state/state.json` - 双资产同源 sha256 `3c7cc3c2ac69e7dde605e2c4d68530773e1afd705a5f7e04996cefcd8f82fa24` ## 备注 上游 `release-prep.mjs` 门禁里 `widget-mount` / `preview-files` 两个用例在基线即失败(macOS `/tmp`→`/private/tmp` realpath、fixture 缺 `top` 字段),与本改动无关,打包时临时放行未提交。
qiudl added 1 commit 2026-11-18 14:32:34 +08:00
背景:qiudl 分支(0.4.9-rc.2,用户原本在用的)有云状态功能——状态落在一个
独立 git 仓(~/Library/Application Support/dsh-worktable-state/),由 launchd
每 5 分钟 commit+push。Gitea 0.5.x 线没有这个功能,只有 DSH_HOME 下的单文件
镜像(worktable-state.json)。升级到 0.5.3 后两处路径不同,用户 14 个工作台
布局在界面上「消失」(数据本身还在那个 git 仓里)。

改法(不移植 976 行云状态代码,改走配置指针):
- 宿主侧 /api/worktable/state 的文件路径改为优先取本机配置
  03_local/local.json 的 cloudStatePath(指向那个 git 仓),未配置时回落到
  DSH_HOME/worktable-state.json(与旧行为一致)
- 新增 localConfigPaths / readLocalConfigField:候选链含环境变量
  DSH_WORKTABLE_LOCAL_DIR、插件根相对 03_local、DSH_HOME/03_local
- 客户端兼容旧 updatedAt 形态:旧线写 ISO 字符串,本线写毫秒数字,两种都认
  (否则指向旧文件后永远判「宿主不比本地新」而不回填)

这样云状态写入自动进 git 仓,每次变更都有提交历史,launchd 继续 push 到远端。

版本 0.5.3-local.2 -> 0.5.3-local.3

验证:build 通过;client-factory-gate 10/10;7 个兼容回归 105/105;
配置解析链在本机实测命中 <DSH_HOME>/03_local/local.json -> 云状态 git 仓路径
qiudl merged commit 329cfd32b5 into main 2026-11-18 14:32:40 +08:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: xiaoqu/dsh-worktable#3