@joekytc/dsh-swarm 0.1.2 → 0.2.0

package/skills/llm-wiki-skill/scripts/hook-session-start.sh

@@ -0,0 +1,46 @@
+#!/bin/bash
+# SessionStart hook: 会话开始时注入 wiki 上下文（只触发一次）
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+# shellcheck disable=SC1091
+source "$SCRIPT_DIR/shared-config.sh"
+
+WIKI_PATH=""
+
+if [ -f "$HOME/.llm-wiki-path" ]; then
+  WIKI_PATH="$(cat "$HOME/.llm-wiki-path")"
+fi
+
+if [ -z "$WIKI_PATH" ] && [ -f .wiki-schema.md ]; then
+  WIKI_PATH="$(pwd)"
+fi
+
+if [ -z "$WIKI_PATH" ] || [ ! -f "$WIKI_PATH/.wiki-schema.md" ]; then
+  printf '{}\n'
+  exit 0
+fi
+
+require_python_cmd
+
+"$PYTHON_CMD" - "$WIKI_PATH" <<'PY'
+import json
+import os
+import sys
+
+# 防御性：即使上游 shared-config.sh 未设置 PYTHONIOENCODING，
+# 此处也强制 stdout 为 UTF-8，避免 Agent 接到 gbk 字节
+if hasattr(sys.stdout, "reconfigure"):
+    sys.stdout.reconfigure(encoding="utf-8")
+
+wiki_path = os.path.realpath(sys.argv[1])
+message = f"[llm-wiki] 检测到知识库: {wiki_path}/index.md，回答问题时优先查阅 wiki 内容获取上下文"
+
+print(json.dumps({
+    "hookSpecificOutput": {
+        "hookEventName": "SessionStart",
+        "additionalContext": message,
+    }
+}, ensure_ascii=False))
+PY

package/skills/llm-wiki-skill/scripts/init-wiki.sh

@@ -0,0 +1,95 @@
+#!/bin/bash
+# llm-wiki 初始化脚本
+# 自动创建知识库的目录结构
+# 用法：bash init-wiki.sh <知识库路径> <主题>
+
+set -e
+
+WIKI_ROOT="${1:-$HOME/Documents/我的知识库}"
+TOPIC="${2:-我的知识库}"
+LANGUAGE="${3:-中文}"
+DATE=$(date +%Y-%m-%d)
+SKILL_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+
+# 安全的模板变量替换函数（用 perl 替代 sed，避免中文/空格/特殊字符问题）
+replace_vars() {
+    local input_file="$1"
+    local output_file="$2"
+    TOPIC_VALUE="$TOPIC" \
+    DATE_VALUE="$DATE" \
+    WIKI_ROOT_VALUE="$WIKI_ROOT" \
+    LANGUAGE_VALUE="$LANGUAGE" \
+    perl -pe '
+        s/\{\{TOPIC\}\}/$ENV{TOPIC_VALUE}/g;
+        s/\{\{DATE\}\}/$ENV{DATE_VALUE}/g;
+        s/\{\{WIKI_ROOT\}\}/$ENV{WIKI_ROOT_VALUE}/g;
+        s/\{\{LANGUAGE\}\}/$ENV{LANGUAGE_VALUE}/g;
+    ' "$input_file" > "$output_file"
+}
+
+echo "正在创建知识库..."
+echo "   路径：$WIKI_ROOT"
+echo "   主题：$TOPIC"
+echo "   语言：$LANGUAGE"
+echo ""
+
+# 创建目录结构（包含小红书和知乎）
+mkdir -p "$WIKI_ROOT"/raw/{articles,tweets,wechat,xiaohongshu,zhihu,pdfs,notes,assets}
+mkdir -p "$WIKI_ROOT"/wiki/{entities,topics,sources,comparisons,synthesis,synthesis/sessions,queries}
+
+cat > "$WIKI_ROOT/.gitignore" <<'EOF'
+.wiki-tmp/
+EOF
+
+echo "[完成] 目录结构已创建"
+
+# 从模板生成文件
+replace_vars "$SKILL_DIR/templates/schema-template.md" "$WIKI_ROOT/.wiki-schema.md"
+echo "[完成] Schema 文件已生成"
+
+replace_vars "$SKILL_DIR/templates/index-template.md" "$WIKI_ROOT/index.md"
+echo "[完成] 索引文件已生成"
+
+replace_vars "$SKILL_DIR/templates/log-template.md" "$WIKI_ROOT/log.md"
+echo "[完成] 日志文件已生成"
+
+replace_vars "$SKILL_DIR/templates/overview-template.md" "$WIKI_ROOT/wiki/overview.md"
+echo "[完成] 总览文件已生成"
+
+if [ "$LANGUAGE" = "English" ]; then
+    replace_vars "$SKILL_DIR/templates/purpose-en-template.md" "$WIKI_ROOT/purpose.md"
+else
+    replace_vars "$SKILL_DIR/templates/purpose-template.md" "$WIKI_ROOT/purpose.md"
+fi
+echo "[完成] 研究方向文件已生成"
+
+cat > "$WIKI_ROOT/.wiki-cache.json" <<'EOF'
+{
+  "version": 1,
+  "entries": {}
+}
+EOF
+echo "[完成] 缓存文件已生成"
+
+echo ""
+echo "知识库创建完成！"
+echo ""
+echo "目录结构："
+echo "   $WIKI_ROOT/"
+echo "   ├── raw/        （原始素材）"
+echo "   │   ├── articles/     网页文章"
+echo "   │   ├── tweets/       X/Twitter"
+echo "   │   ├── wechat/       微信公众号"
+echo "   │   ├── xiaohongshu/  小红书"
+echo "   │   ├── zhihu/        知乎"
+echo "   │   ├── pdfs/         PDF"
+echo "   │   ├── notes/        笔记"
+echo "   │   └── assets/       图片等附件"
+echo "   ├── wiki/       （知识库）"
+echo "   ├── index.md    （索引）"
+echo "   ├── log.md      （日志）"
+echo "   ├── purpose.md  （研究方向）"
+echo "   ├── .wiki-cache.json （缓存）"
+echo "   └── .wiki-schema.md （配置）"
+echo ""
+echo "下一步：给 agent 一个链接或文件，开始构建知识库！"

package/skills/llm-wiki-skill/scripts/lib/source-signal-eligibility.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+"use strict";
+
+const SCAN_KINDS = [
+  { subdir: "entities", pageType: "entity", applicable: true },
+  { subdir: "topics", pageType: "topic", applicable: true },
+  { subdir: "sources", pageType: "source", applicable: true },
+  { subdir: "comparisons", pageType: "comparison", applicable: true },
+  { subdir: "queries", pageType: "query", applicable: false },
+  { subdir: "synthesis", pageType: "synthesis", applicable: false }
+];
+
+function sortedUnique(values) {
+  return Array.from(new Set(values)).sort();
+}
+
+function extractFrontmatter(text) {
+  if (!text.startsWith("---\n") && !text.startsWith("---\r\n")) {
+    return { hasFrontmatter: false, frontmatter: "", body: text };
+  }
+
+  const match = text.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)([\s\S]*)$/);
+  if (!match) {
+    return { hasFrontmatter: false, frontmatter: "", body: text };
+  }
+
+  return {
+    hasFrontmatter: true,
+    frontmatter: match[1],
+    body: match[2]
+  };
+}
+
+function normalizeSourceToken(token) {
+  const trimmed = String(token || "").trim();
+  if (!trimmed) return null;
+
+  let value = trimmed;
+  if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+    value = value.slice(1, -1).trim();
+  }
+
+  return value || null;
+}
+
+function parseInlineSources(raw) {
+  const trimmed = raw.trim();
+  if (trimmed === "[]") return { ok: true, values: [] };
+  if (!(trimmed.startsWith("[") && trimmed.endsWith("]"))) {
+    return { ok: false, values: [] };
+  }
+
+  const inner = trimmed.slice(1, -1).trim();
+  if (!inner) return { ok: true, values: [] };
+
+  const values = inner
+    .split(",")
+    .map(normalizeSourceToken)
+    .filter(Boolean);
+
+  return { ok: true, values };
+}
+
+function parseSourcesFrontmatter(frontmatter) {
+  if (!frontmatter) {
+    return { hasField: false, parsed: false, sources: [], signalAvailable: false };
+  }
+
+  const lines = frontmatter.split(/\r?\n/);
+
+  for (let index = 0; index < lines.length; index += 1) {
+    const match = lines[index].match(/^sources:\s*(.*)$/);
+    if (!match) continue;
+
+    const rest = match[1].trim();
+    if (rest) {
+      if (!rest.startsWith("[")) {
+        const single = normalizeSourceToken(rest);
+        return {
+          hasField: true,
+          parsed: Boolean(single),
+          sources: single ? [single] : [],
+          signalAvailable: Boolean(single)
+        };
+      }
+
+      const parsedInline = parseInlineSources(rest);
+      return {
+        hasField: true,
+        parsed: parsedInline.ok,
+        sources: parsedInline.ok ? sortedUnique(parsedInline.values) : [],
+        signalAvailable: parsedInline.ok && parsedInline.values.length > 0
+      };
+    }
+
+    const collected = [];
+    let parsed = true;
+    let consumed = 0;
+
+    for (let cursor = index + 1; cursor < lines.length; cursor += 1) {
+      const line = lines[cursor];
+      if (!line.trim()) {
+        consumed += 1;
+        continue;
+      }
+      if (/^[^\s-]/.test(line)) break;
+      const itemMatch = line.match(/^\s*-\s*(.+)$/);
+      if (!itemMatch) {
+        parsed = false;
+        consumed += 1;
+        continue;
+      }
+      const token = normalizeSourceToken(itemMatch[1]);
+      if (token) collected.push(token);
+      consumed += 1;
+    }
+
+    index += consumed;
+    return {
+      hasField: true,
+      parsed,
+      sources: parsed ? sortedUnique(collected) : [],
+      signalAvailable: parsed && collected.length > 0
+    };
+  }
+
+  return { hasField: false, parsed: false, sources: [], signalAvailable: false };
+}
+
+function evaluateSourceSignalEligibility({ pageType, frontmatter }) {
+  const kind = SCAN_KINDS.find((k) => k.pageType === pageType);
+  if (!kind || !kind.applicable) {
+    return { eligible: false, reason: "not_applicable", sources: [] };
+  }
+
+  const parsed = parseSourcesFrontmatter(frontmatter);
+
+  if (!parsed.hasField) {
+    return { eligible: false, reason: "missing_sources", sources: [] };
+  }
+  if (!parsed.parsed) {
+    return { eligible: false, reason: "invalid_sources", sources: [] };
+  }
+  if (parsed.sources.length === 0) {
+    return { eligible: false, reason: "empty_sources", sources: [] };
+  }
+
+  return { eligible: true, reason: "ok", sources: parsed.sources };
+}
+
+module.exports = {
+  SCAN_KINDS,
+  extractFrontmatter,
+  evaluateSourceSignalEligibility,
+  normalizeSourceToken,
+  parseSourcesFrontmatter,
+  sortedUnique
+};

package/skills/llm-wiki-skill/scripts/lint-fix.sh

@@ -0,0 +1,114 @@
+#!/bin/bash
+# lint-fix.sh — 自动修复 lint 发现的低风险问题
+# 用法：bash scripts/lint-fix.sh <wiki_root> [--dry-run]
+# 修复范围：仅处理确定性修复（补 index 条目），不做高风险操作（删页面、改内容）
+# 退出码：0 = 完成，1 = 参数错误
+
+set -u
+shopt -s nullglob
+
+WIKI_ROOT="${1:-.}"
+DRY_RUN=false
+[ "${2:-}" = "--dry-run" ] && DRY_RUN=true
+
+WIKI_DIR="$WIKI_ROOT/wiki"
+INDEX_FILE="$WIKI_ROOT/index.md"
+
+if [ ! -d "$WIKI_DIR" ]; then
+  echo "ERROR: wiki directory not found: $WIKI_DIR" >&2
+  exit 1
+fi
+if [ ! -f "$INDEX_FILE" ]; then
+  echo "ERROR: index.md not found: $INDEX_FILE" >&2
+  exit 1
+fi
+
+FIXED=0
+
+index_has_entry() {
+  local entry="$1"
+  grep -ohE "\[\[[^]]+\]\]" "$INDEX_FILE" 2>/dev/null | \
+    sed -e 's/\[\[//g' -e 's/\]\]//g' -e 's/|.*//' | \
+    grep -Fxq "$entry"
+}
+
+# Insert a [[link]] entry after the matching section header in index.md.
+# If no matching section is found, appends to end of file as fallback.
+insert_under_section() {
+  local index_file="$1"
+  local section_pattern="$2"
+  local entry="$3"
+
+  # Find the line number of the section header
+  local line_num
+  line_num=$(grep -n -i -E "^#.*($section_pattern)" "$index_file" 2>/dev/null | head -1 | cut -d: -f1)
+
+  if [ -n "$line_num" ]; then
+    # Scan from section header to find insert point:
+    # last "- [[" line before next "##" header or EOF
+    local total_lines last_list_line offset
+    total_lines=$(wc -l < "$index_file" | tr -d ' ')
+    last_list_line="$line_num"
+    offset=$((line_num + 1))
+    while [ "$offset" -le "$total_lines" ]; do
+      local cur_line
+      cur_line=$(sed -n "${offset}p" "$index_file")
+      case "$cur_line" in
+        "##"*) break ;;
+        "- [["*) last_list_line="$offset" ;;
+      esac
+      offset=$((offset + 1))
+    done
+    # Insert after the last list item
+    local tmp_file
+    tmp_file=$(mktemp "${index_file}.tmp.XXXXXX") || return 1
+    awk -v insert_after="$last_list_line" -v entry="$entry" '
+      { print }
+      NR == insert_after { print "- [[" entry "]]" }
+    ' "$index_file" > "$tmp_file" && mv "$tmp_file" "$index_file"
+  else
+    # Fallback: append to end of file
+    printf '\n- [[%s]]\n' "$entry" >> "$index_file"
+  fi
+}
+
+echo "=== lint-fix: low-risk auto-repair ==="
+echo ""
+
+# Fix 1: Add unlisted pages to index.md
+# Only adds pages that exist in wiki/ but are not referenced in index.md
+# Skips derived pages (queries/, sessions/)
+echo "--- Checking for unlisted pages ---"
+for _subdir in entities topics sources comparisons synthesis; do
+  for f in "$WIKI_DIR"/$_subdir/*.md; do
+    [ -f "$f" ] || continue
+    BASENAME=$(basename "$f" .md)
+    # Skip derived pages
+    case "$f" in
+      */queries/*|*/sessions/*) continue ;;
+    esac
+    if ! index_has_entry "$BASENAME"; then
+      SECTION_PATTERN=""
+      case "$_subdir" in
+        entities) SECTION_PATTERN="实体页|Entities" ;;
+        topics) SECTION_PATTERN="主题页|Topics" ;;
+        sources) SECTION_PATTERN="素材摘要|Sources" ;;
+        comparisons) SECTION_PATTERN="对比分析|Comparisons" ;;
+        synthesis) SECTION_PATTERN="综合分析|Synthesis" ;;
+      esac
+      if [ "$DRY_RUN" = true ]; then
+        echo "  [dry-run] Would add [[$BASENAME]] under $_subdir section"
+      else
+        insert_under_section "$INDEX_FILE" "$SECTION_PATTERN" "$BASENAME"
+        echo "  Fixed: added [[$BASENAME]] under $_subdir section"
+      fi
+      FIXED=$((FIXED + 1))
+    fi
+  done
+done
+[ "$FIXED" -eq 0 ] && echo "  (all pages already listed)"
+echo ""
+
+echo "=== lint-fix complete: $FIXED fix(es) applied ==="
+[ "$DRY_RUN" = true ] && echo "(dry-run mode — no files were modified)"
+exit 0

package/skills/llm-wiki-skill/scripts/lint-runner.sh

@@ -0,0 +1,217 @@
+#!/bin/bash
+# lint-runner.sh — wiki 机械健康检查
+# 用法：bash scripts/lint-runner.sh <wiki_root>
+# 输出：结构化文本报告（供 AI 后续分析使用）
+# 退出码：0 = 运行完成，1 = 脚本错误（路径不存在、wiki 结构不完整）
+
+set -u
+shopt -s nullglob
+
+WIKI_ROOT="${1:-.}"
+WIKI_DIR="$WIKI_ROOT/wiki"
+INDEX_FILE="$WIKI_ROOT/index.md"
+
+if [ ! -d "$WIKI_DIR" ]; then
+  echo "ERROR: wiki 目录不存在：$WIKI_DIR" >&2
+  echo "       请确认路径正确，或先运行 init 工作流初始化知识库。" >&2
+  exit 1
+fi
+if [ ! -f "$INDEX_FILE" ]; then
+  echo "ERROR: index.md 不存在：$INDEX_FILE" >&2
+  exit 1
+fi
+
+index_has_entry() {
+  local entry="$1"
+  grep -ohE "\[\[[^]]+\]\]" "$INDEX_FILE" 2>/dev/null | \
+    sed -e 's/\[\[//g' -e 's/\]\]//g' -e 's/|.*//' | \
+    grep -Fxq "$entry"
+}
+
+echo "=== llm-wiki lint 报告 ==="
+echo "时间：$(date '+%Y-%m-%d %H:%M')"
+echo "检查路径：$WIKI_DIR"
+echo ""
+
+# 检查 1：孤立页面
+# 定义：entities/、topics/、sources/ 下的页面，除了自己之外没有任何其他 wiki 页面用 [[名称]] 引用它
+echo "--- 孤立页面（没有被其他页面引用） ---"
+_ORPHANS=0
+for _subdir in entities topics sources; do
+  for f in "$WIKI_DIR"/$_subdir/*.md; do
+    [ -f "$f" ] || continue
+    BASENAME=$(basename "$f" .md)
+    if ! grep -rlF "[[$BASENAME]]" "$WIKI_DIR" 2>/dev/null | grep -vxF "$f" | grep -q .; then
+      echo "  孤立: $_subdir/$BASENAME"
+      _ORPHANS=$((_ORPHANS + 1))
+    fi
+  done
+done
+[ "$_ORPHANS" -eq 0 ] && echo "  （无孤立页面）"
+echo ""
+
+# 检查 2：断链
+# 定义：wiki/ 下的页面里有 [[X]] 链接（支持 [[X|别名]] 语法），但 wiki/ 任意子目录找不到 X.md
+echo "--- 断链（被链接但不存在的页面） ---"
+_TMP_BROKEN=$(mktemp)
+grep -rohE "\[\[[^]]+\]\]" "$WIKI_DIR" 2>/dev/null | \
+  sed -e 's/\[\[//g' -e 's/\]\]//g' -e 's/|.*//' | \
+  sort -u | \
+  while read -r LINK; do
+    [ -z "$LINK" ] && continue
+    if ! find "$WIKI_DIR" -name "$LINK.md" 2>/dev/null | grep -q .; then
+      echo "  断链: [[$LINK]]"
+      echo "$LINK" >> "$_TMP_BROKEN"
+    fi
+  done
+if [ ! -s "$_TMP_BROKEN" ]; then
+  echo "  （无断链）"
+fi
+rm -f "$_TMP_BROKEN"
+echo ""
+
+# 检查 3：index 一致性
+# 定义：index.md 里有 [[X]] 记录（去掉别名），但 wiki/ 任意子目录都找不到 X.md
+echo "--- index 一致性（index.md 有记录但文件缺失） ---"
+_TMP_MISSING=$(mktemp)
+grep -ohE "\[\[[^]]+\]\]" "$INDEX_FILE" 2>/dev/null | \
+  sed -e 's/\[\[//g' -e 's/\]\]//g' -e 's/|.*//' | \
+  sort -u | \
+  while read -r ENTRY; do
+    [ -z "$ENTRY" ] && continue
+    if ! find "$WIKI_DIR" -name "$ENTRY.md" 2>/dev/null | grep -q .; then
+      echo "  index 有但文件缺失: $ENTRY"
+      echo "$ENTRY" >> "$_TMP_MISSING"
+    fi
+  done
+if [ ! -s "$_TMP_MISSING" ]; then
+  echo "  （index 与文件一致）"
+fi
+rm -f "$_TMP_MISSING"
+echo ""
+
+# 检查 4：反向 index 一致性
+# 定义：wiki/ 下实际存在的页面，但 index.md 里没有 [[页面名]] 记录
+# 排除 derived 页面（queries/、synthesis/sessions/）
+echo "--- 反向 index 一致性（文件存在但 index.md 未收录） ---"
+_TMP_UNLISTED=$(mktemp)
+for _subdir in entities topics sources comparisons synthesis; do
+  for f in "$WIKI_DIR"/$_subdir/*.md; do
+    [ -f "$f" ] || continue
+    BASENAME=$(basename "$f" .md)
+    # 跳过 derived 页面
+    case "$f" in
+      */queries/*|*/sessions/*) continue ;;
+    esac
+    if ! index_has_entry "$BASENAME"; then
+      echo "  未收录: $_subdir/$BASENAME"
+      echo "$BASENAME" >> "$_TMP_UNLISTED"
+    fi
+  done
+done
+if [ ! -s "$_TMP_UNLISTED" ]; then
+  echo "  （所有页面均已收录）"
+fi
+rm -f "$_TMP_UNLISTED"
+echo ""
+
+# 检查 5：图片资产一致性
+# 定义：source 页面 frontmatter 中 image_paths 列出的文件，在知识库中是否实际存在
+# 支持 block list 格式和 inline array 格式
+echo "--- 图片资产一致性（image_paths 声明但文件缺失） ---"
+_IMG_ISSUES=0
+for f in "$WIKI_DIR"/sources/*.md; do
+  [ -f "$f" ] || continue
+  _BASENAME=$(basename "$f" .md)
+  # 提取 frontmatter 中 image_paths 的值
+  _IN_FM=false
+  _IN_IMG=false
+  _INLINE_VAL=""
+  while IFS= read -r line; do
+    case "$line" in
+      "---")
+        if [ "$_IN_FM" = true ]; then break; fi
+        _IN_FM=true
+        continue
+        ;;
+    esac
+    [ "$_IN_FM" = true ] || continue
+    case "$line" in
+      image_paths:*)
+        # 检查是否有 inline value（如 image_paths: ["a.png", "b.jpg"]）
+        _INLINE_VAL=$(echo "$line" | sed 's/^image_paths:[[:space:]]*//')
+        if [ -n "$_INLINE_VAL" ] && [ "$_INLINE_VAL" != "[]" ]; then
+          # 解析 inline array：去掉 []，按逗号分割
+          echo "$_INLINE_VAL" | tr -d '[]' | tr ',' '\n' | while IFS= read -r _ITEM; do
+            _PATH=$(echo "$_ITEM" | sed 's/^[[:space:]]*//' | sed 's/[[:space:]]*$//' | tr -d '"' | tr -d "'")
+            [ -z "$_PATH" ] && continue
+            if [ ! -f "$WIKI_ROOT/$_PATH" ]; then
+              echo "  缺失: $_BASENAME → $_PATH"
+            fi
+          done
+          _INLINE_COUNT=$(echo "$_INLINE_VAL" | tr -d '[]' | tr ',' '\n' | while IFS= read -r _ITEM; do
+            _P=$(echo "$_ITEM" | sed 's/^[[:space:]]*//' | sed 's/[[:space:]]*$//' | tr -d '"' | tr -d "'")
+            [ -z "$_P" ] && continue
+            [ ! -f "$WIKI_ROOT/$_P" ] && echo "x"
+          done | wc -l | tr -d ' ')
+          _IMG_ISSUES=$((_IMG_ISSUES + _INLINE_COUNT))
+          _IN_IMG=false
+        else
+          _IN_IMG=true
+        fi
+        continue
+        ;;
+      "  - "*)
+        if [ "$_IN_IMG" = true ]; then
+          _PATH=$(echo "$line" | sed 's/^[[:space:]]*- //' | sed 's/^[[:space:]]*//' | sed 's/[[:space:]]*$//' | tr -d '"' | tr -d "'")
+          [ -z "$_PATH" ] && continue
+          if [ ! -f "$WIKI_ROOT/$_PATH" ]; then
+            echo "  缺失: $_BASENAME → $_PATH"
+            _IMG_ISSUES=$((_IMG_ISSUES + 1))
+          fi
+        fi
+        ;;
+      *) _IN_IMG=false ;;
+    esac
+  done < "$f"
+done
+[ "$_IMG_ISSUES" -eq 0 ] && echo "  （无缺失图片）"
+echo ""
+
+# 检查 6：source-signal 覆盖情况
+echo "--- source-signal 覆盖情况 ---"
+_COVERAGE_SCRIPT="$(cd "$(dirname "$0")" && pwd)/source-signal-coverage.js"
+if [ -f "$_COVERAGE_SCRIPT" ] && command -v node >/dev/null 2>&1; then
+  _COVERAGE_JSON=$(node "$_COVERAGE_SCRIPT" "$WIKI_ROOT" 2>/dev/null)
+  if [ $? -eq 0 ] && [ -n "$_COVERAGE_JSON" ]; then
+    node -e '
+      const data = JSON.parse(require("fs").readFileSync("/dev/stdin", "utf8"));
+      const s = data.summary;
+      console.log("  已参与：" + s.ok);
+      console.log("  缺少 sources 字段：" + s.missing_sources);
+      console.log("  sources 为空：" + s.empty_sources);
+      console.log("  sources 格式无效：" + s.invalid_sources);
+      console.log("  当前不参与：" + s.not_applicable);
+      const issues = data.pages.filter(p => p.reason !== "ok" && p.reason !== "not_applicable");
+      if (issues.length > 0) {
+        const byReason = { missing_sources: [], empty_sources: [], invalid_sources: [] };
+        for (const p of issues) { if (byReason[p.reason]) byReason[p.reason].push(p.path); }
+        for (const [reason, paths] of Object.entries(byReason)) {
+          if (paths.length === 0) continue;
+          const label = { missing_sources: "缺少 sources 字段", empty_sources: "sources 为空", invalid_sources: "sources 格式无效" }[reason];
+          console.log("");
+          console.log("  " + label + "：");
+          for (const p of paths) console.log("  - " + p);
+        }
+      }
+    ' <<< "$_COVERAGE_JSON"
+  else
+    echo "  （coverage 脚本执行失败，跳过覆盖检查）"
+  fi
+else
+  echo "  （coverage 脚本或 node 不可用，跳过覆盖检查）"
+fi
+echo ""
+
+echo "=== 机械检查完成。矛盾检测、交叉引用、置信度抽查由 AI 继续执行 ==="
+exit 0