What makes webchat-extension notable?

1K downloads. Trust evidence available

How should webchat-extension be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

webchat-extension

部署「网页划线对话」浏览器扩展（Chrome MV3 / 兼容 Chrome·Edge·千问·夸克等 Chromium 内核浏览器）。在任意网页选中文字，点工具栏图标唤起可拖动对话浮层，带着网页上下文用 CodeBuddy AI 流式问答。包含本地 Express + SSE 后端（CodeBuddy Agent SDK）与前端扩展。当用户要「做一个网页划词对话插件 / 给浏览器装个网页对话工具 / 选中文字问 AI / 部署小虾网页对话扩展 / web highlight chat extension / 把网页内容丢给 AI 聊」时使用本技能。

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.0k

Updated

Oct 11, 2026

Version

0.1.5

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 10/11/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 1K downloadsadoption · observed Oct 11, 2026
Latest release: 0.1.5release · observed Aug 7, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s176ns2k88htgg2h6v9myyxg7x83q8k1:webchat-extension

Install using `clawhub skill install s176ns2k88htgg2h6v9myyxg7x83q8k1:webchat-extension` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/noaheleven/webchat-extension before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-noaheleven-webchat-extension/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

144,529 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: webchat-extension
description: 部署「网页划线对话」浏览器扩展（Chrome MV3 / 兼容 Chrome·Edge·千问·夸克 等 Chromium 内核浏览器）。在任意网页选中文字，点工具栏图标唤起可拖动对话浮层，带着网页上下文用 CodeBuddy AI 流式问答。包含本地 Express + SSE 后端（CodeBuddy Agent SDK）与前端扩展。当用户要「做一个网页划词对话插件 / 给浏览器装个网页对话工具 / 选中文字问 AI / 部署小虾网页对话扩展 / web highlight chat extension / 把网页内容丢给 AI 聊」时使用本技能。
---

# 网页划线对话 · 小虾 🦐

一个浏览器扩展 + 本地 AI 后端：用户在任意网页**选中文字**或**复制文字**，点工具栏图标弹出对话浮层，带着网页上下文直接和 AI 流式对话。后端基于 **CodeBuddy Agent SDK**（官方 `@tencent-ai/codebuddy-code` CLI 做 transport）。

## 什么时候用
- 用户想要「在网页上选中一段文字，直接问 AI 这是什么 / 帮我总结 / 翻译 / 解释」。
- 用户想把某个网页内容作为上下文和 AI 聊。
- 用户要部署/打包一个浏览器划词对话工具。

## 架构
```
浏览器扩展 (Chrome MV3)                本地后端 (Express + SSE)
┌──────────────────────────┐          ┌────────────────────────────┐
│ 点工具栏图标 → 浮层(iframe) │──fetch──▶│  /api/chat  (SSE 流式)      │
│ content.js 注入网页          │          │  query() → codebuddy CLI    │
│ background.js service worker│          │  (CodeBuddy Agent SDK)      │
│ 选区经 executeScript 跨 iframe│         │  buildSystemPrompt 注入网页上下文│
└──────────────────────────┘          └────────────────────────────┘
```
- 前端只请求 `http://localhost:3000`，**API Key 只在后端**。
- 面板状态（开关/位置/上下文/对话）用 `chrome.storage` 持久化，刷新不丢。

## 文件布局（本 skill 内）
```
webchat-extension/
├── SKILL.md
├── pack.mjs                  # 发布工具：在 deploy 产物(双形态目录)下 node pack.mjs → 生成干净分享包 zip
├── gen-icons.mjs             # 独立图标生成（零依赖）：node gen-icons.mjs [dir]
├── scripts/
│   ├── deploy.mjs            # 脚手架：复制 assets 源码 + npm install + 生成 icons/（Windows 部署时生成 launcher.vbs + 注册协议）
│   ├── gen-vbs.mjs           # 唯一 source of truth：写出 backend/launcher.vbs（agent 部署时调用，不随包分发）
│   └── register-protocol.cjs # 一键注册/修复 webchat:// 协议（协议丢失或被识别成 Store 应用时用）
├── assets/
│   ├── extension/            # 浏览器扩展（manifest/background/content/panel.*/icons）
│   ├── backend/              # server.js / launcher.mjs / patch-sdk.mjs / package.json / .env.example（launcher.vbs 由 agent 在部署时用 scripts/gen-vbs.mjs 生成，不随包分发）
│   └── root/                 # 部署到目标根目录的文档：README.md（.gitignore / 协议模板不随包分发）
└── references/deploy-guide.md  # 详细排错表
```

> **统一原则**：本 skill 是**唯一 source of truth**。运行环境一律由 `deploy.mjs` 生成（assets → 目标目录），不要在别处手维护一份带 `extension/ backend/` 的"双形态"目录，以免与 skill 不同步产生歧义。deploy 产物（目标目录）本身就是双形态目录（含 `extension/ backend/ SKILL.md pack.mjs gen-icons.mjs`），可直接加载运行，也可 `node pack.mjs` 生成分享包。

## 部署步骤（agent 照做）
1. **脚手架**：运行 `node <skill_dir>/scripts/deploy.mjs <targetDir>`（不加 `[targetDir]` 默认 `./webchat-extension` 或 `~/webchat-extension`）。脚本把 `assets/` 里的扩展、后端、根文档复制到目标目录并 `npm install`；**在 Windows 上，agent 会自动用 `scripts/gen-vbs.mjs` 生成 `backend/launcher.vbs`（即使带 `--no-protocol` 也会生成），并自动注册 `webchat://start` 协议**，使面板「🚀 启动后端」按钮免终端生效。`launcher.vbs` 是部署期产物，**绝不随分享包分发/上传**——若目标目录缺失它，可随时补：`node <skill_dir>/scripts/gen-vbs.mjs <target>/backend`。加 `--no-install` 只复制不装依赖；加 `--no-protocol` 跳过协议注册（但 vbs 仍会生成）。非 Windows 或需手动注册时，按 README「四、一键启动后端」用面板「📋 复制启动命令」手动 `npm start`，或参考 README/references 手动 `reg add` 注册协议。
2. **配置后端**：在 `<target>/backend/` 复制 `.env.example` 为

assets/root/README.md

# 网页划线对话 · 小虾 🦐

> 📦 仓库地址：https://github.com/NoahEleven/webchat-extension

一个 **Chrome / Edge / 千问 / 夸克 等 Chromium 内核浏览器** 扩展：在任意网页上**选中或复制文字**，点一下工具栏图标，就能带着这段网页上下文，直接和 AI 对话、流式得到回答。

> 本质：复用 CodeBuddy Agent SDK 的 **Express + SSE 后端**，前端换成「浏览器扩展 + 网页划线交互」。

---

## 目录结构

```
webchat-extension/
├── README.md
├── webchat-protocol.reg.example   # 仅仓库内模板，不随分享包分发（协议改由部署脚本自动注册）
├── pack.mjs                       # 一键打包分享 zip（按 .gitignore 排除 node_modules/.env/私钥等）
├── extension/                     # 浏览器扩展（Chrome MV3）
│   ├── manifest.json
│   ├── background.js              # service worker：图标点击→开关浮层；心跳 ping 后端
│   ├── content.js                 # 注入网页：开/关浮层、读选区、状态持久化、触发协议
│   ├── panel.html / panel.js / panel.css   # 对话浮层界面与逻辑
│   └── icons/                     # 图标 icon16/32/48/128.png（分享包不含，由 deploy/gen-icons 自动生成）
└── backend/                       # AI 后端（Express + CodeBuddy SDK + SSE）
    ├── server.js                  # /api/chat(SSE) /api/health /api/heartbeat /api/stop
    ├── launcher.mjs               # 协议触发：托管模式静默拉起 server.js
    ├── launcher.vbs               # 隐藏窗口启动 launcher.mjs（由 agent 在部署时用 scripts/gen-vbs.mjs 生成，不随分享包分发）
    ├── patch-sdk.mjs              # postinstall 自动给 SDK 注入 windowsHide，消除 Windows 黑框
    ├── package.json / package-lock.json
    └── .env.example               # 复制为 .env 后填写（含 API Key）
```

---

## 前置依赖（重要）

- **Node.js 18+**：后端是 Node 程序。
- **codebuddy CLI（核心外部依赖，需收件人自备）**：后端通过 `@tencent-ai/agent-sdk` 在运行时 `spawn` 一个 `codebuddy` 子进程来真正调用 AI。`server.js` 的 `resolveCli()` 按以下顺序找它：
  1. 环境变量 `CODEBUDDY_CLI_PATH` 显式指定；
  2. 系统 `PATH` 上的 `codebuddy` 命令；
  3. 兜底固定路径 `~/.workbuddy/binaries/node/versions/22.22.2/node_modules/@tencent-ai/codebuddy-code/bin/codebuddy`（**仅本机 WorkBuddy 托管环境才有**）。
  - 本机因装了 WorkBuddy，托管 Node 已自带 `codebuddy`，所以开箱可用。
  - **分享给别人的机器若没有 WorkBuddy**：需对方自行安装 CLI —— `npm i -g @tencent-ai/codebuddy-code`，并保证 `codebuddy` 在 `PATH` 上（或在 `.env` 设 `CODEBUDDY_CLI_PATH=绝对路径` 指向 CLI）。否则 `query()` 拉不起进程、后端连不上（登录模式和 Key 模式都依赖该 CLI）；此时仅 `WEBCHAT_DEMO=1` 演示模式可跑通交互闭环。

---

## 一、启动后端

```bash
cd backend
npm install
cp .env.example .env        # 然后按需填写 CODEBUDDY_API_KEY
npm start                   # 默认监听 http://localhost:3000
```

启动后访问 `http://localhost:3000/api/health` 应返回 `{ "status": "ok", ... }`。

### 三种模式
| 模式 | 条件 | 表现 |
|---|---|---|
| **登录模式（默认，零配置）** | 没填 `CODEBUDDY_API_KEY` 且未设 `WEBCHAT_DEMO` | 复用本机 `codebuddy` CLI 已登录凭据，**真实 AI**（首次需在终端跑一次 `codebuddy` 完成登录） |
| **Key 模式（推荐无人值守）** | 填了 `CODEBUDDY_API_KEY` | 用 Key 直连 CodeBuddy AI，不依赖交互登录，**真实 AI** |
| **演示模式** | 显式设 `WEBCHAT_DEMO=1` | 后端返回模拟流式回复，用来验收「划线→对话」交互闭环（无需任何账号/登录） |

---

## 二、申请 CODEBUDDY_API_KEY（可选，无人值守场景才需要）

> 默认**不填 Key 也是真实 AI**（登录模式，复用本机 `codebuddy` CLI 已登录凭据）。只有想脱离交互登录、无人值守直连时才需要配 Key。

1. 打开 https://www.codebuddy.cn → 登录
2. 进入「个人中心 / API 密钥」生成 Key
3. 把 Key 填进 `backend/.env` 的 `CODEBUDDY_API_KEY=`
4. 重启后端 `npm start`

> 没 Key 也没关系——登录模式默认就是真实 AI；纯验收交互闭环可设 `WEBCHAT_DEMO=1` 进演示模式。

---

## 三、在浏览器加载扩展

本扩展是标准 Chrome MV3，兼容一切 Chromium 内核浏览器（Chr

_meta.json

{
  "ownerId": "kn769gn5we5rgv7bfhb9ztd8j983p8qc",
  "slug": "webchat-extension",
  "version": "0.1.5",
  "publishedAt": 1786085680332
}

references/deploy-guide.md

# 网页划线对话 · 部署与排错指南

本文件是 skill 的详细排错表，配合 `SKILL.md` 使用。扩展版本 1.5.5。

## 〇、前置依赖：codebuddy CLI（外部依赖，不随包分发）

后端通过 `@tencent-ai/agent-sdk` 在运行时 `spawn` 一个 `codebuddy` 子进程来真正调用 AI。`server.js` 的 `resolveCli()` 按序找它：① `CODEBUDDY_CLI_PATH` 显式指定 → ② 系统 `PATH` 上的 `codebuddy` → ③ 兜底 `~/.workbuddy/binaries/node/versions/22.22.2/node_modules/@tencent-ai/codebuddy-code/bin/codebuddy`（仅本机 WorkBuddy 托管环境有）。

- **本机**（装了 WorkBuddy）：托管 Node 已自带 `codebuddy`，开箱可用。
- **分享给别人的机器若没有 WorkBuddy**：需对方 `npm i -g @tencent-ai/codebuddy-code` 并确保 `codebuddy` 在 `PATH`，或在 `.env` 设 `CODEBUDDY_CLI_PATH` 指向 CLI。否则 `query()` 拉不起进程 → 后端连不上（登录/Key 模式都依赖该 CLI）；仅 `WEBCHAT_DEMO=1` 演示模式可跑通交互闭环。

> 注意：`backend/` 目录**必须随扩展一起分享**——扩展只是 UI 外壳，AI 能力全在后端。

## 一、后端启动与模式

| 步骤 | 命令 | 说明 |
|---|---|---|
| 进入后端 | `cd <target>/backend` | — |
| 安装依赖 | `npm install` | 仅首次；用受管 node 即可 |
| 复制配置 | `cp .env.example .env` | 按需填 `CODEBUDDY_API_KEY` |
| 启动 | `npm start` | 默认 `http://localhost:3000` |
| 健康检查 | `curl http://localhost:3000/api/health` | 返回 `{"status":"ok",...}` |

**三种模式**
- 登录模式（默认，零配置）：未填 `CODEBUDDY_API_KEY` 且未设 `WEBCHAT_DEMO`，复用本机 `codebuddy` CLI 已登录凭据走**真实 AI**（首次需终端跑一次 `codebuddy` 登录）。
- Key 模式（推荐无人值守）：填了 `CODEBUDDY_API_KEY`，用 Key 直连 CodeBuddy AI，不依赖交互登录。
- 演示模式：显式设 `WEBCHAT_DEMO=1`，后端返回模拟流式回复，验收交互闭环用，无需账号/登录。

---

## 二、现象 → 排查

| 现象 | 原因 / 排查 |
|---|---|
| 面板提示「连接后端失败」 | 确认 `cd backend && npm start` 已启动；端口 3000 |
| 点「🚀 启动后端」没反应 | 多半是 `webchat://` 协议未注册（见第四节）。可改用面板「📋 复制启动命令」手动 `npm start` |
| 点图标没反应 | 多见于 `chrome://`、`edge://` 等系统页（扩展无法注入）；普通网页正常。确认扩展已加载且未被禁用 |
| 选中文字点「添加选中文本」没反应 | 选区由 `chrome.scripting.executeScript(allFrames)` 读取，正常能抓微信读书/千问 iframe。若阅读器是 **sandboxed iframe（无 allow-scripts）** 或屏蔽 copy，则只能手动粘贴/输入到输入框发送（发送自动收上下文）。属平台限制非 bug |
| 收到的是演示（模拟）回复 | 说明设了 `WEBCHAT_DEMO=1`。删掉它重启即走登录模式真实 AI；登录态失效则终端跑一次 `codebuddy` 重登，或 `.env` 填 `CODEBUDDY_API_KEY` 走 Key 模式 |
| `/api/health` 返回 `demo:true` | 说明设了 `WEBCHAT_DEMO=1`（演示模式）；移除该变量走默认登录模式真实 AI，或填 Key |
| **真实模式一直转圈、面板无回答**（后端日志 `EADDRINUSE` / CLI 卡死） | 官方 CLI 的 prewarm 端口与 WorkBuddy 桌面应用撞车。在 `.env` 设 `SERVER__PORT=40123`（或空闲端口）并重启；若环境变量残留旧 `SERVER__PORT`，启动时用 `SERVER__PORT=40123 npm start` 显式覆盖 |
| 后端报 `400 model [...] service info not found` | 模型名不对，把 `CODEBUDDY_MODEL` 改成 `deepseek-v4-flash`、`hy3` 或 `auto`（本账户不支持 `claude-sonnet-4`） |
| 后端报 `initialize` 超时 / 永远 0 字节 | 用了 WorkBuddy 自带那份 cli（协议不匹配）。必须用官方 `@tencent-ai/codebuddy-code`；`server.js` 的 `resolveCli()` 已自动定位，必要时用 `CODEBUDDY_CLI_PATH` 显式指定 |
| 拖拽抖动 / 跳左上角 | 扩展 V1.5.2 已修复拖拽坐标公式；若仍异常，扩展管理页「重新加载」并确认 manifest 版本 ≥ 1.5.2 |
| **Windows 上每次对话 / 启动后端弹黑框** | SDK 内部 spawn CLI 默认 `windowsHide:false`。`package.json` 的 `postinstall` 会自动跑 `patch-sdk.mjs` 给 `@tencent-ai/agent-sdk` 的 `process-transport.js` 两处 spawn 注入 `windowsHide:true`；`npm install` 后即生效。若依赖是手动装、跳过了 postinstall，运行一次 `node backend/patch-sdk.mjs` 即可 |

---

## 三、端口冲突根因说明

官方 `@tencent-ai/codebuddy-code` 启动时会起一个 prewarm 本地 server，端口由 `SERVER__PORT` 环境变量控制。本机 **WorkBuddy 桌面应用自身也会起同类 server 占端口**（实测占 54975 之类），两者撞车 → CLI 一绑定就 `EADDRINUS

skill-card.md

## Description:

Deploys a Chromium browser extension and local Express/SSE backend that let users select or copy webpage text and stream contextual answers from CodeBuddy AI.

This skill is ready for commercial/non-commercial use.

## Publisher:

[noaheleven](https://clawhub.ai/user/noaheleven)

### License/Terms of Use:

MIT-0

## Use Case:

Developers and agents use this skill to deploy, configure, and package a browser-based webpage chat assistant. The deployed extension helps users carry selected or copied webpage context into CodeBuddy AI conversations.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill can read and persist selected or copied webpage and clipboard text, which may include sensitive data.

Mitigation: Require explicit user confirmation before adding clipboard content, avoid use on sensitive pages, and review stored conversation/context data before sharing or packaging.

Risk: The local AI backend uses local CodeBuddy login or API-key credentials and was flagged as lacking sufficient access control.

Mitigation: Bind the backend to loopback only, add backend authentication, keep API keys only in local environment files, and exclude credentials from release archives.

Risk: The backend CORS and browser-panel message handling may allow unintended local access if left broad.

Mitigation: Restrict CORS to expected extension origins, check message sources, and keep browser permissions scoped to the extension workflow.

Risk: The release depends on a local CodeBuddy CLI, a Windows protocol handler, and npm dependencies that must be trusted and current.

Mitigation: Install dependencies from trusted sources, update dependency versions before sensitive use, review protocol-handler registration, and verify the generated launcher path.

## Reference(s):

- [ClawHub skill page](https://clawhub.ai/noaheleven/skills/webchat-extension)
- [Publisher profile](https://clawhub.ai/user/noaheleven)
- [Deployment and troubleshooting guide](references/deploy-guide.md)
- [CodeBuddy](https://www.codebuddy.cn)
- [CodeBuddy API console](https://copilot.tencent.com)

## Skill Output:

**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance]

**Output Format:** [Markdown guidance with shell commands and generated project files]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Produces deployment instructions and file-generation steps for a Chromium extension and local Node.js backend.]

## Skill Version(s):

0.1.5 (source: server release evidence)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Github ReposUpdated 2d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW

Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular