dsh-file-extension

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 不可用或拒绝（例如热重载服务活跃、包被进程占用）时，对话框会给出 可直接复制的命令而不是谎报成功。 ---