@jokeran/frontend-code-skimmer 0.1.6 → 0.1.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +24 -17
- package/dist/index.js +94 -188
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -14,21 +14,21 @@ AI 代码助手的智能代码索引引擎，支持 **Vue 2 / Vue 3 / React Hook
|
|
|
14
14
|
|
|
15
15
|
## 13 个 MCP 工具
|
|
16
16
|
|
|
17
|
-
| 工具
|
|
18
|
-
|
|
|
19
|
-
| `skimmer_index_project`
|
|
20
|
-
| `skimmer_get_component_outline`
|
|
21
|
-
| `skimmer_find_symbol`
|
|
22
|
-
| `skimmer_get_code_slice`
|
|
23
|
-
| `skimmer_trace_assignments`
|
|
24
|
-
| `skimmer_trace_property_changes` | 对象属性修改追踪（轻量）
|
|
25
|
-
| `skimmer_find_by_behavior`
|
|
26
|
-
| `skimmer_trace_api_calls`
|
|
27
|
-
| `skimmer_get_call_graph`
|
|
28
|
-
| `skimmer_trace_key_flow`
|
|
29
|
-
| `skimmer_visualize_dataflow`
|
|
30
|
-
| `skimmer_get_blast_radius`
|
|
31
|
-
| `skimmer_get_project_overview`
|
|
17
|
+
| 工具 | 用途 |
|
|
18
|
+
| -------------------------------- | ---------------------------------- |
|
|
19
|
+
| `skimmer_index_project` | 初始化/更新代码索引 |
|
|
20
|
+
| `skimmer_get_component_outline` | ⭐ 获取文件骨架（极致 Token 节省） |
|
|
21
|
+
| `skimmer_find_symbol` | 智能符号搜索（支持拼写错误） |
|
|
22
|
+
| `skimmer_get_code_slice` | 精准代码切片（只取一个函数） |
|
|
23
|
+
| `skimmer_trace_assignments` | 变量赋值链路追踪（轻量） |
|
|
24
|
+
| `skimmer_trace_property_changes` | 对象属性修改追踪（轻量） |
|
|
25
|
+
| `skimmer_find_by_behavior` | ⭐ 按行为标签搜索（绕过命名问题） |
|
|
26
|
+
| `skimmer_trace_api_calls` | 网络 API 调用追踪 |
|
|
27
|
+
| `skimmer_get_call_graph` | 函数调用关系图谱 |
|
|
28
|
+
| `skimmer_trace_key_flow` | ⭐ 单工具 key 链路追踪 |
|
|
29
|
+
| `skimmer_visualize_dataflow` | 赋值+调用+落点合并视图 |
|
|
30
|
+
| `skimmer_get_blast_radius` | 修改影响范围评估 |
|
|
31
|
+
| `skimmer_get_project_overview` | 项目整体概览 |
|
|
32
32
|
|
|
33
33
|
## 安装
|
|
34
34
|
|
|
@@ -60,6 +60,8 @@ npm run build
|
|
|
60
60
|
### 多项目工作流
|
|
61
61
|
|
|
62
62
|
```
|
|
63
|
+
利用pwd命令获取当前项目路径替换"/work/project-a"
|
|
64
|
+
|
|
63
65
|
项目 A: skimmer_index_project({ project_path: "/work/project-a" })
|
|
64
66
|
项目 B: skimmer_index_project({ project_path: "/work/project-b" })
|
|
65
67
|
|
|
@@ -73,12 +75,15 @@ npm run build
|
|
|
73
75
|
|
|
74
76
|
→ 省略 project_path 时，自动使用上次操作的项目：
|
|
75
77
|
skimmer_find_symbol({ query: "handleSubmit" }) ← 自动用项目 B
|
|
78
|
+
|
|
79
|
+
→ 强制全量重建索引（遇到意外异常或想重走流程时）
|
|
80
|
+
skimmer_index_project({ project_path: "/work/project-a", force: true })
|
|
76
81
|
```
|
|
77
82
|
|
|
78
83
|
### 数据库存放位置
|
|
79
84
|
|
|
80
|
-
| 情况 | 数据库位置
|
|
81
|
-
| ------------ |
|
|
85
|
+
| 情况 | 数据库位置 |
|
|
86
|
+
| ------------ | ------------------------------------------------ |
|
|
82
87
|
| 项目目录可写 | `<项目根>/.frontend-code-skimmer-index.db` |
|
|
83
88
|
| 项目只读 | `~/.frontend-code-skimmer/databases/<项目名>.db` |
|
|
84
89
|
|
|
@@ -140,6 +145,7 @@ skimmer_trace_property_changes({ object: "params", property: "receiveAdr", file_
|
|
|
140
145
|
```
|
|
141
146
|
|
|
142
147
|
说明：
|
|
148
|
+
|
|
143
149
|
- `skimmer_trace_assignments` 已升级为 **AST 优先**（正则兜底），可更稳定识别 `this.xxx = ...`、`obj[prop] = ...` 等赋值。
|
|
144
150
|
|
|
145
151
|
### 7. 追踪接口调用
|
|
@@ -149,6 +155,7 @@ skimmer_trace_api_calls({ file_path: "src/views/apply/index.vue", keyword: "/que
|
|
|
149
155
|
```
|
|
150
156
|
|
|
151
157
|
说明：
|
|
158
|
+
|
|
152
159
|
- 支持识别封装网络调用（如 `this.aksCommonHandle(...)`、`xxxApi.request(...)`）并归类为 `network`。
|
|
153
160
|
|
|
154
161
|
### 8. 数据流总览（轻量）
|