前言¶
在 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）。
