概览
dsh-whale-catch
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
### ✅ 兼容性 | 项目 | 支持范围 | |---|---| | DSH | `>= 0.2.0-rc.2` | | Node | `^22.19 || >=24` | | 平台 | macOS / Windows / Linux（CI 三平台 × Node 22/24） | | 构建 | 无；`lib/client.js` 原样加载 | | 运行时依赖 | `@deepseek-ai/schemastery`（纯校验库） | ### ⚠️ 已知限制 | 限制 | 影响 / 说明 | |---|---| | 只覆盖当前会话 cwd | cwd 外文件不进筐，`present` 声明的绝对路径除外 | | Host 重启 | `present` 描述与轮次号不恢复；文件靠 mtime 重新出现 | | mtime 早于会话创建 | 「复制进来但保留旧时间戳」的文件不会进筐 | | 差异只在 Host 存活期间可看 | `workspace-changes` 把对比留在内存，重启后只剩文件名 | | 差异依赖内核能力 | 宿主没有 `workspaceChanges.diff()` 时面板只给提示 | | 长 diff 截断 | `/diff` 最多 1200 行，面板每条 hunk 最多铺 300 行 | | 归档不自动清理 | 默认在 `$DSH_HOME` 下，不自动同步网盘；请自行整理 | | 预览受浏览器能力限制 | PDF / 图片 / 文本 / 常见源码内联；HTML/SVG 沙箱；docx/xlsx 下载 | | 大列表无虚拟滚动 | 一次渲染全部行；搜索是子串匹配，没有排序 | | 点文件不自动收集 | `.env` 等需要 `present` 显式声明 | ### ❓ 常见问题 <details> <summary><b>面板打开了但一直是空的？</b></summary> 先确认会话有没有 cwd、有没有在本轮结束后点一次「刷新」。文件 mtime 不能早于会话创建时间；`.env` 这类点文件默认不扫。还不行就看 Host 日志里有没有 `no-cwd` / `scan` 相关报错。 </details> <details> <summary><b>为什么「差异」按钮不出现？</b></summary> 只有带 `workspace/changes` 记录的文件才有前后对比。扫描进来的文件、单纯 `present` 的文件没有快照，按钮不会出现；Host 重启后旧轮次的对比也会失效。 </details> <details> <summary><b>为什么 docx / xlsx 点预览变成下载？</b></summary> 浏览器原生不渲染 Office。鱼篓按附件返回，交给系统应用打开；DSH 自带的文档预览更适合这类文件，欢迎 PR 接入。 </details> <details> <summary><b>安装时 npm 报 EPERM / 缓存权限错误？</b></summary> 常见于受限环境把 `~/.npm` 缓存挡在写权限之外。换一个可写缓存即可，不用 sudo： ```sh npm pack --dry-run --cache="$(mktemp -d)" ``` </details> <a id="dev"></a>