安装

Doc Agent Extension 由两部分组成：本地 Gateway（Node 服务）和 Chrome 扩展。两者都要运行。

前置条件

• Node.js ≥ 18
• pnpm ≥ 8
• Chrome ≥ 116（扩展使用 Side Panel 与现代 CSS）
• 至少一个官方 CLI（dws / lark-cli / ntn），可由 Setup 向导 引导安装

方式一：从 Release 安装扩展（推荐）

每次推送 v* 标签，GitHub Actions 会自动构建并在 Releases 附带 doc-agent-extension-chrome-mv3-vX.Y.Z.zip：

1. 下载并解压该 zip。
2. 打开 chrome://extensions，开启右上角「开发者模式」。
3. 点击「加载已解压的扩展程序」，选择解压后的目录。

然后按下方「启动 Gateway」运行本地服务。

方式二：从源码构建

git clone https://github.com/xinyuehtx/doc-agent-extension.git
cd doc-agent-extension
pnpm install

启动 Gateway（CLI 模式，默认端口 19836）

AGENT_EXECUTION_MODE=cli pnpm start:gateway

验证：

# 健康检查 → 应返回 executionMode:"cli"
curl http://127.0.0.1:19836/health

# CLI 状态检测
curl -XPOST http://127.0.0.1:19836/setup/detect -d '{"providers":["dingtalk"]}'

构建并加载扩展

pnpm build:ext

在 chrome://extensions（开发者模式）中「加载已解压的扩展程序」，选择 packages/chrome-extension/dist。

常用命令

pnpm build       # 全量构建（gateway tsc + 扩展 vite）
pnpm test        # 全部单元 / 集成测试
pnpm typecheck   # 各包 tsc --noEmit
pnpm docs:dev    # 本地预览文档站点

下一步

打开扩展侧边栏，进入 Setup 向导 完成 CLI 检测与登录。