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