dsh-inbox

给 DeepSeek Harness（dsh）的本地收件箱插件：把随手复制的东西收进一个仓库，需要的时候找得回来——包括在对话里让助手替你取。

English | 中文

它解决什么问题

一天里复制过的东西——一条待读的链接、一张截图、一段配置、一个账号密码——散落在剪贴板历史、收藏夹和临时文件里，要用的时候找不到，也记不住放在哪。

dsh-inbox 把它们收进一个本地仓库：粘贴即存、自动分类、侧栏里能翻能搜；想找的时候不必自己翻，直接在对话里问助手「我上个月存的那篇讲缓存的文章呢」。

它只服务于你自己：数据全部落在本机，只有你让助手查的时候，模型才看得到内容。

主要功能

功能	说明
两个入口	输入框里 /inbox <文字或链接>（图片附在输入框上一起收），或面板里粘贴 / 拖拽 / 选择文件
自动分类	链接按平台与类型分（B 站视频、公众号文章…）、文本按密钥形状分、图片按比例加「疑似证件」标签；规则判不出的交给模型兜底，有每日上限
面板	待看 / 类目 / 标签筛选 + 跨标题正文链接备注的搜索；两种列表密度；详情里能改名称、类目、备注、标签，能标待看，能删除与恢复；跟着 dsh 的深色/浅色主题走，也跟着它的语言走（在「设置 → 常规」里把 dsh 切成 English，面板、右侧 dock、对话卡片与使用手册一起变）
每条都有名字	链接自动抓页面标题（不花模型 token）、图片文件用原文件名；你自己起的名字永远优先。列表里显示名字本身，类型交给左侧图标（密钥就是一把钥匙）
类目是谁判的	类目旁带颜色标签：规则判定（灰）/ 模型判定（紫）/ 手动判定（蓝）。你改过的类目，后续任何流程都不会覆盖
对话里取回	直接问「我的收件箱 / 仓库 / inbox 里有哪些还没看的链接」就行，助手按关键词/类目/标签/待看/类型查（最多 10 条 + 还剩几条，带图的结果直接显示缩略图），按 id 打开一条（正文最多 1000 字、链接、备注、标签、附件信息）。想直接看某一条：展开回答上方的「N 次工具调用」，记录后面的「打开 ↗」会在右侧「仓库」里停到那一条
看图	默认图片字节不进对话；你说「帮我看这张图是什么」时，助手才会把那张图发给自己看（一次性、显式要）
密钥安全	账密正文加密落盘：主密码派生密钥，密码与密钥都不落盘；列表只显示你起的名字；明文永不进对话、永不发给模型
双向同步	配一个 WebDAV 目录或 S3 桶：入库后自动推送，点「刷新」做一次完整同步（先推后拉、按时间合并），清空回收站连云端一起删
对话卡片	工具结果渲染成 dsh-inbox 卡片：链接可点，图片标记在本机渲染成缩略图
网关兼容	有些对象存储网关把每把 AccessKey 绑在"应用"上并按客户端标识认人（状态码与"密码错"一样）——插件支持按协议各存一份客户端标识

界面

界面都在 dsh 里：左侧栏多一个 Inbox 入口，点开是整页仓库管理；面板右上角有「设置」和「使用手册」（手册把常见场景讲了一遍）。

两种用法

① 存：在对话里转存

输入框里写 /inbox 再跟文字或链接，图片直接附在输入框上——这条命令不会发给模型，只进仓库。适合存账号密码、临时链接这类不该出现在对话里的东西。

② 取：在对话里问

不用记命令，正常说话就行：

我收件库里那个小程序码是哪张？

上周存的讲缓存的文章给我看看

帮我把还没看过的链接列一下

同一段对话里的两次提问（真机截图）：

安装

前置：Node ≥ 22，以及一个能用的 dsh。dsh plugin add 是转发给 pnpm 的，所以机器上没有 pnpm 时，安装命令会顺手替你装好：

平台：目前只在 Windows 上做过完整验收；macOS / Linux 尚未验证（代码里没有平台特定依赖，欢迎试用后反馈）。

dsh web 就是 dsh --profile web，所以直接装进你日常启动的那个 profile：

npx @chance722/dsh-inbox init --profile web --install-pnpm

然后照旧启动——dsh web。左栏出现 Inbox；新会话里问「我的收件箱里有哪些还没看的链接」，助手就会去查。

全新机器（从没跑过 dsh，还没有 web 这个 profile）加 --create-profile 让它先建：

npx @chance722/dsh-inbox init --profile web --create-profile --install-pnpm

init 做三件事，重复运行是安全的：

1. 把插件装进这个 profile——面板和宿主半边都从这里来
2. 复制 dsh 自带的 standard preset 到 ~/.dsh/.agent-presets/inbox/ 并加入本插件——这一步决定助手能不能看到收件箱工具
3. 把你用户级的默认 preset 指向它（会先备份 ~/.dsh/settings.yaml），于是所有 profile 的新会话都带上这套工具

有两件事跟你的设置有关，先说清楚：插件会进你点名的那个 profile；你的默认 agent preset 变成「收件箱」那份——它是 standard 的副本快照，dsh 以后升级 standard 不会自动跟着变。两件都能退（见「卸载」）。

想让日常 dsh 保持干净？ 给插件单独一个 profile 和端口：

npx @chance722/dsh-inbox init --create-profile     # 建一个隔离的 inbox profile
dsh --profile inbox --no-open --port 3102          # 在那个 profile 里起

其它选项：--profile <名字> 装到别处，--install-pnpm 在没有 pnpm 时先替你装（上面两条命令已经带上它），--no-default 不动默认 preset，--help 列全。装进哪个 profile 只决定面板跑在哪儿——agent preset 是所有 profile 共享的（~/.dsh/.agent-presets/inbox/），装第二个 profile 只会补上缺的那行。

从本地仓库装

git clone <本仓库> dsh-inbox ; cd dsh-inbox
pnpm install ; pnpm build
node lib/cli.js init --package <本仓库的绝对路径>

卸载

# 1. 从你装进去的那个 profile 里摘掉（同时会从 dsh.profile.bundles 移除）
dsh plugin --profile <你装的 profile> remove @chance722/dsh-inbox

# 2. 删掉 init 建的东西
rm -r ~/.dsh/.agent-presets/inbox      # 那个 preset 副本
# 默认 preset：把 ~/.dsh/settings.yaml 里 agent-presets.default 删掉（继承部署默认），
# 或改成 standard；init 每次都留了 settings.yaml.bak-* 备份，也可以直接还原

# 3. 想连这个 profile 一起删（只为这个插件建过才需要）
rm -r ~/.dsh/profiles/<你装的 profile>

卸载不会删掉你的仓库。 连记录一起删：rm -r ~/.dsh/storages/dsh_inbox。

东西存在哪

全部在本机（%DSH_HOME%，Windows 上就是 C:\Users\<你>\.dsh）：

什么	在哪
记录：文本、链接、类目、备注、标签、待看…	storages\dsh_inbox\items\*.json（一条一个文件）
附件索引（mime / 尺寸 / 原文件名）	storages\dsh_inbox\attachments\*.json
图片 / 视频 / 文件的字节	attachments\（dsh 自己的附件仓库，按内容寻址，永不自动删）
远端密码 / S3 AccessKey Secret	dsh 的凭证库 .credentials.yaml
远端设置（地址、桶、客户端标识…）	dsh 的 settings

云端长什么样

配了远端（WebDAV 目录或 S3 桶）、目录填 /inbox 时：

远端路径	是什么
inbox/<你扔的文件>	投放区：任何设备往这儿扔文件，本机拉取时读它们并入库
inbox/sync/items/<记录 id>.json	一条记录的机器可读版（同步的真相来源）
inbox/sync/items/<记录 id>.txt	同一条记录的可读版（云盘里直接能看：正文、备注、附件指向）
inbox/sync/attachments/<附件 id>.<扩展名>	附件字节（图片 / 视频 / PDF 直接能打开）
inbox/sync/attachments/<附件 id>.meta.json	附件元数据（原文件名、宽高、字节数、摘要）
0 字节、以 / 结尾的 key	云盘自己建的目录占位，不是插件写的

隐私与安全

• 账密加密落盘：账密正文以密文保存（AES-256-GCM，密钥由你设的主密码派生）。主密码和密钥都不落盘——服务每次重启都要在「设置 → 账密加密」解锁一次；密码忘了就解不开已有密文，没有找回。没设主密码时，账密不会被存进去。
• 加密的边界：只加密账密的正文。备注、类目、标签、时间与附件的字节不在内——附件里装着密钥，它就是明文。别把"账密加密"理解成"整个仓库加密"。
• 列表与对话脱敏：密钥类记录在列表里只显示你起的名字；明文永不进对话、永不发给模型。
• 图片：分类时会把图片发给模型判断（手机拍的证件照比例与普通照片无异）；对话里默认只回 [attachment:id] 标记，字节不进对话。唯一的例外：你明确让助手「看这张图」时，它会把那一张发给自己看——每次都要显式要求，默认永不发。
• 模型看不到你的仓库，除非你让它查（它调工具时才读得到），且分类请求先过脱敏。
• 云端要有访问控制：同步上去的内容里只有账密正文是密文，其余（文本、链接、备注、附件字节）是明文；主密码与密钥从不同步。

开发

pnpm install
pnpm build        # lib/index.js（宿主）+ lib/client.js（面板）+ lib/cli.js（init）+ lib/types
pnpm typecheck
pnpm test         # vitest

改客户端代码：pnpm build 后刷新页面即可（dsh 的 client-hmr 会自己重载）；改宿主代码要重启服务。细节见 docs/help/dev-setup.md，阶段与验收记录在开发总线。

许可

MIT