远程开发机的产物审阅，卡在刷新与权限上
把 DSH 放在云上跑之后，产出审阅这件事会从「个人习惯」变成「运维问题」。原因不复杂：面板在浏览器里，数据在服务器上，中间还隔着一条反代。任何一头配置不当，看到的都是「列表不动」或者「点开是空的」。
这篇不谈怎么装，只讲装好之后怎么把它调到日常可用——以及哪些开销是可以省掉的。
刷新频率决定电池，不决定体验
插件有两处周期行为，都不显眼但一直在跑：
- 侧边栏面板在打开时每 2 秒拉一次产物列表（设置里的「自动刷新」默认开）。
- 独立弹出标签页每 1.5 秒刷新一次，且这个间隔是写死的，没有设置项。
数据量很小——一次请求返回的是文件路径与类型，不返回文件内容（内容是按需另取）。所以带宽不是问题。真正的影响在两端：笔记本电池模式下，一个每秒半次请求的标签页会让网卡一直醒着；服务器侧则表现为一条稳定的小流量，压测时容易被误认为异常。
我的做法是：需要盯着跑的时候开自动刷新，纯阅读或写文档时把它关掉，靠手动点一下刷新。代价是每次要多点一次，收益是副屏挂一整天也不烫。
快照对比的成本，落在云盘上
bash / pwsh 这类调用，插件判断产出了什么，靠的是命令前后各做一次工作区快照：递归列目录、算版本 token 指纹、取差集。它主动跳过 node_modules、.git 等大目录。
这条设计在本地几乎无感，在云上会被放大。两个变量：
- 工作区规模。几万个文件的中型仓库，一次快照的递归开销已经能感觉到；跳过的大目录越多，感觉越轻。
- 存储介质。工作区放在 ESSD 云盘上没问题；放在 NAS 或网络盘挂载点上，递归列目录的延迟会让每次命令之后都有一个明显停顿。
所以云上部署的第一条实践是：工作区放本地云盘，不要放网络挂载点。顺带说，这也让文件树的懒加载展开快很多。
清除模式不是删除，但磁盘还是得管
侧栏右上角的清除模式，点条目标红、再点 × 移除——它只移除列表条目，不动磁盘文件。这个设计是对的（审阅视图不该有删文件的权力），但它意味着另一件事：面板清空了，磁盘一点没轻。
云主机的系统盘通常在 40–60 GiB 这个量级，产物里既有代码也有图片、日志、构建输出。实践上的分工是：
- 用面板做「这轮改了什么」的判断；
- 用
du -sh与定时清理处理「磁盘还剩多少」； - 把审阅目录与临时目录分开，临时目录定期清、审阅目录进快照。
云盘快照是按增量的，把工作区放在单独一块数据盘上、只对数据盘做快照策略，比整机快照便宜也更可控。
设置不跟机器走，这是设计而非缺陷
所有偏好——默认是否展开、自动刷新开关、文件树开关、最短面板宽度（20–60%）、预览区高度（20–80%）——都存在浏览器 localStorage 里，键名 dsh-popout-sidebar:settings。
三个直接后果，提前知道能省掉疑惑：
- 换浏览器、清缓存、开无痕，全部回到默认值。
- 同一台 ECS 用两台电脑访问，各自配各自的，不会互相影响。
- 浏览器插件清理工具（清 cookie/站点数据那类）会把它一起清掉，看起来像「插件坏了」。
如果你在多台机器上用它，建议把偏好的数值记下来（比如最短面板宽度 30%、预览区 65%），换机器时一次性配好，比逐个试快。
HTTPS 不只是安全，还决定了两个功能
云上部署最常见的偷懒是「先用 HTTP 跑通再说」。对这个插件来说，HTTP 下有两处会直接降级：
- 复制路径 / 引用依赖
navigator.clipboard，非安全上下文里不可用。插件带了降级方案（textarea +execCommand），但不是所有浏览器都还支持这条路。 - PDF 预览依赖浏览器原生查看器，部分浏览器在非安全上下文下会改为强制下载。
所以证书该配就配。反代上把 443 配好、80 跳转，应用端口只听 127.0.0.1——这三件事做完，前面那些「复制没反应」「PDF 打不开」的报障基本会消失。
独立标签页固定浅色，这是个已知取舍
弹出页有意不跟随主界面深色主题，理由是「在另一块显示器上内容清晰稳定」。要深色只能在地址后手动加 ?scheme=dark。
如果团队里有人对深色有硬要求，两个办法：接受这个差异（毕竟它是副屏用的），或者不用弹出页、只用浮动侧栏（浮动面板跟随 --dsw-alias-* 主题变量）。
权限边界要写进交接文档
站点的自动扫描结论是「含敏感能力」，13 处证据：读写/删除本地文件、写入剪贴板（不计风险）、发起外部网络请求。这些能力都是功能必需，但站点还没有人工评估，也未做风险分级。
远程开发机往往是多人共用或者长期在线的。把这条写进交接文档比藏在 README 里有用：谁在这台机器上装了这个插件，就意味着它能在工作区里读文件、删产物条目、发网络请求。信任档位「已验证」只说明 L4 真实安装通过，不覆盖源码层面的审查。
一套可复用的运维参数
| 项 | 建议值 | 理由 |
|---|---|---|
| 自动刷新 | 追长任务时开，阅读时关 | 省电，减少无意义请求 |
| 文件树 | 目录很深时关 | 降低面板加载开销 |
| 工作区位置 | 本地 ESSD 云盘 | 快照与懒加载都不受网络盘延迟影响 |
| 应用端口 | 只听 127.0.0.1 | 只经反代暴露 |
| 反代缓冲 | 关闭 | 否则实时通道不刷新 |
proxy_read_timeout |
大于最长静默时间 | 防长任务被掐断 |
总结
远程环境里这个插件的可用性由三件事决定：快照成本（工作区放哪）、刷新策略（开还是关）、以及 HTTPS（两个功能直接依赖它）。功能本身很薄——四条跟踪路径、一块面板、一个弹出页，依赖为零，权限为读写本地文件加网络请求。同类插件的部署形态与横向对照见 DeepSeek Harness Hub 插件清单。
适合与不适合
适合：长期在线的远程开发机；多人共用一台 ECS、需要统一审阅视图的团队；对云盘与快照成本敏感、想把参数一次调好的运维。
不适合：只在本机用 DSH 的单人开发者（本篇大部分配置用不上）；要求面板能删磁盘文件的需求；必须在深色主题下保持一致界面的场景；不能接受插件具备本地文件读写权限的合规环境。
标签：dsh-popout-sidebar、DeepSeek Harness、阿里云、远程运维、产物审阅
本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。
