前言¶
DeepSeek Harness(DSH)採用插件化架構,強調在生成過程中引入具體的質量引導和審查工具。在長篇寫作任務中,模型容易產生風格漂移、角色一致性缺失或事實性錯誤。human-writing-skills 插件旨在解決這些問題,通過一套具體的規則和審計工具,將通用的生成行爲轉化爲符合特定文體和連貫性的輸出。
插件介紹¶
該插件是一個開源的高級多語言 AI 人機化工具包,專注於自然散文、聲音保留、長篇連續性和專注審計。它並非簡單的提示詞集合,而是包含兩層能力:
- 可執行 Python 工具:提供確定性的檢查和修復預覽。
- 模型執行編輯模塊:通過 Markdown 文件提供體裁和審查指令。
該插件不依賴額外的 Python 核心包安裝,且具備零依賴特性。
安裝與前置要求¶
安裝該插件需要 DeepSeek Harness 的 Web 配置文件。
- 安裝命令:
執行以下命令將插件添加到 DSH 配置中:
dsh plugin --profile web add https://github.com/whh110112/human-writing-skills/releases/download/dsh-v0.2.0/dsh-advanced-human-writing.tgz
- 前置要求:
- 需要安裝 Python 3.9 或更高版本。
- 需要安裝 Node.js,版本需滿足
^22.19.0 || >=24.0.0。
核心功能¶
插件提供以下具體能力:
- 寫作與編輯:支持自然重寫、AI 文本清理、小說編輯以及小說續寫。
- 風格與一致性審計:提供分塊長篇審計、寫作風格統一以及角色一致性審查。
- 事實與連貫性管理:包含自動提取連續性賬本(Ledger)的功能,用於整理現有章節中的事實、推斷和衝突。
- 質量控制:在生成時內置質量協議,防止重複修辭、裝飾性細節和不必要的解釋。
典型用法¶
插件提供了 human-writing-skills 命令行工具和 MCP 服務支持。
命令行操作¶
- 事實提取:從現有章節中提取連續性信息,生成供人類審覈的提示詞。
human-writing-skills extract-ledger --draft chapters-01-10.md --context novel-ledger.md --output ledger-extraction-prompt.md
- 代碼風格檢查:檢查草稿並輸出 GitHub Actions 格式的註釋。
human-writing-skills lint --draft - --style general --format github --source-name docs-change.md
- 構建生成提示詞:根據特定風格和任務構建提示詞。
human-writing-skills build --style self-media --task "Explain the supplied test results for buyers." --source test-notes.md
- 盲審比較:對比原文與修改稿,生成盲審目錄。
human-writing-skills compare-blind --original original.md --candidate revised.md --style self-media --brief writing-brief.md --output-dir blind-review
MCP 服務¶
對於長篇項目,可以使用 human-writing-mcp 服務進行本地協調,支持跨 Codex、Claude Code、OpenCode、DSH、Manus 和 Hermes 等代理的編排。
human-writing-mcp --root C:\writing-project
配置與注意事項¶
- 項目配置:在項目根目錄創建
.humanwriting.json文件,可持久化默認設置,如樣式、文檔類型、上下文路徑和審計白名單。該配置文件無法靜默激活深層配置或昂貴的引用檢查。
{
"style": "fiction",
"document_type": "fiction",
"context": "novel-ledger.md",
"allow": ["END001"]
}
- 運行權限:DSH 插件以當前 DSH 進程的權限運行,無獨立的系統級進程管理。
- 質量侷限:真實的寫作質量仍需獨立的流暢性審查員進行人工評估;單元測試不能證明文本的自然性。
- 適用場景:插件明確支持事實類的自媒體文章和議論文,並在重寫時保留原作的語態。
總結¶
human-writing-skills 插件通過 Python 工具和 Markdown 模塊的結合,爲 DeepSeek Harness 提供了一套從風格統一到事實審計的完整工作流。它不承諾通過算法欺騙模型,而是通過明確的指令和約束,提升生成文本的連貫性和可讀性。
- 倉庫地址:https://github.com/whh110112/human-writing-skills
- 許可證:MIT