sanguo/sanguo_llmwiki
2
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity
15 Commits 2 Branches 0 Tags
421b3ada3b9ccd44e9a322149f89d7b6ad492eee
Commit Graph

15 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
claude_dev 421b3ada3b feat: 搜索改进与代码修复 
- 连字符扩展：multi-agent → multi agent 提升搜索召回率
- 中文同义词支持：添加中英文混合查询扩展
- Snippet 高亮预留：为 FTS5 snippet 功能预留接口
- YAML 解析增强：支持 HTML 实体解码
- 标签关联维护：自动维护 wiki_page_tags 关联表
- 缓存失效优化：支持智能前缀匹配
- 设计文档更新：汇总近期改动 (v1.3)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-28 07:47:28 +08:00
claude_dev b2c3ca02f0 chore: 添加 Claude Code 项目配置 
- .claude/settings.json: MCP 权限配置
- CLAUDE.md: 项目说明和快速命令

Co-Authored-By: Claude Dev <noreply@anthropic.com>
 2026-06-26 12:39:34 +08:00
claude_dev 5642fb4fa3 chore: 更新部署配置指向安装目录 
- cwd: ~/.sanguo_projects/sanguo_llmwiki (安装目录)
- script: python3 (明确使用 python3)
- WIKI_INDEX_PATH: 使用绝对路径

Co-Authored-By: Claude Dev <noreply@anthropic.com>
 2026-06-26 12:35:14 +08:00
claude_dev 850275a329 docs: 添加项目完成总结 
Phase 1-4 全部完成：
- ✅ 需求分析和评审
- ✅ 设计和两轮评审
- ✅ MCP Server 实现（4 层架构，8 工具）
- ✅ Wiki Skills 实现（11 个）
- ✅ 代码审查修复（5 个问题）
- ✅ 测试套件（90+ 用例）

待 Phase 5: 部署

Co-Authored-By: Claude Dev <noreply@anthropic.com>
 2026-06-26 12:23:19 +08:00
claude_dev 67157dff34 feat: 实现完整测试套件 
- 单元测试: Database 和 Service 层
- 集成测试: MCP 工具端到端测试
- 测试配置: pytest.ini 和覆盖率设置
- 测试文档: tests/README.md

测试覆盖:
- 数据库 CRUD 操作
- FTS5 搜索和验证
- 缓存服务 (LRU + TTL)
- 解析服务 (frontmatter, wikilinks)
- 索引服务 (增量更新, 重建)
- MCP 工具集成测试

Co-Authored-By: Claude Dev <noreply@anthropic.com>
 2026-06-26 12:21:10 +08:00
claude_dev 9649e8a761 feat: 实现 11 个 Wiki Skills 
P0 (核心):
- wiki-setup: 初始化 wiki vault
- wiki-ingest: 蒸馏文档为 wiki 页面
- wiki-capture: 保存对话为 wiki 笔记

P1 (重要):
- wiki-rebuild: 重建 wiki 索引
- data-ingest: 录入非结构化数据
- ingest-url: 抓取 URL 内容
- wiki-export: 导出知识图谱

P2 (可选):
- wiki-research: 多轮搜索研究
- impl-validator: 验证实现
- graph-colorize: 着色 Obsidian 图形
- wiki-agent: 录入 agent 历史

Co-Authored-By: Claude Dev <noreply@anthropic.com>
 2026-06-26 12:17:38 +08:00
claude_dev 62b8fef18a fix: 代码审查问题修复 
- C1 (Critical): 添加 PyYAML 解析 frontmatter，支持多行值和列表
- M1 (Major): 添加 FTS5 查询验证，防止注入攻击
- M2/M3 (Major): 工具类使用显式 wiki_vault_path 参数
- M4 (Major): 集成 aiofiles 实现真正的异步文件 I/O
- M5 (Major): 改用 logger.exception() 记录完整堆栈

Co-Authored-By: Claude Dev <noreply@anthropic.com>
 2026-06-26 12:10:41 +08:00
claude_dev dfd8421dc6 feat(§03): 实现 MCP Server 核心 - Storage/Service/Tool/MCP Protocol Layers 
**Storage Layer:**
- Database 类（aiosqlite + WAL + 并发保护）
- WikiPage 数据模型
- fix_dirty_states 恢复机制
- FTS5 全文搜索支持
- 完整的 SQLite 表结构

**Service Layer:**
- CacheService（LRU 缓存 + TTL + 大小限制）
- QueryService（查询服务）
- ParserService（Markdown 解析）
- IndexerService（索引服务）
- GraphService（链接图服务）

**Tool Layer (8 个 MCP Tools):**
- wiki_query - FTS5 全文搜索 + 标签过滤
- memory_bridge - 按工具来源浏览
- wiki_status - 索引状态
- wiki_lint - 健康审计
- cross_linker - 缺失链接发现
- tag_taxonomy - 标签一致性
- wiki_synthesize - 跨概念综合分析
- daily_update - 日常维护 + hot.md 生成

**MCP Protocol Layer:**
- MCP 协议解析和封装
- 工具注册和路由
- 错误处理和日志
- stdio 模式支持

**配置和部署:**
- requirements.txt
- config.example.yaml
- ecosystem.config.cjs (PM2)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 11:32:43 +08:00
claude_dev 67a53d82de docs(§02): v1.2 设计文档修订 - 修复第二轮评审发现的 3 个 Major 问题 
- M1: 修复 FTS5 表结构语法错误（删除重复定义，调整表创建顺序）
- M2: 在 WikiPage 中添加 source_tool 字段，解决 memory_bridge 的 tool_name 数据来源问题
- M3: 补充 CacheService 详细实现（LRU 缓存 + 最大容量 1000 条 + TTL 3600 秒 + asyncio.Lock）

两轮独立评审均通过，设计文档 v1.2 完成。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 11:15:23 +08:00
claude_dev 941febf63c docs(§02): v1.1 设计文档修订 - 修复 7 个评审问题 
- C1: 补充 QueryService 模块设计（第 2.3 节）
- C2: 补充完整 SQLite 表结构设计（第 3.3 节）
- M1: Database 类改用 aiosqlite（第 2.4 节）
- M2: 补充 MemoryBridgeTool 详细设计（第 2.2 节）
- M3: 配置项与需求对齐（第 6.1 节）
- M4: Wiki Skills 优先级对齐（第 10.2 节）
- M5: 新增 benchmark.py 设计（第 11 节）
- 5 个 Minor 问题也已修复

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 11:08:48 +08:00
claude_dev 22932e34eb docs: add design document (Phase 2) 
- 架构设计：MCP Server + Wiki Skills 混合架构
- 模块设计：4 层架构（Protocol/Tool/Service/Storage）
- 数据模型：WikiPage 和 WikiIndex
- 接口设计：MCP Tool 接口规范
- 核心算法：增量更新、查询、cross_linker
- 配置设计：YAML 配置 + 环境变量
- 错误处理：5 类错误处理策略
- 性能优化：FTS5、缓存、WAL 并发优化
- Wiki Skills 设计：11 个 Skills 优先级划分
- 测试设计：单元/集成/E2E 三层测试
- 部署设计：开发 + 生产环境配置

Phase 2: 设计评审

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 10:11:41 +08:00
claude_dev ed58d12c7e docs: revise requirements v1.1 based on best practices 
根据 wiki 优秀实践修订需求文档：

修复 Critical 问题：
- C1: 补充性能基准测试方案（参考 BitNet 实践）
- C2: 详细说明增量更新机制和索引结构
- C3: 明确 SQLite 并发策略（参考三国团队经验）
- C4: 明确使用 FTS5，语义搜索留作扩展

新增章节：
- 术语表、数据模型、错误处理、日志监控
- 风险分析、测试策略、配置管理

评审结果：✅ 通过

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 10:08:17 +08:00
claude_dev 8aa2776e18 docs: add requirements review report (Phase 1) 
- 独立 agent 评审完成
- 评级: 有条件通过
- 4 Critical, 7 Major, 4 Minor 问题
- 评审报告已提交

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 09:58:15 +08:00
claude_dev 70e337462e docs: add requirements document (Phase 1) 
- 添加需求文档 docs/01-requirements.md
- 更新 README.md
- Phase 1: 需求评审

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 09:56:15 +08:00
admin c1b736fa3a Initial commit 2026-06-26 01:53:02 +00:00