前言¶
在 DeepSeek Harness（DSH）裏做多模態生圖或對照參考出圖時，常見做法是在瀏覽器裏開圖庫、手動保存圖片、再貼進對話框並手寫提示詞。步驟多、容易漏圖或詞不對齊。油猴腳本《AI 生圖參考圖一鍵填充》已經驗證了「選圖 + 拼提示詞 + 寫入輸入框」的工作流，但依賴用戶腳本管理器和頁面匹配聲明。
dsh-ref-autofill 是同一思路的 DSH 插件版：保留原有 UI 與數據層邏輯，由 dsh plugin 安裝、在 dsh web 客戶端內加載，不再需要油猴運行時。下面介紹它做什麼、怎麼裝、怎麼用，以及使用時需要注意的數據與授權邊界。
這是什麼¶
dsh-ref-autofill（維護者 dddaniel1）是 DeepSeek Harness 的參考圖一鍵填充插件，分類屬於聯網工具。它在 dsh web 裏提供中文 AI 參考圖庫瀏覽面板，選中臉 / 服裝 / 姿勢等參考後，把高清原圖寫入對話框附件區、把生成的提示詞寫入編輯器；是否發送由你自己決定。
插件由原油猴腳本 dsh-ref-autofill.user.js 插件化而來：站點適配與交互原樣保留，存儲從 GM_getValue 改爲 localStorage（鍵名不變）。參考庫數據運行時從公開 CDN 按需讀取，不打包進插件倉庫。
核心功能¶
已覈實的能力如下（數量以 README 記載、安全模式開啓時姿勢庫爲準）：
- 三個參考庫：臉（1499 項）、服裝（3224 項）、姿勢（153 項）。
- 搜索與篩選：中文 / English / 編號全文檢索；臉可按髮長·髮型過濾，服裝可按大類·分類，姿勢可按體系·動作分類。
- 姿勢多視角：正面 / 俯視 / 仰視 / 側面 / 斜側；可在 3D 白模與深度圖（ControlNet Depth）之間切換。
- 提示詞生成：按所選圖拼出「圖1 人像參考 / 圖2 服裝參考 / 圖3 姿勢參考」，支持風格預設、補充描述、改寫與一鍵複製。
- 本地圖片：托盤未選槽位可上傳本地圖，與圖庫混搭。
- 一鍵填充：高清原圖進 DSH 輸入框附件區，提示詞進編輯器；重複填充自動去重。
- 交互細節：安全模式、參考圖數量上限、面板可拖動/縮放/吸附、跟隨 DSH 明暗主題、
Alt+Shift+R呼出面板。
網絡請求走瀏覽器 fetch；三個數據源均返回 Access-Control-Allow-Origin: *，插件僅在 DSH 客戶端內運行，無需 @match / @connect 類聲明。
安裝與啓用¶
從 GitHub 安裝（命令來自項目 README）：
dsh plugin --profile web add github:dddaniel1/dsh-ref-autofill
dsh web
本地開發或調試時，可將倉庫路徑直接加入 web 配置：
dsh plugin --profile web add /path/to/dsh-ref-autofill
啓動 dsh web 後，頁面右下角出現「參考庫」按鈕，點擊展開面板；也可使用快捷鍵 Alt+Shift+R。
package.json 聲明引擎要求：node >= 20，dsh >= 0.2.1-rc.5 且 < 0.3.0。插件當前版本爲 1.0.0，許可證 MIT。
典型用法¶
按 README 的可復現步驟操作即可：
- 在「臉 / 服裝 / 姿勢」標籤裏點卡片選參考圖；姿勢庫可按需切換角度或深度圖。
- 需要時用本地上傳填滿未使用的槽位。
- 檢查自動生成的提示詞，按需換風格預設或補充描述。
- 點「填充到對話框」，覈對輸入框中的圖片與文字，確認無誤後再自行點擊發送。
插件不會替你發消息；填充只是把素材與文字準備好，發送時機仍由你控制。
適用場景與注意¶
適合誰：在 DSH Web 裏做 AI 生圖、需要系統化對照臉 / 服 / 姿勢參考，並希望減少「找圖 → 下載 → 粘貼 → 寫詞」重複勞動的開發者或創作者。
數據與授權：參考庫數據來自開源項目 anhao/ai-pose-gallery-zh。人像臉庫與中國曆代服飾爲 CC0；姿勢庫與其餘服裝庫圖片禁止二次分發。插件運行時按需從 CDN 讀取，不轉儲、不再分發圖片。使用前請閱讀上游倉庫與 README 中的署名與限制。
安全與信任：插件以當前 DSH 進程及瀏覽器上下文權限運行，會發起對外 fetch。安裝前建議查看 GitHub 倉庫 源碼與 MIT 許可證，確認符合你的環境策略。DSH 社區插件目錄（如 SkillHub 目錄頁）爲獨立生態站點，與 DeepSeek / 幻方無官方從屬關係；「一切皆插件」是 DSH 的設計取向，不代表官方應用商店審覈。
倉庫提供 test/e2e.js，可在真實 DSH 頁面控制台調用 runE2E() 做自檢（見 README「插件結構」一節）。
結尾¶
dsh-ref-autofill 把中文 AI 參考圖庫嵌進 dsh web，用一鍵填充把高清參考圖與結構化提示詞同步到對話框，同時去掉對油猴的依賴。若你的工作流已經在 DSH 裏，可按上文命令安裝，用「參考庫」面板或 Alt+Shift+R 開始選圖。
