前言¶

在 DSH 里做内容生产，常见链路不止“生成一段 Markdown”。还需要截图、录屏、把 Markdown 渲染成小红书图文卡片、生成自包含 HTML 用于 CSDN / 公众号粘贴，再调用 dev.to / Medium API 发布。这些步骤分散在不同脚本、浏览器路径和权限里时，容易出现工具缺失、环境不一致、发布前缺少人工确认的问题。

dsh-content-studio 是面向 DeepSeek Harness（DSH）的内容创作与多平台分发 bundle 插件。DSH 生态强调插件化组合，社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系；本文只介绍该插件本身。

这是什么¶

dsh-content-studio 的一句话定位是：面向 DeepSeek Harness（DSH）的内容创作与多平台分发 bundle 插件。

仓库地址为 https://github.com/ZRui-C/dsh-content-studio。仓库路径中的 ZRui-C 可作为 GitHub 仓库账号识别；已核实资料未单独确认“维护者”字段，本文不据此推断维护状态。

它把以下内容放在同一插件中：

• 素材生成：文本生图、macOS 桌面截屏、定时长 MP4 录屏。
• 内容渲染：Markdown 转小红书图文卡片、自包含排版 HTML。
• 内容发布：dev.to / Medium 官方 API 发布。
• 人工确认：草稿落盘、浏览器浮动审阅面板、批准或打回。
• 外部能力挂载：Playwright MCP、xhs-mcp。

核心功能¶

下面按能力类型说明。

文本生图¶

content_text_to_image 支持文本生图，使用 Nano Banana / Gemini 2.5 Flash Image，需要 API key。可用于生成封面、背景图、插图。

桌面截屏与录屏¶

• content_screenshot：macOS 桌面截屏，支持全屏、区域、延时。
• content_screen_record：使用 ffmpeg AVFoundation 进行定时长 MP4 录屏，自动探测屏幕 / 麦克风设备，支持麦克风与裁切区域。

Markdown 转小红书卡片¶

content_md_to_cards 将 Markdown 渲染为小红书图文卡片，使用 Chrome 无头渲染。

核心规格：

• 封面卡 + 按 H1/H2 分节成卡。
• 卡片尺寸：1242×1660（3:4）。
• 5 套配色 × 4 种版式。
• 支持 ![描述](路径) 插图。
• 支持带可读性遮罩的背景图。

自包含排版 HTML¶

content_md_to_html 生成自包含排版 HTML，可用于预览、CSDN 粘贴、公众号粘贴。

dev.to / Medium 发布¶

• content_publish_devto：dev.to（Forem）官方 API 发布，支持草稿 / 直发。
• content_publish_medium：Medium 官方 API 发布，支持草稿 / 直发。

人工审阅闸门¶

content_review_open / status / refresh / close 提供持久化的人工审阅流程：

• 草稿落盘到 ~/.dsh/content-studio-output/review/draft.json。
• 浏览器浮动审阅面板提供“审阅 / 发布 / 设置”三个页签。
• 面板可实时预览卡片。
• 用户可修改文字、配色、版式与发布文案。
• 用户可以选择批准或打回。

外部 MCP 能力¶

• Playwright MCP（mcp__playwright__*）：网页截图、会话录屏、UI 自动化，使用系统 Chrome。
• xhs-mcp（mcp__xhs__*）：小红书登录、图文 / 视频发布、搜索。

安装与启用¶

先确认本机满足运行要求，再选择安装方式。两种方式二选一；两者注册相同工具名，同时挂载会因重名冲突而失败。

环境要求¶

建议先检查以下项：

• macOS。
• ffmpeg：brew install ffmpeg。
• Google Chrome。
• AI 生图需要 GEMINI_API_KEY。
• dev.to 发布需要 DEVTO_API_KEY。
• 给运行 DSH 的终端授予“屏幕录制”权限。
• 小红书需要一次性扫码登录：mcp__xhs__xhs_auth_login。

如果需要 AI 生图，先到 https://aistudio.google.com/apikey 创建 Gemini API key，然后设置 GEMINI_API_KEY，或在调用时传 api_key。

如果需要发布 dev.to，先到 dev.to/settings/extensions 创建 API key，然后设置 DEVTO_API_KEY。

也可以不直接设置环境变量，而是在审阅面板的“③ API Keys”区配置。配置会保存到 ~/.dsh/content-studio-output/keys.json，面板仅显示已配置状态。

bundle 安装（推荐）¶

bundle 安装是把插件安装到 DSH 的 web profile。下面是推荐命令：

dsh plugin --profile web add dsh-content-studio

如果要从 GitHub 指定分支安装，可用：

dsh plugin --profile web add "github:ZRui-C/dsh-content-studio#main"

开发本机路径时，可用：

dsh plugin --profile web add ~/Projects/dsh-content-studio

安装后重启 DSH 生效。

预设复制安装¶

预设复制安装是把本地仓库复制到 DSH 预设目录，然后在新会话中选择该预设。先确认本地已有仓库副本，再执行：

rsync -a ~/Projects/dsh-content-studio/ ~/.dsh/.agent-presets/content-studio/

完成后，新开会话选择“内容工作室”预设。

典型用法¶

下面介绍几个可复现的使用路径。

渲染卡片并进入审阅¶

先准备一份 Markdown 草稿。下面是审阅工作流的主要顺序：

1. content_md_to_cards 渲染卡片（PNG）。
2. content_review_open 将草稿落盘，并弹出浏览器审阅面板。
3. 根据 content_review_status 的状态处理：
   - edited：用修改后的字段重渲染，再调用 content_review_refresh。
   - approved：用面板中的发布文案发布，再调用 content_review_close。
   - rejected：按面板反馈修改后重开审阅。

经过上面的步骤，可以完成“渲染卡片 — 人工确认 — 发布 / 打回”的闭环。

卡片样式¶

卡片样式由两个独立维度组成：配色和版式。

配色共 5 套：

• xhs-soft
• xhs-dark
• plain
• forest
• sunset

版式共 4 种：

• classic
• magazine
• poster
• notebook

图片与背景图支持：

• Markdown 图片语法：![描述](路径/URL)。
• 背景图：bg_image，可为 URL 或本地路径，并带主题感半透明遮罩以保证文字可读。
• AI 生图：content_text_to_image 可生成封面、背景图或插图；生成后的本地路径可用作 bg_image，也可用于 Markdown 图片语法。

发布通道¶

不同平台使用的通道和限制如下。

验证审阅面板¶

如果准备对外说明“审阅面板可见”，先运行验证门。下面的脚本用于检查审阅面板相关链路：

DSH_DEPLOY=/path/to/dsh ./scripts/verify-panel.sh

五层全 PASS 才允许声称面板可见；有 FAIL 时按脚本提示修复，并重启 DSH 后重跑。

跨机器注意¶

换机器或换环境时，重点检查以下项：

• cordis.patch.yml 会把 xhs-mcp 固定在作者的 Chrome 二进制上（PUPPETEER_EXECUTABLE_PATH）。换机器时要么改成目标机器路径，要么删掉该环境变量并执行 npx xhs-mcp browser 自下载 Chromium。
• 桌面截屏 / 录屏目前仅 macOS，依赖 screencapture / AVFoundation；Linux / Windows 适配在路线图上。
• 审阅草稿位于 ~/.dsh/content-studio-output/。
• 卡片渲染需要本机 Chrome，或用 CHROME_PATH 指向 Chromium 内核浏览器。

适用场景与注意¶

适合以下使用者：

• 在 macOS 上运行 DSH，需要把 Markdown 转成小红书图文卡片。
• 需要同时准备 dev.to / Medium 发布文案。
• 需要在发布前进行人工审阅。
• 希望把截图、录屏、卡片渲染、HTML 生成和发布工具集中管理。

使用前务必注意：

• 插件以当前 dsh 进程权限运行；安装前应检查源码与 MIT 许可证。
• 文本生图需要 GEMINI_API_KEY 或调用时传入 api_key。
• dev.to 发布需要 DEVTO_API_KEY。
• 桌面截屏 / 录屏需要运行 DSH 的终端具备“屏幕录制”权限。
• 小红书需要一次性扫码登录：mcp__xhs__xhs_auth_login。
• 审阅面板可用性以验证门结果为准。
• 小红书、dev.to、Medium 等平台限制需要在发布前检查。

参考链接¶

• GitHub：https://github.com/ZRui-C/dsh-content-studio
• 目录页：本次已核实资料未确认目录页 URL；可按插件名 dsh-content-studio 在 DSH 插件目录检索。