claude_dev
eefedd5f07
- 创建 skills/llmwiki/SKILL.md (使用导向) - 更新项目 CLAUDE.md (实现导向) - 更新全局 CLAUDE.md (添加 llmwiki 条目) - 安装 skill 到 ~/.claude/skills/llmwiki/ 使用场景和实现方法分离，更清晰 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
4.5 KiB
4.5 KiB
sanguo_llmwiki - Claude Code 项目配置
项目说明
混合架构 Wiki 系统 - MCP Server (Python) + Wiki Skills
路径
- 开发目录:
~/.openclaw/sanguo_projects/sanguo_llmwiki - 安装目录:
~/.sanguo_projects/sanguo_llmwiki - Wiki Vault:
/Volumes/KnowledgeBase/wiki-vault
架构设计
四层架构
┌─────────────────────────────────────┐
│ MCP Protocol Layer │ stdio 通信
├─────────────────────────────────────┤
│ Tool Layer (8 tools) │ wiki_query, memory_bridge...
├─────────────────────────────────────┤
│ Service Layer │ Query, Indexer, Parser...
├─────────────────────────────────────┤
│ Storage Layer (SQLite + FTS5) │ wiki_pages, wiki_fts...
└─────────────────────────────────────┘
技术栈
- 语言: Python 3.10+
- 数据库: SQLite (WAL 模式)
- 搜索: FTS5 全文搜索
- 通信: MCP stdio 协议
- 部署: PM2 进程管理
目录结构
sanguo_llmwiki/
├── mcp_server/ # MCP Server (4 层架构, 21 文件)
│ ├── __init__.py
│ ├── main.py # MCP 协议入口
│ ├── protocol/ # Protocol Layer
│ ├── tools/ # Tool Layer (8 tools)
│ ├── services/ # Service Layer
│ └── storage/ # Storage Layer
├── skills/ # Wiki Skills (11 个)
│ ├── llmwiki/ # 汇总技能
│ ├── wiki-setup/
│ ├── wiki-ingest/
│ └── ...
├── tests/ # 测试套件 (90+ 用例)
├── docs/ # 设计文档
├── config.yaml # 配置文件
└── ecosystem.config.cjs # PM2 配置
开发命令
# 测试
pytest
# 启动 MCP Server (开发模式)
python3 -m mcp_server.main
# 部署到安装目录
scripts/deploy.sh
# 启动生产服务
pm2 start ecosystem.config.cjs
pm2 list # 查看状态
pm2 logs wiki-mcp # 查看日志
MCP 工具 (8 个)
| 工具 | 功能 | 方法 |
|---|---|---|
wiki_query |
FTS5 全文搜索 + 标签过滤 | wiki_query(query, tags, limit) |
memory_bridge |
按工具来源浏览 | memory_bridge(tool_name, date_range) |
wiki_status |
索引状态查询 | wiki_status() |
wiki_lint |
健康审计 | wiki_lint(path, level) |
cross_linker |
发现缺失的交叉链接 | cross_linker(path, dry_run) |
tag_taxonomy |
标签一致性检查 | tag_taxonomy(path, enforce) |
wiki_synthesize |
跨概念综合分析 | wiki_synthesize(concepts, threshold) |
daily_update |
日常维护 | daily_update() |
Wiki Skills (11 个)
| 优先级 | 技能 | 功能 |
|---|---|---|
| P0 | wiki-setup |
初始化 wiki vault |
| P0 | wiki-ingest |
蒸馏文档为 wiki 页面 |
| P0 | wiki-capture |
保存对话为 wiki 笔记 |
| P1 | wiki-rebuild |
重建 wiki 索引 |
| P1 | data-ingest |
录入非结构化数据 |
| P1 | ingest-url |
抓取 URL 内容 |
| P1 | wiki-export |
导出知识图谱 |
| P2 | wiki-research |
多轮搜索研究 |
| P2 | impl-validator |
验证实现 |
| P2 | graph-colorize |
着色 Obsidian 图形 |
| P2 | wiki-agent |
录入 agent 历史 |
详细用法见 skills/*/SKILL.md
配置说明
config.yaml
# Wiki 路径
wiki_vault_path: "/Volumes/KnowledgeBase/wiki-vault"
# 数据库路径
database_path: "/Volumes/KnowledgeBase/wiki-vault/.wiki-index.db"
# 搜索配置
search:
max_results: 10
snippet_length: 200
环境变量
export WIKI_INDEX_PATH="/Volumes/KnowledgeBase/wiki-vault/.wiki-index.db"
export WIKI_VAULT_PATH="/Volumes/KnowledgeBase/wiki-vault"
搜索改进
连字符扩展
multi-agent → 自动搜索 multi AND agent
中文同义词映射
多智能体 → 自动扩展为 multi-agent
搜索片段显示
返回匹配文本片段，快速定位相关内容
相关文档
docs/01-requirements.md- 需求文档docs/02-design.md- 设计文档skills/llmwiki/SKILL.md- 使用手册