# macOS Documents TCC 阻断 Cron 时的项目迁移方案 ## 何时使用 当 Hermes cron(launchd/systemd tick)访问 `~/Documents/...` 中的项目目录报: ```text PermissionError: [Errno 1] Operation not permitted shell-init: error retrieving current directory: getcwd: cannot access parent directories: Operation not permitted ``` 且无法/不便通过 GUI 给 Python 二进制添加 Full Disk Access 时使用本方案。 ## 核心思路 将项目整体移出受 TCC 保护的 `Documents`,在原地留下符号链接保持交互式入口,再把所有无人值守 cron job 的 `workdir`、prompt 和 checkpoint 更新到真实新路径。 ## 执行步骤 ### 1. 迁移目录 ```bash # 创建新父目录 mkdir -p /Users/$USER/Projects/lemonAI # 迁移项目(保留 .git、未提交改动和 untracked 文件) mv /Users/$USER/Documents/lemonAI/graphagent /Users/$USER/Projects/lemonAI/graphagent # 在原地留下符号链接,保持交互式入口和旧书签/IDE 可用 ln -s /Users/$USER/Projects/lemonAI/graphagent /Users/$USER/Documents/lemonAI/graphagent ``` 注意:不要把 cron 的 `workdir` 继续指向符号链接。后台进程经过 `Documents` 目录解析符号链接时仍可能触发 TCC。 ### 2. 更新 cron job 的 workdir qa profile: ```bash hermes -p qa cron edit --workdir /Users/$USER/Projects/lemonAI/graphagent/doc hermes -p qa cron edit --workdir /Users/$USER/Projects/lemonAI/graphagent/source ``` 若 job 分散在 code / planning profile: ```bash hermes -p code cron edit --workdir /Users/$USER/Projects/lemonAI/graphagent/source hermes -p planning cron edit --workdir /Users/$USER/Projects/lemonAI/graphagent/doc ``` ### 3. 更新 prompt 中的旧路径 workdir 只能保证工具默认目录正确;如果 prompt 中硬编码了旧路径,agent 仍可能主动 `cd` 到旧路径。 批量替换各 profile `cron/jobs.json` 中的路径字符串: ```python import json import glob import os old_root = f'/Users/{os.environ["USER"]}/Documents/lemonAI/graphagent' new_root = f'/Users/{os.environ["USER"]}/Projects/lemonAI/graphagent' for path in glob.glob(f'/Users/{os.environ["USER"]}/.hermes/profiles/*/cron/jobs.json'): with open(path, 'r+', encoding='utf-8') as f: text = f.read() new_text = text.replace(old_root, new_root) if new_text != text: f.seek(0) f.write(new_text) f.truncate() print(f'updated {path}') ``` ### 4. 更新 checkpoint workdir Hermes checkpoint 中缓存了会话 workdir。恢复到旧路径的 checkpoint 会让 agent 从 Documents 目录启动: ```python import json import glob import os old_root = f'/Users/{os.environ["USER"]}/Documents/lemonAI/graphagent' new_root = f'/Users/{os.environ["USER"]}/Projects/lemonAI/graphagent' for path in glob.glob(f'/Users/{os.environ["USER"]}/.hermes/profiles/*/checkpoints/store/projects/*.json'): with open(path, 'r+', encoding='utf-8') as f: data = json.load(f) if isinstance(data, dict) and isinstance(data.get('workdir'), str): old = data['workdir'] new_wd = old.replace(old_root, new_root) if new_wd != old: data['workdir'] = new_wd f.seek(0) json.dump(data, f, ensure_ascii=False, indent=2) f.truncate() print(f'updated {path}: {old} -> {new_wd}') ``` ### 5. 更新 profile AGENTS.md 中的共享入口 例如 `/Users/$USER/.hermes/profiles/qa/AGENTS.md` 中若有: ```markdown - 共享入口:`/Users/$USER/Documents/lemonAI/graphagent` ``` 替换为新路径。 ### 6. 验证 手动触发一次 cron job: ```bash hermes -p cron run ``` 或 Hermes cron 工具:`cronjob` 的 `action='run'`。 检查输出中不再出现 `Operation not permitted`、`getcwd` 失败、`PermissionError` 等 TCC 相关错误。真实证据: - agent log 中 `read_file` 成功返回新路径下的文件内容; - terminal 工具能正常 `cd`、执行 `git status`、跑测试; - 等待一个自然周期,确认 `last_run_at` 推进、`last_status=ok`。 ### 7. 检查被暂停的 cron job 大规模路径变更后,Hermes 可能自动把 job 置为 `paused`。检查并恢复: ```bash hermes -p qa cron list hermes -p qa cron resume ``` ## 不要做什么 - 不要把 workdir 继续指向符号链接并期望 TCC 放行; - 不要只更新 workdir 而忽略 prompt 和 checkpoint; - 不要把交互式终端的成功当作后台 cron 已通的证据; - 不要删除旧目录里的 symlink(否则旧入口、IDE 配置、其他脚本会断)。