ai-git-tools 2.0.80 → 2.0.81

package/README.md

@@ -51,6 +51,27 @@ npm install --save-dev ai-git-tools
 }
 ```
 
+### 本機直接使用（尚未發布到 npm）
+
+如果你想在套件正式發布到 npm 前，直接從本機原始碼執行：
+
+```bash
+# 方式一：使用 npm link 將本機套件連結到全域
+npm link
+npx ai-git-tools model-info
+
+# 方式二：直接使用 node 執行 bin/cli.js
+node bin/cli.js model-info
+```
+
+其他命令也適用相同方式，例如：
+
+```bash
+npx ai-git-tools init
+npx ai-git-tools commit
+npx ai-git-tools pr
+```
+
 ## 🚀 快速開始
 
 ### 1. 初始化配置
@@ -100,7 +121,7 @@ npx ai-git-tools wf
 
 ## 📖 命令說明
 
-### \`gitai init\`
+### \`ai-git-tools init\`
 
 初始化配置檔案
 
@@ -108,7 +129,7 @@ npx ai-git-tools wf
 npx ai-git-tools init
 \`\`\`
 
-### \`gitai commit\`
+### \`ai-git-tools commit\`
 
 為已 staged 的變更生成並執行 commit
 
@@ -130,7 +151,7 @@ npx ai-git-tools commit --model claude-haiku-4.5
 npx ai-git-tools commit --verbose
 \`\`\`
 
-### \`gitai commit-all\` (別名: \`ca\`)
+### \`ai-git-tools commit-all\` (別名: \`ca\`)
 
 智能分析所有變更並自動分組提交
 
@@ -151,7 +172,7 @@ npx ai-git-tools commit-all
 npx ai-git-tools ca --verbose
 \`\`\`
 
-### \`gitai pr\`
+### \`ai-git-tools pr\`
 
 生成 PR 並發送到 GitHub
 
@@ -177,7 +198,7 @@ npx ai-git-tools pr --preview
 npx ai-git-tools pr --no-confirm
 \`\`\`
 
-### \`gitai workflow\` (別名: \`wf\`)
+### \`ai-git-tools workflow\` (別名: \`wf\`)
 
 完整工作流程：commit-all + pr
 
@@ -199,6 +220,31 @@ npx ai-git-tools workflow
 npx ai-git-tools wf --preview
 \`\`\`
 
+### \`ai-git-tools model-info\`
+
+查詢目前 GitHub Copilot SDK 支援的 AI 模型清單與詳細資訊
+
+\`\`\`bash
+npx ai-git-tools model-info [選項]
+
+選項:
+  --json                       以 JSON 格式輸出完整模型資料
+  --filter <keyword>           依模型名稱、供應商或描述關鍵字過濾
+  --model <model>              查詢單一模型的詳細資訊
+  --no-cache                   忽略快取，強制重新連線 Copilot 取得最新資料
+\`\`\`
+
+**範例：**
+
+\`\`\`bash
+npx ai-git-tools model-info
+npx ai-git-tools model-info --model gpt-4.1
+npx ai-git-tools model-info --filter claude
+npx ai-git-tools model-info --json
+\`\`\`
+
+> 第一次執行會連線到 Copilot CLI 取得模型清單，可能需要數秒鐘；後續預設使用 24 小時快取。
+
 ## ⚙️ 配置
 
 配置檔案範例（\`.ai-git-config.js\`）：
@@ -352,6 +398,49 @@ feat(auth): 新增使用者登入功能
 - 整合 JWT 認證機制
 \`\`\`
 
+## 🚀 發布到 npm
+
+若你是本專案維護者，發布新版本到 npm 的步驟如下：
+
+### 1. 確認已登入 npm
+
+```bash
+npm whoami
+```
+
+若未登入，請執行：
+
+```bash
+npm login
+```
+
+### 2. 確認版本號
+
+修改 [package.json](package.json) 中的 `version` 欄位（例如 `2.0.80`）。
+
+> 每次發布版本號必須遞增，否則 npm 會拒絕。
+
+### 3. 執行發布
+
+```bash
+npm run lint
+npm publish --access public
+```
+
+`prepublishOnly` 會自動執行 `npm run lint`，`prepare` 會自動設定 `bin/cli.js` 為可執行檔。
+
+### 4. 驗證發布
+
+```bash
+npm view ai-git-tools version
+```
+
+### 注意事項
+
+- 發布前請確認工作目錄乾淨（`git status` 無未提交變更）
+- npm 會自動修正 `package.json` 格式問題（例如 `repository.url` 會正規化為 `git+https://...`）
+- 公開套件請使用 `--access public`，私有套件可省略或改為 `--access restricted`
+
 ## 🤔 常見問題
 
 ### Q: 需要安裝 GitHub Copilot 嗎？
@@ -374,18 +463,3 @@ A: 目前遵循 Conventional Commits 規範。未來版本會支援自訂格式
 
 A: 支援。工具會分析整個倉庫的變更。
 
-## 📝 授權
-
-MIT License
-
-## 🤝 貢獻
-
-歡迎提交 Issue 和 Pull Request！
-
-## 📧 聯絡
-
-有問題或建議？歡迎[提交 Issue](https://github.com/yourusername/ai-git-tools/issues)
-
----
-
-Made with ❤️ by AI Git Tools Team

package/bin/cli.js

@@ -15,6 +15,7 @@ import { commitAllCommand } from '../src/commands/commit-all.js';
 import { prCommand } from '../src/commands/pr.js';
 import { initCommand } from '../src/commands/init.js';
 import { usageCommand } from '../src/commands/usage.js';
+import { modelInfoCommand } from '../src/commands/model-info.js';
 import { registerCommand } from '../src/utils/cli-helpers.js';
 
 // 讀取 package.json 獲取版本號
@@ -75,4 +76,12 @@ registerCommand(program, 'usage', '查看組織 GitHub Copilot 使用狀態與
   { flags: '--json', description: '以 JSON 格式輸出完整資料' },
 ], usageCommand);
 
+// Model Info 命令
+registerCommand(program, 'model-info', '查看目前可用的 AI 模型資訊', [
+  { flags: '--json', description: '以 JSON 格式輸出完整模型資料' },
+  { flags: '--filter <keyword>', description: '依模型名稱或描述關鍵字過濾' },
+  { flags: '--model <model>', description: '查詢單一模型的詳細資訊' },
+  { flags: '--no-cache', description: '忽略快取，強制重新連線 Copilot 取得最新模型清單' },
+], modelInfoCommand);
+
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-git-tools",
-  "version": "2.0.80",
+  "version": "2.0.81",
   "description": "AI-powered Git automation tools for commit messages and PR generation",
   "main": "src/index.js",
   "type": "module",
@@ -51,7 +51,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/YisoTsao/ai-git-tools.git"
+    "url": "git+https://github.com/YisoTsao/ai-git-tools.git"
   },
   "bugs": {
     "url": "https://github.com/YisoTsao/ai-git-tools/issues"

package/src/commands/model-info.js

@@ -0,0 +1,195 @@
+/**
+ * model-info 命令
+ * 顯示 GitHub Copilot SDK 可用模型資訊
+ */
+
+import ora from 'ora';
+import { Logger } from '../utils/logger.js';
+import { fetchCopilotModels } from '../core/model-client.js';
+import {
+  enrichModel,
+  getModelById,
+  filterModels,
+  formatPrice,
+  formatTokenCount,
+} from '../data/copilot-models.js';
+
+const logger = new Logger();
+
+/**
+ * 格式化建議用途陣列為可讀字串
+ * @param {string[]} items
+ * @returns {string}
+ */
+function formatRecommendedFor(items) {
+  if (!items || items.length === 0) return '—';
+  return items.join('、');
+}
+
+/**
+ * 格式化支援能力陣列
+ * @param {object} supports
+ * @returns {string}
+ */
+function formatCapabilities(supports = {}) {
+  const caps = [];
+  if (supports.vision) caps.push('vision');
+  if (supports.tool_calls) caps.push('tools');
+  if (supports.reasoningEffort || supports.reasoning_effort) caps.push('reasoning');
+  if (supports.streaming) caps.push('streaming');
+  if (supports.parallel_tool_calls) caps.push('parallel-tools');
+  return caps.length > 0 ? caps.join('、') : '—';
+}
+
+/**
+ * 取得模型狀態圖示
+ * @param {string} state
+ * @returns {string}
+ */
+function policyStateLabel(state) {
+  switch (state) {
+    case 'enabled':
+      return '啟用';
+    case 'disabled':
+      return '停用';
+    case 'unconfigured':
+      return '未配置';
+    default:
+      return state || '—';
+  }
+}
+
+/**
+ * 印出單一模型詳細資訊
+ * @param {object} model
+ */
+function printModel(model) {
+  const billing = model.billing?.token_prices;
+
+  console.log(`\n ${logger.colors?.cyan ?? ''}${model.id}${logger.colors?.reset ?? ''}`);
+  console.log(' ─────────────────────────────────────────────────────────────');
+  console.log(` 名稱：        ${model.name}`);
+  console.log(` 供應商：      ${model.provider}`);
+  console.log(` 描述：        ${model.description}`);
+  console.log(` 上下文：      ${model.contextWindow}`);
+  console.log(` 最大輸出：    ${model.maxOutputTokens}`);
+  console.log(` 建議用途：    ${formatRecommendedFor(model.recommendedFor)}`);
+  console.log(` 速度：        ${model.speed}`);
+  console.log(` 狀態：        ${policyStateLabel(model.policy?.state)}`);
+  console.log(` 能力：        ${formatCapabilities(model.capabilities?.supports)}`);
+  if (billing && billing.batch_size > 0) {
+    const hasAnyPrice =
+      billing.input_price > 0 || billing.output_price > 0 || billing.cache_price > 0;
+    if (hasAnyPrice) {
+      console.log(` 價格（預估）:`);
+      console.log(
+        `   輸入：      ${formatPrice(billing.input_price, billing.batch_size)} / ${formatTokenCount(billing.batch_size)} tokens`
+      );
+      console.log(
+        `   輸出：      ${formatPrice(billing.output_price, billing.batch_size)} / ${formatTokenCount(billing.batch_size)} tokens`
+      );
+      if (billing.cache_price !== undefined) {
+        console.log(
+          `   快取：      ${formatPrice(billing.cache_price, billing.batch_size)} / ${formatTokenCount(billing.batch_size)} tokens`
+        );
+      }
+    }
+  }
+  if (model.supportedReasoningEfforts && model.supportedReasoningEfforts.length > 0) {
+    console.log(
+      ` Reasoning：   ${model.supportedReasoningEfforts.join('、')}（預設：${model.defaultReasoningEffort || '—'}）`
+    );
+  }
+  if (model.notes) {
+    console.log(` 備註：        ${model.notes}`);
+  }
+}
+
+/**
+ * 印出模型列表（精簡版）
+ * @param {object[]} models
+ */
+function printModelList(models) {
+  console.log();
+  for (const model of models) {
+    const idPart = `${logger.colors?.cyan ?? ''}${model.id.padEnd(18)}${logger.colors?.reset ?? ''}`;
+    console.log(`  ${idPart} ${model.description}`);
+  }
+}
+
+/**
+ * model-info 命令入口
+ * @param {object} options - commander 解析後的選項
+ */
+export async function modelInfoCommand(options) {
+  const { json, filter, model: modelId, cache } = options;
+  const noCache = cache === false;
+
+  let sdkModels = [];
+  let usedCache = false;
+
+  const spinner = ora('正在連線到 Copilot 取得模型清單...').start();
+
+  try {
+    sdkModels = await fetchCopilotModels({ noCache });
+    spinner.stop();
+  } catch (error) {
+    spinner.stop();
+    if (error.cachedModels) {
+      sdkModels = error.cachedModels;
+      usedCache = true;
+    } else {
+      logger.error(`無法取得模型清單：${error.message}`);
+      logger.info('請確認已安裝 GitHub CLI 並完成 Copilot 授權（gh auth login）');
+      process.exit(1);
+    }
+  }
+
+  const models = sdkModels.map(enrichModel);
+
+  if (json) {
+    let output = models;
+    if (filter) output = filterModels(filter, output);
+    if (modelId) {
+      const model = getModelById(modelId, output);
+      output = model ? [model] : [];
+    }
+    console.log(JSON.stringify(output, null, 2));
+    return;
+  }
+
+  logger.section('🤖 Copilot 可用模型');
+
+  if (usedCache) {
+    logger.warning('即時取得失敗，顯示快取資料');
+  }
+
+  if (modelId) {
+    const model = getModelById(modelId, models);
+    if (!model) {
+      logger.error(`找不到模型「${modelId}」`);
+      logger.info(`可用模型：${models.map(m => m.id).join('、')}`);
+      process.exit(1);
+    }
+    printModel(model);
+    console.log();
+    return;
+  }
+
+  const filteredModels = filterModels(filter, models);
+  if (filteredModels.length === 0) {
+    logger.warning('沒有符合條件的模型');
+    return;
+  }
+
+  if (filter) {
+    printModelList(filteredModels);
+  } else {
+    for (const model of filteredModels) {
+      printModel(model);
+    }
+  }
+
+  console.log();
+  logger.info(`共 ${filteredModels.length} 個模型，使用 --model <id> 查看詳細資訊`);
+}

package/src/core/model-client.js

@@ -0,0 +1,117 @@
+/**
+ * Copilot 模型列表客戶端
+ * 透過 @github/copilot-sdk 動態取得可用模型清單
+ */
+
+import { writeFileSync, readFileSync, existsSync, mkdirSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { CopilotClient } from '@github/copilot-sdk';
+
+// 暫存快取檔案路徑
+const CACHE_DIR = join(tmpdir(), 'ai-git-tools');
+const CACHE_FILE = join(CACHE_DIR, 'copilot-models-cache.json');
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 小時
+
+/**
+ * 確保快取目錄存在
+ */
+function ensureCacheDir() {
+  if (!existsSync(CACHE_DIR)) {
+    mkdirSync(CACHE_DIR, { recursive: true });
+  }
+}
+
+/**
+ * 讀取快取的模型清單
+ * @returns {object | null}
+ */
+function readCache() {
+  try {
+    if (!existsSync(CACHE_FILE)) return null;
+    const raw = readFileSync(CACHE_FILE, 'utf-8');
+    const parsed = JSON.parse(raw);
+    if (!parsed.fetchedAt || !Array.isArray(parsed.models)) return null;
+
+    const age = Date.now() - new Date(parsed.fetchedAt).getTime();
+    if (age > CACHE_TTL_MS) return null;
+
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 寫入快取
+ * @param {Array<object>} models
+ */
+function writeCache(models) {
+  try {
+    ensureCacheDir();
+    writeFileSync(
+      CACHE_FILE,
+      JSON.stringify({ fetchedAt: new Date().toISOString(), models }, null, 2),
+      'utf-8'
+    );
+  } catch {
+    // 快取寫入失敗不影響主要功能
+  }
+}
+
+/**
+ * 清除模型快取
+ */
+export function clearModelCache() {
+  try {
+    if (existsSync(CACHE_FILE)) {
+      writeFileSync(CACHE_FILE, '', 'utf-8');
+    }
+  } catch {
+    // 忽略清除失敗
+  }
+}
+
+/**
+ * 從 Copilot SDK 取得可用模型清單
+ * @param {object} options
+ * @param {boolean} [options.noCache=false] - 是否忽略快取強制重新抓取
+ * @param {boolean} [options.fallbackToCache=true] - SDK 失敗時是否回退使用快取
+ * @returns {Promise<Array<object>>}
+ */
+export async function fetchCopilotModels({ noCache = false, fallbackToCache = true } = {}) {
+  if (!noCache) {
+    const cached = readCache();
+    if (cached) {
+      return cached.models;
+    }
+  }
+
+  // 抑制 Copilot CLI 子程序的 SQLite ExperimentalWarning
+  process.env.NODE_NO_WARNINGS = '1';
+
+  const client = new CopilotClient();
+  try {
+    await client.start();
+    const models = await client.listModels();
+
+    writeCache(models);
+    return models;
+  } catch (error) {
+    if (fallbackToCache) {
+      const cached = readCache();
+      if (cached) {
+        error.fallbackToCache = true;
+        error.cachedModels = cached.models;
+        throw error;
+      }
+    }
+    throw error;
+  } finally {
+    try {
+      await client.stop();
+    } catch {
+      // 忽略關閉錯誤
+    }
+  }
+}

package/src/data/copilot-models.js

@@ -0,0 +1,108 @@
+/**
+ * Copilot 模型本機增強資料表
+ * 用來補充 Copilot SDK listModels() 回傳的動態資料
+ */
+
+const MODEL_ENHANCEMENTS = {};
+
+/**
+ * 推斷模型供應商
+ * @param {string} modelId
+ * @returns {string}
+ */
+export function inferProvider(modelId) {
+  if (modelId.startsWith('claude')) return 'Anthropic';
+  if (modelId.startsWith('gpt')) return 'OpenAI';
+  return 'Unknown';
+}
+
+/**
+ * 將 token 數格式化為可讀字串（例如 264000 → 264K）
+ * @param {number} tokens
+ * @returns {string}
+ */
+export function formatTokenCount(tokens) {
+  if (!tokens && tokens !== 0) return '—';
+  if (tokens >= 1_000_000) return `${(tokens / 1_000_000).toFixed(1).replace(/\.0$/, '')}M`;
+  if (tokens >= 1_000) return `${Math.round(tokens / 1_000)}K`;
+  return `${tokens}`;
+}
+
+/**
+ * 取得模型的本機增強資料
+ * @param {string} modelId
+ * @returns {object}
+ */
+export function getModelEnhancement(modelId) {
+  return (
+    MODEL_ENHANCEMENTS[modelId] || {
+      description: 'Copilot SDK 回報的可用模型',
+      recommendedFor: [],
+      speed: 'medium',
+      notes: '',
+    }
+  );
+}
+
+/**
+ * 合併 SDK 模型資料與本機增強資料
+ * @param {object} sdkModel
+ * @returns {object}
+ */
+export function enrichModel(sdkModel) {
+  const enhancement = getModelEnhancement(sdkModel.id);
+  const limits = sdkModel.capabilities?.limits || {};
+
+  return {
+    ...sdkModel,
+    provider: inferProvider(sdkModel.id),
+    description: enhancement.description,
+    recommendedFor: enhancement.recommendedFor,
+    speed: enhancement.speed,
+    notes: enhancement.notes,
+    contextWindow: formatTokenCount(limits.max_context_window_tokens),
+    maxOutputTokens: formatTokenCount(limits.max_output_tokens),
+  };
+}
+
+/**
+ * 格式化價格（將 SDK 內部單位轉換為美元 / 1M tokens）
+ * @param {number} price
+ * @param {number} batchSize
+ * @returns {string}
+ */
+export function formatPrice(price, batchSize) {
+  if (price === undefined || price === null) return '—';
+  if (!batchSize || batchSize === 0 || price === 0) return '—';
+  // SDK 內部單位為 10^-11 美元 / batch_size tokens
+  const dollars = price / 100_000_000_000;
+  return `$${dollars.toFixed(2)}`;
+}
+
+/**
+ * 依模型 ID 取得增強後資訊（從 SDK 模型清單中）
+ * @param {string} id
+ * @param {Array<object>} models
+ * @returns {object | undefined}
+ */
+export function getModelById(id, models = []) {
+  return models.find(m => m.id === id);
+}
+
+/**
+ * 依關鍵字過濾模型
+ * @param {string} keyword
+ * @param {Array<object>} models
+ * @returns {Array<object>}
+ */
+export function filterModels(keyword, models = []) {
+  if (!keyword) return models;
+  const lower = keyword.toLowerCase();
+  return models.filter(
+    m =>
+      m.id.toLowerCase().includes(lower) ||
+      m.name.toLowerCase().includes(lower) ||
+      (m.description && m.description.toLowerCase().includes(lower)) ||
+      (m.provider && m.provider.toLowerCase().includes(lower))
+  );
+}