NodeLane Act
EN获取 Act
☰
NODELANE ACT / DOCS

安装与使用

安装浏览器扩展和 MCP，让 AI 在你的登录会话中调用知乎与 Reddit 的网站能力。

按你的 Agent 选择安装指南

本页提供两个组件的通用安装与使用说明。客户端配置分别见 act.nodelane.net/codex/、act.nodelane.net/claude-code/ 和 act.nodelane.net/cursor/；它们使用同一个本地 MCP 服务。

平台工作流与分页细节分别见 act.nodelane.net/reddit-mcp/ 和 act.nodelane.net/zhihu-mcp/。npm 与市场状态以 act.nodelane.net/download/ 为准。

准备环境

NodeLane Act 0.2.0 需要同一台电脑上的 MCP 客户端、Node.js 22 或更新版本，以及 Chrome 或 Edge 120 或更新版本。Windows 是当前测试环境；macOS 和 Linux 尚未实测。真实网站只读验收使用 Chrome，浏览器自动化测试使用独立 Chromium。

浏览器需要保持运行，并在你希望操作的网站正常登录。项目不要求网站开放平台账号、App Key 或另建 OAuth 应用。AI 客户端本身的账号和使用费用由对应服务提供方决定。

node --version

1. 获取同一版本的安装包

前往 act.nodelane.net/download/ 选择安装方式。浏览器扩展和 MCP 是两个组件，都需要安装；ZIP 和 MCPB 是 MCP 的不同安装方式，选择其中一种即可。

ZIP 包已经包含构建后的代码和运行依赖，无需再执行 npm install，但不包含 Node.js 二进制。MCPB 也不捆绑 Node.js，请先确保系统可运行 Node.js 22+。当前文档不表示项目已经发布到 npm、浏览器扩展商店或任何 MCP 市场；具体上架状态以下载页的明确标注为准。

  • nodelane-act-extension-0.2.0.zip：独立浏览器扩展。
  • nodelane-act-plugin-0.2.0.zip：MCP 服务、Codex 插件清单和同版本浏览器扩展。
  • nodelane-act-0.2.0.mcpb：供支持 MCPB 的客户端导入的 MCP 包，浏览器扩展仍需另行安装。

2. 安装浏览器扩展

把扩展 ZIP 解压到固定目录。在 Chrome 打开 chrome://extensions，在 Edge 打开 edge://extensions，启用“开发者模式”，选择“加载已解压的扩展”，然后选择包含 manifest.json 的解压目录。不要直接选择 ZIP 文件。

如果下载的是完整插件 ZIP，也可加载其中的 dist/extension 目录，无需再安装第二份扩展。按浏览器提示核对网站访问权限。扩展通过已声明的网站权限执行操作；安装后不会追加配对码、端口输入或扩展确认步骤。

保留解压目录，浏览器以后仍从这里加载文件。扩展弹窗显示连接状态、执行状态与近期历史。

3A. 导入 MCPB

如果你的 MCP 客户端支持 MCPB 本地安装，在该客户端的扩展或 MCP 设置中导入 nodelane-act-0.2.0.mcpb，核对包名与权限后启用。具体入口取决于客户端及版本，不能假设所有 MCP 客户端都支持此格式。

这个文件安装 MCP 服务，不会代替 Chrome 或 Edge 扩展的安装。若客户端没有 MCPB 导入入口，使用下面的普通 stdio MCP 配置。客户端如果提供符合版本要求的 Node.js 运行时，也可使用其运行时；项目不保证每个客户端都内置 Node.js。

3B. 配置普通 MCP

把完整插件 ZIP 解压到固定目录，例如 C:\Tools\nodelane-act。保持 package.json、dist/ 和点文件的原有层级。MCP 启动命令为 node，参数为解压目录下 dist/server/index.js 的绝对路径。

支持 mcpServers JSON 配置的客户端可使用下例。其他客户端请在对应表单中填写相同的 command 与 args；不要把服务器命令填写为远程 HTTP URL。修改后按客户端要求重新加载或重启 MCP。

{
  "mcpServers": {
    "nodelane-act": {
      "command": "node",
      "args": ["C:\\Tools\\nodelane-act\\dist\\server\\index.js"]
    }
  }
}

Codex 命令行安装

已安装 Codex 命令行时，可以用下面的命令注册同一个本地 stdio MCP。路径应替换为实际解压位置。完整 ZIP 也包含 .codex-plugin/plugin.json 与 .mcp.json，供支持相应插件导入方式的 Codex 客户端使用。不要同时用多个入口重复注册同一个服务。

Codex 的 MCP 配置说明：learn.chatgpt.com/docs/extend/mcp?surface=cli。

codex mcp add nodelane-act -- node "C:\Tools\nodelane-act\dist\server\index.js"

4. 检查连接并开始读取

MCP 启动时会自动启动或复用本机桥接，扩展自动发现并连接。安装顺序不限，不需要设置端口或复制认证信息。让浏览器与 MCP 客户端同时运行，确认弹窗显示已连接。

可以先让 AI“读取 Reddit 推荐的 5 条帖子”或“查看这个知乎问题的前 5 个回答，并保留下一页游标”。AI 先选择页面，再按当前站点发现必要操作。浏览器缺少目标页面时，可由 site.context 打开；不会覆盖其他已有标签页。

site.context({ site: "zhihu" })
site.discover({ site: "zhihu", operation: "answers" })
site.execute({
  targetId: "<context 返回的 targetId>",
  operation: "answers",
  args: { questionId: "<问题 ID>", limit: 5 }
})

翻页、正文与上下文预算

初始只有 site.context、site.discover 和 site.execute 三个工具。site.discover 传入 site 可获取精简目录，加入 query 可查找相关能力，加入 operation 可只获取一个操作的参数定义。

知乎列表将 nextCursor 原样传回 cursor；Reddit 列表按各自参数定义使用 after 或 before。下一页保留原始查询、排序等条件。正文单独读取，避免一次返回整页 HTML。

知乎话题列表可读取对应网页已加载的卡片。抵达末尾时尝试一次正常滚动，最多等待 8 秒；没有新增内容且没有明确结束标记时，返回 PAGE_NOT_READY。TARGET_PAGE_REQUIRED 会给出可由 site.context 自动打开的页面地址。网页游标与 API 游标不能混用。

site.execute 的 maxChars 默认 12000、最高 30000，这是字符预算，不是精确 token 数。超大结果会分段返回；使用 resultId 与 nextOffset 续取的是本地缓存，不会再次执行原操作。缓存最多 30 项，10 分钟过期。

site.execute({ resultId: "<返回的 resultId>", offset: 12000, maxChars: 12000 })

互动与失败处理

明确告诉 AI 操作对象和希望执行的动作。获得用户指令后，支持的写入直接提交到网站，扩展不再弹出第二次确认。发布前需要审核的内容，应先让 AI 起草，确认内容后再要求提交。

取消、超时或断线无法撤销已经发出的写入。遇到结果不确定，请先在网站查看是否已经完成，再决定是否重试。扩展不会自动重试写入。页面导航或目标失效后，应重新调用 site.context。

登录、权限、限流和验证码由网站决定。遇到限制时，在浏览器按网站正常流程处理；NodeLane Act 不破解签名或绕过验证。知乎文章发布需要 zhuanlan.zhihu.com 的页面目标。

更新、诊断与卸载

更新时先停止正在进行的操作，替换为同版本 MCP 与扩展文件，在扩展管理页重新加载扩展，并重启客户端中的 MCP。不要在操作执行期间删除安装目录。

连接失败时先检查 Node.js 版本、MCP 绝对路径、浏览器是否运行、扩展是否启用和网站访问权限。下列命令从同一安装目录检查状态或停止共享桥接。停止前先在 MCP 客户端停用服务，避免下一次请求自动重新启动桥接。

卸载时移除浏览器扩展和客户端中的 MCP 配置，停止本机桥接，然后删除安装目录。本地运行配置需另行清理；网站上已经发布的内容与 AI 客户端保存的对话不会随卸载删除。

node "C:\Tools\nodelane-act\dist\server\index.js" status
node "C:\Tools\nodelane-act\dist\server\index.js" stop

从源码构建

开发者可以从项目仓库构建，然后加载 dist/extension，并将 dist/server/index.js 注册为本地 MCP。新增站点在 sites/<id>/ 中提供 manifest.json 与 adapter.ts，遵循同一参数校验和结果协议。浏览器执行代码变更后需要重建并重新加载扩展。

git clone https://github.com/Wy2926/nodelane-act.git
cd nodelane-act
npm ci
npm run build