@@ -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# 获取所有标签
7280get_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