Deploy IntelliJ IDEA plugins to the JetBrains Marketplace and remote servers. Used for publishing plugins, updating versions, deploying site documentation, and managing plugin releases. Supports version management, automated deployment workflows, and documentation generation.
本 Skill 提供将 IntelliJ IDEA 插件部署到 JetBrains Marketplace 和远程服务器的指导。涵盖版本管理、自动化部署工作流、文档生成和服务器部署。
在以下场景使用本 Skill:
deploy.sh - 统一部署脚本位置: 项目根目录
用途: 发布和部署插件的主脚本。
用法:
# 部署插件并更新版本
./deploy.sh <plugin-name> -v <version>
# 仅执行特定操作
./deploy.sh <plugin-name> -p # 仅发布到市场
./deploy.sh <plugin-name> -z # 仅上传 ZIP
./deploy.sh <plugin-name> -d # 仅部署站点目录
./deploy.sh <plugin-name> -n # 部署 Nginx 配置
# 全局操作(无需指定插件名称)
./deploy.sh -n # 部署全局 Nginx 配置
./deploy.sh -w # 部署 latest.html (What's New 页面)
支持的插件:
engine - intelli-ai-enginejavadoc - intelli-ai-javadocchangelog - intelli-ai-changelognacos - intelli-ai-nacostracer - intelli-ai-tracerswagger - intelli-ai-swaggerarchiver - archiver-manhelper - zks-dev-helper部署步骤 (未指定特定标志时):
-p): 执行 gradlew publishPlugin-z): 上传插件 ZIP 到远程服务器-d): 部署站点目录(落地页、文档等)远程服务器配置:
aliyun (SSH 别名)/var/www/zeka-idea-plugin/var/www/data/intelli-ai-plugin/etc/nginx/conf.dupdate-version.sh - 版本管理脚本位置: 项目根目录
用途: 更新所有白名单插件的版本。
用法:
# 将所有插件更新到指定版本
./update-version.sh 2025.3.1
更新内容:
每个插件目录中的 gradle.properties:
pluginVersionkitVersionengineVersion (如果存在)Nginx 配置 (ideaplugin.dong4j.site.conf):
白名单插件:
版本格式: x.y.z 或 x.y.z.w (例如: 2025.3.1)
generate-whatsnew.sh - What's New 页面生成器位置: 项目根目录
用途: 从所有插件的更新日志生成聚合的 What's New 页面。
用法:
# 生成 latest.html
./generate-whatsnew.sh
功能:
includes/pluginChanges.html 文件plugin.xml)plugin.xml 提取插件名称latest.htmlintelli-ai-engine/src/main/resources/whatsnew/latest.htmlInternalWhatsNewProvider.java 的版本映射输出文件:
latest.html (项目根目录) - 聚合更新日志页面intelli-ai-engine/src/main/resources/whatsnew/latest.html - 用于 IDE 显示的副本intelli-ai-engine/src/main/resources/whatsnew/{version}.html - 版本特定的更新日志允许的插件 (按顺序):
generate-docs-list.sh - 文档清单生成器位置: 项目根目录
用途: 从文档目录中的 Markdown 文件生成 docs-list.json。
用法:
# 为插件生成 docs-list.json
./generate-docs-list.sh <docs-dir>
# 示例:
./generate-docs-list.sh intelli-ai-engine/site/docs
功能:
.md 文件docs-list.jsonname 和 path 字段的 JSON 数组输出格式:
[
{
"name": "quick-start",
"path": "./docs/quick-start.md"
},
{
"name": "user-guide",
"path": "./docs/user-guide.md"
}
]
Makefile - 构建和部署快捷操作位置: 项目根目录
用途: 为常见的构建和部署操作提供便捷快捷方式。
常用命令:
# 构建操作
make build-engine # 构建 engine 插件
make build-javadoc # 构建 javadoc 插件
make quick-build # 构建所有插件(并行)
# 清理操作
make clean-engine # 清理 engine 插件
make quick-clean # 清理所有插件(并行)
# 部署操作
make deploy-engine # 部署 engine 插件
make deploy-javadoc # 部署 javadoc 插件
make quick-deploy # 部署子插件(并行)
# 版本管理
make version # 显示所有插件版本
# 本地安装
make copy-zips # 构建并复制 ZIP 到 Downloads
make install-plugins # 安装插件到本地 IDEA
make copy-install-upload # 复制、安装并上传到服务器
插件目录:
idea-plugin-kit - 共享工具库intelli-ai-engine - AI 引擎插件intelli-ai-javadoc - Javadoc 生成插件intelli-ai-changelog - 更新日志插件intelli-ai-nacos - Nacos 集成插件intelli-ai-tracer - 追踪插件# 1. 更新所有插件版本
./update-version.sh 2025.3.1
# 2. 生成 What's New 页面
./generate-whatsnew.sh
# 3. 部署 What's New 页面
./deploy.sh -w
# 4. 部署每个插件(可并行执行)
./deploy.sh engine -v 2025.3.1
./deploy.sh javadoc -v 2025.3.1
./deploy.sh changelog -v 2025.3.1
./deploy.sh nacos -v 2025.3.1
./deploy.sh tracer -v 2025.3.1
# 5. 部署 Nginx 配置(如需要)
./deploy.sh -n
# 1. 生成文档清单
./generate-docs-list.sh intelli-ai-javadoc/site/docs
# 2. 仅部署站点目录
./deploy.sh javadoc -d
# 1. 更新版本
./update-version.sh 2025.3.1
# 2. 仅发布到市场
./deploy.sh engine -p
# 使用 Makefile 进行并行操作
make quick-build # 并行构建所有插件
make quick-deploy # 并行部署子插件
插件 ID: 29152
部署:
# 完整部署并更新版本
./deploy.sh engine -v 2025.3.1
# 仅市场发布
./deploy.sh engine -p
# 仅站点部署
./deploy.sh engine -d
重要: Engine 插件必须首先部署,因为其他插件依赖它。
插件 ID: 28835
部署:
./deploy.sh javadoc -v 2025.3.1
插件 ID: 29154
部署:
./deploy.sh changelog -v 2025.3.1
插件 ID: 29156
部署:
./deploy.sh nacos -v 2025.3.1
插件 ID: 29155
部署:
./deploy.sh tracer -v 2025.3.1
aliyun/var/www/zeka-idea-plugin/var/www/data/intelli-ai-plugin/etc/nginx/conf.d/var/www/zeka-idea-plugin/
├── intelli-ai-engine/
│ ├── site/ # 站点目录(如果存在)
│ │ ├── landing.html
│ │ ├── docs.html
│ │ └── docs/
│ └── intelli-ai-engine.zip
├── intelli-ai-javadoc/
│ └── ...
└── ...
/var/www/data/intelli-ai-plugin/
├── intelli-ai-engine.zip
├── intelli-ai-javadoc.zip
└── ...
全局配置: ideaplugin.dong4j.site.conf
部署:
# 部署全局 Nginx 配置
./deploy.sh -n
功能:
/etc/nginx/conf.d/nginx -t)systemctl restart nginx)deploy.sh - 主部署脚本update-version.sh - 版本更新脚本generate-whatsnew.sh - What's New 生成器generate-docs-list.sh - 文档清单生成器Makefile - 构建快捷方式DEPLOY.md - 部署文档ideaplugin.dong4j.site.conf - Nginx 配置download.dong4j.site.conf - 下载服务器 Nginx 配置latest.html - 生成的 What's New 页面buy-me-a-coffee.html - 捐赠页面每个插件目录包含:
includes/pluginChanges.html - 更新日志文件site/ - 站点目录(可选)
landing-v2.html - 落地页docs.html - 文档索引docs/ - 文档 Markdown 文件build/distributions/ - 构建产物(ZIP 文件)gradle.properties - 插件配置(版本等)始终先更新版本:
./update-version.sh 2025.3.1
验证版本更新:
make version
使用语义化版本: x.y.z 或 x.y.z.w
部署站点前生成文档清单:
./generate-docs-list.sh <plugin>/site/docs
重大发布前更新 What's New:
./generate-whatsnew.sh
./deploy.sh -w
部署前检查构建产物:
ls -la <plugin>/build/distributions/*.zip
验证站点目录存在:
ls -la <plugin>/site/landing-v2.html
重载前测试 Nginx 配置:
ssh aliyun "nginx -t"
问题: gradlew buildPlugin 失败
解决方案:
问题: rsync 或 ssh 连接失败
解决方案:
aliyun 已配置ssh aliyun "ls -la /var/www/zeka-idea-plugin"问题: 版本未在所有文件中更新
解决方案:
gradle.properties 存在pluginVersion, kitVersion, engineVersion)问题: Nginx 重载失败
解决方案:
ssh aliyun "nginx -t"ssh aliyun "tail -f /var/log/nginx/error.log"DEPLOY.mdidea-plugin-dev skillintelli-ai-javadoc/, intelli-ai-changelog/# 1. 更新所有版本
./update-version.sh 2025.3.2
# 2. 生成 What's New
./generate-whatsnew.sh
# 3. 部署 What's New 页面
./deploy.sh -w
# 4. 部署所有插件
./deploy.sh engine -v 2025.3.2
./deploy.sh javadoc -v 2025.3.2
./deploy.sh changelog -v 2025.3.2
./deploy.sh nacos -v 2025.3.2
./deploy.sh tracer -v 2025.3.2
# 5. 部署 Nginx 配置
./deploy.sh -n
# 更新 javadoc 插件的文档
./generate-docs-list.sh intelli-ai-javadoc/site/docs
./deploy.sh javadoc -d
# 发布到市场而不部署站点
./update-version.sh 2025.3.2
./deploy.sh engine -p
./deploy.sh javadoc -p
Search for places (restaurants, cafes, etc.) via Google Places API proxy on localhost.
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Start voice calls via the OpenClaw voice-call plugin.
Notion API for creating and managing pages, databases, and blocks.
Gemini CLI for one-shot Q&A, summaries, and generation.
Category:developer