前言¶
在 DeepSeek Harness(DSH)裏寫公衆號稿件時,常見做法是本地用 Markdown 編輯,再借助 doocs/md 等工具排版後粘貼進微信公衆號後臺。若每次都要切到瀏覽器或獨立站點,右側文件面板裏的 .md 只能看源碼或默認 Markdown 預覽,和公衆號編輯器裏的 inline 樣式對不上,複製粘貼還要再跑一遍排版流程。
下面介紹社區客戶端插件 dsh-wechat-md(維護者 sleepy-zone):在 DSH 右側文件面板爲 Markdown 增加 doocs/md 排版 預覽,一鍵把渲染結果以富文本(text/html + text/plain)寫入剪貼板,可直接貼進公衆號編輯器。樣式參考開源項目 doocs/md。插件在 SkillHub 目錄 歸類爲「客戶端」;源碼見 GitHub(MIT,當前 package 版本 1.2.0)。
這是什麼¶
dsh-wechat-md 是 DSH 的 bundle 型客戶端插件(包名 @local/wechat-md),只做「預覽 + 複製」,不修改文件、不增加對話入口。它通過 documentPreviews 註冊 id 爲 @local/wechat-md/file-preview 的查看器,與內置 Markdown 查看器並列:打開 .md / .markdown 時默認仍是內置 Markdown 查看器,下拉可選 doocs/md 排版;內置 Plain text 查看器仍可用。
核心功能¶
排版與主題¶
選擇 doocs/md 排版 後,當前 Markdown 按 doocs/md 風格渲染爲適合公衆號的 HTML 結構。查看器提供:
- 三套主題:經典、優雅、簡潔
- 五種強調色
- 正文字號 14–18px
上述偏好按瀏覽器持久保存。
一鍵複製富文本¶
工具欄上的複製按鈕把渲染後的文章寫入剪貼板(富 HTML + 純文本)。粘貼到微信公衆號編輯器時,inline 樣式會保留。
公衆號後臺會丟棄 <style> 塊和 class 選擇器,因此插件在渲染階段把規則「烤」進各元素的 style 屬性:標題、段落、引用、列表、表格、代碼、鏈接、圖片均帶 inline CSS;相對樣式在渲染前按主題解析,不依賴外鏈樣式表、web font、CDN 腳本或網絡請求。
Markdown 與元數據¶
- 解析器爲 vendored 的 marked v15(MIT),打包在
client.js中。 - Markdown 中的原始 HTML 會消毒:移除 script、frame、表單控件、
on*處理器及javascript:URL 等,再進入預覽或剪貼板。 - 文件開頭的 YAML frontmatter 視爲文檔元數據,不會出現在正文渲染結果中。
與內置查看器的關係¶
註冊優先級爲 builtin,因此 Markdown 仍爲默認,doocs/md 爲下拉選項。若希望 doocs/md 成爲默認,需在插件配置側使用 priority: 'extension'(見 README 說明)。
安裝與啓用¶
本倉庫是 DSH bundle:在工作區中取得源碼目錄後,通過 plugin_manager 的 install_bundle 安裝該包目錄。README 給出的獲取方式如下:
git clone https://github.com/sleepy-zone/dsh-wechat-md.git
安裝 bundle 後,下一次頁面啓動 時加載;若當前頁面仍顯示舊一代客戶端,需重啓應用或重新加載 Web UI 一次。
插件以當前 DSH 進程權限在客戶端運行;安裝前請自行閱讀源碼與 LICENSE、THIRD_PARTY_NOTICES.md(含 marked、doocs/md 等第三方許可)。SkillHub 爲社區目錄站點,與 DeepSeek / 幻方無官方從屬關係。
典型用法¶
- 在 DSH 右側文件面板打開工作區內的
.md或.markdown文件。 - 在查看器下拉菜單中選擇 doocs/md 排版(需要時可切換主題、強調色、字號)。
- 確認預覽內容與預期一致後,點擊複製按鈕。
- 打開微信公衆號圖文編輯器,粘貼;富文本 inline 樣式應隨粘貼保留。
相對路徑的本地圖片在側邊欄預覽中可通過鑑權文件路由顯示;複製出的 HTML 仍使用 Markdown 裏寫的 URL,相對路徑圖片在公衆號中需自行上傳後才能顯示;公網 HTTP(S) 圖片在粘貼後通常由微信側重新託管。
適用場景與已知限制¶
適合:已在 DSH 裏用 Markdown 寫稿、希望排版風格貼近 doocs/md、並減少「排版站點 ↔ 編輯器」來回切換的開發者或運營者。
不適合或需注意:
- 不支持 Mermaid、PlantUML、KaTeX、emoji、GFM alert 等擴展;代碼塊無語法高亮(完整 doocs/md 具備這些能力)。
- 預覽即剪貼板 payload,不是微信編輯器 iframe,無法在 DSH 內 1:1 復現微信端表格滾動等 quirks。
- 僅爲查看器,不提供文件編輯能力。
主題樣式改編自 doocs/md 的 WTFPL 主題;WeChat 佈局 UI 爲 DSH 專用實現。
結尾¶
dsh-wechat-md 把 doocs/md 式公衆號排版收進 DSH 右側文件面板:默認 Markdown 預覽不變,需要排版時切換 doocs/md 排版,複製後即可粘貼進公衆號後臺。
- 目錄頁:https://www.skillhub.cn/plugins/sleepy-zone/dsh-wechat-md
- GitHub:https://github.com/sleepy-zone/dsh-wechat-md