SuperAPI AI 工具集

soia-pkm-clip-drive

办公与效率

查看项目

更新于 10-16 09:30

技能介绍

用途:面向网盘与本地存量资料的批量导入技能,属于笔记收集环节。与抓取网页不同,它处理本地或云盘上的 PDF、DOCX、TXT、Markdown 文件,把内容落入 Obsidian vault 并生成可后续整理的笔记。典型触发为「导入云盘资料」「把这批 PDF 导进来」「clip 这个文档」「整理云盘」。

主要能力:按输入的文件路径或目录做目录级批处理,每个文件生成一篇笔记;用 pypdf、pdfplumber 提取 PDF 文本,用 python-docx 提取 Word 文本;原文件保留到 _附件/;按类别落地,资料/参考类放入 <vault-resources-dir>/<主题>/,文章类放入 <vault-articles-dir>/,目录由配置或 CLI 参数决定;写入 frontmatter,包含 tags:[资料] 或 [文章摘抄]、source、original_path、captured_at、topics:[] 等字段;导入后建议衔接 organize 做分类、建 MOC 与去重。

使用方式:单个技能安装命令为 npx skills add soia-team/soia-open-pkm-clip-skills -g -a '*' -s soia-pkm-clip-drive -y。配置默认路径是 ~/.config/soia-skills/soia-pkm-clip-drive/config.yml,也可用环境变量 SOIA_PKM_CLIP_DRIVE_CONFIG_FILE 指定自定义配置文件;无需私有配置时可不创建 config.yml。API key、cookie、session、provider home 或本机路径只能放在私有 config.yml、进程环境或 provider 登录态中,不得写入仓库、vault 正文或日志。执行时先判断是否命中本技能,再检查依赖、配置、权限与风险动作;能 dry-run 或预览的先给预览,涉及删除、覆盖、发送、发布、写远端状态时先征求确认;完成后校验真实输出,并按「做了什么、文件变更、下一步」等格式给出可见回执,缺依赖、权限、配置或 key 时明确说明缺失项。

适用场景与限制:适合把大批量、来源繁杂的存量文档快速变成 vault 笔记并送整理流程。提取与落地当前由 agent 按流程手工执行,专用批量导入脚本尚待补充到本 skill 的 scripts/;强依赖、可选依赖与第三方 skill 关系以该 SKILL.md 后续说明为准,资料未提供部分暂未提供。元数据不确定时需在回执中标注未核实。