dsh-panel-updater 1.0.0 → 1.0.1
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 +94 -74
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -1,113 +1,133 @@
|
|
|
1
|
-
# 更新器
|
|
1
|
+
# 更新器 · dsh-panel-updater
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
> DeepSeek Harness 的左侧栏更新器:一次点击,看清每个插件的版本、依赖与扩展状态。
|
|
4
|
+
|
|
5
|
+
[](https://www.npmjs.com/package/dsh-panel-updater)
|
|
6
|
+
[](./LICENSE)
|
|
7
|
+
[](https://github.com/deepseek-ai)
|
|
8
|
+
|
|
9
|
+
装到十几个插件之后,麻烦的其实只有三件事:**谁该更新**、**为什么不工作了**、**换台电脑怎么搬过去**。更新器把这三件事收进一个面板。
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 安装
|
|
4
14
|
|
|
5
15
|
```powershell
|
|
6
16
|
dsh plugin add dsh-panel-updater
|
|
7
17
|
```
|
|
8
18
|
|
|
9
|
-
|
|
19
|
+
也可以在 DSH 的「插件」页搜索 `dsh-panel-updater`。
|
|
10
20
|
|
|
11
|
-
|
|
21
|
+
装好后左侧栏会出现一个循环箭头图标,点开就是面板。
|
|
12
22
|
|
|
13
|
-
|
|
23
|
+
---
|
|
14
24
|
|
|
15
|
-
|
|
16
|
-
2. 对每个包向包源查询 `pluginManager.listVersions()`;同时读取 `pluginMarket` 里配置的每个插件源索引,按包名比对源里的默认版本。
|
|
17
|
-
3. 两端取较高版本,若高于已装版本,就直接调用 `pluginManager.updateBundle()` **静默更新**,不再询问。
|
|
18
|
-
4. 全流程结果发布在两条回环地址路由上:`GET /api/dsh-updater/status`、`POST /api/dsh-updater/check`。
|
|
25
|
+
## 它能做什么
|
|
19
26
|
|
|
20
|
-
|
|
27
|
+
### 一眼看清所有插件
|
|
21
28
|
|
|
22
|
-
-
|
|
23
|
-
-
|
|
24
|
-
-
|
|
29
|
+
- **按来源分组**:云端安装 / 本地链接 / Git 副本 / 本插件
|
|
30
|
+
- **组内按"需要你处理"排序**:扩展加载失败 → 有可升级版本 → 缺依赖(必需或可选)→ npm 别名需手动升级 → 其余安静的排后面
|
|
31
|
+
- 每行给出:名称、当前版本、最新版本、状态、来源标识(`npm` / `本地` / `git`)
|
|
32
|
+
- **点名称**打开插件介绍页;旁边还有「仓库」「源」按钮;本地安装的会直接**打开系统资源管理器**定位到文件
|
|
25
33
|
|
|
34
|
+
### 更新,但不要打扰你
|
|
26
35
|
|
|
27
|
-
|
|
36
|
+
- **打开面板不会触发检查**——只读上一次的结果,秒开不卡
|
|
37
|
+
- 检查在后台按你设定的间隔静默进行,发现新版本直接装
|
|
38
|
+
- 想手动时:单条「升级」,或标题栏「一键升级(N)」,逐条执行并给出结果
|
|
39
|
+
- **已经是最新时按钮是灰的**,不给你点没用的按钮
|
|
28
40
|
|
|
29
|
-
|
|
30
|
-
- 点击图标打开中央面板:
|
|
31
|
-
- 顶部:上次检查时间(含这一轮的触发来源:启动检查 / 后台自检 / 打开面板)与「立即检查」;
|
|
32
|
-
- **后台自检设置卡**:自动检查开关、检查间隔(15 分钟 ~ 12 小时)、启动时检查、发现新版本自动安装。**每次改动立即保存**,宿主随即重排定时器,不需要重启。设置存放在 profile 目录的 `dsh-updater.settings.json`。
|
|
33
|
-
- 汇总行:已检查 / 已更新 / 最新 / 未核对 / 问题;
|
|
34
|
-
- **问题区**:红色是真正挡住更新的事(更新失败、源查询失败),黄色是不影响更新的提示(插件源连不上)。每条都显示「阶段 · 对象 · 原因」,诊断原文收进可展开的「查看诊断」;每条右侧带修复按钮——红色条目给「重试」,黄色条目给「重试源」;
|
|
35
|
-
- **插件表按来源分组**:云端安装 / 本地链接 / Git 副本 / 本插件;组内按「坏了 → 缺依赖 → 未核对 → 有更新 → 其余」排序;
|
|
36
|
-
- 每个插件行显示:名称(点开介绍页)、当前版本、最新版本、状态,以及第二行的**扩展加载状态**(`N 个扩展正常` / `N 个扩展未加载`)、**缺失依赖**、该包声明的 DSH 版本要求;
|
|
37
|
-
- 每行右侧按钮:**升级**(任何时候都能点,已最新会直接告诉你)、**修复**(有扩展加载失败时出现,重新挂载失败的 Loader 行)、**装依赖**(缺的 peer 恰好是市场里的 bundle 时出现)、**仓库**、**源**(本地安装显示「本地」并把路径放进悬停提示);
|
|
38
|
-
- 插件源表:每个索引是否可用、抓到多少条目;不可用时就地给「重试源」。市场服务未启用时直接说明。
|
|
41
|
+
### 依赖与扩展,真的会查
|
|
39
42
|
|
|
40
|
-
|
|
43
|
+
- 读每个包自己声明的 `peerDependencies`,并区分**必需**与**可选**:可选依赖缺失只提示「只影响对应附加功能」,不会误报成故障
|
|
44
|
+
- 扩展状态读 Loader 真实的 fiber 结果,失败的行标红并可「修复」(重新挂载)
|
|
45
|
+
- 缺依赖时展开行内说明:**依赖和插件是什么关系、为什么缺、影响范围**,并给出可复制的命令
|
|
46
|
+
- 只有插件市场里确实存在对应包时才出现「装依赖」按钮——普通库不会假装能装
|
|
41
47
|
|
|
42
|
-
|
|
43
|
-
- **依赖**:读每个包自己的 `package.json` 的 `peerDependencies`,并用 `peerDependenciesMeta` **区分必需与可选**:
|
|
44
|
-
- 必需缺失 → 黄色提示,参与排序,可装(若在市场里);
|
|
45
|
-
- 可选缺失(例如 `dsh-connect-workbuddy` 的 `@earendil-works/pi-ai`,声明为 `optional: true`)→ 只说明「只影响对应的附加功能」,不报警、不参与排序。
|
|
46
|
-
- `react`、`react-dom`、`cordis`、`dsh`、所有 `@deepseek-ai/*` 视为安装已提供。
|
|
47
|
-
- 缺依赖时展开行内「这是什么意思」:解释 peer 依赖与本体的关系、为什么缺、影响范围,并给出可直接复制的命令:
|
|
48
|
-
```
|
|
49
|
-
cd "<profile 目录>"
|
|
50
|
-
pnpm add <缺失的包>
|
|
51
|
-
```
|
|
52
|
-
- 只有**同时出现在插件市场索引里**的依赖才有「装依赖」按钮;普通库无法作为 bundle 安装,给按钮就是骗人。
|
|
53
|
-
- **npm 别名安装**(如 `dsh-our-free-model@npm:@ebony-vinyl/dsh-our-free-model@2.8.5`):`listVersions` 只服务已安装的依赖名,别名包无法自动核对。这类行标注「npm 别名安装,需手动升级」,并把「源」链接指向**真实发布包**的页面。
|
|
48
|
+
### 把整套配置搬到另一台设备
|
|
54
49
|
|
|
55
|
-
|
|
50
|
+
- **同步码**:生成一段 `DSHU1-…`,复制到另一台设备粘贴即可。带勾选列表(全选 / 单选 / 取消 → 确认安装),不需要账号、网盘或文件
|
|
51
|
+
- **平台过滤**:码里带每个插件的平台声明,手机端导入时桌面专属插件会被禁用勾选并标注原因,不会硬装
|
|
52
|
+
- **本地安装也能搬**:`file:` 装的插件会解析出真正的远程源(插件市场条目或仓库地址),新设备据此重新安装;实在没有远程源的才标「需手动拷贝」
|
|
53
|
+
- **账号快照**(可选):以登录账号为键保存在本机,放进 OneDrive / 坚果云 等同步盘即可多机共享。卡片会明确告诉你属于哪种情况——DSH 目前没有云端配置存储,这一点不会含糊
|
|
56
54
|
|
|
57
|
-
|
|
55
|
+
### 出问题能定位,而不是只亮个红点
|
|
58
56
|
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
57
|
+
- 每条问题都给出三层:**阶段**(源查询 / 更新 / 插件清单 / 检索插件源…)→ **对象**(哪个插件或哪个索引地址)→ **原因**,原始诊断可展开查看
|
|
58
|
+
- **红点 = 真问题**(挡住更新),**黄点 = 提示**(不影响更新,例如某个插件源暂时连不上)
|
|
59
|
+
- 插件源偶尔超时会**沿用上次成功抓到的数据**,并标出「沿用 hh:mm 的数据」,不会因为一次抖动就报警
|
|
60
|
+
- 每条问题旁边直接给修复按钮:「重试」「重试源」「修复」
|
|
63
61
|
|
|
64
|
-
|
|
62
|
+
---
|
|
65
63
|
|
|
66
|
-
|
|
67
|
-
- 浏览器支持 `CompressionStream` 时用 `DSHU1-`(压缩),否则自动退回 `DSHU0-`(未压缩,更长但同样可用)。
|
|
68
|
-
- **平台过滤**:码里带每个插件的 `dsh.compatibility.profiles` 与客户端平台声明;手机端导入时,桌面专属插件会被禁用勾选并标注「当前设备不支持」,不会被装上。
|
|
69
|
-
- 本地路径安装(`file:` / `link:`)的插件标为「需手动放置」,不会尝试远程安装。
|
|
64
|
+
## 界面速览
|
|
70
65
|
|
|
71
|
-
|
|
66
|
+
| 区域 | 内容 |
|
|
67
|
+
|---|---|
|
|
68
|
+
| 顶部 | 上次检查时间(含触发来源)、「立即检查」 |
|
|
69
|
+
| 后台自检 | 自动检查开关、间隔(15 分钟 ~ 12 小时)、启动时检查、发现新版本自动安装,**改动即时生效并保存** |
|
|
70
|
+
| 问题区 | 红色问题 / 黄色提示,逐条给阶段、对象、原因、诊断与修复按钮 |
|
|
71
|
+
| 插件表 | 分组列表,每行带状态、来源、版本与操作按钮 |
|
|
72
|
+
| 同步 | 「同步码 / 账号快照」两个页签 |
|
|
73
|
+
| 插件源 | 每个索引是否可用、条目数、更新时间;可就地「重试源」「移除」,也可新增源 |
|
|
72
74
|
|
|
73
|
-
|
|
75
|
+
按钮按语义配色:升级为蓝色实心、修复与装依赖为黄色、导出为绿色、仓库与源为中性色。
|
|
74
76
|
|
|
77
|
+
---
|
|
75
78
|
|
|
79
|
+
## 设置项
|
|
76
80
|
|
|
77
|
-
|
|
81
|
+
在面板「后台自检」里改,保存到 profile 目录的 `dsh-updater.settings.json`,宿主会立即重排定时器,不需要重启。
|
|
78
82
|
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
+
| 项 | 说明 | 默认 |
|
|
84
|
+
|---|---|---|
|
|
85
|
+
| 按间隔自动检查 | 关掉后只有打开面板或手动点才检查 | 开 |
|
|
86
|
+
| 检查间隔 | 15 / 30 / 60 / 120 / 240 / 480 / 720 分钟 | 60 分钟 |
|
|
87
|
+
| 启动时检查一次 | DSH 启动约 8 秒后跑一轮 | 开 |
|
|
88
|
+
| 发现新版本自动安装 | 关掉则只查询、不安装 | 开 |
|
|
83
89
|
|
|
90
|
+
---
|
|
84
91
|
|
|
85
|
-
##
|
|
92
|
+
## 隐私与安全
|
|
86
93
|
|
|
87
|
-
-
|
|
88
|
-
-
|
|
89
|
-
-
|
|
90
|
-
-
|
|
91
|
-
- **后台自检由用户在面板里设置**(开关 / 5 分钟~12 小时 / 启动检查 / 自动安装),改动即时保存到 profile 的 `dsh-updater.settings.json` 并重排定时器。
|
|
92
|
-
- **打开面板不触发检查**:只读取已有报告,避免每次点进来就等一整轮。
|
|
93
|
-
- 路由只接受回环地址请求,非本机直接 403。
|
|
94
|
+
- 只访问 npm registry 与你配置的插件源索引,没有任何统计上报
|
|
95
|
+
- 所有本地 HTTP 接口**只监听回环地址**,非本机请求一律 `403`
|
|
96
|
+
- 同步码只在你自己的设备之间传递,**不经过任何服务器**
|
|
97
|
+
- 账号快照写在本机 profile 目录,不上传
|
|
94
98
|
|
|
95
|
-
|
|
99
|
+
---
|
|
96
100
|
|
|
97
|
-
|
|
101
|
+
## 兼容性
|
|
98
102
|
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
103
|
+
- **DSH**:`>=0.2.2-rc.1 <0.3.0`
|
|
104
|
+
- **平台**:桌面端(Windows / macOS / Linux)与 Web 界面(`dsh.compatibility.profiles = ["desktop","web"]`)
|
|
105
|
+
|
|
106
|
+
---
|
|
107
|
+
|
|
108
|
+
## 已知限制
|
|
102
109
|
|
|
103
|
-
|
|
110
|
+
说清楚比藏起来好:
|
|
111
|
+
|
|
112
|
+
- **npm 别名安装**(`pkg@npm:real@1.2.3`)无法自动升级,会单独标注「npm 别名安装,需手动升级」,并把「源」指向真实发布包
|
|
113
|
+
- **普通库依赖**不能作为插件安装,只给可复制的命令
|
|
114
|
+
- **账号快照不是云同步**:DSH 不提供云端配置存储,快照只在本机;跨设备要么用同步码,要么把它放进同步盘
|
|
115
|
+
- 更新器**不会操作自身**,避免在点击过程中替换掉正在运行的模块
|
|
116
|
+
|
|
117
|
+
---
|
|
118
|
+
|
|
119
|
+
## English
|
|
120
|
+
|
|
121
|
+
A sidebar updater for DeepSeek Harness. It reads every plugin in your profile, compares versions against npm and your configured plugin indexes, installs newer versions silently, and checks two things most tools ignore: **peer dependencies** (required vs optional) and **extension load state**. Every failure names the stage, the target, and the raw diagnostic — with a one-click repair next to it. The same panel carries your whole setup to another device as a single sync code, filtering out plugins that cannot run on the target platform.
|
|
104
122
|
|
|
105
123
|
```powershell
|
|
106
|
-
|
|
107
|
-
Invoke-RestMethod http://127.0.0.1:<port>/api/dsh-updater/status |
|
|
108
|
-
ForEach-Object { $_.report | ConvertTo-Json -Depth 12 } | Set-Content report.json
|
|
109
|
-
node tools/client-smoke.mjs dsh-updater/client.js report.json
|
|
124
|
+
dsh plugin add dsh-panel-updater
|
|
110
125
|
```
|
|
111
126
|
|
|
112
|
-
|
|
127
|
+
Requires DSH `>=0.2.2-rc.1 <0.3.0`, desktop and web.
|
|
128
|
+
|
|
129
|
+
---
|
|
130
|
+
|
|
131
|
+
## 许可证
|
|
113
132
|
|
|
133
|
+
[MIT](./LICENSE)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-panel-updater",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1",
|
|
4
4
|
"description": "Sidebar updater for DeepSeek Harness: checks every installed plugin and plugin source, updates silently, reports dependency and extension problems with one-click repairs, and carries the whole setup to another device as a sync code.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -58,3 +58,4 @@
|
|
|
58
58
|
}
|
|
59
59
|
}
|
|
60
60
|
|
|
61
|
+
|