@ia-ccun/idea-plugin-share 0.0.1

package/README.md

@@ -0,0 +1,98 @@
+# idea-plugin-share
+
+内网 IntelliJ IDEA 插件分发工具 —— 用 npm 包当"容器"，把 `.zip` 装进 `plugins/` 目录发布到 npm registry，内网同事 `npm i` 即可拿到。
+
+## 工作原理
+
+```
+外网开发 → 把插件 zip 放进 plugins/ → npm publish → 内网 npm i → postinstall 自动复制到本地目录 → IDEA 从磁盘安装
+```
+
+## 使用方式（发布者）
+
+### 1. 准备插件
+
+把 IDEA 插件的 `.zip` 文件放进 `plugins/` 目录：
+
+```bash
+plugins/
+├── my-awesome-plugin-1.0.0.zip
+└── another-tool-2.3.1.zip
+```
+
+### 2. 修改 package.json
+
+把 `name` 改成你自己的 scope：
+
+```json
+{
+  "name": "@your-scope/idea-plugin-share",
+  "version": "1.0.1"
+}
+```
+
+### 3. 发布
+
+```bash
+npm login
+npm publish --access public
+```
+
+## 使用方式（内网用户）
+
+```bash
+# 安装
+npm install @your-scope/idea-plugin-share -g
+
+# 查看本地存放路径
+idea-plugin path
+
+# 打开目录（macOS/Win/Linux）
+idea-plugin open
+```
+
+或一次性：
+
+```bash
+npx @your-scope/idea-plugin-share install
+```
+
+## 目录约定
+
+| 位置 | 说明 |
+|------|------|
+| `plugins/` | 源目录：放要分发的 `.zip` |
+| `~/idea-plugins/` | 默认本地目标目录（可用 `IDEA_PLUGIN_DIR` 覆盖） |
+
+## IDEA 安装步骤
+
+1. `idea-plugin open` 打开目标目录
+2. IDEA → **Settings → Plugins → ⚙ → Install Plugin from Disk**
+3. 选择目标目录里的 `.zip`
+4. 重启 IDEA
+
+## 命令
+
+```bash
+idea-plugin install   # 复制 zip 到本地（npm install 自动触发）
+idea-plugin list     # 列出本包所有插件
+idea-plugin path     # 打印本地目标目录
+idea-plugin open     # 打开本地目标目录
+idea-plugin help     # 帮助
+```
+
+## 更新插件
+
+1. 更新 `package.json` 的 `version`（如 `1.0.0` → `1.0.1`）
+2. 替换 `plugins/` 里的 zip
+3. `npm publish`
+
+内网用户重新 `npm i` 即可。
+
+## 零依赖
+
+只用 Node.js 内置模块，无需任何第三方依赖。Node >= 14。
+
+## License
+
+MIT

package/bin/idea-plugin.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+// 极简 CLI：纯 Node.js 内置模块，零依赖
+// - 把本包 plugins/ 下的 IDEA 插件 zip 复制到本地目标目录
+// - 内网用户执行 `npm install @your-scope/idea-plugin-share` 即可拿到
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync } = require('child_process');
+
+const PKG_ROOT = path.resolve(__dirname, '..');
+const SRC_DIR = path.join(PKG_ROOT, 'plugins');
+const TARGET_DIR = process.env.IDEA_PLUGIN_DIR || path.join(os.homedir(), 'idea-plugins');
+
+const COLOR = {
+  reset: '\x1b[0m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+  dim: '\x1b[2m',
+  red: '\x1b[31m',
+};
+
+const log = {
+  ok: (m) => console.log(`${COLOR.green}✓${COLOR.reset} ${m}`),
+  info: (m) => console.log(`${COLOR.cyan}ℹ${COLOR.reset} ${m}`),
+  warn: (m) => console.log(`${COLOR.yellow}⚠${COLOR.reset} ${m}`),
+  err: (m) => console.log(`${COLOR.red}✗${COLOR.reset} ${m}`),
+};
+
+function findZips(dir) {
+  if (!fs.existsSync(dir)) return [];
+  return fs.readdirSync(dir).filter((f) => f.toLowerCase().endsWith('.zip'));
+}
+
+function humanSize(bytes) {
+  const units = ['B', 'KB', 'MB', 'GB'];
+  let i = 0;
+  let n = bytes;
+  while (n >= 1024 && i < units.length - 1) {
+    n /= 1024;
+    i++;
+  }
+  return `${n.toFixed(n >= 10 || i === 0 ? 0 : 1)} ${units[i]}`;
+}
+
+function cmdInstall() {
+  const zips = findZips(SRC_DIR);
+  if (zips.length === 0) {
+    log.warn(`未在 ${SRC_DIR} 找到任何 .zip 文件`);
+    log.info('请把你的 IDEA 插件 zip 放进 plugins/ 目录后重新发布');
+    return;
+  }
+
+  fs.mkdirSync(TARGET_DIR, { recursive: true });
+
+  log.info(`源目录: ${SRC_DIR}`);
+  log.info(`目标目录: ${TARGET_DIR}`);
+  console.log();
+
+  for (const file of zips) {
+    const src = path.join(SRC_DIR, file);
+    const dst = path.join(TARGET_DIR, file);
+    const size = fs.statSync(src).size;
+    fs.copyFileSync(src, dst);
+    log.ok(`${file}  ${COLOR.dim}(${humanSize(size)})${COLOR.reset}  →  ${dst}`);
+  }
+
+  console.log();
+  log.info('下一步：在 IDEA 中  Settings → Plugins → ⚙ → Install Plugin from Disk');
+  log.info(`选择 ${TARGET_DIR} 下的 zip 文件安装`);
+}
+
+function cmdList() {
+  const zips = findZips(SRC_DIR);
+  if (zips.length === 0) {
+    log.warn('本包 plugins/ 目录为空');
+    return;
+  }
+  console.log(`${COLOR.cyan}本包包含的 IDEA 插件：${COLOR.reset}`);
+  for (const file of zips) {
+    const full = path.join(SRC_DIR, file);
+    const size = fs.statSync(full).size;
+    console.log(`  • ${file}  ${COLOR.dim}(${humanSize(size)})${COLOR.reset}`);
+  }
+}
+
+function cmdPath() {
+  console.log(TARGET_DIR);
+}
+
+function cmdOpen() {
+  if (!fs.existsSync(TARGET_DIR)) {
+    fs.mkdirSync(TARGET_DIR, { recursive: true });
+  }
+  const cmd =
+    process.platform === 'darwin'
+      ? `open "${TARGET_DIR}"`
+      : process.platform === 'win32'
+      ? `explorer "${TARGET_DIR}"`
+      : `xdg-open "${TARGET_DIR}"`;
+  try {
+    execSync(cmd, { stdio: 'ignore' });
+  } catch (e) {
+    log.err(`无法打开目录: ${e.message}`);
+    log.info(`手动打开: ${TARGET_DIR}`);
+  }
+}
+
+function cmdHelp() {
+  console.log(`${COLOR.cyan}idea-plugin${COLOR.reset} - 内网 IDEA 插件分发工具
+
+用法:
+  idea-plugin install   从本包 plugins/ 复制 zip 到本地目录（npm install 自动触发）
+  idea-plugin list     列出本包包含的插件
+  idea-plugin path     打印本地目标目录
+  idea-plugin open     打开本地目标目录
+  idea-plugin help     查看帮助
+
+环境变量:
+  IDEA_PLUGIN_DIR      覆盖默认目标目录（默认: ~/idea-plugins）
+`);
+}
+
+const commands = {
+  install: cmdInstall,
+  list: cmdList,
+  ls: cmdList,
+  path: cmdPath,
+  open: cmdOpen,
+  help: cmdHelp,
+  '--help': cmdHelp,
+  '-h': cmdHelp,
+};
+
+const cmd = process.argv[2] || 'help';
+const fn = commands[cmd];
+if (!fn) {
+  log.err(`未知命令: ${cmd}`);
+  cmdHelp();
+  process.exit(1);
+}
+fn();

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@ia-ccun/idea-plugin-share",
+  "version": "0.0.1",
+  "description": "IntelliJ IDEA 插件分发包：把 zip 放进 plugins/ 目录，npm publish 后内网 npm i 即可获取",
+  "bin": {
+    "idea-plugin": "bin/idea-plugin.js"
+  },
+  "scripts": {
+    "postinstall": "node bin/idea-plugin.js install",
+    "demo": "node examples/demo.js",
+    "list": "node bin/idea-plugin.js list"
+  },
+  "keywords": [
+    "idea",
+
+
+    "intellij",
+    "plugin",
+    "jetbrains",
+    "distribute",
+    "intranet"
+  ],
+  "engines": {
+    "node": ">=14"
+  },
+  "files": [
+    "plugins/**/*",
+    "bin/**/*",
+    "README.md"
+  ],
+  "license": "MIT"
+}