dsh-paste-dock
> DeepSeek Harness 插件:大段文本粘贴自动存为 pastes/*.txt,完整信息移到输入框上方的 dock 卡片,草稿里只留一枚可辨识的最小徽标。
它做什么
-
大段粘贴转附件:在输入框粘贴超过阈值(默认 500 字符)的文本时,客户端拦截粘贴,经 RPC 交给宿主写入当前会话工作区的
pastes/<时间戳>.txt(默认上限 1 MiB,CRLF/BOM/UTF-8 逐字节保真);保存失败自动把原文插回输入框并如实说明。宿主同时注册save_paste工具作纪律兜底。 -
草稿内只留可辨识的最小徽标:输入框里插入的是 dsh 原生原子引用 chip(与官方附件同一套节点),默认显示为
📄 开头几个字…(多粘贴依次为📄2、📄3…,带各自开头预览)——
- Backspace/Delete 一次整删,无逐字删除中间态;
- 点击徽标,dsh 内核把它路由到右侧栏预览(装了 dsh-better-sidebar 可编辑);
- 发送路径零改动:chip 序列化成裸@"pastes/x.txt",不增加请求 token,模型自己读文件;已发送消息渲染成同一张可点卡片。 -
输入框上方 dock(order 0,居中卡片):完整信息在
conversation.input.dock槽位——📄、文件名、开头预览… · N 字符 · 路径、✕ 从草稿移除(文件保留)、打开全文(装了 dsh-better-sidebar 走它的编辑器;本机 loopback 部署可经宿主用系统应用打开;都没有时提示点击草稿徽标预览)。
- dock 是草稿引用的投影:草稿里删掉徽标,卡片同步消失;卡片 ✕,草稿里的 mention 同步删除;
- 只认领本插件创建的引用,手输的@"pastes/…"不会被认领;
- 注册表镜像 sessionStorage,会话切走再切回卡片仍在;整页刷新后引用仍有效,但 dock 可能忘记卡片元数据。 -
facade 缺失自动降级:老 dsh 线或输入框正忙时,退回文本引用
@"pastes/x.txt" (N 字符)——发送后同样渲染成可点卡片,dock 也能识别它。
安装
# 本地目录安装(在本仓库父目录执行):
dsh plugin --profile web add ./dsh-paste-dock
dsh --profile web # 重启后控制台可见 [dsh-paste-dock] …
npm 发布后可 dsh plugin --profile add dsh-paste-dock。桌面版需在它自己的 profile 上单独安装一次。
配置(cordis.patch.yml,部署默认;改完重启 dsh,无需重建)
| 字段 | 默认 | 说明 |
|---|---|---|
minChars |
500 | 大段粘贴阈值(UTF-16 code units)。用户可在 Settings → General 覆盖(即时生效) |
maxBytes |
1048576 | 单次粘贴字节上限,宿主强制;硬顶 64 MiB |
chipBadge |
true |
草稿 chip 显示为最小徽标;false 恢复 文件名 · N 字符 完整 label |
dock |
true |
输入框上方 dock;false 不注入槽位(保存功能不受影响) |
客户端 bundle 拿不到 row config,以上值经 pasteStore/getConfig RPC 下发,本地默认仅兜底。
建议搭配 AGENTS.md 纪律
## dsh-paste-dock 纪律
用户粘贴大段文字(约 500 字符以上)时:若输入框钩子未拦截,主动调用 save_paste 工具
把文本存入 pastes/<时间戳>.txt,并在回复中引用该工作区相对路径,不要复述原文。
已知限制
- 切会话后 chip 退化为文本引用:dsh 的草稿镜像只存文本(上游宿主限制),退化后的
@"…" (N 字符)仍可发送、仍渲染成卡片,dock 也能识别。 - better-sidebar 编辑保存 400:上游 DSH-better-sidebar#646(相对/绝对路径不一致),与本插件无关;从它的文件树打开同一文件即可保存。
- dock 卡片的"打开":better-sidebar 探测走
openFile/openPath/open方法名,服务未暴露时落到宿主openWorkspacePath(仅 loopback)。 - 普通文件/图片粘贴不接管:DSH 原生附件管线已覆盖。
开发
pnpm install # 或 npx pnpm@10 install --frozen-lockfile
npm run build:all # tsc(宿主) + tsdown(client 单 bundle)→ dist/,同步 lib/(双份入库)
npm test # node --test(112 项:宿主单测 + 客户端源级契约守卫)
npm run typecheck # 宿主 + 客户端两套 tsconfig 严格检查
npm run lint && npm run format:check && npm run privacy && npm run metrics
源码结构:src/index.ts + src/typert.host.ts(宿主半身,tsc);src/client/*.ts(web 半身,按 shared/rpc/composer/chip/registry/dock/toast/hint/settings 分模块,tsdown 打成单文件 dist/client.js,保持 window.__ModuleLoader__.load 装载契约)。
peer 范围 0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4 枚举白名单——由 scripts/hosts.mjs 经 node scripts/sync-hosts.mjs --write 下发,与 engines.dsh 同源;dsh 挂载前逐包 semver 校验,不满足整包拒载,勿手改。
License
MIT — Copyright (c) 2026 drscrewdriver
