SuperAPI AI 工具集

soia-pkm-clip-web

通用与其它

查看项目

更新于 10-16 08:08

技能介绍

用途:把任意网页或博客文章一键归档到 Obsidian vault,并可按 clip 家族规范整理;当用户要求「归档并转 PDF」时,归档后优先调用 Obsidian 自带导出 PDF。

主要能力:抓取任意文章 URL(博客、Substack、Medium、新闻、知乎等);用 trafilatura 或 readability-lxml 抽取正文并去广告/导航,提取标题、作者、发布时间;抓不到正文时标 content_complete: false,不静默截断。落地路径为 <vault-articles-dir>/<年>/YYYY-MM-DD-<来源>-<作者>-<标题>.md,frontmatter 同 clip 家族,正文含 ## 摘要 / 原文 / 我的看法 / 关联;归档后补摘要与 topics,并走 organize 归位。手机端可用 Obsidian Web Clipper 落到 <vault-inbox-dir>/,再由本技能迁入。

使用方式:安装命令为 npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-clip-web -y。配置约定路径 ~/.config/soia-skills/soia-open-skills/soia-pkm/soia-pkm-clip-web/config.yml,也可用环境变量 SOIA_PKM_CLIP_WEB_CONFIG_FILE=<custom-config-path>;无私有配置时可不创建 config.yml。抓取与落地当前由 agent 按流程手工执行,专用归档脚本待补充到 scripts/。

限制:脚本退出码 0 不等于成功,写入前须人工核对标题、正文完整性与字数,命中登录墙、验证关键词、正文过短或几乎全是链接即判定失败并换策略。API key、cookie、session 等只能放入私有配置、环境或 provider 登录态,不得写入仓库、vault 正文或日志。导出 PDF 仅在目标文件位于 Obsidian vault 内时优先用 Obsidian 自带功能,外部引擎为降级方案。

流程定位:★clip-web(收) → organize → distill → compose → publish。缺依赖、权限或配置时停止相关动作并说明缺少内容,不猜测。