Overview
dsh-file-extension
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
1. **依赖 DOM 契约。** dsh 的文件树没有行级扩展点，插件依附于 [兼容性](#兼容性)中列出的三个行属性。这是唯一的耦合面，且刻意收窄。 2. **行内重命名是覆盖层。** 输入框绝对定位覆盖在条目上（官方条目无法承载注入的组件）， 会跟随条目滚动与刷新；条目消失时自动关闭。 3. **回收站在宿主侧。** 删除发生在运行宿主进程的机器上，不是运行浏览器的机器。 4. **下载上限。** 浏览器下载降级默认拒绝超过 32 MiB 的文件（插件配置项 `maxDownloadBytes`）。 5. **显示功能依赖 `open-in-app`。** 若某部署未挂载 `session.openWorkspacePath` 这个 Remote，「在文件资源管理器中显示」会保持置灰。 6. **极小概率竞态。** 宿主会拒绝覆盖已存在的目标，但在检查与写入之间新建的文件仍可能 被系统级复制覆盖。这与任何保存对话框的窗口期相同。 7. **检查更新需要能直连 GitHub。** 若宿主机器有 TLS 拦截代理（企业网络常见）， Node 默认无法验证 `api.github.com`，检查会以可读的错误收场（不崩溃、不静默）。 以 `--use-system-ca` 启动 dsh，或设置 `NODE_EXTRA_CA_CERTS` 指向企业根证书即可。 8. **就地更新取决于部署。** 更新操作交由 harness 的 pluginManager 执行；在 pluginManager 不可用或拒绝（例如热重载服务活跃、包被进程占用）时，对话框会给出 可直接复制的命令而不是谎报成功。 ---