技能介绍

要解决什么问题

读网页时你经常只想问一句：这段是什么意思、帮我总结、翻译或解释。把内容复制到独立聊天窗口，上下文和出处很容易丢；若还要自己拼 prompt，成本更高。

小虾（WorkBuddy 网页对话扩展）把这件事收进浏览器工具栏：在任意页面选中文字或依赖复制/剪贴板，打开侧栏浮层，把当前网页片段当作上下文，与 AI 流式多轮对话。前端只访问 http://localhost:3000，API Key 与 CodeBuddy 认证逻辑都在本地后端，扩展不碰密钥。

怎么工作

架构：Chromium 扩展（Chrome / Edge / 千问 / 夸克等）+ Node 本地服务；后端通过 CodeBuddy Agent SDK 调用模型，transport 对齐官方 @tencent-ai/codebuddy-code CLI。
喂上下文：面板里用「添加选中文本」累加片段（摘要展示，可删）；也可直接发送，自动带上剪贴板或输入内容。background.js 对多帧页面用 chrome.scripting.executeScript({ allFrames: true }) 尽量读到 iframe 内选区。
状态持久化：开关、面板位置、上下文与对话历史写在 chrome.storage，刷新页面后仍可恢复。
认证：未配置 CODEBUDDY_API_KEY 时默认登录模式，复用本机 codebuddy CLI 已登录凭据；填 Key 则走无人值守；仅当 WEBCHAT_DEMO=1 时为演示回复。本 skill 以 deploy.mjs 为唯一来源，生成可加载的 extension/ 与 backend/ 目录。

边界与注意点

chrome://、edge:// 等系统页无法注入脚本，点图标无反应属正常。
与 WorkBuddy 桌面端 或其他进程争用 CLI 的 SERVER__PORT 时，可能出现后端一直转圈；需在 .env 指定空闲端口并由 launcher 注入环境。
部分阅读器若在 sandboxed iframe 里屏蔽复制，只能手动粘贴到输入框再发送。
账户模型需与控制台一致（例如不支持 claude-sonnet-4 时应改用 hy3 或 auto）；勿混用 WorkBuddy 自带 CLI 路径，以免 initialize 超时。