用途:do.link 用于把外部工作区连接到磁盘上已有的 DeepOrbit Obsidian vault,并按其内部工作流处理自然语言请求。DeepOrbit vault 是自包含的,deeporbit init 会把工作流物化到 99_System/DeepOrbit/skills/ 并生成 skills-index.json 触发索引;外部工作区只需安装本技能,即可注册 vault、解析使用哪个 vault,并把请求路由到 vault 内的工作流。
安装:推荐系统级安装 npx skills add dull-bird/DeepOrbit --skill do.link --global --agent '*' --yes。不要默认把整个 DeepOrbit 技能包装进每个项目;vault 内 99_System/DeepOrbit/skills/ 的副本才是项目级工作流目录。若 deeporbit 可执行文件不可用,改用 PYTHONPATH=<repo>/src python -m deeporbit …。需要本技能未列出的命令时,运行 deeporbit __schema 查看完整 CLI 表面。
链接与路由:使用 deeporbit link add <name> <vault-path> --description "<what this vault is for>" 建立链接,并始终在链接时设置描述;用户未提供时可依据 deeporbit.json、目录结构和近期笔记推导,并以 --source agent 保存。deeporbit link route "<natural-language request>" 用于歧义场景,先选出最佳 vault,再通过 --vault @name 路由后续工作。管理命令包括 link list、link default <name>、link describe <name> "<text>" [--source agent]、link remove <name>。注册表位于设备本地 ~/.config/deeporbit/links.json,不与 vault 同步。
执行流程:读取 <vault>/99_System/DeepOrbit/skills-index.json 匹配意图,再读取对应 SKILL.md 及其 reference/ 或 scripts/ 文件;以 <vault> 为工作区根执行,文件读写使用 vault 内绝对路径,CLI 调用传 --vault @<name>。若 vault 未物化技能,回退到 DeepOrbitPrompt.md 与 deeporbit --vault @<name> <command>,并建议运行 do.init。
限制:绝不写入链接 vault 之外,外部写入仅限设备本地链接注册表和 OS 缓存目录下的 vault 本地索引;始终说明由哪个 vault 处理请求;除非用户明确说明,不把当前目录当作 vault;未经用户确认不得覆盖 description_source 为 user 的描述。