前言¶
做 RP 卡往往要同时写主提示词、档案页、聊天样式，还要对齐目标平台的 JSON 字段。手工在编辑器里拆文件、自己对照导出格式，改一轮就要在平台和本地之间来回粘贴。DeepSeek Harness（DSH）支持用插件把这类流程收进对话与工作区；社区插件目录在 SkillHub，与 DeepSeek / 幻方无官方从属关系。
下面介绍维护者 chunbo824-tech 的 dsh-rp-card（GitHub：chunbo824-tech/dsh-rp-card，目录页：SkillHub 条目）。它把「一句话想法」收成四段流水线，每段人工在平台验证后再继续，最后组装成面向 fengyue.ai（风月） 的导入 JSON。插件当前版本 1.6.3，许可证 MIT；安装与运行与当前 DSH 进程权限一致，安装前建议自行查看仓库源码与许可证。
这是什么¶
dsh-rp-card 是 DSH 上的 RP 卡创作插件：基于对话与斜杠命令，按固定四部分产出 Markdown / HTML / CSS 与分步 JSON，并在世界书规则层做校验，再一键合并为平台可用的 card.json。默认导出结构按风月平台实测字段适配；其他平台未内置映射。
插件面向 18 岁以上用户，用于创作虚构的成人向角色扮演内容；插件本身不附带成人素材，内容由用户与模型在本地生成。使用前请自行确认所在地法规与目标平台规则。
核心功能¶
四部分流水线与产物¶
| 部分 | 主要产物 | 对应平台字段 | 说明 |
|---|---|---|---|
| 1 写卡正文 | 01-writing.md、part-1-writing.json |
name、pre_prompt、ptx、post_text、opening_statement、lore_bk |
主提示词、前缀后缀、世界书 |
| 2 初始化档案页 | 02-profile.html、part-2-description.json |
desc |
玩家填资料、生成开场 |
| 3 聊天页 | 03-chat.css、part-3-chat.json |
built_in_css、rgx_rep |
消息样式与正则替换 |
| 4 变量面板（可选） | 04-variables.md、part-4-variable.json |
ai_variable_tmpl、ai_v_prompt、ai_v_json、extend |
地图、商店、状态卡等 |
前三部分完成即为可玩版本；第四部分可选。每部分交付后会生成 part-N-*.v2.json（仅本段字段，便于单段导入验证）以及累计的 card.json。风月平台导入为整卡覆盖：单测某段用 part 文件，恢复整卡用 card.json。
人工门禁与 PASS¶
每部分生成后流程会暂停，待在目标平台实测。确认无误后回复例如「第 1 部分 PASS」；仅说「继续」不算通过。PASS 与当时文件摘要绑定，手动改产物后需重新验证。第三部分通过后还有一次分支：组装可玩版本、全面评估，或继续做变量面板。
需求含糊时，插件会先复述理解、列出最多三条结构缺口，并给出 2–3 个方向供选择，方案写入 00-design-<部分>.md，确认后再实现。
世界书规则层¶
世界书承担运行规则、路由与按需知识。插件交付时会检查常驻锚词、路由兜底、控制词成对等（WB101–WB113）；无标签旁车文件时检查自动跳过。创作规范随插件装在安装目录的 docs/。
图像能力（第二部分）¶
档案页常需配图。插件内置 Seedream 5.0 flash（火山方舟）与 recraft V4.1 的地址与参数，用户只需配置 API Key；也可选「不接入图像模型」，用 CSS / 内联 SVG 完成前端。密钥写入 ~/.dsh/.credentials.yaml 的 refs 段（写入前自动备份），或使用环境变量 IMAGE_GEN_PROVIDER_API_KEY、RECRAFT_API_KEY。图像模式记在同文件的 RP_CARD_IMAGE_MODE。
装配与报告¶
按目标平台约 40 键结构组装，输出 card.json 与 build-report.md（含验证状态与已知限制）。bg_img / mobile_bg 不由插件生成，需在平台导入后自行设置。
装好后可用对话工具 card_build、斜杠命令 /card-build，以及在「设置 → 插件 → 图像能力」中配置图像。
安装与启用¶
npm 安装（README 推荐）：
dsh plugin --profile desktop add dsh-rp-card
跟踪 GitHub 最新提交时：
dsh plugin --profile desktop add github:chunbo824-tech/dsh-rp-card
本地路径安装：
dsh plugin --profile desktop add /绝对路径/dsh-rp-card
安装完成后需完全退出 DSH 再启动（不是只关窗口），插件才会加载。更新由 DSH 插件管理器处理；若无更新入口，可卸载后按上述命令重装。卡片与 .card-build 状态在用户选定的工作区，不在插件目录内。运行时要求 Node >= 22.19（见 package.json 的 engines）。
典型用法¶
- 新建空目录作为作品目录，用 DSH 打开。
- 用自然语言描述想法，例如：
做一个雨夜咖啡馆的日常恋爱卡，玩家是新来的常客，店主是个话不多的女人。
- 需求清晰则直接开工；否则先选方向。
- 阅读第一部分方案，回复「按这个做」后生成，并按提示到风月平台粘贴验证。
- 试玩通过后回复「第 1 部分 PASS」，依次完成二、三、四部分。
- 导入最终的
card.json。
常用斜杠命令（参数多数可省略，作品目录默认为当前工作区，平台默认 fengyue.ai）：
/card-build start --design clear|brainstorm
/card-build status
/card-build pass --part writing
/card-build fail --part writing --feedback "哪里不对"
/card-build assemble
完整子命令列表见 GitHub README。
适用场景与注意¶
适合谁：已在用 DSH、计划在 fengyue.ai 发布 RP 卡、愿意分阶段在平台实测的创作者。SkillHub 分类为「趣味换装」，与流水线式「写卡 + 前端 + 变量」的创作形态相关，但本质仍是 RP 卡组装工具，而非单纯换皮资源包。
注意：
- 插件只在生成图像时请求火山方舟与 Recraft；作品内容不上传（见 README「数据与隐私」）。
- 换平台需自行改字段映射，当前未内置其他平台适配。
- 中途修改已 PASS 的部分会使该段 PASS 失效，下游标记过期并需重验。
- 无图像密钥时可选纯代码前端，功能路径不受影响。
结尾¶
dsh-rp-card 把 RP 卡拆成可验证的四段，把世界书校验和风月 JSON 组装收进 DSH 工作流，适合「先想清楚、再在平台逐段过关」的做卡方式。
- 目录页：https://www.skillhub.cn/plugins/chunbo824-tech/dsh-rp-card
- 源码与文档：https://github.com/chunbo824-tech/dsh-rp-card
