soia-pkm-alipan-curator 是一个阿里云盘资源顾问技能，在 soia-pkm-alipan-drive-ops 原子操作层之上提供 inventory/organize/catalog/plan 四类工作流：盘点云盘、整理资源、生成 Obsidian 馆藏、增量 Excel 总索引与家庭课程导航、基于本次用户提供的学情生成学习计划。
主要能力
- inventory（盘点）：递归扫描到资源根或叶级终态，把核对清单写到用户显式指定的路径，每支记录「内容 · 类型 · 建议动作」，用户拍板后交 organize。没有输出参数时先询问，不猜 vault 目录。
- organize（整理）：去营销尾巴、去套娃、删广告、按查找目的选主轴、命名统一、分区边界句、不确定项隔离复核。大型整理按固定执行链推进：merge map → assign numbers（可选）→ build reclass → build structure → preflight → audit → dry-run → execute → fresh terminal scan → refresh OB/Excel → publish cloud catalog → final audit；任何一步失败即停在该步。
- catalog（索引落 OB）：调用 scripts/gen_catalog.py 生成 00_馆藏总览与 _全文检索/，整理或移动后必须重跑刷新，支持按分区 --merge-existing 增量更新。
- plan（学习计划）：从成绩单或学情描述诊断弱项，映射到云盘索引中的对应资源，按用户给出的可用时间、优先级和负担上限倒排周计划，落盘为状态「待确认」的计划文件，用户拍板后转正。
使用方式
- 安装单个技能：npx skills add soia-team/soia-open-pkm-clip-skills -g -a '*' -s soia-pkm-alipan-curator -y
- 配置约定：~/.config/soia-skills/soia-pkm-alipan-curator/config.yml；也可用 SOIA_PKM_ALIPAN_CURATOR_CONFIG_FILE 指定自定义配置路径。不需要私有配置时可不创建 config.yml。
- 用自然语言说明目标并提供必要输入（文件、URL、repo、workspace、proposal、vault 或平台账号状态）。
- 能 dry-run 或预览的动作先给预览；涉及删除、覆盖、发送、发布、写远端状态时先征求用户确认。
- 最终回复给出可见总结：做了什么、日志摘要、文件变化、问题和下一步。
输出与中间产物
- Excel 总索引、家庭导航和学习计划等用户交付物：优先写用户明确说出的路径；否则读环境变量或私有 config.yml 中的 ALIPAN_CURATOR_OUTPUT_DIR；都没有时默认写入 <用户家目录>/Downloads/soia-pkm-alipan-curator/，并向 stderr 提示可用 --output-dir 或配置覆盖。禁止写入 vault 根 outputs/、<session-uuid> 命名目录或 cwd 相对路径。
- Obsidian 馆藏 Markdown（inventory/catalog 的 md 产物）作为产品特性，按馆藏区约定路径写入 vault。
- 运行包与审计报告放入 ${XDG_STATE_HOME:-$HOME/.local/state}/soia-pkm-alipan-curator/ 下的 runs/moves 目录；解析缓存放 ${XDG_CACHE_HOME:-$HOME/.cache}/soia-pkm-alipan-curator/catalog-xlsx/。
- 私密信息（API key、cookie、session、本机路径）只能放在私有 config.yml、进程环境或 provider 登录态中。
依赖关系
- soia-pkm-alipan-drive-ops：强依赖，所有云盘读写、登录、扫描、移动、重命名都走该原子层。
- soia-pkm-reading-plan：方法复用，学习计划排期沿用其「按真实体量排期」原则，不要求运行它。
- huashu-weread-advisor、weread-skills、book-to-skill、find-skills：非依赖。
Excel 与索引要点
- 全盘/多分区馆藏总索引由 scripts/gen_catalog_xlsx.py 产出；单个学习分区的家长说明与课程导航由 scripts/gen_family_nav_xlsx.mjs 产出。
- 全盘输出为轻量 00_阿里云盘馆藏总索引.xlsx 加相邻的每分区明细工作簿；默认按每份 _全文检索/*.md 的 SHA-256 增量刷新，未变化分区不改写。首次生成或规则整体升级才用 --force。
- Excel 作者层优先复用宿主提供的 @oai/artifact-tool，缺失时退回内置 openpyxl；可通过 --renderer {auto,artifact-tool,openpyxl} 选择。交付验收加 --verify，有 soffice 时传入以预计算链接显示值。
- 家庭导航先上传并复核，再做终态扫描与总索引。
适用场景与限制
适用于需要盘点、整理、建馆藏索引或按学情生成学习计划的阿里云盘用户，尤其是覆盖完整一级分区、多个二级分区的全区分深度重组场景。限制方面：执行云盘 mv/rmdir 前必须先把移动清单落盘到指定路径，不允许先动手再补记录；删除动作需登记到 cleanup_batches，并在用户授权与新鲜空壳验证后由原子层执行；批量云盘写入始终单写者，--max-parallel 只能为 1；涉及结构写入的运行包在云端索引发布证据通过前只能标记 pending_catalog_publish。关于本技能的具体收费、价格与更多平台支持信息，资料中暂未提供。