前言¶
做小红书图文时，常见做法是：从 Excel、PDF 或 Word 里人工拆选题、逐篇写文案，再用设计工具或生图模型拼封面和内页。版式容易随工具或提示词波动，同一批内容也很难保持统一风格。DeepSeek Harness（DSH）把能力拆成可安装的插件；在 Desktop 工作台里，可以把「资料进 → 选题 → 勾选 → 按模板出图」收成一条固定流程。
下面介绍社区插件 dsh-xhs-batch-studio（维护者 Nanfeng0108，GitHub 仓库 Nanfeng0108/dsh-xhs-batch-studio）。它是 DSH Desktop 工作台插件，分类为模型推理：用本机配置的模型做选题提炼与文案，封面与内页由 HTML 模板渲染，不依赖图片生成模型，同一模板与配色下输出稳定。
这是什么¶
一句话：把 Excel / PDF / Word / CSV 资料批量变成小红书图文——先提炼可编辑的选题清单，勾选后再按写作模板与版式模板生成文案、封面、内页图，并导出索引表。
插件通过 dsh.client 注入 dsh-desktop-workbenches，左侧工作台名称为「小红书批量工作台」。服务端路由在 dsh/index.js（/api/xhs-batch/*），客户端为三步式面板（lib/client.js）。当前 npm 包版本为 3.6.11（见仓库 package.json），许可证 MIT。
工作流¶
README 中的流程可以概括为三步：
① 导入资料（Excel / PDF / Word / CSV）
↓ 解析 + OCR + 提炼
② 选题清单（可编辑标题/角度，勾选要写的）
↓ 写作模板 + 版式模板
③ 成品（文案 + 封面 + 内页图 + 总清单）
第一步只提炼选题，不写文案。 可以先核对选题、改标题与角度、只勾选要写的几条，再进入第二步；换一批选题不会改动已上传的资料。
文案阶段需要模型：在 DSH 里配置好 DeepSeek，或设置环境变量 XHS_USE_DSH_MODEL=1 借用当前 provider 的 key。不需要登录小红书账号；出图在本机完成，设置里的「图上署名」只是印在图片角落的文字，可留空。
核心功能¶
资料导入与选题¶
支持 Excel、PDF、Word、CSV。上传后解析，必要时 OCR，再提炼选题。可调「内容方向」收敛选题（例如「小户型收纳」），以及「选题数量」（一次提炼多少个；最终篇数由勾选决定）。
写作模板（技能）¶
顶部「模板 / 技能」中可选内置写作模板：干货清单、教程步骤、避坑指南、测评对比、观点共鸣、好物合集。也可新建自定义模板，配置节数范围、每节行数、每行字数、标题规则、开头钩子、结尾引导、语气、补充要求（可粘贴自有写作 skill / 规则），并支持编辑、另存、删除（内置模板只能另存）。
自定义写作模板文件路径：
$DSH_HOME/xhs-batch-studio/templates/writing/*.json
可直接改文件或纳入版本管理。
版式与出图稳定性¶
- 封面 3 种固定版式（大字报 / 杂志留白 / 便签），每种有 a、b 两个构图变体，均为 HTML 模板渲染，不调用图片生成模型。
- 内页 2 种固定版式（编号卡片 / 时间轴），各有 a、b 构图变体；要点行按关键词配线性图标，未命中则退回圆点；字号随内容长度自适应。
- 同一模板 + 同一配色 + 同一文案 → 图片一致；改文案只改文字，不改版式。
- 篇间强调色、封面构图由标题哈希决定，非随机数。
- 页面角色：封面 → 要点卡 → 金句页 → 尾页（CTA + 标签）。
- 尺寸 1080×1440（小红书 3:4 竖版），导出 2 倍清晰度。
可选配色：米白朱红、暖纸棕、浅绿、深色金。色相范围：narrow（同族轮换，默认）或 wide（跨色相）。内页要点卡每篇 2–6 张，另加封面、金句页、尾页。
产物与数据目录¶
每次运行数据落在：
$DSH_HOME/xhs-batch-studio/
├── runs/<运行编号>/ 资料、topics.json、notes.json、成品目录、index.xlsx
├── uploads/ 上传的原始资料
├── templates/writing/ 自定义写作模板
└── venv/ 插件自用 Python 环境
macOS 上 $DSH_HOME 默认为 ~/Library/Application Support/dsh-desktop/harness。卸载插件不会删除上述目录。
安装与启用¶
官方 README 给出的安装方式如下（二选一）：
dsh plugin --profile web add dsh-xhs-batch-studio # 已发 npm 时
dsh plugin --profile web add Nanfeng0108/dsh-xhs-batch-studio # 或直接用 GitHub 仓库
也可在 DSH Desktop 中：插件 → 添加插件，填写包名、GitHub 地址或本地目录。
装完后重启一次，左侧出现「小红书批量工作台」。第一次使用要点「准备环境」：创建独立 venv、安装 Python 依赖、下载 Chromium（约 150 MB），约一两分钟，之后不再需要。需要 Python 3.10+，本机 python3 可用。
打开方式：重启 DSH Desktop 后，展开左侧栏 → 点左上角「工作台」右侧的当前工作台名称 → 选择「小红书批量工作台」。
首次点「提炼选题」时，插件也会在后台准备 Python 环境与浏览器渲染器（约 1–2 分钟，有进度提示）。
典型用法与参数¶
按界面顺序操作即可复现 README 流程：
- 导入资料文件。
- 设置参数（见下表），点「提炼选题」，在选题清单中编辑并勾选。
- 选择写作模板与封面 / 内页版式、配色等，生成成品并下载或查看
runs目录与index.xlsx。
| 参数 | 说明 |
|---|---|
| 内容方向 | 可选，收敛选题 |
| 选题数量 | 一次提炼多少个选题 |
| 写作模板 | 文案结构与语气 |
| 封面 / 内页版式 | 图片排版 |
| 配色 | 米白朱红 / 暖纸棕 / 浅绿 / 深色金 |
| 色相范围 | narrow / wide |
| 内页张数 | 每篇要点卡 2–6 张 |
| 图上署名 | 可留空 |
仓库维护者可在本地用 tools/ 下脚本自测（不打进发布包）：
node tools/test-host.mjs env # 路由 + 环境 + 模板目录
node tools/test-host.mjs prepare # 准备 Python 环境
node tools/test-host.mjs all # 上传样例 → 提炼选题 → 生成两篇 → 校验图片/zip/xlsx
适用场景与注意¶
适合谁： 手头有一批结构化或非结构化资料，需要批量产出风格统一的小红书图文草稿（文案 + 固定版式图），并愿意在 DSH Desktop 里配置模型与一次性 Python/Chromium 环境。
权限与安全： 插件以当前 DSH 进程权限运行，会读写 $DSH_HOME/xhs-batch-studio、调用本机 Python 与 Chromium。安装前建议阅读仓库源码与 MIT 许可证，确认上传资料与模型 key 的使用方式符合你的环境策略。
生态说明： DSH 社区插件目录（如 SkillHub 上的条目）为独立站点，与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。
结尾¶
dsh-xhs-batch-studio 把「资料 → 选题清单 → 勾选 → 模板化文案与出图」收进 DSH Desktop 工作台：模型负责理解与写作，版式由 HTML 模板保证稳定。需要试用或查 issue 时，可看目录页与 GitHub：
- 目录页：https://www.skillhub.cn/plugins/Nanfeng0108/dsh-xhs-batch-studio
- GitHub：https://github.com/Nanfeng0108/dsh-xhs-batch-studio
