dsh-whale-catch

自动收集 · 就地预览 / 差异 · 交付台账 · 体检 · 回执 · 还原 · 内容搜索

🚀 30 秒上手 · ✨ 功能地图 · 🖥️ 界面 · 🛡️ 安全模型 · English

给 DeepSeek Harness（DSH）的右侧栏交付工作台：把一场会话里产出或改动过的文件自动收进「鱼篓」，支持预览、行内差异、版本链、交付台账、交付体检、回执、归档还原、内容搜索、打包 zip 与复制清单。 [!TIP] 一句话： 不改变你的工作流，只给「这一场会话到底产出了什么」一个常驻的答案。 🧭 目录 🐋 为什么需要它 🆚 和内核产出物的区别 ✨ 功能地图 🚀 30 秒上手 🖥️ 界面与交互 🧠 零登记是怎么做到的 ⚙️ 配置 🛡️ 安全模型 📊 兼容性与已知限制 ❓ 常见问题 🛠️ 开发与测试 🗺️ 路线图 🤝 参与与致谢 🐋 为什么需要它

在 DSH 里连续干上几轮活之后，「文件到底产出到哪了」几乎是日常问题： 🪟 内核的产出物卡片只在当前这一轮出现，往下翻几屏就散了； 🐚 在 bash 里跑 python build_doc.py、npm run build 写出来的 docx / pdf / zip，既不算「文件工具改动」，也没调 present，两套机制都不认； 📦 攒了十几个交付物想一次发给别人，只能回目录里翻，还要担心漏掉； 🔍 改过的文件想看看「改了多少、改了什么」，得切回 git 或翻历史。

鱼篓现在管一条线：自动收、一处看、交付前体检、打包 / 归档 / 回执、历史可回看可还原。改过的文件能就地展开 unified diff、按轮次翻版本、搜正文，都在同一个侧栏里完成。

🆚 和内核产出物的区别

这不是重复造轮子——内核的 deliverables/presented 与 workspace/changes 鱼篓照单全收，只是把它们覆盖不到的场景补上： ✨ 功能地图 🎁 0.4.0 亮点 🧾 从收纳篮到交付工作台：归档会写 manifest.json + 本地台账，Host 重启、换会话都能回看；present 描述也不再随重启消失。 🩺 交付体检：缺文件、超大、空文件、敏感文件名 / 文件头密钥模式、归档后改动，打包前一次列清；内容命中只回传模式名与行号。 🧾 交付回执：自包含 HTML / Markdown，附 sha256，可打印、可核对；API 的 /ledger/verify 可重算摘要确认归档文件没被换过。 🔁 版本链与归档对比：内核本来留着每轮 diff，现在能选第 3 / 5 / 7 轮看；当前文件也能和上次归档的那一版比。 ♻️ 归档还原：skip / rename / overwrite 三策略，先 dry-run，覆盖前自动备份，只写会话工作目录内。 🔎 内容搜索：只搜鱼篓里的文本文件，命中行直接跳预览；不建索引、不落盘、不支持正则。 ✅ 交付勾选：标记已交付、看进度，状态写进台账。 0.3.x / 0.2.x 的逐版细节都搬进了 CHANGELOG.md，README 只留当前版本。

🚀 30 秒上手 环境要求 - DSH >= 0.2.0-rc.2 - Node ^22.19 || >=24（Desktop 自带运行时已满足） - 无需构建、无需额外服务、无需配置数据库 1. 安装

Desktop 用户走应用内：设置 → 插件 → 安装，粘贴下面任一标识（desktop profile 由 Electron 独占，命令行 dsh plugin --profile desktop add 会被拒绝）：

非 Desktop 的自建 profile 才用 CLI：

2. 打开面板

刷新页面（⌘R / Ctrl+R），右侧栏点 +，在引导页里选 「打开深海鱼篓」；也可以直接点侧栏里的 🐋 图标。 3. 开始干活