@jokeran/frontend-code-skimmer 0.1.7 → 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.
Files changed (2) hide show
  1. package/README.md +24 -17
  2. 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` | ⭐ 获取文件骨架(极致 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` | 项目整体概览 |
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. 数据流总览(轻量)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jokeran/frontend-code-skimmer",
3
- "version": "0.1.7",
3
+ "version": "0.1.9",
4
4
  "description": "Frontend-Code-Skimmer: 不读全文,只看骨架;不搜字符,搜语义关联。支持 Vue2/Vue3/React Hooks",
5
5
  "publishConfig": {
6
6
  "registry": "https://registry.npmjs.org/",