前言¶
在 DeepSeek Harness（DSH）中，直接往輸入框粘貼圖片，內核通常只把它當作內存裏的 object URL，不立即上傳到磁盤。這導致兩個問題：其一，官方的 @ 菜單裏找不到這張圖；其二，沒有固定的編號，無法在長對話中精確指代它。dsh-picflow 解決了這個缺口：它將粘貼操作轉化爲一次入庫，賦予圖片固定的編號（如 圖片506），並在輸入框旁提供面板進行管理和插入。
工作原理¶
插件會每 350 毫秒讀取一次輸入框的實時草稿附件，將圖片字節 POST 給宿主路由，由宿主調用官方 attachments.saveImage 接口。這套流程保證了圖片以同一套規範入庫，擁有相同的 SHA256 和對象。編號則依據全庫文件的修改時間（mtime）升序排列，最早的那張固定爲 圖片1，後續新增的圖片編號只會更大。
核心功能¶
粘貼即入庫與編號固定¶
粘貼的圖片會自動進入附件庫並分配編號。編號在全庫範圍內唯一且固定，即便你未發送該圖片，它也會被收錄，方便後續引用。
輸入框旁的面板與搜索¶
輸入框旁展開「引用素材」面板，顯示最新圖片。面板包含縮略圖、編號、時間、大小，並提供操作按鈕：
* 插到光標處：在光標位置插入引用芯片。
* 掛上：將圖片存爲當前消息的附件，供模型直接查看。
* 路徑：複製 Markdown 引用。
* 全屏查看：點擊縮略圖查看大圖。
面板支持搜索與篩選，可按編號、日期（如 10-04）、文件名、SHA 前綴或大小（如 128kb）搜索。排序支持最新/最早/最大，翻頁每次加載 120 張。
時間桶與狀態桶¶
- 時間桶：頂部固定篩選欄，提供「全部」「近3天」「近7天」「近30天」「更早」，具體日期通過「按日期」開關展開。
- 狀態桶：第二排提供「用過」「沒用過」「已置頂」「大文件」「小噪音」「可清理」等篩選，實時統計各狀態圖片數量。
使用賬本與清理嚮導¶
插件會在本地記錄使用情況（<DSH_HOME>/dsh-picflow/usage.json），每一次插入或掛上都會更新記錄。
* 清理嚮導：針對「入庫滿 N 天（默認 14）」「從未被引用」「未置頂」「不屬於當前會話」的圖片提供清理選項。點擊「移入回收站」會將圖片搬至 <DSH_HOME>/trash/dsh-picflow/，7 天內可撤銷，到期才真刪。
其他能力¶
- 置頂：可手動置頂圖片，置頂項不會進入清理候選。
@圖片源：在@菜單中會出現「圖片」分組，選中插入的即爲此類引用芯片。- 自動插入：默認開啓。粘貼入庫後，引用芯片會自動落到光標處；關閉後需手動點擊面板按鈕。
安裝與啓用¶
支持以下任一方式安裝：
curl -fsSL https://raw.githubusercontent.com/XWIDE/dsh-picflow/main/install.sh | sh
桌面端（Windows）：
iwr https://raw.githubusercontent.com/XWIDE/dsh-picflow/main/install.ps1 -useb | iex
手動安裝：
dsh plugin --profile web add git+https://github.com/XWIDE/dsh-picflow.git
安裝完成後，需重啓承載插件的應用（如 DSH NEXT 或 dsh web 進程），以便宿主註冊 HTTP 路由。
典型用法¶
- 粘貼入庫：在輸入框粘貼截圖，圖片自動編號併入庫。
- 插入引用：在面板中點擊「插到光標處」，或開啓自動插入功能。
- 精準引用：在對話中輸入
圖片506，或通過面板搜索找到該圖片。 - 管理歷史：使用清理嚮導篩選「可清理」的圖片，移入回收站。
注意事項¶
- 本地運行：插件不聯網，所有操作在本地完成，無外部依賴。
- 必入庫行爲：粘貼的圖片即便未發送，也會進入附件庫。這是設計取捨，清理嚮導是爲此準備的補救機制。
- 格式與大小：支持 PNG、JPEG、WebP、GIF。單張圖片最大 20MB（官方庫），請求體上限 24MB。
- 環境要求：需要 Node.js 22.19+ 或 24+。
- 兼容性：已針對 DSH 0.2.0-rc.2 實測驗證。
結語¶
dsh-picflow 通過攔截粘貼操作，將零散的內存附件轉化爲可管理的本地資源，解決了在長對話中引用截圖的痛點。它提供了從粘貼、編號、面板管理到清理的完整閉環，適合需要頻繁處理截圖的智能體開發者使用。
