SuperAPI AI 工具集

soia-pkm-clip-drive

通用与其它

查看项目

更新于 10-16 08:46

技能介绍

用途:把网盘或本地的存量资料(PDF、DOC/DOCX、PPT/PPTX、XLS/XLSX、TXT、Markdown)批量导入 Obsidian vault,属于 clip 家族的云盘成员,区别于抓网页,专注本地与云盘文件。

主要能力:按文件批量提取文本,生成资料笔记;资料/参考类落 <vault-resources-dir>/<主题>/,文章类落 <vault-articles-dir>/;原文件留到 _附件/。frontmatter 含 tags:[资料] 或 [文章摘抄]、source、original_path、captured_at、topics:[]。提取稿保留 source、original_path、source_sha256、extraction_method,随后由 soia-pkm-query-vault 搜索提取稿,不直接解析二进制正文。导入后必走 organize 分类、建 MOC、去重;只要新建 20 区文件,须重建 OB知识库地图.md 并用 vault_index_verify.py 验证 Base。

使用方式:用自然语言说明目标并提供文件或目录。安装推荐整套插件:claude plugin marketplace add soia-team/soia-open-skills,claude plugin install soia-pkm-vault@soia;单装本技能用 npx skills add soia-team/soia-open-pkm-vault-skills -g -a '*' -s soia-pkm-clip-drive -y。配置路径为 ~/.config/soia-skills/soia-pkm-clip-drive/config.yml,可用 SOIA_PKM_CLIP_DRIVE_CONFIG_FILE 指定自定义路径;不需要私有配置时可不创建。密钥、cookie、session 只能放私有配置、环境变量或 provider 登录态,不得写入仓库、vault 正文或日志。

限制:图片不能仅凭文件名当正文,需用户明确要求并有 OCR 后端,OCR 结果须标记 ocr、工具和人工核对状态。批量导入脚本待补充,提取与落地当前由 agent 按流程手工执行。落到 20_资料库/ 时目标语义目录须带唯一编号,不确定分类先停 Inbox 或交生命周期技能生成 manifest。缺依赖、权限、配置或 key 时停止外部动作并说明缺什么。WorkBuddy 需单独安装,见 docs/install/workbuddy.md。原文未提供第三方具体 OCR 工具与价格信息。