dsh-panel-updater 0.0.0-stage → 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/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 dsh-updater contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,133 @@
1
- # Temporary Holding Version
1
+ # 更新器 · dsh-panel-updater
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ > DeepSeek Harness 的左侧栏更新器:一次点击,看清每个插件的版本、依赖与扩展状态。
4
+
5
+ [![npm](https://img.shields.io/npm/v/dsh-panel-updater?color=2563eb&logo=npm)](https://www.npmjs.com/package/dsh-panel-updater)
6
+ [![license](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
7
+ [![DSH](https://img.shields.io/badge/DSH-%3E%3D0.2.2--rc.1-7c3aed)](https://github.com/deepseek-ai)
8
+
9
+ 装到十几个插件之后,麻烦的其实只有三件事:**谁该更新**、**为什么不工作了**、**换台电脑怎么搬过去**。更新器把这三件事收进一个面板。
10
+
11
+ ---
12
+
13
+ ## 安装
14
+
15
+ ```powershell
16
+ dsh plugin add dsh-panel-updater
17
+ ```
18
+
19
+ 也可以在 DSH 的「插件」页搜索 `dsh-panel-updater`。
20
+
21
+ 装好后左侧栏会出现一个循环箭头图标,点开就是面板。
22
+
23
+ ---
24
+
25
+ ## 它能做什么
26
+
27
+ ### 一眼看清所有插件
28
+
29
+ - **按来源分组**:云端安装 / 本地链接 / Git 副本 / 本插件
30
+ - **组内按"需要你处理"排序**:扩展加载失败 → 有可升级版本 → 缺依赖(必需或可选)→ npm 别名需手动升级 → 其余安静的排后面
31
+ - 每行给出:名称、当前版本、最新版本、状态、来源标识(`npm` / `本地` / `git`)
32
+ - **点名称**打开插件介绍页;旁边还有「仓库」「源」按钮;本地安装的会直接**打开系统资源管理器**定位到文件
33
+
34
+ ### 更新,但不要打扰你
35
+
36
+ - **打开面板不会触发检查**——只读上一次的结果,秒开不卡
37
+ - 检查在后台按你设定的间隔静默进行,发现新版本直接装
38
+ - 想手动时:单条「升级」,或标题栏「一键升级(N)」,逐条执行并给出结果
39
+ - **已经是最新时按钮是灰的**,不给你点没用的按钮
40
+
41
+ ### 依赖与扩展,真的会查
42
+
43
+ - 读每个包自己声明的 `peerDependencies`,并区分**必需**与**可选**:可选依赖缺失只提示「只影响对应附加功能」,不会误报成故障
44
+ - 扩展状态读 Loader 真实的 fiber 结果,失败的行标红并可「修复」(重新挂载)
45
+ - 缺依赖时展开行内说明:**依赖和插件是什么关系、为什么缺、影响范围**,并给出可复制的命令
46
+ - 只有插件市场里确实存在对应包时才出现「装依赖」按钮——普通库不会假装能装
47
+
48
+ ### 把整套配置搬到另一台设备
49
+
50
+ - **同步码**:生成一段 `DSHU1-…`,复制到另一台设备粘贴即可。带勾选列表(全选 / 单选 / 取消 → 确认安装),不需要账号、网盘或文件
51
+ - **平台过滤**:码里带每个插件的平台声明,手机端导入时桌面专属插件会被禁用勾选并标注原因,不会硬装
52
+ - **本地安装也能搬**:`file:` 装的插件会解析出真正的远程源(插件市场条目或仓库地址),新设备据此重新安装;实在没有远程源的才标「需手动拷贝」
53
+ - **账号快照**(可选):以登录账号为键保存在本机,放进 OneDrive / 坚果云 等同步盘即可多机共享。卡片会明确告诉你属于哪种情况——DSH 目前没有云端配置存储,这一点不会含糊
54
+
55
+ ### 出问题能定位,而不是只亮个红点
56
+
57
+ - 每条问题都给出三层:**阶段**(源查询 / 更新 / 插件清单 / 检索插件源…)→ **对象**(哪个插件或哪个索引地址)→ **原因**,原始诊断可展开查看
58
+ - **红点 = 真问题**(挡住更新),**黄点 = 提示**(不影响更新,例如某个插件源暂时连不上)
59
+ - 插件源偶尔超时会**沿用上次成功抓到的数据**,并标出「沿用 hh:mm 的数据」,不会因为一次抖动就报警
60
+ - 每条问题旁边直接给修复按钮:「重试」「重试源」「修复」
61
+
62
+ ---
63
+
64
+ ## 界面速览
65
+
66
+ | 区域 | 内容 |
67
+ |---|---|
68
+ | 顶部 | 上次检查时间(含触发来源)、「立即检查」 |
69
+ | 后台自检 | 自动检查开关、间隔(15 分钟 ~ 12 小时)、启动时检查、发现新版本自动安装,**改动即时生效并保存** |
70
+ | 问题区 | 红色问题 / 黄色提示,逐条给阶段、对象、原因、诊断与修复按钮 |
71
+ | 插件表 | 分组列表,每行带状态、来源、版本与操作按钮 |
72
+ | 同步 | 「同步码 / 账号快照」两个页签 |
73
+ | 插件源 | 每个索引是否可用、条目数、更新时间;可就地「重试源」「移除」,也可新增源 |
74
+
75
+ 按钮按语义配色:升级为蓝色实心、修复与装依赖为黄色、导出为绿色、仓库与源为中性色。
76
+
77
+ ---
78
+
79
+ ## 设置项
80
+
81
+ 在面板「后台自检」里改,保存到 profile 目录的 `dsh-updater.settings.json`,宿主会立即重排定时器,不需要重启。
82
+
83
+ | 项 | 说明 | 默认 |
84
+ |---|---|---|
85
+ | 按间隔自动检查 | 关掉后只有打开面板或手动点才检查 | 开 |
86
+ | 检查间隔 | 15 / 30 / 60 / 120 / 240 / 480 / 720 分钟 | 60 分钟 |
87
+ | 启动时检查一次 | DSH 启动约 8 秒后跑一轮 | 开 |
88
+ | 发现新版本自动安装 | 关掉则只查询、不安装 | 开 |
89
+
90
+ ---
91
+
92
+ ## 隐私与安全
93
+
94
+ - 只访问 npm registry 与你配置的插件源索引,没有任何统计上报
95
+ - 所有本地 HTTP 接口**只监听回环地址**,非本机请求一律 `403`
96
+ - 同步码只在你自己的设备之间传递,**不经过任何服务器**
97
+ - 账号快照写在本机 profile 目录,不上传
98
+
99
+ ---
100
+
101
+ ## 兼容性
102
+
103
+ - **DSH**:`>=0.2.2-rc.1 <0.3.0`
104
+ - **平台**:桌面端(Windows / macOS / Linux)与 Web 界面(`dsh.compatibility.profiles = ["desktop","web"]`)
105
+
106
+ ---
107
+
108
+ ## 已知限制
109
+
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.
122
+
123
+ ```powershell
124
+ dsh plugin add dsh-panel-updater
125
+ ```
126
+
127
+ Requires DSH `>=0.2.2-rc.1 <0.3.0`, desktop and web.
128
+
129
+ ---
130
+
131
+ ## 许可证
132
+
133
+ [MIT](./LICENSE)