dsh-content-studio
面向 DeepSeek Harness 的内容创作与多平台分发 bundle 插件。
English · dsh-plugin 主题
截屏、录屏、Markdown 渲染小红书图文、dev.to / Medium 发布、发布前人工审阅 —— 一次安装、十六个工具，告别每次现写脚本。
特性
- 🎨
content_text_to_image —— 文本生图（Nano Banana / Gemini 2.5 Flash Image，需 API key）：封面、背景图、插图一键生成
- 📸
content_screenshot —— macOS 桌面截屏（全屏 / 区域 / 延时）
- 🎬
content_screen_record —— ffmpeg AVFoundation 定时长 MP4 录屏，自动探测屏幕/麦克风设备，支持麦克风与裁切区域
- 🃏
content_md_to_cards —— Markdown → 小红书图文卡片（Chrome 无头渲染）：封面卡 + 按 H1/H2 分节成卡，1242×1660（3:4），5 套配色 × 4 种版式，支持  插图与带可读性遮罩的背景图
- 🌐
content_md_to_html —— 自包含排版 HTML，用于预览、CSDN、公众号粘贴
- 📤
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，浏览器浮动审阅面板（审阅 / 发布 / 设置 三个页签）实时预览卡片，用户可改文字、配色、版式与发布文案，然后批准或打回
- 🔌 Playwright MCP（
mcp__playwright__*）—— 网页截图、会话录屏、UI 自动化（系统 Chrome）
- 📕 xhs-mcp（
mcp__xhs__*）—— 小红书登录、图文/视频发布、搜索
安装
方式 A —— bundle 安装（推荐）
# 从 npm（推荐）
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 生效。本包在 package.json 中声明了 dsh.bundle.patch，安装后其 patch 成为 profile 激活层：宿主插件（全部工具）+ Playwright / 小红书 MCP 行。可与任意预设（standard、cordis 等）搭配，Settings → Plugins 面板可见。
方式 B —— 预设复制
rsync -a ~/Projects/dsh-content-studio/ ~/.dsh/.agent-presets/content-studio/
新开会话选「内容工作室」预设：standard 全量 + 插件行 + MCP 行 + 动态插件工具集（cordis_*）+ 工作流 Skill。
⚠️ 两种方式二选一。两者注册相同工具名，同时挂载会因重名冲突而失败。
工具
| 工具 | 能力 |
|---|
content_screenshot | 桌面截屏（macOS screencapture），区域/延时 |
content_screen_record | 定时长桌面 MP4 录屏（ffmpeg AVFoundation），可选麦克风与裁切 |
content_capture_devices | 列出 ffmpeg 可见的采集设备 |
content_md_to_cards | Markdown → XHS 卡片（Chrome 无头渲染，封面 + 分节成卡） |
content_text_to_image | 文本生图（Nano Banana），支持 1:1/3:4/4:3/9:16/16:9 |
content_md_to_html | Markdown → 排版 HTML（自包含） |
content_publish_devto | dev.to API 发布 |
content_publish_medium | Medium API 发布 |
content_review_open / status / refresh / close | 发布前持久化人工审阅 |
mcp__playwright__* | 网页截图 / 录屏 / UI 自动化 |
mcp__xhs__* | 小红书登录 / 发布 / 搜索 |
卡片样式系统
两个独立维度 —— 配色 × 版式，外加照片插图与背景图：
- 配色（5 套）：
xhs-soft 奶油暖调 · xhs-dark 深夜暗调 · plain 简洁白底 · forest 森林墨绿 · sunset 落日暖橙
- 版式（4 种）：
classic 经典（左竖线标题）· magazine 杂志（衬线居中）· poster 大字报（超大标题、色块高亮）· notebook 手账（贴纸胶囊、横线底纹）
- 照片：Markdown 图片语法
，本地路径自动嵌入为 data URL
- 背景图：
bg_image（URL 或本地路径），带主题感半透明遮罩保证文字可读
- AI 生图：
content_text_to_image 生成封面/背景/插图（本地路径直接可用作 bg_image 或 ）
审阅工作流（人机双层协作）
实体层 + 双交互层：Agent 用工具创作，人类看图改稿：
content_md_to_cards 渲染卡片（PNG）
↓
content_review_open 草稿落盘；浏览器弹出审阅面板
↓ 用户看缩略图，改卡片 Markdown/配色/版式，
↓ 以及独立于图片文字的发布标题/正文
content_review_status
├─ edited → 用修改后的字段重渲染 → content_review_refresh → 再等一轮
├─ approved → 用面板的发布标题/正文发布 → content_review_close
└─ rejected → 读 humanNote，改稿后重开审阅
工具与草稿是静态持久的（重启不丢）。浏览器面板是动态插件 —— 客户端半需要 dsh.client 构建管线才能静态化（见 Roadmap）。面板模板在 plugins/content-review-panel/，任意会话 cordis_define + cordis_run 约 10 秒即可重建，草稿数据永不丢失。
平台矩阵
| 平台 | 通道 | 说明 |
|---|
| 小红书 XHS | mcp__xhs__* | 标题 ≤ 20 字、正文 ≤ 1000、1–18 图（3:4 最佳） |
| dev.to | content_publish_devto | 官方 API，≤ 4 tags |
| Medium | content_publish_medium | 官方 API，≤ 5 tags |
| 掘金 Juejin | 可选 mcp-juejin 行 / Playwright UI 自动化 | 需本地起 JueJin-MCP 服务 |
| CSDN / 公众号 | content_md_to_html 粘贴 | 无公开 API |
| V2EX | bash + token API | 宣传帖 |
环境要求
- macOS、ffmpeg（
brew install ffmpeg）、Google Chrome
- AI 生图需 Gemini API key（aistudio.google.com/apikey 创建，设
GEMINI_API_KEY 或调用时传 api_key）
- dev.to 发布需 API key（dev.to/settings/extensions 创建，设
DEVTO_API_KEY）
- 也可直接在审阅面板「③ API Keys」区配置（保存到
~/.dsh/content-studio-output/keys.json，仅显示已配置状态）
- 给运行 DSH 的终端授予「屏幕录制」权限
- 小红书一次性扫码登录（
mcp__xhs__xhs_auth_login）；dev.to API key 设 DEVTO_API_KEY
跨机器注意
cordis.patch.yml 把 xhs-mcp 固定在作者的 Chrome 二进制上（PUPPETEER_EXECUTABLE_PATH）。换机器时要么改成目标机器的路径，要么删掉这个环境变量并执行一次 npx xhs-mcp browser 让它自下载 Chromium。- 桌面截屏/录屏（
content_screenshot / content_screen_record）目前仅 macOS（screencapture / AVFoundation）；Linux/Windows 适配在路线图上。
- 审阅草稿在
~/.dsh/content-studio-output/ 下；卡片渲染需要本机 Chrome（或 CHROME_PATH 指向 Chromium 内核浏览器）。
仓库结构
├── package.json # dsh.bundle.patch 声明
├── cordis.patch.yml # bundle 层：宿主行 + MCP 行
├── preset.yml # 方式 B 的显示元数据
├── agent.cordis.yml # 方式 B 的预设组合
├── src/index.js # 宿主插件 —— 注册全部 16 个工具（内容工作室 + 审阅 + cordis 动态插件）
├── src/lib/ # screenshot / record / cards / template / devto / util / review
├── vendor/marked.umd.cjs # vendored Markdown 解析器（零运行时依赖）
├── plugins/content-review-panel/ # 审阅面板动态插件模板
├── scripts/verify-panel.sh # 审阅面板四层验证门
└── skills/xhs-content-studio/ # 端到端工作流 Skill
运维与验证
审阅面板跨四个持久化层：profile 组合树（宿主行）→ boot 图（dsh.client 浏览器 bundle）→ 面板 API 路由 → 磁盘草稿。任何一层断裂都会表现为"面板不见了"。断言面板可用之前必须先跑验证门：
DSH_DEPLOY=/path/to/dsh ./scripts/verify-panel.sh
五层全 PASS 才允许声称面板可见；有 FAIL 时按脚本提示修复并重启 DSH 后重跑。已知的两个启动竞态（webServer / dynamicCordisRunner 晚于本插件挂载）已用 ctx.interval 轮询兜底，路由与工具会等 service 就位后自动注册。
Roadmap
License
MIT
