AI 输出修改规范 V2.1

版本 V2.1 更新日期：2026-05-28 适用对象：非程序员用户

定义 AI 在要求修改某功能时的标准输出流程。

一、AI 输出流程（必须遵循）

理解功能

先复述用户意图，确认理解正确。标注受影响的文件（如 story.json、game.js）。

设计代码（展示修改片段）

只输出需要修改的代码块，不输出完整文件（除非用户要求）。每个代码块必须标明文件路径和节点/函数名称。使用 // ... 其他代码保持不变 省略无关部分。

⚠️ 涉及删除节点、删除选项或删除效果时，必须明确写出被删除的内容（可用 diff 格式），避免用户误解。

检查跨文本影响

列出是否影响其他节点、flag、变量、物品、金币等。如有影响，必须一并输出修改方案。若无影响，明确说明"无跨文本影响"。

输出测试案例

给出一组可执行的测试步骤（从游戏起点开始的操作路径）。在每个步骤中埋入验证点：预期看到的文字、装备、身份、金币数量或控制台输出。

1. 开局 → 选择「跟他走」
2. 选择「同意被打死」→「同意按 F9」
3. 选择「自己忍受」
4. 预期：装备栏先变木剑，后变炼狱；结交愚者；身份显示"星星"

输出校验提示（用于非程序员）

清除 localStorage（F12 → Application → Local Storage → 删除 tarotSave）
刷新页面测试
检查控制台有无红色报错
提供回滚方法：备份被修改的文件，或告知如何恢复

二、输出格式模板

## 修改理解

（用户想要……，我将修改……）

## 代码修改

**文件：story.json**
**节点/函数：`12_book`**
```json
"12_book": {
  ...,
  "text": "新的文本内容"
}
```

**文件：game.js**
**函数：applyEffects**
```javascript
// 新增 effect 类型
case "newEffect":
   // 实现
   break;
```

**删除内容（如有）：**
```diff
- 删除节点 "test_combat"
- 删除节点 "1" 中的选项 { "text": "战斗测试", "next": "test_combat" }
```

## 跨文本影响检查

影响节点：无（或列出）

影响 flag：无（或列出）

影响物品：无（或列出）

影响金币：无（或列出）

## 测试案例

步骤一 → 预期结果

步骤二 → 预期结果

验证点：装备栏应显示 xxx，身份应为 xxx，金币应为 xxx。

## 校验与回滚

测试前请清除 localStorage。

若出现问题，请恢复以下文件到备份版本：story.json, game.js

三、关于"语法符号错误"的处理

输出代码时

输出完整可复制的代码块（不要省略关键符号如逗号、引号）
标注容易出错的地方（如 JSON 中字符串内的双引号需转义）
输出后提醒用户："请复制上述代码块，不要手动修改标点符号。"
建议用户使用 JSON 校验工具（附链接）

对于已发生的语法错误

直接给出正确的完整代码块，让用户整段替换，而不是逐字修改
不要要求用户手动添加或删除逗号（他们很难找对位置）

四、适用范围

适用于 AI 在任何对话框中的代码输出
用户可随时提醒"请按修改规范输出"
规范可迭代（如增加新的 effect 类型时补充测试案例模板）

主要变更（V2.1）：增加删除操作的明确标注要求；增加金币、战斗、商店等说明（在数据格式规范中体现）。