base_parts_ai 1.0.56 → 1.0.57

package/README.md

@@ -7,7 +7,7 @@
 npx base_parts_ai
 ```
 
-无参数时会让用户选择 `jcc`、`jcx`、`weds` 或 `ucx`，再继续执行对应配置流程。
+无参数时会让用户选择 `jcc`、`jcx`、`weds`、`ucx` 或 `jgrok`，再继续执行对应流程。
 
 也可以明确指定工具，适合脚本或需要带参数的场景：
 
@@ -16,6 +16,7 @@ npx base_parts_ai jcc
 npx base_parts_ai jcx
 npx base_parts_ai weds
 npx base_parts_ai ucx
+npx base_parts_ai jgrok
 npx base_parts_ai jcc setapi
 npx base_parts_ai jcx setapi
 npx base_parts_ai weds setapi
@@ -28,18 +29,21 @@ npx base_parts_ai --help
 npx base_parts_ai --version
 ```
 
-通过 `base_parts_ai` 入口执行时，会屏蔽 `base_parts_ai` 自身自动升级；`jcc`、`jcx`、`weds`、`ucx` 单独运行行为保持不变。
+通过 `base_parts_ai` 入口执行时，会屏蔽 `base_parts_ai` 自身自动升级；`jcc`、`jcx`、`weds`、`ucx`、`jgrok` 单独运行行为保持不变。
 
 全局安装后也可以直接运行：
 
 ```powershell
 ucx
+jgrok
 ```
 
 `ucx` 会扫描用户主目录下一层的 `~/.codex` 与 `~/.codex_*`。账号名优先用 `auth.json` 中非空 `OPENAI_API_KEY` 的脱敏短名，否则用 JWT email；不会自动创建空的 `~/.codex`。
 
+`jgrok` 若 `~/.grok/.env` 不存在则写入代理示例并打印绝对路径，请编辑后再运行。已存在则把该文件注入环境变量：本机没有 `grok` 时通过腾讯云 npm 源安装 `@xai-official/grok`（安装不注入环境变量），然后启动 `grok`，用户参数原样透传。
+
 ## 下载发布的包
-https://registry.npmjs.org/base_parts_ai/-/base_parts_ai-1.0.56.tgz
+https://registry.npmjs.org/base_parts_ai/-/base_parts_ai-1.0.57.tgz
 
 ## 然后放在jdwfiles目录下
 https://jdwfiles.oss-cn-hangzhou.aliyuncs.com/npm_pkg/base_parts_ai-1.0.34.tgz

package/bin/jgrok.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+
+'use strict';
+
+var os = require('os');
+var path = require('path');
+
+/**
+ * 构建 jgrok 运行配置，只解析主目录
+ * @returns {{ homeDir: string }}
+ */
+function getBuildCfg() {
+    var homeDir = process.env.JCC_TEST_HOME || os.homedir();
+    return { homeDir: homeDir };
+}
+
+/**
+ * 动态加载 lib 下的命令模块，便于本地开发时读取最新文件
+ * @param {string} libName lib 目录下的文件名（不含 .js）
+ * @returns {Function}
+ */
+function loadLib(libName) {
+    var libPath = path.resolve(__dirname, '../lib/' + libName + '.js');
+    delete require.cache[require.resolve(libPath)];
+    return require(libPath);
+}
+
+/**
+ * 运行 jgrok CLI，参数全部透传给 grok，可供命令行直接执行或被 base_parts_ai require 调用
+ * @param {Array<string>} args 用户参数，不包含 node 和脚本路径
+ * @returns {Promise<number>}
+ */
+async function runCli(args) {
+    var buildCfg = getBuildCfg();
+    return await loadLib('jgrok')(args || [], buildCfg);
+}
+
+if (require.main === module) {
+    runCli(process.argv.slice(2)).then(function (code) {
+        process.exit(typeof code === 'number' ? code : 0);
+    }).catch(function (err) {
+        console.error('jgrok 执行失败:', err.message);
+        process.exit(1);
+    });
+}
+
+module.exports = runCli;

package/bin/postinstall.js

@@ -17,5 +17,6 @@ console.log(c.cyan + '  ║  ' + c.yellow + '安装完成！输入以下命令
 console.log(c.cyan + '  ║    ' + c.green + 'jcc' + c.white + '  配置或安装 ClaudeCode' + c.reset);
 console.log(c.cyan + '  ║    ' + c.green + 'weds' + c.white + ' 配置或安装 weds ClaudeCode' + c.reset);
 console.log(c.cyan + '  ║    ' + c.green + 'ucx' + c.white + '  切换 Codex 账号' + c.reset);
+console.log(c.cyan + '  ║    ' + c.green + 'jgrok' + c.white + ' 带代理环境启动 grok' + c.reset);
 console.log(c.cyan + '  ╚══════════════════════════════════════════╝' + c.reset);
 console.log('');

package/lib/ai_utils.js

@@ -51,7 +51,7 @@ async function fetchRemoteText(url, timeoutMs) {
 
 /**
  * 从当前入口文件名推断正在运行的 CLI 命令名
- * @returns {string} jcc、jcx、weds、ucx 或空字符串
+ * @returns {string} jcc、jcx、weds、ucx、jgrok 或空字符串
  */
 function getCurrentCliName() {
     var entryName = path.basename(process.argv[1] || '').toLowerCase();
@@ -59,6 +59,7 @@ function getCurrentCliName() {
     if (entryName === 'jcc' || entryName === 'jcc.js') return 'jcc';
     if (entryName === 'weds' || entryName === 'weds.js') return 'weds';
     if (entryName === 'ucx' || entryName === 'ucx.js') return 'ucx';
+    if (entryName === 'jgrok' || entryName === 'jgrok.js') return 'jgrok';
     return '';
 }
 

package/lib/jgrok.js

@@ -0,0 +1,202 @@
+'use strict';
+
+/**
+ * jgrok 命令：检测并安装 grok，注入 ~/.grok/.env 后启动官方 grok
+ * 首次创建 .env 只提示编辑，不启动 grok
+ */
+
+var fs = require('fs');
+var os = require('os');
+var path = require('path');
+var childProcess = require('child_process');
+
+/** ~/.grok/.env 自定义代理示例内容 */
+var GROK_ENV_DEMO = [
+    'HTTP_PROXY=http://127.0.0.1:11811',
+    'HTTPS_PROXY=http://127.0.0.1:11811',
+    'ALL_PROXY=http://127.0.0.1:11811',
+    'NO_PROXY=localhost,127.0.0.1,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16',
+    '',
+].join('\n');
+
+/** 缺失 grok 时走腾讯云 npm 源安装，不加 --force，安装时不注入环境变量 */
+var GROK_INSTALL_CMD = 'npm install -g @xai-official/grok --registry=https://mirrors.cloud.tencent.com/npm/';
+
+/**
+ * 解析用户主目录：优先 buildCfg.homeDir，再 JCC_TEST_HOME，最后 os.homedir()
+ * @param {object} [buildCfg] 入口传入的配置
+ * @returns {string}
+ */
+function getHomeDir(buildCfg) {
+    if (buildCfg && buildCfg.homeDir) {
+        return buildCfg.homeDir;
+    }
+    return process.env.JCC_TEST_HOME || os.homedir();
+}
+
+/**
+ * 获取 ~/.grok 目录路径
+ * @param {string} homeDir 用户主目录
+ * @returns {string}
+ */
+function getGrokDir(homeDir) {
+    return path.join(homeDir, '.grok');
+}
+
+/**
+ * 获取 ~/.grok/.env 绝对路径
+ * @param {string} homeDir 用户主目录
+ * @returns {string}
+ */
+function getGrokEnvPath(homeDir) {
+    return path.join(getGrokDir(homeDir), '.env');
+}
+
+/**
+ * 解析 KEY=VALUE 文本，跳过空行和 # 注释，去掉值两端成对引号
+ * @param {string} content .env 文件内容
+ * @returns {object}
+ */
+function parseEnvFile(content) {
+    var env = {};
+    String(content || '').replace(/^\uFEFF/, '').split(/\r?\n/).forEach(function (line) {
+        var trimmed = line.trim();
+        if (!trimmed || trimmed.charAt(0) === '#') {
+            return;
+        }
+        var eq = trimmed.indexOf('=');
+        if (eq <= 0) {
+            return;
+        }
+        var key = trimmed.slice(0, eq).trim();
+        var value = trimmed.slice(eq + 1).trim();
+        var quote = value.charAt(0);
+        if ((quote === '"' || quote === "'") && value.length >= 2 && value.charAt(value.length - 1) === quote) {
+            value = value.slice(1, -1);
+        }
+        env[key] = value;
+    });
+    return env;
+}
+
+/**
+ * 检测本机是否存在指定命令：Windows 用 where，其它用 which
+ * @param {string} name 命令名
+ * @param {object} [options] 可选配置，execImpl 用于注入 execSync
+ * @returns {boolean}
+ */
+function commandExists(name, options) {
+    options = options || {};
+    var exec = options.execImpl || childProcess.execSync;
+    var cmd = process.platform === 'win32' ? ('where ' + name) : ('which ' + name);
+    try {
+        exec(cmd, { stdio: 'ignore' });
+        return true;
+    } catch (e) {
+        return false;
+    }
+}
+
+/**
+ * 本机没有 grok 时通过腾讯云 npm 源全局安装，安装失败向上抛错
+ * 安装不注入 ~/.grok/.env，直接走镜像源
+ * @param {object} [options] 可选配置，execImpl 用于注入 execSync
+ * @returns {void}
+ */
+function ensureGrokInstalled(options) {
+    if (commandExists('grok', options)) {
+        return;
+    }
+    options = options || {};
+    var exec = options.execImpl || childProcess.execSync;
+    console.log('未检测到 grok，正在从腾讯云 npm 源安装 @xai-official/grok ...');
+    exec(GROK_INSTALL_CMD, { stdio: 'inherit' });
+}
+
+/**
+ * 确保 ~/.grok/.env 存在；不存在则写入代理示例，已存在则不覆盖
+ * @param {string} homeDir 用户主目录
+ * @returns {{ created: boolean, envPath: string }}
+ */
+function ensureGrokEnvFile(homeDir) {
+    var grokDir = getGrokDir(homeDir);
+    var envPath = getGrokEnvPath(homeDir);
+    if (!fs.existsSync(grokDir)) {
+        fs.mkdirSync(grokDir, { recursive: true });
+    }
+    if (fs.existsSync(envPath)) {
+        return { created: false, envPath: envPath };
+    }
+    fs.writeFileSync(envPath, GROK_ENV_DEMO, 'utf8');
+    return { created: true, envPath: envPath };
+}
+
+/**
+ * 将 .env 解析结果覆盖到当前进程环境副本上，供子进程使用
+ * @param {string} content .env 文件内容
+ * @returns {object}
+ */
+function buildChildEnv(content) {
+    return Object.assign({}, process.env, parseEnvFile(content));
+}
+
+/**
+ * 启动官方 grok，Windows 走 shell 以便找到 grok.cmd
+ * @param {Array<string>} args 透传给 grok 的参数
+ * @param {object} childEnv 注入后的环境变量
+ * @param {object} [options] 可选配置，spawnImpl 用于注入 spawnSync
+ * @returns {number} grok 退出码
+ */
+function spawnGrok(args, childEnv, options) {
+    options = options || {};
+    var spawn = options.spawnImpl || childProcess.spawnSync;
+    var result = spawn('grok', args || [], {
+        stdio: 'inherit',
+        shell: process.platform === 'win32',
+        env: childEnv,
+    }) || {};
+    if (result.error) {
+        throw result.error;
+    }
+    if (result.signal) {
+        return 1;
+    }
+    return typeof result.status === 'number' ? result.status : 0;
+}
+
+/**
+ * 执行 jgrok：先处理 .env，首次创建则提示编辑；否则注入环境后安装并启动 grok
+ * @param {Array<string>} args 透传给 grok 的参数
+ * @param {object} buildCfg 含 homeDir 的配置
+ * @param {object} [options] 可选配置，execImpl/spawnImpl 用于单测注入
+ * @returns {Promise<number>} 退出码
+ */
+async function runJgrok(args, buildCfg, options) {
+    options = options || {};
+    var homeDir = getHomeDir(buildCfg);
+    var envResult = ensureGrokEnvFile(homeDir);
+    if (envResult.created) {
+        console.log('已首次创建 grok 环境文件，请编辑后再运行 jgrok：');
+        console.log(envResult.envPath);
+        return 0;
+    }
+    var childEnv = buildChildEnv(fs.readFileSync(envResult.envPath, 'utf8'));
+    ensureGrokInstalled(options);
+    return spawnGrok(args || [], childEnv, options);
+}
+
+runJgrok._private = {
+    GROK_ENV_DEMO: GROK_ENV_DEMO,
+    GROK_INSTALL_CMD: GROK_INSTALL_CMD,
+    getHomeDir: getHomeDir,
+    getGrokDir: getGrokDir,
+    getGrokEnvPath: getGrokEnvPath,
+    parseEnvFile: parseEnvFile,
+    commandExists: commandExists,
+    ensureGrokInstalled: ensureGrokInstalled,
+    ensureGrokEnvFile: ensureGrokEnvFile,
+    buildChildEnv: buildChildEnv,
+    spawnGrok: spawnGrok,
+};
+
+module.exports = runJgrok;

package/main.js

@@ -6,7 +6,7 @@ var path = require('path');
 var inquirer = require('inquirer');
 var packageJson = require('./package.json');
 
-var VALID_TARGETS = ['jcc', 'jcx', 'weds', 'ucx'];
+var VALID_TARGETS = ['jcc', 'jcx', 'weds', 'ucx', 'jgrok'];
 
 /**
  * 打印 base_parts_ai 入口命令的中文帮助信息
@@ -17,11 +17,12 @@ function printUsage() {
         'base_parts_ai 入口工具',
         '',
         '用法:',
-        '  base_parts_ai                 选择 jcc、jcx、weds 或 ucx 后继续执行',
+        '  base_parts_ai                 选择 jcc、jcx、weds、ucx 或 jgrok 后继续执行',
         '  base_parts_ai jcc [参数...]   执行 Claude Code 配置工具',
         '  base_parts_ai jcx [参数...]   执行 Codex 配置工具',
         '  base_parts_ai weds [参数...]  执行 weds Claude Code 配置工具',
         '  base_parts_ai ucx [参数...]   通过目录改名切换 Codex 账号',
+        '  base_parts_ai jgrok [参数...] 注入 ~/.grok/.env 后启动 grok',
         '  base_parts_ai --help          显示入口帮助',
         '  base_parts_ai --version       显示当前版本',
         '',
@@ -57,13 +58,13 @@ function resolveTarget(args) {
 
     return {
         type: 'error',
-        message: '参数无效：有参数时必须先明确指定 jcc、jcx、weds 或 ucx。',
+        message: '参数无效：有参数时必须先明确指定 jcc、jcx、weds、ucx 或 jgrok。',
     };
 }
 
 /**
  * 让用户选择要继续执行的配置工具
- * @returns {Promise<string>} jcc、jcx、weds 或 ucx
+ * @returns {Promise<string>} jcc、jcx、weds、ucx 或 jgrok
  */
 async function selectTarget() {
     var answer = await inquirer.prompt([{
@@ -75,6 +76,7 @@ async function selectTarget() {
             { name: 'jcx - Codex 配置工具', value: 'jcx' },
             { name: 'weds - weds Claude Code 配置工具', value: 'weds' },
             { name: 'ucx - 切换 Codex 账号', value: 'ucx' },
+            { name: 'jgrok - 带代理环境启动 grok', value: 'jgrok' },
         ],
     }]);
     return answer.target;
@@ -82,7 +84,7 @@ async function selectTarget() {
 
 /**
  * 获取当前包内目标 CLI 脚本路径
- * @param {string} target jcc、jcx、weds 或 ucx
+ * @param {string} target jcc、jcx、weds、ucx 或 jgrok
  * @returns {string}
  */
 function getTargetScriptPath(target) {
@@ -90,8 +92,8 @@ function getTargetScriptPath(target) {
 }
 
 /**
- * 加载当前包内的 jcc/jcx/weds/ucx 入口函数
- * @param {string} target jcc、jcx、weds 或 ucx
+ * 加载当前包内的 jcc/jcx/weds/ucx/jgrok 入口函数
+ * @param {string} target jcc、jcx、weds、ucx 或 jgrok
  * @returns {Function}
  */
 function loadTargetCli(target) {
@@ -99,8 +101,8 @@ function loadTargetCli(target) {
 }
 
 /**
- * 同进程执行当前包内的 jcc/jcx/weds/ucx 入口，并临时注入跳过自身升级的环境变量
- * @param {string} target jcc、jcx、weds 或 ucx
+ * 同进程执行当前包内的 jcc/jcx/weds/ucx/jgrok 入口，并临时注入跳过自身升级的环境变量
+ * @param {string} target jcc、jcx、weds、ucx 或 jgrok
  * @param {Array<string>} args 透传给目标入口的参数
  * @param {Function} loader 测试用入口加载函数，默认 loadTargetCli
  * @returns {Promise<number>} 退出码
@@ -113,8 +115,8 @@ async function runTarget(target, args, loader) {
         if (typeof runCli !== 'function') {
             throw new Error(target + ' 入口没有导出可调用函数');
         }
-        await runCli(args || []);
-        return 0;
+        var result = await runCli(args || []);
+        return typeof result === 'number' ? result : 0;
     } finally {
         if (typeof oldSkipSelfUpdate === 'undefined') {
             delete process.env.BASE_PARTS_AI_SKIP_SELF_UPDATE;

package/package.json

@@ -1,16 +1,17 @@
 {
   "name": "base_parts_ai",
-  "version": "1.0.56",
+  "version": "1.0.57",
   "description": "jaskle base_parts_ai",
   "main": "./main.js",
   "registry": true,
   "directories": {},
   "scripts": {
-    "test": "node ./test_project_md_rename.js && node ./test_main.js && node ./test_jcc.js && node ./test_jcx.js && node ./test_ucx.js",
+    "test": "node ./test_project_md_rename.js && node ./test_main.js && node ./test_jcc.js && node ./test_jcx.js && node ./test_ucx.js && node ./test_jgrok.js",
     "jcc": "node ./bin/jcc.js",
     "jcx": "node ./bin/jcx.js",
     "weds": "node ./bin/weds.js",
     "ucx": "node ./bin/ucx.js",
+    "jgrok": "node ./bin/jgrok.js",
     "base_parts_ai": "node ./main.js",
     "__postinstall": "node ./bin/postinstall.js"
   },
@@ -19,7 +20,8 @@
     "jcc": "./bin/jcc.js",
     "jcx": "./bin/jcx.js",
     "weds": "./bin/weds.js",
-    "ucx": "./bin/ucx.js"
+    "ucx": "./bin/ucx.js",
+    "jgrok": "./bin/jgrok.js"
   },
   "files": [
     "main.js",