前言¶

在 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