前言¶

在 DeepSeek Harness（DSH）裏做智能體時，人像、寫真、街拍等場景往往需要模型給出可執行的擺姿說明，而不是泛泛的「自然一點」。自己維護姿勢文案成本高，每次對話從零生成也容易重複。社區插件 dsh-photo-pose-plugin 把 60 個 SFW 姿勢按 12 個場景打包成庫，通過 photo、photo_stats 兩個工具暴露給模型，並內置冷卻期去重，避免短時間內反覆抽到同一條。

下面按「是什麼 → 能做什麼 → 怎麼裝 → 怎麼用 → 注意點」說明。

這是什麼¶

dsh-photo-pose-plugin 是 DSH 的 tool 插件（TypeScript 模塊，導出 apply(ctx)，用 defineTool 註冊工具）。維護者爲 icpjimait，在 SkillHub 目錄中歸類爲 趣味換裝；包版本 0.2.0，許可證 MIT。

一句話定位：拍人像、寫真、情侶、閨蜜、親子、街拍、運動、商務不知道擺什麼姿勢時，讓模型按場景從內置庫隨機抽取，每條包含動作要領與拍攝建議。

姿勢數據隨包分發在 poses/poses.json，安裝後即可使用，無需另配庫。

核心功能¶

工具：photo¶

按場景隨機抽取攝影姿勢，返回內容包括：

• 動作要領
• 拍攝建議（焦段、機位、光線等）
• 畫面描述

默認啓用 冷卻期去重：排除最近 10 次已抽記錄，抽中的條目寫入 used.log。

抽取策略（README 說明）：

1. 嚴格模式：排除全部歷史記錄
2. 冷卻期模式：只排除最近 K 次
3. 池子抽完後先報 WARN，再從冷卻池中重抽

插件故意不提供 reset 工具，模型不能清空 used.log。

工具名使用 photo / photo_stats，與私人小說類插件的 pose / pose_stats 錯開，同一 profile 可同時安裝而不撞名。

工具：photo_stats¶

查詢姿勢庫與使用情況的統計，包括：

• 庫總量
• 歷史抽取次數
• 按場景分佈
• 按氛圍分佈

姿勢庫規模與場景¶

共 60 個姿勢 / 12 個場景，內容均爲 SFW。每場景 5 個姿勢。

場景列表：肖像室內、咖啡館、城市街頭、公園草地、海邊、黃昏日落、山野旅行、校園、運動場、商務職場、親子家庭、情侶約會。

安裝與啓用¶

DSH 仍處於 developer preview，本插件在 README 中 pin 了兼容版本（2026-11-08 實測 npm）：

• @deepseek-ai/dsh 0.2.2-rc.1（latest）
• @deepseek-ai/dsh-tools 0.2.2-rc.1（next）
• @deepseek-ai/cordis ~4.1.0
• engines.dsh: >=0.2.2-rc.1 <0.3.0

需要 Node.js 18+。

本地目錄安裝（README 測試流程）¶

先將 DSH Web 跑起來，再把插件裝到指定 profile：

# 1. 先裝 DSH（Node.js 18+）
npx @deepseek-ai/dsh web

另開終端，進入插件目錄後執行：

dsh plugin --profile demo add /path/to/dsh-photo-pose-plugin
dsh --profile demo --dump-config   # 應該能看到 "# == dsh-photo-pose-plugin" 這一層
dsh --profile demo

安裝命令來自倉庫 README，請把 /path/to/dsh-photo-pose-plugin 換成本地克隆或解壓後的實際路徑。從 GitHub 遠程名直裝時，若使用 pnpm 且未跑 prepare，TypeScript 包可能缺少 lib/；本包在 npm install 或本地 dsh plugin add ./... 時會通過 prepare: npm run build 編譯。詳見官方發佈文檔中 “Installing from GitHub: the build-script catch” 一節。

開發者在插件目錄自檢：

cd dsh-photo-pose-plugin
npm install
npm run build   # tsc，生成 lib/
npm test        # node --test，抽取/冷卻/嚴格/fallback/統計全覆蓋

典型用法¶

在 Web UI（默認 http://127.0.0.1:3080）中向模型發起帶場景的抽取請求，例如：

用 photo 工具，在海邊場景抽 3 個姿勢

模型調用 photo 後，應返回 3 個帶 [P0xx] 編號的姿勢塊；同時 ~/.dsh/photo-pose-used.log 中應新增 3 行記錄。再讓模型調用 photo_stats，總量應報 60。

自定義庫與日誌路徑（可選）¶

默認使用包內 poses/poses.json。若改用自有庫或自定義去重日誌位置，可設置環境變量：

默認 used.log 位置：

• 使用包自帶庫時：~/.dsh/photo-pose-used.log
• 使用 photo-pose-library 目錄中的庫時：該目錄下的 used.log

適用場景與注意¶

適合誰

• 在 DSH 裏編排攝影、人像、活動跟拍類智能體，需要結構化擺姿與拍攝提示的開發者
• 希望姿勢來源固定、可審計（used.log），並減少短期重複的會話設計

運行與信任邊界

插件以當前 dsh 進程權限 運行，會讀寫上述日誌與（若配置）自定義 JSON 庫。安裝前應閱讀源碼與 MIT 許可證，確認路徑與數據內容符合你的環境策略。

DSH 生態主張「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，本文不構成官方應用商店說明。

結尾¶

dsh-photo-pose-plugin 把 12 場景、60 條 SFW 攝影姿勢打成開箱即用的 DSH 工具，用冷卻去重和統計工具支撐 repeatable 的擺姿工作流。查閱目錄與源碼：

• 目錄頁：https://www.skillhub.cn/plugins/icpjimait/dsh-photo-pose-plugin
• GitHub：https://github.com/icpjimait/dsh-photo-pose-plugin