前言¶
在 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 检查行为是否漂移。对于需要长期维护角色的长篇写作，这是一套比较具体的检查流程。
相关入口：
