前言¶
在 DeepSeek Harness(DSH)里让模型按固定格式写实验报告、思想汇报或公文时,常见做法是每次在对话里粘贴模板、反复强调格式要求。长对话或上下文压缩之后,结构、编号和语气容易跑偏;换新会话又要从头说明。
Writing Style Learner 是 maintainer ygz77 发布的 DSH 插件(npm 包名 dsh-writing-style-learner,分类上常被归入模型推理类能力)。它从一段样例中提炼写作风格,保存为与工作区绑定的持久档案,并在每一步通过系统提示节(section)重新注入,使生成文字在长对话、压缩上下文和新会话中尽量保持一致。插件本身不内置任何文风,档案只在用户第一次保存时按需创建。
这是什么¶
一句话定位:一个可学习任意写作风格的 DeepSeek Harness 插件。
维护者与源码:ygz77,仓库 github.com/ygz77/dsh-writing-style-learner。社区目录页见 skillhub.cn/plugins/ygz77/dsh-writing-style-learner。DSH 生态以「一切皆插件」为思路;社区目录为独立站点,与 DeepSeek、幻方无官方从属关系。
核心功能¶
下面功能均来自插件 README 与 package.json 说明。
- 提炼风格:从用户提供的样例中抽取结构、文本风格、编号、表格、字体、格式、插图、规则、示例等维度;不适用的维度记为「无」。
- 固化档案:将风格存为可复用档案,不依赖单次对话上下文。
- 每步注入:通过
ctx.systemPrompt.section()注入系统提示,每一步重新渲染,减轻长对话、上下文压缩、新会话导致的风格丢失。 - 按需生成:插件包内无内置风格;
Writing-Style目录仅在第一次保存档案时创建。
模型侧可调用的工具包括:
| 工具 | 作用 |
|---|---|
save_writing_style |
保存并激活一个风格档案 |
show_writing_style |
查看当前激活的档案 |
list_writing_styles |
列出已保存档案 |
activate_writing_style |
切换激活档案 |
clear_writing_style |
删除档案 |
安装与启用¶
需要 DSH 版本满足 engines.dsh:>= 0.2.1-rc.5。
从本地插件目录安装时,将 <path-to-this-directory> 换为克隆或下载后的路径:
dsh plugin --profile <profile> add <path-to-this-directory>
从 GitHub 源码安装:
dsh plugin --profile <profile> add github:ygz77/dsh-writing-style-learner
将 <profile> 换为你实际使用的 DSH profile 名称。安装前建议阅读仓库源码与 MIT 许可证;插件在当前 dsh 进程权限下运行,与 DSH 加载的其他插件相同。
典型用法¶
在输入框使用斜杠命令,把 /writing-style 之后的内容(或附件)交给模型:
/writing-style <要学 / 要写的内容>
示例:
/writing-style 学习这篇思想汇报的写法,然后写一篇当前日期的思想汇报
流程上:命令将后缀内容交给模型;模型从内容中解析风格、调用 save_writing_style 保存,再按档案写作。README 说明没有单独的管理子命令,也无需提前手工建档案。用户也可在自然语言中说「学习 / 模仿 / 参照 / 按这个风格写」,由插件自动保存风格。
数据位置与配置¶
存储路径
- 有工作区:
<workspace>/Writing-Style/profiles.json,每个风格另存为<folder>/<name>.json。 - 无工作区:
$DSH_HOME/Writing-Style/。 - 卸载插件不会删除工作区内的
Writing-Style(数据在工作区,不在插件包内)。
示意目录结构:
Writing-Style/
├── profiles.json
└── 实验报告/
└── buaa-dl-lab.json
cordis.patch.yml 的 config
| 配置项 | 默认值 | 说明 |
|---|---|---|
sectionName |
writing-style |
系统提示 section 名 |
sectionOrder |
100 |
组装提示中的位置 |
maxProfileBytes |
24000 |
注入内容字节上限 |
dataDir |
Writing-Style |
档案目录(工作区优先,否则 $DSH_HOME) |
autoWriteJson |
false |
保存时是否额外写 JSON 副本 |
jsonFileName |
writing-style-profile.json |
额外副本文件名 |
适用场景与注意¶
适合需要反复产出同类文档的 DSH 用户:实验报告、思想汇报、作业、公文、邮件、文案等,只要有一段可参照的样例即可尝试沉淀档案。
注意点:
- 风格档案体积受
maxProfileBytes限制,极长模板可能被截断,需结合配置与样例长度评估。 - 提炼质量依赖模型对样例的理解,样例应结构清晰、代表性强。
- 敏感样例会进入工作区 JSON,注意工作区权限与备份策略。
结尾¶
Writing Style Learner 把「每次口头约束格式」换成「样例 → 档案 → 每步系统提示注入」,适合在 DSH 工作流里固定写作范式。进一步了解可看社区目录页 skillhub.cn/plugins/ygz77/dsh-writing-style-learner 与 GitHub 仓库 github.com/ygz77/dsh-writing-style-learner。当前 npm 版本为 1.0.0(见 package.json)。