前言¶

在 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 插件目錄檢索。