# Companion 文件清理修复方案（待 WeiWei 实施）

## 问题
cleanup cron (`contract-cleanup.py`) 只删 tracker 里有记录的文件。审查意见、合同流程单等 companion 文件按规则不单独写 tracker，主合同被清理后 companion 成为孤儿，永远留在 `任务交付/`。

## 2026-06-29 实证
清理了 11 个 orphan companion 文件（6个合同流程单 xlsx、5个审查意见 docx），最老的残留 91 小时。

## 修复方案（方案 A，推荐）

### 1. pass workflow (skill) 改动
步骤1写 tracker 时，扫描 `任务交付/` 目录，找到与主合同同名的 companion 文件，写入 `companion_files` 字段。

### 2. cleanup 脚本改动
删主合同时，读 `companion_files` 字段，一并删除。

## .doc 原始文件残留修复

cleanup 删 `original_filename` 时，如果文件不存在，尝试同名但换扩展名（.doc 换 .docx 或反之）。

## 状态
- 2026-06-29：方案已提交给 WeiWei 讨论
- 待 WeiWei 确认后实施代码改动