@insightsuen/dingdoc 0.1.0

package/README.md

@@ -0,0 +1,200 @@
+# dingdoc MCP Server
+
+通过 MCP 协议读取钉钉知识库文档内容，支持两种工作模式：**API 模式**（完整功能）和**仅浏览器模式**（无需凭证）。
+
+## 运行模式
+
+| 模式 | 触发条件 | 可用工具 |
+|------|---------|---------|
+| **API 模式** | 提供了 AppKey / AppSecret / 用户身份，且验证通过 | 全部 3 个工具 |
+| **仅浏览器模式** | 未提供凭证，或凭证验证失败 | 仅 `dingtalk_get_document` |
+
+- 服务启动时自动检测，无需手动切换
+- 仅浏览器模式首次使用时会打开登录窗口，完成钉钉扫码登录后 session 持久保存（`~/.insight-mcp/dingdoc-browser/`）
+
+## 在 MCP 客户端中配置
+
+### 仅浏览器模式（最简配置）
+
+```json
+{
+  "mcpServers": {
+    "dingdoc": {
+      "command": "node",
+      "args": ["/path/to/Insight-MCP/servers/dingdoc/dist/index.js"]
+    }
+  }
+}
+```
+
+### API 模式（完整功能）
+
+直接写入凭证：
+
+```json
+{
+  "mcpServers": {
+    "dingdoc": {
+      "command": "node",
+      "args": ["/path/to/Insight-MCP/servers/dingdoc/dist/index.js"],
+      "env": {
+        "DINGTALK_APP_KEY": "your_app_key",
+        "DINGTALK_APP_SECRET": "your_app_secret",
+        "DINGTALK_UNION_ID": "your_union_id"
+      }
+    }
+  }
+}
+```
+
+引用已有的环境变量名（凭证不写入配置文件）：
+
+```json
+{
+  "mcpServers": {
+    "dingdoc": {
+      "command": "node",
+      "args": [
+        "/path/to/Insight-MCP/servers/dingdoc/dist/index.js",
+        "--app-key-env=MY_APP_KEY",
+        "--app-secret-env=MY_APP_SECRET",
+        "--union-id-env=MY_UNION_ID"
+      ]
+    }
+  }
+}
+```
+
+## 凭证说明
+
+服务支持三种方式提供凭证，按优先级从高到低：
+
+| 方式 | 示例 |
+|------|------|
+| CLI 直传明文 | `--app-key=xxx --app-secret=xxx` |
+| CLI 指定环境变量名 | `--app-key-env=MY_VAR --app-secret-env=MY_VAR` |
+| 默认环境变量 | `DINGTALK_APP_KEY` / `DINGTALK_APP_SECRET` |
+
+操作人身份（三种方式均支持）：
+
+| 凭证 | 默认环境变量 | CLI 明文 | CLI 指定 env 名 |
+|------|------------|---------|----------------|
+| unionId（推荐） | `DINGTALK_UNION_ID` | `--union-id=xxx` | `--union-id-env=MY_VAR` |
+| userId（自动解析为 unionId）| `DINGTALK_USER_ID` | `--user-id=xxx` | `--user-id-env=MY_VAR` |
+
+**unionId 与 userId 的区别：**
+
+- **unionId**：钉钉跨企业唯一用户标识，格式为 Base64-like 字符串（如 `HOqmx7FOhIBxUBjJ580XJgiEiE`）。API 调用时作为操作人身份，直接使用无需额外查询，推荐优先使用。
+- **userId**：企业内部的员工工号（如 `STAFF-001`），仅在本企业内唯一。服务会在启动时自动调用 `Contact.User.Read` 接口将其解析为 `unionId`，解析成功后打印结果供日后直接使用。
+
+> **如何获取 unionId？** 配置 `DINGTALK_USER_ID`（工号）启动一次服务，日志中会打印对应的 `unionId`，复制后改用 `DINGTALK_UNION_ID` 配置即可，后续启动不再需要查询接口。
+
+API 权限要求：
+- `Wiki.Read`（知识库读取）
+- `Contact.User.Read`（用户信息查询，仅使用 userId 时需要）
+
+## 可用工具
+
+### `dingtalk_get_document` _(API 模式 + 仅浏览器模式均可用)_
+
+读取文档内容，返回 Markdown 格式全文。
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `nodeId` | string | 二选一 | 文档节点 ID（dentryUuid） |
+| `url` | string | 二选一 | 文档 URL，格式：`https://alidocs.dingtalk.com/i/nodes/{nodeId}` |
+
+API 模式优先通过 DingTalk Stream 异步导出获取；若 API 无权限，自动 fallback 到浏览器读取。
+
+---
+
+### `dingtalk_list_spaces` _(仅 API 模式)_
+
+列出当前用户有权限的所有钉钉知识库，返回 `spaceId`、名称、`rootNodeId` 和访问链接。
+
+无需参数，直接调用即可作为浏览目录的起点。
+
+---
+
+### `dingtalk_list_nodes` _(仅 API 模式)_
+
+列出指定节点下的子节点（文件和文件夹）。
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `nodeId` | string | 是 | 父节点 ID，从 `dingtalk_list_spaces` 的 `rootNodeId` 开始 |
+| `recursive` | boolean | 否 | 是否递归展开整个目录树，默认 `false` |
+
+## 工作原理
+
+### API 模式文档读取
+
+钉钉文档导出是异步的，`dingtalk_get_document` 采用以下机制同步返回结果：
+
+1. 服务启动时建立 **DingTalk Stream WebSocket 长连接**，监听 `doc_content_export_result` 事件
+2. 调用工具时，通过 REST API 触发导出任务，获取 `taskId`
+3. 等待 Stream 推送的导出完成事件，事件中包含 Markdown 全文
+4. 若钉钉因服务端缓存未推送新事件，自动重试一次（总等待上限约 50s）
+5. 导出结果在进程内缓存，同一文档再次请求直接返回
+
+### 仅浏览器模式文档读取
+
+使用 Playwright 驱动 Chromium 无头浏览器：
+
+1. 导航到文档页面（`https://alidocs.dingtalk.com/i/nodes/{nodeId}`）
+2. 等待 SPA 渲染完成，在 iframe 及主页面中依次查找内容区元素
+3. 提取 HTML 内容并转换为 Markdown
+
+## 从 npm 安装
+
+```bash
+npx @insightsuen/dingdoc
+```
+
+在 MCP 客户端配置中使用（无需本地安装）：
+
+```json
+{
+  "mcpServers": {
+    "dingdoc": {
+      "command": "npx",
+      "args": ["-y", "@insightsuen/dingdoc@latest"],
+      "env": {
+        "DINGTALK_APP_KEY": "xxx",
+        "DINGTALK_APP_SECRET": "xxx",
+        "DINGTALK_UNION_ID": "xxx"
+      }
+    }
+  }
+}
+```
+
+> **注意**：首次使用浏览器模式时，`npx` 方式无法弹出登录窗口（headless 环境）。建议先在本地完成一次登录，session 保存后再用 `npx` 方式运行。
+
+## 从源码构建
+
+```bash
+# 克隆仓库后在项目根目录执行
+pnpm install
+pnpm --filter @insightsuen/dingdoc build
+
+# 安装 Playwright 浏览器（仅浏览器模式需要）
+pnpm --filter @insightsuen/dingdoc exec playwright install chromium
+```
+
+## 手动启动 / 调试
+
+```bash
+# 使用环境变量
+DINGTALK_APP_KEY=xxx DINGTALK_APP_SECRET=xxx DINGTALK_UNION_ID=xxx \
+  node servers/dingdoc/dist/index.js
+
+# 使用 CLI 参数
+node servers/dingdoc/dist/index.js \
+  --app-key=xxx \
+  --app-secret=xxx \
+  --union-id=xxx
+
+# MCP Inspector
+npx @modelcontextprotocol/inspector node servers/dingdoc/dist/index.js
+```

package/dist/auth.d.ts

@@ -0,0 +1,19 @@
+export declare function getAccessToken(): Promise<string>;
+export declare function getOperatorId(): Promise<string>;
+/** 返回应用凭证（供 stream 客户端使用） */
+export declare function getAppCredentials(): {
+    appKey: string | undefined;
+    appSecret: string | undefined;
+};
+/**
+ * 判断 API 凭证是否已配置（不抛错）。
+ * 凭证缺失时服务器以"仅浏览器模式"运行，所有文档读取走 Playwright。
+ */
+export declare function isApiConfigured(): boolean;
+/** 标记 API 已通过验证，可正常使用 */
+export declare function setApiAvailable(val: boolean): void;
+/** 返回 API 是否已通过验证并可用（凭证存在 + 启动时验证通过） */
+export declare function isApiAvailable(): boolean;
+/** 启动时验证凭证有效性，失败则抛出错误 */
+export declare function validateCredentials(): Promise<void>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAsEA,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAqCtD;AAyBD,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAwCrD;AAED,6BAA6B;AAC7B,wBAAgB,iBAAiB,IAAI;IAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAKjG;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAOzC;AAMD,yBAAyB;AACzB,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAElD;AAED,wCAAwC;AACxC,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAID,yBAAyB;AACzB,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAUzD"}

package/dist/auth.js

@@ -0,0 +1,178 @@
+import { logger } from "@insight-mcp/shared";
+const OAUTH_URL = "https://api.dingtalk.com/v1.0/oauth2/accessToken";
+const USER_GET_URL = "https://oapi.dingtalk.com/topapi/v2/user/get";
+const LEAD_TIME_MS = 10 * 60 * 1000; // 提前 10 分钟刷新
+let cachedToken = null;
+let tokenExpiresAt = 0;
+let cachedOperatorId = null;
+// ─── CLI 参数解析 ─────────────────────────────────────────────────────────────
+/**
+ * 解析命令行参数，支持：
+ *   --app-key=xxx           直接传值
+ *   --app-key-env=MY_VAR    指定读取的环境变量名
+ */
+function parseCliArgs() {
+    const map = new Map();
+    for (const arg of process.argv.slice(2)) {
+        if (arg.startsWith("--")) {
+            const eqIdx = arg.indexOf("=");
+            if (eqIdx > 2) {
+                const key = arg.slice(2, eqIdx);
+                const val = arg.slice(eqIdx + 1);
+                map.set(key, val);
+            }
+        }
+    }
+    return map;
+}
+const CLI_ARGS = parseCliArgs();
+/**
+ * 凭证解析优先级：
+ *   1. CLI 直传：       --{argKey}=VALUE
+ *   2. 自定义 env 名：  --{argKey}-env=MY_VAR → process.env.MY_VAR
+ *   3. 默认 env 名：    process.env[defaultEnvKey]
+ */
+function resolveCredential(argKey, defaultEnvKey) {
+    // 1. CLI 直传
+    const direct = CLI_ARGS.get(argKey);
+    if (direct)
+        return direct;
+    // 2. 自定义 env var 名
+    const customEnvName = CLI_ARGS.get(`${argKey}-env`);
+    if (customEnvName) {
+        const val = process.env[customEnvName];
+        if (val)
+            return val;
+        logger.warn(`--${argKey}-env 指定了 ${customEnvName}，但该环境变量未设置`);
+    }
+    // 3. 默认 env var
+    return process.env[defaultEnvKey];
+}
+// ─── Access Token ─────────────────────────────────────────────────────────────
+export async function getAccessToken() {
+    const now = Date.now();
+    if (cachedToken && now < tokenExpiresAt) {
+        return cachedToken;
+    }
+    const appKey = resolveCredential("app-key", "DINGTALK_APP_KEY");
+    const appSecret = resolveCredential("app-secret", "DINGTALK_APP_SECRET");
+    if (!appKey || !appSecret) {
+        throw new Error([
+            "缺少钉钉应用凭证，请通过以下任一方式提供：",
+            "  • 环境变量：DINGTALK_APP_KEY / DINGTALK_APP_SECRET",
+            "  • CLI 参数：--app-key=xxx --app-secret=xxx",
+            "  • 自定义 env 名：--app-key-env=MY_VAR --app-secret-env=MY_VAR",
+            "  AppKey/AppSecret 可在钉钉开发者后台「凭证与基础信息」页面获取。",
+        ].join("\n"));
+    }
+    logger.debug("Refreshing DingTalk access token...");
+    const resp = await fetch(OAUTH_URL, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ appKey, appSecret, grantType: "client_credentials" }),
+    });
+    if (!resp.ok) {
+        throw new Error(`获取 access token 失败：HTTP ${resp.status}`);
+    }
+    const data = (await resp.json());
+    cachedToken = data.accessToken;
+    tokenExpiresAt = now + data.expireIn * 1000 - LEAD_TIME_MS;
+    logger.debug("DingTalk access token refreshed");
+    return cachedToken;
+}
+// ─── Operator ID（unionId）───────────────────────────────────────────────────
+/** 通过 userId 查询 unionId */
+async function fetchUnionId(userId) {
+    const token = await getAccessToken();
+    const resp = await fetch(`${USER_GET_URL}?access_token=${token}`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ userid: userId }),
+    });
+    if (!resp.ok) {
+        throw new Error(`获取 unionId 失败：HTTP ${resp.status}`);
+    }
+    const data = (await resp.json());
+    if (data.errcode !== 0 || !data.result?.unionid) {
+        throw new Error(`获取 unionId 失败：${data.errmsg}（errcode: ${data.errcode}）`);
+    }
+    return data.result.unionid;
+}
+export async function getOperatorId() {
+    if (cachedOperatorId)
+        return cachedOperatorId;
+    // 优先使用 unionId
+    const unionId = resolveCredential("union-id", "DINGTALK_UNION_ID");
+    if (unionId) {
+        cachedOperatorId = unionId;
+        return cachedOperatorId;
+    }
+    // 回退：通过 userId 换取 unionId
+    const userId = resolveCredential("user-id", "DINGTALK_USER_ID");
+    if (userId) {
+        logger.info([
+            `检测到 DINGTALK_USER_ID，正在查询对应的 unionId...`,
+            `  提示：你也可以直接设置 DINGTALK_UNION_ID 跳过此步骤，`,
+            `         unionId 可从钉钉开发者后台「用户管理」或首次运行日志中获取。`,
+        ].join("\n"));
+        const resolved = await fetchUnionId(userId);
+        logger.info(`  ✓ unionId 解析成功：${resolved}`);
+        logger.info(`  建议将 DINGTALK_UNION_ID=${resolved} 写入环境变量以加速后续启动。`);
+        cachedOperatorId = resolved;
+        return cachedOperatorId;
+    }
+    throw new Error([
+        "缺少操作人身份（unionId），请通过以下任一方式提供：",
+        "  • 环境变量（推荐）：DINGTALK_UNION_ID=xxx",
+        "  • 环境变量（自动解析）：DINGTALK_USER_ID=xxx  （将自动查询 unionId）",
+        "  • CLI 参数：--union-id=xxx  或  --user-id=xxx",
+        "  • 自定义 env 名：--union-id-env=MY_VAR",
+        "",
+        "  unionId 获取方式：",
+        "    1. 钉钉开发者后台 → 用户管理 → 点击用户 → 查看 unionId",
+        "    2. 或先设置 DINGTALK_USER_ID（如工号 BG012345），服务启动时会自动显示 unionId",
+    ].join("\n"));
+}
+/** 返回应用凭证（供 stream 客户端使用） */
+export function getAppCredentials() {
+    return {
+        appKey: resolveCredential("app-key", "DINGTALK_APP_KEY"),
+        appSecret: resolveCredential("app-secret", "DINGTALK_APP_SECRET"),
+    };
+}
+/**
+ * 判断 API 凭证是否已配置（不抛错）。
+ * 凭证缺失时服务器以"仅浏览器模式"运行，所有文档读取走 Playwright。
+ */
+export function isApiConfigured() {
+    const appKey = resolveCredential("app-key", "DINGTALK_APP_KEY");
+    const appSecret = resolveCredential("app-secret", "DINGTALK_APP_SECRET");
+    const hasUser = !!resolveCredential("union-id", "DINGTALK_UNION_ID") ||
+        !!resolveCredential("user-id", "DINGTALK_USER_ID");
+    return !!(appKey && appSecret && hasUser);
+}
+// ─── 运行时 API 可用状态 ──────────────────────────────────────────────────────
+let _apiAvailable = false;
+/** 标记 API 已通过验证，可正常使用 */
+export function setApiAvailable(val) {
+    _apiAvailable = val;
+}
+/** 返回 API 是否已通过验证并可用（凭证存在 + 启动时验证通过） */
+export function isApiAvailable() {
+    return _apiAvailable;
+}
+// ─── 启动验证 ─────────────────────────────────────────────────────────────────
+/** 启动时验证凭证有效性，失败则抛出错误 */
+export async function validateCredentials() {
+    logger.info("正在验证钉钉凭证...");
+    try {
+        await getAccessToken();
+        await getOperatorId();
+        logger.info("✓ 钉钉凭证验证成功");
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`钉钉凭证验证失败：\n${msg}`, { cause: err });
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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"}

package/dist/browser.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 通过浏览器访问钉钉文档并提取内容为 Markdown。
+ *
+ * 首次使用需要登录：
+ *   - 若检测到登录页，自动切换到有界面模式供用户完成登录
+ *   - 登录后 session 保存在 ~/.insight-mcp/dingdoc-browser/
+ *   - 后续调用直接复用登录状态（无需重新登录）
+ */
+export declare function fetchDocViaBrowser(nodeId: string): Promise<string>;
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAgEA;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA+HxE"}

package/dist/browser.js

@@ -0,0 +1,192 @@
+import { chromium } from "playwright";
+import path from "path";
+import os from "os";
+import TurndownService from "turndown";
+import { logger } from "@insight-mcp/shared";
+const USER_DATA_DIR = path.join(os.homedir(), ".insight-mcp", "dingdoc-browser");
+const DOC_BASE_URL = "https://alidocs.dingtalk.com/i/nodes";
+/**
+ * 钉钉文档内容区的候选选择器，按优先级排列。
+ * 钉钉编辑器（ne-engine / alidoc）的 DOM 结构可能随版本变化，保留多个备选。
+ */
+const CONTENT_SELECTORS = [
+    ".ne-viewer-body",
+    ".ne-doc-content",
+    ".ne-engine-body",
+    ".ne-doc",
+    "[class*='viewer-body']",
+    "[class*='docContent']",
+    "[class*='doc-content']",
+    "[class*='editor-body']",
+    "[class*='content-body']",
+    ".wiki-doc-content",
+    "article",
+];
+/** 判断当前页面是否需要登录 */
+function isLoginPage(url) {
+    return (url.includes("/login") ||
+        url.includes("/sso") ||
+        url.includes("oauth") ||
+        url.includes("dingtalk.com/o/") ||
+        url.includes("account.dingtalk.com"));
+}
+let browserContext = null;
+let browserContextHeadless = true;
+/** 获取或创建浏览器上下文（持久化，保留登录 session） */
+async function getContext(headless) {
+    if (browserContext && browserContextHeadless === headless) {
+        return browserContext;
+    }
+    if (browserContext) {
+        await browserContext.close();
+        browserContext = null;
+    }
+    logger.info(`[Browser] 启动 Chromium 持久化上下文（headless=${String(headless)}）...`);
+    logger.info(`[Browser] 浏览器数据目录：${USER_DATA_DIR}`);
+    browserContext = await chromium.launchPersistentContext(USER_DATA_DIR, {
+        headless,
+        viewport: { width: 1280, height: 900 },
+        locale: "zh-CN",
+    });
+    browserContextHeadless = headless;
+    return browserContext;
+}
+/**
+ * 通过浏览器访问钉钉文档并提取内容为 Markdown。
+ *
+ * 首次使用需要登录：
+ *   - 若检测到登录页，自动切换到有界面模式供用户完成登录
+ *   - 登录后 session 保存在 ~/.insight-mcp/dingdoc-browser/
+ *   - 后续调用直接复用登录状态（无需重新登录）
+ */
+export async function fetchDocViaBrowser(nodeId) {
+    const url = `${DOC_BASE_URL}/${nodeId}`;
+    logger.info(`[Browser] 正在通过浏览器访问文档，nodeId: ${nodeId}`);
+    let ctx = await getContext(true); // 先尝试 headless
+    let page = await ctx.newPage();
+    try {
+        await page.goto(url, { waitUntil: "domcontentloaded", timeout: 20_000 });
+        // 检测是否跳转到登录页
+        if (isLoginPage(page.url())) {
+            logger.warn("[Browser] 检测到登录页，切换到有界面模式，请在浏览器窗口中完成钉钉登录...");
+            await page.close();
+            // 切换到有界面模式
+            ctx = await getContext(false);
+            page = await ctx.newPage();
+            await page.goto(url, { waitUntil: "domcontentloaded", timeout: 20_000 });
+            // 等待用户登录并跳转回文档页（最多等 3 分钟）
+            if (isLoginPage(page.url())) {
+                logger.warn("[Browser] 请在打开的浏览器窗口中完成登录（最多等待 3 分钟）...");
+                await page.waitForURL((u) => u.href.startsWith(url), { timeout: 180_000 });
+                logger.info("[Browser] 登录成功，继续加载文档...");
+            }
+        }
+        // 等待网络空闲，让 SPA 完成渲染
+        await page.waitForLoadState("networkidle", { timeout: 20_000 }).catch(() => {
+            logger.warn("[Browser] 网络未完全空闲，继续尝试提取内容...");
+        });
+        // 优先在 iframe 内搜索内容（钉钉文档编辑区通常嵌入在 iframe 中）
+        const iframeCount = await page.locator("iframe").count();
+        logger.info(`[Browser] 检测到 ${iframeCount} 个 iframe`);
+        let iframeContentText = "";
+        if (iframeCount > 0) {
+            for (let i = 0; i < iframeCount; i++) {
+                try {
+                    const frame = page.frameLocator("iframe").nth(i);
+                    for (const sel of CONTENT_SELECTORS) {
+                        const count = await frame.locator(sel).count();
+                        if (count > 0) {
+                            const text = await frame.locator(sel).first().innerText();
+                            if (text.trim().length > 50) {
+                                iframeContentText = text;
+                                logger.info(`[Browser] 在 iframe[${i}] 的 "${sel}" 找到内容（${text.length} 字符）`);
+                                break;
+                            }
+                        }
+                    }
+                    if (iframeContentText)
+                        break;
+                    // 尝试 iframe 的 .ne-viewer-body 或 body
+                    const neViewer = await frame.locator(".ne-viewer-body, .ne-doc, [class*='viewer']").first().innerText().catch(() => "");
+                    if (neViewer.trim().length > 100) {
+                        iframeContentText = neViewer;
+                        logger.info(`[Browser] 在 iframe[${i}] ne-viewer 找到内容（${neViewer.length} 字符）`);
+                        break;
+                    }
+                    const bodyText = await frame.locator("body").innerText().catch(() => "");
+                    if (bodyText.trim().length > 100) {
+                        iframeContentText = bodyText;
+                        logger.info(`[Browser] 在 iframe[${i}] body 找到内容（${bodyText.length} 字符）`);
+                        break;
+                    }
+                }
+                catch {
+                    // iframe 跨域或其他错误，跳过
+                }
+            }
+        }
+        // 若 iframe 里没找到，再尝试主页面内容选择器
+        let contentText = iframeContentText;
+        let usedSelector = "";
+        if (!contentText) {
+            for (const selector of CONTENT_SELECTORS) {
+                try {
+                    const el = page.locator(selector).first();
+                    const visible = await el.isVisible({ timeout: 2_000 });
+                    if (visible) {
+                        const text = await el.innerText();
+                        if (text.trim().length > 50) {
+                            contentText = text;
+                            usedSelector = selector;
+                            logger.info(`[Browser] 使用选择器 "${selector}" 提取到内容（${text.length} 字符）`);
+                            break;
+                        }
+                    }
+                }
+                catch {
+                    // 继续尝试下一个
+                }
+            }
+        }
+        if (!contentText) {
+            // 回退：获取 body 全文（Playwright 的 innerText 会自动跳过不可见元素）
+            logger.warn("[Browser] 未找到文档内容区，回退到 body 全文（innerText）");
+            contentText = await page.locator("body").innerText().catch(() => "");
+        }
+        // 若找到了 HTML 结构的选择器则转 Markdown，否则直接返回纯文本
+        let result;
+        if (usedSelector) {
+            const html = await page.locator(usedSelector).first().innerHTML();
+            const td = new TurndownService({
+                headingStyle: "atx",
+                codeBlockStyle: "fenced",
+                bulletListMarker: "-",
+            });
+            td.addRule("removeNav", {
+                filter: ["nav", "header", "footer", "aside"],
+                replacement: () => "",
+            });
+            result = td.turndown(html).trim();
+        }
+        else {
+            result = contentText.trim();
+        }
+        logger.info(`[Browser] 文档提取成功，长度: ${result.length} 字符`);
+        return result;
+    }
+    finally {
+        await page.close();
+    }
+}
+// 进程退出时关闭浏览器
+process.on("exit", () => {
+    if (browserContext) {
+        void browserContext.close();
+    }
+});
+process.on("SIGINT", () => {
+    if (browserContext) {
+        void browserContext.close().then(() => process.exit(0));
+    }
+});
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,10 @@
+export declare class DingTalkApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+/** GET 请求，自动附加认证头和 operatorId */
+export declare function dingtalkGet<T>(path: string, params?: Record<string, string | number | boolean>): Promise<T>;
+/** POST 请求，自动附加认证头 */
+export declare function dingtalkPost<T>(path: string, body?: Record<string, unknown>): Promise<T>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAIA,qBAAa,gBAAiB,SAAQ,KAAK;aAEvB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;gBADZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM;CAKlB;AAOD,iCAAiC;AACjC,wBAAsB,WAAW,CAAC,CAAC,EACjC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAM,GACrD,OAAO,CAAC,CAAC,CAAC,CA6BZ;AAED,sBAAsB;AACtB,wBAAsB,YAAY,CAAC,CAAC,EAClC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,CAAC,CAAC,CA2BZ"}