dsh-web-search-pro 0.1.2 → 0.1.4

package/LOGIN.md

@@ -16,16 +16,29 @@ node scripts/save-login.mjs all login-state.json
 node scripts/save-login.mjs zhihu login-state.json
 ```
 
-然后把文件路径填到 `$DSH_HOME/settings.yaml`：
+然后在 dsh-browser 的部署配置中创建命名、按域名授权的 AuthProfile：
 
 ```yaml
+# cordis.yml 中的 dsh-browser 插件行
+- id: browser
+  name: '@anweat/dsh-browser'
+  config:
+    authProfiles:
+      china-community:
+        storageStatePath: 'D:/secrets/login-state.json'
+        allowedDomains: [zhihu.com, weibo.com, douban.com, baidu.com, douyin.com, kuaishou.com]
+        persistState: false
+
+# $DSH_HOME/settings.yaml
+---
 web-search-pro:
-  playwright:
-    storageStatePath: 'login-state.json'   # 绝对路径更稳
+  browserBindings:
+    zhihu: { authProfile: china-community }
+    weibo: { authProfile: china-community }
 ```
 
 > storageState 是 Playwright 的标准登录态文件（cookies + origins），
-> 同一份文件可同时含多个站点的登录态（脚本会依次登录并合并）。
+> 同一份文件可含多个站点登录态，但每个 AuthProfile 必须显式给出 `allowedDomains`；访问其他域名会被拒绝。`persistState` 默认 false，只有明确开启才会原子回写新 Cookie/localStorage。
 
 ## 方式二：用 Cookie 插件导出
 
@@ -41,6 +54,34 @@ web-search-pro:
 
 每个 cookie 至少需要 `name` `value` `domain` `path`（可补 `expires` `httpOnly` `secure`）。
 
+不要把 Cookie JSON 作为模型工具参数传入；导入到本地 storageState 文件后只在配置中引用路径。
+
+## 受控脚本增强（RulePack V2）
+
+dsh-browser 可配置命名 RulePack。它支持有界的 `waitFor` / `click` / `scroll` / `wait` 步骤；可选 init script 只能引用本地文件，必须提供 SHA-256，且文件不超过 64KB。RulePack 同样按 `matches` 限域，不接受模型直接提交任意 JavaScript。
+
+```yaml
+rulePacks:
+  zhihu-enhanced:
+    matches: [zhihu.com]
+    initScriptPath: 'D:/dsh/rules/zhihu-init.js'
+    initScriptSha256: '<64位sha256>'
+    steps:
+      - { type: waitFor, selector: '.SearchResult-Card', timeoutMs: 10000 }
+      - { type: scroll, deltaY: 1600, repeat: 2, waitMs: 300 }
+```
+
+## OpenCLI 社区平台
+
+Reddit / 小红书 / Twitter / Instagram / Facebook 走 OpenCLI Browser Bridge，使用当前 Chrome 扩展会话，不读取或导出 Cookie。`dsh-browser` 已包含 OpenCLI CLI，但 Chrome 扩展必须已安装并连接：
+
+```bash
+opencli doctor
+opencli reddit search "DeepSeek Harness" -f yaml
+```
+
+若 `doctor` 显示 daemon 正常但 extension disconnected，请启动安装了 OpenCLI 扩展的 Chrome profile；不要把 Quark 或禁用扩展的 Playwright 临时 profile 当作替代。只有需要在终端独立诊断时，才需要额外全局安装 `@jackwener/opencli`。
+
 ## 结果选择器可配置
 
 站点改版后如果提取不到结果，不用改代码——在 `settings.yaml` 按平台覆盖选择器：

package/README.md

@@ -2,7 +2,7 @@
 
 增强型、可持久化的扩展网页搜索插件 for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）。
 
-一个 DSH **bundle 插件**，把多引擎网页搜索、平台搜索、持久化缓存、脚本猫式按站提取、Playwright 渲染打包成模型可直接调用的 9 个工具。灵感来自 [MediaCrawler](https://github.com/NanmiCoder/MediaCrawler)、[Agent-Reach](https://github.com/Panniantong/Agent-Reach)、脚本猫/油猴 userscript、opencli 与 playwright。
+一个 DSH **bundle 插件**，把多引擎网页搜索、平台搜索、持久化缓存、受控按站增强和 Playwright 渲染打包成模型可直接调用的 11 个工具。路由控制面借鉴 Agent-Reach 的后端探测、顺序选择和失败冷却思路，核心逻辑为本项目原生 TypeScript 实现。
 
 ## 安装
 
@@ -14,22 +14,44 @@ dsh plugin --profile web add ./dsh-web-search-pro
 dsh --profile web
 ```
 
-> dsh-browser 需先发布到 npm（本地测试可用 `dsh plugin --profile web add ../dsh-browser ../dsh-web-search-pro` 一条命令显式列两个）。
+> npm 安装会解析 `@anweat/dsh-browser`；本地联调可用 `dsh plugin --profile web add ../dsh-browser ../dsh-web-search-pro` 一条命令显式列两个。
 > 依赖 `@deepseek-ai/*` 已发布到 npm（`^0.1.0-rc.6`，与社区 dsh-cc-tui 一致）。
 > 若你的 harness 是本地源码 checkout（如 `0.1.0-rc.5`），版本号可能有出入——用
 > `dsh plugin --profile web add ./<path>` 并在 profile 的 `pnpm-workspace.yaml`
 > 里对齐版本后重装即可。
 
-## 工具（9 个）
+## 快速使用与适用情形
+
+安装并重启后，直接在 DSH 会话里要求模型调用工具即可：
+
+```text
+请调用 web_backend_status 检查后端，然后用 web_search_pro 搜索
+"DeepSeek Harness community feedback"，指定 exa、fresh=true、返回 8 条来源。
+```
+
+| 情形 | 推荐入口 | 说明 |
+|---|---|---|
+| 日常网页搜索 | `web_search_pro` | 默认按配置顺序回退；需要强制刷新时传 `fresh=true` |
+| 语义研究、社区观点 | `web_search_pro` + `exa` | 有 API Key 时走原生 Exa API；只有 Exa MCP 连接时自动经 `mcporter` 回退 |
+| 已知 URL 的批量正文 | `web_exa_contents` | 直接调用 Exa `/contents`，必须配置 `EXA_API_KEY` |
+| GitHub/B站/Reddit 等平台 | `web_platform_search` | Reddit 等 OpenCLI 平台需要 Chrome 扩展在线；中文受限站点使用 AuthProfile |
+| 登录后页面或私有论坛 | `browserBindings` + AuthProfile | Cookie 保存在本地 storageState，按域名授权，默认只读 |
+| 页面改版、懒加载 | `platformRules` 或 RulePack | 优先改选择器；需要等待/点击/滚动时再使用有界 RulePack |
+
+先运行 `web_backend_status` 判断后端是否 ready。指定单一引擎时失败会原样返回；不指定时才会按 `engines` 顺序自动回退。
+
+## 工具（11 个）
 
 | 工具 | 作用 |
 |---|---|
 | `web_search_pro` | 多引擎搜索 + RRF 融合 + 内存/SQLite 双层缓存 + 历史 |
+| `web_exa_contents` | 原生 Exa `/contents` 批量正文抓取（1-100 URL） |
 | `web_fetch_pro` | 可读化抓取（Jina → HTTP+规则抽取 → Playwright 兜底）+ 快照缓存 |
 | `web_platform_search` | 20 平台：GitHub/B站/YouTube/V2EX/小红书/Twitter/Reddit/IG/FB/RSS + 知乎/微博/豆瓣/贴吧/抖音/快手（Playwright 登录态） |
 | `web_snapshot` | Playwright 全页截图 + HTML + 文本落盘 |
 | `web_history` / `web_cache_clear` / `web_search_stats` | 持久历史 / 清缓存 / 存储统计 |
 | `web_rule` | 持久化按站提取规则（脚本猫式，list/upsert/remove） |
+| `web_backend_status` | 无副作用后端探测、失败/冷却诊断与 CLI 状态 |
 | `web_deps` | 检测/安装外部依赖（gh/bili/yt-dlp/opencli/agent-reach/mcporter/playwright） |
 
 ## 配置
@@ -40,12 +62,16 @@ dsh --profile web
 
    ```yaml
    web-search-pro:
-     exaApiKey: 'sk-...'       # 或环境变量 EXA_API_KEY / .credentials.yaml
-     jinaApiKey: 'jina_...'    # 或环境变量 JINA_API_KEY
+     exaApiKeyEnv: EXA_API_KEY # 推荐：运行环境或凭据服务，不把密钥写入配置
+     jinaApiKeyEnv: JINA_API_KEY
      engines: [ddg, bing, exa, seam, jina]
      parallelEngines: false
      ttlSeconds: 3600
      searchMaxResults: 8
+     browserBindings:
+       zhihu:
+         authProfile: china-community
+         rulePack: zhihu-enhanced
    ```
 
 2. **cordis.yml `config:`**（部署级默认值，见 `cordis.patch.yml`）。
@@ -57,21 +83,24 @@ dsh --profile web
 
 | 依赖 | 用途 | 安装 |
 |---|---|---|
-| gh | GitHub 后端 | `winget install GitHub.cli` / `choco install gh` |
 | bili-cli | B站后端 | `uv tool install bili-cli` / `pipx install bili-cli` |
 | yt-dlp | YouTube 后端 | `uv tool install yt-dlp` / `pip install yt-dlp` |
-| opencli | 小红书/Twitter/Reddit/IG/FB | `npm i -g opencli` |
+| opencli | 小红书/Twitter/Reddit/IG/FB | 由 dsh-browser 内置；扩展未连接时用 `opencli doctor` 诊断 |
 | agent-reach | agent-reach 后端 | `uv tool install agent-reach` / `pip install agent-reach` |
-| playwright | 渲染/截图后端 | `npm i -g playwright && playwright install chromium` |
+| mcporter | 无裸 API Key 时的 Exa MCP 回退 | `npm i -g mcporter` |
+| playwright | 渲染/截图后端 | 由 dsh-browser 内置；缺 Chromium 时调用 `browser_install` |
 
 ## 平台与引擎
 
-`seam`（ctx.web/DeepSeek 原生）· `exa` · `ddg` · `bing` · `jina` · `github` · `bilibili` · `v2ex` · `youtube`。默认顺序 `ddg, bing, exa, seam, jina`（免费优先），失败自动回退；`multi` 并行融合。
+`seam`（ctx.web/DeepSeek 原生）· `exa` · `ddg` · `bing` · `jina` · `github`（REST 搜索 API，免 CLI；可选 `$GITHUB_TOKEN`/`githubToken` 提升限额并解锁代码搜索）· `bilibili` · `v2ex` · `youtube`。默认顺序 `ddg, bing, exa, seam, jina`（免费优先），失败自动回退；失败后短时冷却，`web_backend_status` 可查看原因；`multi` 并行融合。
+
+Exa 优先使用原生 API 客户端：`web_search_pro` 可传 `exaType`、域名包含/排除、发布时间范围和 category。若没有裸 API Key、但启用了 CLI 后端且 Exa MCP 已连接，搜索会自动通过 `mcporter` 完成；该兼容路径只支持 query + 结果数，高级筛选和 `web_exa_contents` 仍要求 `EXA_API_KEY`。不同选项、结果数、引擎顺序和单/多引擎模式使用不同缓存指纹。
 
 ## 开发
 
 ```bash
 pnpm install
+pnpm test
 pnpm build        # tsc src → lib
 ```
 
@@ -88,8 +117,8 @@ zhihu / weibo / douban / tieba / douyin / kuaishou 的免登录公开接口都
 所以走 **Playwright 驱动登录态浏览器**（借鉴 MediaCrawler 思路、MIT 独立实现，未用其签名算法）：
 
 1. 登录一次保存登录态：`node scripts/save-login.mjs all login-state.json`
-2. 在 `$DSH_HOME/settings.yaml` 里设 `playwright.storageStatePath`
-3. 站点改版时无需改代码，用 `platformRules` 按平台覆盖结果选择器
+2. 在 dsh-browser 配置中声明按域名隔离的 `authProfiles`
+3. 在 `browserBindings` 把平台绑定到 profile；站点改版时用 `platformRules` 或 dsh-browser `rulePacks`
 
 详见 [LOGIN.md](./LOGIN.md)。
 
@@ -99,9 +128,9 @@ zhihu / weibo / douban / tieba / douyin / kuaishou 的免登录公开接口都
 web_history 支持：kind/query/engine/platform 过滤、replay（用 queryId 回放已存结果）、
 export（把过滤后的历史+结果写成 JSON 文件）。
 
-## 自定义平台（解析 cookie 去搜索）
+## 自定义平台
 
-在 settings.yaml 里定义任意站点（URL 模板 + 结果选择器 + 可选 Cookie），
+在 settings.yaml 里定义任意站点（URL 模板 + 结果选择器），
 web_platform_search 就能直接搜它——不需要改代码：
 
     web-search-pro:
@@ -112,12 +141,16 @@ web_platform_search 就能直接搜它——不需要改代码：
           item: '.bili-video-card'
           title: '.bili-video-card__info--tit'
           link: 'a'
-        # 需要登录的站点补 cookie（a=b; c=d，自动应用到 url 域名）
+        # 需要登录时优先通过 browserBindings 绑定命名 authProfile。
         myforum:
           name: '某论坛'
           url: 'https://forum.example.com/search?q={query}'
           item: '.thread'
           title: '.thread-title a'
           link: '.thread-title a'
-          cookie: 'sessionid=abc123; csrftoken=xyz'
+      browserBindings:
+        myforum:
+          authProfile: forum
+
+旧版 `customPlatforms.*.cookie` 仍兼容，但会让 Cookie 明文进入配置；新配置应使用 dsh-browser 的命名 AuthProfile，状态文件不要提交到仓库。
 

package/cordis.patch.yml

@@ -1,20 +1,11 @@
 # dsh-web-search-pro bundle patch.
 #
-# Install (self-contained — also pulls in dsh-browser as a dependency):
-#   dsh plugin --profile <name> add dsh-web-search-pro
+# Install BOTH bundles (DSH activates only DIRECT dependencies' bundle layers):
+#   dsh plugin --profile <name> add @anweat/dsh-browser dsh-web-search-pro
 #
-# The patch inserts BOTH rows: browser (the dsh-browser runtime this plugin
-# injects) and web-search-pro. dsh-browser is declared as a regular
-# dependency in package.json, so pnpm installs it; because dsh plugin
-# reconcile only auto-mounts DIRECT dependencies' patches, the parent plugin
-# inserts the child's row here so one command activates both.
+# @anweat/dsh-browser is declared as a peerDependency: it provides the browser
+# service that this plugin injects (inject: ['browser']).
 - insert:
-    - id: browser
-      name: '@anweat/dsh-browser'
-      config:
-        channel: chromium
-        headless: true
-        opencliEnabled: true
     - id: web-search-pro
       name: dsh-web-search-pro
       config:

package/lib/backend-registry.d.ts

@@ -0,0 +1,38 @@
+export interface BackendProbe {
+    available: boolean;
+    reason?: string;
+}
+export interface Backend<I, O> {
+    id: string;
+    probe(): BackendProbe;
+    run(input: I): Promise<O>;
+}
+export interface BackendDiagnostic {
+    id: string;
+    available: boolean;
+    state: 'ready' | 'unavailable' | 'cooldown';
+    reason?: string;
+    lastError?: string;
+    cooldownUntil?: string;
+}
+export declare class BackendRegistry<I, O> {
+    private readonly options;
+    private readonly entries;
+    private readonly failures;
+    constructor(options?: {
+        cooldownMs?: number;
+    });
+    register(backend: Backend<I, O>): this;
+    run(input: I, options: {
+        preferred: readonly string[];
+        override?: string;
+    }): Promise<O>;
+    runSelected(input: I, options: {
+        preferred: readonly string[];
+        override?: string;
+    }): Promise<{
+        id: string;
+        value: O;
+    }>;
+    diagnostics(): BackendDiagnostic[];
+}

package/lib/backend-registry.js

@@ -0,0 +1,59 @@
+export class BackendRegistry {
+    options;
+    entries = new Map();
+    failures = new Map();
+    constructor(options = {}) {
+        this.options = options;
+    }
+    register(backend) {
+        if (this.entries.has(backend.id))
+            throw new Error('duplicate backend: ' + backend.id);
+        this.entries.set(backend.id, backend);
+        return this;
+    }
+    async run(input, options) {
+        return (await this.runSelected(input, options)).value;
+    }
+    async runSelected(input, options) {
+        const ids = options.override ? [options.override] : options.preferred;
+        const errors = [];
+        for (const id of ids) {
+            const backend = this.entries.get(id);
+            if (!backend) {
+                errors.push(id + ': unknown');
+                continue;
+            }
+            const failed = this.failures.get(id);
+            if (failed && failed.until > Date.now()) {
+                errors.push(id + ': cooldown');
+                continue;
+            }
+            const probe = backend.probe();
+            if (!probe.available) {
+                errors.push(id + ': ' + (probe.reason ?? 'unavailable'));
+                continue;
+            }
+            try {
+                const result = await backend.run(input);
+                this.failures.delete(id);
+                return { id, value: result };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                this.failures.set(id, { message, until: Date.now() + (this.options.cooldownMs ?? 30_000) });
+                errors.push(id + ': ' + message);
+            }
+        }
+        throw new Error('no backend succeeded: ' + errors.join('; '));
+    }
+    diagnostics() {
+        return [...this.entries.values()].map(backend => {
+            const probe = backend.probe();
+            const failed = this.failures.get(backend.id);
+            if (failed && failed.until > Date.now())
+                return { id: backend.id, available: probe.available, state: 'cooldown', lastError: failed.message, cooldownUntil: new Date(failed.until).toISOString() };
+            return { id: backend.id, available: probe.available, state: probe.available ? 'ready' : 'unavailable', ...probe.reason ? { reason: probe.reason } : {} };
+        });
+    }
+}
+//# sourceMappingURL=backend-registry.js.map

package/lib/backend-registry.js.map

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

package/lib/browser-service.d.ts

@@ -38,11 +38,15 @@ export interface BrowserService {
         signal?: AbortSignal;
         maxChars?: number;
         waitMs?: number;
+        authProfile?: string;
+        rulePack?: string;
     }): Promise<BrowserRenderResult>;
     snapshot(url: string, rules: readonly RenderRule[], opts: {
         signal?: AbortSignal;
         outDir: string;
         maxChars?: number;
+        authProfile?: string;
+        rulePack?: string;
     }): Promise<BrowserSnapshotResult>;
     searchResults(url: string, spec: {
         item: string;
@@ -59,6 +63,8 @@ export interface BrowserService {
             domain: string;
             path: string;
         }[];
+        authProfile?: string;
+        rulePack?: string;
     }): Promise<BrowserSearchItem[]>;
     opencli(args: string[], opts?: {
         timeoutMs?: number;

package/lib/cache-key.d.ts

@@ -0,0 +1,17 @@
+export interface SearchCacheInput {
+    query: string;
+    engines: readonly string[];
+    count: number;
+    multi: boolean;
+    exa?: Record<string, unknown>;
+}
+export interface PlatformCacheInput {
+    platform: string;
+    query: string;
+    url?: string;
+    count: number;
+    authProfile?: string;
+    rulePack?: string;
+}
+export declare function createSearchCacheKey(input: SearchCacheInput): string;
+export declare function createPlatformCacheKey(input: PlatformCacheInput): string;

package/lib/cache-key.js

@@ -0,0 +1,22 @@
+import crypto from 'node:crypto';
+function canonical(value) {
+    if (Array.isArray(value))
+        return value.map(canonical);
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value)
+            .filter(([, v]) => v !== undefined)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([k, v]) => [k, canonical(v)]));
+    }
+    return value;
+}
+function fingerprint(kind, input) {
+    return kind + ':v2:' + crypto.createHash('sha256').update(JSON.stringify(canonical(input))).digest('hex');
+}
+export function createSearchCacheKey(input) {
+    return fingerprint('search', { ...input, query: input.query.trim().replace(/\s+/g, ' ').toLowerCase() });
+}
+export function createPlatformCacheKey(input) {
+    return fingerprint('platform', { ...input, query: input.query.trim().replace(/\s+/g, ' ').toLowerCase() });
+}
+//# sourceMappingURL=cache-key.js.map

package/lib/cache-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-key.js","sourceRoot":"","sources":["../src/cache-key.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAA;AAmBhC,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACrD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;aACvE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC;aAClC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;aACtC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACxC,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,KAAc;IAC/C,OAAO,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC3G,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAuB;IAC1D,OAAO,WAAW,CAAC,QAAQ,EAAE,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;AAC1G,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAyB;IAC9D,OAAO,WAAW,CAAC,UAAU,EAAE,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;AAC5G,CAAC"}

package/lib/config.d.ts

@@ -15,6 +15,12 @@ export interface CustomPlatformSpec {
     /** Optional raw Cookie header (`a=b; c=d`); cookies are applied to the URL's domain. */
     cookie?: string;
 }
+export interface BrowserBinding {
+    /** Named dsh-browser auth profile. */
+    authProfile?: string;
+    /** Named dsh-browser enhancement rule pack. */
+    rulePack?: string;
+}
 export interface Config {
     /** SQLite database path; defaults to $DSH_HOME/data/web-search-pro/store.db */
     dbPath?: string;
@@ -48,7 +54,11 @@ export interface Config {
     jinaApiKey?: string;
     /** Credential/env reference for the Jina key; defaults to JINA_API_KEY. */
     jinaApiKeyEnv?: string;
-    /** Allow CLI backends (gh / bili / yt-dlp / opencli / agent-reach). */
+    /** GitHub API token for the REST search engines (falls back to $GITHUB_TOKEN / $GH_TOKEN / credentials ref). */
+    githubToken?: string;
+    /** Credential/env reference for the GitHub token; defaults to GITHUB_TOKEN. */
+    githubTokenEnv?: string;
+    /** Allow CLI backends (bili / yt-dlp / opencli / agent-reach). */
     enableCliBackends: boolean;
     /** Allow opencli browser-session backends. */
     opencliEnabled: boolean;
@@ -67,6 +77,8 @@ export interface Config {
     }>;
     /** User-defined custom platform search: url template + selectors + optional cookie. */
     customPlatforms?: Record<string, CustomPlatformSpec>;
+    /** Per-platform binding to domain-scoped dsh-browser auth/rule profiles. */
+    browserBindings?: Record<string, BrowserBinding>;
     /** Snapshot options. The browser runtime itself (channel/headless/storageStatePath) is provided by the dsh-browser plugin via the `browser` service. */
     playwright: {
         /** Gate the playwright fallback backend in web_fetch_pro. */
@@ -83,6 +95,7 @@ export interface ResolvedConfig extends Config {
     exaApiKeyEnv: string;
     jinaApiKey?: string;
     jinaApiKeyEnv: string;
+    githubTokenEnv: string;
     playwright: Required<Pick<Config['playwright'], 'enabled' | 'snapshotDir'>>;
 }
 /** Default database path under the harness home. */

package/lib/config.js

@@ -22,6 +22,8 @@ export const Config = z.object({
     exaApiKeyEnv: z.string().default('EXA_API_KEY'),
     jinaApiKey: z.string().role('secret'),
     jinaApiKeyEnv: z.string().default('JINA_API_KEY'),
+    githubToken: z.string().role('secret'),
+    githubTokenEnv: z.string().default('GITHUB_TOKEN'),
     enableCliBackends: z.boolean().default(true),
     opencliEnabled: z.boolean().default(true),
     agentReachEnabled: z.boolean().default(true),
@@ -42,6 +44,10 @@ export const Config = z.object({
         text: z.string(),
         cookie: z.string(),
     })),
+    browserBindings: z.dict(z.object({
+        authProfile: z.string(),
+        rulePack: z.string(),
+    })),
     playwright: z.object({
         enabled: z.boolean().default(true),
         snapshotDir: z.string(),
@@ -63,6 +69,7 @@ export function resolveConfig(config) {
         dbPath,
         exaApiKeyEnv: config.exaApiKeyEnv ?? 'EXA_API_KEY',
         jinaApiKeyEnv: config.jinaApiKeyEnv ?? 'JINA_API_KEY',
+        githubTokenEnv: config.githubTokenEnv ?? 'GITHUB_TOKEN',
         playwright: {
             enabled: pw.enabled ?? true,
             snapshotDir,

package/lib/config.js.map

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

package/lib/deps.d.ts

@@ -1,6 +1,6 @@
 /**
  * External dependency detection and install for the CLI/platform backends.
- * Most backends shell out to tools installed outside DSH (gh, bili, yt-dlp,
+ * Most backends shell out to tools installed outside DSH (bili, yt-dlp,
  * opencli, agent-reach, playwright, mcporter). This module reports which are
  * present and how to install them; the web_deps tool exposes it to the model.
  *

package/lib/deps.js

@@ -1,6 +1,6 @@
 /**
  * External dependency detection and install for the CLI/platform backends.
- * Most backends shell out to tools installed outside DSH (gh, bili, yt-dlp,
+ * Most backends shell out to tools installed outside DSH (bili, yt-dlp,
  * opencli, agent-reach, playwright, mcporter). This module reports which are
  * present and how to install them; the web_deps tool exposes it to the model.
  *
@@ -14,13 +14,6 @@ import { runCli } from "./util.js";
 const IS_WIN = process.platform === 'win32';
 /** One external tool the plugin may shell out to. */
 const DEPS = [
-    {
-        id: 'gh', label: 'GitHub CLI', usedBy: 'github 后端',
-        installs: [
-            { installer: 'winget', command: 'winget install GitHub.cli' },
-            { installer: 'choco', command: 'choco install gh' },
-        ],
-    },
     {
         id: 'bili', label: 'bili-cli', usedBy: 'bilibili 后端',
         installs: [
@@ -44,7 +37,7 @@ const DEPS = [
         ],
     },
     {
-        id: 'mcporter', label: 'mcporter', usedBy: '（预留：Exa MCP 后端）',
+        id: 'mcporter', label: 'mcporter', usedBy: 'Exa MCP fallback',
         installs: [
             { installer: 'npm', command: 'npm i -g mcporter' },
         ],

package/lib/deps.js.map

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

package/lib/engines.d.ts

@@ -7,6 +7,7 @@
 import type { WebSearchSource, WebRuntime } from '@deepseek-ai/dsh-web';
 import type { BrowserService } from './browser-service.ts';
 import type { CustomPlatformSpec } from './config.ts';
+import { type ExaSearchRequest } from './exa-client.ts';
 export interface SearchOutcome {
     /** Provider-generated answer/summary text, when any. */
     content?: string;
@@ -17,7 +18,14 @@ export interface Engine {
     label: string;
     /** Cheap local availability check; must not do network I/O. */
     available(): boolean;
-    search(query: string, count: number, signal?: AbortSignal): Promise<SearchOutcome>;
+    search(query: string, count: number, signal?: AbortSignal, options?: EngineSearchOptions): Promise<SearchOutcome>;
+}
+export interface EngineSearchOptions {
+    exa?: Omit<ExaSearchRequest, 'query' | 'numResults'>;
+    browser?: {
+        authProfile?: string;
+        rulePack?: string;
+    };
 }
 export declare class EngineError extends Error {
     readonly code: string;
@@ -28,6 +36,8 @@ export interface EngineDeps {
     web?: WebRuntime;
     exaApiKey?: string;
     jinaApiKey?: string;
+    /** GitHub API token (config githubToken / $GITHUB_TOKEN / $GH_TOKEN). */
+    githubToken?: string;
     enableCli: boolean;
     opencliEnabled: boolean;
     agentReachEnabled: boolean;
@@ -46,6 +56,8 @@ export interface EngineDeps {
     skipSeam: boolean;
 }
 export declare function seamEngine(deps: EngineDeps): Engine;
+/** Parse mcporter's human-readable Exa response into the router's native source shape. */
+export declare function parseMcporterExaSearch(output: string, count: number): WebSearchSource[];
 export declare function exaEngine(deps: EngineDeps): Engine;
 export declare function ddgEngine(): Engine;
 export declare function bingEngine(): Engine;