soia-pkm-alipan-curator 是一个面向阿里云盘的资源顾问技能，在 soia-pkm-alipan-drive-ops 原子操作之上提供方法论与产出能力，包含 inventory/organize/catalog/plan 四类工作流：盘点云盘、整理资源、生成 Obsidian 馆藏、增量 Excel 总索引与家庭课程导航，以及基于用户本次提供学情的学习计划。
【用途与触发】 除名称外，可识别说法包括「整理云盘」「云盘盘点」「更新云盘索引」「更新 Excel 总索引」「生成家庭导航 Excel」「给云盘建图书馆」。单个文件的浏览、下载或上传交给 soia-pkm-alipan-drive-ops。使用时以自然语言说明目标，并提供必要输入：文件、URL、repo、workspace、proposal、vault 或平台账号状态。能 dry-run 或预览的动作先给预览；涉及删除、覆盖、发送、发布、写远端状态时先征求确认。
【主要能力】
- inventory（盘点）：递归扫描到资源根或叶级终态，把核对清单写到用户显式指定的路径，每支记「内容 · 类型 · 建议动作」。没有输出参数时先询问，不猜 vault 目录。
- organize（整理）：执行规范包括先记录后动手、大型整理固定执行链、单写者执行云盘写入、终态验证等。整理动作涵盖去营销尾巴、去套娃、删广告候选、按查找目的选主轴、命名统一、编号可配置且必须闭环、长系列分组、SHA1 级查重、广告特征清理等。删除动作登记在 cleanup_batches，由原子层在用户授权与空壳验证后执行。
- catalog（索引落 OB）：调用 scripts/gen_catalog.py 从全盘扫描数据生成 00_馆藏总览（浏览）与 _全文检索/（检索），整理或移动后必须重跑刷新。支持 --merge-existing 做单分区增量、--roots 补入 file_id、--search-dir 刷新全文检索。
- plan（学习计划）：输入成绩截图或学情描述，流程为诊断（分数/排名/失分点/目标）→ 资源映射（弱项对应云盘索引资源并标注理由）→ 排期（视频查实集数与单集时长，按用户给出的可用时间、目标优先级和负担上限倒排）→ 落盘（写入 OB 学习计划目录，匿名代号文件名，状态「待确认」，用户拍板后转正）。
【正式脚本入口】 大型整理使用固定正式脚本：merge_classification_map.py（合并分类结论）、assign_resource_numbers.py（仅编号确认时）、build_reclass_plan.py（生成重分类计划）、build_structure_plan.py（生成结构计划）、preflight_reclass.py（执行前预检）、audit_run_bundle.py / audit_structure.py（审计）、apply_reclass.py / apply_reclass_bulk.py（可恢复执行，默认 dry-run，写调用默认节流 2 秒）、plan_series_chunks.py（长系列分组计划）、audit_catalog_publish.py（索引发布闭环审计）。不在运行包、临时目录或会话里另写同职能 builder。
【Excel 与交付物】 全盘/多分区馆藏总索引用 scripts/gen_catalog_xlsx.py；单个学习分区的家长说明与课程导航用 scripts/gen_family_nav_xlsx.mjs。Excel 总索引、家庭导航和学习计划是用户交付物，落盘目录按三级优先级：用户明确说出的路径 → 环境变量或私有 config 中的 ALIPAN_CURATOR_OUTPUT_DIR → 默认 <用户家目录>/Downloads/soia-pkm-alipan-curator/。Obsidian 馆藏 Markdown 例外，按馆藏区约定路径写入 vault。
【安装与配置】 推荐安装整个领域插件： claude plugin marketplace add soia-team/soia-open-skills claude plugin install soia-pkm-vault@soia 只要单个技能时可用 npx 路线： npx skills add soia-team/soia-open-pkm-vault-skills -g -a '' -s soia-pkm-alipan-curator -y 注意技能会落进共享真源 ~/.agents/skills；若同时装了插件会出现两份索引且各自漂移，建议二选一。配置约定：~/.config/soia-skills/soia-pkm-alipan-curator/config.yml，或环境变量 SOIA_PKM_ALIPAN_CURATOR_CONFIG_FILE=<custom-config-path>。若无需私有配置可不创建 config.yml。需要 API key、cookie、session、provider home 或本机路径时只能放进私有 config.yml、进程环境或 provider 自己的登录态。WorkBuddy 的装载单位是角色化专家而不是插件，npx skills add -a '' 覆盖不到，需单独安装，见 docs/install/workbuddy.md。
【依赖关系】 强依赖 soia-pkm-alipan-drive-ops：所有云盘读写、登录、扫描、移动、重命名都走该原子层。方法复用 soia-pkm-reading-plan 的「按真实体量排期」原则，不要求运行它。huashu-weread-advisor 与 weread-skills 仅为类比或非依赖，本技能不调用微信读书 API。book-to-skill / find-skills 为非依赖。
【私密信息与中间数据】 阿里云盘登录凭据留在 provider 自己的登录态或系统凭据存储中，本技能只通过原子层调用，不读取、复制或打印秘密值。移动计划、运行包、发布 manifest 和审计报告放在用户 state 目录；可重建的扫描解析与 Excel 增量缓存放用户 cache 目录；下载样本和渲染探针放 OS 临时目录并在成功或失败后清理。日志和回执只记录脱敏后的路径角色、数量、哈希和状态，不暴露用户名、本地私有绝对路径、账号标识或云盘凭据。
【限制与约束】 删除/覆盖必须有授权；同一索引文件只能有一个写入者；LIST_FAIL 不等于空目录；每条命令需显式 --driveId。重分类计划和恢复型执行器只接受 mkdir、mv、rename，遇到 delete/remove/trash 会在解析阶段拒绝。历史 cleanup debt 不得洗白、不可补造或事后倒填 authorized_at，只能单独登记为 legacy_process_debt 或 authorization_unproven_execution。结构写入后的云端索引上传是强制收官步骤，缺少发布 manifest、远端证据、版本一致性或旧 file_id 零引用证明时，audit_run_bundle.py --final 必须失败。第三方 skill 只能声明依赖和安装方式，不直接修改第三方 skill 文件。