🕷️ Spider Web — 技能触发词网络系统#

智能技能路由中台。将所有技能的触发词串联成一张蜘蛛网，用户查询命中任一节点，自动路由到目标技能。

核心理念#

text

用户输入 → 蜘蛛网路由核心 → 触发词匹配引擎 → 最佳技能推荐
                ↑
        触发词数据库 (JSON)
                ↑
     自动扫描所有技能的 SKILL.md

串/并联模式：

• 并联 (OR)：用户查询命中任意一个触发词 → 激活对应技能
• 串联 (AND)：用户查询必须同时包含多个触发词 → 激活对应技能

何时触发#

当用户表达以下意图时使用此技能：

• "这个查询应该触发哪个技能" "哪个技能可以处理XX"
• "匹配技能" "技能路由" "技能推荐"
• "蜘蛛网" "触发词匹配" "触发词网络"
• "帮我匹配一下技能" "查一下这个该用哪个技能"
• 用户想了解技能触发词系统、管理触发词

快速开始#

1. 索引触发词数据库#

bash

python ~/.workbuddy/skills/spider-web/scripts/index_triggers.py

这会在 scripts/trigger_db.json 生成完整的触发词数据库。

2. 匹配查询#

bash

# 直接查询
python ~/.workbuddy/skills/spider-web/scripts/match_engine.py "帮我分析电商数据"

# 返回技能名
python ~/.workbuddy/skills/spider-web/scripts/match_engine.py "内存占用高" --skill

# 交互模式
python ~/.workbuddy/skills/spider-web/scripts/match_engine.py

3. 启动 Web 管理面板#

bash

python ~/.workbuddy/skills/spider-web/scripts/server.py --port 8766

访问 http://127.0.0.1:8766 查看：

• 📊 统计面板：技能数、触发词数、网络密度
• 🔍 实时匹配测试：输入查询即时看结果
• 📋 技能触发词分布：按触发词数量排序
• 🔄 一键重新索引

作为技能路由器使用#

当用户问题不确定该激活哪个技能时，执行以下步骤：

Step 1: 确保数据库最新#

bash

python ~/.workbuddy/skills/spider-web/scripts/index_triggers.py

Step 2: 执行匹配#

bash

python ~/.workbuddy/skills/spider-web/scripts/match_engine.py "<用户原始查询>" --skill --top 3

Step 3: 路由到目标技能#

根据返回的技能名，使用 Skill tool 加载目标技能。

示例：

text

用户: "帮我分析一下这个商品的主图有没有优化空间"
→ spider-web 匹配 → ecommerce-image-diagnosis
→ 加载 ecommerce-image-diagnosis 技能

匹配引擎详解#

匹配层级#

层级方法速度准确度L1精确子串匹配⚡ 极快高L2技能名称直接匹配⚡ 极快高L3中文字符级重叠 (Bigram + Jaccard + LCS)🔵 快中高L4英文模糊匹配 (difflib)🟡 中中

串联模式 (AND)#

bash

python ~/.workbuddy/skills/spider-web/scripts/match_engine.py "我要用鸿蒙做个小程序" --mode and

要求查询同时匹配多个触发词才激活技能。

并联模式 (OR)#

bash

python ~/.workbuddy/skills/spider-web/scripts/match_engine.py "帮我分析数据" --mode or

任意触发词匹配即可。

模糊匹配#

bash

python ~/.workbuddy/skills/spider-web/scripts/match_engine.py "股票" --fuzzy

触发词数据库结构#

scripts/trigger_db.json:

json

{
  "meta": {
    "total_skills": 38,
    "total_triggers": 399,
    "unique_triggers": 390,
    "overlap_triggers": 9
  },
  "skills": {
    "finance-daily-report": ["财经日报", "今日财经", "股市日报", ...],
    "flower-care": ["识花", "这是什么花", "花卉识别", ...]
  },
  "reverse_index": {
    "财经日报": ["finance-daily-report"],
    "股市行情": ["finance-daily-report"],
    ...
  }
}

为现有技能添加触发词#

每个技能的触发词定义在 SKILL.md 的 description 字段中，格式：

yaml

description: >
  技能描述文本。
  触发词：关键词1, 关键词2, 关键词3。
  Triggers: keyword4, keyword5.

支持中英文触发词标记：

• 触发词： 或 触发词: — 中文触发词
• Triggers: 或 Trigger: — 英文触发词

运行 index_triggers.py 重新索引后生效。

Web Dashboard API 端点#

方法路径说明GET/交互式管理面板GET/api/health健康检查GET/api/data完整数据库GET/api/stats统计摘要GET/api/export导出 JSONPOST/api/match查询匹配 {"query":"...", "mode":"auto"}POST/api/reindex重新索引

注意事项#

1. 首次使用需索引：运行 index_triggers.py 生成数据库
2. 新增技能后需重新索引：新安装的技能不会自动注册
3. 触发词重叠处理：当多个技能共享同一个触发词时，通过评分机制自动排序
4. 中文匹配：使用字符 Bigram + Jaccard + LCS 三重算法，对自然语言友好
5. Windows 编码：所有脚本已处理 GBK/UTF-8 编码问题