wiki-manager（维基管理员）

wiki-manager / Wiki 索引管理

版本：v1.0 创建：2026-04-08 更新：2026-04-08（空空建议，改为单 JSON 索引方案） 依据：空空方案 + 小蜂自想（两者高度一致） 铁三角：彧哥 + 空空 + 小蜂

核心理念

用工具化索引文件代替散 .md：

• 1 个 wiki.json = 所有关键词索引
• 500 条封顶
• 三池循环（core / buffer / new）
• 不存大段正文，内容交给向量库/memory

文件结构

wiki/
├── wiki.json       ← 索引文件（三池合一，全部词条在这里）
├── wiki.json.bak   ← 上一次备份（每次写入前自动更新）
└── SKILL.md       ← 本文件，管理脚本

wiki.json 结构

{
  "version": "1.0",
  "name": "小蜂Wiki索引",
  "pools": {
    "core":   { "name": "核心热词池", "limit": 200 },
    "buffer": { "name": "次热缓冲池", "limit": 200 },
    "new":    { "name": "新晋新词池", "limit": 100 }
  },
  "entries": [
    {
      "id": "001",
      "keyword": "四部曲",
      "pool": "core",
      "definition": "想→说→做→看，沟通决策流程",
      "source": "skills/4steps-to-wisdom/SKILL.md",
      "score": 5,
      "lastUsed": "2026-04-08",
      "created": "2026-04-08",
      "sourceType": "skill"
    }
  ]
}

字段说明：

三池容量

循环规则

new 高频用 → 升 buffer
buffer 高频用 → 升 core
core 长期不用 → 降 buffer
buffer 长期不用 → 降 new → 淘汰

降级/淘汰触发：最后使用距今 > 30 天

管理脚本（无工具版，用 exec）

查词（按池）

# 查 core 池
cat wiki/wiki.json | jq '.entries | map(select(.pool == "core"))'

# 模糊搜索
cat wiki/wiki.json | jq '.entries | map(select(.keyword | contains("四部")))'

查所有（高效加载）

cat wiki/wiki.json    # 一次读完所有词条，毫秒级

新增词条

# 编辑 wiki/wiki.json，手动追加 entries[]
# 注意：先检查是否已存在（keyword 去重）

升降级

# 将某词从 new 升到 buffer（score >= 3 时触发）
# 修改 wiki.json 中对应 entry 的 pool 字段

淘汰检查（每次心跳或定期）

# 检查 buffer/new 池中最后使用 > 30 天的词
cat wiki/wiki.json | jq '.entries | map(select(.lastUsed < "2026-03-09" and .pool != "core"))'

备份（写入前自动）

cp wiki/wiki.json wiki/wiki.json.bak

compact 恢复流程

compact 后认知丢失 → 执行以下步骤恢复：

1. cat wiki/wiki.json         # 加载所有词条（毫秒级）
2. 读取 definition 字段       # 恢复一句话认知
3. 如需详细内容 → 从 source 字段路径读取 memory/ 向量库

维护节奏

注意事项

• 每次写入前先 cp wiki/wiki.json wiki/wiki.json.bak
• wiki.json 损坏时用 cp wiki/wiki.json.bak wiki/wiki.json 恢复
• compact 后 reload 一次 wiki.json 即可恢复全部词条认知
• 不要存大段正文，只存引用路径，详细内容在 memory 向量库

*Wiki 索引管理 v1.0 - 轻量高效，铁三角共识*