前言¶
在 DSH 寫作場景裏，長篇小說常見的問題不是單句生成，而是角色一致性：人物卡里寫了動機、口癖和底線，但正文寫到後期仍可能行爲漂移；角色出場多少、誰該退場，也常缺少統計依據。
下面介紹一個 DSH 寫作插件：dsh-character-profiler。它圍繞角色側寫、出場權重、行爲偏離三類任務，給出一套可檢查的檔案與統計。DSH 的插件生態強調“一切皆插件”；社區目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係，因此安裝插件時仍建議按第三方組件審查。
這是什麼¶
dsh-character-profiler 是 DSH 寫作插件，定位是長篇小說人物一致性的量化監控。倉庫地址爲 https://github.com/MlittleFriend/dsh-character-profiler，許可證爲 MIT。
它主要解決三類問題：
- 角色性格缺少持續可用的側寫檔案。
- 角色出場次數、段落分佈和佔比缺少統計。
- 正文中的角色行爲是否偏離設定，缺少可檢查的依據。
核心功能¶
| 工具 | 作用 | 消耗 |
|---|---|---|
novel_profile |
爲角色生成/更新性格側寫檔案，包括五維性格、動機、恐懼、價值觀、說話風格、行爲習慣、情緒觸發點、弱點、當前成長弧、一致性紅線，並收集全名/別稱 | LLM，深模型可選 |
novel_appearance |
統計每個角色的出場權重與佔比，包括提及次數、段落數、對話段數、章節分佈、權重分、佔比排行與主角/配角檔位，並提示正文中出現但未建檔的疑似角色 | 純本地，0 API |
novel_deviation |
檢測角色在正文中的行爲與側寫的偏離程度，包括偏離指數 0~100、偏離點清單，並區分無鋪墊的 OOC 突變與有因果鋪墊的合理性格發展 | LLM |
novel_profiler_status |
提供角色一致性總覽，包括人物卡與側寫檔案對照、出場權重、未建檔角色、建議動作 | 純本地 |
工作機制¶
側寫檔案會寫入項目的：
lore/profiles/<角色key>.md
該目錄位於 lore/ 下，會被寫作引擎自動注入後續寫作上下文。也就是說，正文寫作時模型可以持續看到角色側寫檔案，而不是隻依賴一次性的設定說明。
出場統計會從人物卡標題自動推導簡稱；生成側寫後，還會合並 LLM 提取的別稱。
偏離檢測默認對照側寫檔案；沒有檔案時退化爲對照人物卡，並建議先跑 novel_profile。
沒建人物卡的角色不會被統計/檢測，novel_appearance 會提示補卡。
安裝與啓用¶
安裝前需要滿足：
node >=22.5.0
並聲明以下 peerDependencies：
@deepseek-ai/cordis ^4.0.1
@deepseek-ai/dsh-tools ^0.1.0-rc.6
@deepseek-ai/schemastery ^3.18.1
dsh-tool-writing >=0.5.1
使用 DSH 插件命令安裝到 web profile：
dsh plugin --profile web add github:MlittleFriend/dsh-character-profiler
安裝腳本會把安裝包放到：
~/.dsh/profiles/web
並會把插件加入 bundles，在 profile 的 cordis.patch.yml 登記插件行。
API 配置由插件在運行時自動繼承 dsh-tool-writing 行的配置；key 只存在一處（tool-writing 的 patch 配置或環境變量），無需複製。
插件以當前 dsh 進程權限運行。安裝前建議檢查源碼與許可證；本插件許可證爲 MIT。
典型用法¶
下面是一套從建檔到檢查的流程：
- 每捲開頭：運行
novel_profiler_status，看誰沒側寫、誰佔比異常。 - 新角色：運行
novel_profile，建側寫檔案。 - 例行檢查：運行
novel_appearance，看出場權重/佔比是否失衡。 - 寫完幾章：運行
novel_deviation，查行爲是否漂移。 - 弧光變化：運行
novel_profile，更新側寫；舊檔案會被覆蓋。
也可以在本地直接驅動引擎驗證：
node test-local.mjs --stats --root "項目目錄"
node test-local.mjs --profile <角色key> --root "項目目錄"
node test-local.mjs --deviation <角色key> --root "項目目錄"
這些命令分別用於查看統計、生成/更新側寫、檢測角色行爲偏離。
適用場景與注意¶
適合：
- 長篇小說、多角色寫作。
- 已經有人物卡，但缺少持續側寫檔案。
- 需要統計角色出場權重、佔比和章節分佈。
- 需要檢查正文中的角色行爲是否偏離設定。
注意：
novel_profile和novel_deviation消耗 LLM；novel_profile深模型可選。novel_appearance和novel_profiler_status爲純本地、0 API。- 沒建人物卡的角色不會被統計/檢測，
novel_appearance會提示補卡。 - 沒有側寫檔案時，偏離檢測會退化爲對照人物卡，並建議先跑
novel_profile。 novel_profile更新側寫時，舊檔案會被覆蓋。- 插件運行在當前 dsh 進程權限內，安裝前應檢查源碼與許可證。
- DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不應把目錄頁理解爲官方應用商店。
結尾¶
dsh-character-profiler 把角色一致性拆成側寫、統計、檢測三類可執行任務：先用 novel_profile 建角色檔案，再用 novel_appearance 看出場權重，最後用 novel_deviation 檢查行爲是否漂移。對於需要長期維護角色的長篇寫作，這是一套比較具體的檢查流程。
相關入口：
