搭建安全的代理工作目录

代理动作最终都落在某个工作目录上。干净、隔离、可回退的工作目录是运行安全的落地基础：它配合沙箱边界与审批策略，把误操作范围限制在可控容器内。本节给出安全工作目录的构成要素、开工前检查清单、隔离与回退习惯，以及常见风险规避方法。

一、安全工作目录的构成要素

要素	做法	作用
独立项目目录	每个项目有专属工作文件夹，多项目不共用一份脏工作区	改动不串项目、边界清晰
Git 干净基线	开工前 git status 确认无未提交混杂改动，基线可还原	每轮成果可归因、可回退
可复现依赖	依赖来源与锁定方式明确，安装过程可重建	环境一致、减少偶然性
临时产物隔离	构建、缓存、日志等临时文件落入约定目录并可清理/忽略	源码与产物不混淆提交
凭证外置	密钥与本地配置不放在会被提交的源码路径中	避免敏感信息入库
备份与版本节点	阶段性成果及时提交，重要操作前保留可还原基线	出错可快速回到可用状态

二、开工前检查清单

• 当前终端工作目录是否就是目标项目根目录，避免在错误位置启动。
• git status 是否干净；若有他人或历史遗留改动，先确认归属或处理基线。
• 项目依赖是否已按官方方式安装、可用检查命令能否跑通基线。
• 敏感配置与密钥是否放在仓库外的安全位置，源码中只有占位或引用。
• 本轮任务的修改范围（目录/文件类型）是否已在任务描述中限定。
• 是否存在需要保护的未备份数据，先做备份再允许写操作。

三、隔离与回退习惯

1. 改动集中在项目内：优先在工作区目录内完成修改，不直接改动系统级或其他项目文件。
2. 实验与主线分离：较大不确定性的尝试可用隔离副本或版本分支进行，验证成立后再合并，避免污染主线。
3. 小步固化：每完成一个可验证小目标就形成版本节点，使回退粒度最小化。
4. 未提交改动可放弃：方向错误的试验性文件用 git restore 还原，保持主线始终可用。
5. 清理临时产物：任务收尾前检查生成文件，按约定清理或忽略，避免把噪声提交进版本库。

四、常见工作区风险与对策

风险情形	后果	对策
在脏基线上开工	新旧改动混在一起，难以归因与回退	先整理基线，必要时提交或暂存现有改动
实验目录与正式目录混用	误把半成品当正式成果，污染发布	隔离副本/分支验证，达标后再合并
凭证或本地配置入库	密钥泄露、提交历史被污染	外置存储、检查 diff、使用忽略规则
临时文件被一并提交	仓库膨胀、diff 噪声大、干扰审阅	约定输出目录并配置忽略，提交前筛除
删除前无备份	不可恢复的数据或配置丢失	先确认备份与版本记录，再执行删除类动作
多任务并行改同一目录	相互覆盖、状态冲突	分目录或分版本线推进，避免并发写同一文件集

五、FAQ

问题	处理建议
工作区很乱还能直接开始新任务吗	先整理基线：提交有效改动、暂存或清理实验文件，干净后再开始。
临时文件很多如何不进提交	统一输出到约定目录并配置忽略规则，提交前用 git status 核对文件清单。
如何保证删除类操作安全	确认已有版本记录或备份、明确删除目标清单，并在审批环节单独授权。
多项目并行怎么避免互相干扰	各自独立目录与版本线，不共用工作区；切换项目前确认当前目录与基线状态。

六、动手练习

• 练习：按开工前检查清单逐项核对一个项目，记录不达标项并补齐；再为一次不确定的实验建立隔离副本/分支，验证后决定合并还是丢弃，体会小步可回退的收益。