用途:将已有本地 Markdown vault 接入腾讯 ima(ima.qq.com)作为云端消费端,实现 vault → ima 单向同步,本地 Markdown、frontmatter、目录与 Git 为唯一真源,ima 内容不反向覆盖 vault。本技能不负责从零创建 vault,也不编造 ima 客户端按钮、菜单路径或未公开 API。
主要能力:建立同步范围与目录映射、接入指定 ima 知识库;引导使用 ima 官方 Skills 的本地文件夹监控能力;明确单向同步与排除项,不执行 ima → vault 反向同步。
使用方式:提供已有 vault 路径、希望同步的相对目录、目标 ima 知识库和一篇验证文章标题;安装并登录 ima 客户端;先确定目录 allowlist 并完成敏感级别预检,再在 ima 官方 Skills 中配置本地文件夹监控;首次只同步一篇或一个小目录,确认层级、标题、正文后再扩大范围;在 ima 搜索验证,冲突以本地 Markdown 为准。
安装命令: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-bootstrap-vault-ima -y。配置路径:~/.config/soia-skills/soia-pkm-bootstrap-vault-ima/config.yml,或环境变量 SOIA_PKM_BOOTSTRAP_VAULT_IMA_CONFIG_FILE。预检命令:python3 scripts/preflight_sync.py --vault <vault-path> --path-prefix '20_资料库/<精选分类>/<明确云端范围>'。
适用场景:在 ima 中检索 vault 内容、新文章自动进入 ima、保持本地内容为真源。
限制:整个 vault、20_资料库/ 根目录、历史导入目录、40_图书视频馆/、00_Obsidian系统/、.obsidian/、30_日志与思考/、10_工作台/、.git/、.env 及凭据类文件均须排除;路径允许不等于内容允许,需 fail-closed 预检且 ready=true。ima 具体 UI 操作未经实测,以客户端实际界面为准;官方 Skills 不可用时停止自动同步,不得改用第三方 watcher。回执不得打印账号、token、私有内容或本机绝对路径。WorkBuddy 需单独安装。