fix(desktop): 状态镜像到宿主侧,修复随机端口导致重启丢数据
This commit is contained in:
@@ -0,0 +1,47 @@
|
||||
# 本地补丁:工作台状态镜像到宿主侧
|
||||
|
||||
基于上游 `Aisland-SJL/dsh-worktable` **v0.5.1**,本地版本号改成 `0.5.2-local.1`。
|
||||
|
||||
## 为什么打这个补丁
|
||||
|
||||
桌面端宿主启动参数写死 `--port 0`(`@deepseek-ai/dsh-slark-desktop-host` 的
|
||||
`windows-startup.js`:`--profile web --no-open --host 127.0.0.1 --port 0`),每次启动端口随机。
|
||||
而工作台把项目/布局/绑定存在 localStorage(`dsh.worktable.projects.v1`、`dsh.worktable.view.v1`),
|
||||
媒体存 IndexedDB —— 浏览器按「来源」隔离存储,端口一变就是另一个空库。
|
||||
现象:新建的工作台,重启后消失。
|
||||
|
||||
## 改了什么
|
||||
|
||||
1. `01_content/src/index.ts`:新增路由 `GET/POST /api/worktable/state`
|
||||
- 文件位置:`<DSH_HOME>/worktable-state.json`(走)`resolveDshHomeSafe()`)
|
||||
- GET 读回,POST 原子写入(先写 `.tmp-<pid>-<ts>` 再 rename)
|
||||
- 走宿主既有鉴权(`requestRejection`),和 `/api/worktable/file` 等私有路由一致
|
||||
2. `01_content/src/client/hostState.ts`(新增):宿主镜像的读/写与 400ms 防抖合并
|
||||
3. `01_content/src/client/index.tsx`:
|
||||
- `loadView` / `loadProjects` 抽出 `normalizeView` / `normalizeProjects`,本地存档与宿主镜像共用校验
|
||||
- `persistView` / `persistProjects` 额外写 `dsh.worktable.savedAt.v1` 并把状态排进宿主镜像
|
||||
- 挂载时拉宿主镜像,只有 `updatedAt > 本地 savedAt` 才回填,避免旧镜像盖掉刚改的内容
|
||||
- `markHydrated()` 之前的写入一律不发,防止首屏默认值把镜像冲掉
|
||||
- `pagehide` / `beforeunload` 立即冲刷
|
||||
|
||||
## 覆盖范围
|
||||
|
||||
- 覆盖:项目、布局、绑定、文件夹、视图/外观设置
|
||||
- **不覆盖**:图库媒体(照片)仍在 IndexedDB,换端口照样丢
|
||||
|
||||
## 构建 / 安装
|
||||
|
||||
```powershell
|
||||
cd 01_content
|
||||
npm install
|
||||
npm run build # lib/index.js + lib/client.js
|
||||
npm pack # 产出 dsh-worktable-0.5.2-local.1.tgz(7 文件,无 .map)
|
||||
dsh plugin --profile web add "file:./dsh-plugins/dsh-worktable-0.5.2-local.1.tgz"
|
||||
```
|
||||
|
||||
装完必须**完全退出宿主再重开**。
|
||||
|
||||
## 升级官方版时的注意
|
||||
|
||||
上游出 0.5.2 及以上时,本地补丁会被覆盖,需要把上面的三处改动重新合并到新版本再打包。
|
||||
如果上游自己解决了「桌面端随机端口 + localStorage」,这个补丁就可以直接丢掉。
|
||||
Reference in New Issue
Block a user