@research-copilot/plugin 1.1.17 → 1.1.19

package/dist/skills/llm-wiki/tests/adapter-state.sh

@@ -0,0 +1,338 @@
+#!/bin/bash
+# 外挂状态检测的回归测试
+# 覆盖：not_installed / env_unavailable / runtime_failed / empty_result / unsupported
+
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+
+fail() {
+    echo "FAIL: $1" >&2
+    exit 1
+}
+
+assert_file_contains() {
+    local file="$1"
+    local text="$2"
+
+    if ! grep -F -- "$text" "$file" > /dev/null; then
+        fail "Expected $file to contain: $text"
+    fi
+}
+
+assert_text_contains() {
+    local text="$1"
+    local expected="$2"
+
+    if ! printf '%s' "$text" | grep -F -- "$expected" > /dev/null; then
+        fail "Expected output to contain: $expected"
+    fi
+}
+
+assert_text_not_contains() {
+    local text="$1"
+    local unexpected="$2"
+
+    if printf '%s' "$text" | grep -F -- "$unexpected" > /dev/null; then
+        fail "Expected output to not contain: $unexpected"
+    fi
+}
+
+make_stub() {
+    local path="$1"
+    local body="$2"
+
+    printf '%s\n' "$body" > "$path"
+    chmod +x "$path"
+}
+
+prepare_skill_root() {
+    local skill_root="$1"
+
+    mkdir -p "$skill_root/baoyu-url-to-markdown"
+    mkdir -p "$skill_root/youtube-transcript"
+}
+
+prepare_source_checkout() {
+    local repo_root="$1"
+
+    mkdir -p "$repo_root/scripts" "$repo_root/deps/baoyu-url-to-markdown" "$repo_root/deps/youtube-transcript"
+    : > "$repo_root/.git"
+    cp "$REPO_ROOT/scripts/adapter-state.sh" "$repo_root/scripts/adapter-state.sh"
+    cp "$REPO_ROOT/scripts/source-registry.sh" "$repo_root/scripts/source-registry.sh"
+    cp "$REPO_ROOT/scripts/source-registry.tsv" "$repo_root/scripts/source-registry.tsv"
+    cp "$REPO_ROOT/scripts/shared-config.sh" "$repo_root/scripts/shared-config.sh"
+    cp "$REPO_ROOT/scripts/runtime-context.sh" "$repo_root/scripts/runtime-context.sh"
+}
+
+test_bundled_adapters_are_not_treated_as_installed_from_repo_checkout() {
+    local tmp_dir output
+    tmp_dir="$(mktemp -d)"
+    trap 'rm -rf "$tmp_dir"' RETURN
+
+    mkdir -p "$tmp_dir/bin" "$tmp_dir/skills"
+
+    make_stub "$tmp_dir/bin/lsof" '#!/bin/sh
+exit 1'
+
+    output="$(
+        PATH="$tmp_dir/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+        bash "$REPO_ROOT/scripts/adapter-state.sh" --skill-root "$tmp_dir/skills" check web_article 2>&1
+    )" || fail "adapter-state should check the target skill root, not the repo checkout"
+
+    assert_text_contains "$output" "not_installed"
+    assert_text_contains "$output" "baoyu-url-to-markdown"
+}
+
+test_source_checkout_uses_repo_deps_for_bundled_adapters() {
+    local tmp_dir output
+    tmp_dir="$(mktemp -d)"
+    trap 'rm -rf "$tmp_dir"' RETURN
+
+    prepare_source_checkout "$tmp_dir/repo"
+    mkdir -p "$tmp_dir/bin"
+
+    make_stub "$tmp_dir/bin/lsof" '#!/bin/sh
+exit 1'
+
+    output="$(
+        PATH="$tmp_dir/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+        bash "$tmp_dir/repo/scripts/adapter-state.sh" check web_article 2>&1
+    )" || fail "adapter-state should understand bundled deps from a source checkout"
+
+    assert_text_contains "$output" "available"
+    assert_text_contains "$output" "临时浏览器"
+}
+
+test_adapter_state_distinguishes_not_installed_and_unsupported() {
+    local tmp_dir output
+    tmp_dir="$(mktemp -d)"
+    trap 'rm -rf "$tmp_dir"' RETURN
+
+    mkdir -p "$tmp_dir/bin" "$tmp_dir/skills"
+    make_stub "$tmp_dir/bin/uv" '#!/bin/sh
+exit 0'
+
+    output="$(
+        PATH="$tmp_dir/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+        bash "$REPO_ROOT/scripts/adapter-state.sh" --skill-root "$tmp_dir/skills" check wechat_article 2>&1
+    )" || fail "adapter-state should classify not_installed"
+
+    assert_text_contains "$output" "not_installed"
+    assert_text_contains "$output" "wechat-article-to-markdown"
+    assert_text_contains "$output" "手动入口"
+
+    output="$(
+        PATH="$tmp_dir/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+        bash "$REPO_ROOT/scripts/adapter-state.sh" --skill-root "$tmp_dir/skills" check xiaohongshu_post 2>&1
+    )" || fail "adapter-state should classify unsupported"
+
+    assert_text_contains "$output" "unsupported"
+    assert_text_contains "$output" "请先从 App 或网页复制内容"
+}
+
+test_web_capture_available_without_chrome_debug_port() {
+    local tmp_dir output
+    tmp_dir="$(mktemp -d)"
+    trap 'rm -rf "$tmp_dir"' RETURN
+
+    mkdir -p "$tmp_dir/bin" "$tmp_dir/skills"
+    prepare_skill_root "$tmp_dir/skills"
+
+    make_stub "$tmp_dir/bin/lsof" '#!/bin/sh
+exit 1'
+
+    output="$(
+        PATH="$tmp_dir/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+        bash "$REPO_ROOT/scripts/adapter-state.sh" --skill-root "$tmp_dir/skills" check web_article 2>&1
+    )" || fail "adapter-state should keep Chrome-backed sources available without 9222"
+
+    assert_text_contains "$output" "available"
+    assert_text_contains "$output" "临时浏览器"
+    assert_text_contains "$output" "9222"
+}
+
+test_web_capture_available_with_chrome_debug_port() {
+    local tmp_dir output
+    tmp_dir="$(mktemp -d)"
+    trap 'rm -rf "$tmp_dir"' RETURN
+
+    mkdir -p "$tmp_dir/bin" "$tmp_dir/skills"
+    prepare_skill_root "$tmp_dir/skills"
+
+    make_stub "$tmp_dir/bin/lsof" '#!/bin/sh
+exit 0'
+
+    output="$(
+        PATH="$tmp_dir/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+        bash "$REPO_ROOT/scripts/adapter-state.sh" --skill-root "$tmp_dir/skills" check web_article 2>&1
+    )" || fail "adapter-state should report available with Chrome debug session"
+
+    assert_text_contains "$output" "available"
+    assert_text_contains "$output" "可复用的 Chrome 调试会话"
+    # install_hint 应为"-"，不应出现"补充说明"
+    assert_text_not_contains "$output" "9222"
+}
+
+test_uv_backed_source_reports_env_unavailable_without_uv() {
+    local tmp_dir output
+    tmp_dir="$(mktemp -d)"
+    trap 'rm -rf "$tmp_dir"' RETURN
+
+    mkdir -p "$tmp_dir/bin" "$tmp_dir/skills"
+    prepare_skill_root "$tmp_dir/skills"
+
+    make_stub "$tmp_dir/bin/lsof" '#!/bin/sh
+exit 1'
+
+    output="$(
+        PATH="$tmp_dir/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+        bash "$REPO_ROOT/scripts/adapter-state.sh" --skill-root "$tmp_dir/skills" check youtube_video 2>&1
+    )" || fail "adapter-state should classify env_unavailable for uv-backed sources"
+
+    assert_text_contains "$output" "env_unavailable"
+    assert_text_contains "$output" "uv"
+}
+
+test_adapter_state_distinguishes_runtime_failed_and_empty_result() {
+    local tmp_dir output
+    tmp_dir="$(mktemp -d)"
+    trap 'rm -rf "$tmp_dir"' RETURN
+
+    mkdir -p "$tmp_dir/bin" "$tmp_dir/skills"
+    prepare_skill_root "$tmp_dir/skills"
+
+    make_stub "$tmp_dir/bin/lsof" '#!/bin/sh
+exit 0'
+    make_stub "$tmp_dir/bin/uv" '#!/bin/sh
+exit 0'
+
+    : > "$tmp_dir/empty.txt"
+    printf 'body\n' > "$tmp_dir/full.txt"
+
+    output="$(
+        PATH="$tmp_dir/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+        bash "$REPO_ROOT/scripts/adapter-state.sh" --skill-root "$tmp_dir/skills" classify-run web_article 1 "$tmp_dir/full.txt" 2>&1
+    )" || fail "adapter-state should classify runtime_failed"
+
+    assert_text_contains "$output" "runtime_failed"
+    assert_text_contains "$output" "重试"
+
+    output="$(
+        PATH="$tmp_dir/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+        bash "$REPO_ROOT/scripts/adapter-state.sh" --skill-root "$tmp_dir/skills" classify-run web_article 0 "$tmp_dir/empty.txt" 2>&1
+    )" || fail "adapter-state should classify empty_result"
+
+    assert_text_contains "$output" "empty_result"
+    assert_text_contains "$output" "手动补全文本"
+
+    output="$(
+        PATH="$tmp_dir/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+        bash "$REPO_ROOT/scripts/adapter-state.sh" --skill-root "$tmp_dir/skills" classify-run web_article 0 "$tmp_dir/full.txt" 2>&1
+    )" || fail "adapter-state should keep available runs green"
+
+    assert_text_contains "$output" "available"
+}
+
+test_classify_run_preserves_preflight_failures() {
+    local tmp_dir output
+    tmp_dir="$(mktemp -d)"
+    trap 'rm -rf "$tmp_dir"' RETURN
+
+    mkdir -p "$tmp_dir/bin" "$tmp_dir/skills"
+    printf 'body\n' > "$tmp_dir/full.txt"
+
+    make_stub "$tmp_dir/bin/uv" '#!/bin/sh
+exit 0'
+
+    output="$(
+        PATH="$tmp_dir/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+        bash "$REPO_ROOT/scripts/adapter-state.sh" --skill-root "$tmp_dir/skills" classify-run wechat_article 1 "$tmp_dir/full.txt" 2>&1
+    )" || fail "classify-run should preserve not_installed preflight state"
+
+    assert_text_contains "$output" "not_installed"
+    assert_text_not_contains "$output" "runtime_failed"
+
+    output="$(
+        PATH="$tmp_dir/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+        bash "$REPO_ROOT/scripts/adapter-state.sh" --skill-root "$tmp_dir/skills" classify-run xiaohongshu_post 1 "$tmp_dir/full.txt" 2>&1
+    )" || fail "classify-run should preserve unsupported preflight state"
+
+    assert_text_contains "$output" "unsupported"
+    assert_text_not_contains "$output" "runtime_failed"
+}
+
+test_install_reports_adapter_states_from_shared_model() {
+    local tmp_dir output
+    tmp_dir="$(mktemp -d)"
+    trap 'rm -rf "$tmp_dir"' RETURN
+
+    mkdir -p "$tmp_dir/home/.claude/skills" "$tmp_dir/bin"
+
+    make_stub "$tmp_dir/bin/bun" '#!/bin/sh
+mkdir -p node_modules
+exit 0'
+
+    make_stub "$tmp_dir/bin/lsof" '#!/bin/sh
+exit 1'
+
+    make_stub "$tmp_dir/bin/uv" "#!/bin/sh
+printf '%s\n' '#!/bin/sh' 'exit 0' > \"$tmp_dir/bin/wechat-article-to-markdown\"
+chmod +x \"$tmp_dir/bin/wechat-article-to-markdown\"
+exit 0"
+
+    output="$(
+        HOME="$tmp_dir/home" \
+        PATH="$tmp_dir/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+        bash "$REPO_ROOT/install.sh" --platform claude --with-optional-adapters 2>&1
+    )" || fail "install.sh should surface adapter states"
+
+    assert_text_contains "$output" "外挂状态"
+    assert_text_contains "$output" "网页文章"
+    assert_text_contains "$output" "可用"
+    assert_text_contains "$output" "临时浏览器"
+    assert_text_contains "$output" "微信公众号"
+    assert_text_contains "$output" "可用"
+}
+
+test_skill_routes_ingest_and_status_through_adapter_state_model() {
+    assert_file_contains "$REPO_ROOT/SKILL.md" "scripts/adapter-state.sh"
+    assert_file_contains "$REPO_ROOT/SKILL.md" "not_installed / env_unavailable / runtime_failed / unsupported / empty_result"
+    assert_file_contains "$REPO_ROOT/SKILL.md" "外挂状态"
+    assert_file_contains "$REPO_ROOT/SKILL.md" "--with-optional-adapters"
+}
+
+test_summary_human_shows_supplementary_label_for_available_with_hint() {
+    local tmp_dir output
+    tmp_dir="$(mktemp -d)"
+    trap 'rm -rf "$tmp_dir"' RETURN
+
+    mkdir -p "$tmp_dir/bin" "$tmp_dir/skills"
+    prepare_skill_root "$tmp_dir/skills"
+
+    # lsof 返回 1 → Chrome 9222 未监听 → state=available + install_hint 非空
+    make_stub "$tmp_dir/bin/lsof" '#!/bin/sh
+exit 1'
+
+    output="$(
+        PATH="$tmp_dir/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+        bash "$REPO_ROOT/scripts/adapter-state.sh" --skill-root "$tmp_dir/skills" summary-human 2>&1
+    )" || fail "summary-human should succeed"
+
+    # available + 有 install_hint → 应显示"补充说明"
+    assert_text_contains "$output" "补充说明"
+}
+
+test_adapter_state_distinguishes_not_installed_and_unsupported
+test_bundled_adapters_are_not_treated_as_installed_from_repo_checkout
+test_source_checkout_uses_repo_deps_for_bundled_adapters
+test_web_capture_available_without_chrome_debug_port
+test_web_capture_available_with_chrome_debug_port
+test_uv_backed_source_reports_env_unavailable_without_uv
+test_adapter_state_distinguishes_runtime_failed_and_empty_result
+test_classify_run_preserves_preflight_failures
+test_install_reports_adapter_states_from_shared_model
+test_skill_routes_ingest_and_status_through_adapter_state_model
+test_summary_human_shows_supplementary_label_for_available_with_hint
+
+echo "Adapter state checks passed."

package/dist/skills/llm-wiki/tests/browser/graph-density-preview.mjs

@@ -0,0 +1,53 @@
+import assert from "node:assert/strict";
+import { createRequire } from "node:module";
+import { pathToFileURL } from "node:url";
+
+const require = createRequire(import.meta.url);
+const { chromium } = require("playwright");
+
+const html = process.env.GRAPH_DENSITY_PREVIEW_HTML || "";
+assert.notEqual(html, "", "GRAPH_DENSITY_PREVIEW_HTML must point at generated HTML");
+
+const browser = await chromium.launch();
+try {
+  const page = await browser.newPage({ viewport: { width: 1440, height: 960 } });
+  await page.goto(pathToFileURL(html).href);
+  await page.waitForSelector("[data-llm-wiki-graph-root='true']");
+
+  const root = page.locator("[data-llm-wiki-graph-root='true']");
+  const totalNodes = await page.locator(".node").count();
+  const fullCards = await page.locator(".node:not(.is-compact):not(.is-point):not(.is-overview)").count();
+  assert.ok(totalNodes >= 120, `dense fixture should render many nodes, got ${totalNodes}`);
+  assert.ok(fullCards < totalNodes / 2, "dense fixture should not render every node as a full card");
+
+  const compact = page.locator(".node.is-compact").first();
+  await compact.waitFor();
+  await compact.hover();
+  await assertPreviewOpen(page, "compact node should open hover preview");
+
+  await page.mouse.move(20, 20);
+  await waitForPreviewState(page, "closed");
+
+  await page.waitForSelector(".node.is-point");
+  const point = page.locator(".node.is-point").first();
+  await point.evaluate((element) => {
+    element.dispatchEvent(new PointerEvent("pointerenter", { bubbles: true, pointerType: "mouse" }));
+  });
+  await assertPreviewOpen(page, "point node should open hover preview");
+} finally {
+  await browser.close();
+}
+
+async function assertPreviewOpen(page, message) {
+  await page.waitForSelector(".graph-hover-preview[data-state='open']");
+  const preview = page.locator(".graph-hover-preview");
+  await preview.locator(".graph-hover-preview-title").waitFor();
+  await preview.locator(".graph-hover-preview-type").waitFor();
+  assert.equal(await preview.locator(".graph-hover-preview-summary").count(), 1, message);
+}
+
+async function waitForPreviewState(page, state) {
+  await page.waitForFunction((state) => {
+    return document.querySelector(".graph-hover-preview")?.dataset.state === state;
+  }, state);
+}

package/dist/skills/llm-wiki/tests/browser/graph-html-insights.mjs

@@ -0,0 +1,41 @@
+import assert from "node:assert/strict";
+import { createRequire } from "node:module";
+import { pathToFileURL } from "node:url";
+
+const require = createRequire(import.meta.url);
+const { chromium } = require("playwright");
+
+const html = process.env.GRAPH_HTML_INSIGHTS_HTML || "";
+assert.notEqual(html, "", "GRAPH_HTML_INSIGHTS_HTML must point at generated HTML");
+
+const browser = await chromium.launch();
+try {
+  const page = await browser.newPage({ viewport: { width: 1440, height: 960 } });
+  await page.goto(pathToFileURL(html).href);
+  await page.waitForSelector("[data-llm-wiki-graph-root='true']");
+
+  await page.keyboard.down("Shift");
+  await page.locator(".node[data-id='A']").click();
+  await page.locator(".node[data-id='B']").click();
+  await page.keyboard.up("Shift");
+  await page.waitForSelector(".graph-selection-panel[data-state='open']");
+  const panel = page.locator(".graph-selection-panel");
+  await panel.getByText("Shift+点击 增删节点").waitFor();
+  await panel.getByText("节点A").waitFor();
+  await panel.getByText("节点B").waitFor();
+  assert.ok(await panel.locator(".graph-selection-fact").count() >= 4, "Shift selection should show structural facts");
+  assert.equal(await panel.getByText("提问选区").count(), 0, "offline selection panel must not show ask actions");
+
+  await page.keyboard.press("Escape");
+  await page.waitForSelector(".graph-selection-panel[data-state='closed']");
+
+  await page.getByRole("button", { name: "筛选" }).click();
+  await page.waitForSelector('.graph-toolbar-panel[data-state="filters"] .community-legend-row');
+  await page.locator(".community-legend-row").first().click();
+  await page.waitForSelector(".graph-selection-panel[data-state='open']");
+  await panel.getByText(/社区选区/).waitFor();
+  await panel.getByText("内部关联").waitFor();
+  assert.equal(await panel.locator("button", { hasText: "提问选区" }).count(), 0, "offline community selection must not show ask actions");
+} finally {
+  await browser.close();
+}

package/dist/skills/llm-wiki/tests/browser/graph-node-slim.mjs

@@ -0,0 +1,71 @@
+import assert from "node:assert/strict";
+import { createRequire } from "node:module";
+import { pathToFileURL } from "node:url";
+
+const require = createRequire(import.meta.url);
+const { chromium } = require("playwright");
+
+const html = process.env.GRAPH_NODE_SLIM_HTML || "";
+assert.notEqual(html, "", "GRAPH_NODE_SLIM_HTML must point at generated HTML");
+
+const browser = await chromium.launch();
+try {
+  const page = await browser.newPage({ viewport: { width: 1440, height: 960 } });
+  await page.goto(pathToFileURL(html).href);
+  await page.waitForSelector("[data-llm-wiki-graph-root='true']");
+
+  const node = page.locator(".node[data-id='A']");
+  await node.waitFor();
+  await assertNodeDetailDisplay(node, "none", "none", "default card node should hide type and weight details");
+  assert.equal(await node.locator(".node-name").innerText(), "节点A", "default card node should keep the title visible");
+
+  await node.hover();
+  await assertNodeDetailDisplay(node, "block", "flex", "hovered card node should expose type and weight details");
+  await page.waitForSelector(".graph-hover-preview[data-state='open']");
+  const preview = page.locator(".graph-hover-preview");
+  await preview.locator(".graph-hover-preview-title", { hasText: /^节点A$/ }).waitFor();
+  await preview.getByText("实体").waitFor();
+  await preview.getByText("这是节点A的内容。").waitFor();
+  assert.equal(await preview.locator(".graph-hover-preview-summary").count(), 1, "content nodes should show a preview summary");
+
+  await page.mouse.move(20, 20);
+  await waitForPreviewState(page, "closed");
+  await assertNodeDetailDisplay(node, "none", "none", "card node details should hide again after hover leaves");
+
+  await node.click();
+  await page.waitForSelector(".graph-reader[data-state='open']");
+  await assertNodeDetailDisplay(node, "block", "flex", "selected card node should expose type and weight details");
+
+  const emptyNode = page.locator(".node[data-id='empty-preview']");
+  if (await emptyNode.count()) {
+    await emptyNode.hover();
+    await page.waitForSelector(".graph-hover-preview[data-state='open']");
+    await preview.locator(".graph-hover-preview-title", { hasText: /^空内容节点$/ }).waitFor();
+    await preview.getByText("主题").waitFor();
+    assert.equal(await preview.locator(".graph-hover-preview-summary").count(), 0, "empty content nodes should omit summary text");
+  }
+} finally {
+  await browser.close();
+}
+
+async function waitForPreviewState(page, state) {
+  await page.waitForFunction((state) => {
+    return document.querySelector(".graph-hover-preview")?.dataset.state === state;
+  }, state);
+}
+
+async function assertNodeDetailDisplay(node, expectedKind, expectedMeta, message) {
+  const actual = await node.evaluate((element) => {
+    const kind = element.querySelector(".node-kind");
+    const meta = element.querySelector(".node-meta");
+    const styles = element.ownerDocument.defaultView;
+    return {
+      kind: kind && styles ? styles.getComputedStyle(kind).display : "",
+      meta: meta && styles ? styles.getComputedStyle(meta).display : "",
+      metaText: meta?.textContent?.trim() || ""
+    };
+  });
+  assert.equal(actual.kind, expectedKind, `${message}: node kind display`);
+  assert.equal(actual.meta, expectedMeta, `${message}: node meta display`);
+  assert.match(actual.metaText, /\d+|来源暂不可用/, `${message}: node meta text should remain available`);
+}