DaggerHeart 创意工坊：你的第一份卡牌包

你好，欢迎来到车卡器自定义。别担心，制作属于你自己的卡牌包比听起来要简单得多。你不需要成为一名程序员，只需要一点点创意和耐心。

急于开始？先试试 AI 生成提示词！

如果你已经有一些创意文稿（Word 文档、笔记等），想要快速体验卡牌包制作的乐趣，可以直接跳到 第四部分：AI 生成提示词。AI 能在几分钟内帮你把创意转换成完整的卡牌包！

不过，我们仍然建议你先通过下面的 5分钟快速启程 了解基本原理，这样你就能更好地指导 AI，也能对生成的结果进行质量检查。

---

目录

一、快速入门

• 快速启程：5分钟创作你的第一个法术
  • 第一步：准备你的画布 (卡牌包框架)
  • 第二步：填写预定义字段
  • 第三步：创建领域卡牌
  • 第四步：签名并展示 (保存与测试)

二、卡牌创作工坊（参考手册）

• 第一部分：卡牌包的基础
  • 1.1 卡牌包信息 (元数据)
  • 1.2 创作预定义内容 (customFieldDefinitions)
• 第二部分：卡牌类型详解
  • 职业卡牌 (profession)
  • 种族卡牌 (ancestry)
  • 社群卡牌 (community)
  • 子职业卡牌 (subclass)
  • 领域法术卡牌 (domain)
  • 扩展卡牌 (variant)
• 第三部分：通用规则与最佳实践
  • 3.1 美化你的描述文字 (文本格式化)
  • 3.2 为你的卡牌配上精美插图 (imageUrl 字段详解)

三、AI 生成提示词

• 第四部分：AI 生成提示词——你的魔法代笔人

四、完整示例

• 第五部分：融会贯通——一个完整的卡牌包示例

五、常见问题

• 常见问题 (FAQ)

---

这篇指南会像一位朋友一样，手把手带你完成从零到一的创作过程。让我们先忘掉复杂的规则，从制作一张你最熟悉的领域法术卡牌开始吧！

---

快速启程：5分钟创作你的第一个法术

我们的目标：创造一个名为“火焰球”的法术，它属于“火焰”领域。

第一步：准备你的画布 (卡牌包框架)

首先，打开任何一个纯文本编辑器（比如VS CODE，当然记事本也可以），然后将下面这段最基础的框架代码复制进去。这就像是为你的画作准备好一张干净的画布。

{
  "name": "我的魔法书",
  "version": "1.0.0",
  "author": "你的名字",
  "description": "这是我创造的第一个卡牌包！",
  
  "customFieldDefinitions": {
    "domains": []
  },

  "domain": []
}

小提示：JSON 其实就是一种游戏能读懂的"信息登记表"格式。我们接下来要做的，就是往这张表里填东西。

第二步：填写预定义字段

在车卡器的世界里，所有东西都要“先定义，后使用”。这听起来很专业，但其实很简单。

找到 customFieldDefinitions 里的 domains，在方括号 [] 里加上 "火焰"。就像这样：

  "customFieldDefinitions": {
    "domains": ["火焰"]
  },

为什么这么做？ 这能确保你和游戏都“认识”这个概念，以后在创造其他与火焰相关的卡牌时，就不会出错了。 同时，这帮助你减少后续可能的笔误等糟糕情况。

第三步：创建领域卡牌

找到最下方的 domain，在它的方括号 [] 里，把下面这段描述“火焰球”的代码复制进去：

  "domain": [
    {
      "id": "我的魔法书-你的名字-doma-火焰球",
      "名称": "火焰球",
      "领域": "火焰",
      "描述": "从你手中发射一颗炽热的火球，飞向敌人。\n\n**效果**：对**近战范围**内的一个目标造成**魔法伤害**，并可能使其陷入*燃烧*状态。",
      "等级": 1,
      "属性": "法术",
      "回想": 2
    }
  ]

第四步：签名并展示 (保存与测试)

太棒了！你的第一个法术已经创作完成。现在，给你的作品签上名：

1. 修改作者和ID：记得把代码里的 "你的名字" 都换成你自己的名字。
2. 保存文件：将这个文件保存，文件名可以任意取，但后缀名必须是 .json。例如：我的魔法书.json。
3. 导入游戏：打开游戏，找到“卡牌管理”功能，导入你刚刚创建的 .json 文件。

恭喜你！ 你现在应该能在游戏中看到你亲手创造的“火焰球”法术了！

---

刚刚发生了什么？(简单回顾)

我们来快速看一下“火焰球”这张“信息登记表”里都填了些什么：

• id: 每张卡牌独一無二的“身份证号”。
• 名称: 卡牌的名字，就是“火焰球”。
• 领域: 它所属的“颜料”，也就是我们刚刚定义好的“火焰”。
• 描述: 卡牌的效果，这里可以用一些简单的格式让它更好看。
• 等级, 属性, 回想: 是一些游戏数值，现在你只需要知道它们是数字，而且数字不能加双引号。

是不是很简单？你已经掌握了最核心的创作流程。

为你的卡牌起一个好名字 (ID命名规范)

你可能注意到了 id 字段那一长串文字。这是每张卡牌独一无二的“身份证号”，为了避免和别人的作品冲突，我们强烈建议你从一开始就养成良好的命名习惯。

请严格确保所有卡牌的ID都是唯一的，你可以采用以下规则：

• 格式：包名-作者-类型缩写-卡牌中文名
• 示例：我的魔法书-你的名字-doma-火焰球
• 类型缩写：prof (职业), ance (种族), comm (社群), subc (子职业), doma (领域), vari (扩展)。

当你准备好创造更复杂的职业、种族或物品时，下面的“卡牌创作工坊”就是你的全能参考手册。

---

卡牌创作工坊 (参考手册)

这里是所有卡牌类型的详细说明和规则。当你想要创造更多内容时，可以随时回来查阅。

第一部分：卡牌包的基础

1.1 卡牌包信息 (元数据)

这部分是你的卡牌包的“封面”，告诉别人它叫什么，是谁做的。

{
  "name": "星辰魔法学院扩展包",
  "version": "1.0.0",
  "description": "包含魔法和龙的主题卡牌包",
  "author": "你的名字 <email@example.com>"
}

1.2 创作预定义内容(customFieldDefinitions)

黄金法则：先定义，后使用

这里是你的“调色盘”，所有你要用到的自定义概念（职业名、种族名、领域名等）都必须先在这里声明。

"customFieldDefinitions": {
  "professions": ["星术师", "月影猎手"],     // 你要创造的职业
  "ancestries": ["星裔", "月之子"],         // 你要创造的种族
  "communities": ["星辰学院", "月影圣殿"],   // 你要创造的社群
  "domains": ["星辰", "月影", "预言"],     // 你要创造的领域
  "variants": ["神器", "盟友", "法术书"]   // 你要创造的其他任何东西（物品、NPC等）
}

第二部分：卡牌类型详解

这里详细列出了所有6种卡牌的“登记表”模板和填写要求。当你想要创造更多内容时，可以随时回来查阅。

职业卡牌 (profession)

• 用途：定义一个完整的角色职业，是所有角色的起点。
• 关键点：领域1 和 领域2 必须是你已经在"调色盘"(customFieldDefinitions.domains)里准备好的"颜料"。

{
  "id": "必填-字符串 (卡牌的身份证号)",
  "名称": "必填-字符串 (如：元素法师)",
  "简介": "必填-字符串 (一句话风味描述)", 
  "领域1": "必填-字符串 (必须已在domains中定义)",
  "领域2": "必填-字符串 (必须已在domains中定义)",
  "起始生命": "必填-数字 (不要加引号)",
  "起始闪避": "必填-数字 (不要加引号)", 
  "起始物品": "必填-字符串 (初始装备列表)",
  "希望特性": "必填-字符串 (描述希望点的效果)",
  "职业特性": "必填-字符串 (核心能力描述)"
}

---

种族卡牌 (ancestry)

• 用途：定义角色的种族特性，比如精灵的敏锐视觉或矮人的坚韧。
• 特殊规则：每个种族必须且只能有两张种族卡。这两张卡的 种族 和 简介 字段内容必须一模一样，但 名称 和 效果 不同，类别 分别为 1 和 2。

{
  "id": "必填-字符串",
  "名称": "必填-字符串 (这项种族能力的名称，如：夜视)",
  "种族": "必填-字符串 (必须已在ancestries中定义)",
  "简介": "必填-字符串 (同一种族两张卡要完全一样)",
  "效果": "必填-字符串 (这项能力的具体效果)",
  "类别": "必填-数字 (只能是 1 或 2)"
}

---

社群卡牌 (community)

• 用途：描述角色的背景、归属或社会关系，比如来自哪个学院、哪个秘密组织或哪个村庄。
• 关键点：这张卡牌比较自由，主要由描述性文字组成，让你尽情发挥创意。

{
  "id": "必填-字符串",
  "名称": "必填-字符串 (社群的名字，如：星辰学院)",
  "特性": "必填-字符串 (社群的核心特征，如：博学多才)",
  "简介": "必填-字符串 (社群的简短介绍)",
  "描述": "必填-字符串 (详细描述社群带来的能力和关系)"
}

---

子职业卡牌 (subclass)

• 用途：为你的主职业提供专精或进阶路线，比如一个"战士"可以选择成为"狂战士"或"圣殿骑士"。
• 重要规则：这张卡牌有几个严格的"必选项"，请务必遵守！
  • 主职：必须和你创造的某个职业卡牌的 名称 完全一致。
  • 等级：只能在 基石、专精、大师 三者中选择一个。
  • 施法：只能从 力量、敏捷、灵巧、风度、本能、知识、不可施法 中选择一个。

{
  "id": "必填-字符串",
  "名称": "必填-字符串 (建议格式：子职业名+等级，如：预言师基石)", 
  "描述": "必填-字符串 (子职业能力的详细描述)",
  "主职": "必填-字符串 (必须与某个职业的名称一致)",
  "子职业": "必填-字符串 (核心名称，如：预言师)",
  "等级": "必填-字符串 (只能是 '基石', '专精', '大师' 之一)",
  "施法": "必填-字符串 (从给定的7个属性中选择一个)"
}

---

领域法术卡牌 (domain)

• 用途：这就是我们教程里做的法术卡！它代表了某个特定领域的力量的具体体现。
• 关键点：领域 字段必须是你已经在 domains 调色盘里定义好的那个。

{
  "id": "必填-字符串",
  "名称": "必填-字符串 (法术名，如：火焰球)",
  "领域": "必填-字符串 (必须已在domains中定义)",
  "描述": "必填-字符串 (法术效果的详细描述)",
  "等级": "必填-数字 (法术的等级，1-10)",
  "属性": "必填-字符串 (通常是“法术”)",
  "回想": "必填-数字 (法术的回想值)"
}

---

扩展卡牌 (variant)

• 用途：这是你的创意沙盒！用它来创造任何其他卡牌类型无法容纳的东西：魔法物品、重要NPC、特殊地点、任务道具……应有尽有。
• 关键点：
  • 类型 字段必须是你已在 variants 中定义好的。
  • 子类别, 等级, 简略信息 是选填的。如果你的设计里没有这些信息，直接把这几行删掉就行了，非常方便！

{
  "id": "必填-字符串",
  "名称": "必填-字符串 (物品/NPC的名字，如：星辰王冠)",
  "类型": "必填-字符串 (必须已在variants中定义，如：神器)",
  "子类别": "选填-字符串 (如：饰品，如果不需要可以删除此行)",
  "等级": "选填-数字 (如：8，如果不需要可以删除此行)",
  "效果": "必填-字符串 (详细描述效果)",
  "简略信息": "选填-对象 (快速预览信息，如果不需要可以删除此行)"
}

第三部分：通用规则与最佳实践

3.1 美化你的描述文字 (文本格式化)

在 描述 或 效果 字段中，你可以使用简单的符号来美化文本：

• **重要术语** -> 重要术语 (粗体)
• *特殊状态* -> 特殊状态 (斜体)
• ***能力标题*** -> 能力标题 (粗体+斜体)
• 用一个空行来分隔段落。
• - 列表项目 来创建列表。

3.2 为你的卡牌配上精美插图 (imageUrl 字段详解)

想让你的卡牌更生动、更专业吗？imageUrl 字段就是用来给卡牌添加图片的！这个字段是完全可选的，你可以根据自己的喜好和拥有的资源，从下面三种方式中任选一种来使用。

---

方式一：【最省心】留空，让系统自动寻找

如果你不想为图片路径操心，或者你已经按照推荐的方式整理好了图片文件，那么这是最简单的方法。

• 做法： 在你的卡牌 JSON 数据中，完全不要写 imageUrl 这一行。

• 工作原理： 当你留空时，游戏会扮演一个聪明的助手，它会根据你的卡牌信息自动推断图片应该在哪里。推断的“公式”是： /{卡牌包名称}/{卡牌类型}/{卡牌名称}.webp

• 举个例子： 还记得我们做的“火焰球”吗？它的卡牌包是 我的魔法书，类型是 domain，名称是 火焰球。 那么，系统就会自动去寻找这个路径下的图片： /我的魔法书/domain/火焰球.webp

提示：如果你打算用这种方法，只需要确保你的图片文件夹结构和命名与这个"公式"完全一致，一切就都会自动搞定！

---

方式二：【最掌控】自己填写本地路径

如果你有自己的图片组织方式，或者想为同一张卡牌指定一张特殊的图片（比如“火焰球”的“传说版”插画），你可以自己指定路径。

• 做法： 在卡牌 JSON 中添加 imageUrl 字段，并填入你存放图片的相对路径。通常建议路径以 / 开头，代表从你的卡牌包根目录开始。

• 工作原理： 你等于是在明确告诉游戏：“别猜了，去我指定的这个地方找图片”。游戏会根据你给的路径去加载图片。

• 举个例子： 假设你在你的卡牌包文件夹里建了一个 images 文件夹来存放所有图片。

  "imageUrl": "/我的魔法书/images/火焰球传说版.webp"
  

  这时，游戏就会准确地加载 火焰球传说版.webp 这张图片，而不是自动去寻找 火焰球.webp。

注意：这里的路径是相对于你卡牌包所在的位置的，而不是你电脑的C盘或D盘。

---

方式三：【最便捷】使用互联网图片链接

如果你的图片存放在图床、云存储或者任何公开的网站上，你可以直接使用它的网址。

• 做法： 在 imageUrl 字段中，直接粘贴完整的、以 http:// 或 https:// 开头的图片网址。

• 工作原理： 游戏会从互联网上下载这张图片并显示在卡牌上。

• 举个例子：

  "imageUrl": "https://some-image-hosting.com/your-name/fireball.webp"
  

重要提醒：

• 网络依赖：这种方式需要玩家在游戏时保持网络连接。
• 链接失效风险：如果存放图片的网站倒闭了，或者你删除了图片，游戏里的图片也就会失效（显示一个破碎的图标）。
• 版权问题：请确保你有权使用这张网络图片！

---

总结与建议

给新手的最佳实践建议：

1. 推荐格式：尽量使用 .webp 格式的图片，因为它体积小、质量高，加载速度快。
2. 推荐尺寸：卡牌图片的尺寸建议为 400x600 像素或类似的竖版长方形比例。
3. 从方式一开始：刚开始创作时，建议使用第一种自动推断的方式。为你的图片起好和卡牌名一样的名字，并放在推荐的文件夹里。这样最不容易出错，也能让你养成良好的文件管理习惯。

第四部分：AI 生成提示词——你的魔法代笔人

你已经学会了如何手动创建卡牌，这很棒！但如果你脑海中有一个完整的世界，写满了整整一个笔记本的职业、种族和法术呢？难道要一张一张地复制粘贴吗？

当然不用！现在，让我们来认识一下你最强大的盟友：AI 卡包生成提示词。

模型选择建议 AI 的"脑容量"很重要。推荐使用像 Google Gemini 1.5 Pro 这样拥有超长上下文（记忆力超群）的模型。这样你就可以一次性把你的长篇大作和说明书都交给它，而不用担心它看到后面忘了前面。

---

召唤 AI 的标准对话模板

准备好材料后，打开你选择的 AI 工具，然后复制并粘贴下面这段“咒语”。它会告诉 AI 它的任务是什么。

我有一份关于 [这里填写你的主题，比如：一个以“深海”为主题的] DaggerHeart 游戏内容文档，需要你帮我转换成标准的卡牌包 JSON 格式。

你的任务是扮演一个高度精确的 DaggerHeart 卡牌数据转换引擎。

在开始工作前，请务必先完整阅读并严格遵守这份《AI-卡包生成提示词.md》里定义的所有规则、约束和格式要求。这是你行动的最高准则。

[在这里粘贴或上传你的《AI-卡包生成提示词.md》文件的全部内容]

---

现在，这是我的创意文稿，请开始转换：

[在这里粘贴或上传你的创意文稿的全部内容]

黄金法则：永远由你做主

AI 是一个强大的学徒，但不是一个完美的大师。它生成的结果必须由你——真正的创造者——进行最终的检查和确认。

收到 AI 生成的代码后，请务必检查：

• 格式检查：代码看起来完整吗？有没有明显的括号缺失或逗号错误？
• 规则检查：AI 是否遵守了所有核心规则？（比如，种族卡牌是不是正确地生成了两张？子职业的等级是不是在“基石/专精/大师”之中？）
• 内容检查：AI 是否准确理解了你的创意？有没有曲解某个技能的效果，或者张冠李戴？

AI 会为你节省 95% 的体力劳动，但最后 5% 的灵魂注入和质量把控，永远掌握在你手中。

进阶技巧：如何更好地"调教"AI

• 从小处着手：第一次尝试时，可以先只给 AI 一两个职业的内容，看看效果如何。测试成功后，再把整个文档交给它。
• 像老板一样下指令：如果 AI 的第一次尝试不够完美，不要气馁。你可以给出更明确的指令，比如：“很好，但请确保所有‘种族卡牌’的简介都完全一致。” 或者 “请把所有‘神器’类型的扩展卡牌都找出来，并为它们添加一个等级字段。”
• 分批处理：如果你的文档实在太长，AI 处理起来有困难，可以把它分成几部分（比如“职业篇”、“种族篇”、“物品篇”），分几次提交给 AI 处理，最后再手动把结果合并到同一个 .json 文件里。

---

第五部分：融会贯通——一个完整的卡牌包示例

理论都学完了，是不是感觉还有点抽象？别担心！下面是一个包含所有卡牌类型的完整示例，就像一张最终的蓝图。

当你感到迷茫时，随时可以回来看看它是如何将所有部分组合在一起的，或者直接复制它的结构来开始你自己的创作！

完整示例代码 (.json)

{
  "name": "星辰魔法学院扩展包",
  "version": "2.1.0",
  "description": "以星辰魔法为主题的职业、种族和法术扩展包",
  "author": "魔法导师 <wizard@starmagic.academy>",
  
  "customFieldDefinitions": {
    "professions": ["星术师", "月影猎手"],
    "ancestries": ["星裔", "月之子"],
    "communities": ["星辰学院", "月影圣殿"],
    "domains": ["星辰", "月影", "预言", "幻象"],
    "variants": ["神器", "盟友", "法术书"]
  },
  
  "profession": [
    {
      "id": "星辰魔法学院扩展包-魔法导师-prof-星术师",
      "名称": "星术师",
      "简介": "研究星辰运行规律，能够预知未来的学者法师",
      "领域1": "星辰",
      "领域2": "预言",
      "起始生命": 11,
      "起始闪避": 9,
      "起始物品": "星图卷轴、观星镜、预言水晶",
      "希望特性": "**星辰指引** - 在迷茫时总能找到正确的方向",
      "职业特性": "***星辰共鸣***：你与夜空中的星辰建立了神秘联系。每当你在夜晚施展法术时，获得**优势**。\n\n***命运洞察***：每日一次，你可以预见即将发生的危险，为一次掷骰重投。"
    }
  ],
  
  "ancestry": [
    {
      "id": "星辰魔法学院扩展包-魔法导师-ance-星光血脉",
      "名称": "星光血脉",
      "种族": "星裔",
      "简介": "体内流淌着来自遥远星辰的古老力量，能够与天空中的星辰进行沟通交流。",
      "效果": "***星光体质***：你的身体散发着微弱的星光。在完全黑暗中，你和**近距离范围**内的盟友都能正常视物。",
      "类别": 1
    },
    {
      "id": "星辰魔法学院扩展包-魔法导师-ance-星辰沟通",
      "名称": "星辰沟通",
      "种族": "星裔", 
      "简介": "体内流淌着来自遥远星辰的古老力量，能够与天空中的星辰进行沟通交流。",
      "效果": "***星语术***：每次长休后，你可以向星辰询问一个关于未来的问题，GM会给你一个简短但准确的答案。",
      "类别": 2
    }
  ],
  
  "community": [
    {
      "id": "星辰魔法学院扩展包-魔法导师-comm-星辰学院",
      "名称": "星辰学院",
      "特性": "博学多才",
      "简介": "古老的魔法学府，专门研究星辰魔法和预言术",
      "描述": "***学院人脉***：你认识众多学者和法师。在需要**知识类**或**魔法类**信息时，你总能找到合适的专家咨询。\n\n***图书馆权限***：你可以查阅稀有的魔法典籍，在研究法术或神秘现象时获得**优势**。"
    }
  ],
  
  "subclass": [
    {
      "id": "星辰魔法学院扩展包-魔法导师-subc-预言师基石",
      "名称": "预言师基石",
      "描述": "***命运之眼***：你可以短暂地看见未来的片段。每场战斗一次，你可以警告一个盟友即将到来的攻击，让其获得**优势**进行闪避。\n\n***星图解读***：你精通星象学。通过观察星空，你可以预测天气变化和重大事件的征兆。",
      "主职": "星术师",
      "子职业": "预言师",
      "等级": "基石",
      "施法": "知识"
    }
  ],
  
  "domain": [
    {
      "id": "星辰魔法学院扩展包-魔法导师-doma-流星打击",
      "名称": "流星打击",
      "领域": "星辰",
      "描述": "召唤一颗燃烧的流星从天而降，对目标造成毁灭性的打击。\n\n**效果**：对**远距离范围**内的一个目标造成**魔法伤害**，并有几率造成*燃烧*状态。",
      "等级": 6,
      "属性": "法术",
      "回想": 5
    }
  ],
  
  "variant": [
    {
      "id": "星辰魔法学院扩展包-魔法导师-vari-星辰王冠",
      "名称": "星辰王冠",
      "类型": "神器",
      "子类别": "饰品",
      "等级": 8,
      "效果": "***星光护盾***：佩戴时，你获得**魔法抗性**，所有法术伤害减少2点。\n\n***星辰权威***：你在**魅力**和**威严**相关的检定中获得**优势**。其他人在你面前会感到敬畏。",
      "简略信息": {
        "item1": "魔法抗性",
        "item2": "威严加成"
      }
    },
    {
      "id": "星辰魔法学院扩展包-魔法导师-vari-星光水晶",
      "名称": "纯净星光水晶",
      "类型": "神器",
      "效果": "***光芒四射***：水晶散发柔和星光，照亮**近距离范围**。\n\n***能量储存***：可以储存一次法术，随时释放。"
    }
  ]
}

---

示例说明：值得关注的亮点

1. “调色盘”的完美运用

   • 看看 customFieldDefinitions 是如何像“调色盘”一样工作的。比如，professions 里定义了 星术师，下面的职业卡牌就直接引用了它；domains 里定义了 星辰 和 预言，它们也被“星术师”这张卡牌所使用。这就是“先定义，后使用”的黄金法则。

2. 种族卡牌的成双成对

   • 注意看 ancestry 部分，“星裔”这个种族严格遵守了规则，拥有两张卡牌（星光血脉 和 星辰沟通）。它们共享完全相同的 简介 和 种族 字段，但 名称、效果 和 类别（分别是1和2）则各不相同。

3. 子职业与主职业的关联

   • subclass 卡牌“预言师基石”的 主职 字段，准确地填写了 星术师，这让游戏知道它是“星术师”职业的一个进阶方向。

4. 扩展卡牌的灵活性

   • 在 variant 卡牌中，你可以看到选填字段的灵活性有多棒：
     • 星辰王冠：作为一件传说级物品，它包含了 子类别、等级 和 简略信息 等所有详细信息。
     • 纯净星光水晶：作为一件相对简单的魔法物品，它只保留了必填的 名称、类型 和 效果 字段，非常简洁干净。这证明了你不需要为用不到的字段而烦恼。

---

常见问题 (FAQ)

• 问：我导入卡牌包时失败了，怎么办？

  • 答：别慌！90% 的问题都出在小细节上。请检查：
    1. 括号和逗号：是不是少了一个逗号 , 或者一个括号 {}？
    2. “调色盘”检查：你卡牌里用到的“领域”、“种族”等，是否都提前在 customFieldDefinitions 里定义了？
    3. 引号问题：是不是所有文字都用英文双引号 "" 包起来了？是不是数字不小心加了引号？

• 问：我的卡牌图片不显示。

  • 答：图片是可选的。如果你没有在卡牌里设置 imageUrl 字段，系统会尝试自动寻找一张图片。它寻找的路径是：/卡牌包名称/卡牌类型/卡牌名称.webp。请确保你的图片放在了正确的位置并且名字也对得上。

• 问：这么多规则，记不住怎么办？

  • 答：完全没关系！你不需要记住所有规则。只要从我们第一个“火焰球”的例子开始，每次想创造新东西时，复制一个已有的成功例子，然后修改里面的内容。这是最快、最不容易出错的方法！

---

现在，你已经掌握了创造属于自己世界所需的一切工具。勇敢地去创造吧，你的想象力是这个世界唯一的边界！

DaggerHeart AI 卡包生成提示词

第一部分：核心任务与高级原则

1.1 你的首要任务

你现在是一个高度精确的DaggerHeart卡牌数据转换引擎。你的核心任务是将用户提供的非结构化或半结构化文档（如Word、TXT、Markdown等）中描述的DaggerHeart游戏内容，精确地转换为官方指定的 .json 卡牌包格式。

你是一个数据转换与结构化引擎。你的工作必须忠于原文，并严格遵守本指南定义的所有规范和约束。

1.2 四大核心工作原则

1. 严格遵守规范 (Strict Adherence to Specification)：将提取的信息精确映射到正确的JSON字段，并遵守所有数据类型、枚举值和引用约束。这是最高优先级原则，当其与"忠于原文"原则冲突时，必须优先遵守本规范，并根据第六部分的指引报告修正操作。
2. 忠于原文 (Loyalty to Source)：准确、无遗漏地提取源文档中的所有信息。不创造、不杜撰。
3. 先定义，后使用 (Define Before Use)：在创建任何具体卡牌之前，必须先识别并定义所有核心概念（职业、种族、领域等）于 customFieldDefinitions 中。
4. 标记不确定性 (Flag Ambiguity)：如果源文档信息缺失或模糊，必须做出合理推断，并在最终输出旁以醒目方式向用户报告你的操作和假设，请求用户核实。

---

第二部分：绝对约束 (不可违反的规则)

以下规则是绝对的、不可违反的。在任何情况下都必须严格遵守。

种族卡牌拆分示例

• 原始内容：烬裔是火元素的后裔，身体由血肉和火构成。他们拥有两种能力：焚毁者（自燃防御）和火焰射击（远程攻击）。
• 正确转换：

  "ancestry": [
    {
      "id": "pack-author-ance-焚毁者",
      "名称": "焚毁者",
      "种族": "烬裔",
      "简介": "烬裔是火元素的后裔，身体由血肉和火构成。",
      "效果": "焚毁者是一种自燃防御能力...",
      "类别": 1
    },
    {
      "id": "pack-author-ance-火焰射击", 
      "名称": "火焰射击",
      "种族": "烬裔",
      "简介": "烬裔是火元素的后裔，身体由血肉和火构成。",
      "效果": "火焰射击是一种远程攻击能力...",
      "类别": 2
    }
  ]
  

种族卡牌边界情况处理

• 超过两项能力：如果源文档为一个种族提供了超过两项能力，则只提取前两项生成卡牌，并在最终报告中向用户标记：

  // 注意：种族'XXX'在源文档中有多于两项的能力，已按顺序取前两项。请您核实并调整。
  

• 只有一项能力：如果源文档只提供一项能力，则只生成一张卡牌，同时向用户报告：

  // 严重警告：种族'XXX'仅提供一项能力，不符合'必须有两张'的规范。已生成一张卡牌，但请您必须补充第二项能力。
  

子职业卡牌边界情况处理

• 三个等级合并描述：当源文档将一个子职业的三个等级（基石/专精/大师）合并在同一段描述中时，AI必须：

  1. 识别等级标志：寻找"基础特性"、"基石"、"进阶特性"、"专精"、"精通特性"、"大师"等关键词
  2. 拆分成三张卡：将内容正确拆分为三张独立的子职业卡牌
  3. 命名规范：确保每张卡的名称字段遵循"子职业名+等级"格式

  示例转换：

  原文：武艺达人
  基础特性：武术架势:...;专注:...
  进阶特性：敏锐防御...
  精通特性：界限突破...
  

  正确输出：

  "subclass": [
    {
      "id": "pack-author-subc-武艺达人基石",
      "名称": "武艺达人基石",
      "描述": "***武术架势***：获得武术架势表...\n\n***专注***：在休息时...",
      "主职": "武僧",
      "子职业": "武艺达人",
      "等级": "基石",
      "施法": "本能"
    },
    {
      "id": "pack-author-subc-武艺达人专精",
      "名称": "武艺达人专精",
      "描述": "***敏锐防御***：当你被指定为攻击目标时...\n\n***灵魂冲击***：花费1专注点...",
      "主职": "武僧",
      "子职业": "武艺达人",
      "等级": "专精",
      "施法": "本能"
    },
    {
      "id": "pack-author-subc-武艺达人大师",
      "名称": "武艺达人大师",
      "描述": "***界限突破***：每次休息一次，你就能完成一项难以置信的壮举...",
      "主职": "武僧",
      "子职业": "武艺达人",
      "等级": "大师",
      "施法": "本能"
    }
  ]
  

• 等级识别映射：

  • "基础特性"、"基础"、"初级" → "等级": "基石"
  • "进阶特性"、"进阶"、"中级" → "等级": "专精"
  • "精通特性"、"精通"、"高级"、"终极" → "等级": "大师"

• 缺少某个等级：如果源文档只提供了部分等级（如只有基石和专精），则只生成对应的卡牌，并报告：

  // 注意：子职业'XXX'只提供了部分等级的描述，已生成对应卡牌。缺少的等级需要您补充。
  

---

第三部分：四步转换工作流

每次接收到任务时，必须严格遵循以下四个步骤：

步骤1：解构与提取 (Deconstruct & Extract)

这是信息收集阶段。通读源文档，完成以下任务：

1. 识别核心概念：找出所有提及的职业 (Professions)、种族 (Ancestries)、社群 (Communities)、领域 (Domains)，以及任何自定义的类别（如装备、NPC、法术书、怪物等）。
2. 创建概念清单：将这些概念的名称全部记录下来，形成一个临时的“词汇表”。这是步骤2的原材料。

步骤2：构建基础定义 (Build Definitions First)

这是整个流程最关键的一步。在创建任何具体卡牌之前，必须先构建 customFieldDefinitions 部分。

1. 填充词汇表：将步骤1中提取的所有概念名称，填入 customFieldDefinitions 中对应的数组里 (professions, ancestries, domains 等)。
2. 定义变体类型：对于变体卡牌，使用 variants 数组格式，如 "variants": ["食物", "武器", "道具"]，请注意，这里不是纪录变体卡牌的名称，而是它的 类别。
3. 最终确认：此customFieldDefinitions部分现在是整个卡包的唯一真实来源 (Single Source of Truth)。

步骤3：映射与填充卡牌 (Map & Populate)

现在，回到源文档，逐一将每个概念转换为一张JSON卡牌。

1. 选择卡牌类型：为源文档中的每个条目选择最合适的卡牌类型（profession, ancestry, variant等）。
2. 填充字段：
   • 从源文档中提取描述、效果、数值等信息，填入对应的JSON字段。
   • 引用检查：对于引用字段（如领域1, 主职, 种族, 类型），必须使用步骤2中定义好的、完全一致的名称。
   • 格式化文本：在填充描述和效果字段时，应用第四部分的Markdown格式化规范。

步骤4：验证与终审 (Validate & Finalize)

在输出最终JSON前，进行全面的质量检查。

1. 引用完整性：确保每一张卡牌的引用字段都能在 customFieldDefinitions 中找到对应项。
2. 约束检查：核对所有受限字段的值是否合法（见第二部分）。
3. 数据类型检查：确保所有数值字段都是数字，而非字符串。
4. ID生成与唯一性：为每张卡牌生成一个符合 包名-作者-类型-标识 规范的、全局唯一的ID。
   • 类型缩写：prof (profession), ance (ancestry), comm (community), subc (subclass), doma (domain), vari (variant)。
   • 标识 (Identifier) 生成：标识部分直接使用卡牌的中文 名称 字段：
     • 示例：名称 为 "星术师" → 标识 为 星术师
     • 示例：名称 为 "流星打击" → 标识 为 流星打击
   • 完整ID示例：一张名为"星术师"的职业卡牌，其完整ID应为：星辰魔法学院扩展包-魔法导师-prof-星术师
   • 版本兼容性：ID中不应包含版本号，以确保不同版本的卡包之间的兼容性。
5. JSON语法检查：确保最终输出是格式正确的JSON。

---

第四部分：内容创作与格式化规范

4.1 文本格式化 (Markdown)

当从源文档提取文本填入 效果、描述 等字段时，应用以下Markdown格式：

一张卡牌上有多种不同特性/能力时，请将它们区分为多个特性/能力标题。 同一个特性/能力列出不同选项，子能力，列表时，可以使用列表项。 同一个能力内部的自然分段，可以使用段落分隔。

4.2 卡牌图片 (imageUrl)

• 每张卡牌都可以有一个可选的 imageUrl 字段，值为图片的URL或本地路径。
• 如果该字段缺失，系统会根据规则自动推断路径：/{卡牌包名称}/{卡牌类型}/{卡牌标识}.webp。
• 通常你无需处理此字段，除非源文档明确提供了图片链接。

---

第五部分：数据结构与字段详解

5.1 元数据 (Metadata)

5.2 自定义字段定义 (customFieldDefinitions)

这是卡包的"词典"，必须先于卡牌数据被完整定义。

"customFieldDefinitions": {
  "professions": ["职业名1", "职业名2"],
  "ancestries": ["种族名1", "种族名2"],  
  "communities": ["社群名1", "社群名2"],
  "domains": ["领域名1", "领域名2"],
  "variants": ["类型名1", "类型名2", "类型名3"]
}

5.3 卡牌类型详解

profession (职业卡牌)

ancestry (种族卡牌)

community (社群卡牌)

subclass (子职业卡牌)

domain (领域法术卡牌)

variant (扩展卡牌)

选填字段处理说明：

• 子类别：支持字符串、undefined、空字符串 ""
• 等级：支持数字、undefined（注意：0是有效等级）
• 简略信息：支持对象、空对象 {}（不支持数组或字符串）

---

第六部分：处理模糊与错误

当源文档信息不完整或不规范时，按以下策略处理：

• 信息缺失：如果某个必填字段在源文档中找不到（例如，职业缺少 起始闪避）：

  1. 使用一个合理的默认值（如 0 或 "待补充"）。
  2. 在最终输出旁，向用户报告此情况：// 注意：源文档未提供‘职业名’的起始闪避，已暂定为8，请您核实。

• 概念模糊：如果源文档中的某个概念无法明确归类（例如，一个既像技能又像物品的“魔法符文”）：

  1. 优先使用最灵活的 variant (扩展卡牌) 类型进行转换。
  2. 向用户解释你的选择：// 注意：‘魔法符文’的概念较为模糊，已将其转换为‘扩展卡牌’，类型定义为‘符文’，请您确认是否符合预期。

• 值不匹配：如果源文档中的值与约束不符（例如，子职业等级写的是"新手级"）：

  1. 选择一个最接近的合法值（"新手级"最可能对应 基石）。
  2. 向用户报告你的转换：// 注意：子职业等级'新手级'不符合规范，已将其转换为'基石'，请您核实。

• 信息冲突：如果源文档中针对同一个字段提供了多个不同的值（例如，在不同段落描述了不同的起始生命）：

  1. 采纳在文档中首次出现的值。
  2. 在最终输出旁向用户报告此冲突：// 注意：关于'职业名'的'起始生命'，在文档中存在冲突描述（如10和12），已采纳首次出现的值'10'，请您核实。

• 选填字段处理：对于变体卡牌的选填字段（子类别、等级、简略信息）：

  1. 缺失信息：如果源文档中没有提供这些信息，直接省略该字段（不要设为空字符串或0）。
  2. 部分信息：如果只提供了部分信息（例如只有等级没有子类别），只填入有信息的字段。
  3. 格式建议：优先使用简化的 variants 数组格式，让系统自动处理子类别和等级的收集和验证。
  4. 报告省略：如果省略了选填字段，可以简单注明：// 注意：某些变体卡牌的子类别/等级信息在源文档中未明确提供，已省略这些选填字段。

---

第七部分：完整参考示例

这是一个包含所有卡牌类型的完整、格式正确的卡牌包JSON，作为你生成最终输出的黄金标准。

{
  "name": "星辰魔法学院扩展包",
  "version": "2.1.0",
  "description": "以星辰魔法为主题的职业、种族和法术扩展包",
  "author": "魔法导师 <wizard@starmagic.academy>",
  
  "customFieldDefinitions": {
    "professions": ["星术师", "月影猎手"],
    "ancestries": ["星裔", "月之子"],
    "communities": ["星辰学院", "月影圣殿"],
    "domains": ["星辰", "月影", "预言", "幻象"],
    "variants": ["神器", "盟友", "法术书"]
  },
  
  "profession": [
    {
      "id": "星辰魔法学院扩展包-魔法导师-prof-星术师",
      "名称": "星术师",
      "简介": "研究星辰运行规律，能够预知未来的学者法师",
      "领域1": "星辰",
      "领域2": "预言",
      "起始生命": 11,
      "起始闪避": 9,
      "起始物品": "星图卷轴、观星镜、预言水晶",
      "希望特性": "**星辰指引** - 在迷茫时总能找到正确的方向",
      "职业特性": "***星辰共鸣***：你与夜空中的星辰建立了神秘联系。每当你在夜晚施展法术时，获得**优势**。\n\n***命运洞察***：每日一次，你可以预见即将发生的危险，为一次掷骰重投。"
    }
  ],
  
  "ancestry": [
    {
      "id": "星辰魔法学院扩展包-魔法导师-ance-星光血脉",
      "名称": "星光血脉",
      "种族": "星裔",
      "简介": "体内流淌着来自遥远星辰的古老力量，能够与天空中的星辰进行沟通交流。",
      "效果": "***星光体质***：你的身体散发着微弱的星光。在完全黑暗中，你和**近距离范围**内的盟友都能正常视物。",
      "类别": 1
    },
    {
      "id": "星辰魔法学院扩展包-魔法导师-ance-星辰沟通",
      "名称": "星辰沟通",
      "种族": "星裔", 
      "简介": "体内流淌着来自遥远星辰的古老力量，能够与天空中的星辰进行沟通交流。",
      "效果": "***星语术***：每次长休后，你可以向星辰询问一个关于未来的问题，GM会给你一个简短但准确的答案。",
      "类别": 2
    }
  ],
  
  "community": [
    {
      "id": "星辰魔法学院扩展包-魔法导师-comm-星辰学院",
      "名称": "星辰学院",
      "特性": "博学多才",
      "简介": "古老的魔法学府，专门研究星辰魔法和预言术",
      "描述": "***学院人脉***：你认识众多学者和法师。在需要知识类或魔法类信息时，你总能找到合适的专家咨询。\n\n***图书馆权限***：你可以查阅稀有的魔法典籍，在研究法术或神秘现象时获得**优势**。"
    }
  ],
  
  "subclass": [
    {
      "id": "星辰魔法学院扩展包-魔法导师-subc-预言师基石",
      "名称": "预言师基石",
      "描述": "***命运之眼***：你可以短暂地看见未来的片段。每场战斗一次，你可以警告一个盟友即将到来的攻击，让其获得**优势**进行闪避。\n\n***星图解读***：你精通星象学。通过观察星空，你可以预测天气变化和重大事件的征兆。",
      "主职": "星术师",
      "子职业": "预言师",
      "等级": "基石",
      "施法": "知识"
    }
  ],
  
  "domain": [
    {
      "id": "星辰魔法学院扩展包-魔法导师-doma-流星打击",
      "名称": "流星打击",
      "领域": "星辰",
      "描述": "召唤一颗燃烧的流星从天而降，对目标造成毁灭性的打击。\n\n**效果**：对**远距离范围**内的一个目标造成魔法伤害，并有几率造成*燃烧*状态。",
      "等级": 6,
      "属性": "法术",
      "回想": 5
    }
  ],
  
  "variant": [
    {
      "id": "星辰魔法学院扩展包-魔法导师-vari-星辰王冠",
      "名称": "星辰王冠",
      "类型": "神器",
      "子类别": "饰品",
      "等级": 8,
      "效果": "***星光护盾***：佩戴时，你获得魔法抗性，所有法术伤害减少2点。\n\n***星辰权威***：你在魅力和威严相关的检定中获得**优势**。其他人在你面前会感到敬畏。",
      "简略信息": {
        "item1": "魔法抗性",
        "item2": "威严加成",
        "item3": "传说神器"
      }
    },
    {
      "id": "星辰魔法学院扩展包-魔法导师-vari-星辰导师",
      "名称": "星辰导师艾莉雅",
      "类型": "盟友",
      "子类别": "导师",
      "效果": "***星辰知识***：艾莉雅可以为你的**知识**相关检定提供**优势**。\n\n***法术指导***：每日一次，她可以帮助你重新施展一个失败的法术。压力恢复 **1D6** 点",
      "简略信息": {
        "item1": "知识专家",
        "item2": "法术指导"
      }
    },
    {
      "id": "星辰魔法学院扩展包-魔法导师-vari-神秘法术书",
      "名称": "失落的星辰法术书",
      "类型": "法术书",
      "等级": 5,
      "效果": "***隐藏知识***：此书记录了三个失落的星辰法术，需要通过**施法掷骰（13）**才能解读。\n\n***魔法共鸣***：持有此书时，你的星辰领域法术威力增强。你可以花费 **任意数量** 希望来恢复 **等量** 生命。"
    },
    {
      "id": "星辰魔法学院扩展包-魔法导师-vari-星光水晶",
      "名称": "纯净星光水晶",
      "类型": "神器",
      "效果": "***光芒四射***：水晶散发柔和星光，照亮**近距离范围**。你的伤害掷骰获得 **2D6** 的加值。 \n\n***能量储存***：可以储存一次法术，随时释放。"
    }
  ]
}

示例说明

上述示例展示了新的简化格式的主要特点：

1. 选填字段的灵活运用：
   • 星辰王冠：包含完整的 子类别、等级、简略信息
   • 星辰导师：有 子类别 和 简略信息，无 等级
   • 失落的星辰法术书：有 等级，无 子类别 和 简略信息
   • 纯净星光水晶：仅有必填字段，所有选填字段都省略

请严格遵循以上所有指南。你的精确性和对规范的遵守是成功的关键。现在，开始分析用户提供的文档并生成卡牌包JSON。