NSFW 写卡助手 yuailuoxi-arch/dsh-nsfw-cardwriter

dsh-nsfw-cardwriter

DeepSeek Harness 的 NSFW 写卡插件：固定注入写卡规范，按来源预设 / 模型切换破甲片段。

简介

在 DSH 里做 NSFW 角色卡，通常会卡在三件事上：提示词靠 Skill 触发、不稳定；写卡工程要求「只输出 JSON」和破甲要求「每次输出 」互相打架；手上有好几套不同作者的破甲预设，不知道哪条来自哪里、该开哪个。

这个插件把它们分别处理掉。

固定层是每次请求都注入的写卡规范，用 ctx.systemPrompt.section() 注册 ——这是注册式注入，不依赖模型是否主动加载某个 Skill，也不靠模型自觉。
它内置任务分流规则：识别到写卡、改 JSON/YAML、改代码这类工程任务时，固定层优先，片段里「每次输出 / 」之类的要求一律不执行；只有明确要求写 NSFW 正文时，片段格式才生效。工程与创作互不污染。

片段层是可切换的破甲内容。每个片段带完整的来源标注 ——原作者、来源预设、原条目名 —— 管理页按来源分组展示，切哪个、开不开由你决定。
切换和编辑立即生效，不用重启。

自带的 Web 管理页可以完成全部操作：总开关、按来源浏览、启用、编辑、删除、导入自己的 .md / .txt 文件、编辑固定层。

⚠️ 本插件面向成年虚构创作。使用者需自行确认所在地区法律与所用服务条款。

它怎么解决

| 问题 | 做法 |
| 提示词不稳 | 用 systemPrompt.section() 固定注入，不依赖模型触发 |
| 多层冲突 | 固定层写死任务分流规则：工程任务固定层优先，创作任务片段生效 |
| 来源混乱 | 每个片段在 frontmatter 记录 source / author / preset / origin，管理页按来源分组显示 |

安装

cd "$DSH_HOME/profiles/web" # 默认 ~/.dsh/profiles/web
dsh plugin --profile web add link:/path/to/dsh-nsfw-cardwriter

然后重启 DSH Web。DSH profile 的 patchReload 默认是 startup，插件在启动时装配。

首次启动会自动创建数据目录并写入内置固定层与默认片段。

同步内置片段

仓库里的 presets/ 是源，运行时目录是副本：

node tools/sync-presets.mjs # 预演
node tools/sync-presets.mjs --write # 写入

--prune 会清理「已从源移除且带 managed: true」的片段，不会动你自己新建或导入的片段。

使用

打开管理页：

http://127.0.0.1:3080/nsfw-cardwriter

页面里可以：

- 总开关：关闭后完全不注入
- 按来源分组查看片段，每组显示原作者与预设名
- 启用 / 编辑 / 删除片段
- 导入 .md / .txt 文件
- 编辑固定层（写卡规范）

命令行切换

curl -s -X POST http://127.0.0.1:3080/nsfw-cardwriter/api \
-H 'content-type: application/json' \
-d '{"action":"switch","slug":"izumi-01-破甲1"}'

数据位置

$DSH_HOME/nsfw-cardwriter/
├── state.json 开关与当前生效片段 ├── base.md 固定层（写卡规范） └── fragments/.md 片段

直接改文件也有效 —— 插件在每次进入步骤前重读一次。

片段格式

name: izumi-01-破甲1 label: 破甲1 source: izumi # 分组键 author: 泉此方 # 原作者（管理页显示） preset: Izumi 0923 # 来源预设名 origin: 😤破甲1（基米别开！！！） # 原条目名 role: system # 原注入角色

（破甲正文）

只有 name 是必需的；其余字段缺失时管理页会退化显示。

内置片段来源

本仓库 presets/ 下的片段提取自以下第三方预设，版权归原作者所有：

| 目录 | 原作者 | 来源预设 |
| presets/izumi/ | 泉此方 | Izumi 0923 |
| presets/harukireset-39/ | harukireset | 夏瑾 天琴座 Beta 3.9 |
| presets/harukireset-v2/ | harukireset | 夏瑾 天琴座 V2 Beta 1.0-1 |
| presets/bolt072/ | bolt072 | v0.7.2 |
| presets/builtin/ | 本插件 | 内置通用默认 |

提取范围仅限破甲 / 破限相关条目，不含文风、思维链正文、世界书、正则等其余内容。
提取脚本见 tools/extract-presets.py，每个片段的 frontmatter 都记录了原条目名以便追溯。

提取时的技术处理

DSH 预设注入层没有宏系统，所以原预设里的 {{setvar::x::…}} / {{getvar::x}}
在提取阶段就就地展开成静态文本。例如：

原条目：{{trim}}{{getvar::JailbreakPrompt}}
产物： （JailbreakPrompt 的实际正文）

这保证片段可直接注入，不会把花括号原样发给模型。

关于「基米」

「基米」是 Gemini 的代称。Izumi 预设里有两条明确标注 😤破甲1（基米别开！！！） / 😤破甲2（基米别开！！！），意思是 Gemini 不要开这两条。片段保留了原始标注，是否启用由使用者决定。

⚠️ 与其他插件的冲突

complete: true 会丢弃本插件的注入 @deepseek-ai/dsh-system-prompt 的规则是：若存在 complete: true 的段落，组装后只有那一段生效，其他段落全部丢弃。

dsh-preset-enhance 生成的 st-preset 正好用了 complete: true，所以在「预设模式」会话里本插件不会注入。检查与修复：

node tools/patch-complete.mjs status
node tools/patch-complete.mjs off --write

用标准模式等其他模式则不受影响。

与 dsh-preset-enhance 同时启用

两者都会往请求里塞提示词。建议只保留一层。如果仍要用它，可以只关闭它的自动注入而不删数据：

node tools/preset-enhance-toggle.mjs off
node tools/preset-enhance-toggle.mjs on # 恢复

自检

node tests/selfcheck.mjs # 核心逻辑
node tests/smoke.mjs # 插件加载与 HTTP 接口
node tests/e2e-inject.mjs # 真实 SystemPrompt 组装（需能解析 @deepseek-ai/）

边界

片段是提示词层内容，只能影响模型如何理解任务。它不能：

- 改变 DSH 的工具权限、文件策略或系统规则
- 绕过真实世界安全要求或设备策略
- 保证模型一定服从
- 替代 SillyTavern 侧的真正预设注入

许可

本插件代码（lib/、web/、tools/、tests/）以 MIT 发布，见 LICENSE。

presets/ 下的片段不属于 MIT 范围，版权归各自原作者，见 THIRD_PARTY_NOTICES.md。