dsh-paste-doc：DSH 客戶端長文本粘貼插件

在 DSH（DeepSeek Harness）中，直接粘貼長文本通常只會被當作普通文本發送給模型，模型難以精準引用其中的細節。dsh-paste-doc 插件解決了這個問題，它能在粘貼長文本時自動生成「文本文檔引用」，效果類似 DeepSeek 官方聊天的文檔摺疊功能，方便在發送給模型前查看和引用。

插件介紹¶

dsh-paste-doc 是一個 DSH 客戶端插件，由 dzf-code 維護，開源協議爲 MIT。它主要用於在輸入框中粘貼長文本時，將其轉換爲可視化的引用芯片和文檔卡片，並在發送時將其序列化爲結構化 XML 文本，供模型閱讀。

核心功能¶

自動轉換：粘貼 ≥ 200 字的文本，自動轉換爲引用芯片（顯示 📄 + 文本前幾個字的預覽）。
文檔卡片：輸入框上方出現可展開/收起的文檔卡片，隨時查看全文。
結構化序列化：發送時將引用序列化爲結構化 XML 文本：

    <引用文檔 id="doc1" 標題="…" 字數="1234">
    <全文>
    ……原文……
    </全文>
    </引用文檔>

引用語法：輸入 @docN 高亮引用；@ 菜單可手動插入歷史粘貼文檔。
極簡樣式：透明底色 + 中性描邊膠囊（跟隨主題，無陰影）。
實時同步：卡片與芯片實時同步，刪除芯片 → 卡片消失；發送後 → 全部清空。
逃生通道：支持 Ctrl+Shift+V（Windows/Linux）或 Cmd+Shift+V（macOS）粘貼純文本。

安裝與啓用¶

前置條件¶

DSH web profile
pnpm

安裝命令¶

插件聲明瞭 dsh.bundle.patch 並隨包攜帶 cordis.patch.yml，安裝後自動加入 profile 的 bundle 層，無需手工編輯配置文件。

dsh plugin --profile web add "github:dzf-code/dsh-paste-doc"

安裝完成後重啓 dsh web，進入設置 → 插件列表確認 paste-doc 狀態爲 active。

兼容性說明¶

DSH 0.1.5 將輸入框形態改爲 Lexical，需使用 v0.1.11+ 插件兼容。
DSH 0.1.5 起芯片改爲 Lexical 節點，需使用 v0.1.12+ 插件適配樣式。
插件自 v0.1.11 起自動兼容兩種形態（舊版 <textarea> / 新版 Lexical）。

典型用法¶

粘貼長文本：直接 Ctrl+V 粘貼長文本，自動變成引用芯片 + 文檔卡片。
查看全文：點擊輸入框上方的卡片「展開」查看全文。
刪除引用：在輸入框裏刪掉芯片（退格或選中刪除），卡片會同步消失。
手動插入：輸入 @ 在菜單中選擇「粘貼文檔」來源。
特定命令行爲：當 /plan、/goal 等命令 claim 正在生效時，粘貼長文本會以純文本插入（而不是芯片），確保完整內容進入命令參數、不被截斷。
粘貼純文本：如需粘貼純文本（不轉引用），使用 Ctrl+Shift+V（Windows/Linux）或 Cmd+Shift+V（macOS）。

注意事項¶

文檔庫保存在瀏覽器內存中，刷新頁面即清空。
需要確保 DSH 版本與插件版本匹配，特別是升級 DSH 到 0.1.5 後，需升級插件到 0.1.11+ 以維持輸入框兼容，升級到 0.1.12+ 以維持樣式兼容。

總結¶

dsh-paste-doc 通過結構化的 XML 序列化和可視化的卡片展示，解決了在 DSH 中處理長文本上下文的痛點，讓模型能更準確地引用粘貼的文檔內容。