feat(knowledge): 完成 L0+L1 混合检索集成

核心功能：
- 新增 FrontmatterParser 解析 YAML frontmatter
- 新增 KnowledgeIndexService L0 内存索引
- 新增 LookupKnowledgeTool 混合检索工具
- 增强 DocumentManagementService 文件保存和索引同步

技术实现：
- 数据库迁移 V004: api_document.metadata (TEXT)
- 依赖新增: snakeyaml 2.0
- 配置新增: knowledge.base-path
- 可观测性: requestId 追踪 + 性能日志

质量保证：
- 单元测试: 31/31 通过
- 测试覆盖: FrontmatterParser(11), KnowledgeIndexService(13), LookupKnowledgeTool(7)
- 启动验证: L0 索引正常加载

归档文档：
- OpenSpec: openspec/changes/lookup-knowledge-integration/
- devflow 档案: devflow/projects/2026-06-24-lookup-knowledge-integration/
- handoff: handoff/2026-06-24-lookup-knowledge-integration.md

knowledge_base/api/payment-errors.md

@@ -0,0 +1,32 @@
+---
+title: 支付网关错误码定义
+keywords: [ERR_TIMEOUT, 超时, 支付网关]
+summary: 记录了支付网关所有核心错误码的含义及排查方向
+category: api
+---
+
+# 支付网关错误码定义
+
+## 1. 超时类错误
+
+### ERR_TIMEOUT
+- **含义**：支付网关请求超时
+- **常见原因**：网络延迟、第三方服务响应慢
+- **排查方向**：检查网络连接、查看第三方服务状态
+
+### ERR_GATEWAY_TIMEOUT
+- **含义**：上游网关超时
+- **常见原因**：银行接口响应慢
+- **排查方向**：联系银行技术支持
+
+## 2. 业务类错误
+
+### ERR_INSUFFICIENT_BALANCE
+- **含义**：余额不足
+- **常见原因**：用户账户余额不够
+- **排查方向**：提示用户充值
+
+### ERR_INVALID_AMOUNT
+- **含义**：金额无效
+- **常见原因**：金额为负数或超过限额
+- **排查方向**：检查金额校验逻辑