（2918期）File Writer – 大文件零截断安全写入指南

大文件零截断安全写入指南 提供大文件安全写入策略，避免截断问题，含分步操作、阈值指南与错误恢复方案，适合5000字节以上文件操作。 使用说明 核心用法 file-writer 是一套针对大文件（>5000 字节）的安全写入策略框架，而非单一工具调用。其核心工作流为四步循环：读取当前状态 → 精准编辑修改 → 验证结果 → 重复直至完成。该 skill 强调使用 edit 工具替代 write 工具进行增量修改，并提供了详细的安全阈值表：新建文件 <2000 字节可直写，2000-5000 字节为中等风险，>5000 字节必须使用分块策略；编辑操作则以 500 字节为安全线，>1000 字节需采用标记分段法。 显著优点 系统性风险管控：明确量化截断风险阈值，将抽象的"大文件问题"转化为可执行的操作规则 多层级回退策略：提供 4 种 fallback 方案（分块写入、唯一标记、增量构建、备份恢复），覆盖从网络中断到工具限制的各类故障场景 精准定位机制：强调 edit 工具的精确匹配特性，配合唯一标记（如 <!-- SECTION_START -->）实现复杂内容的安全替换 验证闭环设计：每次修改后要求验证文件大小、行数、尾部完整性，避免"静默截断" 潜在局限 操作复杂度高：相比直接 write，需多次工具调用和人工验证，简单场景下效率损失明显 依赖环境一致性：oldText 精确匹配要求文件内容稳定，并发修改或编码差异易导致匹配失败 无自动化保障：策略本身依赖用户严格执行，缺乏强制校验机制，存在"知道但未做到"的执行 gap 阈值静态化：5000/500 字节等阈值基于经验假设，未考虑具体运行时的内存/网络环境差异 适合人群 需要频繁操作大型 Markdown/配置文件的开发者 在不稳定网络环境或受限沙箱中工作的用户 对数据完整性要求极高的关键文件维护者 遭遇过文件截断问题、需要系统性解决方案的技术人员 常规风险 | 风险类型 | 等级 | 说明 ||---------|------|------|| 文件截断 | 高 | 未遵循策略时，大文件写入可能中断导致数据丢失 || 编辑匹配失败 | 中 | oldText 不匹配会阻断操作，需重新读取定位 || 增量不一致 | 中 | 多步骤修改中若未逐步验证，可能出现中间状态错误 || 备份覆盖 | 低 | 频繁备份策略若管理不当，可能浪费存储或混淆版本 | 该 skill 属于防御性编程指南，本身无代码执行风险，但执行效果高度依赖用户对策略的理解与遵守程度。 原始说明 Safely write or update large files over 5000 bytes by reading, incrementally editing small sections, verifying each change, and using fallback recovery methods.