用途:把已有本地 Markdown vault 接入腾讯 ima(ima.qq.com)作为云端消费端。同步方向为 vault → ima;本地 Markdown、frontmatter、目录和 Git(若启用)是唯一真身,ima 内容不反向覆盖 vault。本技能不负责从零创建 vault,也不提供 ima 客户端未公开 API 或按钮名称。
主要能力:建立同步范围与目录映射,接入指定 ima 知识库;引导使用 ima 官方 Skills 的本地文件夹监控能力,实现新文章自动进入 ima;明确单向同步与排除项,保持本地内容为真源,不做 ima → vault 反向同步。
使用方式:先提供已有 vault 路径、希望同步的相对目录、目标 ima 知识库和一篇用于验证的文章标题;安装并登录 ima 客户端(官网入口 https://ima.qq.com/);以 allowlist 形式确定本地同步范围,再在 ima 官方 Skills 中配置本地文件夹监控;首次同步只选一篇或一个小目录,确认层级、标题和正文后再扩大范围;在 ima 搜索验证文章,冲突以本地 Markdown 为准。
安装命令:npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-bootstrap-vault-ima -y
配置约定:~/.config/soia-skills/soia-open-skills/soia-pkm/soia-pkm-bootstrap-vault-ima/config.yml,或通过 SOIA_PKM_BOOTSTRAP_VAULT_IMA_CONFIG_FILE=<custom-config-path> 指定。
适用场景:在 ima 中检索 vault 内容、新文章自动进入 ima、保持本地内容为真源的个人知识库接入场景。
限制:ima 具体 UI 操作未经实测,首次执行时必须以客户端实际界面为准并校正文档;应排除 .obsidian/、.git/、.env、私密目录、会话日志和未发布草稿;没有明确同步范围时暂停,不要监控整个 vault。若官方 Skills 当前客户端不可用,记录版本并停止自动同步,勿改用第三方 watcher 或自建反向同步。回执不得打印账号、token、私有文件内容或本机绝对路径。