Appearance
文件、工作区、路径与产物排障
适用症状
任务说找不到文件、读取结果为空、路径含中文或空格时失败、保存提示权限不足、产物出现在意外目录、输出重复或原文件被覆盖，都先判断是“文件不存在”“工作区不对”“权限不足”还是“任务状态不明”。
快速诊断
保存任务名称、实际工作区路径、文件名/扩展名、文件是否存在、最近一次成功操作、当前账号和完整错误。不要先移动、重命名、删除或覆盖原文件；用只读方式确认目录和文件元数据。
检查顺序
- 确认工作区： 看当前任务真正使用的目录，不以资源管理器最后打开的位置或聊天中写过的路径为准。
- 确认文件存在： 核对完整路径、大小、扩展名、大小写、中文字符和是否被其他程序移动或锁定。
- 确认访问权限： 用当前账号对测试文件执行读取和写入到新文件的最小动作，不对原文件直接覆盖。
- 确认输入版本： 多份同名文件、云同步冲突或迁移后目录可能有多个版本，先标出主版本和时间。
- 确认输出位置： 检查任务要求、实际生成目录、文件命名和是否有临时文件；不把“聊天里出现链接”当成产物已经落盘。
修复路径
找不到文件或路径错误
把任务切换到一个短、清楚、已授权的测试目录，用一个已知文件做读取验证。通过后再逐层恢复原目录，避免一次性给出整个磁盘或客户资料目录。
无法保存或被占用
先保存到新文件和独立输出目录，确认文件没有被编辑器、同步工具或其他任务占用。若企业策略限制写入，交给管理员调整批准目录，不要绕过安全策略。
产物重复或版本不明
停止自动化和外部写入，保留目录清单、时间线和文件哈希/大小等可比信息，指定主版本。确认上一次任务是否已经成功，再决定合并、回退或重新生成。
迁移后工作区失效
核对账号、客户端、路径、权限和目标设备，回到账号与工作区迁移的样本任务流程。不要在没有备份的情况下清理旧目录。
验证是否恢复
- 测试账号可以在预期工作区读取已知文件；
- 写入只产生新文件或草稿，原文件保持不变；
- 输出路径、文件名、版本和来源可以复核；
- 多次运行不会产生不可解释的重复产物；
- 任务完成后能关闭临时目录、权限或连接器，并保留必要诊断记录。
不要做什么
- 不要先给整个磁盘、共享盘或客户目录开放读写；
- 不要用模型生成缺失文件、猜测路径或补齐未读取的数据；
- 不要为了“清干净”删除原文件、备份、日志或迁移包；
- 不要把本地可见路径、客户文件名和完整日志直接发到公开渠道。
停止与求助信息
若发现原始资料丢失、未经授权的写入、重复覆盖、路径指向陌生目录、权限越界、同步冲突无法判断主版本或疑似数据泄露，立即停止任务。保留原目录、备份、错误、时间和影响范围，由资料负责人、企业管理员或当前官方支持处理。
相关内容
来源与版本说明
- SRC-UPSTREAM-CH03：任务、工作区和路径边界。
- SRC-UPSTREAM-CH12：只读扫描、预览、人工确认和文件回退方法。
- SRC-UPSTREAM-CH02：安装、更新和迁移后的环境核对。
- 内容版本：
0.1.0 - 最后核对日期：
2026-09-26