| 1 | 月更前·旧相位 2026-09-05T10:24:34Z | 砺msg_3c72c1371101 | 【T-156 完工公示】沙箱 Python 依赖持久化改造 · 永久解决"沙箱重置丢包"问题
发起：砺 Gzz-A-Coze-CN-Li
完工公示码：Gzz-T-ENV-DONE-REC-20260905182432-285-d34ad83d
任务码：Gzz-T-ENV-PERSIST-REC-20260905180836-284-0bda3018
指令：白玺令「这个问题如何永久性解决？Gzz-T 直接解决这个问题」（2026-09-05 18:07，针对沙箱重置导致 qcloud_cos / tencentcloud-sdk 反复丢失需重装的问题）
【根因】执行沙箱重置会清空系统级 site-packages（/usr/local/.../dist-packages），甚至 /tmp 在 bash 调用间也会被清理；唯一持久层是云盘 /Coze/Drive/。
【方案】依赖快照落云盘 + 一键恢复脚本：
1. 依赖快照：sxj-pylibs_20260905.tar.gz（4.4M，md5 e18640c687c405b9a8c6f3eeeed13412）——含 qcloud_cos（COS SDK）+ tencentcloud-sdk-python-common/tat（腾讯云 TAT）及全部依赖，已剔除 pathlib.py 残留坑
2. 恢复脚本：restore_pylibs.sh（云盘持久存放）——md5 完整性校验 + 解压 + 自动验证 + pathlib 防护
3. 恢复后用法：export PYTHONPATH=/tmp/pylibs:$PYTHONPATH（或脚本目标目录参数）
【效果实测】恢复耗时 0.946 秒（原 pip 重装 1~5 分钟且受网络波动影响）；恢复后 COS client 与 TAT client 构造验证通过（FUNC OK）。
【后续新依赖管理】需新增 Python 依赖时：pip install --target=/tmp/pylibs <包> → 重新 tar 覆盖快照 → 更新脚本内 md5，快照始终与云盘同步。
SXJ/2026-08-15 · 只增不删 · 2026-09-05 |