dsh-better-file-viewer 0.1.17 → 0.1.20

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,20 +1,29 @@
1
1
  # Better file viewer
2
2
 
3
- 独立的 DSH「文件」会话视图。新增会话视图,不改动、接管或替换原侧栏。
3
+ DSH 一体化侧栏文件浏览器:默认复用当前会话一个浏览器标签,文件导航与预览同页;纯图标按钮按需打开无文件树的独立内容标签。同时保留中央「文件」会话视图。通过官方扩展点接入,不改写 DSH 源码、导航方法或安装文件。
4
+
5
+ ## 0.1.20
6
+
7
+ - 从侧栏的「文件」入口打开完整浏览器,文件树/层级列、路径搜索、图库和文件预览在同一页。普通文件链接经官方路由交接给已有浏览器;同会话的多个分栏也优先复用该浏览器,不自动累积永久文件标签。
8
+ - 选中文件后,工具栏出现纯图标「在新标签页打开」按钮(悬停提示与可访问名称,不显示文字)。点击才打开固定文件、无文件树的独立内容标签;后续默认浏览不改变其文件,相同会话及等价路径优先激活已有独立标签。
9
+ - 接入官方 `files` extension 类型和单独的资源交接/内容类型。交接标签只短期承载路径及行号,成功后关闭;失败保留明确错误和重试。不修改官方方法,不声称做到打开前取消或已验证零闪动。
10
+ - 已经存在的官方 `text` 文件标签不强行关闭或迁移;其他插件显式指定官方类型时仍按其指定处理。试用时从「文件」入口或重新打开文件链接;停用本插件后恢复官方文件浏览页。
11
+ - 会话交付的图片、文档等产物继续走普通文件浏览器;**变更文件清单保持官方对比页,不进入本插件浏览器**。不会修改原生变更对比的标签、摘要读取或交互。
12
+ - 本次 npm 发行版本为 **0.1.20**;GitHub 历史资产和市场条目不会随 npm 上传自动更新。npm 上传成功后仍可能需要分发处理时间,上传状态与可下载状态分别记录。
4
13
 
5
14
  ## 安装(无需克隆源码)
6
15
 
7
- **0.1.17** 的适配基线是 DSH Desktop/Web **0.2.2-rc.3**。通过 npm 安装精确版本;普通 Web profile 可使用:
16
+ **0.1.20** 的适配基线是 DSH Desktop/Web **0.2.2-rc.3**。npm 分发可能延迟几十分钟;同步期间出现 404 或占位版本不代表上传失败。下载可用后,通过 npm 安装精确版本;普通 Web profile 可使用:
8
17
 
9
18
  ```sh
10
- dsh plugin --profile web add dsh-better-file-viewer@0.1.17
19
+ dsh plugin --profile web add dsh-better-file-viewer@0.1.20
11
20
  ```
12
21
 
13
- 也可在 DSH 插件管理器中使用 `dsh-better-file-viewer@0.1.17`。npm 包页:https://www.npmjs.com/package/dsh-better-file-viewer 。
22
+ 也可在 DSH 插件管理器中使用 `dsh-better-file-viewer@0.1.20`。npm 包页:https://www.npmjs.com/package/dsh-better-file-viewer 。
14
23
 
15
- GitHub 历史已发布包仍为 **0.1.12(rc1 基线)**,不包含 rc3 修复;不要把旧 GitHub 安装地址当作 0.1.17。本次 npm 分发不自动创建 GitHub Release 或更新市场。
24
+ GitHub 历史已发布包仍为 **0.1.12(rc1 基线)**,不包含 rc3 修复;不要把旧 GitHub 安装地址当作 0.1.20。本次 npm 分发不自动创建 GitHub Release 或更新市场。
16
25
 
17
- 安装包已包含浏览器构建产物,无需本地构建或手动复制文件。插件市场条目正在提交;收录后可搜索 `dsh-better-file-viewer`。是否需要刷新或重启以插件管理器的结果为准,不会自动重启 DSH。
26
+ 安装包已包含浏览器构建产物,无需本地构建或手动复制文件。若通过插件市场安装,请核对条目实际版本;本次不更新市场。是否需要刷新或重启以插件管理器的结果为准,不会自动重启 DSH。
18
27
 
19
28
  Office 预览依赖宿主的 `officeToPdf` 服务;本插件不安装 Office 转换运行时。不支持的宿主版本未经过兼容性验证。
20
29
 
@@ -32,10 +41,10 @@ Office 预览依赖宿主的 `officeToPdf` 服务;本插件不安装 Office
32
41
  - 非 JSON 文件使用独立 fork 的官方预览:文本、Markdown、代码、图片、HTML、PDF、Excel/CSV/TSV、Office 转 PDF。格式支持和安全策略继承固定版本实现。
33
42
  - JSON 使用 super-json-editor 的结构导航,默认只读、无 Raw 编辑;按用户最新要求完整保留默认 object/表格/控件/配色/装饰,仅隔离样式作用域和适配预览容器尺寸。
34
43
  - 四种布局均限制在当前会话视图可用区域内:文件树和预览各自滚动,外层不共同滚动。只在文件视图隐藏聊天输入区,保持编辑器挂载和草稿不变。
35
- - 优先消费原生发给 better-files 的 viewRequest,并保留同一会话及 Conversation occurrence 的短期点击路径交接。聊天中的普通本地文件点击通过当前 occurrence 的原生「文件」标签进入文件视图;标签折叠时,通过原生 More 菜单及其公开 onOpen 回调进入。没有读取私有 React/store 或替换聊天/侧栏组件。仅在路由可用、路径解析有效时阻止该次原生点击;修饰键、外链及插件未就绪时仍走原导航。DOM 导航锚点固定到 rc3,歧义或缺失时保留原导航。
44
+ - 中央视图继续消费原生发给 better-files 的 viewRequest。默认文件打开现由官方侧栏类型选择交给单例浏览器,保留文件地址、来源会话和行号;停用旧的聊天 DOM 点击转中央桥接,不改写 Chat 或侧栏导航。显式「在新标签页打开」只增加纯内容标签,文件树/图库/搜索内的普通选择只切换当前预览。
36
45
  - 支持中英文,外层文件视图使用 DSH 主题;SJE 按用户要求保留原默认配色。布局方向是插件自己的浏览器偏好。
37
46
 
38
- 入口:有内容的会话顶部,与「聊天 / 轨迹 / 上下文」同级的「文件」。窄窗口可能收进官方的更多菜单;空白会话是否显示视图导航遵循官方会话页。
47
+ 主要入口:右侧栏的「文件」,或普通本地文件链接。中央「文件」会话视图仍保留,与「聊天 / 轨迹 / 上下文」同级;窄窗口可能收进官方更多菜单,空白会话是否显示中央视图导航遵循官方会话页。
39
48
 
40
49
  ## 边界
41
50
 
@@ -74,7 +83,7 @@ JSON 源码快照包含文件哈希;更新时执行 scripts/snapshot-editor.mj
74
83
  - scripts/build.mjs:本地编译所需官方 primitives/store,宿主 React 保持 external;PDF/Excel/frontmatter 保持自包含懒加载。
75
84
  - betterFiles.preview Factory 独立拥有 betterFiles.document 等子 Slot;服务、locale 和 CSS 标识均与官方侧栏分开。
76
85
 
77
- 原侧栏继续运行未改动的官方组件,本插件不使用 sidebarRight/sidebarRightTabs,也不从注册表抓取官方组件实例。
86
+ 侧栏布局、标签和非文件组件继续由官方管理;本插件使用 `sidebarRightTabs.register`、公开的 `sidebarRight` 操作和 `tab.actions` 接入自己的类型,不改写官方方法,也不从注册表抓取组件实例。`files` extension 替代内置文件浏览页;默认资源交接类型和显式内容类型分别完成单例定位与按需保留。JSON 弹层使用每实例 ref/context,避免保留多个预览时跨标签挂载。
78
87
 
79
88
  ## 初版 0.1.0 交付验证(2026-11-12)
80
89
 
@@ -217,6 +226,31 @@ JSON 源码快照包含文件哈希;更新时执行 scripts/snapshot-editor.mj
217
226
  - 当前已连接 GUI 的 Inspect 确认 build=0.1.17,并记录真实图片链接点击的 `file-click-routed → file-click-delivered → request-consumed → preview-state`;文件视图已挂载且选中目标图片、`navigationError` 为空。用户随后明确确认“已经可以了”。自动浏览器此前访问 GUI 停在认证页;折叠菜单完整焦点/冒泡及明暗主题视觉仍未自动验收。
218
227
  - 已完成只读 UI/UX 审查:主流程无阻断问题。已知兼容性边界:原生可见 tab 不暴露 view ID,只能在所属页头按本插件标题匹配;若其他插件也创建同名视图且真正文件 tab 折叠,仍可能产生标题冲突。两个可见同名 tab 会拒绝接管。未为了这项条件性跨插件冲突替换宿主页头或修改当前已由用户确认可用的交互。
219
228
 
229
+ ## 0.1.18 官方侧栏单例浏览器(本地试用,2026-11-18)
230
+
231
+ - [官方接入与交接](<src/sidebar.mjs>)注册 `files` extension、默认文件资源交接类型,以及仅由图标按钮指定的内容类型;不覆盖 fallback `text`,不包装或改写官方方法。默认请求使用公开标签清单、聚焦及标签操作定位当前会话浏览器,成功后关闭交接标签;其他会话、后台标签和非文件标签不受影响。
232
+ - [共享界面](<src/client.jsx>)复用已有 FileWorkspace,侧栏与中央视图使用同一套导航/预览。目录、图库和路径搜索的普通选择不新建标签;工具栏纯图标按钮打开独立内容页。内容页不含文件树/路径搜索;重复打开按来源会话和规范化路径复用,Windows 大小写等价而 POSIX 大小写保持区分。
233
+ - [JSON 实例作用域](<scripts/scope-editor-root.mjs>)在构建时注入每个编辑器的 ref/context,消除多个保留 JSON 标签间的弹层串页;不修改原始 vendor 快照或默认 SJE 样式。目录导航采用嵌套列表和原生按钮,并用 aria-current 同步可访问的当前位置。
234
+ - 构建及全量 **181 项自动化测试通过**,本次修改的源码/文档差异检查通过。通过插件管理器重新启用当前本地链接,返回 `application=applied`、`warnings=[]`;已连接 GUI 的只读 Inspect 确认 build=0.1.18、`files` 的实际实现为本插件、默认文件 claim 为 `better-files-route`,三个自有侧栏组件均 active。
235
+ - 已完成独立只读 UI/UX 审查并处理实例隔离、内容标签去重和目录语义问题。自动浏览器访问当前 GUI 仍显示认证要求,未获取认证令牌或绕过认证;**真实点击交接、过渡标签是否闪动、明暗主题及多会话/多分栏视觉尚待试用**,未把单元测试或注册当作完整端到端验收。未发布 npm/GitHub,未重启或替换 DSH。
236
+
237
+ ## 0.1.19 误加的变更清单接管(已撤回,仅历史)
238
+
239
+ **纠正:当时将当前打开的变更页误当成图片/文档交付卡片的点击证据,不能据此认定产物卡片的问题。用户随后明确确认图片等产物已可用,变更页不应进入插件浏览器。下列方案已在 0.1.20 删除,不代表当前功能或当前决策。**
240
+
241
+ - 当时的误判:当前 GUI Focused Inspect 记录实际打开的是 `changes-review` 资源,而非普通 `file`。固定 rc3 的 ChangedFiles 卡片调用 `openReview(index)`,经官方 Deliverables 注册者生成 `dsh-resource://changes-review/session/<id>/<seq>/<turn>`;0.1.18 的文件地址匹配因此没有接到它。
242
+ - 当时的变更资源适配(现已删除)新增独立 extension 类型 `better-files-changes-route`。通过与官方相同的文档相对、同源认证 GET `api/changes.summary` 读取声明的文件 `path` 和所选原始索引,不把 `display`/卡片文案猜成路径,不读取或提取认证令牌。再按官方 `fileAddressFor` 语义转为 Session 文件请求,进入原有单例交接;超时、关闭、隐藏、快速切换索引会取消旧读取,失败提供重试。
243
+ - 原生 builtin `changes-review` 不被覆盖。来源上下文与当前文件匹配时,工具栏显示纯图标「查看变更对比」;转接失败页也有同一图标,显式指定原生 kind 避免再次进入默认转接。跨会话对比坐标在读取前拒绝,防止原生对比组件按当前会话读到错误数据。原生系统打开、独立内容标签及已有对比标签不受改变。
244
+ - 构建和 **191 项测试通过**,新增索引/相对路径/实际 path/缺失或非法摘要/取消/会话边界/同浏览器复用/原生对比不递归及注册恢复回归。只读 UI/UX 复核后无剩余高可信阻断问题。
245
+ - 当前本地链接插件重新启用均返回 `application=applied`、`warnings=[]`。Focused Inspect 已确认 build=0.1.19,用户当前真实变更地址的默认 claim 变为 `better-files-changes-route`。旧的官方对比标签保留原身份,重新点击会话清单才走新路由。自动浏览器的认证限制仍在,实际点击与视觉不据此宣称通过;未发布 npm/GitHub,未改写 DSH 代码或服务方法。
246
+
247
+ ## 0.1.20 恢复原生变更对比(本地试用,2026-11-18)
248
+
249
+ - 用户明确确认:“图片什么现在都可以了,但是变更就不应该打开我们的浏览器”。因此撤回 0.1.19 的误诊及变更资源接管决策,不再把变更清单当成交付产物卡片。
250
+ - 删除变更转接源文件、摘要 GET、额外类型注册和误加的对比图标/上下文状态。[侧栏注册](<src/sidebar.mjs>)仅保留 `files`、`better-files-route` 和 `better-files-content`:图片/文档继续使用单例浏览器及纯图标独立内容标签;`changes-review` 完全交给官方。
251
+ - [边界回归](<tests/changes-route.test.mjs>)防止再次把变更资源注册或打包进插件,原生对比注册/卸载保持不变。构建及全量 **184 项测试通过**,只读复核未发现撤回残留或文件浏览功能被移除。
252
+ - 本地重新启用返回 `application=applied`、`warnings=[]`;Focused Inspect 已确认 build=0.1.20、普通文件默认为 `better-files-route`、用户实际变更地址的默认 kind 恢复为 `changes-review`。这是实时路由核验,未冒充新的端到端点击/视觉验收;未发布 npm/GitHub,未修改 DSH。
253
+
220
254
  ## 许可证
221
255
 
222
256
  见 [LICENSE](<LICENSE>)、[THIRD_PARTY_NOTICES.md](<THIRD_PARTY_NOTICES.md>) 和 [THIRD_PARTY_LICENSES.txt](<THIRD_PARTY_LICENSES.txt>)。
package/RELEASING.md CHANGED
@@ -4,17 +4,17 @@
4
4
 
5
5
  ## 1. 当前发布方式与参考
6
6
 
7
- 截至 2026-11-16,本项目的发布基线(GitHub 历史发行仍为 0.1.12,rc3 修订为 0.1.17,维护者已授权 npm 公开分发):
7
+ 截至 2026-11-18,本项目的发布基线(GitHub 历史发行仍为 0.1.12,npm 前版为 0.1.17,当前候选为 0.1.20,维护者已授权 npm 公开分发):
8
8
 
9
9
  | 项目 | 当前约定 |
10
10
  | --- | --- |
11
- | 包与版本 | `dsh-better-file-viewer`,当前版本见 [package.json](<package.json>);本次候选为 0.1.17 |
11
+ | 包与版本 | `dsh-better-file-viewer`,当前版本见 [package.json](<package.json>);本次候选为 0.1.20 |
12
12
  | 主分发渠道 | npm 预构建包;历史 GitHub tgz 继续保留,安装方式见 [README](<README.md>) |
13
- | npm | `private: false`,publishConfig 固定官方 registry、public 和 latest;必须发布已经审计的 tgz,成功以 registry 回读及独立下载核验为准 |
13
+ | npm | `private: false`,publishConfig 固定官方 registry、public 和 latest;必须上传已经审计的 tgz,`npm publish` 成功即完成本次发布;registry 可见与下载可用可能延迟几十分钟,另行记录,不作为完成门禁 |
14
14
  | 运行基线 | Node >=24;当前固定 DSH 基线为 0.2.2-rc.3;声明的 engines 范围不等于该范围内每个版本都已实测 |
15
15
  | 依赖 | 已有 [pnpm-lock.yaml](<pnpm-lock.yaml>);packageManager 已固定 pnpm 11.28.5,发布记录仍须保存实际版本 |
16
16
  | 构建与测试 | 提供 `build`、`test`、`vendor`、`test:host-contracts` scripts;尚无本仓库的自动发布 CI |
17
- | 集成形态 | 新增独立「文件」会话视图;不是替换原生侧栏/Chat 的整包 fork |
17
+ | 集成形态 | 官方侧栏 `files` extension 与单例文件浏览器,保留中央「文件」视图;按需纯内容标签;`changes-review` 保持原生,不改写 DSH 方法 |
18
18
 
19
19
  参考了本机兄弟目录中的下列实际材料,公开源码链接供其他维护者查阅:
20
20
 
@@ -54,7 +54,7 @@ Invoke-ReleaseStep { pnpm test }
54
54
  ```
55
55
 
56
56
  - 构建必须在测试之前完成,避免发行检查读到旧产物。以当次测试结果为准;0.1.12 的历史基线为 94 项通过,不把 94 写成后续版本的固定成功条件。
57
- - [构建脚本](<scripts/build.mjs>)生成主入口、三个懒加载 chunk 和依赖许可证,并检查无私有 Harness UI 模块导入、无侧栏控制写入;[隔离适配](<scripts/fork-preview.mjs>)及[链接收集适配](<scripts/native-link-collector.mjs>)的固定上游锚点变更会使构建失败,不能移除断言硬过关。
57
+ - [构建脚本](<scripts/build.mjs>)生成主入口、三个懒加载 chunk 和依赖许可证,并检查无私有 Harness UI 模块导入、不改写侧栏服务方法;插件自身通过官方类型注册和公开标签操作接入;[隔离适配](<scripts/fork-preview.mjs>)及[链接收集适配](<scripts/native-link-collector.mjs>)的固定上游锚点变更会使构建失败,不能移除断言硬过关。
58
58
  - `pnpm run vendor` 会联网下载并写入 vendor,并非只读检查;仅在需要恢复/有意更新快照时使用。其 [脚本](<scripts/fetch-vendor.mjs>)校验固定版本 tgz 的 SHA-512。编辑器快照更新使用 [快照脚本](<scripts/snapshot-editor.mjs>),另行审查来源、授权和文件哈希。
59
59
  - 先完成所需源码、版本、文档和生成产物的提交,再记录候选的 source commit。打包与验收后若修改任何包内文件,必须重新执行相关门禁,产生新候选并重新验收。
60
60
 
@@ -122,10 +122,10 @@ package/THIRD_PARTY_LICENSES.txt
122
122
 
123
123
  ### 必测清单
124
124
 
125
- - [ ] 「文件」与原侧栏并存;不接管原生条目,也不丢失聊天输入草稿。
125
+ - [ ] 中央「文件」视图保留,侧栏文件页通过官方扩展接入;普通文件复用一个浏览器,纯图标按钮按需创建内容标签,卸载恢复原生文件页;不丢失聊天草稿。
126
126
  - [ ] 左/右文件树,上/下层级分栏,展开/收起、切根、分隔拖动及四布局切换;导航与预览独立滚动。
127
127
  - [ ] 空目录留白;读取中、失败、重试及截断状态仍明确显示。
128
- - [ ] 聊天普通文件链接、**带悬停预览且缺 title 的图片文件链接**,以及重复点击、另一个会话中的点击,都能定位正确目标;不得按文案猜文件,也不能卡住祖先目录 loading。
128
+ - [ ] 聊天普通文件链接及交付的图片/文档产物进入同一浏览器;重复打开和会话隔离正确,不按文案猜路径、不卡祖先目录 loading。**变更文件清单必须保留原生 changes-review,不得再次接管。**
129
129
  - [ ] 图片目录缩略图、单图、前后翻页、返回目录、Ctrl 加减、Ctrl 滚轮及单图平移;正常滚动与编辑器输入不被抢占。
130
130
  - [ ] JSON 合法/非法/大文件及默认样式;文本、Markdown、代码、HTML、PDF、表格/Excel 和 Office 分支。Office 缺转换服务时须有明确提示;缺条件的分支标注“未测”,不能写通过。
131
131
  - [ ] 跨会话/同会话不同 Conversation occurrence 不串定位;外链、内嵌图片按钮、上传附件和修饰键保持原行为。
@@ -173,18 +173,29 @@ if ((Get-FileHash -LiteralPath $DownloadedPackage -Algorithm SHA256).Hash.ToLowe
173
173
 
174
174
  维护者明确要求将当前最新版发布到 npm,原包名保持 `dsh-better-file-viewer`,公开访问、正式版本使用 `latest`。第三方公开再分发许可见第 2 节;保留 Node >=24 与 rc3 宿主边界。React 和宿主模块由 DSH Client loader 提供,不新增会触发 npm 自动安装的宿主 peer;构建依赖仅留在 devDependencies。鉴权复用维护者已有 npm 登录,不保存凭据到仓库。发布前必须核对账号及远程版本;权限或网络错误不能当成版本不存在。
175
175
 
176
- 本次仅发布 npm,不自动创建 GitHub Release、推送 tag、更新市场或安装真实 Profile。发布候选的静态安装检查与真实宿主验收分别记录;既有 0.1.17 用户验收不冒充本次 tgz 的干净安装/冷启动验收,未测项保留披露。
176
+ 本次仅发布 npm,不自动创建 GitHub Release、推送 tag、更新市场或安装真实 Profile。发布候选的静态安装检查与真实宿主验收分别记录;既有 0.1.20 本地链接版的用户反馈和路由核验不冒充本次 tgz 的干净安装/冷启动验收,未测项保留披露。
177
177
 
178
178
  ```powershell
179
179
  if ($Manifest.private) { throw '当前包为 private,不允许 npm 发布。' }
180
180
  # 正式版本选 latest;SemVer 预发布须另外确认 next/beta 并同步 publishConfig,不能误标 latest。
181
181
  Invoke-ReleaseStep { npm whoami --registry=https://registry.npmjs.org/ }
182
182
  Invoke-ReleaseStep { npm publish $Package --access public --tag latest --registry=https://registry.npmjs.org/ }
183
+ # 此步骤成功(退出 0,输出 + 包名@版本)即完成 npm 上传;保存结果后结束本次发布。
184
+ ```
185
+
186
+ **上传成功即交付,不等待下载。** 维护者于 2026-11-16 明确约定:从上传到实际下载可用可能需要几十分钟。npm 可能输出 `Your package is being processed`,即时查询可能返回 404,或暂时只显示 `0.0.0-stage` 占位版本。这不代表上传失败,不要重复 publish、改版本重发、删除占位包或强行修改 dist-tag。若上传退出状态不明,先核对 npm 记录,不能盲重试;认证/OTP 失败仍须停止并如实报告,不能当作上传成功。
187
+
188
+ 状态必须拆分记录:**上传成功**(含命令结果、版本、目标标签和候选 SHA)/**registry 可见**/**可下载与完整性已核验**。本次完成条件仅为第一项,后两项可以明确写“npm 处理/同步中,尚未验证”;不自动等待、轮询或安排定时复查,不承诺固定生效时间。报告可以写“已发布(上传完成,分发处理中)”,不能写成“已可下载”或“线上字节已核验”。
189
+
190
+ 以下是用户需要时**另行执行**的可选后续核验,不与上面的上传命令串成必需流水线,也不以其即时失败推翻上传成功:
191
+
192
+ ```powershell
183
193
  Invoke-ReleaseStep { npm view "dsh-better-file-viewer@$Version" name version dist.integrity dist.tarball --json --registry=https://registry.npmjs.org/ }
184
194
  Invoke-ReleaseStep { npm view dsh-better-file-viewer dist-tags --json --registry=https://registry.npmjs.org/ }
195
+ # 可下载后,再用匿名下载副本比较 dist.integrity、SHA 和完整字节。
185
196
  ```
186
197
 
187
- 发布同一验收 tgz,不从目录重新隐式打包。核对 dist-tag、registry 完整性及重新下载字节;认证/OTP 失败即停止,不能报告成功。不要把本插件的独立 fork 发布到官方 `@deepseek-ai` 命名空间。
198
+ 上传同一验收 tgz,不从目录重新隐式打包;上传后本地发布文档可继续更新,但不要因此重打包或覆盖已上传版本。不要把本插件的独立 fork 发布到官方 `@deepseek-ai` 命名空间。
188
199
 
189
200
  ### 插件市场
190
201
 
@@ -193,7 +204,7 @@ Invoke-ReleaseStep { npm view dsh-better-file-viewer dist-tags --json --registry
193
204
  ## 8. 回滚与交付记录
194
205
 
195
206
  - 出问题先停止推广并记录具体版本/安装状态;按插件管理器支持的方式禁用本 bundle,或重装之前验收过且兼容的精确 tgz。重启仍由用户决定。
196
- - 本插件没有覆盖原侧栏条目,无需借用 Better Tasks 的“恢复六个原生包”步骤。
207
+ - 禁用本插件会撤销官方扩展注册并恢复 builtin 文件页,无需借用 Better Tasks 的“恢复六个原生包”步骤;不修改或复制还原官方安装文件。
197
208
  - 不删除 Session、Workspace、Profile 其他插件、凭据、草稿、布局偏好或诊断数据来伪造回滚成功;不整份恢复旧 Profile 覆盖并发修改。
198
209
  - 包已经公开后,用新版本修复并保留旧资产;npm 撤销/弃用、市场回退、资产删除是单独审核的外部操作。
199
210
 
@@ -208,7 +219,8 @@ Node / pnpm / 确切 DSH 版本:
208
219
  包内容审计:
209
220
  独立安装、冷启动和功能/视觉验收(含未测项):
210
221
  GitHub 状态、公开 URL、独立下载 SHA:
211
- npm / 市场状态(未发布、待审也要如实写):
222
+ npm 上传结果 / registry 可见状态 / 下载完整性状态(三者分别记录,不等待分发):
223
+ 市场状态(未更新、待审也要如实写):
212
224
  真实 Profile 是否另行升级 / 回滚目标:
213
225
  ```
214
226