Skip to content

Commit 9cf3ad9

Browse files
committed
✨ 更新README文档,增强智能查询功能描述,支持复杂查询语法
✨ 在上下文信息中添加查询引擎操作符支持说明
1 parent f050bcc commit 9cf3ad9

File tree

3 files changed

+48
-3
lines changed

3 files changed

+48
-3
lines changed

.cunzhi-memory/context.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,3 +2,4 @@
22
- 已为CodeNexus项目创建综合实现文档implementation_guide.md,整合了Rust MCP生态系统指南、系统设计和文档规范,提供完整的3阶段实现路径(4-5周),包含技术架构、开发环境配置、核心组件实现、测试调试和部署指南
33
- CodeNexus项目已完成!实现了完整的多项目支持架构,包含13个MCP工具接口、路径安全验证、项目隔离存储、智能查询引擎等核心功能。项目可生产使用,所有测试通过,代码质量高,文档完善。解决了MCP服务器启动目录不可控的关键问题。
44
- 已为CodeNexus项目建立完整代码关系体系:17个文件100%标记和注释,31个依赖关系,37个多维度标签,支持智能查询、关系分析、架构导航等功能
5+
- 已为CodeNexus查询引擎实现完整操作符支持:NOT、OR、通配符、复合查询,支持复杂表达式如"(type:manager OR type:adapter) AND NOT module:core",并更新README文档说明新功能

.cunzhi-memory/metadata.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"project_path": "\\\\?\\E:\\Projects\\MyProjects\\code_nexus",
3-
"last_organized": "2025-07-08T07:45:59.176142800Z",
4-
"total_entries": 4,
3+
"last_organized": "2025-07-08T08:12:04.705590400Z",
4+
"total_entries": 5,
55
"version": "1.0.0"
66
}

README.md

Lines changed: 45 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ CodeNexus 是一个基于 Rust 和 Model Context Protocol (MCP) 的代码库关
77
- **标签管理**: 为文件添加结构化标签 (type:value 格式)
88
- **注释系统**: 为文件添加描述性注释
99
- **关联关系**: 建立文件间的依赖和关联关系
10-
- **智能查询**: 支持复杂的标签查询和关系搜索
10+
- **智能查询**: 支持复杂的标签查询(AND、OR、NOT、通配符)和关系搜索
1111
- **多项目支持**: 同时管理多个项目,每个项目独立存储
1212
- **路径验证**: 确保文件路径安全性和有效性
1313
- **MCP 集成**: 通过 MCP 协议与 AI 助手无缝集成
@@ -68,6 +68,14 @@ query_files_by_tags({
6868
"query": "category:api AND status:active"
6969
})
7070

71+
# 支持的查询语法:
72+
# - 单标签查询: "category:api"
73+
# - AND操作: "category:api AND status:active"
74+
# - OR操作: "type:manager OR type:adapter"
75+
# - NOT操作: "NOT module:core"
76+
# - 通配符: "module:*", "type:*"
77+
# - 复合查询: "(type:manager OR type:adapter) AND NOT module:core"
78+
7179
# 获取所有标签
7280
get_all_tags({
7381
"project_path": "/path/to/your/project"
@@ -92,6 +100,42 @@ update_file_comment({
92100
})
93101
```
94102

103+
## 查询语法
104+
105+
CodeNexus 支持强大的查询语法,可以进行复杂的标签搜索:
106+
107+
### 基本查询
108+
- **单标签查询**: `category:api`
109+
- **精确匹配**: `status:active`
110+
111+
### 逻辑操作符
112+
- **AND操作**: `category:api AND status:active`
113+
- **OR操作**: `type:manager OR type:adapter`
114+
- **NOT操作**: `NOT module:core`
115+
116+
### 通配符
117+
- **匹配所有**: `module:*` (匹配所有module标签)
118+
- **前缀匹配**: `type:manage*` (匹配type:manager等)
119+
120+
### 复合查询
121+
- **组合查询**: `(type:manager OR type:adapter) AND NOT module:core`
122+
- **嵌套查询**: `layer:business AND (type:manager OR type:query)`
123+
124+
### 查询示例
125+
```bash
126+
# 查找所有业务层的管理器文件
127+
query_files_by_tags({"query": "layer:business AND type:manager"})
128+
129+
# 查找非核心模块的所有文件
130+
query_files_by_tags({"query": "NOT module:core"})
131+
132+
# 查找管理器或适配器类型的文件
133+
query_files_by_tags({"query": "type:manager OR type:adapter"})
134+
135+
# 查找所有模块的文件(通配符)
136+
query_files_by_tags({"query": "module:*"})
137+
```
138+
95139
### 关联关系
96140

97141
```bash

0 commit comments

Comments
 (0)