---
{
  "title": "修改与编辑模块：指令写法、错误账本与版本回滚",
  "description": "模块上线后照样可以持续修改。本文按修改类型给出可直接照抄的指令写法，讲清每次修改后如何验证、错误账本的状态流转，以及如何用版本日志把模块整体回滚到任意历史版本。",
  "date": "2026-09-03",
  "tags": ["AI构建器", "修改", "版本回滚"],
  "group": "构建器详解",
  "order": 2,
  "author": "Inkwell 团队"
}
---

Inkwell 的模块不是「生成交付就结束」的静态产物——业务变了，回到构建器继续说就行。本文覆盖修改模块的全部路径：从哪进入、怎么说、改完怎么验、出错怎么办、怎么回滚。

## 一、进入修改状态的三条路径

1. **原会话继续**（推荐）：从会话列表打开当初的会话，上下文最完整；
2. **从模块列表打开**：AI Studio「模块」标签 → 模块卡片「打开」→ 自动接续该模块最近会话；
3. **从详情页进入**：模块「详情」→「继续编辑」，跳转工作台并接续会话。

三条路径殊途同归：修改指令始终在**会话**里下达，AI 基于模块当前版本做增量修改。

## 二、按修改类型选指令写法

所有修改都遵循同一句式：**对象 + 改成什么 + 约束（可选）**。逐类给模板：

**改数据模型**（影响数据库结构与接口）：

```
给设备台账加两个字段：上次保养日期（date，可为空）、保养周期天数（整数，默认 90）。
```

```
把「责任人」从手填改成从用户列表选择。
```

**改页面**（列、筛选、表单、布局）：

```
列表加一列显示保养状态，超过保养周期还没保养的行标红。
```

```
筛选栏去掉更新时间，新建按钮改成只对管理员可见。
```

**改行为**（默认值、校验、权限）：

```
设备编号改成必填且唯一，保存时重复要提示「编号已存在」。
```

**删东西**：明确说删什么、删掉后相关数据怎么办：

```
删除「备注」字段，历史数据里的备注先导出一份再删。
```

更多措辞模式与反例改写见[给 AI 下指令的模式库](ai-instruction-patterns.html)。

## 三、改完之后的两道验证

**第一道：预览即时确认。** AI 每次交付后右侧预览自动刷新，立即在预览里把被修改的路径点一遍。涉及数据模型的修改，AI 会先同步测试库结构，预览里的新建/编辑表单即为最终形态。

**第二道：错误账本。** 顶栏「N 项待修」红标是模块错误账本的未解决计数。点开可见每条错误的来源（前端/后端）、发生次数、最近时间，按状态过滤（未解决/待处理/已确认/修复中/已解决/已忽略）。

![错误账本：状态统计、来源过滤与每条错误的次数与时间](../assets/docs/builder-error-ledger.png)

错误账本的状态流转：

- AI 或运行时捕获到问题 → 记为**未解决**，相同问题按指纹累计次数不重复建条；
- 点「让 AI 修复全部」→ AI 逐条修复，修复中的条目进入**修复中**；
- 修复经重新测试后标记**已解决**；确认是误报或可接受的，可手动标记**已忽略**；
- 底部「全部已修复」用于人工修复完成后批量核销。

**发布拦截面**：存在未解决错误时发布会失败并给出原因（见[模块的测试与发布](module-test-publish.html)），错误账本清零是发布的硬前提。

## 四、版本系统：每次交付一个版本，随时整体回滚

AI 对模块的每次成功交付（新建、修改、修复）都会记为一个新版本，可在模块详情页的「版本日志」里看到完整时间线：版本号、产出说明、时间。

![版本日志：v2 到 v7 的完整时间线，每个历史版本都有整体回滚按钮](../assets/docs/builder-version-log.png)

- **回滚操作**：版本日志中找到目标版本 → 点该行的「整体回滚」→ 模块整体恢复到该版本的状态（页面、接口、数据模型一起回滚）；
- **版本不可变**：回滚不删除任何历史版本，回滚本身也会产生新版本，所以不存在「回滚滚丢了」的风险；
- **典型场景**：一轮多步修改后发现问题相互纠缠，与其逐条描述修正，不如整体回滚到上版本，用更准确的指令重来一次。

## 五、已发布模块的修改流程

已上线的模块同样按上述方式修改，闭环多一步：

1. 在会话里下达修改指令，AI 在测试环境交付；
2. 测试环境验证通过（预览 + 错误账本清零）；
3. 重新发布。重新发布保持菜单位置与路由不变，生产环境**热更新生效，不中断访问**；生产数据不受影响，涉及数据结构的变更由发布流程自动处理。

## 六、注意事项

- **删除字段是敏感操作**：先导出或确认无价值再删；AI 对删除类指令会额外确认，回答时要明确；
- **一次别堆太多修改**：单条消息里塞五六个不相关改动，返工率显著上升；拆成多轮，每轮验收；
- **权限相关修改说清角色**：「只对管理员可见」要对应到[角色与权限配置](roles-permissions.html)里的具体角色名；
- **修改不改动测试数据**：测试库数据在结构变更后保留（新增字段旧行为空），需要刷新数据用 Excel 重新导入（见[用 Excel 一步建模块](excel-to-module.html)）。