SuperAPI AI 工具集

doc-vault-save

写作与研究

查看项目

更新于 10-16 01:18

技能介绍

用途:把对话中已存在的结构化内容持久化到 Obsidian 库,不负责研究或生成内容。

前置条件:需已配置 doc-obsidian 技能,其提供通过 notesmd-cli 的库增删改查与 qmd 搜索能力。每次保存前先运行 VAULT=$(notesmd-cli print-default --path-only) 和 qmd status,任一失败则停止并提示先配置 doc-obsidian。

工作流:设置→检测内容类型→命名与路由→去重检查→构建笔记→保存→生成 wikilink→重建索引确认。内容类型分 res-deep(含 Framework 头与 Research Statistics 页脚)、res-price-compare(含 PLN/EUR 价格表与 TOP 3 等)、generic(其余),可用“save as research”等指令强制指定。命名采用 kebab-case、小写、无特殊字符、最长 60 字符;res-deep 与 res-price-compare 默认存入 research/ 文件夹,generic 存库根目录,可用“save to {folder}”覆盖。保存前需展示名称与文件夹供确认。

去重:用 qmd search 与 notesmd-cli print 检查同名或相似主题笔记,按结果选择新建、覆盖、追加或加 -2/-3 后缀,并展示已有笔记日期。保存用 notesmd-cli create,支持 --overwrite 与 --append;更新特定段落时先 print 再用编辑工具;内容超约 100KB 时改用 Write 工具直接写入。保存后更新 frontmatter 日期(notesmd-cli fm)。

wikilink:用 qmd vsearch 找相关笔记,排除刚保存的与得分低于 0.3 的,保留前 3-5 条,在 frontmatter 后插入或替换 Related 行。

索引与模式:完成后执行 qmd update && qmd embed 并输出确认信息。模式有 save(默认,全流程)、quick(跳过去重与 wikilink)、update(外科式编辑已有笔记)、dry-run(仅预览不保存)。

限制:不做研究;不硬编码库路径;不创建无 frontmatter 或空笔记;非 quick 模式必须去重;编辑前先读笔记;未经用户同意不修改其他技能的笔记。详细 schema 与路由规则见其 references 文件。