@baimingtao/lbs-agent 1.0.0

package/extensions/skills/optional/research/drug-discovery/scripts/chembl_target.py

@@ -0,0 +1,53 @@
+#!/usr/bin/env python3
+"""
+chembl_target.py — Search ChEMBL for a target and retrieve top active compounds.
+Usage: python3 chembl_target.py "EGFR" --min-pchembl 7 --limit 20
+No external dependencies.
+"""
+import sys, json, time, argparse
+import urllib.request, urllib.parse
+
+BASE = "https://www.ebi.ac.uk/chembl/api/data"
+
+def get(endpoint):
+    try:
+        req = urllib.request.Request(f"{BASE}{endpoint}", headers={"Accept":"application/json"})
+        with urllib.request.urlopen(req, timeout=15) as r:
+            return json.loads(r.read())
+    except Exception as e:
+        print(f"API error: {e}", file=sys.stderr); return None
+
+def main():
+    parser = argparse.ArgumentParser(description="ChEMBL target → active compounds")
+    parser.add_argument("target")
+    parser.add_argument("--min-pchembl", type=float, default=6.0)
+    parser.add_argument("--limit", type=int, default=10)
+    args = parser.parse_args()
+
+    enc = urllib.parse.quote(args.target)
+    data = get(f"/target/search?q={enc}&limit=5&format=json")
+    if not data or not data.get("targets"):
+        print("No targets found."); sys.exit(1)
+
+    t = data["targets"][0]
+    tid = t.get("target_chembl_id","")
+    print(f"\nTarget: {t.get('pref_name')} ({tid})")
+    print(f"Type: {t.get('target_type')} | Organism: {t.get('organism','N/A')}")
+    print(f"\nFetching compounds with pChEMBL ≥ {args.min_pchembl}...\n")
+
+    acts = get(f"/activity?target_chembl_id={tid}&pchembl_value__gte={args.min_pchembl}&assay_type=B&limit={args.limit}&order_by=-pchembl_value&format=json")
+    if not acts or not acts.get("activities"):
+        print("No activities found."); sys.exit(0)
+
+    print(f"{'Molecule':<18} {'pChEMBL':>8} {'Type':<12} {'Value':<10} {'Units'}")
+    print("-"*65)
+    seen = set()
+    for a in acts["activities"]:
+        mid = a.get("molecule_chembl_id","N/A")
+        if mid in seen: continue
+        seen.add(mid)
+        print(f"{mid:<18} {str(a.get('pchembl_value','N/A')):>8} {str(a.get('standard_type','N/A')):<12} {str(a.get('standard_value','N/A')):<10} {a.get('standard_units','N/A')}")
+        time.sleep(0.1)
+    print(f"\nTotal: {len(seen)} unique molecules")
+
+if __name__ == "__main__": main()

package/extensions/skills/optional/research/drug-discovery/scripts/ro5_screen.py

@@ -0,0 +1,44 @@
+#!/usr/bin/env python3
+"""
+ro5_screen.py — Batch Lipinski Ro5 + Veber screening via PubChem API.
+Usage: python3 ro5_screen.py aspirin ibuprofen paracetamol
+No external dependencies beyond stdlib.
+"""
+import sys, json, time
+import urllib.request, urllib.parse
+
+BASE = "https://pubchem.ncbi.nlm.nih.gov/rest/pug/compound/name"
+PROPS = "MolecularWeight,XLogP,HBondDonorCount,HBondAcceptorCount,RotatableBondCount,TPSA"
+
+def fetch(name):
+    url = f"{BASE}/{urllib.parse.quote(name)}/property/{PROPS}/JSON"
+    try:
+        with urllib.request.urlopen(url, timeout=10) as r:
+            return json.loads(r.read())["PropertyTable"]["Properties"][0]
+    except Exception:
+        return None
+
+def check(p):
+    mw,logp,hbd,hba,rot,tpsa = float(p.get("MolecularWeight",0)),float(p.get("XLogP",0)),int(p.get("HBondDonorCount",0)),int(p.get("HBondAcceptorCount",0)),int(p.get("RotatableBondCount",0)),float(p.get("TPSA",0))
+    v = sum([mw>500,logp>5,hbd>5,hba>10])
+    return dict(mw=mw,logp=logp,hbd=hbd,hba=hba,rot=rot,tpsa=tpsa,violations=v,ro5=v<=1,veber=tpsa<=140 and rot<=10,ok=v<=1 and tpsa<=140 and rot<=10)
+
+def report(name, r):
+    if not r: print(f"✗ {name:30s} — not found"); return
+    s = "✓ PASS" if r["ok"] else "✗ FAIL"
+    flags = (f" [Ro5 violations:{r['violations']}]" if not r["ro5"] else "") + (" [Veber fail]" if not r["veber"] else "")
+    print(f"{s}  {name:28s} MW={r['mw']:.0f} LogP={r['logp']:.2f} HBD={r['hbd']} HBA={r['hba']} TPSA={r['tpsa']:.0f} RotB={r['rot']}{flags}")
+
+def main():
+    compounds = sys.stdin.read().splitlines() if len(sys.argv)<2 or sys.argv[1]=="-" else sys.argv[1:]
+    print(f"\n{'Status':<8} {'Compound':<30} Properties\n" + "-"*85)
+    passed = 0
+    for name in compounds:
+        props = fetch(name.strip())
+        result = check(props) if props else None
+        report(name.strip(), result)
+        if result and result["ok"]: passed += 1
+        time.sleep(0.3)
+    print(f"\nSummary: {passed}/{len(compounds)} passed Ro5 + Veber.\n")
+
+if __name__ == "__main__": main()

package/extensions/skills/optional/research/duckduckgo-search/SKILL.md

@@ -0,0 +1,238 @@
+---
+name: duckduckgo-search
+description: 通过 DuckDuckGo 进行免费网络搜索 — 文本、新闻、图片、视频。无需 API 密钥。已安装的情况下，首选 `ddgs` CLI；仅在验证当前运行环境中 `ddgs` 可用后，才使用 Python DDGS 库。
+version: 1.3.0
+author: gamedevCloudy
+license: MIT
+platforms: [linux, macos, windows]
+metadata:
+  hermes:
+    tags: [search, duckduckgo, web-search, free, fallback]
+    related_skills: [arxiv]
+    fallback_for_toolsets: [web]
+---
+
+# DuckDuckGo 搜索
+
+使用 DuckDuckGo 进行免费网络搜索。**无需 API 密钥。**
+
+当 `web_search` 不可用或不合适时（例如未设置 `FIRECRAWL_API_KEY`），这是首选方案。当特别需要 DuckDuckGo 的结果时，也可以作为独立的搜索路径使用。
+
+## 检测流程
+
+在选择方案之前，请先检查实际可用的工具：
+
+```bash
+# Check CLI availability
+command -v ddgs >/dev/null && echo "DDGS_CLI=installed" || echo "DDGS_CLI=missing"
+```
+
+决策树：
+1. 如果已安装 `ddgs` CLI，优先使用 `terminal` + `ddgs`
+2. 如果未安装 `ddgs` CLI，不要假设 `execute_code` 能够导入 `ddgs`
+3. 如果用户明确想要使用 DuckDuckGo，请先在相关环境中安装 `ddgs`
+4. 否则，回退到内置的 web/browser 工具
+
+重要的运行时说明：
+- Terminal 和 `execute_code` 是独立的运行环境
+- 在 shell 中成功安装，并不能保证 `execute_code` 可以导入 `ddgs`
+- 绝不要假设 `execute_code` 中预装了第三方的 Python 包
+
+## 安装
+
+仅当明确需要使用 DuckDuckGo 搜索，且当前运行环境尚未提供该工具时，才安装 `ddgs`。
+
+```bash
+# Python package + CLI entrypoint
+pip install ddgs
+
+# Verify CLI
+ddgs --help
+```
+
+如果工作流依赖于 Python 导入，请在使用 `from ddgs import DDGS` 之前，验证该运行环境是否能够导入 `ddgs`。
+
+## 方法 1：CLI 搜索（首选）
+
+如果存在 `ddgs` 命令，则通过 `terminal` 使用。这是首选路径，因为它避免了假设 `execute_code` 沙盒中已安装 `ddgs` Python 包。
+
+```bash
+# Text search
+ddgs text -q "python async programming" -m 5
+
+# News search
+ddgs news -q "artificial intelligence" -m 5
+
+# Image search
+ddgs images -q "landscape photography" -m 10
+
+# Video search
+ddgs videos -q "python tutorial" -m 5
+
+# With region filter
+ddgs text -q "best restaurants" -m 5 -r us-en
+
+# Recent results only (d=day, w=week, m=month, y=year)
+ddgs text -q "latest AI news" -m 5 -t w
+
+# JSON output for parsing
+ddgs text -q "fastapi tutorial" -m 5 -o json
+```
+
+### CLI Flags
+
+| 标志 | 说明 | 示例 |
+| ------ | ------------- | --------- |
+| `-q` | 查询 — **必填** | `-q "search terms"` |
+| `-m` | 最大结果数 | `-m 5` |
+| `-r` | 区域 | `-r us-en` |
+| `-t` | 时间限制 | `-t w` (周) |
+| `-s` | 安全搜索 | `-s off` |
+| `-o` | 输出格式 | `-o json` |
+
+## 方法 2：Python API（仅在验证后使用）
+
+只有在验证了该环境中已安装 `ddgs` 后，才能在 `execute_code` 或其他 Python 运行时中使用 `DDGS` 类。不要默认 `execute_code` 包含了第三方包。
+
+推荐的说法：
+- “在安装或验证了所需的包之后，使用 `execute_code` 运行 `ddgs`”
+
+避免说：
+- “`execute_code` 包含了 `ddgs`”
+- “DuckDuckGo 搜索在 `execute_code` 中默认可用”
+
+**重要提示：** `max_results` 必须始终作为**关键字参数**传递 — 在所有方法中将其作为位置参数都会引发错误。
+
+### 文本搜索
+
+最适用于：一般研究、公司信息、文档。
+
+```python
+from ddgs import DDGS
+
+with DDGS() as ddgs:
+    for r in ddgs.text("python async programming", max_results=5):
+        print(r["title"])
+        print(r["href"])
+        print(r.get("body", "")[:200])
+        print()
+```
+
+返回字段：`title`, `href`, `body`
+
+### 新闻搜索
+
+最适用于：时事、突发新闻、最新更新。
+
+```python
+from ddgs import DDGS
+
+with DDGS() as ddgs:
+    for r in ddgs.news("AI regulation 2026", max_results=5):
+        print(r["date"], "-", r["title"])
+        print(r.get("source", ""), "|", r["url"])
+        print(r.get("body", "")[:200])
+        print()
+```
+
+返回字段：`date`, `title`, `body`, `url`, `image`, `source`
+
+### 图片搜索
+
+最适用于：视觉参考、产品图片、图表。
+
+```python
+from ddgs import DDGS
+
+with DDGS() as ddgs:
+    for r in ddgs.images("semiconductor chip", max_results=5):
+        print(r["title"])
+        print(r["image"])
+        print(r.get("thumbnail", ""))
+        print(r.get("source", ""))
+        print()
+```
+
+返回字段：`title`, `image`, `thumbnail`, `url`, `height`, `width`, `source`
+
+### 视频搜索
+
+最适用于：教程、演示、讲解。
+
+```python
+from ddgs import DDGS
+
+with DDGS() as ddgs:
+    for r in ddgs.videos("FastAPI tutorial", max_results=5):
+        print(r["title"])
+        print(r.get("content", ""))
+        print(r.get("duration", ""))
+        print(r.get("provider", ""))
+        print(r.get("published", ""))
+        print()
+```
+
+返回字段：`title`, `content`, `description`, `duration`, `provider`, `published`, `statistics`, `uploader`
+
+### 快速参考
+
+| 方法 | 适用场景 | 关键字段 |
+| -------- | ---------- | ------------ |
+| `text()` | 一般研究、公司信息 | title, href, body |
+| `news()` | 时事、更新 | date, title, source, body, url |
+| `images()` | 视觉素材、图表 | title, image, thumbnail, url |
+| `videos()` | 教程、演示 | title, content, duration, provider |
+
+## 工作流：搜索并提取
+
+DuckDuckGo 返回的是标题、URL 和摘要片段 — 而不是完整的页面内容。要获取完整的页面内容，请先进行搜索，然后使用 `web_extract`、浏览器工具或 curl 提取最相关的 URL。
+
+CLI 示例：
+
+```bash
+ddgs text -q "fastapi deployment guide" -m 3 -o json
+```
+
+Python 示例（仅在验证了该运行环境中已安装 `ddgs` 之后使用）：
+
+```python
+from ddgs import DDGS
+
+with DDGS() as ddgs:
+    results = list(ddgs.text("fastapi deployment guide", max_results=3))
+    for r in results:
+        print(r["title"], "->", r["href"])
+```
+
+然后使用 `web_extract` 或其他内容检索工具提取最佳的 URL。
+
+## 限制
+
+- **速率限制**：DuckDuckGo 可能会在大量快速请求后进行限流。如有需要，请在搜索之间添加短暂的延迟。
+- **无内容提取**：`ddgs` 返回的是摘要片段，而不是完整的页面内容。请使用 `web_extract`、浏览器工具或 curl 获取完整的文章/页面。
+- **结果质量**：总体良好，但不如 Firecrawl 搜索的可配置性高。
+- **可用性**：DuckDuckGo 可能会拦截来自某些云端 IP 的请求。如果搜索返回为空，请尝试更换关键词或等待几秒钟。
+- **字段可变性**：返回的字段可能因结果或 `ddgs` 版本而异。对可选字段请使用 `.get()` 以避免引发 `KeyError`。
+- **独立的运行时**：在 terminal 中成功安装 `ddgs`，并不自动意味着 `execute_code` 可以导入它。
+
+## 故障排查
+
+| 问题 | 可能的原因 | 处理方法 |
+| --------- | -------------- | ------------ |
+| `ddgs: command not found` | shell 环境中未安装 CLI | 安装 `ddgs`，或者改用内置的 web/browser 工具 |
+| `ModuleNotFoundError: No module named 'ddgs'` | Python 运行环境中未安装该包 | 在准备好该运行环境之前，不要在此处使用 Python DDGS |
+| 搜索没有返回任何结果 | 暂时的速率限制或查询词不佳 | 等待几秒钟，重试，或者调整查询词 |
+| CLI 可用但 `execute_code` 导入失败 | Terminal 和 `execute_code` 是不同的运行环境 | 继续使用 CLI，或者单独准备 Python 运行环境 |
+
+## 常见陷阱
+
+- **`max_results` 仅限关键字参数**：`ddgs.text("query", 5)` 会引发错误。请使用 `ddgs.text("query", max_results=5)`。
+- **不要假设 CLI 存在**：在使用前请检查 `command -v ddgs`。
+- **不要假设 `execute_code` 可以导入 `ddgs`**：除非单独准备了该运行时，否则 `from ddgs import DDGS` 可能会失败并提示 `ModuleNotFoundError`。
+- **包名**：该包名为 `ddgs`（以前为 `duckduckgo-search`）。使用 `pip install ddgs` 进行安装。
+- **不要混淆 `-q` 和 `-m`**（CLI）：`-q` 用于查询词，`-m` 用于指定最大结果数。
+- **空结果**：如果 `ddgs` 未返回任何内容，可能是受到了速率限制。请等待几秒钟并重试。
+
+## 验证依据
+
+已针对 `ddgs==9.11.2` 的语义验证了相关示例。此技能指南现在将 CLI 可用性与 Python 导入可用性视为两个独立的问题，因此文档中记录的工作流与实际的运行时行为相符。

package/extensions/skills/optional/research/duckduckgo-search/scripts/duckduckgo.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+# DuckDuckGo Search Helper Script
+# Wrapper around ddgs CLI with sensible defaults
+# Usage: ./duckduckgo.sh <query> [max_results]
+
+set -e
+
+QUERY="$1"
+MAX_RESULTS="${2:-5}"
+
+if [ -z "$QUERY" ]; then
+    echo "Usage: $0 <query> [max_results]"
+    echo ""
+    echo "Examples:"
+    echo "  $0 'python async programming' 5"
+    echo "  $0 'latest AI news' 10"
+    echo ""
+    echo "Requires: pip install ddgs"
+    exit 1
+fi
+
+# Check if ddgs is available
+if ! command -v ddgs &> /dev/null; then
+    echo "Error: ddgs not found. Install with: pip install ddgs"
+    exit 1
+fi
+
+ddgs text -q "$QUERY" -m "$MAX_RESULTS"

package/extensions/skills/optional/research/gitnexus-explorer/SKILL.md

@@ -0,0 +1,196 @@
+---
+name: gitnexus-explorer
+description: 使用 GitNexus 为代码库创建索引，并通过 web UI + Cloudflare tunnel 提供交互式知识图谱服务。
+version: 1.0.0
+author: Hermes Agent + Teknium
+license: MIT
+platforms: [linux, macos, windows]
+metadata:
+  hermes:
+    tags: [gitnexus, code-intelligence, knowledge-graph, visualization]
+    related_skills: [native-mcp, codebase-inspection]
+---
+
+# GitNexus Explorer
+
+将任何代码库索引为知识图谱，并提供交互式 web UI，用于探索符号、调用链、集群和执行流。通过 Cloudflare 隧道进行远程访问。
+
+## 何时使用
+
+- 用户希望以可视化方式探索代码库的架构
+- 用户需要仓库的知识图谱 / 依赖图
+- 用户希望与他人共享交互式代码库浏览器
+
+## 前置条件
+
+- **Node.js** (v18+) — 运行 GitNexus 和代理所必需
+- **git** — 仓库必须包含 `.git` 目录
+- **cloudflared** — 用于建立隧道（如果不存在，会自动安装到 ~/.local/bin）
+
+## 规模警告
+
+Web UI 会在浏览器中渲染所有节点。文件数在 5,000 个左右的仓库运行良好。大型仓库（3 万个以上节点）会导致浏览器卡顿或标签页崩溃。CLI/MCP 工具适用于任何规模——只有 Web 可视化存在此限制。
+
+## 步骤
+
+### 1. 克隆并构建 GitNexus（一次性设置）
+
+```bash
+GITNEXUS_DIR="${GITNEXUS_DIR:-$HOME/.local/share/gitnexus}"
+
+if [ ! -d "$GITNEXUS_DIR/gitnexus-web/dist" ]; then
+  git clone https://github.com/abhigyanpatwari/GitNexus.git "$GITNEXUS_DIR"
+  cd "$GITNEXUS_DIR/gitnexus-shared" && npm install && npm run build
+  cd "$GITNEXUS_DIR/gitnexus-web" && npm install
+fi
+```
+
+### 2. 修改 Web UI 以支持远程访问
+
+Web UI 默认调用 `localhost:4747` 进行 API 请求。请将其修改为使用同源策略，以便通过隧道/代理正常工作：
+
+**文件：`$GITNEXUS_DIR/gitnexus-web/src/config/ui-constants.ts`**
+更改：
+```typescript
+export const DEFAULT_BACKEND_URL = 'http://localhost:4747';
+```
+为：
+```typescript
+export const DEFAULT_BACKEND_URL = typeof window !== 'undefined' && window.location.hostname !== 'localhost' ? window.location.origin : 'http://localhost:4747';
+```
+
+**文件：`$GITNEXUS_DIR/gitnexus-web/vite.config.ts`**
+在 `server: { }` 块内添加 `allowedHosts: true`（仅在以开发模式而非生产构建运行时需要）：
+```typescript
+server: {
+    allowedHosts: true,
+    // ... existing config
+},
+```
+
+然后构建生产包：
+```bash
+cd "$GITNEXUS_DIR/gitnexus-web" && npx vite build
+```
+
+### 3. 为目标仓库创建索引
+
+```bash
+cd /path/to/target-repo
+npx gitnexus analyze --skip-agents-md
+rm -rf .claude/    # remove Claude Code-specific artifacts
+```
+
+添加 `--embeddings` 可启用语义搜索（速度较慢 — 需要几分钟而不是几秒）。
+
+索引位于仓库内的 `.gitnexus/` 目录中（会被自动添加到 gitignore）。
+
+### 4. 创建代理脚本
+
+将以下内容写入文件（例如 `$GITNEXUS_DIR/proxy.mjs`）。它会提供生产环境的 Web UI 服务，并将 `/api/*` 代理到 GitNexus 后端 —— 同源、无 CORS 问题、无需 sudo、无需 nginx。
+
+```javascript
+import http from 'node:http';
+import fs from 'node:fs';
+import path from 'node:path';
+
+const API_PORT = parseInt(process.env.API_PORT || '4747');
+const DIST_DIR = process.argv[2] || './dist';
+const PORT = parseInt(process.argv[3] || '8888');
+
+const MIME = {
+  '.html': 'text/html', '.js': 'application/javascript', '.css': 'text/css',
+  '.json': 'application/json', '.png': 'image/png', '.svg': 'image/svg+xml',
+  '.ico': 'image/x-icon', '.woff2': 'font/woff2', '.woff': 'font/woff',
+  '.wasm': 'application/wasm',
+};
+
+function proxyToApi(req, res) {
+  const opts = {
+    hostname: '127.0.0.1', port: API_PORT,
+    path: req.url, method: req.method, headers: req.headers,
+  };
+  const proxy = http.request(opts, (upstream) => {
+    res.writeHead(upstream.statusCode, upstream.headers);
+    upstream.pipe(res, { end: true });
+  });
+  proxy.on('error', () => { res.writeHead(502); res.end('Backend unavailable'); });
+  req.pipe(proxy, { end: true });
+}
+
+function serveStatic(req, res) {
+  let filePath = path.join(DIST_DIR, req.url === '/' ? 'index.html' : req.url.split('?')[0]);
+  if (!fs.existsSync(filePath)) filePath = path.join(DIST_DIR, 'index.html');
+  const ext = path.extname(filePath);
+  const mime = MIME[ext] || 'application/octet-stream';
+  try {
+    const data = fs.readFileSync(filePath);
+    res.writeHead(200, { 'Content-Type': mime, 'Cache-Control': 'public, max-age=3600' });
+    res.end(data);
+  } catch { res.writeHead(404); res.end('Not found'); }
+}
+
+http.createServer((req, res) => {
+  if (req.url.startsWith('/api')) proxyToApi(req, res);
+  else serveStatic(req, res);
+}).listen(PORT, () => console.log(`GitNexus proxy on http://localhost:${PORT}`));
+```
+
+### 5. 启动服务
+
+```bash
+# Terminal 1: GitNexus backend API
+npx gitnexus serve &
+
+# Terminal 2: Proxy (web UI + API on one port)
+node "$GITNEXUS_DIR/proxy.mjs" "$GITNEXUS_DIR/gitnexus-web/dist" 8888 &
+```
+
+验证：执行 `curl -s http://localhost:8888/api/repos` 应返回已索引的仓库。
+
+### 6. 使用 Cloudflare 建立隧道（可选 — 用于远程访问）
+
+```bash
+# Install cloudflared if needed (no sudo)
+if ! command -v cloudflared &>/dev/null; then
+  mkdir -p ~/.local/bin
+  curl -sL https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 \
+    -o ~/.local/bin/cloudflared
+  chmod +x ~/.local/bin/cloudflared
+  export PATH="$HOME/.local/bin:$PATH"
+fi
+
+# Start tunnel (--config /dev/null avoids conflicts with existing named tunnels)
+cloudflared tunnel --config /dev/null --url http://localhost:8888 --no-autoupdate --protocol http2
+```
+
+隧道 URL（例如 `https://random-words.trycloudflare.com`）会输出到 stderr。
+分享此链接 —— 任何拥有该链接的人都可以浏览此图谱。
+
+### 7. 清理
+
+```bash
+# Stop services
+pkill -f "gitnexus serve"
+pkill -f "proxy.mjs"
+pkill -f cloudflared
+
+# Remove index from the target repo
+cd /path/to/target-repo
+npx gitnexus clean
+rm -rf .claude/
+```
+
+## 注意事项
+
+- **如果用户在 `~/.cloudflared/config.yml` 中已有现有的命名隧道配置，则 cloudflared 必须使用 `--config /dev/null`。** 若不加此参数，配置中的全匹配 ingress 规则会对所有快速隧道请求返回 404 错误。
+
+- **进行隧道穿透时必须使用生产构建。** Vite 开发服务器默认会阻止非 localhost 主机的访问 (`allowedHosts`)。生产构建 + Node 代理可以完全避免此问题。
+
+- **Web UI 不会创建 `.claude/` 或 `CLAUDE.md`。** 这些是由 `npx gitnexus analyze` 创建的。使用 `--skip-agents-md` 可以禁止生成这些 markdown 文件，然后执行 `rm -rf .claude/` 清理剩余内容。这些是 hermes-agent 用户不需要的 Claude Code 集成功能。
+
+- **浏览器内存限制。** Web UI 会将整个图谱加载到浏览器内存中。包含 5k+ 个文件的仓库可能会导致卡顿。超过 30k 个文件可能会导致标签页崩溃。
+
+- **Embeddings 是可选的。** `--embeddings` 会启用语义搜索，但在大型仓库上需要几分钟时间。如果只是快速浏览请跳过它；如果想通过 AI 聊天面板使用自然语言查询，则可以添加它。
+
+- **多仓库支持。** `gitnexus serve` 会为所有已索引的仓库提供服务。你可以为多个仓库创建索引，只需启动一次 serve 服务，即可在 Web UI 中切换浏览它们。

package/extensions/skills/optional/research/gitnexus-explorer/scripts/proxy.mjs

@@ -0,0 +1,92 @@
+/**
+ * GitNexus reverse proxy — serves production web UI + proxies /api/* to backend.
+ * Zero dependencies, Node.js built-ins only.
+ *
+ * Usage: node proxy.mjs <dist-dir> [port]
+ *   dist-dir: path to gitnexus-web/dist (production build)
+ *   port: listen port (default: 8888)
+ *
+ * Environment:
+ *   API_PORT: GitNexus serve backend port (default: 4747)
+ */
+import http from 'node:http';
+import fs from 'node:fs';
+import path from 'node:path';
+
+const API_PORT = parseInt(process.env.API_PORT || '4747');
+const DIST_DIR = process.argv[2] || './dist';
+const PORT = parseInt(process.argv[3] || '8888');
+
+const MIME = {
+  '.html': 'text/html',
+  '.js': 'application/javascript',
+  '.css': 'text/css',
+  '.json': 'application/json',
+  '.png': 'image/png',
+  '.svg': 'image/svg+xml',
+  '.ico': 'image/x-icon',
+  '.woff2': 'font/woff2',
+  '.woff': 'font/woff',
+  '.wasm': 'application/wasm',
+  '.ttf': 'font/ttf',
+  '.map': 'application/json',
+};
+
+function proxyToApi(req, res) {
+  const opts = {
+    hostname: '127.0.0.1',
+    port: API_PORT,
+    path: req.url,
+    method: req.method,
+    headers: { ...req.headers, host: `127.0.0.1:${API_PORT}` },
+  };
+  const proxy = http.request(opts, (upstream) => {
+    res.writeHead(upstream.statusCode, upstream.headers);
+    upstream.pipe(res, { end: true });
+  });
+  proxy.on('error', () => {
+    res.writeHead(502, { 'Content-Type': 'text/plain' });
+    res.end('GitNexus backend unavailable — is `npx gitnexus serve` running?');
+  });
+  req.pipe(proxy, { end: true });
+}
+
+function serveStatic(req, res) {
+  const urlPath = req.url.split('?')[0];
+  let filePath = path.join(DIST_DIR, urlPath === '/' ? 'index.html' : urlPath);
+
+  // SPA fallback: if file doesn't exist and isn't a static asset, serve index.html
+  if (!fs.existsSync(filePath) && !path.extname(filePath)) {
+    filePath = path.join(DIST_DIR, 'index.html');
+  }
+
+  const ext = path.extname(filePath);
+  const mime = MIME[ext] || 'application/octet-stream';
+
+  try {
+    const data = fs.readFileSync(filePath);
+    res.writeHead(200, {
+      'Content-Type': mime,
+      'Cache-Control': ext === '.html' ? 'no-cache' : 'public, max-age=86400',
+    });
+    res.end(data);
+  } catch {
+    res.writeHead(404, { 'Content-Type': 'text/plain' });
+    res.end('Not found');
+  }
+}
+
+const server = http.createServer((req, res) => {
+  if (req.url.startsWith('/api')) {
+    proxyToApi(req, res);
+  } else {
+    serveStatic(req, res);
+  }
+});
+
+server.listen(PORT, () => {
+  console.log(`GitNexus proxy listening on http://localhost:${PORT}`);
+  console.log(`  Web UI: http://localhost:${PORT}/`);
+  console.log(`  API:    http://localhost:${PORT}/api/repos`);
+  console.log(`  Backend: http://127.0.0.1:${API_PORT}`);
+});