修改与编辑模块：指令写法、错误账本与版本回滚

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

更多措辞模式与反例改写见给 AI 下指令的模式库。

三、改完之后的两道验证

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

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

错误账本的状态流转：

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

发布拦截面：存在未解决错误时发布会失败并给出原因（见模块的测试与发布），错误账本清零是发布的硬前提。

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

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

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

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

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

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

六、注意事项

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