soia-pkm-bootstrap-vault-imalisted

# soia-pkm-bootstrap-vault-ima 把已有本地 Markdown vault 接入腾讯 ima（[ima.qq.com](https://ima.qq.com/)）作为云端消费端。同步方向是 **vault → ima**；本地 Markdown、frontmatter、目录和 Git（若启用）是唯一真身，ima 中的内容不反向覆盖 vault。 ## 客户可读说明 ### 这个技能可以做什么 | 客户想要 | 技能会做 | 客户能看到 | |---|---|---| | 在 ima 中检索 vault 内容 | 建立同步范围和目录映射，接入指定 ima 知识库 | 映射表、同步范围和验证结果 | | 新文章自动进入 ima | 引导使用 ima 官方 Skills 的本地文件夹监控能力 | 监控源目录、目标知识库和首次同步回执 | | 保持本地内容为真源 | 明确单向同步与排除项 | 不会执行 ima → vault 反向同步 | 本 skill 不负责从零创建 vault，也不编造 ima 客户端的按钮名称、菜单路径或未公开 API。ima 具体 UI 操作未经本次实测，首次执行时必须以客户端实际界面为准并校正本文档。 ### 客户如何使用 1. 提供已有 vault 路径、希望同步的相对目录、目标 ima 知识库和一篇用于验证的文章标题。 2. 安装并登录 ima 客户端。 3. 先确定 allowlist 形式的本地同步范围，再在 ima 官方 Skills 中配置本地文件夹监控。 4. 首次同步只选一篇或一个小目录，确认层级、标题和正文后再扩大范围。 5. 在 ima 搜索验证文章；任何冲突都以本地 Markdown 为准，不从 ima 反向写回。 ### 依赖与安装 安装本 skill（hard dependency 会同时要求 base）： ```bash npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-bootstrap-vault-ima -y ``` 配置约定： ```text ~/.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 官网与客户端下载入口：https://ima.qq.com/ - ima 的 Skills、本地文件夹监控和知识库界面会随客户端版本变化；未实测部分标注为“以 ima 客户端实际界面为准，首次执行时校正本文档”。 ### 日志与完成回执 回执至少包含：客户端登录检查、目标知识库和本地 allowlist（只写相对目录）、首次同步范围、成功/跳过/失败数量、检索验证结果和仍需用户手动校正的 UI 步骤。不得打印账号、token、私有文件内容或本机绝对路径。 ## 接入流程 ### 1. 安装客户端并登录 打开 [ima 官方入口](https://ima.qq.com/)，安装电脑端客户端并登录。官网当前提供“打开电脑版”和客户端下载入口；具体安装提示以官方页面和本机系统为准。 ### 2. 创建知识库并制定目录映射 在 ima 客户端创建一个用于消费 vault 内容的知识库。具体