TOPn动态规则+MCP首次检测+browser-harness依赖检测+环境检查系统分流(Windows/macOS)

project/短视频脚本创作/V1.0/references/接口调用/MCP_工具调用规范.md

@@ -26,7 +26,7 @@
 
 ## 3) 自动检测与安装引导流程
 
-**触发时机：用户首次提问（技能被触发）时即检测并提醒安装，不等到真正用到 API 功能才提示。**
+**触发时机：用户首次提问（技能被触发）时即检测并提醒安装，不等到真正用到 API 功能才提示。「首次提问」= 本技能会话的首次交互（用户询问功能/功能介绍/发起任何任务，无论问什么），由 SKILL.md「MCP 依赖（摘要）·安装引导」作为必做动作驱动。**
 
 | 触发点 | 行为 |
 |--------|------|
@@ -36,7 +36,7 @@
 
 按以下流程处理：
 
-1. **检测**：检查 `myai-mcp-production` 的 MCP 工具是否在可用列表中。可用 → 跳到 [4 登录检查]；不可用 → 进入步骤2
+1. **检测**：检查 `myai-mcp-production` 的 MCP 工具是否在可用列表中。**检测方法（任一即可判定）**：① 查看当前会话可用 MCP 工具列表是否含该服务工具（如 `auth_status`/`upload_douyin_video`/`short_video_detail`）；② 读 `~/.workbuddy/mcp.json`（Windows 为 `%USERPROFILE%\.workbuddy\mcp.json`）是否含 `myai-mcp-production` 服务配置。两者都无 → 未安装 → 进入步骤2
 2. **判定环境 + 提示**：
    - **首次提问（轻量提醒，不打断创作）**：
      > 本技能部分功能（对标视频解析 / 创意灵感 / 账号设定查询）依赖 MCN MCP 服务。是否现在安装？暂时不需要可跳过，不影响核心创作流程，用到时会再次提醒。
@@ -50,7 +50,7 @@
    - **部署预检（先做，按顺序）**：
      1. **运行时版本**：检查 Node.js（`node --version`）和 Python（`python --version`）是否已安装。缺失则先引导安装对应运行时再继续——`npx` 型 MCP 依赖 Node.js，`python` 型 MCP 依赖 Python，缺失会导致 MCP 安装/启动失败。
      2. **npm 缓存权限（macOS 高发坑，必须查）**：`npx` 型 MCP 首次运行需写入 npm 缓存（默认 `~/.npm` 的 `_npx`/`_cacache`）。若缓存目录里有 **root 权限文件**（常见于曾用 sudo 装过包、系统迁移/重装后遗留），npx 无权限写入 → MCP 启动静默失败。典型症状：包能正常下载（源没问题）、配置也写入了，但 MCP 一直连不上/不出现。
-        - **检查**：`npm config get cache` 确认缓存目录（默认 `~/.npm`）；`find ~/.npm -user root 2>/dev/null | head` 查看是否有 root 文件
+        - **检查**：`npm config get cache` 确认缓存目录（默认 `~/.npm`）；**macOS/Linux** 用 `find ~/.npm -user root 2>/dev/null | head` 查看是否有 root 文件；**Windows 无 root 权限文件问题，跳过此项检查**（只需确认缓存目录可写即可）
         - **处理**：缓存可重建，直接清理（目录本身归用户所有，**无需 sudo**）：`rm -rf ~/.npm/_npx ~/.npm/_cacache`，下次 npx 运行自动重建
         - **注意**：只清缓存目录，**不要**动 `~/.npmrc`（含 registry 配置）和全局已安装的包
      3. **（可选）npm 源**：国内网络确认 registry 已配镜像（`npm config get registry`，如 `https://registry.npmmirror.com`）避免拉包超时。但镜像**不是**启动失败的根因，排查顺序永远是 1 → 2 → 3。