Compare commits
7 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| d1e3c660b8 | |||
| f87aad52db | |||
| eefedd5f07 | |||
| ecee4113d4 | |||
| 6a93f15c07 | |||
| e5f14cba1f | |||
| d13019c631 |
@@ -1,55 +0,0 @@
|
||||
# Code Review Agent - sanguo_llmwiki 搜索改进
|
||||
|
||||
## 任务
|
||||
|
||||
对以下 PR 进行全面的代码审查:
|
||||
|
||||
**分支**: `feat/search-improvements` → `main`
|
||||
**提交**: `feat: 搜索改进与代码修复`
|
||||
|
||||
## 审查重点
|
||||
|
||||
### 1. 搜索改进功能
|
||||
|
||||
**连字符扩展** (`database.py:505-519`):
|
||||
```python
|
||||
def _expand_hyphenated_text(self, text: str) -> str:
|
||||
if not text:
|
||||
return ""
|
||||
return text.replace('-', ' ')
|
||||
```
|
||||
- 检查是否有边缘情况处理(如连续连字符、连字符在开头/结尾)
|
||||
- 验证扩展后的文本是否正确存储到 FTS 表
|
||||
|
||||
**中文同义词支持** (`query.py:17-27, 53-74`):
|
||||
- 检查同义词映射表是否完整
|
||||
- 验证查询扩展逻辑是否正确处理 OR 连接
|
||||
- 检查缓存 key 是否包含 `use_synonyms` 参数
|
||||
|
||||
### 2. 代码质量
|
||||
|
||||
- 一致性:代码风格是否与现有代码一致
|
||||
- 错误处理:是否有适当的异常处理
|
||||
- 性能:查询扩展是否会影响性能
|
||||
- 测试覆盖:新功能是否有对应测试
|
||||
|
||||
### 3. 文档更新
|
||||
|
||||
- 设计文档 (docs/02-design.md) 是否准确反映改动
|
||||
- 注释是否清晰
|
||||
|
||||
## 审查输出
|
||||
|
||||
请提供:
|
||||
|
||||
1. **发现问题列表**(按严重性分类)
|
||||
2. **建议改进**
|
||||
3. **是否 LGTM(Looks Good To Me)**
|
||||
|
||||
---
|
||||
|
||||
**参考文件**:
|
||||
- mcp_server/services/query.py
|
||||
- mcp_server/storage/database.py
|
||||
- mcp_server/services/parser.py
|
||||
- docs/02-design.md
|
||||
@@ -174,3 +174,4 @@ cython_debug/
|
||||
# PyPI configuration file
|
||||
.pypirc
|
||||
|
||||
.claude/review_agent.md
|
||||
|
||||
@@ -4,48 +4,144 @@
|
||||
|
||||
混合架构 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 实现 (Python)
|
||||
├── skills/ # Wiki Skills (11 个)
|
||||
├── tests/ # 测试套件
|
||||
├── docs/ # 文档
|
||||
├── 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 配置
|
||||
```
|
||||
|
||||
## 快速命令
|
||||
## 开发命令
|
||||
|
||||
```bash
|
||||
# 运行测试
|
||||
# 测试
|
||||
pytest
|
||||
|
||||
# 启动 MCP Server (开发)
|
||||
# 启动 MCP Server (开发模式)
|
||||
python3 -m mcp_server.main
|
||||
|
||||
# 部署到安装目录
|
||||
# 从 ~/.openclaw/sanguo_projects/sanguo_llmwiki
|
||||
# 到 ~/.sanguo_projects/sanguo_llmwiki
|
||||
scripts/deploy.sh
|
||||
|
||||
# 启动生产服务
|
||||
pm2 start ecosystem.config.cjs
|
||||
pm2 list # 查看状态
|
||||
pm2 logs wiki-mcp # 查看日志
|
||||
```
|
||||
|
||||
## MCP 工具
|
||||
## MCP 工具 (8 个)
|
||||
|
||||
服务器提供 8 个工具:
|
||||
- wiki_query: 搜索 wiki
|
||||
- memory_bridge: 记忆桥接
|
||||
- wiki_status: 状态查询
|
||||
- wiki_lint: 健康审计
|
||||
- cross_linker: 交叉链接
|
||||
- tag_taxonomy: 标签分类
|
||||
- wiki_synthesize: 主题综合
|
||||
- daily_update: 日常维护
|
||||
| 工具 | 功能 | 方法 |
|
||||
|------|------|------|
|
||||
| `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
|
||||
## Wiki Skills (11 个)
|
||||
|
||||
11 个一次性操作技能位于 skills/ 目录下。
|
||||
| 优先级 | 技能 | 功能 |
|
||||
|--------|------|------|
|
||||
| **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
|
||||
|
||||
```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
|
||||
```
|
||||
|
||||
### 环境变量
|
||||
|
||||
```bash
|
||||
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` - 使用手册
|
||||
|
||||
+17
-2
@@ -1038,6 +1038,21 @@ pm2 save
|
||||
|
||||
## 14. 修订记录
|
||||
|
||||
### v1.4(2026-07-03)- 文档结构重组
|
||||
|
||||
**文档重组:**
|
||||
- ✅ **创建 `skills/llmwiki/SKILL.md`** - 使用导向,包含场景、方法、触发条件
|
||||
- ✅ **更新项目 `CLAUDE.md`** - 实现导向,包含架构、技术、命令
|
||||
- ✅ **更新全局 `CLAUDE.md`** - 添加 llmwiki skill 条目
|
||||
|
||||
**设计原则:**
|
||||
- 使用者看 `SKILL.md`(如何用)
|
||||
- 开发者看 `CLAUDE.md`(如何实现)
|
||||
|
||||
**变更影响:**
|
||||
- `/llmwiki` 命令现在可以自动触发
|
||||
- 文档职责更清晰,维护更容易
|
||||
|
||||
### v1.3(2026-06-28)- 搜索改进与代码修复
|
||||
|
||||
**搜索改进(P0-P1):**
|
||||
@@ -1085,6 +1100,6 @@ pm2 save
|
||||
|
||||
---
|
||||
|
||||
*文档版本:v1.3*
|
||||
*文档版本:v1.4*
|
||||
*创建时间:2026-06-26*
|
||||
*更新时间:2026-06-28*
|
||||
*更新时间:2026-07-03*
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
|
||||
**项目名称**: sanguo_llmwiki
|
||||
**描述**: 混合架构 Wiki 系统 - MCP Server (Python) + Wiki Skills (11 个)
|
||||
**状态**: ✅ Phase 1-4 完成,待 Phase 5 部署
|
||||
**状态**: ✅ Phase 1-5 全部完成(项目已完成)
|
||||
|
||||
## 完成的工作
|
||||
|
||||
@@ -89,11 +89,19 @@
|
||||
|
||||
## 待完成工作
|
||||
|
||||
### Phase 5: 部署
|
||||
- [ ] 配置 PM2 (ecosystem.config.cjs 已准备)
|
||||
- [ ] 设置环境变量
|
||||
- [ ] 验证 MCP Server 连接
|
||||
- [ ] 配置 Claude Code MCP 客户端
|
||||
### Phase 5: 部署 ✅ 已完成
|
||||
- [x] 配置 PM2 (ecosystem.config.cjs 已准备)
|
||||
- [x] 设置环境变量
|
||||
- [x] 验证 MCP Server 连接
|
||||
- [x] 配置 Claude Code MCP 客户端 (.claude/settings.json)
|
||||
|
||||
### 部署验证结果
|
||||
- ✅ MCP Server 在安装目录正常运行
|
||||
- ✅ 8 个工具全部注册成功
|
||||
- ✅ wiki_query 搜索功能正常
|
||||
- ✅ wiki_status 统计功能正常
|
||||
- ✅ 数据库连接和事务正常
|
||||
- ✅ Wiki 索引状态:459 页面,810 链接,641 标签
|
||||
|
||||
## 代码统计
|
||||
|
||||
@@ -125,6 +133,13 @@ sanguo_llmwiki 项目的核心开发工作已完成:
|
||||
|
||||
项目已准备就绪,可进入 Phase 5 部署阶段。
|
||||
|
||||
**Phase 5 部署状态(2026-06-28)**:
|
||||
- ✅ 部署到安装目录 `~/.sanguo_projects/sanguo_llmwiki`
|
||||
- ✅ MCP Server 通过 stdio 模式正常运行
|
||||
- ✅ 8 个工具全部测试通过
|
||||
- ✅ Wiki 索引状态:459 页面,810 链接,641 标签
|
||||
- ✅ Claude Code MCP 客户端配置完成
|
||||
|
||||
---
|
||||
生成时间: 2024-01-15
|
||||
生成时间: 2026-06-28
|
||||
Co-Authored-By: Claude Dev <noreply@anthropic.com>
|
||||
|
||||
@@ -0,0 +1,135 @@
|
||||
# sanguo_llmwiki 项目完成报告
|
||||
|
||||
**项目名称**: sanguo_llmwiki
|
||||
**完成时间**: 2026-06-28
|
||||
**状态**: ✅ 全部完成 (Phase 1-5)
|
||||
|
||||
---
|
||||
|
||||
## 项目概览
|
||||
|
||||
混合架构 Wiki 系统,结合 MCP Server (Python) 和 Wiki Skills,为 Claude Code 提供 Wiki 知识库查询能力。
|
||||
|
||||
### 核心特性
|
||||
- **4 层架构**: Storage → Service → Tool → Protocol
|
||||
- **8 个 MCP 工具**: wiki_query, memory_bridge, wiki_status, wiki_lint, cross_linker, tag_taxonomy, wiki_synthesize, daily_update
|
||||
- **11 个 Wiki Skills**: wiki-setup, wiki-ingest, wiki-capture, wiki-rebuild, data-ingest, ingest-url, wiki-export, wiki-research, impl-validator, graph-colorize, wiki-agent
|
||||
- **FTS5 全文搜索**: 高性能中文分词搜索
|
||||
- **异步 I/O**: aiosqlite + aiofiles 完全异步
|
||||
|
||||
---
|
||||
|
||||
## 交付成果
|
||||
|
||||
### 代码文件
|
||||
| 模块 | 文件数 | 说明 |
|
||||
|------|--------|------|
|
||||
| Storage Layer | 1 | database.py (532 行) |
|
||||
| Service Layer | 5 | cache, query, parser, indexer, graph |
|
||||
| Tool Layer | 8 | 8 个 MCP 工具实现 |
|
||||
| Protocol Layer | 1 | main.py (222 行) |
|
||||
| Wiki Skills | 11 | SKILL.md 定义 |
|
||||
| Tests | 3 | unit, integration, e2e |
|
||||
|
||||
### 文档
|
||||
| 文档 | 说明 |
|
||||
|------|------|
|
||||
| docs/01-requirements.md | 需求文档 |
|
||||
| docs/01-requirements-review.md | 需求评审报告 |
|
||||
| docs/02-design.md | 设计文档 v1.2 |
|
||||
| docs/02-design-review.md | 设计评审报告 |
|
||||
| docs/03-completion-summary.md | 完成总结 |
|
||||
| docs/04-final-report.md | 本报告 |
|
||||
|
||||
---
|
||||
|
||||
## Phase 完成情况
|
||||
|
||||
### Phase 1: 需求分析 ✅
|
||||
- 需求文档完整
|
||||
- 需求评审通过
|
||||
|
||||
### Phase 2: 设计 ✅
|
||||
- 设计文档 v1.2 完成
|
||||
- 两轮设计评审,10 个问题修复
|
||||
|
||||
### Phase 3: 实现 ✅
|
||||
- MCP Server 4 层架构完整实现
|
||||
- 11 个 Wiki Skills 完整实现
|
||||
- 90+ 测试用例覆盖
|
||||
|
||||
### Phase 4: 代码审查和测试 ✅
|
||||
- 5 个审查问题全部修复
|
||||
- 单元测试通过
|
||||
- 集成测试通过
|
||||
|
||||
### Phase 5: 部署 ✅
|
||||
- 部署到 `~/.sanguo_projects/sanguo_llmwiki`
|
||||
- MCP Server 通过 stdio 模式正常运行
|
||||
- Claude Code MCP 客户端配置完成
|
||||
- 8 个工具全部测试通过
|
||||
|
||||
---
|
||||
|
||||
## 部署验证结果
|
||||
|
||||
```
|
||||
=== MCP Server Test (2026-06-28) ===
|
||||
Registered tools: ['wiki_query', 'memory_bridge', 'wiki_status', 'wiki_lint', 'cross_linker', 'tag_taxonomy', 'wiki_synthesize', 'daily_update']
|
||||
|
||||
=== wiki_query('moziplus') ===
|
||||
Found: practices/moziplus-multi-project-practices.md
|
||||
|
||||
=== wiki_status ===
|
||||
Pages: 459, Links: 810, Tags: 641
|
||||
|
||||
All tests passed!
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 技术栈
|
||||
|
||||
- **Python**: 3.11+
|
||||
- **异步框架**: aiosqlite, aiofiles
|
||||
- **MCP SDK**: mcp 1.28.0
|
||||
- **数据解析**: PyYAML
|
||||
- **测试框架**: pytest
|
||||
- **进程管理**: PM2
|
||||
|
||||
---
|
||||
|
||||
## Git 历史
|
||||
|
||||
最近的提交:
|
||||
1. `6a93f15` docs: Phase 5 部署完成
|
||||
2. `67157df` feat: 实现完整测试套件
|
||||
3. `9649e8a` feat: 实现 11 个 Wiki Skills
|
||||
4. `62b8fef` fix: 代码审查问题修复
|
||||
5. `dfd8421` feat: 实现 MCP Server 核心
|
||||
|
||||
---
|
||||
|
||||
## 待推送
|
||||
|
||||
本地有新的提交需要推送到远程:
|
||||
```bash
|
||||
cd ~/.openclaw/sanguo_projects/sanguo_llmwiki
|
||||
git push origin main
|
||||
```
|
||||
|
||||
注意:推送可能需要 PR 审查(根据仓库配置)。
|
||||
|
||||
---
|
||||
|
||||
## 后续建议
|
||||
|
||||
1. **监控**: 设置日志监控和告警
|
||||
2. **备份**: 定期备份 index.db
|
||||
3. **更新**: 定期运行 `daily_update` 工具更新索引
|
||||
4. **扩展**: 考虑 SSE 模式支持多客户端并发
|
||||
|
||||
---
|
||||
|
||||
**项目状态**: ✅ 完成并可用
|
||||
**Co-Authored-By**: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
||||
@@ -0,0 +1,176 @@
|
||||
---
|
||||
name: llmwiki
|
||||
description: LLM Wiki 知识库系统 - 支持搜索、蒸馏、维护
|
||||
trigger: 当用户查询知识库、优秀实践,总结经验、或管理 wiki 时
|
||||
---
|
||||
|
||||
# /llmwiki
|
||||
|
||||
LLM Wiki 是你的持久化知识库,支持跨会话记忆、自动索引、智能关联。
|
||||
|
||||
## Wiki 位置
|
||||
|
||||
| 路径 | 用途 | 类型 |
|
||||
|------|------|------|
|
||||
| `/Volumes/KnowledgeBase/wiki-vault` | 编译后的 LLM Wiki (Obsidian 格式) | 生产 |
|
||||
| `/Volumes/KnowledgeBase/knowledge_base` | 原始材料 | 源文件 |
|
||||
|
||||
## 使用场景
|
||||
|
||||
### 查询知识库
|
||||
```
|
||||
"我的 wiki 里有什么关于 multi-agent 的内容?"
|
||||
"查一下我之前记录的 SQLite 并发经验"
|
||||
```
|
||||
|
||||
### 查询优秀实践
|
||||
```
|
||||
"我的优秀实践有哪些?"
|
||||
"根据我的 wiki,多智能体编排的最佳实践是什么?"
|
||||
"wiki 里关于测试的实践"
|
||||
```
|
||||
|
||||
### 总结经验
|
||||
```
|
||||
"总结这次项目的经验教训"
|
||||
"把这次对话蒸馏到 wiki"
|
||||
"记录这个问题的解决过程"
|
||||
```
|
||||
|
||||
### 管理 wiki
|
||||
```
|
||||
"检查 wiki 健康状况"
|
||||
"更新 wiki 索引"
|
||||
"发现缺失的交叉链接"
|
||||
```
|
||||
|
||||
## 查询触发规则
|
||||
|
||||
**BEFORE answering any question, first check wiki for existing knowledge:**
|
||||
|
||||
1. **User asks "优秀实践" / "最佳实践" / "best practice"** → MUST search `practices/` first
|
||||
2. **Doing research/analysis/investigation** → MUST search `practices/` for existing experience
|
||||
3. **Technical selection/architecture design** → MUST search wiki for related patterns
|
||||
4. **Multi-agent orchestration questions** → Check `practices/moziplus-*` first
|
||||
5. **SQLite/concurrency questions** → Check `practices/sanguo-team-experience` first
|
||||
|
||||
### 查询流程
|
||||
|
||||
```
|
||||
1. Read /Volumes/KnowledgeBase/wiki-vault/index.md
|
||||
2. Search relevant sections (practices/, concepts/, projects/)
|
||||
3. Synthesize answer with [[wikilink]] citations
|
||||
4. Log query to wiki-vault/log.md
|
||||
```
|
||||
|
||||
## 知识管理流程
|
||||
|
||||
```
|
||||
┌─────────────────┐ wiki-query ┌──────────────┐
|
||||
│ Problem/Decision │ ──────────────────→ │ Search Wiki │
|
||||
└─────────────────┘ └──────────────┘
|
||||
│ │
|
||||
↓ Not found ↓ Found
|
||||
┌─────────────────┐ ┌──────────────┐
|
||||
│ Research/Solve │ ←────────────────── │ Apply Answer │
|
||||
└─────────────────┘ wiki-update └──────────────┘
|
||||
│
|
||||
↓ After solving
|
||||
┌─────────────────┐
|
||||
│ wiki-update │ → Distill to wiki
|
||||
└─────────────────┘
|
||||
```
|
||||
|
||||
### 何时更新 Wiki
|
||||
|
||||
**DO distill to wiki:**
|
||||
- Architecture decisions and *why* they were made
|
||||
- Patterns discovered (things you'd Google again)
|
||||
- Key abstractions and mental models
|
||||
- Trade-offs evaluated and choices made
|
||||
- Lessons learned not obvious from code
|
||||
|
||||
**DON'T distill:**
|
||||
- File listings, boilerplate
|
||||
- Individual bug fixes with no broader lesson
|
||||
- Dependency versions
|
||||
- Implementation details code already states
|
||||
|
||||
**Heuristic**: *If reading the codebase answers the question, don't wiki it. If you'd have to re-derive reasoning from git blame across 20 commits, wiki it.*
|
||||
|
||||
## Wiki 结构
|
||||
|
||||
```
|
||||
/Volumes/KnowledgeBase/wiki-vault/
|
||||
├── practices/ # 最佳实践、经验教训
|
||||
├── concepts/ # 概念、思维模型
|
||||
├── entities/ # 人物、公司、工具
|
||||
├── projects/ # 项目文档
|
||||
├── skills/ # 如何做教程
|
||||
├── references/ # 外部资料摘要
|
||||
├── synthesis/ # 跨项目分析
|
||||
├── journal/ # 日常笔记
|
||||
├── index.md # 主索引
|
||||
├── log.md # 查询/更新日志
|
||||
└── wiki-instructions.md # 触发规则
|
||||
```
|
||||
|
||||
## 与项目集成
|
||||
|
||||
在任何项目中工作时:
|
||||
1. **Before starting**: 检查 wiki 中是否有相关模式/实践
|
||||
2. **During work**: 在讨论中引用相关 wiki 页面
|
||||
3. **After completion**: 运行 wiki-update 蒸馏新知识
|
||||
|
||||
## MCP 工具
|
||||
|
||||
后台自动调用,无需手动:
|
||||
|
||||
| 工具 | 功能 |
|
||||
|------|------|
|
||||
| `wiki_query` | FTS5 全文搜索 + 标签过滤 |
|
||||
| `memory_bridge` | 按工具来源浏览 (claude/web_reader/gitea/other) |
|
||||
| `wiki_status` | 索引状态查询 |
|
||||
| `wiki_lint` | 健康审计 (格式、链接、frontmatter) |
|
||||
| `cross_linker` | 发现缺失的交叉链接 |
|
||||
| `tag_taxonomy` | 标签一致性检查 |
|
||||
| `wiki_synthesize` | 跨概念综合分析 |
|
||||
| `daily_update` | 日常维护 (索引更新、hot.md 生成) |
|
||||
|
||||
## Wiki Skills
|
||||
|
||||
一次性操作技能,详细用法见各技能目录:
|
||||
|
||||
| 优先级 | 技能 | 功能 |
|
||||
|--------|------|------|
|
||||
| **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 历史 |
|
||||
|
||||
## Frontmatter 模板
|
||||
|
||||
```yaml
|
||||
---
|
||||
name: page-slug
|
||||
description: 一句话摘要
|
||||
metadata:
|
||||
type: practice | concept | entity | project | skill | reference | synthesis
|
||||
created: YYYY-MM-DD
|
||||
tags: [tag1, tag2]
|
||||
---
|
||||
```
|
||||
|
||||
## 注意
|
||||
|
||||
- Wiki 可以从**任何项目目录**使用(不只是 obsidian-wiki)
|
||||
- 所有 wiki 页面使用 `[[wikilinks]]` 进行交叉引用
|
||||
- 页面有生命周期标记: `draft`, `verified`, `archived`, `disputed`
|
||||
- 陈旧页面(>90 天)会在查询结果中标注
|
||||
Reference in New Issue
Block a user