PathMark 是一个专为 AI 而生的 JetBrains IntelliJ Platform 插件，用于快速复制项目内文件、文件夹或当前代码位置引用。

当你在项目树中选中文件或文件夹后，可以通过右键菜单点击 Copy AI Path，将目标相对项目根目录的路径复制到系统剪贴板。

当你在编辑器中选中代码后，也可以通过右键菜单点击 Copy AI Path，将当前文件相对项目根目录的路径和行号范围复制到系统剪贴板。

• 在项目树右键菜单中提供 Copy AI Path，支持复制单个文件或文件夹路径。
• 在编辑器右键菜单中提供 Copy AI Path，支持复制当前代码位置。

项目树中选中文件：

@frontend/index.html

多行选区：

@frontend/index.html#L9-12

单行选区或无选区时：

@frontend/src/main.ts#L8

首次运行建议使用项目内 Gradle Wrapper：

./gradlew test

如果本机默认 Gradle 缓存目录不可写，可以指定项目内缓存目录：

GRADLE_USER_HOME=.gradle-home ./gradlew test

在项目根目录执行：

./gradlew runIde

如果需要使用项目内 Gradle 缓存目录：

GRADLE_USER_HOME=.gradle-home ./gradlew runIde

运行后会启动一个测试用 IntelliJ IDEA 实例。在测试 IDE 中打开任意项目，进入项目树或编辑器右键菜单，即可看到 Copy AI Path。

执行：

./gradlew buildPlugin

构建产物位于：

build/distributions/

每次提交 Marketplace 前，使用以下命令重新构建并校验归档结构、配置与 IntelliJ IDEA 2026.1 的二进制兼容性：

GRADLE_USER_HOME=.gradle-home ./gradlew check buildPlugin verifyPluginProjectConfiguration verifyPluginStructure verifyPlugin
unzip -t build/distributions/PathMark-0.1.3.zip
shasum -a 256 build/distributions/PathMark-0.1.3.zip

上传时只能选择这次命令生成的 ZIP，并保留输出的 SHA-256，以便在 Marketplace 下载后进行比对。

1. 通过 ./gradlew runIde 启动测试 IDE。
2. 在测试 IDE 中打开一个项目。
3. 打开项目内任意普通文件，例如 frontend/index.html。
4. 选中第 9 行到第 12 行代码。
5. 右键点击 Copy AI Path。
6. 粘贴剪贴板内容，确认格式类似：

@frontend/index.html#L9-12

无选区时，将光标放在目标行，执行相同菜单操作，结果应为单行格式：

@frontend/index.html#L9

1. 通过 ./gradlew runIde 启动测试 IDE。
2. 在测试 IDE 中打开一个项目。
3. 在项目树中选中单个文件，例如 frontend/index.html。
4. 右键点击 Copy AI Path。
5. 粘贴剪贴板内容，确认格式类似：

@frontend/index.html