SuperAPI AI 工具集

agentation

编程与开发

查看项目

更新于 10-16 06:14

技能介绍

用途:在 Next.js 项目中安装并挂载 Agentation 标注工具栏;如用户要求,再把它与选定的 agent 运行时通过 MCP 连接,使标注可传递给 agent。已存在的 import 只能说明组件已加入,不能证明标注能到达 agent。

主要能力与用法: 安装前先读项目说明、package.json、lockfile 与现有配置,使用项目自身的包管理器;React 与 React DOM 需满足 peer 范围(React 18 或更新)。在 app/、pages/、src/ 中搜索已有 import 与挂载,优先复用。

挂载:仅开发环境挂载一次。App Router(app/layout.* 或 src/app/layout.)下新建/复用小客户端组件,在根布局 body 内 children 之后渲染,保持布局为 Server Component;Pages Router(pages/_app. 或 src/pages/_app.*)下在页面组件之后渲染。示例: "use client"; import { Agentation } from "agentation"; export function DevAgentation() { if (process.env.NODE_ENV !== "development") return null; return <Agentation endpoint="http://localhost:4747" />; } Pages Router 用 {process.env.NODE_ENV === "development" && (<Agentation endpoint="http://localhost:4747" />)}。将示例 URL 换成已验证的、浏览器可达地址;纯本地工具栏可省略 endpoint。

MCP(仅在范围内):先读所选运行时现有配置与 CLI 帮助或官方文档,只增改其 Agentation 条目。stdio 命令为 npx -y agentation-mcp server,同时启动 HTTP 服务(默认端口 4747)与面向 agent 的 MCP 服务。Claude 示例(仅当其为所选运行时):claude mcp add agentation -- npx -y agentation-mcp server。Codex、OpenCode、Grok 使用各自支持的 MCP 注册方式,不要用 Claude 向导或全 agent 安装器兜底;不支持 MCP 时应说明只能用复制/导出,不要静默更换提供方。自定义端口用 server --port <port> 并对应工具栏 endpoint;已有共享 HTTP 服务用 server --mcp-only --http-url <server-base-url>,避免另起监听。

验证:运行项目类型/构建检查,在开发浏览器查看工具栏,确认生产环境守卫生效;检查配置 HTTP 基址的 /health 与浏览器网络错误,必要时重载 MCP 或重启运行时,确认其 Agentation 工具可列出会话;授权任务中可创建带标记的测试标注、经 MCP 取回后删除。npx -y agentation-mcp doctor 仅为补充(1.2.0 检查 Claude 配置与 localhost:4747,不覆盖其他运行时、自定义端口或浏览器到 agent 的投递)。若无法重启或访问浏览器,应说明已配置但同步未验证。

限制:import、配置条目或 HTTP 服务健康本身均不足以证明同步成功。官方文档、收费与支持平台暂未提供。