前言¶
DeepSeek Harness (DSH) 的核心價值在於插件化擴展。在使用大模型生成文檔時,開發者往往需要花費大量精力去定義結構、格式和段落順序,而不僅僅是撰寫內容。mario03690/dsh-writer 旨在解決這一痛點,它提供了一組預定義的工具,讓模型專注於內容的生成,而工具本身負責提供文檔的格式約束和結構規範。
插件說明¶
該插件由 mario03690 維護,基於 MIT 許可證開源。它包含 15 個專門針對不同文檔類型的長文生成工具,支持博客、新聞稿、產品描述、求職信等多種場景。插件不包含本地執行代碼,僅通過配置層調用遠程服務。
核心功能¶
插件提供以下 15 個工具,覆蓋了從創意生成到文檔潤色的全過程:
- what_can_you_do:描述任務的自然語言指令,系統返回能執行該任務的工具列表及調用方式。
- polish_academic:學術英語潤色,將粗略草稿轉化爲出版級文稿。
- make_blog_post:根據主題和關鍵點生成結構完整的博客文章。
- seo_pack:生成 SEO 包文件,包含標題標籤、元描述、OG 標籤及關鍵詞建議。
- make_press_release:根據事實信息生成標準的新聞稿。
- make_product_description:根據產品信息生成電商產品描述。
- make_job_description:根據職位和需求生成職位描述。
- make_faq:根據描述生成包含 10 個問答的常見問題頁面。
- make_email_template:生成響應式 HTML 郵件模板。
- make_readme:根據項目描述生成完整的 README.md。
- make_changelog:根據提交記錄生成 Keep-a-Changelog 格式的更新日誌。
- meeting_minutes:根據會議紀要生成結構化的會議記錄。
- make_weekly_report:根據工作要點生成周報。
- make_cover_letter:根據職位描述和個人背景生成求職信。
- name_ideas:根據產品描述生成名稱創意及域名建議。
安裝與啓用¶
使用以下命令將插件添加到指定的 DSH 配置文件中:
dsh plugin --profile <your-profile> add github:mario03690/dsh-writer
使用示例¶
- 查找工具:用自然語言描述需求,系統會自動匹配最合適的工具。
- 輸入:”我想寫一篇關於機器學習入門的博客文章”
- 輸出:系統返回
make_blog_post工具及其參數要求。
- 生成博客:提供主題、關鍵點和語氣。
- 輸入:
topic=”機器學習入門”,points=[“監督學習”, “神經網絡基礎”],tone=”輕鬆” - 輸出:Markdown 格式的博客文章。
- 輸入:
- 生成變更日誌:直接輸入原始提交記錄。
- 輸入:
commits=[“fix: login bug”, “feat: add dark mode”] - 輸出:按 Added/Changed/Fixed 分組的 CHANGELOG 條目。
- 輸入:
權限與限制¶
- 運行環境:要求 DSH 版本爲
v0.1 developer preview (Cordis v4)。 - 本地權限:插件不包含任何本地工具代碼,不進行構建步驟,不涉及生命週期腳本。無文件系統或 Shell 訪問權限。
- 網絡訪問:僅允許出站 HTTPS 連接至
ainetcafe.com。 - 數據隱私:免費層無需提供憑證。文檔僅在內存中處理,不會被持久化存儲。
- 依賴項:依賴
@deepseek-ai/dsh-mcp-client。 - 計費:每次調用均會產生費用,價格在 $0.015 至 $0.03 之間,失敗調用不計費。
總結¶
mario03690/dsh-writer 是一套針對文檔生成的結構化工具集,適合需要批量處理不同格式文本的開發者。安裝前請確認本地環境版本,並根據需求選擇對應的工具。