用途:本技能仅用于检测传输方式,并对选定的 Obsidian vault 做只读读取或搜索,不承担写入职责。
主要能力:探测官方 obsidian 可执行文件是否真正可用,读取与搜索笔记,读取反链、标签或 Bases 结果(需 CLI 就绪)。判断依据是 available.cli.usable,而非文件存在或退出状态;即便 CLI 受支持,也可能因 Obsidian 未运行、命令行访问被禁用或返回错误而不可用。
使用方式:先定位已安装产品根目录,不要用 vault 或当前工作目录推导,例如设置 PRODUCT_ROOT 后使用 $PRODUCT_ROOT/scripts/detect-transport.sh。可用探测命令:bash "$DETECT_TRANSPORT" --peek --vault "$VAULT"。只有当用户或安装流程要求生成传输快照时,才执行 bash "$DETECT_TRANSPORT" --force --vault "$VAULT",生成 .vault-meta/transport.json,并保留检测器记录的 manual_override。读取和搜索应在选定 vault 内运行官方命令,例如 (cd "$VAULT" && obsidian read path="$NOTE") 与 (cd "$VAULT" && obsidian search query="$QUERY"),具体语法以已安装 CLI 支持为准。CLI 未就绪时,直接读取 $VAULT 下文件并用 rg 搜索。
限制:禁止使用 CLI 的创建、写入、追加、属性设置、每日追加、移动、重命名或删除命令,也不得用直接文件系统写入替代;任何知识或配置变更须通过可移植核心以单次受审事务表达。拒绝绝对笔记路径、路径穿越、符号链接或解析后超出选定 vault 的路径。CLI 只是可选读取面,不是锁管理器、事务引擎或 Git 检查点机制;其他细节暂未提供。