用途：把文稿（尤其是脚注、参考文献）里的 URL 提交到 perma.cc，生成永久、可被法院引用的归档快照。
主要能力与命令（脚本路径 PC="${CLAUDE_SKILL_DIR}/scripts/permacc.py"）： uv run --script "$PC" status —— 查看密钥归属及是否存在赞助文件夹 uv run --script "$PC" folders —— 列出所有文件夹，标出赞助文件夹 uv run --script "$PC" archive URL... --auto-folder —— 归档并自动选用赞助文件夹 uv run --script "$PC" archive --from-json inventory.json --out archives.json --auto-folder —— 从 JSON 批量归档 uv run --script "$PC" verify --out archives.json —— 复核已有记录的抓取状态 uv run --script "$PC" delete --out archives.json --failed --private-if-undeletable —— 删除失败项，不可删则转为私有
用法要点：--auto-folder 自动解析赞助文件夹；--folder <id> 在有多个文件夹时固定其一；--out 让运行可断点续传，已归档 URL 会被跳过。密钥读取顺序为 --api-key、PERMACC_API_KEY、PERMACC_API_KEY_FILE。文件夹必须放在 JSON body 字段，放在 ?query= 会被静默忽略并计入个人配额。认证方案是 ApiKey 而非 Bearer；文件夹列表键是 top_level_folders；赞助挂在文件夹而非组织上。
限制与陷阱：免费个人额度为每月 10 条链接；HTTP 201 只表示生成了链接，抓取仍可能失败（SSRN 因 Cloudflare 常失败，此时应引用原始 URL）；链接 24 小时内可删，之后 DELETE 返回 403，只能设为私有；private_reason 是封闭枚举，user 表示不再公开；归档不幂等，重复 POST 会产生多条链接。