ai-git-tools 2.1.10 → 2.1.12

package/README.md

@@ -399,6 +399,8 @@ AI 產出的 notes 會固定整理成以下架構：
 
 實作內容最多顯示 6 個項目；沒有待確認事項時不會建立空的 `待確認` 區塊。Git 與流程圖區塊會維持既有格式。
 
+所有 Copilot AI 回應會在程式內統一轉換為台灣繁體中文，包含 Redmine notes、需求說明、實作內容、行為規則、影響範圍與 Mermaid 文字；不依賴模型自行遵守語言設定。
+
 ## ⚙️ 配置
 
 配置檔案範例（\`.ai-git-config.js\`）：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-git-tools",
-  "version": "2.1.10",
+  "version": "2.1.12",
   "description": "AI-powered Git automation tools for commit messages and PR generation",
   "main": "src/index.js",
   "type": "module",
@@ -44,6 +44,7 @@
     "chalk": "^5.3.0",
     "commander": "^12.0.0",
     "inquirer": "^9.2.0",
+    "opencc-js": "^1.4.2",
     "ora": "^8.0.1"
   },
   "devDependencies": {

package/src/commands/redmine-update.js

@@ -12,6 +12,7 @@ import {
 import { buildRedmineConfig } from '../redmine/config.js';
 import { RedmineClient } from '../redmine/redmine-client.js';
 import { Logger } from '../utils/logger.js';
+import { toTraditionalChinese } from '../utils/traditional-chinese.js';
 import {
   applyRedmineDraft,
   generateRedmineDraft,
@@ -32,7 +33,7 @@ function printProgress(progress) {
       logger.step(`[${progress.index}/${progress.total}] 讀取 Redmine Issue #${progress.issueId}...`);
       break;
     case 'issue-read':
-      logger.success(`Issue #${progress.issueId} 已取得：${progress.subject || '無標題'}`);
+      logger.success(`Issue #${progress.issueId} 已取得：${toTraditionalChinese(progress.subject || '無標題')}`);
       break;
     case 'analyze-issue':
       logger.step(`[${progress.index}/${progress.total}] 使用 Copilot 分析 Issue #${progress.issueId}...`);
@@ -161,7 +162,7 @@ export async function redmineUpdateCommand(options = {}) {
     }
   }
   if (pullRequest) {
-    logger.success(`已找到 PR #${pullRequest.number}：${pullRequest.title || '無標題'}`);
+    logger.success(`已找到 PR #${pullRequest.number}：${toTraditionalChinese(pullRequest.title || '無標題')}`);
     console.log(`🔗 ${pullRequest.url}`);
   } else {
     logger.info('目前 branch 沒有找到對應的 GitHub PR，略過 PR 資訊');

package/src/core/ai-client.js

@@ -4,6 +4,7 @@
  */
 
 import { CopilotClient, approveAll } from '@github/copilot-sdk';
+import { toTraditionalChinese } from '../utils/traditional-chinese.js';
 
 export class AIClient {
   /**
@@ -75,7 +76,7 @@ export class AIClient {
         const response = await Promise.race([responsePromise, timeoutPromise]);
 
         const content = response?.data?.content || '';
-        return content.trim();
+        return toTraditionalChinese(content.trim());
       } catch (error) {
         lastError = error;
         if (attempt < maxRetries) {

package/src/redmine/issue-analyzer.js

@@ -1,4 +1,5 @@
 import { AIClient } from '../core/ai-client.js';
+import { normalizeAnalysisLanguage } from '../utils/traditional-chinese.js';
 
 const ANALYSIS_FIELDS = [
   'developmentSummary',
@@ -17,9 +18,11 @@ const ANALYSIS_FIELDS = [
 function normalizeFlowcharts(value) {
   const flowcharts = Array.isArray(value)
     ? value
-    : value
+    : typeof value === 'string'
       ? [{ source: value }]
-      : [];
+      : value
+        ? [value]
+        : [];
 
   const usedIds = new Set();
   return flowcharts
@@ -39,7 +42,9 @@ function normalizeFlowcharts(value) {
       return {
         id: uniqueId,
         title,
-        source: typeof flowchart.source === 'string' ? flowchart.source.trim() : '',
+        source: typeof (flowchart.source || flowchart.mermaid) === 'string'
+          ? (flowchart.source || flowchart.mermaid).trim()
+          : '',
         evidence: asStringArray(flowchart.evidence),
       };
     })
@@ -82,13 +87,15 @@ export function buildIssueAnalysisPrompt({ issue, evidence }) {
 
 重要規則：
 - 這次只分析指定的 Issue #${issue.id}，不得把結果指派給其他 Issue。
+- 所有自然語言欄位必須使用台灣繁體中文，禁止輸出簡體中文。
 - 只能描述下方 Issue、Git commits、changed files、diff 或 PR evidence 中有明確證據的內容。
 - 不得捏造 API endpoint、參數、檔案、function、class、測試或部署結果。
 - requirementDescription 必須是一句話，說明這次為什麼修改。
 - implementationDetails 必須整理 3～6 個實際完成事項。
 - behaviorRules 必須使用 scenario/behavior 物件描述不同情境的行為。
 - impactScope 必須描述受到影響的功能、API、頁面或模組。
-- 若能從實際流程推導出可靠的流程，才產生 flowcharts；每張流程圖必須有穩定 id、title、source 與 evidence。
+- 只要 Issue 或 Git evidence 能推導出頁面、API、驗證或狀態之間的實際步驟，flowcharts 必須至少產生一張 Mermaid 流程圖，不得因為已有文字摘要而省略。
+- 只有在證據不足以描述任何流程時，flowcharts 才能回傳空陣列；每張流程圖必須有穩定 id、title、source 與 evidence。
 - 沒有明確測試或驗證證據時，verification 必須是空陣列。
 - 不要產生 suggestedStatus、coverage 或 confidence，也不要決定 Redmine status。
 
@@ -125,7 +132,7 @@ requirementDescription 與 impactScope 必須是字串；implementationDetails
  * @returns {object}
  */
 export function parseIssueAnalysis(content, issueId) {
-  const parsed = AIClient.parseJSON(content);
+  const parsed = normalizeAnalysisLanguage(AIClient.parseJSON(content));
   const result = { issueId };
 
   for (const field of ANALYSIS_FIELDS) {

package/src/redmine/redmine-formatters.js

@@ -1,5 +1,6 @@
 import inquirer from 'inquirer';
 import chalk from 'chalk';
+import { normalizeAnalysisLanguage, toTraditionalChinese } from '../utils/traditional-chinese.js';
 
 function bulletSection(title, items) {
   if (!Array.isArray(items) || items.length === 0) return '';
@@ -169,18 +170,20 @@ export function formatRedmineDescription(description = '', source = null) {
  * @returns {string}
  */
 export function formatRedmineNote({ issue = {}, analysis = {}, evidence = {}, pullRequest = null }) {
+  const localizedIssue = normalizeAnalysisLanguage(issue);
+  const localizedAnalysis = normalizeAnalysisLanguage(analysis);
   const sections = ['## 開發內容', ''];
   const requirementDescription = formatRequirement(
-    analysis.requirementDescription || analysis.developmentSummary?.[0] || issue.description || ''
+    localizedAnalysis.requirementDescription || localizedAnalysis.developmentSummary?.[0] || localizedIssue.description || ''
   );
-  const implementationDetails = getImplementationDetails(analysis);
-  const behaviorRules = formatBehaviorRules(analysis.behaviorRules);
+  const implementationDetails = getImplementationDetails(localizedAnalysis);
+  const behaviorRules = formatBehaviorRules(localizedAnalysis.behaviorRules);
   const implementation = bulletSection('實作內容', implementationDetails);
-  const impactScope = paragraphSection('影響範圍', analysis.impactScope);
-  const unresolved = analysis.unresolvedItems?.length
-    ? `### 待確認\n${analysis.unresolvedItems.map(item => `- [ ] ${item}`).join('\n')}\n`
+  const impactScope = paragraphSection('影響範圍', localizedAnalysis.impactScope);
+  const unresolved = localizedAnalysis.unresolvedItems?.length
+    ? `### 待確認\n${localizedAnalysis.unresolvedItems.map(item => `- [ ] ${item}`).join('\n')}\n`
     : '';
-  const flowcharts = formatFlowcharts(analysis.flowcharts);
+  const flowcharts = formatFlowcharts(localizedAnalysis.flowcharts);
 
   sections.push(
     paragraphSection('需求說明', requirementDescription),
@@ -217,8 +220,8 @@ export function formatRedmineNote({ issue = {}, analysis = {}, evidence = {}, pu
     );
   }
 
-  if (analysis.evidence?.length) {
-    sections.push(`分析依據：${analysis.evidence.join('、')}`, '');
+  if (localizedAnalysis.evidence?.length) {
+    sections.push(`分析依據：${localizedAnalysis.evidence.join('、')}`, '');
   }
 
   return sections.filter((section, index) => section || index === 1).join('\n').trim();
@@ -295,8 +298,8 @@ export function formatRedminePreview(drafts = []) {
   for (const draft of drafts) {
     lines.push(
       chalk.bold.cyan(`Issue #${draft.issueId}`),
-      `${chalk.dim('目前狀態：')} ${draft.currentStatusName || draft.originalStatusName || '—'}`,
-      `${chalk.green('更新狀態：')} ${draft.statusName || '未選擇'}`,
+      `${chalk.dim('目前狀態：')} ${toTraditionalChinese(draft.currentStatusName || draft.originalStatusName || '—')}`,
+      `${chalk.green('更新狀態：')} ${toTraditionalChinese(draft.statusName || '未選擇')}`,
       draft.doneRatio !== undefined ? `${chalk.green('完成百分比：')} ${draft.doneRatio}%` : '',
       draft.dueDate ? `${chalk.green('完成日期：')} ${draft.dueDate}` : '',
       draft.customFields?.length

package/src/utils/traditional-chinese.js

@@ -0,0 +1,28 @@
+import OpenCC from 'opencc-js';
+
+const convertToTraditional = OpenCC.Converter({ from: 'cn', to: 'tw' });
+
+/**
+ * 將文字轉換為台灣繁體中文
+ * @param {string} value
+ * @returns {string}
+ */
+export function toTraditionalChinese(value) {
+  return typeof value === 'string' ? convertToTraditional(value) : value;
+}
+
+/**
+ * 遞迴將資料中的所有字串轉換為台灣繁體中文
+ * @param {unknown} value
+ * @returns {unknown}
+ */
+export function normalizeAnalysisLanguage(value) {
+  if (typeof value === 'string') return toTraditionalChinese(value);
+  if (Array.isArray(value)) return value.map(normalizeAnalysisLanguage);
+  if (value && typeof value === 'object') {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, item]) => [key, normalizeAnalysisLanguage(item)])
+    );
+  }
+  return value;
+}