dsh-at-sider：为 DeepSeek Harness 侧边栏文件树补上 @ 引用与排序

它是做什么的？

它是 DeepSeek Harness（DSH）的侧边栏文件树增强插件，在保留原生「文件」标签页的前提下，为每一行补上 @ 引用按钮、大小与修改时间两列，以及页头全工作区搜索框。它解决的是原生文件树只能看名字、无法快速引用文件、也无法按时间或体积排序的麻烦，让你不必离开侧边栏就能把文件引用插进当前会话。插件由 aiyacharley 维护，采用 MIT 协议，用 JavaScript 编写，零配置即可使用。

核心功能

• @ 引用按钮：悬停或聚焦任意行时，文件名右侧出现 @文件（目录为 @文件夹），点击即把 @路径 作为原子引用插入当前会话输入框，与内置 @ 补全、拖入文件生成的引用完全一致；按住 Alt/⌥ 点击则改为复制引用文本。
• 大小与修改时间列：行尾显示人性化大小（如 870 B、1.5 KB、1.2 MB）和本地时间 YYYY-MM-DD HH:mm，悬停可看精确字节数与完整本地时间，列宽按树体宽度自适应，窄到 300–379px 时自动隐藏大小列。
• 页头排序与搜索：排序按钮在按名称、按修改时间、按大小、按类型之间循环，目录始终在前、缺字段条目沉底，偏好写入 localStorage；搜索框可递归整个工作区查找文件。
• 预览页签右键动作：在文件预览页签上右键，可一键 @文件 或「在文件树中定位」，定位会展开祖先链并高亮目标行。
• 随时回退原生：右键「文件」页签选择「回退原生文件树」即可切回原生树，插件不修改任何原生代码，卸载后原样恢复。

怎么使用这个插件？

在 DSH 中启用后，打开右侧栏的「文件」标签页（或按 Mod+P），把鼠标移到任意一行上，文件名右侧就会出现 @文件，点击即可把该文件的引用插入当前会话输入框；按住 Alt/⌥ 点击则复制引用文本。行尾的大小与修改时间、页头的排序按钮与全工作区搜索框都直接可用，无需额外配置。需要对照原生树时，右键「文件」页签选择「回退原生文件树」；打开文件预览后右键该页签，还能一键 @文件 或定位到树中对应行。列表与搜索路由只做只读访问、不读取文件内容，且被限制在会话工作区根内。

报错怎么排查？

• 开发中改了客户端产物却「重启也没生效」：客户端产物按文件元数据派生的版本戳寻址，旧版本戳的请求会被拒绝而不是返回新字节。先做浏览器硬刷新，仍不行就按官方说明卸载重装，重装会触发实时重扫并发布新版本戳。
• 输入框不可达：@文件 会自动降级为复制引用文本，属预期行为。
• 文件监听不可用：树不会自动刷新，退回手动刷新即可。
• 页签动作菜单条目缺失：只是少两个菜单项，其余功能不受影响。