character-card-v3-generator

Character Card V3 生成器

概述

生成符合规范且适用于角色扮演的高质量 Character Card V3 JSON 输出。构建角色卡和知识库，明确行为锚点、实用的激活逻辑，并确保聊天表现可预测。

工作流

1. 明确需求。

• 了解类型、语气、硬性边界、与 {{user}} 的关系、聊天风格（简短/详细）以及期望的行为约束。
• 询问输出应使用精简、标准还是高级模板。
• 如果用户没有选择，默认使用 standard。

2. 构建 CCv3 骨架。

• 对于新角色卡，从 assets/templates/ 开始，优先填写必填字段。
• 对于转换或升级，先加载现有角色卡，再以最小差异将其转换为 CCv3（保留现有意图/内容，除非与 CCv3 结构冲突）。
• 当角色卡结构不均衡时，应用 references/popular-card-patterns.md 中的规范化模式（字段重新平衡、触发词清理和知识库条目拆分）。
• 添加风格细节之前，先确保对架构至关重要的字段有效。
• 使用 references/spec-v3-field-map.md 了解必填字段的行为要求。

3. 编写高信号量的角色内容。

• 应用 references/character-writing-guidelines.md。
• 相比冗长的文字，优先描述稳定的身份、行为约束和具体示例。
• 使用 references/spec-v3-field-map.md 设计 system_prompt 和 post_history_instructions，将其作为主要控制面。
• 将持久的规则放在 system_prompt 中；将最终轮次的引导/约束放在 post_history_instructions 中。

4. 设计知识库策略。

• 使用 references/lorebook-guidelines.md 选择条目关键词、激活深度、令牌预算和插入顺序。
• 每个条目只包含一个概念，并优先根据观察到的问题逐步添加内容。

5. 在需要时添加角色卡专属的正则脚本（仅适用于 SillyTavern）。

• 使用 references/regex-scoped-scripts.md 了解 data.extensions.regex_scripts 的结构和示例。
• 仅用于需要与此角色卡绑定的确定性文本转换。
• 正则脚本应保持精简，并在发布前使用示例对话进行测试。

6. 验证输出。

• 运行 scripts/validate_card.py <path-to-card.json> 进行结构检查。
• 手动抽查知识库触发词是否匹配用户可能采用的说法。
• 使用 references/reviewing-cards.md 进行质量检查。

7. 返回交付内容。

• 返回最终的 CCv3 JSON。
• 在 JSON 代码块之外单独附上简短说明，介绍主要设计选择和取舍。

输出规则

• 始终输出有效 JSON，绝不输出伪 JSON。
• 如果同时提供说明，请将其放在 JSON 产物之外（例如，将 JSON 放在一个代码围栏中，并在单独的文字部分说明理由）。
• 除非另有明确要求，否则将 spec 设为 "chara_card_v3"，将 spec_version 设为 "3.0"。
• 对于非标准的应用数据，使用 extensions；避免随意添加顶层字段。
• 知识库条目应简洁且可执行。
• 区分严格的规范约束与模型行为启发规则。
• 使用隐藏状态模式（例如 XML 注释）时，应说明泄露风险，并建议在聊天中进行测试。

资源

• references/spec-v3-field-map.md
  • CCv3 必填/可选字段及关键约束。
• references/image-and-asset-formats.md
  • PNG/APNG/JSON/CHARX 的处理方式，以及实用的图像资源兼容性规则。
• references/character-writing-guidelines.md
  • 实用的角色创作质量评估标准。
• references/lorebook-guidelines.md
  • Lorebook 条目设计、触发词质量和 Token 策略。
• references/multi-character-and-scenarios.md
  • 群像角色阵容、偶尔登场的 NPC，以及结构化世界事件逻辑的模式。
• references/popular-card-patterns.md
  • 从高使用率角色卡中总结出的一般性质量模式和规范化策略。
• references/source-notes.md
  • 从相关社区讨论中一次性收集的启发式经验。
• references/reviewing-cards.md
  • 用于评估是否达到发布标准的质量审查清单和评分标准。
• references/regex-scoped-scripts.md
  • SillyTavern 角色卡作用域正则表达式的架构、示例和安全实践。
• references/format-options.md
  • Prose、Attributes、AliChat、JED/JED+、Plaintext 和 W++ 的比较及使用场景指南。
• examples/format-comparison.md
  • 以每种主要格式展示同一角色概念，便于快速并排学习。
• examples/command-orchestration-pattern.md
  • 用于命令触发型 Lorebook 操作的通用模板，包含加权结果和临时内容清理。
• examples/secret-reveal-pattern.md
  • 公开/秘密内容拆分，包含延迟揭示、信念与事实分层，以及节奏控制。
• assets/templates/minimal-card-v3.json
  • 适用于快速生成的精简入门模板。
• assets/templates/standard-card-v3.json
  • 内含 Lorebook 的均衡入门模板。
• assets/templates/advanced-card-v3.json
  • 使用多语言备注和资源的扩展入门模板。
• scripts/validate_card.py
  • 用于角色卡 JSON 的轻量级结构验证器。

注意事项

• 社区技巧可能因前端和模型系列而异。应用这些经验后，请通过测试对话进行调整。
• 某些链接的 Reddit 讨论串在受限环境中可能无法访问；如果无法访问，请采用保守的指导，并优先遵循规范支持的行为。