修复跳转

Author: cyz-home

.cursor/rules/code-completion.mdc

@@ -1,13 +1,13 @@
 ---
-globs: *Completion*.kt,*CompletionContributor*.kt,*CompletionProvider*.kt
+globs: *Completion*.java,*CompletionContributor*.java,*CompletionProvider*.java
 description: 代码提示和自动补全开发规范
 ---
 
 # 代码提示开发规范
 
 ## 代码补全实现
 
-- 基于 LSP 的代码补全功能
+- 基于本地 Java 实现的代码补全功能
 - 实现自定义补全提供者
 - 支持智能提示和上下文感知
 - 提供补全项排序和过滤

.cursor/rules/code-navigation.mdc

@@ -1,5 +1,5 @@
 ---
-globs: *Navigation*.kt,*GoTo*.kt,*Reference*.kt,*Symbol*.kt
+globs: *Navigation*.java,*GoTo*.java,*Reference*.java,*Symbol*.java
 description: 代码跳转和导航功能开发规范
 ---
 
@@ -20,11 +20,11 @@ description: 代码跳转和导航功能开发规范
 - 导入声明跳转
 - 重写方法跳转
 
-## LSP 集成
+## 本地实现
 
-- 使用 LSP 的跳转功能
-- 处理 LSP 跳转请求
-- 支持多文件跳转
+- 使用 IntelliJ Platform 的 PSI API
+- 实现自定义跳转处理器
+- 支持跨文件跳转
 - 提供跳转预览
 
 ## 性能优化
@@ -46,4 +46,4 @@ description: 代码跳转和导航功能开发规范
 - 处理跳转目标不存在
 - 提供跳转失败降级
 - 记录跳转性能指标
-- 优雅处理 LSP 错误
+- 优雅处理 PSI 错误

.cursor/rules/intellij-plugin-structure.mdc

@@ -7,25 +7,24 @@ description: IntelliJ IDEA 插件项目结构和开发规范
 
 ## 项目概述
 
-开发一个支持 DIY 语言的 IntelliJ IDEA 插件，集成外部 LSP 服务器提供代码高亮、代码提示、代码跳转等功能。
+开发一个支持 DIY 语言的 IntelliJ IDEA 插件，使用本地 Java 实现提供代码高亮、代码提示、代码跳转等功能。
 
 ## 技术栈
 
-- **开发语言**: Kotlin (优先) 或 Java
+- **开发语言**: Java (已从 Kotlin 重构)
 - **构建工具**: Gradle
 - **IntelliJ Platform SDK**: 最新稳定版本
-- **LSP 集成**: IntelliJ LSP API
-- **语言服务器**: `/Users/lvluo/Desktop/github.com/php-any/origami/bin/zy-lsp`
+- **实现方式**: 本地 Java 实现，无外部依赖
+- **参考项目**: [Haehnchen/idea-php-laravel-plugin](https://github.com/Haehnchen/idea-php-laravel-plugin)
 
 ## 项目结构规范
 
 ```
 src/
 ├── main/
-│   ├── kotlin/
+│   ├── java/
 │   │   └── com/company/plugin/
 │   │       ├── language/          # 语言相关功能
-│   │       ├── lsp/              # LSP 客户端集成
 │   │       ├── completion/       # 代码提示
 │   │       ├── navigation/       # 代码跳转
 │   │       └── highlighting/     # 语法高亮
@@ -35,17 +34,17 @@ src/
 │       ├── icons/               # 图标资源
 │       └── fileTypes/           # 文件类型定义
 └── test/
-    └── kotlin/
+    └── java/
 ```
 
 ## 开发原则
 
-- 优先使用 Kotlin 而非 Java
+- 使用 Java 作为主要开发语言
 - 遵循 IntelliJ Platform 编码规范
 - 使用有意义的命名，避免缩写
-- 添加适当的中文 KDoc 注释
+- 添加适当的中文注释
 - 遵循 SOLID 原则和 Clean Architecture
 - 异步处理耗时操作
-- 优雅处理 LSP 连接失败
+- 本地实现所有功能，无外部依赖
 - **禁止使用临时跳过逻辑，必须完整实现所有功能**
 - **禁止删除本地缓存，避免重复下载依赖**

.cursor/rules/lsp-integration.mdc

@@ -1,10 +1,13 @@
 ---
 globs: *.kt,*Lsp*.kt,*lsp*.kt
 description: LSP 集成和语言服务器连接规范
+deprecated: true
 ---
 
 # LSP 集成开发规范
 
+> ⚠️ **已弃用**: 此规则已过时，项目已重构为本地 Java 实现，不再使用 LSP 集成
+
 ## LSP 服务器配置
 
 - **服务器路径**: `/Users/lvluo/Desktop/github.com/php-any/origami/bin/zy-lsp`

.cursor/rules/syntax-highlighting.mdc

@@ -1,5 +1,5 @@
 ---
-globs: *Highlighting*.kt,*Syntax*.kt,*Lexer*.kt,*Parser*.kt
+globs: *Highlighting*.java,*Syntax*.java,*Lexer*.java,*Parser*.java
 description: 语法高亮和词法分析器开发规范
 ---
 

.cursor/rules/testing.mdc

@@ -1,5 +1,5 @@
 ---
-globs: *Test*.kt,*test*.kt
+globs: *Test*.java,*test*.java
 description: 测试开发规范和最佳实践
 ---
 
@@ -9,13 +9,13 @@ description: 测试开发规范和最佳实践
 
 - 使用 IntelliJ Platform 测试框架
 - 编写单元测试和集成测试
-- 使用 MockK 进行 Kotlin 代码模拟
+- 使用 Mockito / JUnit 进行 Java 代码模拟
 - 实现端到端测试
 
 ## 测试覆盖
 
 - 为每个功能模块编写测试
-- 测试 LSP 连接和通信
+- （已移除）LSP 连接和通信相关测试
 - 测试语法高亮功能
 - 测试代码提示和跳转
 

.cursor/rules/zy-file-support.mdc

@@ -22,16 +22,16 @@ description: .zy 文件语法高亮和语法提示支持
 
 ## 语法提示功能
 
-- 基于 LSP 的语法提示
+- 基于本地 Java 的语法提示
 - 支持关键字补全
 - 提供变量和函数提示
 - 实现上下文感知的智能提示
 
-## LSP 集成
+## 本地实现
 
-- 连接 LSP 服务器: `/Users/lvluo/Desktop/github.com/php-any/origami/bin/zy-lsp`
-- 支持 .zy 文件的 LSP 功能
-- 处理 LSP 连接和通信
+- 使用 IntelliJ PSI 和索引 API
+- 本地解析和索引 `.zy` 文件
+- 无外部依赖，离线可用
 - 提供错误恢复机制
 
 ## 性能要求

.cursor/rules/zy-lsp-client.mdc

@@ -1,10 +1,13 @@
 ---
 globs: *ZyLsp*.kt,*zyLsp*.kt,*Lsp*.kt
 description: .zy 文件 LSP 客户端集成规范
+deprecated: true
 ---
 
 # .zy 文件 LSP 客户端集成
 
+> ⚠️ **已弃用**: 此规则已过时，项目已重构为本地 Java 实现，不再使用 LSP 客户端
+
 ## LSP 服务器配置
 
 - **服务器路径**: `/Users/lvluo/Desktop/github.com/php-any/origami/bin/zy-lsp`

build.gradle.kts

@@ -1,5 +1,5 @@
 plugins {
-    id("org.jetbrains.kotlin.jvm") version "1.9.10"
+    id("java")
     id("org.jetbrains.intellij") version "1.17.4"
 }
 
@@ -11,17 +11,21 @@ repositories {
 }
 
 dependencies {
-    implementation("org.eclipse.lsp4j:org.eclipse.lsp4j:0.21.1")
+    // 移除 LSP 依赖，使用本地 Java 实现
+    testImplementation("org.junit.jupiter:junit-jupiter:5.10.2")
 }
 
 intellij {
     // 使用本地已安装的 IntelliJ IDEA，避免远程下载
     localPath.set("/Applications/IntelliJ IDEA.app/Contents")
-    type.set("IC")
+    // type.set("IC")
     downloadSources.set(false)
     plugins.set(listOf("com.intellij.java"))
     // 不自动写入 since/until 到 plugin.xml，由我们手动控制
     updateSinceUntilBuild.set(false)
+    // 添加配置以解决Gradle兼容性问题
+    pluginName.set("zy-language-support")
+    // version.set("2024.1.3")
 }
 
 tasks {
@@ -32,11 +36,22 @@ tasks {
         sourceCompatibility = "17"
         targetCompatibility = "17"
     }
-    withType<org.jetbrains.kotlin.gradle.tasks.KotlinCompile> {
-        kotlinOptions.jvmTarget = "17"
+
+    test {
+        useJUnitPlatform()
     }
 
     patchPluginXml {
         sinceBuild.set("241")
+        untilBuild.set("241.*")
     }
-}
+    
+    runIde {
+        // 添加JVM参数以解决兼容性问题，包含调试支持
+        jvmArgs = listOf(
+            "-Djava.awt.headless=false",
+            "-XX:MaxJavaStackTraceDepth=10000",
+            "-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005"
+        )
+    }
+}

docs/development_guide.md

@@ -0,0 +1,96 @@
+### ZY 语言插件开发/修改指南
+
+#### 技术栈与约束
+
+- **语言**: Java（禁止 Kotlin、外部 LSP）
+- **平台**: IntelliJ Platform SDK（优先使用本地 IDEA 路径）
+- **注释**: 所有类/方法/复杂逻辑/重要变量必须中文注释
+- **实现**: 禁止占位、临时跳过；功能需完整实现
+
+#### 项目结构
+
+- `src/main/java/com/company/plugin/`
+  - `language/`: `ZyLanguage`、`ZyFileType`、`ZyParserDefinition`
+  - `highlighting/`: `ZyLexer`、`ZySyntaxHighlighter`、`ZySyntaxHighlighterFactory`、`ZyTokenTypes`
+  - `navigation/`: 跳转与引用
+  - `completion/`: 补全
+- `src/main/resources/META-INF/plugin.xml`: 扩展点注册
+- `build.gradle.kts`: 构建配置
+
+#### 构建与运行
+
+- 构建: `./gradlew build --offline`
+- 清理: `./gradlew clean`
+- 沙箱运行: `./gradlew runIde`
+- 缓存保护: 不删除全局 Gradle/Maven/IDEA 缓存；仅清理项目 `build/`、`out/`
+
+#### 语法高亮与词法分析
+
+- 入口组件：
+  - 词法分析：`highlighting/ZyLexer`
+  - Token 类型：`highlighting/ZyTokenTypes`
+  - 高亮器：`highlighting/ZySyntaxHighlighter`
+  - 颜色键：`highlighting/ZySyntaxHighlighterFactory`
+- 关键字维护：
+  - 在 `ZyLexer` 的 `ZY_KEYWORDS` 中增删（已包含 `struct`）
+  - `getTokenTypeForText` 返回 `ZyTokenTypes.KEYWORD` → `ZySyntaxHighlighter` 映射至 `KEYWORD` 颜色
+- 新语法元素流程：
+  1. 在 `ZyLexer.advance()` 识别并返回新的 `ZyTokenTypes` 类型
+  2. 在 `ZyTokenTypes` 定义 `IElementType`
+  3. 在 `ZySyntaxHighlighter.getTokenHighlights` 做颜色映射
+  4. 在 `ZySyntaxHighlighterFactory` 定义默认 `TextAttributesKey`
+- 注意点：
+  - 字符串转义与闭合、注释块闭合、变量标识（如 `$`）要完整处理
+  - 空白应作为独立 token，保持 token 流连续
+
+#### 代码补全与导航
+
+- 补全：`completion/ZyCompletionContributor`
+  - 基于上下文/索引提供候选，保证非阻塞；正确处理 `ProcessCanceledException`
+- 跳转：`navigation/ZySimpleGotoDeclarationHandler`
+- 引用：`navigation/ZySimpleReferenceContributor`
+- 索引/作用域：`index/ZyScopeBasedParser` 可用于构建符号表，支持跨文件
+
+#### plugin.xml 配置
+
+- 注册：`fileType`、`syntaxHighlighterFactory`、`completion`、`gotoDeclarationHandler`、`referenceContributor` 等扩展点
+- 确保 `.zy` 文件类型关联与图标配置
+
+#### 性能与稳定性
+
+- 性能：
+  - 词法/高亮单次扫描，编辑区增量触发
+  - 对索引/作用域解析结果做缓存，变更时精准失效
+- 错误处理：
+  - 捕获并传播 `ProcessCanceledException`，避免吞异常
+  - 提供清晰日志与用户提示，不阻塞 UI 线程
+
+#### 测试建议
+
+- 单元测试：
+  - 词法切分、高亮映射
+  - 补全过滤/排序
+  - 跳转/引用解析
+- 集成测试：
+  - 打开 `.zy` 文件全链路（高亮、补全、跳转）
+- 查看报告：`build/reports/tests`
+
+#### 典型改动清单
+
+- 新增保留字：
+  1. `ZyLexer.ZY_KEYWORDS.add("keyword")`
+  2. 如需差异化配色：扩展 `ZyTokenTypes` 与颜色键
+- 扩展补全：
+  1. 在 `ZyCompletionContributor` 注入 `CompletionProvider`
+  2. 从索引/作用域读取符号，排序与去重
+
+#### 构建配置要点
+
+- 使用 Java 插件与固定 IntelliJ 平台版本
+- 配置本地 IDEA 路径、国内镜像与离线/缓存（见 `gradle.properties`）
+
+#### 发布与验证
+
+- 打包: `./gradlew build` 产出 `build/distributions/*.zip`
+- 本地安装: IDE 安装 zip 或 `runIde` 沙箱验证
+- 版本规范: 语义化版本，更新 `plugin.xml` 的兼容范围