使用 Obclip
使用此技能来使 Obclip 工作可预测，而不是试错。
工作流
验证 Obclip 应该如何被调用。
选择与目标站点匹配的浏览器模式。
运行最小的可以成功的命令。
只有当输出不完整时才升级等待和浏览器状态。
报告最终保存的路径或具体的失败原因。
如果 Obclip 已经在 PATH 中，优先使用它。
如果 Obclip 缺失，从 install-and-invoke.md 安装 npm 包。
如果您在源代码仓库中工作，且全局命令不可用，回退到 node \dist\cli.cjs。
安装后，使用 obclip --help 或 npx @harris7/obclip --help 进行验证。
对于不需要登录状态的公共页面，使用默认的 Playwright Chromium。
当用户已经有一个专用的 Chromium 构建并想要一个固定的浏览器二进制文件时，使用 --browser-executable ""。
对于需要登录状态、cookies 或持久会话的站点，使用 --browser-profile ""。
当用户需要看到浏览器或执行初始登录到新鲜的配置文件时，使用 --headful。
不要将 --browser-profile 指向用户的正常日常 Chrome 配置文件。
优先使用专用的配置文件目录。
默认公共页面捕获：obclip --output "\\"
登录或反 bot 页面：添加 --browser-executable、--browser-profile 和通常 --headful
如果用户想要在 stdout 中输出 Markdown，省略 --output
如果用户想要在 Obsidian 中打开笔记，添加 --open 和可选的 vault/URI 标志
使用 command-recipes.md 中的具体命令模板。
首先在简单页面上运行没有自定义等待的命令。
如果页面不完整但可见地加载动态内容，添加 --settle-ms 3000 或 --settle-ms 5000。
如果页面是 SPA 且内容稍后挂载，添加 --wait-selector ""。
优先使用广泛的、内容承载的选择器，例如 article、main、[role="main"] 或稳定的 post 容器。
避免仅匹配导航、登录 shell 或骨架加载器的选择器。
如果页面仍然显示登录墙，使用 --browser-profile 修复浏览器状态；额外的延迟不能解决缺失的身份验证。
如果第一次尝试失败，使用 troubleshooting.md。
成功的文件保存将在 stderr 中打印 Saved note: 。
失败将打印直接原因，例如保存失败、无效的浏览器路径或等待超时。
除非用户明确希望在终端中或将 Markdown 正文管道到另一个命令，否则保持 stdout 清洁。
引用可能包含空格的 Windows 路径。
对于 --output，优先使用现有的目录或以 \\ 或 / 结尾的路径，当您想要目录语义时。
示例：--output "D:\\data\\Clippings\\"
参考
安装和调用：install-and-invoke.md
命令模板：command-recipes.md
故障处理：troubleshooting.md
by