# idea-claude-plugin

**Repository Path**: wagio_admin/idea-claude-plugin

## Basic Information

- **Project Name**: idea-claude-plugin
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-08
- **Last Updated**: 2026-01-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# idea-claude-plugin 项目说明

## 插件功能
这是一个 IntelliJ IDEA 插件项目，主要功能是为开发者提供便捷的文件路径复制功能，特别适用于与 Claude AI 交互时的文件路径引用。

### 使用实例

**场景1：向 Claude 询问某个文件的问题**
1. 在 IDEA 项目视图中找到 `src/main/java/com/example/UserService.java`
2. 右键点击文件 → 选择"复制Claude路径"
3. 文件路径会自动复制到剪贴板：`@src\main\java\com\example\UserService.java`
 

**场景2：询问特定代码段**
1. 在编辑器中打开 `UserController.java` 选中第15-25行的代码块
2. 右键 → "复制Claude路径"
3. 文件路径会自动复制到剪贴板：`@src\main\java\com\example\UserController.java 15行到25行`

 

## 打包与常用命令（Windows/PowerShell）
- 清理并打包插件：
  - `.\gradlew.bat clean buildPlugin`
- 发布到 JetBrains Marketplace（可选，需配置 Token）：
  - `.\gradlew.bat publishPlugin`
 

### 打包产物位置
- 成功执行 `buildPlugin` 后，插件包位于：
  - `build\distributions\idea-claude-plugin-<version>.zip`

## 项目结构与文件说明
项目根目录结构：

```text
idea-claude-plugin/
├── .gitignore                      # Git 忽略规则
├── README.md                       # 项目说明文档
├── build.gradle.kts                # 项目主构建脚本
├── gradle.properties               # Gradle 属性与密钥配置
├── gradlew                         # Wrapper 启动脚本（Unix/macOS）
├── gradlew.bat                     # Wrapper 启动脚本（Windows）
├── settings.gradle.kts             # Gradle 项目设置
└── src/
    └── main/
        ├── java/                   # 插件 Java 源码
        │   └── com/wagio/claudepath/
        │       └── CopyClaudePathAction.java  # 复制Claude路径动作类
        └── resources/              # 插件资源文件（如图标、文档）
            └── META-INF/
                └── plugin.xml      # 插件描述文件（ID、名称、兼容版本、Action注册等）
```

构建生成目录（执行构建后出现）：

```text
build/
├── distributions/                  # 执行 `buildPlugin` 生成的插件 .zip
└── tmp/                            # 构建临时文件

.gradle/                            # Gradle 本地缓存与元数据（自动生成）
```

说明：
- `src/main/resources` 中如存在 `META-INF/plugin.xml`，则为插件描述文件（ID、名称、兼容版本、Action/Listener 注册等）。

## 开发提示
- 修改插件元信息与 Action 注册请在 `src/main/resources/META-INF/plugin.xml`。
- 建议使用 `.
  \gradlew.bat` 执行所有构建/打包任务，避免环境差异。
- 若仅需生成普通 `jar`，可使用 `assemble`，但发布 IntelliJ 插件请使用 `buildPlugin` 生成 `.zip`。
- 不建议使用 Maven 构建 IntelliJ 插件（官方生态以 Gradle 为主，相关任务与工具链更完善）。

## 常见问题
- 打包后找不到产物？
  - 确认执行了 `buildPlugin`；产物在 `build\distributions\*.zip`。
- 验证/签名/发布失败？
  - 检查 `gradle.properties` 中的密钥/Token 配置是否完整；查看任务输出日志定位问题。