Skip to content

SpikeRouting_Params_Guide.md

Latest commit

 

History

History
61 lines (49 loc) · 4.24 KB

SpikeRouting_Params_Guide.md

File metadata and controls

61 lines (49 loc) · 4.24 KB

TagMemo 虫洞扩散路由 (Spike Routing) 参数调控指南

本文档旨在为前端 UI 组以及系统管理员提供 KnowledgeBaseManager.spikeRouting 配置项中各参数的具体含义与调参影响，以便在管理面板 (Admin Panel) 适配对应的数值控制/滑动条。

配置文件路径

该参数集保存在持久化文件 rag_params.json 下的 KnowledgeBaseManager.spikeRouting 节点。

参数详解与 UI 建议

1. 宏观控制类

  • maxSafeHops (最高安全跳数)

    • 含义: 限制网络中任何一条脉冲路径绝对能够行进的最大边数，作为防止图环路死循环的最终安全阀。
    • 默认值: 4 (整数)
    • 影响: 设得过低（如 1 或 2）会截断虫洞的长距穿透；设得过高但在 baseMomentum 用尽前也是无害的，但如果触发了连续虫洞，可能会导致算力消耗。
    • UI 建议: 下拉框或只能选 3-6 的整数步进。平时无需开放给普通用户。

  • maxEmergentNodes (极值截断节点数)

    • 含义: 在经历了所有脉冲扩散后，最终允许“涌现”并重新注入召回阶段的无搜索源标签上限（防止污染搜索空间）。
    • 默认值: 50 (整数)
    • 处理结果: 按聚合能量排序后的 Top K 截断。
    • UI 建议: 滑动条，范围 10 - 100。

  • maxNeighborsPerNode (最大突触扇出)

    • 含义: 任何节点向下放电时，最多向关联最紧密的 N 个邻居传播。
    • 默认值: 20 (整数)
    • 影响: 决定了网络的“宽度”与“发散规模”。调大找得多但杂点多且慢。

2. 动量与张力类 (虫洞核心引擎)

  • baseMomentum (初始起跳动量 TTL)

    • 含义: 查询命中原始种子标签时赋予的传播点数（Time-to-Live）。
    • 默认值: 2.0 (浮点数)
    • 影响: 常规传播每次扣除 1.0 点动量。因此设为 2.0 意味着稠密区只能传两步。如果你希望它只能传一步就枯竭，设置 1.0。虫洞跳跃不扣除该点数。
    • UI 建议: 带有一位小数的滑动条，范围 1.0 - 5.0。

  • tensionThreshold (触发虫洞张力阈值)

    • 含义: = 边权 (coocWeight) * 目标节点的残差 (neighborResidual)。当目标节点新颖度极高时达到该阈值。
    • 默认值: 1.0 (浮点数)
    • 影响: 这个参数最关键。调高（>1.5）会导致极难触发跨域跳跃，算法变成乖宝宝；调低（<0.6）会导致遍地都是虫洞，系统过度脑补、疯狂漂移发散。
    • UI 建议: 精细滑动条（甚至加上显著的颜色警告刻度），范围 0.5 - 3.0。

3. 能量电位类 (阈值与衰减)

  • firingThreshold (底层放电阈值)

    • 含义: 节点能够向下传递电波所需的最低内部能量门槛。
    • 默认值: 0.10 (浮点数)
    • 影响: 防止末端极其微弱的信号继续占用算力做无意义衍生。

  • baseDecay (常规稠密区衰减)

    • 含义: 在相同话题的同质化集群内传播时，能量的折损倍率（保留部分）。
    • 默认值: 0.25 (浮点数)
    • 影响: 数值越小，衰减越剧烈（此处配置的 0.25 意味着下一波只剩下 25% 能量）。为了压制稠密区的无限回声，必须设得很低（< 0.4）。

  • wormholeDecay (特权虫洞区衰减)

    • 含义: 脉冲刺透语义屏障进入高新颖度、高残差节点时采取的衰减策略（保留部分）。
    • 默认值: 0.70 (浮点数)
    • 影响: 数值设定应明显高于 baseDecay。让这股冲破稠密陷阱的脉冲保留大部分（70%）能量，继续向外穿透。
    • UI 建议: 这两个 Decay 参数建议做成对比控制条，直观展示“剥削 (Exploitation: 低保留)”与“探索 (Exploration: 高保留)”的双驱平衡。

配置总结与调试建议： 当想要让系统“更加感性、思维跳跃”时 => 适当调低 tensionThreshold，调高 wormholeDecay 与 baseMomentum。 当想要系统“更加理性、紧抓核心”时 => 调高 tensionThreshold（封锁虫洞），调低 baseMomentum。