dsh-session-sync 0.2.32 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,109 +1,195 @@
1
1
  <div align="center">
2
2
 
3
- # 🔄 dsh-session-sync
4
- - **1024 store channel**: `npm i -g dsh1024` once, then `dsh1024 plugin --profile web add dsh-session-sync` (counts toward the [deepseek1024.com](https://deepseek1024.com) install ranking).
5
- [![Gitee](https://img.shields.io/badge/Gitee-mirror-c71d23?logo=gitee)](https://gitee.com/perrylink/dsh-session-sync)
6
- [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-session-sync?metric=downloads)](https://dshfind.com/plugins/PerryLink/dsh-session-sync?ref=badge)
7
- [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-session-sync/badge)](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-session-sync)
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-session-sync-hero-zh-dark.webp">
5
+ <img src="docs/assets/dsh-session-sync-hero-zh-light.webp" width="100%" alt="dsh-session-sync:两台设备把 $DSH_HOME/sessions 按不透明字节镜像进 git 工作树并提交,推送到你自己的远端;拉取时逐文件三方合并,分歧两边都留(远端版本存为 fork 文件),绝不 force-push。">
6
+ </picture>
7
+
8
+ # dsh-session-sync
8
9
 
9
- **Cross-device session sync for DeepSeek Harness — a dedicated git mirror of your session store.**
10
+ **把会话存储镜像成你自己控制的 git 仓库——跨设备同步,冲突两边都留,绝不丢一轮。**
10
11
 
11
- *Sync your sessions between devices, keep both sides on any conflict, never lose a turn.*
12
+ 面向 DeepSeek Harness 的纯主机端同步插件:会话文件按不透明字节复制,append-only 三方合并,远端由你选(默认明文 git,可选 age 加密),无云服务、无第三方存储。
12
13
 
13
- > **Official repository.** This is the only official repository of dsh-session-sync, maintained by PerryLink. Same-name repositories under other accounts are not affiliated.
14
+ [安装](#三步上手) · [配置](#配置) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
14
15
 
15
- [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
16
- [![DSH plugin](https://img.shields.io/badge/dsh--plugin-✅-green)](https://github.com/topics/dsh-plugin)
17
- [![dsh-doctor](https://raw.githubusercontent.com/PerryLink/dsh-plugin-doctor/main/badges/PerryLink__dsh-session-sync.svg)](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
18
- [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-top-rated.svg)](https://dsh.market/)
19
- [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
20
- [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-session-sync/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-session-sync/actions)
21
- [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-session-sync?label=version)](https://github.com/PerryLink/dsh-session-sync/releases)
22
- [![npm version](https://img.shields.io/npm/v/dsh-session-sync)](https://www.npmjs.com/package/dsh-session-sync)
23
- [![npm downloads](https://img.shields.io/npm/dm/dsh-session-sync)](https://www.npmjs.com/package/dsh-session-sync)
16
+ [![License](https://img.shields.io/badge/license-Apache--2.0-3366CC?style=flat-square&labelColor=2B3245)](LICENSE)
17
+ [![DSH](https://img.shields.io/badge/DSH-%E2%89%A50.1.2%20%3C0.3.0-4B67B4?style=flat-square&labelColor=2B3245)](#兼容性)
18
+ [![npm](https://img.shields.io/npm/v/dsh-session-sync?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-session-sync)
19
+ [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-session-sync/ci.yml?branch=main&label=CI&style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-session-sync/actions/workflows/ci.yml)
20
+ [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24.9-339933?style=flat-square&labelColor=2B3245)](#兼容性)
24
21
 
25
- [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
22
+ [![Stars](https://img.shields.io/github/stars/PerryLink/dsh-session-sync?style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-session-sync/stargazers)
23
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-session-sync?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-session-sync)
24
+ [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-session-sync?metric=downloads)](https://dshfind.com/plugins/PerryLink/dsh-session-sync?ref=badge)
25
+ [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-session-sync/badge)](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-session-sync)
26
+ [![DSH Market](https://img.shields.io/badge/DSH_Market-listed-4B67B4?style=flat-square&labelColor=2B3245)](https://dsh.market/)
27
+ [![Gitee](https://img.shields.io/badge/Gitee-mirror-C71D23?style=flat-square&labelColor=2B3245&logo=gitee)](https://gitee.com/perrylink/dsh-session-sync)
26
28
 
27
29
  ```sh
28
30
  dsh plugin --profile <name> add dsh-session-sync
29
31
  ```
30
32
 
31
-
32
33
  </div>
33
34
 
34
- ---
35
+ <sub>社区插件,与 DeepSeek 官方无关。本仓库是唯一官方仓库,由 PerryLink 维护;其他账号下的同名仓库与本项目无关。Gitee 为镜像。</sub>
35
36
 
36
- **📖 Ecosystem knowledge base** — measured data, not marketing: [plugin development guide · plugin-selection data · maintenance criteria](https://perrylink.github.io/dsh-plugin-guide/).
37
+ ## 它是什么
37
38
 
38
- <!-- star-cta -->
39
- ## Install & uninstall
39
+ `dsh-session-sync` 把 DSH 会话存储(`$DSH_HOME/sessions`)镜像到一个专用 git 工作树,再同步到**你自己**控制的远端:没有云服务,没有第三方存储。会话文件按不透明字节复制,插件从不解析 JSONL/zstd——物理编码属于 harness,插件的职责只是搬运字节、合并 append-only 历史并报告状态。发生分歧时走 append-only 三方合并:**两边都保留**,远端版本留存为 fork 文件,绝不静默覆盖。默认 `backend: git` 是明文镜像;`backend: encrypted` 在镜像之上加一层 age 加密;自动模式全部可配置、可逆。
40
40
 
41
- - **git channel** (latest `main`): `dsh plugin --profile web add github:PerryLink/dsh-session-sync` (equivalent to installing from `git+https://github.com/PerryLink/dsh-session-sync.git`). No build step — `index.mjs` and `lib/` are the shipped artifacts.
42
- - **npm channel** (published releases): `dsh plugin --profile web add dsh-session-sync`.
43
- - **tarball channel**: `pnpm pack` in this repo, then `dsh plugin --profile web add ./dsh-session-sync-<version>.tgz`.
44
- - **uninstall**: `dsh plugin --profile web remove dsh-session-sync` (or remove the row from the profile patch).
41
+ <p align="center">
42
+ <picture>
43
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-session-sync-flow-v5-dark.svg">
44
+ <img src="docs/assets/dsh-session-sync-flow-v5-light.svg" width="100%" alt="dsh-session-sync 结构图:设备 A 的 $DSH_HOME/sessions 经字节镜像与提交,越过确认门推送到你自己的 git 远端;设备 B 拉取后逐文件三方合并(base/ours/theirs),再把会话恢复到本机,分歧时本地保留原路径、远端字节存为 fork 文件;fork 文件永不被删除或覆盖。">
45
+ </picture>
46
+ </p>
45
47
 
46
- ## ⭐ 如果它帮到了你
48
+ ## 三步上手
47
49
 
48
- 这个插件是 [DSH 插件家族](https://github.com/PerryLink)的一员(95 个,全部 Apache-2.0)。如果你在用,**给个 star** —— 它不会解锁任何功能,但会让下一个人在搜索里更容易找到它。
50
+ 1. **安装**(三选一):
49
51
 
50
- *English:* part of a 95 plugin family for DeepSeek Harness. If it is useful, **a star helps the next person find it** — nothing is gated behind it.
52
+ ```sh
53
+ # git 通道(最新 main;等价于 git+https://github.com/PerryLink/dsh-session-sync.git)
54
+ dsh plugin --profile web add github:PerryLink/dsh-session-sync
55
+ # npm 通道(已发布版本)
56
+ dsh plugin --profile web add dsh-session-sync
57
+ # tarball 通道:本仓库 pnpm pack 后
58
+ dsh plugin --profile web add ./dsh-session-sync-<version>.tgz
59
+ ```
51
60
 
61
+ 无构建步骤——`index.mjs` 与 `lib/` 即发布产物。
52
62
 
53
- ## What is dsh-session-sync?
63
+ 2. **最小配置**(在你的 profile patch 里指向一个**私有** git 远端):
54
64
 
55
- Cross-device session sync for DeepSeek Harness — a dedicated git mirror of your session store.
65
+ ```yaml
66
+ - insert:
67
+ - id: session-sync
68
+ name: dsh-session-sync
69
+ config:
70
+ remote: git@github.com:you/your-dsh-sessions.git
71
+ ```
56
72
 
57
- Sync your sessions between devices, keep both sides on any conflict, never lose a turn.
73
+ 3. **验证已生效**:
58
74
 
59
- ![Workflow diagram for dsh-session-sync: request → policy / review → verdict.](docs/assets/dsh-session-sync-flow.svg)
75
+ ```sh
76
+ dsh --profile web --dump-config | grep -A2 'id: session-sync'
77
+ ```
60
78
 
61
- *Workflow overview: request → policy / review → verdict. The examples below use the real command surface.*
79
+ ```
80
+ > /sync status
81
+ > /sync pull
82
+ > /sync push
83
+ ```
62
84
 
85
+ **卸载**:`dsh plugin --profile web remove dsh-session-sync`(或从 profile patch 删掉该行)。
63
86
 
87
+ ## 核心能力
64
88
 
65
- ## Compatibility
89
+ `dsh-session-sync` 在主机侧把会话存储变成可版本化的 git 镜像,并把同步动作交给你的远端:
66
90
 
67
- | Surface | Status |
68
- |---|---|
69
- | Harness | DeepSeek Harness `dsh-v0.2.1-alpha.1` (GitHub tag, verified 2026-09-25: full gate chain against the pinned `0.1.7-rc.2` peers). npm dependency line `0.1.7-rc.2`, peers `>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0`. (adapted 2026-10-04): the conflict fork notice carries the plugin's own producer-owned message source kind - the harness retired the shared `plugin` kind and refuses it on read-back. |
70
- | Node | `^22.19.0 \|\| >=24.0.0` |
71
- | Platforms | Anywhere `git` and DSH run (git-based mirror; no platform-specific code) |
72
- | Model | Text-only models fully supported; no vision or extra model capability required |
91
+ - **`/sync` 命令** —— `status`(分支、脱敏后的远端、领先/落后、未提交文件、fork 文件)、`diff`、`log`、`pull`、`push`、`help`。
92
+ - **`sync_status` / `sync_pull` / `sync_push` 工具** —— 在轮次内为模型提供同样的能力。
93
+ - **append-only 冲突裁决** —— 会话日志是 append-only;任何分歧都会**两边都保留**(本地版本保留、远端版本留存为 fork 文件),绝不静默覆盖。分歧的会话还可在会话层面 fork。
94
+ - **自动模式** —— 启动时拉取、每个关闭轮次后推送、周期拉取,全部可配置且可逆。
95
+ - **写操作走确认门** —— `pull`/`push` 会先询问(经 `userQuestions` 或 `approval`);只读界面从不询问;没有回答者时操作失败关闭。
96
+
97
+ ```text
98
+ 设备 A 远端(你的 git 仓库) 设备 B
99
+ $DSH_HOME/sessions ──镜像──▶ 提交 ──推送──▶ [sessions] ──拉取──▶ 合并(两边保留 + fork)
100
+ ```
101
+
102
+ ### 命令与工具面
103
+
104
+ | 界面 | 只读 | 需要确认 | 说明 |
105
+ |---|---|---|---|
106
+ | `/sync status` | ✅ | — | 分支、脱敏远端、领先/落后、未提交文件、fork 文件、最近推/拉 |
107
+ | `/sync diff` | ✅ | — | 未提交变更 + `HEAD..remote` 统计(只读) |
108
+ | `/sync log` | ✅ | — | 同步仓库最近提交 |
109
+ | `/sync pull` | | ✅ | fetch + 合并(两边保留语义;本地保留、远端留存为 fork) |
110
+ | `/sync push` | | ✅ | 镜像 + 提交 + 推送;绝不强推,被拒时拉取调和后重试一次 |
111
+ | `sync_status` | ✅ | — | 为模型提供 `/sync status` 同样的信息 |
112
+ | `sync_pull` | | ✅ | 模型可调用的拉取 |
113
+ | `sync_push` | | ✅ | 模型可调用的推送 |
73
114
 
74
- ## What you get
115
+ ### 示例
75
116
 
76
- `dsh-session-sync` mirrors your DSH session store into a dedicated git worktree and syncs it to a remote **you** control — no cloud service, no third-party storage:
117
+ 以下为插件真实入口;安装后调用一个即可。
77
118
 
78
- - **`/sync` command** — `status` (branch, sanitized remote, ahead/behind, dirty files, forks), `diff`, `log`, `pull`, `push`, `help`.
79
- - **`sync_status` / `sync_pull` / `sync_push` tools** — the same surface for the model, inside a turn.
80
- - **Append-only conflict resolution** — session logs are append-only; on any divergence the plugin keeps **both** sides (local version kept, remote version preserved as fork files) and never silently overwrites. Diverged sessions can also fork at the session level.
81
- - **Auto modes** — pull on start, push after every closed turn, and periodic pull, all configurable and all reversible.
82
- - **Confirmation-gated writes** — `pull`/`push` ask first (through `userQuestions` or `approval`); read-only surfaces never ask; with no answerer the operation fails closed.
119
+ **详细示例** —— 命令 `/sync help`:
83
120
 
84
121
  ```text
85
- device A remote (your git repo) device B
86
- $DSH_HOME/sessions ──mirror──▶ commit ──push──▶ [sessions] ──pull──▶ merge (keep-both + fork)
122
+ sync: usage — /sync [status | pull | push | diff | log | help]
123
+ status show mirror state (default): branch, remote, ahead/behind, dirty, forks
124
+ pull fetch + merge remote changes (keep-both; confirms first)
125
+ push mirror + commit + push local changes (confirms first)
126
+ diff uncommitted changes + HEAD..remote stat (read-only)
127
+ log last commits in the sync repository
87
128
  ```
88
129
 
89
- ## Quick start
130
+ *Observed from `index.mjs:754-765 (registered /sync handler)`*
90
131
 
91
- ```sh
92
- dsh plugin --profile web add github:PerryLink/dsh-session-sync
132
+ **失败分支** —— 输入 `/sync push`:
133
+
134
+ ```text
135
+ sync: cancelled: approval requires an open turn; /sync commands run between turns — mount userQuestions or set confirmVia: userQuestions
93
136
  ```
94
137
 
95
- ```sh
96
- # 1. install the bundle into your profile
97
- dsh plugin --profile web add github:PerryLink/dsh-session-sync
138
+ *Observed from `plugins/dsh-session-sync/lib/gate.mjs:134-137; plugins/dsh-session-sync/index.mjs:792-794; plugins/dsh-session-sync/test/gate.test.mjs:80-88; plugins/dsh-session-sync/README.md:246`*
98
139
 
99
- # or from npm (published releases)
100
- dsh plugin --profile web add dsh-session-sync
140
+ **简短示例**:`/sync diff` · `/sync pull`
101
141
 
102
- # 2. point it at a private git remote and verify the row
103
- dsh --profile web --dump-config | grep -A2 'id: session-sync'
104
- ```
142
+ ## 配置
143
+
144
+ 所有可调项都是 Schemastery `Config` 字段(可从 cordis.yml 覆盖)。按 id 覆盖会替换整行——请重述所有需要的键。`cordis.patch.yml` 逐键内联注释。
145
+
146
+ 最常用键:
147
+
148
+ | 键 | 默认值 | 含义 |
149
+ |---|---|---|
150
+ | `remote` | `''` | 远端地址(pull/push 前必须非空;status/diff 无需) |
151
+ | `backend` | `git` | 同步后端:`git`(明文镜像)或 `encrypted`(age 加密镜像内容) |
152
+ | `sessionRoot` | `''` | 会话存储根;空 = `$DSH_HOME/sessions`(两者皆缺加载失败) |
153
+ | `repoDir` | `''` | 同步工作树根;空 = `$DSH_HOME/dsh-session-sync/repo` |
154
+ | `branch` | `main` | 远端分支名 |
155
+ | `autoPushOnTurnEnd` | `false` | 每个关闭轮次后推送 |
156
+ | `pullIntervalMinutes` | `0` | 每 N 分钟周期拉取(`0` = 关闭,最大 `10080`) |
157
+ | `cwdMap` | `[]` | 恢复期 cwd 投影表 `[{from, to}]`(最长前缀优先;未命中的跨平台 cwd 归一到 `<sessionRoot>/--unmapped--`,只读) |
158
+ | `followSessionSymlinks` | `false` | 是否跟随 realpath 仍在 `sessionRoot` 内的符号链接(Android/proot 诊断) |
159
+ | `confirmVia` | `auto` | 确认通道:`auto`(优先 userQuestions,其次 approval)、`userQuestions`、`approval` |
160
+
161
+ <details>
162
+ <summary>完整配置表(23 个键)</summary>
105
163
 
106
- Then set the remote in your profile patch (a **private** repository is the baseline) and sync:
164
+ | 键 | 默认值 | 含义 |
165
+ |---|---|---|
166
+ | `enabled` | `true` | 总开关;`false` 卸载命令、工具、监听器与自动模式 |
167
+ | `backend` | `git` | 同步后端:`git`(明文镜像)或 `encrypted`(age 加密镜像内容) |
168
+ | `sessionRoot` | `''` | 会话存储根;空 = `$DSH_HOME/sessions`(两者皆缺加载失败) |
169
+ | `repoDir` | `''` | 同步工作树根;空 = `$DSH_HOME/dsh-session-sync/repo` |
170
+ | `remote` | `''` | 远端地址(pull/push 前必须非空;status/diff 无需) |
171
+ | `branch` | `main` | 远端分支名 |
172
+ | `gitBin` | `git` | git 可执行路径 |
173
+ | `ageBin` | `age` | age 可执行路径(`backend: encrypted` 时探测;缺失降级明文) |
174
+ | `ageRecipient` | `''` | age 收件人(公钥/身份串);空 = 无法加密、降级明文 |
175
+ | `ageIdentity` | `''` | 无口令 age 私钥文件路径(用于解密);空 = 无法解密、降级明文 |
176
+ | `autoPullOnStart` | `false` | 插件挂载时拉取一次(配置即授权,不再确认) |
177
+ | `autoPushOnTurnEnd` | `false` | 每个关闭轮次后推送 |
178
+ | `pullIntervalMinutes` | `0` | 每 N 分钟周期拉取(`0` = 关闭,最大 `10080`) |
179
+ | `cwdMap` | `[]` | 恢复期 cwd 投影表 `[{from, to}]`(最长前缀优先;未命中的跨平台 cwd 归一到 `<sessionRoot>/--unmapped--`,只读) |
180
+ | `followSessionSymlinks` | `false` | 是否跟随 realpath 仍在 `sessionRoot` 内的符号链接(Android/proot 诊断) |
181
+ | `confirmVia` | `auto` | 确认通道:`auto`(优先 userQuestions,其次 approval)、`userQuestions`、`approval` |
182
+ | `graceMs` | `10000` | git 终止宽限(毫秒) |
183
+ | `commandTimeoutMs` | `120000` | 单条命令超时(毫秒) |
184
+ | `maxOutputBytes` | `262144` | 单流收集输出上限(字节) |
185
+ | `commitName` | `dsh-session-sync` | 提交者名 |
186
+ | `commitEmail` | `dsh-session-sync@localhost` | 提交者邮箱 |
187
+ | `registerCommand` | `true` | 注册 `/sync` 命令 |
188
+ | `registerTools` | `true` | tools 服务存在时注册 `sync_*` 工具 |
189
+
190
+ </details>
191
+
192
+ 在你的 profile patch 中的覆盖示例:
107
193
 
108
194
  ```yaml
109
195
  - insert:
@@ -111,203 +197,172 @@ Then set the remote in your profile patch (a **private** repository is the basel
111
197
  name: dsh-session-sync
112
198
  config:
113
199
  remote: git@github.com:you/your-dsh-sessions.git
200
+ branch: main
201
+ autoPushOnTurnEnd: true
202
+ pullIntervalMinutes: 30
203
+ confirmVia: userQuestions
114
204
  ```
115
205
 
116
- ```
117
- > /sync status
118
- > /sync pull
119
- > /sync push
120
- ```
206
+ ## FAQ
121
207
 
122
- ### Examples
208
+ <details>
209
+ <summary>数据到底存在哪?会上传到云端吗?</summary>
123
210
 
124
- These are the plugin's real entry points; install once, then call one.
211
+ 没有云服务,也没有第三方存储。本机有两份副本:`$DSH_HOME/sessions`(harness 的会话存储)与你配置的 `repoDir` 工作树(默认 `$DSH_HOME/dsh-session-sync/repo`);远端是**你自己的** git 仓库。`backend: encrypted` 只把推送/远端的副本变成 age 密文,本地镜像仍是明文。
125
212
 
126
- #### Detailed example
213
+ </details>
127
214
 
128
- **Command**
215
+ <details>
216
+ <summary>冲突会覆盖或丢掉会话吗?</summary>
129
217
 
130
- ~~~sh
131
- /sync help
132
- ~~~
218
+ 不会静默覆盖。会话日志是 append-only,三方合并在任何分歧时都保留两边:本地版本保留,远端版本存成 `<basename>.remote-fork-<UTC 14 位时间戳>-<device8>` 的 fork 文件;fork 文件永不被删除或覆盖,git 绝不强推、reset、rebase 或切换分支。分歧的会话还会在会话层面 fork,并向子会话注入一条持久通知。
133
219
 
134
- **Output**
220
+ </details>
135
221
 
136
- ~~~text
137
- sync: usage — /sync [status | pull | push | diff | log | help]
138
- status show mirror state (default): branch, remote, ahead/behind, dirty, forks
139
- pull fetch + merge remote changes (keep-both; confirms first)
140
- push mirror + commit + push local changes (confirms first)
141
- diff uncommitted changes + HEAD..remote stat (read-only)
142
- log last commits in the sync repository
143
- ~~~
222
+ <details>
223
+ <summary>加密是默认开启的吗?age 缺失会怎样?</summary>
144
224
 
145
- *Observed from `index.mjs:754-765 (registered /sync handler)`*
225
+ 不是,默认 `backend: git`,会话字节以未加密形式存放在你的远端——请使用私有仓库。`backend: encrypted` 需要 `age` 以及非空的 `ageRecipient`/`ageIdentity`;任一缺失时插件显式告警并降级为明文 git,绝不假装已经加密。把远端当作已加密之前,先检查 `/sync status` 中的告警。
146
226
 
147
- #### Failure branch
227
+ </details>
148
228
 
149
- **Input**
229
+ <details>
230
+ <summary>没有 git、或者没有确认回答者会怎样?</summary>
150
231
 
151
- ~~~text
152
- /sync push
153
- ~~~
232
+ 缺少 `git` 可执行文件或 `subprocess` 服务时,同步操作以明确原因失败(profile 仍可启动)。`/sync` 在两轮之间运行,`approval` 通道没有开放轮次可挂靠:请用 `confirmVia: userQuestions`,或在轮次内经 `sync_*` 工具同步;完全没有回答者时操作失败关闭。
154
233
 
155
- **Output**
234
+ </details>
156
235
 
157
- ~~~text
158
- sync: cancelled: approval requires an open turn; /sync commands run between turns — mount userQuestions or set confirmVia: userQuestions
159
- ~~~
236
+ <details>
237
+ <summary>性能开销多大?自动模式会一直跑吗?</summary>
160
238
 
161
- *Observed from `plugins/dsh-session-sync/lib/gate.mjs:134-137; plugins/dsh-session-sync/index.mjs:792-794; plugins/dsh-session-sync/test/gate.test.mjs:80-88; plugins/dsh-session-sync/README.md:246`*
239
+ 会话文件按不透明字节复制,不解析内容;每条 git 命令都有超时、终止宽限与单流输出上限。自动推送默认关闭,周期拉取默认关闭(`pullIntervalMinutes: 0`),启动拉取默认关闭——开启后才由配置授权、不再逐次确认。开销取决于会话存储体积与远端延迟;本仓库没有基准数据,不给出编造的数字。
162
240
 
163
- #### Brief examples
241
+ </details>
164
242
 
165
- - `/sync diff`
166
- - `/sync pull`
243
+ ## 安全边界
167
244
 
168
- ## Configuration
245
+ - **绝不静默覆盖。** append-only 三方合并在任何分歧时都保留两边,包括 delete/modify(修改后的字节保留、删除意图被尊重);fork 文件永不被删除,git 绝不强推、reset、rebase 或切换分支。
246
+ - **路径收容。** 文件按不透明字节镜像、拒绝符号链接,每次路径拼接都做收容校验(`PATH_UNSAFE` 响亮失败)。
247
+ - **脱敏输出。** 远端 URL 凭据、令牌与 `key=value` 密钥在进入模型或日志前被打码;路径展示拒绝根外路径。
248
+ - **不存凭据。** 插件自身不存凭据;git 凭据由你常规的 git credential helper 管理。age 身份/接收方文件由你管理,密钥绝不进入同步仓库。
249
+ - **git 加固。** git 以 `GIT_TERMINAL_PROMPT=0`、`GIT_OPTIONAL_LOCKS=0` 运行,带截止时间与信号边界,输出按流封顶。
250
+ - **失败关闭。** 缺少确认回答者、缺少远端或不安全路径都会响亮拒绝操作。
169
251
 
170
- All tunables are Schemastery `Config` fields (changeable from cordis.yml). An id-targeted override replaces the whole row — restate every key you need. `cordis.patch.yml` documents each key inline.
252
+ ## 权限与数据
171
253
 
172
- | Key | Default | Meaning |
173
- |---|---|---|
174
- | `enabled` | `true` | Master switch; `false` unregisters the command, tools, listeners, and auto modes |
175
- | `backend` | `git` | Sync backend: `git` (plaintext mirror) or `encrypted` (age-encrypted mirror content) |
176
- | `sessionRoot` | `''` | Session store root; empty = `$DSH_HOME/sessions` (both missing fails load) |
177
- | `repoDir` | `''` | Sync worktree root; empty = `$DSH_HOME/dsh-session-sync/repo` |
178
- | `remote` | `''` | Remote address (required before pull/push; status/diff work without one) |
179
- | `branch` | `main` | Remote branch name |
180
- | `gitBin` | `git` | git executable path |
181
- | `ageBin` | `age` | age executable path (probed for `backend: encrypted`; missing degrades to plaintext) |
182
- | `ageRecipient` | `''` | age recipient (public key or identity string); empty = cannot encrypt, degrades to plaintext |
183
- | `ageIdentity` | `''` | Path to a passphrase-less age secret key for decryption; empty = cannot decrypt, degrades to plaintext |
184
- | `autoPullOnStart` | `false` | Pull once when the plugin mounts (config is the grant; no re-confirm) |
185
- | `autoPushOnTurnEnd` | `false` | Push after every closed turn |
186
- | `pullIntervalMinutes` | `0` | Periodic pull every N minutes (`0` = off, max `10080`) |
187
- | `confirmVia` | `auto` | Confirmation channel: `auto` (userQuestions first, then approval), `userQuestions`, `approval` |
188
- | `graceMs` | `10000` | Grace period for git kills (ms) |
189
- | `commandTimeoutMs` | `120000` | Per-command timeout (ms) |
190
- | `maxOutputBytes` | `262144` | Per-stream collected-output cap (bytes) |
191
- | `commitName` | `dsh-session-sync` | Commit author name |
192
- | `commitEmail` | `dsh-session-sync@localhost` | Commit author email |
193
- | `registerCommand` | `true` | Register the `/sync` command |
194
- | `registerTools` | `true` | Register the `sync_*` tools when the tools service is present |
195
-
196
- Example override in your profile patch:
254
+ - **权限**:写操作走确认门(`confirmVia`);插件从不重新实现或绕过 harness 的 `userQuestions`/`approval` 服务。自动模式由配置授权覆盖,不再确认。
255
+ - **数据**:同步元数据(设备 id、最近推/拉、最近推送头、最近错误)存于 `session-sync` 存储领域。会话文件按不透明字节复制——插件从不解析它们。设备 id 也写入同步仓库的 `device.txt`,用于跨设备 fork 归属。
256
+ - **会话日志**:`sync/push`、`sync/pull`、`sync/conflict` 在 `types.d.ts` 中声明;仅当宿主收录这些类型时才追加(见已知限制)。所有写入与展示的内容都经过脱敏。插件写入的唯一持久消息——冲突 fork 通知——携带插件自有的 producer-owned source kind(`dsh-session-sync`);宿主已退役共享的 `plugin` kind,读回会话时一律拒收。
197
257
 
198
- ```yaml
199
- - insert:
200
- - id: session-sync
201
- name: dsh-session-sync
202
- config:
203
- remote: git@github.com:you/your-dsh-sessions.git
204
- branch: main
205
- autoPushOnTurnEnd: true
206
- pullIntervalMinutes: 30
207
- confirmVia: userQuestions
208
- ```
258
+ ## 加密与威胁模型
209
259
 
210
- ## Tools & surfaces
260
+ `backend: encrypted` 在镜像之上增加一层可选的 **age** 加密:会话字节在提交与推送前加密为 `encrypted/**/*.age` 文件,合并前再解密回本地明文镜像。三方合并始终在本地明文上进行,因此追加式保留双方语义不变。
211
261
 
212
- | Surface | Read-only | Needs confirmation | Notes |
213
- |---|---|---|---|
214
- | `/sync status` | ✅ | — | Branch, sanitized remote, ahead/behind, dirty files, fork files, last pull/push |
215
- | `/sync diff` | ✅ | — | Uncommitted changes + `HEAD..remote` stat (read-only) |
216
- | `/sync log` | ✅ | — | Last commits in the sync repository |
217
- | `/sync pull` | | ✅ | Fetch + merge with keep-both semantics; local kept, remote preserved as forks |
218
- | `/sync push` | | ✅ | Mirror + commit + push; never force-pushes, reconciles and retries once on rejection |
219
- | `sync_status` | ✅ | — | Same facts as `/sync status` for the model |
220
- | `sync_pull` | | ✅ | Model-callable pull |
221
- | `sync_push` | | ✅ | Model-callable push |
262
+ 加密**保护**什么:
222
263
 
223
- ## Permissions & data
264
+ - **远端中的镜像内容。** 你推送的会话文件是 age 密文;远端主机、其运维者以及任何克隆该仓库的人,没有私钥都看不到明文的会话字节。
224
265
 
225
- - **Permissions**: mutating operations cross the confirmation gate (`confirmVia`); the plugin never re-implements or bypasses the harness's `userQuestions`/`approval` services. Auto modes are covered by the config grant and never re-confirm.
226
- - **Data**: sync metadata (device id, last pull/push, last push head, last error) lives in the `session-sync` storage domain. Session files are copied as opaque bytes — the plugin never parses them. The device id is also written to `device.txt` in the sync repository for cross-device fork attribution.
227
- - **Session log**: `sync/push`, `sync/pull`, and `sync/conflict` are declared in `types.d.ts`; they are appended only when the host records the types (see Known limitations). Everything written or shown is sanitized. The one durable message the plugin writes — the conflict fork notice — carries the plugin's own producer-owned source kind (`dsh-session-sync`); the harness retired the shared `plugin` kind and refuses it when a session is read back.
266
+ 加密**不**保护什么(边界):
228
267
 
229
- ## Security boundaries
268
+ - **密钥与 age 身份由你管理。** 接收方/身份文件从不由插件随包分发、存储或轮换。密钥泄露会使它保护的镜像内容暴露。请使用无口令身份并把它放在仓库之外。
269
+ - **远端实际仍是私有仓库。** git 元数据——提交信息、`.gitignore`、`encrypted/` 路径结构、分支名与推拉活动——对远端主机依然可见。加密隐藏的是*内容*,不是你在同步这个事实,也不是会话树的形态。
270
+ - **明文仍存在于本地。** `<repoDir>/sessions/` 的镜像在磁盘上是明文;加密保护的是传输中/远端的那份,而非本地磁盘加密或正在使用的会话存储。
271
+ - **优雅降级意味着明文。** 使用 `backend: encrypted` 时,若 `age` 缺失,或 `ageRecipient`/`ageIdentity` 为空,插件会回退到明文 git 路径**并在状态/日志中显式告警**——它绝不假装已经加密。在把远端当作已加密之前,先检查 `/sync status` 中的告警。
230
272
 
231
- - **Never silently overwrite.** The append-only three-way merge keeps both sides on any divergence, including delete/modify (modified bytes kept, deletion intent honored); fork files are never deleted, and git never force-pushes, resets, rebases, or switches branches.
232
- - **Path containment.** Files are mirrored as opaque bytes with symlinks refused and every joined path containment-checked (`PATH_UNSAFE` fails loud).
233
- - **Sanitized output.** Remote-URL credentials, tokens, and `key=value` secrets are redacted before reaching the model or the log; path display refuses anything outside its root.
234
- - **No credential storage.** The plugin stores no credentials; git credentials live in your normal git credential helper. age keys are read from paths you configure (`ageIdentity`); keys never enter the sync repository.
235
- - **Git hardening.** Git runs with `GIT_TERMINAL_PROMPT=0` and `GIT_OPTIONAL_LOCKS=0`, deadline- and signal-bounded, with a per-stream output cap.
236
- - **Fail closed.** A missing confirmation answerer, a missing remote, or an unsafe path refuses the operation loudly.
273
+ 基线:`backend: git`(默认)下,会话字节以未加密形式存放在**你的** git 远端——请使用私有仓库。
237
274
 
238
- ## Encryption & threat model
275
+ ### 跨平台会话与 cwd 投影
239
276
 
240
- `backend: encrypted` adds an optional **age** layer above the mirror: session bytes are encrypted into `encrypted/**/*.age` files before they are committed and pushed, and decrypted back to the local plaintext mirror before merging. The three-way merge always runs on plaintext locally, so the append-only keep-both semantics are unchanged.
277
+ Windows ↔ Linux 会话的 `header.cwd` 在另一台机器上不是本机绝对路径:宿主 `dsh-workspace` 按 `realpath(header.cwd)` 建索引,`session-persistence-jsonl` 更是 header 解析失败就完全看不到会话。用 `cwdMap` 把源设备前缀映射到本机路径:
241
278
 
242
- What the encryption **protects**:
279
+ ```yaml
280
+ cwdMap:
281
+ - from: 'C:\Users\me'
282
+ to: /home/me/win
283
+ ```
243
284
 
244
- - **Mirror content at rest in the remote.** The session files you push are age ciphertext; the remote host, its operators, and anyone who clones the repository do not see plaintext session bytes without the private key.
285
+ - 最长前缀优先,前缀必须结束在路径段边界上(`C:\Users\me2` 不匹配 `C:\Users\me`)。
286
+ - 恢复时只投影**本地副本**:首帧 cwd 改写为本机路径、文件落到宿主布局的项目目录,因此会话出现在 workspace 列表里。同步仓库里的字节始终是源设备的 cwd;推送时把原首帧接回,对端看到的仍是逐字节 append,不会产生无意义分叉。
287
+ - 没有命中的跨平台 cwd 归一到 `<sessionRoot>/--unmapped--`:会话**可见但只读**,`sync_status` 的 `cwdUnmapped` 会计数,本地改动不会推送。给它补一条 `cwdMap` 后重新 pull 即可变成可继续的本地会话。
245
288
 
246
- What it does **not** protect (the boundary):
289
+ ### 符号链接(Android/proot)
247
290
 
248
- - **Keys and age identities are yours to manage.** The recipient/identity files are never shipped, stored, or rotated by the plugin. If a key leaks, the mirror content it protects is exposed. Use a passphrase-less identity and keep it out of the repository.
249
- - **The remote is still a private repository in practice.** git metadata — commit messages, the `.gitignore`, the `encrypted/` path structure, branch names, and push/fetch activity — remains visible to the remote host. Encryption hides the *content*, not the fact that you sync, nor the shape of your session tree.
250
- - **Plaintext still exists locally.** The mirror at `<repoDir>/sessions/` is plaintext on disk; encryption protects the transmitted/remote copy, not local disk encryption or the live session store.
251
- - **graceful degradation means plaintext.** With `backend: encrypted`, if `age` is missing, or `ageRecipient`/`ageIdentity` is empty, the plugin falls back to the plaintext git path **and warns explicitly** in the status/log — it never silently pretends to encrypt. Check `/sync status` for the warning before trusting the remote as encrypted.
291
+ 默认**绝不跟随符号链接**(安全边界)。Android/proot 的 `link2symlink` 会把宿主写入的会话文件报成符号链接(`readdir` 说是链接、`readlink` 为空、内容可读),导致手机自己的会话永远不进镜像。诊断与可选跟随:
252
292
 
253
- Baseline: with `backend: git` (the default), session bytes are stored unencrypted in **your** git remote — use a private repository.
293
+ - `sync_status` 新增 `skippedSymlinks` / `skippedSymlinkPaths`(数量与路径样本)、`followedSymlinks`,push 结果也会带同类 warning;
294
+ - `followSessionSymlinks: true`(默认 `false`)只跟随 `realpath` 仍落在 `sessionRoot` 内的链接,越界链接一律跳过并计数。
254
295
 
255
- ## Known limitations
296
+ ## 已知限制
256
297
 
257
- - **Object storage backend reserved.** `object-storage` is an interface placeholder and fails loudly at load; only `git` and `encrypted` are implemented.
258
- - **git required.** The plugin needs the `git` executable and the `subprocess` service; without them, sync operations fail with a clear reason (profiles keep booting).
259
- - **age is optional, external.** Encryption depends on the `age` binary on `PATH` (or `ageBin`). No `age` → plaintext fallback with a warning; a passphrase-protected identity cannot be used (decryption would block on a TTY prompt, so it fails closed).
260
- - **One repoDir per backend.** Switching between `git` and `encrypted` on the same `repoDir` is not supported; use a fresh worktree per backend.
261
- - **Session events on `0.1.0-rc.6`/`0.1.0-rc.8`/`0.1.1-rc.2`/`0.1.2-alpha.2`/`0.1.2-alpha.3`/`0.1.2-rc.1`/`0.1.7-alpha.2`.** The harness does not record `sync/*` event types, so the session-log appends are skipped (sessions keep loading); the plugin enables them automatically once a host records the types or exposes the `ignorable` envelope on `Session.append`.
262
- - **`approval` between turns.** `/sync` runs between turns, where the `approval` channel has no open turn to attach to; use `confirmVia: userQuestions` for command-driven sync, or drive sync through the tools inside a turn. The open-turn check reads the host `turnBoundary` session projection: a composition without `@deepseek-ai/dsh-session-projection` cannot verify the turn state and fails closed with that reason.
263
- - **Host-private artifacts stay host-private.** `session.lock` (the harness session lease) and `session.migration.*.tmp` staging files are never mirrored or deleted — they are runtime state, not syncable content. Session logs (`session.jsonl`, `session.v[1-9]*.jsonl[.zstd]`) remain the mirrored payload.
298
+ - **加密可选、age 为外部依赖。** `backend: encrypted` 增加一层 age 加密(见上文「加密与威胁模型」);`age` 缺失或 `ageRecipient`/`ageIdentity` 为空时显式告警并降级明文,口令保护的 identity 不可用(解密会阻塞在 TTY 提示上,因此失败关闭)。`backend: git`(默认)下,会话字节以未加密形式存放在**你的** git 远端——请使用私有仓库。
299
+ - **`object-storage` 后端为预留接口。** 它是接口占位符,加载时响亮失败;只实现了 `git` 与 `encrypted`。
300
+ - **依赖 git。** 插件需要 `git` 可执行文件与 `subprocess` 服务;没有它们时同步操作会给出明确原因失败(profile 仍可启动)。
301
+ - **一个 `repoDir` 只对应一个 backend。** 在同一个 `repoDir` 上从 `git` 切换到 `encrypted`(或反向)不受支持;每个 backend 使用全新的工作树。
302
+ - **`0.1.0-rc.6`/`0.1.0-rc.8`/`0.1.1-rc.2`/`0.1.2-alpha.2`/`0.1.2-alpha.3`/`0.1.2-rc.1`/`0.1.7-alpha.2` 上的会话事件。** harness 尚未收录 `sync/*` 事件类型,因此会话日志追加被跳过(会话仍可加载);宿主收录类型或 `Session.append` 暴露 `ignorable` 信封后插件会自动开启。
303
+ - **轮次间的 `approval`。** `/sync` 在轮次之间运行,`approval` 通道没有开放轮次可挂靠;请对命令式同步使用 `confirmVia: userQuestions`,或在轮次内经工具驱动同步。开放轮次判定读宿主 `turnBoundary` 会话投影:未组合 `@deepseek-ai/dsh-session-projection` 时无法核实轮次状态,按失败关闭并给出该原因。
304
+ - **宿主私有产物不进同步。** `session.lock`(宿主会话租约)与 `session.migration.*.tmp`(迁移暂存)永不镜像、永不删除——它们是运行时状态而非可同步内容;会话日志(`session.jsonl`、`session.v[1-9]*.jsonl[.zstd]`)仍是镜像载荷。
264
305
 
265
- ## Development
306
+ ## 兼容性
266
307
 
267
- ```sh
268
- pnpm install # node ^22.19 || >=24
269
- pnpm run typecheck && pnpm run typecheck:ci # tsc --checkJs against the published 0.1.7-alpha.2 peers
270
- pnpm test # node --test (13 test files; the engine git suite skips without git)
271
- pnpm run verify:self-contained # dependency specs resolve from the registry
272
- pnpm run verify:artifacts # shipped files present + index.mjs importable
273
- pnpm run check:readmes # five-language README consistency
274
- pnpm pack # the published tarball
275
- ```
308
+ | 项目 | 状态 |
309
+ |---|---|
310
+ | Harness | DeepSeek Harness `dsh-v0.2.1-alpha.1`(GitHub tag,2026-09-25 已核验:完整门控链,针对钉住的 `0.1.7-rc.2` peers)。npm 依赖线 `0.1.7-rc.2`,peers `>=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0 \|\| >=0.1.6-0 <0.2.0 \|\| >=0.1.7-0 <0.2.0`。(2026-10-04 已适配):冲突 fork 通知携带插件自有的 producer-owned 消息 source kind——宿主已退役共享的 `plugin` kind,读回时一律拒收。 |
311
+ | Node | `^22.19.0 \|\| >=24.9.0` |
312
+ | 平台 | 任何能运行 `git` 和 DSH 的环境(基于 git 镜像;无平台特定代码) |
313
+ | 模型 | 纯文本模型即可完整支持;无需视觉或额外模型能力 |
276
314
 
277
- There is no build step: pure ESM, `index.mjs` and `lib/` are the shipped artifacts.
315
+ ## 生态与质量
278
316
 
279
- ## Topics
317
+ - [Gitee 镜像](https://gitee.com/perrylink/dsh-session-sync)(同步镜像,以 GitHub 为准)
318
+ - [dshfind 插件页](https://dshfind.com/plugins/PerryLink/dsh-session-sync)(安装量与排名)
319
+ - [OpenSSF Scorecard 报告](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-session-sync)(由 [.github/workflows/scorecard.yml](.github/workflows/scorecard.yml) 驱动)
320
+ - [dsh-plugin-doctor 验证报告](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)(K10–K13 的历史验证徽章)
321
+ - [DSH Market](https://dsh.market/)(已上架)
322
+ - **1024 商店渠道**:先 `npm i -g dsh1024`,再 `dsh1024 plugin --profile web add dsh-session-sync`(计入 [deepseek1024.com](https://deepseek1024.com) 安装排行)
323
+ - [生态实测知识库](https://perrylink.github.io/dsh-plugin-guide/):插件开发指南 · 选型实测数据 · 维护取舍判据
280
324
 
281
- `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `session-sync`, `session`, `git`, `sync`, `cross-device`
325
+ ## 开发
282
326
 
283
- ## Contributors
327
+ ```sh
328
+ pnpm install # node ^22.19 || >=24.9
329
+ pnpm run typecheck && pnpm run typecheck:ci # tsc --checkJs:checkout 面 + 已发布线面
330
+ pnpm test # node --test(14 个测试文件;git 引擎套件在无 git 时跳过)
331
+ pnpm run verify:self-contained # 依赖 spec 均可从 registry 解析
332
+ pnpm run verify:artifacts # 发布文件齐全 + index.mjs 可 import
333
+ pnpm run check:readmes # 五语 README 一致性
334
+ pnpm pack # 发布 tarball
335
+ ```
284
336
 
285
- - [@BlakrPander](https://github.com/BlakrPander) — PAT-as-username redaction and the delete/modify keep-both analysis (#14); both halves shipped in 0.2.27/0.2.28.
337
+ 无构建步骤:纯 ESM,`index.mjs` 与 `lib/` 即发布产物。配图由 [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) 程序化生成(Python + Pillow),可重复执行。
286
338
 
287
- - [@PerryLink](https://github.com/PerryLink) — creator and maintainer: git mirror engine, append-only keep-both merge, `/sync` command and `sync_*` tools, auto modes, sanitizers, and the five-language docs.
339
+ Topics:`dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `session-sync`, `session`, `git`, `sync`, `cross-device`
288
340
 
289
- ## PerryLink DSH Plugin Family
341
+ ## 家族与致谢
290
342
 
291
- This project is part of the DeepSeek Harness plugin family from [PerryLink](https://github.com/PerryLink). The roster stays collapsed below so every README keeps a short first screen; expand it to see every row and its status.
343
+ 本项目是 [PerryLink](https://github.com/PerryLink) 维护的 DeepSeek Harness 插件家族成员(全部 Apache-2.0)。如果这个插件帮到了你,**给个 star**——它不解锁任何功能,但会让下一个人更容易找到它。
344
+
345
+ - [@BlakrPander](https://github.com/BlakrPander) —— PAT-as-username 脱敏与 delete/modify 两边保留分析(#14);两部分随 0.2.27/0.2.28 发布。
346
+ - [@PerryLink](https://github.com/PerryLink) —— 创建者与维护者:git 镜像引擎、append-only 两边保留合并、`/sync` 命令与 `sync_*` 工具、自动模式、脱敏器与五语文档。
292
347
 
293
348
  <details>
294
- <summary>Expand all plugins</summary>
349
+ <summary>展开全部插件</summary>
295
350
 
296
- | Plugin | Status |
351
+ | 插件 | 状态 |
297
352
  |---|---|
298
353
  | **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
299
354
  | **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
300
355
  | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
301
- | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 FROZEN — see the repo README |
356
+ | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 已冻结 — 见仓库 README |
302
357
  | **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
303
358
  | **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
304
- | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 FROZEN — see the repo README |
359
+ | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 已冻结 — 见仓库 README |
305
360
  | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
306
361
  | **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
307
362
  | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
308
363
  | **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
309
364
  | **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
310
- | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | |
365
+ | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | 🧊 已冻结 — 见仓库 README |
311
366
  | **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
312
367
  | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
313
368
  | **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
@@ -340,7 +395,7 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
340
395
  | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
341
396
  | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
342
397
  | **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
343
- | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | |
398
+ | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | 🧊 已冻结 — 见仓库 README |
344
399
  | **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
345
400
  | **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
346
401
  | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
@@ -352,10 +407,10 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
352
407
  | **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
353
408
  | **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
354
409
  | **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
355
- | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | |
410
+ | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | 🚫 已退役(仓库已归档) |
356
411
  | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
357
- | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | |
358
- | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | |
412
+ | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | 🚫 已退役(仓库已归档) |
413
+ | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | 🚫 已退役(仓库已归档) |
359
414
  | **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
360
415
  | **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
361
416
  | **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
@@ -367,7 +422,7 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
367
422
  | **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
368
423
  | **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
369
424
  | **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
370
- | **[dsh-score](https://github.com/PerryLink/dsh-score)** | |
425
+ | **[dsh-score](https://github.com/PerryLink/dsh-score)** | 🧊 已冻结 — 见仓库 README |
371
426
  | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
372
427
  | **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
373
428
  | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
@@ -379,20 +434,22 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
379
434
  | **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
380
435
  | **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
381
436
  | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
382
- | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | |
437
+ | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | 🚫 已退役(仓库已归档) |
383
438
  | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
384
439
  | **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
385
- | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 FROZEN — see the repo README |
386
- | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 FROZEN — see the repo README |
387
- | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 FROZEN — see the repo README |
388
- | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 FROZEN — see the repo README |
389
- | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 FROZEN — see the repo README |
390
- | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 RETIRED — see the repo README |
391
- | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 RETIRED — see the repo README |
392
- | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 RETIRED — see the repo README |
440
+ | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 已冻结 — 见仓库 README |
441
+ | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 已冻结 — 见仓库 README |
442
+ | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 已冻结 — 见仓库 README |
443
+ | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 已冻结 — 见仓库 README |
444
+ | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 已冻结 — 见仓库 README |
445
+ | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 已退役(仓库已归档) |
446
+ | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 已退役(仓库已归档) |
447
+ | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 已退役(仓库已归档) |
393
448
 
394
449
  </details>
395
450
 
396
451
  ## License
397
452
 
398
- [LICENSE](LICENSE) (Apache License 2.0) © 2026 dsh-session-sync contributors
453
+ [LICENSE](LICENSE)(Apache License 2.0)© 2026 dsh-session-sync contributors
454
+
455
+ <p align="center"><sub>Apache-2.0 · 社区插件,与 DeepSeek 无关。</sub></p>