前言¶
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 是一套针对文档生成的结构化工具集,适合需要批量处理不同格式文本的开发者。安装前请确认本地环境版本,并根据需求选择对应的工具。