dsh-feiyu-image:給陪伴角色接上「拍照」工具

前言

在 DSH 裏跑陪伴類智能體,常見需求是讓模型不只說話,還能按「此刻穿什麼、人在哪」出一張圖,並在 QQ 等橋裏用 markdown 路徑直接發圖。自己拼 prompt、對接生圖 API、還要和劇本插件對齊上下文,步驟多且容易和舊版工具鏈脫節。dsh-feiyu-image(維護者 Vansnc,社區分類:模型推理)把這件事收成模型可調的一個工具 shoot:自動拼固定角色特徵、可變穿着與場景,落盤 PNG,回覆裏寫 ![描述](路徑) 即可。

這是什麼

dsh-feiyu-image 是 DeepSeek Harness 的 npm 插件(當前版本 0.5.0,MIT,要求 Node.js ≥ 22)。定位爲「給陪伴角色一個相機」:模型調用 shoot 即可生成並保存圖片。生圖默認走火山方舟 Seedream 5.0(doubao-seedream-5-0-pro-260628,2048×2048),並保留百鍊 Token Plan 的 wan2.7-image 作爲備用後端。與已停在 0.1.7、依賴舊版 dsh-tools 的 dsh-image-studio 不同,作者針對當前 dsh 0.2.x 單獨實現了單一工具方案。

配套生態上,安裝 dsh-feiyu-life 後,提示詞會讀取「今日劇本」裏的穿着與場景;未裝仍可用,只是提示詞少這兩項。

核心功能

下面介紹插件向模型暴露的能力和運行約束,均來自倉庫 README。

工具 shoot

參數 說明
提示 可選,畫面裏還想要什麼
類型 selfie 自拍,或 scene 只拍場景

生成流程要點:

  1. 提示詞自動拼接:固定特徵(長相、髮色、耳、尾、瞳色等,每次一字不差帶上)、可變服裝(默認女僕裝;睡衣、浴巾、外出服等以畫面描述爲準)、此刻穿着(來自 dsh-feiyu-life 劇本,若已安裝)、場景、光線與畫風。
  2. 硬比例約束:日系成人向、七頭身、非 Q 版;畫風爲二次元(日系成人向動畫、賽璐璐上色)。文檔中的角色設定爲鯨魚娘(藍髮、鯨魚鰭耳、鯨魚尾、女僕裝等),同一角色靠固定特徵與固定 seed 跨場景保持同一張臉,服裝爲可變量。
  3. 出圖保存路徑:~/.dsh/feiyu-image/feiyu-<時間戳>.png。
  4. 節流:默認每天最多 8 張、兩次調用至少間隔 30 秒(可在配置中調整)。
  5. 生圖失敗會返回原因,不會卡住整輪對話。

與 QQ 橋的銜接

回覆中使用 markdown 圖片語法,例如 ![描述](絕對路徑),QQ 橋會把路徑抽成圖片段發送。

成本與耗時(文檔記載)

單張約 18–22 秒,2048×2048 PNG(約 7MB);按 Token Plan 的圖片額度計費,一張一次。

安裝與啓用

先做插件安裝,再確認百鍊 Token Plan 配置文件存在(與 bailian-tp 插件共用)。

dsh plugin --profile web add dsh-feiyu-image

需要 ~/.dsh/bailian-tp/config.json(Token Plan 的 key 和 base)。

DSH 插件在當前 dsh 進程權限下運行;安裝前建議在 GitHub 查看源碼與 MIT 許可證,確認符合你的環境與合規要求。社區目錄頁:https://www.skillhub.cn/plugins/Vansnc/dsh-feiyu-image;倉庫:https://github.com/Vansnc/dsh-feiyu-image。

配置

配置文件路徑:~/.dsh/feiyu-image-config.json(不存在則使用默認)。示例字段如下:

{
  "總開關": true,
  "模型": "wan2.7-image",
  "外觀": "中國大陸 21 歲女大學生,素顏淡妝,黑色齊肩發,皮膚偏白,身形偏瘦",
  "風格": "手機隨手拍,自然光,輕微膠片顆粒,真實質感,不過度磨皮",
  "每日上限": 8,
  "最短間隔秒": 30,
  "存圖目錄": ""
}

文檔另提到:可將參考圖放在 ~/.dsh/feiyu-image/角色設定/正面.jpg,用於鎖定臉、髮色漸變、鯨魚鰭耳、呆毛、鯨魚尾、女僕裝款式等;改設定時也可對照 ~/.dsh/feiyu-image/角色-設定.png。

典型用法

模型側調用示例:

shoot 類型=selfie 提示="把剛取到的畫冊攤在桌上,低頭看畫面"
shoot 類型=scene  提示="宿舍窗臺上的綠蘿,傍晚的光"

用戶側在模型回覆裏用 ![描述](絕對路徑) 引用落盤文件即可發圖。

適用場景與已知邊界

適合誰: 已在 DSH web profile 下跑陪伴角色、需要「劇本上下文 + 生圖 + QQ 發圖」一條鏈路的開發者;願意使用火山方舟 Seedream 5.0 或百鍊 wan2.7-image 並完成 bailian-tp 配置的用戶。

需要注意:

  1. 文檔記載當前部分接口不接受同時傳文本與參考圖(傳參考圖可能 400:Either 'text' or 'image' must be provided, but not both),因此無法完全用「角色參考圖 + 指令」鎖臉;現方案靠固定設定與固定 seed 保持「同一人」觀感,細節仍可能漂移;要更強鎖定需 LoRA 或支持 image-edit 的接口。
  2. 畫面中的中文文字(黑板、書頁等)容易糊成亂碼,儘量避免需要辨認的字。
  3. 穿着與場景自動銜接依賴 dsh-feiyu-life。

反饋

問題可到 GitHub 開 issue(https://github.com/Vansnc/dsh-feiyu-image/issues),附上插件版本與相關圖片。

經過上面的步驟,dsh-feiyu-image 把生圖收斂爲模型的一個 shoot 調用:上下文從劇本插件讀取,圖片落盤到 ~/.dsh/feiyu-image/,再通過 markdown 路徑對接 QQ。目錄與源碼分別以 SkillHub 與 GitHub 爲準維護與迭代。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜