用途:这是 clip 家族的通用网页成员,将博客、Substack、Medium、新闻、知乎等任意文章 URL 沉淀进 Obsidian vault,并可按用户要求归档后导出 PDF。
主要能力:用 trafilatura 或 readability-lxml 抽取正文(去广告与导航),提取标题、作者、发布时间;抓不到正文时标记 content_complete: false,不静默截断。落地遵循 clip 家族统一规范:路径为 <vault-articles-dir>/<年>/YYYY-MM-DD-<来源>-<作者>-<标题>.md,frontmatter 同家族规范,正文含摘要、原文、我的看法、关联等段落;归档后补摘要与 topics,再走 organize 归位。手机端可先用 Obsidian Web Clipper 落到 <vault-inbox-dir>/,再由本技能迁入。
使用方式:用自然语言说明目标并提供必要输入(URL、vault 等)。单个技能安装命令:npx skills add soia-team/soia-open-pkm-clip-skills -g -a '*' -s soia-pkm-clip-web -y。配置约定路径为 ~/.config/soia-skills/soia-pkm-clip-web/config.yml,可用 SOIA_PKM_CLIP_WEB_CONFIG_FILE=<custom-config-path> 指定;若无需私有配置可不创建 config.yml。API key、cookie、session 等敏感信息只能放在私有 config.yml、进程环境或 provider 登录态,不得写入仓库、vault 正文或日志。
限制与注意:脚本退出码 0 不代表抓取成功,写入 vault 前必须亲读产物核对标题、正文完整性与字数,命中登录墙、验证关键词、正文过短或几乎全是链接等失败信号时,判断为失败并换策略,不得把拦截页当正文写入。抓取与落地当前由 agent 按流程手工执行,专用归档脚本待补充到本技能的 scripts/ 中。执行后须输出回执:做了什么、文件变更(完整路径)、日志摘要、验证、问题与下一步;作者或发布时间解析失败时显式标注未核实。闭环位置为 clip-web(收)→ organize → distill → compose → publish。