Kidai-Clipboard

---

✨ 为什么用？

DeepSeek Harness 的对话、命令、片段散落在各个会话里。KCB 把「抓取草稿、保存会话、从快照分支续写、粘贴回输入框」收进一个悬浮窗口——不再翻聊天历史，不再复制粘贴长文本。

• 🪟 可停靠悬浮窗：拖动、双向缩放、贴右缘停靠（工作区自动避让，不遮挡内容）、收起为竖条
• 📝 保存输入：一键抓取当前输入框草稿
• 🧩 保存会话：完整历史快照（标题/分支点/转录），可编辑重命名
• ✂️ 中途截断分支：保存时可选「存到第几轮为止」，丢弃其后的对话（会话走到 12345 → 只存 123）
• 📜 滚动选择历史轮次：分支点列表先显示最近几轮，向上滚动持续加载更早的历史
• 🔘 回复行入口：每条助手回复下方操作行里的「保存会话分支」，默认定位到该回复所在轮次
• 🧰 布局可调：操作按钮可排成底部一行或面板左侧竖栏；缩放把手可在右下角或左侧竖列之间切换（避开其它插件浮层遮挡）
• 🎈 收起胶囊可拖动：停靠收起后的竖条可上下拖动定位（记忆位置）；向左拖离边缘松手即变悬浮窗展开
• 🌳 文件树分组：Obsidian 风格文件夹树，展开/收起，未分类平铺
• 🖱️ 拖拽整理：把条目拖到文件夹行＝移入，拖到另一条目＝插到它前/后并归入同一文件夹，拖到空白＝移出
• ✏️ 文件夹编辑：文件夹名称 + 调色板颜色（含「无色」），弹窗式编辑，随开随改
• 🔀 在新会话中继续：对快照执行 DSH 原生 fork，在选定轮次一键分支续写（从 123 接着写 12367）；原会话失效时自动转录兜底
• 🏷️ 管理：文件夹、彩色标签、颜色标记、置顶、搜索、多选批量删除

装上即用 —— 重启 DSH 后，侧边栏底部「自动剪贴板」打开窗口。

---

🚀 快速开始

安装

# 本地开发安装（或经该插件自身市场安装）
dsh plugin --profile desktop add file:D:\path\to\kidai-clipboard
# 或 GitHub：
dsh plugin --profile desktop add git+https://github.com/NokorinNishikino/Kidai-Clipboard.git

重启 DSH 生效。

卸载

dsh plugin --profile desktop remove kidai-clipboard

或从 profiles/desktop/package.json 移除依赖与 bundle 声明，删除 node_modules/kidai-clipboard。

---

🎛️ 产品简介

• 项目/包名：kidai-clipboard；品牌名 Kidai-ClipBoard（纪代剪贴板），简称 KCB
• 形态：DSH 双端 Bundle（Host 持久化 + Client UI），桌面与 Web 通用
• 数据：$DSH_HOME/kidai-clipboard/store.json（schema 1，原子写）
• 约束：条目 ≤ 5000、会话记录 ≤ 8000、转录 ≤ 1 MB

---

📚 技术细节

• 停靠：settings.window.dock: "right"；右端钉死左侧拖宽（最小 280）；收起/关闭自动释放；停靠时扁平无缝（无投影、去掉自身顶边框、顶边紧贴会话区分界线）
• 工作区挤出：注入样式表规则 #kidai-clipboard-dock-inset → [data-conversation-scroll]{margin-right:Npx!important}（不用 inline style —— DSH 重渲染会把 React 不认识的 inline 属性清掉，切换会话后内容就会被面板挡住）；收起态挤出胶囊宽度 42px；拖动/拖到边缘时跟手，松手用 .kidc_snapBack 过渡滑入停靠位
• 拖动性能：拖动/缩放期间零 store 写入、零请求，尺寸直接写 DOM（requestAnimationFrame 节流），左侧工作区联动按 ~90 ms 节流；面板内容在拖动时隐藏并显示实时尺寸占位屏，松手才落库一次
• 缩放把手位置：settings.ui.resizeHandle = corner（默认，右下角）/ edge（窗口左侧整条竖列；左边界跟随指针、右边界固定）—— 右下角被其它插件遮挡时用 edge
• 操作按钮位置：settings.ui.actionBar = bottom（默认，底部一行：新建输入 / 保存快照 / 抓取输入）/ left（面板左侧竖栏排列）
• 收起胶囊：settings.window.pillTop 记忆竖直位置（缺省＝会话区顶）；位移 ≥3px 才算拖动、否则算点击（点击语义在 pointerup 判定，避免残留状态吞掉下一次点击）；向左拖离右缘 >24px 视为"拖出停靠" → dock: null 并在该位置以悬浮窗展开
• 设置页框架：参照 kidai-snapshot-guard —— 状态 chips（统计 + 版本）→ 横向页签（通用 / 会话保存 / 数据 / 关于）→ 卡片内容；SettingsPanel({ layout }) 的 hub 形态用左侧品牌栏（168px），classic（设置页回退）用横向品牌头部
• 拖拽整理：原生 HTML5 拖放（draggable + dragstart/dragover/drop，条目 id 走 dataTransfer）。拖到文件夹行＝设 folderId；拖到另一条目＝按鼠标在卡片上下半决定插入前/后，并继承其 folderId，随后重编同容器内所有条目的 order（0..n-1）；拖到列表空白＝folderId = null。排序规则：置顶 → order → 最近更新。拖放事件一律 stopPropagation，否则会被父级（文件夹行/列表根）抢走
• 文件夹编辑：prefs.folderEditor 记录目标 id，弹窗内改名称 + 从 PALETTE 选色（含 null＝无色），Enter 保存 / Esc 关闭
• 会话保存：remote.session.follow + 反向 page（slim 事件），保存 sessionId / lastSeq / transcript / agentPreset / cwd
• 中途截断：以 turn/end 事件列出已完成轮次；选定第 N 轮时 atSeq = 该 turn/end 的 seq，turnCount / totalTurns 记录截断信息，records 与转录同步裁剪
• 历史分页：选择器先取 follow 最新一页，再用 session.page({throughSeq}) 逐页回溯（滚动到顶部同样触发；浏览上限 20000 事件，独立于「最大会话记录数」），保存前自动补齐
• 继续：ctx.sessions.fork({sessionId, atSeq})——先按选定轮次边界切，失败降级到最后完成轮次，再失败转录兜底
• 安全：65 MB body 上限、id 白名单正则、损坏 JSON 容错、atomic tmp+rename
• 测试：scripts/smoke-*.mjs（host 路由/契约/槽位行为）；scripts/verify-*.mjs（真实组合/捕获校验）

---

🔍 说明

• 依赖 DSH 前端服务 sessions/conversation/remote.session（不可用时给出提示）
• 本地开发需 node scripts/sync-install.mjs 同步到 profile 再重启

---

📄 License

MIT