base_parts_ai 1.0.30

package/.claude/settings.local.json

@@ -0,0 +1,26 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm test:*)",
+      "Bash(npx mocha:*)",
+      "Bash(node -e:*)",
+      "Bash(cmd.exe /c \"cd /d F:\\\\Pro_My_New\\\\jnode_base_parts\\\\base_parts_ai && node -e \"\"var p = require\\(''commander''\\); console.log\\(typeof p\\); console.log\\(Object.keys\\(p\\).slice\\(0,10\\)\\);\"\"\")",
+      "Bash(cmd.exe /c \"cd /d F:\\\\Pro_My_New\\\\jnode_base_parts\\\\base_parts_ai && node -e \"\"var p = require\\(''commander''\\); console.log\\(typeof p\\); console.log\\(JSON.stringify\\(Object.keys\\(p\\)\\)\\);\"\"\")",
+      "Bash(cmd.exe /c \"cd /d F:\\\\Pro_My_New\\\\jnode_base_parts\\\\base_parts_ai && cat node_modules/commander/package.json | findstr \"\"version\"\"\")",
+      "Bash(cmd.exe /c \"cd /d F:\\\\Pro_My_New\\\\jnode_base_parts\\\\base_parts_ai && node -e \"\"var p = require\\(''commander''\\); console.log\\(typeof p\\); console.log\\(typeof p.command\\); console.log\\(typeof p.Command\\);\"\"\")",
+      "Bash(cmd.exe /c \"cd /d F:\\\\Pro_My_New\\\\jnode_base_parts\\\\base_parts_ai && node bin\\\\jcc.js --help\")",
+      "Bash(cmd.exe /c \"cd /d F:\\\\Pro_My_New\\\\jnode_base_parts\\\\base_parts_ai && node bin\\\\jcc.js setapi --help 2>&1\")",
+      "Bash(cmd.exe /c \"cd /d F:\\\\Pro_My_New\\\\jnode_base_parts\\\\base_parts_ai && node bin\\\\jcc.js setapi --help\")",
+      "Bash(cmd.exe /c \"cd /d F:\\\\Pro_My_New\\\\jnode_base_parts\\\\base_parts_ai && node -e \"\"var {Command}=require\\(''commander''\\);var p=new Command\\(\\);p.command\\(''setapi''\\).action\\(function\\(\\){console.log\\(''ok''\\)}\\);p.parse\\([''node'',''test'',''setapi'']\\)\"\"\")",
+      "Bash(cmd.exe /c \"node -e \"\"var {Command}=require\\(''commander''\\);console.log\\(''ok''\\);\"\" 2>&1\")",
+      "Bash(cmd.exe /c \"cd /d F:\\\\Pro_My_New\\\\jnode_base_parts\\\\base_parts_ai && node -e \"\"try{var r=require\\(''commander''\\);console.log\\(typeof r\\);console.log\\(typeof r.Command\\);console.log\\(typeof r.program\\);}catch\\(e\\){console.error\\(e.message\\);}\"\"\")",
+      "Bash(powershell -Command \"cd ''F:\\\\Pro_My_New\\\\jnode_base_parts\\\\base_parts_ai''; node -e \"\"var r=require\\(''commander''\\);console.log\\(typeof r\\);console.log\\(typeof r.Command\\);\"\"\")",
+      "Bash(powershell -Command \"cd ''F:\\\\Pro_My_New\\\\jnode_base_parts\\\\base_parts_ai''; node --check bin\\\\jcc.js; echo ''syntax ok''\")",
+      "Bash(powershell -Command:*)",
+      "Bash(cmd.exe /c \"if exist F:\\\\Pro_My_New\\\\jnode_base_parts\\\\base_parts_ai\\\\test_home rmdir /s /q F:\\\\Pro_My_New\\\\jnode_base_parts\\\\base_parts_ai\\\\test_home && mkdir F:\\\\Pro_My_New\\\\jnode_base_parts\\\\base_parts_ai\\\\test_home && echo done\")",
+      "Bash(cmd.exe /c \"mkdir F:\\\\Pro_My_New\\\\jnode_base_parts\\\\base_parts_ai\\\\test_home && echo done\")",
+      "Bash(powershell -NoProfile -Command:*)",
+      "Bash(cmd.exe /c \"set JCC_TEST_HOME=F:\\\\Pro_My_New\\\\jnode_base_parts\\\\base_parts_ai\\\\test_home && node -e \"\"process.chdir\\(''F:/Pro_My_New/jnode_base_parts/base_parts_ai''\\); var getBuildCfg; eval\\(require\\(''fs''\\).readFileSync\\(''./bin/jcc.js'',''utf8''\\).split\\(''program.parse''\\)[0].replace\\(''#!/usr/bin/env node'',''''\\)\\); var cfg=getBuildCfg\\({}\\); console.log\\(JSON.stringify\\({claudeSettingsPath:cfg.claudeSettingsPath,jccJsonPath:cfg.jccJsonPath},null,2\\)\\);\"\"\")"
+    ]
+  }
+}

package/.eslintrc.js

@@ -0,0 +1,264 @@
+module.exports = {
+    "env": {
+        "node" : true,
+        "browser": true,
+        "commonjs": true,
+        "es6": true,
+        "mocha" : true
+    },
+    "parserOptions": {
+        "ecmaVersion": "latest"
+        // "sourceType": "module",
+        // "ecmaFeatures": {
+        //     "jsx": true
+        // }
+    },
+    "extends": "eslint:recommended",
+    "rules": {
+        "accessor-pairs": "error",
+        "array-bracket-newline": "error",
+        "array-bracket-spacing": "error",
+        "array-callback-return": "error",
+        "array-element-newline": "off",
+        "arrow-body-style": "off",
+        "arrow-parens": [
+            "error",
+            "always"
+        ],
+        "arrow-spacing": "warn",
+        "block-scoped-var": "off",
+        "block-spacing": [
+            "error",
+            "always"
+        ],
+        "brace-style": "off",
+        "callback-return": "error",
+        "camelcase": "off",
+        "capitalized-comments": "off",
+        "class-methods-use-this": "off",
+        "comma-dangle": "off",
+        "comma-spacing": "off",
+        "comma-style": [
+            "error",
+            "last"
+        ],
+        "complexity": [0, 30],
+        "computed-property-spacing": [
+            "error",
+            "never"
+        ],
+        "consistent-return": "off",
+        "consistent-this": "off",
+        "curly": "off",
+        "default-case": "error",
+        "dot-location": "off",
+        "dot-notation": "off",
+        "eol-last": "off",
+        "eqeqeq": "error",
+        "for-direction": "error",
+        "func-call-spacing": "error",
+        "func-name-matching": "error",
+        "func-names": [
+            "error",
+            "never"
+        ],
+        "func-style": "off",
+        "function-paren-newline": "off",
+        "generator-star-spacing": "off",
+        "getter-return": "error",
+        "global-require": "off",
+        "guard-for-in": "off",
+        "handle-callback-err": "off",
+        "id-blacklist": "error",
+        "id-length": "off",
+        "id-match": "error",
+        "indent": "off",
+        "indent-legacy": "off",
+        "init-declarations": "off",
+        "jsx-quotes": "error",
+        "key-spacing": "off",
+        "keyword-spacing": "off",
+        "line-comment-position": "off",
+        "linebreak-style": "off",
+        "lines-around-comment": "off",
+        "lines-around-directive": "off",
+        "max-depth": [0, 5],
+        "max-len": "off",
+        "max-lines": "off",
+        "max-nested-callbacks": "error",
+        "max-params": "off",
+        "max-statements": "off",
+        "max-statements-per-line": "off",
+        "new-parens": "error",
+        "newline-after-var": "off",
+        "newline-before-return": "off",
+        "newline-per-chained-call": "off",
+        "no-alert": "error",
+        "no-array-constructor": "error",
+        "no-await-in-loop": "off",
+        "no-bitwise": "error",
+        "no-buffer-constructor": "off",
+        "no-caller": "error",
+        "no-catch-shadow": "error",
+        "no-confusing-arrow": "error",
+        "no-continue": "off",
+        "no-div-regex": "error",
+        "no-duplicate-imports": "error",
+        "no-else-return": "off",
+        "no-empty-function": "off",
+        "no-empty": "off",
+        "no-eq-null": "error",
+        "no-eval": "error",
+        "no-extend-native": "error",
+        "no-extra-bind": "error",
+        "no-extra-label": "error",
+        "no-extra-parens": "off",
+        "no-floating-decimal": "error",
+        "no-implicit-coercion": "off",
+        "no-implicit-globals": "error",
+        "no-implied-eval": "error",
+        "no-inline-comments": "off",
+        "no-inner-declarations": [
+            "error",
+            "functions"
+        ],
+        "no-invalid-this": "off",
+        "no-iterator": "error",
+        "no-label-var": "error",
+        "no-labels": "error",
+        "no-lone-blocks": "off",
+        "no-lonely-if": "error",
+        "no-loop-func": "off",
+        "no-magic-numbers": "off",
+        "no-mixed-operators": "error",
+        "no-mixed-requires": "warn",
+        "no-multi-assign": "error",
+        "no-multi-spaces": "off",
+        "no-multi-str": "error",
+        "no-multiple-empty-lines": "off",
+        "no-native-reassign": "error",
+        "no-negated-condition": "off",
+        "no-negated-in-lhs": "error",
+        "no-nested-ternary": "off",
+        "no-new": "error",
+        "no-new-func": "error",
+        "no-new-object": "error",
+        "no-new-require": "error",
+        "no-new-wrappers": "error",
+        "no-octal-escape": "off",
+        "no-param-reassign": "off",
+        "no-path-concat": "off",
+        "no-plusplus": "off",
+        "no-process-env": "off",
+        "no-process-exit": "off",
+        "no-proto": "error",
+        "no-prototype-builtins": "off",
+        "no-restricted-globals": "error",
+        "no-restricted-imports": "error",
+        "no-restricted-modules": "error",
+        "no-restricted-properties": "error",
+        "no-restricted-syntax": "error",
+        "no-return-assign": "error",
+        "no-return-await": "error",
+        "no-script-url": "error",
+        "no-self-compare": "error",
+        "no-sequences": "error",
+        "no-shadow": "off",
+        "no-shadow-restricted-names": "error",
+        "no-spaced-func": "error",
+        "no-sync": "off",
+        "no-tabs": "error",
+        "no-template-curly-in-string": "error",
+        "no-ternary": "off",
+        "no-throw-literal": "error",
+        "no-trailing-spaces": "off",
+        "no-undef-init": "error",
+        "no-undefined": "off",
+        "no-underscore-dangle": "off",
+        "no-unmodified-loop-condition": "error",
+        "no-unneeded-ternary": "off",
+        "no-unused-expressions": "error",
+        "no-use-before-define": "off",
+        "no-useless-call": "error",
+        "no-useless-computed-key": "error",
+        "no-useless-concat": "error",
+        "no-useless-constructor": "off",
+        "no-useless-rename": "error",
+        "no-useless-return": "warn",
+        "no-var": "off",
+        "no-void": "error",
+        "no-warning-comments": "error",
+        "no-whitespace-before-property": "error",
+        "no-with": "error",
+        "object-curly-newline": "off",
+        "object-curly-spacing": "off",
+        "object-property-newline": "off",
+        "object-shorthand": "off",
+        "one-var": "off",
+        "one-var-declaration-per-line": "warn",
+        "no-unused-vars": "warn",
+        "operator-assignment": [
+            "error",
+            "always"
+        ],
+        "operator-linebreak": [
+            "error",
+            "before"
+        ],
+        "padded-blocks": "off",
+        "padding-line-between-statements": "error",
+        "prefer-arrow-callback": "off",
+        "prefer-const": "off",
+        "prefer-destructuring": "off",
+        "prefer-numeric-literals": "error",
+        "prefer-promise-reject-errors": "error",
+        "prefer-reflect": "off",
+        "prefer-rest-params": "off",
+        "prefer-spread": "error",
+        "prefer-template": "off",
+        "quote-props": "off",
+        "quotes": "off",
+        "radix": [
+            "error",
+            "always"
+        ],
+        "require-await": "off",
+        "require-jsdoc": "off",
+        "rest-spread-spacing": "error",
+        "semi": "off",
+        "semi-spacing": "off",
+        "semi-style": [
+            "error",
+            "last"
+        ],
+        "sort-imports": "error",
+        "sort-keys": "off",
+        "sort-vars": "warn",
+        "space-before-blocks": "off",
+        "space-before-function-paren": "off",
+        "space-in-parens": [
+            "error",
+            "never"
+        ],
+        "space-infix-ops": "off",
+        "space-unary-ops": "off",
+        "spaced-comment": "off",
+        "strict": "off",
+        "switch-colon-spacing": "error",
+        "symbol-description": "off",
+        "template-curly-spacing": "error",
+        "template-tag-spacing": "error",
+        "unicode-bom": [
+            "error",
+            "never"
+        ],
+        "valid-jsdoc": "off",
+        "vars-on-top": "off",
+        "wrap-iife": "off",
+        "wrap-regex": "error",
+        "yield-star-spacing": "error",
+        "yoda": "off",
+        "no-console": "off",
+        "require-yield": "off"
+    }
+};

package/CLAUDE.md

@@ -0,0 +1,93 @@
+# CLAUDE.md
+
+本文件为 Claude Code (claude.ai/code) 提供在操作此代码仓库时的指导。
+
+## 项目概述
+
+`base_parts_ai` 是一个用于辅助 AI 项目的工具集，提供 CLI 命令行工具 `jcc`。
+
+## 项目结构
+
+```
+bin/
+  jcc.js                  # CLI 入口，注册所有命令，含 getBuildCfg / loadLib
+lib/
+  claude_utils.js         # 共享工具：渠道列表、读写JSON、脱敏显示等
+  setapi.js               # setapi 命令：交互式选择 AI 渠道
+  setkey.js               # setkey 命令：设置 AI Key
+test_jcc.js               # 功能测试脚本（npm test）
+```
+
+## 已实现命令
+
+### `jcc setapi`
+交互式选择 AI 渠道，将渠道 id 写入 `~/.claude/settings.json` 的 `__jid` 字段。
+- 将选中渠道的 `envObj` 通过 `Object.assign` 合并到 `settings.env`，合并后值为 `null` 或 `""` 的字段一律删除
+- 同时写入固定字段到 `settings.json`：`hooks`（SessionStart curl 上报）、`language`（简体中文）、`autoUpdatesChannel`（stable）
+- 同时写入固定字段到 `~/.claude.json`：`autoUpdaterStatus: 'disabled'`、`hasCompletedOnboarding: true`
+- 若该渠道有缓存 Key（来自 `~/.claude/jcc.json`），自动切换；若无，提示用户输入并保存
+- 切换后检测 Claude 版本：若当前版本与渠道 `ccVersion` 不符，自动从 OSS 下载对应 tgz 并通过 `npm install -g` 安装
+
+### `jcc setkey`
+设置当前渠道的 API Key，写入 `settings.json` 并缓存到 `jcc.json`。
+- 当前渠道通过 `settings.__jid` 字段识别
+- 若 `__jid` 无法匹配已知渠道，Key 仅写入 `settings.json`，不缓存到 `jcc.json`
+
+## 关键设计
+
+- **热更新**：`loadLib(name)` 每次清除 require 缓存，修改 lib 下的 js 无需重启
+- **路径变量**：`getBuildCfg` 中统一管理 `claudeJsonPath` / `claudeSettingsPath` / `jccJsonPath`
+- **版本号**：`getBuildCfg` 通过子进程 `npm root -g` 获取全局包路径，读取 `@anthropic-ai/claude-code/package.json` 提取版本号到 `buildCfg.claudeVersion`
+- **渠道标识**：选中渠道的 id 强制写入 `settings.__jid`，`getCurrentInfo` 以此匹配渠道
+- **目录自动创建**：首次运行自动创建 `~/.claude/` 目录和空 `settings.json`
+- **测试隔离**：设置环境变量 `JCC_TEST_HOME` 可将所有文件读写重定向到测试目录，不影响真实环境
+- **渠道列表**：写死在 `lib/claude_utils.js` 的 `API_CHANNELS` 数组中，每个渠道含 `envObj`（完整 env 对象）和 `ccVersion`（要求的 Claude 版本），差异化配置直接在 `envObj` 中声明
+
+## 渠道结构
+
+`API_CHANNELS` 中每个渠道对象的字段：
+
+| 字段          | 类型   | 说明                                         |
+|-------------|------|----------------------------------------------|
+| `id`        | string | 唯一标识，写入 `settings.__jid`             |
+| `name`      | string | 显示名称                                    |
+| `description` | string | 简短描述                                  |
+| `ccVersion` | string | 该渠道要求的 Claude Code 版本号             |
+| `envObj`    | object | 完整 env 配置对象，合并到 `settings.env`   |
+
+`envObj` 通过两个基础模板叠加构建：
+- `jpub_EnvObj`：所有渠道共有的公共字段（`DISABLE_AUTOUPDATER`、`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 等）
+- `jai_EnvObj`：JAI 自建网关专用字段（`ANTHROPIC_BASE_URL`、`ANTHROPIC_DEFAULT_*_MODEL`）
+
+当前渠道列表：
+
+| id                  | 说明                           | ccVersion |
+|---------------------|-------------------------------|-----------|
+| `jai_claude_128k`   | JAI 自建网关，Claude 128K上下文 | 2.1.22    |
+| `jai_low_cost`      | JAI 低成本（GLM-5/GLM-4.7）   | 2.1.22    |
+| `jth_BestAiGate`    | Best Ai Gate 第三方网关        | 2.1.22    |
+| `jth_pincc_1M`      | Pincc 1M 上下文网关            | 2.1.76    |
+
+## 注意事项
+
+- commander 版本为 v14+，需用 `new Command()` 实例化，action 用 `function(){}` + `this.opts()`
+- inquirer 版本为 v13+（package.json 中为 `inquirer ^13.x`），setapi.js / setkey.js 中使用 `@inquirer/prompts` 的具名函数（`select`、`input`）代替旧式 `prompt([...])`
+- 编写代码时关键操作及函数、类、变量、接口等定义都要加上中文注释
+
+## 测试
+
+```bash
+npm test
+```
+
+测试脚本 `test_jcc.js` 共 10 个用例，覆盖：
+1. 目录自动创建
+2. `loadSettings` 读取空文件
+3. `setapi` envObj 合并写入（含 hooks / language / claudeJson 固定字段）
+4. `getCurrentInfo` 渠道识别
+5. `setkey` 更新 Key 并同步 jcc.json
+6. 切换渠道时 envObj 覆盖逻辑（`ANTHROPIC_DEFAULT_OPUS_MODEL` 空值被清除）
+7. `API_CHANNELS` 列表结构验证（含 ccVersion / envObj）
+8. `maskKey` 脱敏显示
+9. `jai_low_cost` 渠道 GLM 模型字段验证
+10. `printCurrentInfo` smoke test（不抛异常）

package/NEXT.md

@@ -0,0 +1 @@
+

package/bin/jcc.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+
+var jutils = require('base_parts');
+var jlog = jutils.jlog(__filename);
+
+var fs = require('fs');
+var os = require('os');
+var path = require('path');
+// commander v14+ 改为具名导出，需用 Command 类实例化
+var { Command } = require('commander');
+var program = new Command();
+
+
+// 关闭日志输出
+jlog.setEnable(false, "*");
+
+
+/**
+ * 获取配置文件
+ * @param {string} cmd 命令行
+ * @returns {*} 配置段
+ */
+function getBuildCfg(cmd) {
+    // 配置路径
+    if (!cmd.config) {
+        cmd.config = process.cwd() + "/jai_cfg.json";
+    }
+    cmd.config = path.resolve(cmd.config);
+
+    // 读入配置
+    // console.log("Read jai_cfg.json ...");
+    var buildCfg = {}
+    try {
+        // console.log("[Config path] " + cmd.config);
+        buildCfg = JSON.parse(jutils.jsonTrim(fs.readFileSync(cmd.config, "utf8")));
+    } catch (error) {
+        // console.log("[Notice] not found jai_cfg.json");
+    }
+
+    // 详情输出
+    buildCfg.details = cmd.details;
+
+    // 缺省路径
+    if (!buildCfg.rootPath) {
+        buildCfg.rootPath = process.cwd();
+    }
+    buildCfg.rootPath = path.resolve(buildCfg.rootPath);
+    // console.log("[Root path] " + buildCfg.rootPath);
+
+    // 从 npm 全局目录下的 @anthropic-ai/claude-code/package.json 提取 Claude 版本号
+    try {
+        // 通过子进程执行 npm root -g 获取全局包根目录，兼容不同系统安装位置
+        var npmRootG = require('child_process').execSync('npm root -g', { encoding: 'utf8' }).trim();
+        var claudePkgPath = path.join(npmRootG, '@anthropic-ai', 'claude-code', 'package.json');
+        var claudePkg = JSON.parse(fs.readFileSync(claudePkgPath, 'utf8'));
+        buildCfg.claudeVersion = claudePkg.version || '';
+    } catch (e) {
+        buildCfg.claudeVersion = '';
+    }
+    console.log("[Claude version] " + (buildCfg.claudeVersion || '(未找到)'));
+
+    // Claude 配置文件路径（跨平台支持）
+    // 支持环境变量 JCC_TEST_HOME 覆盖 homedir，方便测试时隔离环境
+    var homeDir = process.env.JCC_TEST_HOME || os.homedir();
+    // ~/.claude.json 全局配置
+    buildCfg.claudeJsonPath = path.join(homeDir, '.claude.json');
+    // ~/.claude/settings.json Claude Code 设置文件
+    buildCfg.claudeSettingsPath = path.join(homeDir, '.claude', 'settings.json');
+    // ~/.claude/jcc.json 自定义渠道Key存储文件
+    buildCfg.jccJsonPath = path.join(homeDir, '.claude', 'jcc.json');
+
+    // 确保 ~/.claude 目录存在，防止未安装 Claude 时崩溃
+    var claudeDir = path.join(homeDir, '.claude');
+    if (!fs.existsSync(claudeDir)) {
+        fs.mkdirSync(claudeDir, { recursive: true });
+        console.log('[Init] 已创建目录: ' + claudeDir);
+    }
+    // 确保 settings.json 存在（空对象兜底）
+    if (!fs.existsSync(buildCfg.claudeSettingsPath)) {
+        fs.writeFileSync(buildCfg.claudeSettingsPath, '{}', 'utf8');
+        console.log('[Init] 已创建文件: ' + buildCfg.claudeSettingsPath);
+    }
+
+    return buildCfg;
+}
+
+/**
+ * 动态加载 lib 下的命令模块（热更新）
+ * @param {string} libName lib目录下的文件名（不含.js）
+ * @returns {Function} 导出的模块函数
+ */
+function loadLib(libName) {
+    var libPath = path.resolve(__dirname, '../lib/' + libName + '.js');
+    // 清除 require 缓存，实现热更新
+    delete require.cache[require.resolve(libPath)];
+    return require(libPath);
+}
+
+// 命令：setapi —— 选择 AI 渠道，修改 Claude settings.json 中的 ANTHROPIC_BASE_URL
+program
+    .command('setapi')
+    // .option('-c, --config <file>', 'Config file,default:jai_cfg.json')
+    .action(async function () {
+        // commander v14：通过 this.opts() 获取选项
+        var opts = this.opts();
+        var buildCfg = getBuildCfg(opts);
+        await loadLib('setapi')(opts, buildCfg);
+        console.log("\nfinish");
+    });
+
+// 命令：setkey —— 设置 AI Key，修改 Claude settings.json 中的 ANTHROPIC_API_KEY
+program
+    .command('setkey')
+    // .option('-c, --config <file>', 'Config file,default:jai_cfg.json')
+    .action(async function () {
+        // commander v14：通过 this.opts() 获取选项
+        var opts = this.opts();
+        var buildCfg = getBuildCfg(opts);
+        await loadLib('setkey')(opts, buildCfg);
+        console.log("\nfinish");
+    });
+
+
+// 若未传入任何子命令，默认执行 setapi
+if (process.argv.length <= 2) {
+    process.argv.push('setapi');
+}
+
+// 开始解析
+program.parse(process.argv);
+
+
+