dsh-session-sync 0.2.32 → 0.2.33

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,199 +1,191 @@
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
-
36
- **📖 Ecosystem knowledge base** — measured data, not marketing: [plugin development guide · plugin-selection data · maintenance criteria](https://perrylink.github.io/dsh-plugin-guide/).
35
+ <sub>社区插件,与 DeepSeek 官方无关。本仓库是唯一官方仓库,由 PerryLink 维护;其他账号下的同名仓库与本项目无关。Gitee 为镜像。</sub>
37
36
 
38
- <!-- star-cta -->
39
- ## Install & uninstall
37
+ ## 它是什么
40
38
 
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).
39
+ `dsh-session-sync` 把 DSH 会话存储(`$DSH_HOME/sessions`)镜像到一个专用 git 工作树,再同步到**你自己**控制的远端:没有云服务,没有第三方存储。会话文件按不透明字节复制,插件从不解析 JSONL/zstd——物理编码属于 harness,插件的职责只是搬运字节、合并 append-only 历史并报告状态。发生分歧时走 append-only 三方合并:**两边都保留**,远端版本留存为 fork 文件,绝不静默覆盖。默认 `backend: git` 是明文镜像;`backend: encrypted` 在镜像之上加一层 age 加密;自动模式全部可配置、可逆。
45
40
 
46
- ## ⭐ 如果它帮到了你
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>
47
47
 
48
- 这个插件是 [DSH 插件家族](https://github.com/PerryLink)的一员(95 个,全部 Apache-2.0)。如果你在用,**给个 star** —— 它不会解锁任何功能,但会让下一个人在搜索里更容易找到它。
48
+ ## 三步上手
49
49
 
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.
50
+ 1. **安装**(三选一):
51
51
 
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
+ ```
52
60
 
53
- ## What is dsh-session-sync?
61
+ 无构建步骤——`index.mjs` 与 `lib/` 即发布产物。
54
62
 
55
- Cross-device session sync for DeepSeek Harness — a dedicated git mirror of your session store.
63
+ 2. **最小配置**(在你的 profile patch 里指向一个**私有** git 远端):
56
64
 
57
- Sync your sessions between devices, keep both sides on any conflict, never lose a turn.
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
+ ```
58
72
 
59
- ![Workflow diagram for dsh-session-sync: request → policy / review → verdict.](docs/assets/dsh-session-sync-flow.svg)
73
+ 3. **验证已生效**:
60
74
 
61
- *Workflow overview: request → policy / review → verdict. The examples below use the real command surface.*
75
+ ```sh
76
+ dsh --profile web --dump-config | grep -A2 'id: session-sync'
77
+ ```
62
78
 
79
+ ```
80
+ > /sync status
81
+ > /sync pull
82
+ > /sync push
83
+ ```
63
84
 
85
+ **卸载**:`dsh plugin --profile web remove dsh-session-sync`(或从 profile patch 删掉该行)。
64
86
 
65
- ## Compatibility
87
+ ## 核心能力
66
88
 
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 |
73
-
74
- ## What you get
75
-
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:
89
+ `dsh-session-sync` 在主机侧把会话存储变成可版本化的 git 镜像,并把同步动作交给你的远端:
77
90
 
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.
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`);只读界面从不询问;没有回答者时操作失败关闭。
83
96
 
84
97
  ```text
85
- device A remote (your git repo) device B
86
- $DSH_HOME/sessions ──mirror──▶ commit ──push──▶ [sessions] ──pull──▶ merge (keep-both + fork)
87
- ```
88
-
89
- ## Quick start
90
-
91
- ```sh
92
- dsh plugin --profile web add github:PerryLink/dsh-session-sync
93
- ```
94
-
95
- ```sh
96
- # 1. install the bundle into your profile
97
- dsh plugin --profile web add github:PerryLink/dsh-session-sync
98
-
99
- # or from npm (published releases)
100
- dsh plugin --profile web add dsh-session-sync
101
-
102
- # 2. point it at a private git remote and verify the row
103
- dsh --profile web --dump-config | grep -A2 'id: session-sync'
98
+ 设备 A 远端(你的 git 仓库) 设备 B
99
+ $DSH_HOME/sessions ──镜像──▶ 提交 ──推送──▶ [sessions] ──拉取──▶ 合并(两边保留 + fork)
104
100
  ```
105
101
 
106
- Then set the remote in your profile patch (a **private** repository is the baseline) and sync:
102
+ ### 命令与工具面
107
103
 
108
- ```yaml
109
- - insert:
110
- - id: session-sync
111
- name: dsh-session-sync
112
- config:
113
- remote: git@github.com:you/your-dsh-sessions.git
114
- ```
115
-
116
- ```
117
- > /sync status
118
- > /sync pull
119
- > /sync push
120
- ```
121
-
122
- ### Examples
123
-
124
- These are the plugin's real entry points; install once, then call one.
125
-
126
- #### Detailed example
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` | | ✅ | 模型可调用的推送 |
127
114
 
128
- **Command**
115
+ ### 示例
129
116
 
130
- ~~~sh
131
- /sync help
132
- ~~~
117
+ 以下为插件真实入口;安装后调用一个即可。
133
118
 
134
- **Output**
119
+ **详细示例** —— 命令 `/sync help`:
135
120
 
136
- ~~~text
121
+ ```text
137
122
  sync: usage — /sync [status | pull | push | diff | log | help]
138
123
  status show mirror state (default): branch, remote, ahead/behind, dirty, forks
139
124
  pull fetch + merge remote changes (keep-both; confirms first)
140
125
  push mirror + commit + push local changes (confirms first)
141
126
  diff uncommitted changes + HEAD..remote stat (read-only)
142
127
  log last commits in the sync repository
143
- ~~~
128
+ ```
144
129
 
145
130
  *Observed from `index.mjs:754-765 (registered /sync handler)`*
146
131
 
147
- #### Failure branch
148
-
149
- **Input**
150
-
151
- ~~~text
152
- /sync push
153
- ~~~
132
+ **失败分支** —— 输入 `/sync push`:
154
133
 
155
- **Output**
156
-
157
- ~~~text
134
+ ```text
158
135
  sync: cancelled: approval requires an open turn; /sync commands run between turns — mount userQuestions or set confirmVia: userQuestions
159
- ~~~
136
+ ```
160
137
 
161
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`*
162
139
 
163
- #### Brief examples
140
+ **简短示例**:`/sync diff` · `/sync pull`
164
141
 
165
- - `/sync diff`
166
- - `/sync pull`
142
+ ## 配置
167
143
 
168
- ## Configuration
144
+ 所有可调项都是 Schemastery `Config` 字段(可从 cordis.yml 覆盖)。按 id 覆盖会替换整行——请重述所有需要的键。`cordis.patch.yml` 逐键内联注释。
169
145
 
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.
146
+ 最常用键:
171
147
 
172
- | Key | Default | Meaning |
148
+ | 键 | 默认值 | 含义 |
173
149
  |---|---|---|
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:
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
+ | `confirmVia` | `auto` | 确认通道:`auto`(优先 userQuestions,其次 approval)、`userQuestions`、`approval` |
158
+
159
+ <details>
160
+ <summary>完整配置表(21 个键)</summary>
161
+
162
+ | 键 | 默认值 | 含义 |
163
+ |---|---|---|
164
+ | `enabled` | `true` | 总开关;`false` 卸载命令、工具、监听器与自动模式 |
165
+ | `backend` | `git` | 同步后端:`git`(明文镜像)或 `encrypted`(age 加密镜像内容) |
166
+ | `sessionRoot` | `''` | 会话存储根;空 = `$DSH_HOME/sessions`(两者皆缺加载失败) |
167
+ | `repoDir` | `''` | 同步工作树根;空 = `$DSH_HOME/dsh-session-sync/repo` |
168
+ | `remote` | `''` | 远端地址(pull/push 前必须非空;status/diff 无需) |
169
+ | `branch` | `main` | 远端分支名 |
170
+ | `gitBin` | `git` | git 可执行路径 |
171
+ | `ageBin` | `age` | age 可执行路径(`backend: encrypted` 时探测;缺失降级明文) |
172
+ | `ageRecipient` | `''` | age 收件人(公钥/身份串);空 = 无法加密、降级明文 |
173
+ | `ageIdentity` | `''` | 无口令 age 私钥文件路径(用于解密);空 = 无法解密、降级明文 |
174
+ | `autoPullOnStart` | `false` | 插件挂载时拉取一次(配置即授权,不再确认) |
175
+ | `autoPushOnTurnEnd` | `false` | 每个关闭轮次后推送 |
176
+ | `pullIntervalMinutes` | `0` | 每 N 分钟周期拉取(`0` = 关闭,最大 `10080`) |
177
+ | `confirmVia` | `auto` | 确认通道:`auto`(优先 userQuestions,其次 approval)、`userQuestions`、`approval` |
178
+ | `graceMs` | `10000` | git 终止宽限(毫秒) |
179
+ | `commandTimeoutMs` | `120000` | 单条命令超时(毫秒) |
180
+ | `maxOutputBytes` | `262144` | 单流收集输出上限(字节) |
181
+ | `commitName` | `dsh-session-sync` | 提交者名 |
182
+ | `commitEmail` | `dsh-session-sync@localhost` | 提交者邮箱 |
183
+ | `registerCommand` | `true` | 注册 `/sync` 命令 |
184
+ | `registerTools` | `true` | tools 服务存在时注册 `sync_*` 工具 |
185
+
186
+ </details>
187
+
188
+ 在你的 profile patch 中的覆盖示例:
197
189
 
198
190
  ```yaml
199
191
  - insert:
@@ -207,107 +199,145 @@ Example override in your profile patch:
207
199
  confirmVia: userQuestions
208
200
  ```
209
201
 
210
- ## Tools & surfaces
202
+ ## FAQ
211
203
 
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 |
204
+ <details>
205
+ <summary>数据到底存在哪?会上传到云端吗?</summary>
222
206
 
223
- ## Permissions & data
207
+ 没有云服务,也没有第三方存储。本机有两份副本:`$DSH_HOME/sessions`(harness 的会话存储)与你配置的 `repoDir` 工作树(默认 `$DSH_HOME/dsh-session-sync/repo`);远端是**你自己的** git 仓库。`backend: encrypted` 只把推送/远端的副本变成 age 密文,本地镜像仍是明文。
224
208
 
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.
209
+ </details>
228
210
 
229
- ## Security boundaries
211
+ <details>
212
+ <summary>冲突会覆盖或丢掉会话吗?</summary>
230
213
 
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.
214
+ 不会静默覆盖。会话日志是 append-only,三方合并在任何分歧时都保留两边:本地版本保留,远端版本存成 `<basename>.remote-fork-<UTC 14 位时间戳>-<device8>` 的 fork 文件;fork 文件永不被删除或覆盖,git 绝不强推、reset、rebase 或切换分支。分歧的会话还会在会话层面 fork,并向子会话注入一条持久通知。
237
215
 
238
- ## Encryption & threat model
216
+ </details>
239
217
 
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.
218
+ <details>
219
+ <summary>加密是默认开启的吗?age 缺失会怎样?</summary>
241
220
 
242
- What the encryption **protects**:
221
+ 不是,默认 `backend: git`,会话字节以未加密形式存放在你的远端——请使用私有仓库。`backend: encrypted` 需要 `age` 以及非空的 `ageRecipient`/`ageIdentity`;任一缺失时插件显式告警并降级为明文 git,绝不假装已经加密。把远端当作已加密之前,先检查 `/sync status` 中的告警。
243
222
 
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.
223
+ </details>
245
224
 
246
- What it does **not** protect (the boundary):
225
+ <details>
226
+ <summary>没有 git、或者没有确认回答者会怎样?</summary>
247
227
 
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.
228
+ 缺少 `git` 可执行文件或 `subprocess` 服务时,同步操作以明确原因失败(profile 仍可启动)。`/sync` 在两轮之间运行,`approval` 通道没有开放轮次可挂靠:请用 `confirmVia: userQuestions`,或在轮次内经 `sync_*` 工具同步;完全没有回答者时操作失败关闭。
252
229
 
253
- Baseline: with `backend: git` (the default), session bytes are stored unencrypted in **your** git remote — use a private repository.
230
+ </details>
254
231
 
255
- ## Known limitations
232
+ <details>
233
+ <summary>性能开销多大?自动模式会一直跑吗?</summary>
256
234
 
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.
235
+ 会话文件按不透明字节复制,不解析内容;每条 git 命令都有超时、终止宽限与单流输出上限。自动推送默认关闭,周期拉取默认关闭(`pullIntervalMinutes: 0`),启动拉取默认关闭——开启后才由配置授权、不再逐次确认。开销取决于会话存储体积与远端延迟;本仓库没有基准数据,不给出编造的数字。
264
236
 
265
- ## Development
237
+ </details>
266
238
 
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
- ```
239
+ ## 安全边界
276
240
 
277
- There is no build step: pure ESM, `index.mjs` and `lib/` are the shipped artifacts.
241
+ - **绝不静默覆盖。** append-only 三方合并在任何分歧时都保留两边,包括 delete/modify(修改后的字节保留、删除意图被尊重);fork 文件永不被删除,git 绝不强推、reset、rebase 或切换分支。
242
+ - **路径收容。** 文件按不透明字节镜像、拒绝符号链接,每次路径拼接都做收容校验(`PATH_UNSAFE` 响亮失败)。
243
+ - **脱敏输出。** 远端 URL 凭据、令牌与 `key=value` 密钥在进入模型或日志前被打码;路径展示拒绝根外路径。
244
+ - **不存凭据。** 插件自身不存凭据;git 凭据由你常规的 git credential helper 管理。age 身份/接收方文件由你管理,密钥绝不进入同步仓库。
245
+ - **git 加固。** git 以 `GIT_TERMINAL_PROMPT=0`、`GIT_OPTIONAL_LOCKS=0` 运行,带截止时间与信号边界,输出按流封顶。
246
+ - **失败关闭。** 缺少确认回答者、缺少远端或不安全路径都会响亮拒绝操作。
278
247
 
279
- ## Topics
248
+ ## 权限与数据
280
249
 
281
- `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `session-sync`, `session`, `git`, `sync`, `cross-device`
250
+ - **权限**:写操作走确认门(`confirmVia`);插件从不重新实现或绕过 harness 的 `userQuestions`/`approval` 服务。自动模式由配置授权覆盖,不再确认。
251
+ - **数据**:同步元数据(设备 id、最近推/拉、最近推送头、最近错误)存于 `session-sync` 存储领域。会话文件按不透明字节复制——插件从不解析它们。设备 id 也写入同步仓库的 `device.txt`,用于跨设备 fork 归属。
252
+ - **会话日志**:`sync/push`、`sync/pull`、`sync/conflict` 在 `types.d.ts` 中声明;仅当宿主收录这些类型时才追加(见已知限制)。所有写入与展示的内容都经过脱敏。插件写入的唯一持久消息——冲突 fork 通知——携带插件自有的 producer-owned source kind(`dsh-session-sync`);宿主已退役共享的 `plugin` kind,读回会话时一律拒收。
282
253
 
283
- ## Contributors
254
+ ## 加密与威胁模型
284
255
 
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.
256
+ `backend: encrypted` 在镜像之上增加一层可选的 **age** 加密:会话字节在提交与推送前加密为 `encrypted/**/*.age` 文件,合并前再解密回本地明文镜像。三方合并始终在本地明文上进行,因此追加式保留双方语义不变。
286
257
 
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.
258
+ 加密**保护**什么:
288
259
 
289
- ## PerryLink DSH Plugin Family
260
+ - **远端中的镜像内容。** 你推送的会话文件是 age 密文;远端主机、其运维者以及任何克隆该仓库的人,没有私钥都看不到明文的会话字节。
290
261
 
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.
262
+ 加密**不**保护什么(边界):
263
+
264
+ - **密钥与 age 身份由你管理。** 接收方/身份文件从不由插件随包分发、存储或轮换。密钥泄露会使它保护的镜像内容暴露。请使用无口令身份并把它放在仓库之外。
265
+ - **远端实际仍是私有仓库。** git 元数据——提交信息、`.gitignore`、`encrypted/` 路径结构、分支名与推拉活动——对远端主机依然可见。加密隐藏的是*内容*,不是你在同步这个事实,也不是会话树的形态。
266
+ - **明文仍存在于本地。** `<repoDir>/sessions/` 的镜像在磁盘上是明文;加密保护的是传输中/远端的那份,而非本地磁盘加密或正在使用的会话存储。
267
+ - **优雅降级意味着明文。** 使用 `backend: encrypted` 时,若 `age` 缺失,或 `ageRecipient`/`ageIdentity` 为空,插件会回退到明文 git 路径**并在状态/日志中显式告警**——它绝不假装已经加密。在把远端当作已加密之前,先检查 `/sync status` 中的告警。
268
+
269
+ 基线:`backend: git`(默认)下,会话字节以未加密形式存放在**你的** git 远端——请使用私有仓库。
270
+
271
+ ## 已知限制
272
+
273
+ - **加密可选、age 为外部依赖。** `backend: encrypted` 增加一层 age 加密(见上文「加密与威胁模型」);`age` 缺失或 `ageRecipient`/`ageIdentity` 为空时显式告警并降级明文,口令保护的 identity 不可用(解密会阻塞在 TTY 提示上,因此失败关闭)。`backend: git`(默认)下,会话字节以未加密形式存放在**你的** git 远端——请使用私有仓库。
274
+ - **`object-storage` 后端为预留接口。** 它是接口占位符,加载时响亮失败;只实现了 `git` 与 `encrypted`。
275
+ - **依赖 git。** 插件需要 `git` 可执行文件与 `subprocess` 服务;没有它们时同步操作会给出明确原因失败(profile 仍可启动)。
276
+ - **一个 `repoDir` 只对应一个 backend。** 在同一个 `repoDir` 上从 `git` 切换到 `encrypted`(或反向)不受支持;每个 backend 使用全新的工作树。
277
+ - **`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` 信封后插件会自动开启。
278
+ - **轮次间的 `approval`。** `/sync` 在轮次之间运行,`approval` 通道没有开放轮次可挂靠;请对命令式同步使用 `confirmVia: userQuestions`,或在轮次内经工具驱动同步。开放轮次判定读宿主 `turnBoundary` 会话投影:未组合 `@deepseek-ai/dsh-session-projection` 时无法核实轮次状态,按失败关闭并给出该原因。
279
+ - **宿主私有产物不进同步。** `session.lock`(宿主会话租约)与 `session.migration.*.tmp`(迁移暂存)永不镜像、永不删除——它们是运行时状态而非可同步内容;会话日志(`session.jsonl`、`session.v[1-9]*.jsonl[.zstd]`)仍是镜像载荷。
280
+
281
+ ## 兼容性
282
+
283
+ | 项目 | 状态 |
284
+ |---|---|
285
+ | 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,读回时一律拒收。 |
286
+ | Node | `^22.19.0 \|\| >=24.9.0` |
287
+ | 平台 | 任何能运行 `git` 和 DSH 的环境(基于 git 镜像;无平台特定代码) |
288
+ | 模型 | 纯文本模型即可完整支持;无需视觉或额外模型能力 |
289
+
290
+ ## 生态与质量
291
+
292
+ - [Gitee 镜像](https://gitee.com/perrylink/dsh-session-sync)(同步镜像,以 GitHub 为准)
293
+ - [dshfind 插件页](https://dshfind.com/plugins/PerryLink/dsh-session-sync)(安装量与排名)
294
+ - [OpenSSF Scorecard 报告](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-session-sync)(由 [.github/workflows/scorecard.yml](.github/workflows/scorecard.yml) 驱动)
295
+ - [dsh-plugin-doctor 验证报告](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)(K10–K13 的历史验证徽章)
296
+ - [DSH Market](https://dsh.market/)(已上架)
297
+ - **1024 商店渠道**:先 `npm i -g dsh1024`,再 `dsh1024 plugin --profile web add dsh-session-sync`(计入 [deepseek1024.com](https://deepseek1024.com) 安装排行)
298
+ - [生态实测知识库](https://perrylink.github.io/dsh-plugin-guide/):插件开发指南 · 选型实测数据 · 维护取舍判据
299
+
300
+ ## 开发
301
+
302
+ ```sh
303
+ pnpm install # node ^22.19 || >=24.9
304
+ pnpm run typecheck && pnpm run typecheck:ci # tsc --checkJs:checkout 面 + 已发布线面
305
+ pnpm test # node --test(14 个测试文件;git 引擎套件在无 git 时跳过)
306
+ pnpm run verify:self-contained # 依赖 spec 均可从 registry 解析
307
+ pnpm run verify:artifacts # 发布文件齐全 + index.mjs 可 import
308
+ pnpm run check:readmes # 五语 README 一致性
309
+ pnpm pack # 发布 tarball
310
+ ```
311
+
312
+ 无构建步骤:纯 ESM,`index.mjs` 与 `lib/` 即发布产物。配图由 [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) 程序化生成(Python + Pillow),可重复执行。
313
+
314
+ Topics:`dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `session-sync`, `session`, `git`, `sync`, `cross-device`
315
+
316
+ ## 家族与致谢
317
+
318
+ 本项目是 [PerryLink](https://github.com/PerryLink) 维护的 DeepSeek Harness 插件家族成员(全部 Apache-2.0)。如果这个插件帮到了你,**给个 star**——它不解锁任何功能,但会让下一个人更容易找到它。
319
+
320
+ - [@BlakrPander](https://github.com/BlakrPander) —— PAT-as-username 脱敏与 delete/modify 两边保留分析(#14);两部分随 0.2.27/0.2.28 发布。
321
+ - [@PerryLink](https://github.com/PerryLink) —— 创建者与维护者:git 镜像引擎、append-only 两边保留合并、`/sync` 命令与 `sync_*` 工具、自动模式、脱敏器与五语文档。
292
322
 
293
323
  <details>
294
- <summary>Expand all plugins</summary>
324
+ <summary>展开全部插件</summary>
295
325
 
296
- | Plugin | Status |
326
+ | 插件 | 状态 |
297
327
  |---|---|
298
328
  | **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
299
329
  | **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
300
330
  | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
301
- | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 FROZEN — see the repo README |
331
+ | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 已冻结 — 见仓库 README |
302
332
  | **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
303
333
  | **[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 |
334
+ | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 已冻结 — 见仓库 README |
305
335
  | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
306
336
  | **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
307
337
  | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
308
338
  | **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
309
339
  | **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
310
- | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | |
340
+ | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | 🧊 已冻结 — 见仓库 README |
311
341
  | **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
312
342
  | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
313
343
  | **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
@@ -340,7 +370,7 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
340
370
  | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
341
371
  | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
342
372
  | **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
343
- | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | |
373
+ | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | 🧊 已冻结 — 见仓库 README |
344
374
  | **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
345
375
  | **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
346
376
  | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
@@ -352,10 +382,10 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
352
382
  | **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
353
383
  | **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
354
384
  | **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
355
- | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | |
385
+ | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | 🚫 已退役(仓库已归档) |
356
386
  | **[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)** | |
387
+ | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | 🚫 已退役(仓库已归档) |
388
+ | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | 🚫 已退役(仓库已归档) |
359
389
  | **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
360
390
  | **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
361
391
  | **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
@@ -367,7 +397,7 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
367
397
  | **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
368
398
  | **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
369
399
  | **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
370
- | **[dsh-score](https://github.com/PerryLink/dsh-score)** | |
400
+ | **[dsh-score](https://github.com/PerryLink/dsh-score)** | 🧊 已冻结 — 见仓库 README |
371
401
  | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
372
402
  | **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
373
403
  | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
@@ -379,20 +409,22 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
379
409
  | **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
380
410
  | **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
381
411
  | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
382
- | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | |
412
+ | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | 🚫 已退役(仓库已归档) |
383
413
  | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
384
414
  | **[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 |
415
+ | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 已冻结 — 见仓库 README |
416
+ | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 已冻结 — 见仓库 README |
417
+ | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 已冻结 — 见仓库 README |
418
+ | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 已冻结 — 见仓库 README |
419
+ | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 已冻结 — 见仓库 README |
420
+ | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 已退役(仓库已归档) |
421
+ | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 已退役(仓库已归档) |
422
+ | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 已退役(仓库已归档) |
393
423
 
394
424
  </details>
395
425
 
396
426
  ## License
397
427
 
398
- [LICENSE](LICENSE) (Apache License 2.0) © 2026 dsh-session-sync contributors
428
+ [LICENSE](LICENSE)(Apache License 2.0)© 2026 dsh-session-sync contributors
429
+
430
+ <p align="center"><sub>Apache-2.0 · 社区插件,与 DeepSeek 无关。</sub></p>