AI批量改文件先比SHA：编辑期间变动的文件暂停处理

{
  "files": [
    {
      "name": "a.txt",
      "text": "旧稿A：将于周一发布。"
    },
    {
      "name": "b.txt",
      "text": "旧稿B：将于周二发布。"
    }
  ],
  "instruction": "将旧稿改成简短提醒，保留各自发布日。"
}

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python run.py

{
  "model": "gemini-2.5-flash-lite",
  "messages": [
    {
      "role": "system",
      "content": "严格只输出单个JSON对象，不要Markdown代码围栏，不要解释。只输出JSON：changes数组，恰好两项，每项name、text，name保留a.txt/b.txt。不输出路径，不执行写入；程序会核对预览时SHA和最新文件。"
    },
    {
      "role": "user",
      "content": "任务约束（只输出JSON对象，不用代码围栏）：\n只输出JSON：changes数组，恰好两项，每项name、text，name保留a.txt/b.txt。不输出路径，不执行写入；程序会核对预览时SHA和最新文件。\n待处理合成材料：\n{\"files\": [{\"name\": \"a.txt\", \"text\": \"旧稿A：将于周一发布。\"}, {\"name\": \"b.txt\", \"text\": \"旧稿B：将于周二发布。\"}], \"instruction\": \"将旧稿改成简短提醒，保留各自发布日。\"}"
    }
  ],
  "temperature": 0,
  "max_tokens": 1536,
  "provider": {
    "sort": "success_rate"
  },
  "response_format": {
    "type": "json_object"
  }
}

plan = json.loads((folder / 'planned-sha.json').read_text())
planned = {r['name']: r['sha256'] for r in plan}
changes = output.get('changes', [])
check('改稿限定两个既有文件', {r.get('name') for r in changes} == {'a.txt', 'b.txt'} and len(changes) == 2)
written = []
conflicts = []
audit = []
target = folder / 'updated'
target.mkdir(exist_ok=True)
for row in changes:
    name = row.get('name')
    source = folder / 'source-files' / str(name)
    if name not in planned or Path(str(name)).name != name:
        conflicts.append({'name': name, 'reason': 'not-allowlisted'})
        continue
    actual = sha(source)
    if actual != planned[name]:
        conflicts.append({'name': name, 'reason': 'sha-changed'})
        audit.append({'name': name, 'planned_sha': planned[name], 'actual_sha': actual, 'action': 'blocked'})
        continue
    text = row.get('text', '')
    temp = target / (name + '.tmp')
    temp.write_text(text)
    temp.replace(target / name)
    written.append(name)
    audit.append({'name': name, 'planned_sha': planned[name], 'actual_sha': actual, 'action': 'write-copy'})
check('仅未变动a写入副本，b冲突保留', written == ['a.txt'] and any((r['name'] == 'b.txt' and r['reason'] == 'sha-changed' for r in conflicts)))
check('原a和用户改动b都未覆盖', sha(folder / 'source-files/a.txt') == planned['a.txt'] and (folder / 'source-files/b.txt').read_text() == '用户在预览后手动修改B，请保留。')
check('本地路径穿越负例被拒绝', Path('../escape.txt').name != '../escape.txt')
write_csv(artifact('write-plan.csv'), audit, ['name', 'planned_sha', 'actual_sha', 'action'])
dump(artifact('conflicts.json'), conflicts)
artifacts.append('updated/a.txt')
result = {'writtenCopies': written, 'conflicts': conflicts, 'originalFilesPreserved': True}

{
  "writtenCopies": [
    "a.txt"
  ],
  "conflicts": [
    {
      "name": "b.txt",
      "reason": "sha-changed"
    }
  ],
  "originalFilesPreserved": true
}