该条目是一个技能模板,而非已完成的可用技能。资料中多处标注 TEMPLATE,并明确说明不要安装或发布 skills/_template,也不要以产品技能的名义提交。
用途与创建方式:通过 npm run new-skill -- <id> 复制该模板目录,并替换其中的 SKILL_ID 占位符,然后补写真实的技能说明与内容。模板要求删除所有 TEMPLATE 注释,替换示例登录地址 https://example.com/login,并在评审前写明可观察的真实成功状态。
主要机制:技能应通过 Ego Lite 会话完成目标操作,依赖 ego-browser 存在于 PATH。若缺少 ego-browser 或站点未登录,应以退出码 2 软失败并告知用户,不应改用 Playwright、Puppeteer 或云端浏览器等其他方式驱动浏览器。
登录闸门:在上传、下载或修改页面前必须运行 node scripts/check-login.mjs,需要留出窗口供人工登录时使用 --keep 参数。退出码 0 表示已登录,可继续并向用户展示 login_tip;退出码 2 表示未登录或缺少 ego-browser,应展示登录指引并停止,请用户在 Ego 中登录后再运行;退出码 1 表示其他错误,应报告 JSON 错误,不得假装成功。模板还要求不另做 cookie 健康检查、不代填密码、不粘贴 Cookie、不自动扫码。仓库根目录下脚本路径为 node skills/SKILL_ID/scripts/check-login.mjs。资料指出,当前模板在二进制存在时仍会返回退出码 1 和 TEMPLATE 错误,需替换为真正的 ego-browser Node.js 探测后才可视为可用。
输入与发布/下载区分:调用方提供路径和文案,模板不写死个人或产品目录,示例仅使用 /tmp/... 或绝对路径。发布类技能由调用方提供本地视频绝对路径,技能不下载视频、不内置 yt-dlp 或 gallery-dl,并需写明成功态(如审核中、私密链接及处理状态、进入内容管理或“发布成功”文案、已存草稿);需要人工扫码的“发表”不得自动点击,视频号场景只存草稿。下载类技能需与发布类分开,仅保存当前 Ego 登录态已能看到的内容。
测试:运行 npm test,测试通过 glob 收录 skills//scripts/test/.test.mjs,使用 c8 统计 scripts/lib/**/*.mjs(不含 ego-deps.mjs),行覆盖率要求不低于 80%。
限制:资料未提供该模板对应的真实目标站点、具体业务功能与实际成功结果,成功状态仍需替换占位句后填写;在补齐前不应作为可用技能安装或使用。