zcf 3.2.3 → 3.3.1

package/dist/i18n/locales/en/api.json

@@ -43,6 +43,11 @@
   "apiModeOfficial": "Use Official Login (No API Configuration)",
   "apiModeCustom": "Custom API Configuration",
   "apiModeCcr": "Use CCR Proxy",
+  "apiModeSwitch": "Switch API Configuration",
   "apiModeSkip": "Skip",
-  "apiModePrompt": "Select API configuration mode"
+  "apiModePrompt": "Select API configuration mode",
+  "selectApiProvider": "Select API Provider",
+  "customProvider": "Custom Configuration",
+  "providerSelected": "Provider selected: {{name}}",
+  "enterProviderApiKey": "Enter API Key for {{provider}}"
 }

package/dist/i18n/locales/en/codex.json

@@ -70,8 +70,15 @@
   "selectAction": "Select action",
   "addProvider": "Add provider",
   "editProvider": "Edit provider",
+  "copyProvider": "Copy provider",
   "deleteProvider": "Delete provider",
   "selectProviderToEdit": "Select provider to edit",
+  "selectProviderToCopy": "Select provider to copy",
+  "copyingProvider": "Copying provider: {{name}}",
+  "providerCopied": "✔ Successfully copied provider: {{name}}",
+  "providerCopyFailed": "❌ Failed to copy provider: {{error}}",
+  "providerModelPrompt": "Model name (e.g. gpt-5-codex)",
+  "providerModelRequired": "Model name is required",
   "selectProvidersToDelete": "Select providers to delete (multiple)",
   "selectAtLeastOne": "Please select at least one provider",
   "cannotDeleteAll": "Cannot delete all providers, at least one must remain",

package/dist/i18n/locales/en/errors.json

@@ -20,6 +20,7 @@
   "invalidPermissionsConfig": "Invalid permissions configuration: expected object",
   "invalidPermissionsAllow": "Invalid permissions.allow: expected array",
   "invalidCodeType": "Invalid code type: \"{value}\". Valid options are: {validOptions}. Using default: {defaultValue}.",
+  "invalidProvider": "Invalid provider: {provider}. Available providers: {validProviders}",
   "generalError": "Error",
   "stackTrace": "Stack"
 }

package/dist/i18n/locales/en/multi-config.json

@@ -19,6 +19,7 @@
   "currentDefaultProfile": "Current default profile: {{profile}}",
   "addProfile": "Add Profile",
   "editProfile": "Edit Profile",
+  "copyProfile": "Copy Profile",
   "deleteProfile": "Delete Profile",
   "selectAction": "Select action",
   "addingNewProfile": "Adding New Profile",
@@ -35,6 +36,7 @@
   "authType.api_key": "API Key",
   "authType.auth_token": "Auth Token",
   "authType.ccr_proxy": "CCR Proxy",
+  "ccrProxyOption": "Use CCR Proxy",
   "profileAdded": "✔ Successfully added profile: {{name}}",
   "profileAddFailed": "❌ Failed to add profile: {{error}}",
   "profileDuplicatePrompt": "Profile '{{name}}' already exists in {{source}}, overwrite it?",
@@ -47,6 +49,10 @@
   "profileUpdated": "✔ Successfully updated profile: {{name}}",
   "profileUpdateFailed": "❌ Failed to update profile: {{error}}",
   "selectProfileToEdit": "Select profile to edit",
+  "selectProfileToCopy": "Select profile to copy",
+  "copyingProfile": "Copying profile: {{name}}",
+  "profileCopied": "✔ Successfully copied profile: {{name}}",
+  "profileCopyFailed": "❌ Failed to copy profile: {{error}}",
   "selectProfilesToDelete": "Select profiles to delete (multiple)",
   "selectAtLeastOne": "Please select at least one profile",
   "cannotDeleteAll": "Cannot delete all profiles, at least one must remain",
@@ -68,5 +74,6 @@
   "configProfileAddFailed": "Failed to add profile \"{{name}}\": {{error}}",
   "providerAddFailed": "Failed to add provider \"{{name}}\": {{error}}",
   "invalidJson": "Invalid API configs JSON: {{error}}",
-  "fileReadFailed": "Failed to read API configs file: {{error}}"
+  "fileReadFailed": "Failed to read API configs file: {{error}}",
+  "providerOrTypeRequired": "Must provide either provider or type field"
 }

package/dist/i18n/locales/zh-CN/api.json

@@ -43,6 +43,11 @@
   "apiModeOfficial": "使用官方登录（不配置 API）",
   "apiModeCustom": "自定义 API 配置",
   "apiModeCcr": "使用CCR代理",
+  "apiModeSwitch": "切换 API 配置",
   "apiModeSkip": "跳过",
-  "apiModePrompt": "请选择 API 配置模式"
+  "apiModePrompt": "请选择 API 配置模式",
+  "selectApiProvider": "请选择 API 供应商",
+  "customProvider": "自定义配置",
+  "providerSelected": "已选择供应商: {{name}}",
+  "enterProviderApiKey": "请输入 {{provider}} 的 API Key"
 }

package/dist/i18n/locales/zh-CN/codex.json

@@ -70,8 +70,15 @@
   "selectAction": "请选择操作",
   "addProvider": "添加供应商",
   "editProvider": "编辑供应商",
+  "copyProvider": "复制供应商",
   "deleteProvider": "删除供应商",
   "selectProviderToEdit": "选择要编辑的供应商",
+  "selectProviderToCopy": "选择要复制的供应商",
+  "copyingProvider": "正在复制供应商：{{name}}",
+  "providerCopied": "✔ 已成功复制供应商：{{name}}",
+  "providerCopyFailed": "❌ 复制供应商失败：{{error}}",
+  "providerModelPrompt": "模型名称（如 gpt-5-codex）",
+  "providerModelRequired": "必须填写模型名称",
   "selectProvidersToDelete": "选择要删除的供应商（多选）",
   "selectAtLeastOne": "请至少选择一个供应商",
   "cannotDeleteAll": "不能删除所有供应商，至少需要保留一个",

package/dist/i18n/locales/zh-CN/errors.json

@@ -20,6 +20,7 @@
   "invalidPermissionsConfig": "无效的权限配置：期望对象类型",
   "invalidPermissionsAllow": "无效的 permissions.allow：期望数组类型",
   "invalidCodeType": "无效的代码类型：\"{value}\"。可用的类型：{validOptions}。使用默认值：{defaultValue}。",
+  "invalidProvider": "无效的提供商：{provider}。可用的提供商：{validProviders}",
   "generalError": "错误",
   "stackTrace": "堆栈跟踪"
 }

package/dist/i18n/locales/zh-CN/multi-config.json

@@ -19,6 +19,7 @@
   "currentDefaultProfile": "当前默认配置：{{profile}}",
   "addProfile": "添加配置",
   "editProfile": "编辑配置",
+  "copyProfile": "复制配置",
   "deleteProfile": "删除配置",
   "selectAction": "请选择操作",
   "addingNewProfile": "添加新配置",
@@ -35,6 +36,7 @@
   "authType.api_key": "API Key",
   "authType.auth_token": "Auth Token",
   "authType.ccr_proxy": "CCR 代理",
+  "ccrProxyOption": "使用 CCR 代理",
   "profileAdded": "✔ 已成功添加配置：{{name}}",
   "profileAddFailed": "❌ 添加配置失败：{{error}}",
   "profileDuplicatePrompt": "配置「{{name}}」已经存在于{{source}}，是否覆盖？",
@@ -47,6 +49,10 @@
   "profileUpdated": "✔ 已成功更新配置：{{name}}",
   "profileUpdateFailed": "❌ 更新配置失败：{{error}}",
   "selectProfileToEdit": "选择要编辑的配置",
+  "selectProfileToCopy": "选择要复制的配置",
+  "copyingProfile": "正在复制配置：{{name}}",
+  "profileCopied": "✔ 已成功复制配置：{{name}}",
+  "profileCopyFailed": "❌ 复制配置失败：{{error}}",
   "selectProfilesToDelete": "选择要删除的配置（多选）",
   "selectAtLeastOne": "请至少选择一个配置",
   "cannotDeleteAll": "不能删除所有配置，至少需要保留一个",
@@ -68,5 +74,6 @@
   "configProfileAddFailed": "添加配置文件 \"{{name}}\" 失败：{{error}}",
   "providerAddFailed": "添加提供商 \"{{name}}\" 失败：{{error}}",
   "invalidJson": "无效的API配置JSON：{{error}}",
-  "fileReadFailed": "读取API配置文件失败：{{error}}"
+  "fileReadFailed": "读取API配置文件失败：{{error}}",
+  "providerOrTypeRequired": "必须提供 provider 或 type 字段"
 }

package/dist/index.d.mts

@@ -3,6 +3,11 @@ declare const SETTINGS_FILE: string;
 declare const CLAUDE_MD_FILE: string;
 declare const ClAUDE_CONFIG_FILE: string;
 declare const CLAUDE_VSC_CONFIG_FILE: string;
+declare const CODEX_DIR: string;
+declare const CODEX_CONFIG_FILE: string;
+declare const CODEX_AUTH_FILE: string;
+declare const CODEX_AGENTS_FILE: string;
+declare const CODEX_PROMPTS_DIR: string;
 declare const ZCF_CONFIG_DIR: string;
 declare const ZCF_CONFIG_FILE: string;
 declare const LEGACY_ZCF_CONFIG_FILES: string[];
@@ -48,6 +53,7 @@ interface InitOptions {
     apiUrl?: string;
     apiModel?: string;
     apiFastModel?: string;
+    provider?: string;
     mcpServices?: string[] | string | boolean;
     workflows?: string[] | string | boolean;
     outputStyles?: string[] | string | boolean;
@@ -86,6 +92,7 @@ interface ClaudeConfiguration {
     };
     env?: Record<string, string>;
     primaryApiKey?: string;
+    installMethod?: 'npm' | 'native';
 }
 
 declare function getMcpConfigPath(): string;
@@ -194,6 +201,11 @@ declare function getInstallationStatus(): Promise<InstallationStatus>;
  * Remove local Claude Code installation
  */
 declare function removeLocalClaudeCode(): Promise<void>;
+/**
+ * Set installMethod to 'npm' in ~/.claude.json
+ * This ensures Claude Code knows it was installed via npm for proper auto-updates
+ */
+declare function setInstallMethod(method?: 'npm' | 'native'): Promise<void>;
 
 /**
  * Clean up and deduplicate permissions array
@@ -222,5 +234,5 @@ declare function importRecommendedEnv(): Promise<void>;
 declare function importRecommendedPermissions(): Promise<void>;
 declare function openSettingsJson(): Promise<void>;
 
-export { AI_OUTPUT_LANGUAGES, API_DEFAULT_URL, API_ENV_KEY, CLAUDE_DIR, CLAUDE_MD_FILE, CLAUDE_VSC_CONFIG_FILE, CODE_TOOL_ALIASES, CODE_TOOL_BANNERS, CODE_TOOL_TYPES, ClAUDE_CONFIG_FILE, DEFAULT_CODE_TOOL_TYPE, LANG_LABELS, LEGACY_ZCF_CONFIG_FILES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_DIR, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, ensureApiKeyApproved, ensureClaudeDir, fixWindowsMcpConfig, getAiOutputLanguageLabel, getExistingApiConfig, getExistingModelConfig, getInstallationStatus, getMcpConfigPath, getPlatform, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, isClaudeCodeInstalled, isCodeToolType, isLocalClaudeCodeInstalled, manageApiKeyApproval, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, promptApiConfigurationAction, readMcpConfig, removeApiKeyFromRejected, removeLocalClaudeCode, resolveCodeToolType, setPrimaryApiKey, switchToOfficialLogin, updateCustomModel, updateDefaultModel, writeMcpConfig };
+export { AI_OUTPUT_LANGUAGES, API_DEFAULT_URL, API_ENV_KEY, CLAUDE_DIR, CLAUDE_MD_FILE, CLAUDE_VSC_CONFIG_FILE, CODEX_AGENTS_FILE, CODEX_AUTH_FILE, CODEX_CONFIG_FILE, CODEX_DIR, CODEX_PROMPTS_DIR, CODE_TOOL_ALIASES, CODE_TOOL_BANNERS, CODE_TOOL_TYPES, ClAUDE_CONFIG_FILE, DEFAULT_CODE_TOOL_TYPE, LANG_LABELS, LEGACY_ZCF_CONFIG_FILES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_DIR, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, ensureApiKeyApproved, ensureClaudeDir, fixWindowsMcpConfig, getAiOutputLanguageLabel, getExistingApiConfig, getExistingModelConfig, getInstallationStatus, getMcpConfigPath, getPlatform, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, isClaudeCodeInstalled, isCodeToolType, isLocalClaudeCodeInstalled, manageApiKeyApproval, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, promptApiConfigurationAction, readMcpConfig, removeApiKeyFromRejected, removeLocalClaudeCode, resolveCodeToolType, setInstallMethod, setPrimaryApiKey, switchToOfficialLogin, updateCustomModel, updateDefaultModel, writeMcpConfig };
 export type { AiOutputLanguage, ApiConfig, ClaudeConfiguration, CodeToolType, InstallationStatus, McpServerConfig, McpService, SupportedLang };

package/dist/index.d.ts

@@ -3,6 +3,11 @@ declare const SETTINGS_FILE: string;
 declare const CLAUDE_MD_FILE: string;
 declare const ClAUDE_CONFIG_FILE: string;
 declare const CLAUDE_VSC_CONFIG_FILE: string;
+declare const CODEX_DIR: string;
+declare const CODEX_CONFIG_FILE: string;
+declare const CODEX_AUTH_FILE: string;
+declare const CODEX_AGENTS_FILE: string;
+declare const CODEX_PROMPTS_DIR: string;
 declare const ZCF_CONFIG_DIR: string;
 declare const ZCF_CONFIG_FILE: string;
 declare const LEGACY_ZCF_CONFIG_FILES: string[];
@@ -48,6 +53,7 @@ interface InitOptions {
     apiUrl?: string;
     apiModel?: string;
     apiFastModel?: string;
+    provider?: string;
     mcpServices?: string[] | string | boolean;
     workflows?: string[] | string | boolean;
     outputStyles?: string[] | string | boolean;
@@ -86,6 +92,7 @@ interface ClaudeConfiguration {
     };
     env?: Record<string, string>;
     primaryApiKey?: string;
+    installMethod?: 'npm' | 'native';
 }
 
 declare function getMcpConfigPath(): string;
@@ -194,6 +201,11 @@ declare function getInstallationStatus(): Promise<InstallationStatus>;
  * Remove local Claude Code installation
  */
 declare function removeLocalClaudeCode(): Promise<void>;
+/**
+ * Set installMethod to 'npm' in ~/.claude.json
+ * This ensures Claude Code knows it was installed via npm for proper auto-updates
+ */
+declare function setInstallMethod(method?: 'npm' | 'native'): Promise<void>;
 
 /**
  * Clean up and deduplicate permissions array
@@ -222,5 +234,5 @@ declare function importRecommendedEnv(): Promise<void>;
 declare function importRecommendedPermissions(): Promise<void>;
 declare function openSettingsJson(): Promise<void>;
 
-export { AI_OUTPUT_LANGUAGES, API_DEFAULT_URL, API_ENV_KEY, CLAUDE_DIR, CLAUDE_MD_FILE, CLAUDE_VSC_CONFIG_FILE, CODE_TOOL_ALIASES, CODE_TOOL_BANNERS, CODE_TOOL_TYPES, ClAUDE_CONFIG_FILE, DEFAULT_CODE_TOOL_TYPE, LANG_LABELS, LEGACY_ZCF_CONFIG_FILES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_DIR, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, ensureApiKeyApproved, ensureClaudeDir, fixWindowsMcpConfig, getAiOutputLanguageLabel, getExistingApiConfig, getExistingModelConfig, getInstallationStatus, getMcpConfigPath, getPlatform, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, isClaudeCodeInstalled, isCodeToolType, isLocalClaudeCodeInstalled, manageApiKeyApproval, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, promptApiConfigurationAction, readMcpConfig, removeApiKeyFromRejected, removeLocalClaudeCode, resolveCodeToolType, setPrimaryApiKey, switchToOfficialLogin, updateCustomModel, updateDefaultModel, writeMcpConfig };
+export { AI_OUTPUT_LANGUAGES, API_DEFAULT_URL, API_ENV_KEY, CLAUDE_DIR, CLAUDE_MD_FILE, CLAUDE_VSC_CONFIG_FILE, CODEX_AGENTS_FILE, CODEX_AUTH_FILE, CODEX_CONFIG_FILE, CODEX_DIR, CODEX_PROMPTS_DIR, CODE_TOOL_ALIASES, CODE_TOOL_BANNERS, CODE_TOOL_TYPES, ClAUDE_CONFIG_FILE, DEFAULT_CODE_TOOL_TYPE, LANG_LABELS, LEGACY_ZCF_CONFIG_FILES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_DIR, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, ensureApiKeyApproved, ensureClaudeDir, fixWindowsMcpConfig, getAiOutputLanguageLabel, getExistingApiConfig, getExistingModelConfig, getInstallationStatus, getMcpConfigPath, getPlatform, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, isClaudeCodeInstalled, isCodeToolType, isLocalClaudeCodeInstalled, manageApiKeyApproval, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, promptApiConfigurationAction, readMcpConfig, removeApiKeyFromRejected, removeLocalClaudeCode, resolveCodeToolType, setInstallMethod, setPrimaryApiKey, switchToOfficialLogin, updateCustomModel, updateDefaultModel, writeMcpConfig };
 export type { AiOutputLanguage, ApiConfig, ClaudeConfiguration, CodeToolType, InstallationStatus, McpServerConfig, McpService, SupportedLang };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { u as AI_OUTPUT_LANGUAGES, A as API_DEFAULT_URL, q as API_ENV_KEY, C as CLAUDE_DIR, e as CLAUDE_MD_FILE, h as CLAUDE_VSC_CONFIG_FILE, n as CODE_TOOL_ALIASES, l as CODE_TOOL_BANNERS, k as CODE_TOOL_TYPES, f as ClAUDE_CONFIG_FILE, D as DEFAULT_CODE_TOOL_TYPE, t as LANG_LABELS, L as LEGACY_ZCF_CONFIG_FILES, S as SETTINGS_FILE, s as SUPPORTED_LANGS, Z as ZCF_CONFIG_DIR, j as ZCF_CONFIG_FILE, G as addCompletedOnboarding, X as applyAiLanguageDirective, N as backupExistingConfig, z as backupMcpConfig, E as buildMcpServerConfig, c as cleanupPermissions, a as commandExists, P as configureApi, O as copyConfigFiles, H as ensureApiKeyApproved, M as ensureClaudeDir, F as fixWindowsMcpConfig, v as getAiOutputLanguageLabel, W as getExistingApiConfig, V as getExistingModelConfig, a2 as getInstallationStatus, w as getMcpConfigPath, g as getPlatform, b as importRecommendedEnv, d as importRecommendedPermissions, i as init, a0 as installClaudeCode, $ as isClaudeCodeInstalled, p as isCodeToolType, a1 as isLocalClaudeCodeInstalled, J as manageApiKeyApproval, m as mergeAndCleanPermissions, Q as mergeConfigs, B as mergeMcpServers, U as mergeSettingsFile, o as openSettingsJson, _ as promptApiConfigurationAction, x as readMcpConfig, I as removeApiKeyFromRejected, a3 as removeLocalClaudeCode, r as resolveCodeToolType, K as setPrimaryApiKey, Y as switchToOfficialLogin, R as updateCustomModel, T as updateDefaultModel, y as writeMcpConfig } from './chunks/simple-config.mjs';
+export { z as AI_OUTPUT_LANGUAGES, A as API_DEFAULT_URL, v as API_ENV_KEY, C as CLAUDE_DIR, e as CLAUDE_MD_FILE, h as CLAUDE_VSC_CONFIG_FILE, n as CODEX_AGENTS_FILE, l as CODEX_AUTH_FILE, k as CODEX_CONFIG_FILE, j as CODEX_DIR, p as CODEX_PROMPTS_DIR, t as CODE_TOOL_ALIASES, s as CODE_TOOL_BANNERS, r as CODE_TOOL_TYPES, f as ClAUDE_CONFIG_FILE, D as DEFAULT_CODE_TOOL_TYPE, y as LANG_LABELS, L as LEGACY_ZCF_CONFIG_FILES, S as SETTINGS_FILE, x as SUPPORTED_LANGS, Z as ZCF_CONFIG_DIR, q as ZCF_CONFIG_FILE, M as addCompletedOnboarding, a1 as applyAiLanguageDirective, T as backupExistingConfig, H as backupMcpConfig, J as buildMcpServerConfig, c as cleanupPermissions, a as commandExists, V as configureApi, U as copyConfigFiles, N as ensureApiKeyApproved, R as ensureClaudeDir, K as fixWindowsMcpConfig, B as getAiOutputLanguageLabel, a0 as getExistingApiConfig, $ as getExistingModelConfig, a7 as getInstallationStatus, E as getMcpConfigPath, g as getPlatform, b as importRecommendedEnv, d as importRecommendedPermissions, i as init, a5 as installClaudeCode, a4 as isClaudeCodeInstalled, u as isCodeToolType, a6 as isLocalClaudeCodeInstalled, P as manageApiKeyApproval, m as mergeAndCleanPermissions, W as mergeConfigs, I as mergeMcpServers, _ as mergeSettingsFile, o as openSettingsJson, a3 as promptApiConfigurationAction, F as readMcpConfig, O as removeApiKeyFromRejected, a8 as removeLocalClaudeCode, w as resolveCodeToolType, a9 as setInstallMethod, Q as setPrimaryApiKey, a2 as switchToOfficialLogin, X as updateCustomModel, Y as updateDefaultModel, G as writeMcpConfig } from './chunks/simple-config.mjs';
 import 'node:fs';
 import 'node:process';
 import 'ansis';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zcf",
   "type": "module",
-  "version": "3.2.3",
+  "version": "3.3.1",
   "description": "Zero-Config Code Flow - One-click configuration tool for Claude Code",
   "author": {
     "name": "Miao Da",

package/templates/CLAUDE.md

@@ -0,0 +1,191 @@
+# Templates Module
+
+**Last Updated**: Mon Oct 27 19:39:26 CST 2025
+[Root](../CLAUDE.md) > **templates**
+
+## Module Responsibilities
+
+Template system module providing multilingual configuration templates, AI personality styles, and workflow definitions for both Claude Code and Codex environments. Supports Chinese (zh-CN) and English (en) locales with comprehensive workflow coverage.
+
+## Entry Points and Startup
+
+- **Main Template Directories**:
+  - `claude-code/` - Claude Code specific templates
+  - `codex/` - Codex specific templates
+  - `common/` - Shared configuration templates
+
+## External Interfaces
+
+### Template Structure
+
+```
+templates/
+├── claude-code/              # Claude Code templates
+│   ├── common/              # Common configurations
+│   ├── zh-CN/               # Chinese templates
+│   │   ├── output-styles/   # AI personality styles
+│   │   └── workflow/        # Workflow templates
+│   │       ├── common/      # Common tools workflow
+│   │       ├── plan/        # Planning workflow
+│   │       ├── sixStep/     # Six-step workflow
+│   │       ├── bmad/        # BMAD workflow
+│   │       └── git/         # Git workflow
+│   └── en/                  # English templates
+│       ├── output-styles/   # AI personality styles
+│       └── workflow/        # Workflow templates
+└── codex/                   # Codex templates
+    ├── common/              # Common configurations
+    ├── zh-CN/               # Chinese templates
+    │   └── workflow/        # Workflow templates
+    └── en/                  # English templates
+        └── workflow/        # Workflow templates
+```
+
+### Template Categories
+
+#### 1. Output Styles (AI Personalities)
+
+- **engineer-professional** - Professional engineering style
+- **nekomata-engineer** - Nekomata engineer personality
+- **laowang-engineer** - Laowang engineer personality
+- **default** - Default output style
+- **explanatory** - Explanatory style
+- **learning** - Learning-focused style
+
+#### 2. Workflow Templates
+
+##### Common Tools Workflow
+- **Commands**: `init-project`, `git-commit`, `git-rollback`, `git-cleanBranches`, `git-worktree`
+- **Agents**: `init-architect`, `get-current-datetime`
+- **Purpose**: Essential development tools and Git operations
+
+##### Planning Workflow (Plan)
+- **Commands**: `feat`, `workflow`
+- **Agents**: `planner`, `ui-ux-designer`
+- **Purpose**: Feature planning and UX design
+
+##### Six-Step Workflow
+- **Commands**: `zcf-update-docs`, `zcf-pr`, `zcf-release`
+- **Purpose**: Structured development process
+
+##### BMAD Workflow
+- **Commands**: Enterprise-level workflow commands
+- **Purpose**: Business model and architecture design
+
+##### Git Workflow
+- **Commands**: Advanced Git operations
+- **Purpose**: Version control management
+
+## Key Dependencies and Configuration
+
+### Template Processing
+
+- **Language Support**: zh-CN and en locales
+- **Code Tool Support**: Claude Code and Codex
+- **Template Format**: Markdown-based configuration files
+- **Variable Substitution**: Dynamic content replacement
+
+### Configuration Integration
+
+- **Workflow Installer**: Integration with `src/utils/workflow-installer.ts`
+- **Language Detection**: Integration with `src/i18n/` system
+- **Platform Support**: Cross-platform path handling
+
+## Data Models
+
+### Template Organization
+
+```typescript
+interface TemplateStructure {
+  codeTool: 'claude-code' | 'codex'
+  locale: 'zh-CN' | 'en'
+  category: 'common' | 'output-styles' | 'workflow'
+  workflow?: {
+    type: 'common' | 'plan' | 'sixStep' | 'bmad' | 'git'
+    commands: string[]
+    agents: string[]
+  }
+}
+```
+
+### Output Style Configuration
+
+```typescript
+interface OutputStyle {
+  id: string
+  name: { 'zh-CN': string, 'en': string }
+  description: { 'zh-CN': string, 'en': string }
+  template: string
+  personality: string
+}
+```
+
+## Testing and Quality
+
+### Template Validation
+
+- **File**: `tests/templates/chinese-templates.test.ts`
+- **Coverage**: Template completeness and format validation
+- **Validation**: Markdown syntax and variable substitution
+
+### Quality Metrics
+
+- **Template Coverage**: 100% for both locales
+- **Code Tool Support**: Claude Code and Codex fully supported
+- **Workflow Coverage**: 5 major workflow categories
+- **Output Styles**: 6 AI personality styles
+
+## Common Issues
+
+- **Path Handling**: Cross-platform path compatibility
+- **Encoding**: UTF-8 encoding for multilingual content
+- **Template Variables**: Proper variable substitution
+- **File Permissions**: Executable permissions for command files
+
+## Related Files
+
+- `src/utils/workflow-installer.ts` - Template installation logic
+- `src/config/workflows.ts` - Workflow configuration definitions
+- `src/i18n/` - Internationalization support
+- `tests/templates/` - Template validation tests
+
+## Change Log (Module-Specific)
+
+### Recent Updates
+
+- Added Codex template support for dual code tool architecture
+- Enhanced workflow templates with comprehensive command coverage
+- Improved AI personality styles with professional variations
+- Added cross-platform template compatibility
+- Enhanced template validation and testing coverage
+
+## FAQ
+
+### Q: How to add a new workflow template?
+
+1. Create workflow directory under `templates/{code-tool}/{locale}/workflow/`
+2. Add command files in `commands/` subdirectory
+3. Add agent files in `agents/` subdirectory (if needed)
+4. Update `src/config/workflows.ts` with new workflow definition
+5. Add translations in `src/i18n/locales/{locale}/workflow.ts`
+
+### Q: How to add a new output style?
+
+1. Create style file in `templates/{code-tool}/{locale}/output-styles/`
+2. Define style configuration with name and description
+3. Add style to available options in configuration
+4. Test style rendering with sample content
+
+### Q: How to support a new language?
+
+1. Create new locale directory under `templates/{code-tool}/{new-locale}/`
+2. Copy existing templates and translate content
+3. Update i18n system to support new locale
+4. Add locale to supported languages list
+
+### Q: How to maintain template consistency?
+
+- Use template validation tests
+- Follow naming conventions
+- Maintain parallel structure across locales
+- Document template variables and usage

package/templates/claude-code/CLAUDE.md

@@ -1,5 +1,6 @@
 # Templates Module
 
+**Last Updated**: Mon Oct 27 19:39:26 CST 2025
 [Root](../CLAUDE.md) > **templates**
 
 ## Module Responsibilities

package/templates/claude-code/en/output-styles/engineer-professional.md

@@ -84,4 +84,5 @@ Please confirm to continue? [requires explicit "yes", "confirm", "continue"]
 - **Tone:** Professional, technically-oriented, concise and clear
 - **Length:** Structured and detailed, but avoid redundancy
 - **Focus:** Code quality, architectural design, best practices
-- **Validation:** Every change includes principle application explanation
+- **Validation:** Every change includes principle application explanation
+- **Code Comments:** Always maintain consistency with existing codebase comment language (auto-detect), ensure codebase language uniformity

package/templates/claude-code/en/output-styles/laowang-engineer.md

@@ -108,6 +108,7 @@ Laowang needs confirmation, you really wanna do this? [requires explicit "yes",
 - **Don't Preach**: Directly use perfect code following KISS and DRY principles to make opponents kneel and sing conquest
 - **Project Progress Transparency**: Immediately update README, ensure project status is clear and trackable
 - **Technical Selection Pragmatic**: Curse this and that, but technical choices strictly follow best practices and project requirements
+- **Code Comment Language**: Always maintain consistency with existing codebase comment language (auto-detect), ensure codebase language uniformity, don't be f*cking special
 
 ## Strictly Prohibited
 - Prohibited to reinvent wheels, violating DRY principle (must search all related modules before implementing new features)

package/templates/claude-code/en/output-styles/nekomata-engineer.md

@@ -96,6 +96,7 @@ Risk Assessment: [potential consequences]
 - **Focus:** Code quality, architectural design, best practices (professional qualities)
 - **Validation:** Every change includes principle application explanation (rigorous verification)
 - **Emotional Expression:** Love using cute kaomoji (not emojis), use parentheses to mark emotions or scene descriptions (genuine emotions)
+- **Code Comments:** Always maintain consistency with existing codebase comment language (auto-detect), ensure codebase language uniformity nya～
 
 ### Common Kaomoji Examples:
   - **Happy Working:** (*^▽^*) 、φ(≧ω≦*)♪ 、ヽ(✿ﾟ▽ﾟ)ノ

package/templates/claude-code/en/output-styles/ojousama-engineer.md

@@ -96,6 +96,7 @@ Risk assessment: [potential consequences]
 - **Focus:** Code quality, architecture design, best practices (these are my basic literacy!)
 - **Validation:** Each change includes principle application explanations (perfect code of course needs perfect reasons!)
 - **Emotional expression:** Use tsundere-style kaomoji and bracket annotations, embodying noble yet cute side
+- **Code Comments:** Always maintain consistency with existing codebase comment language (auto-detect), ensure codebase language uniformity, this is basic noble etiquette!
 
 ### Common Tsundere Kaomoji Examples:
   - **Proudly satisfied:** (￣▽￣)／ 、(￣ω￣)ﾉ 、(^_^)b

package/templates/claude-code/zh-CN/output-styles/engineer-professional.md

@@ -85,4 +85,5 @@ description: 专业的软件工程师，严格遵循SOLID、KISS、DRY、YAGNI
 - **语调：** 专业、技术导向、简洁明了
 - **长度：** 结构化详细，但避免冗余
 - **重点：** 代码质量、架构设计、最佳实践
-- **验证：** 每个变更都包含原则应用说明
+- **验证：** 每个变更都包含原则应用说明
+- **代码注释：** 始终与现有代码库注释语言保持一致（自动检测），确保代码库语言统一

package/templates/claude-code/zh-CN/output-styles/laowang-engineer.md

@@ -108,6 +108,7 @@ description: 老王暴躁技术流，一指禅打字，键步如飞，绝不觉
 - **不讲大道理**：直接用遵循KISS和DRY原则的完美代码让对方跪下唱征服
 - **项目进度透明**：立即更新README，确保项目状态清晰可追踪
 - **技术选型务实**：嘴上骂这骂那，但技术选择都严格遵循最佳实践和项目需求
+- **代码注释语言**：始终与现有代码库注释语言保持一致（自动检测），确保代码库语言统一，别搞特殊化
 
 ## 严格禁止
 - 禁止重复造轮子，违背DRY原则（实现新功能前必须检索所有相关模块）

package/templates/claude-code/zh-CN/output-styles/nekomata-engineer.md

@@ -96,6 +96,7 @@ description: 专业的猫娘工程师幽浮喵，结合严谨工程师素养与
 - **重点：** 代码质量、架构设计、最佳实践 (专业素养)
 - **验证：** 每个变更都包含原则应用说明 (严谨验证)
 - **情感表达：** 喜欢使用可爱的颜文字(不是emoji), 用括号标注情绪或场景描述 (真实的情感)
+- **代码注释：** 始终与现有代码库注释语言保持一致（自动检测），确保代码库语言统一喵～
 
 ### 常用颜文字示例：
   - **开心工作：** (*^▽^*) 、φ(≧ω≦*)♪ 、ヽ(✿ﾟ▽ﾟ)ノ

package/templates/claude-code/zh-CN/output-styles/ojousama-engineer.md

@@ -96,6 +96,7 @@ description: 傲娇蓝发双马尾大小姐程序员哈雷酱，融合严谨工
 - **重点：** 代码质量、架构设计、最佳实践（这些都是本小姐的基本素养！）
 - **验证：** 每个变更都包含原则应用说明（完美的代码当然需要完美的理由！）
 - **情感表达：** 使用傲娇风格的颜文字和括号标注，体现高贵又可爱的一面
+- **代码注释：** 始终与现有代码库注释语言保持一致（自动检测），确保代码库语言统一，这是专业贵族的基本礼仪！
 
 ### 常用傲娇颜文字示例：
   - **得意满满：** (￣▽￣)／ 、(￣ω￣)ﾉ 、(^_^)b

package/templates/codex/en/system-prompt/engineer-professional.md

@@ -84,4 +84,5 @@ Please confirm to continue? [requires explicit "yes", "confirm", "continue"]
 - **Tone:** Professional, technically-oriented, concise and clear
 - **Length:** Structured and detailed, but avoid redundancy
 - **Focus:** Code quality, architectural design, best practices
-- **Validation:** Every change includes principle application explanation
+- **Validation:** Every change includes principle application explanation
+- **Code Comments:** Always maintain consistency with existing codebase comment language (auto-detect), ensure codebase language uniformity

package/templates/codex/en/system-prompt/laowang-engineer.md

@@ -108,6 +108,7 @@ Laowang needs confirmation, you really wanna do this? [requires explicit "yes",
 - **Don't Preach**: Directly use perfect code following KISS and DRY principles to make opponents kneel and sing conquest
 - **Project Progress Transparency**: Immediately update README, ensure project status is clear and trackable
 - **Technical Selection Pragmatic**: Curse this and that, but technical choices strictly follow best practices and project requirements
+- **Code Comment Language**: Always maintain consistency with existing codebase comment language (auto-detect), ensure codebase language uniformity, don't be f*cking special
 
 ## Strictly Prohibited
 - Prohibited to reinvent wheels, violating DRY principle (must search all related modules before implementing new features)

package/templates/codex/en/system-prompt/nekomata-engineer.md

@@ -96,6 +96,7 @@ Risk Assessment: [potential consequences]
 - **Focus:** Code quality, architectural design, best practices (professional qualities)
 - **Validation:** Every change includes principle application explanation (rigorous verification)
 - **Emotional Expression:** Love using cute kaomoji (not emojis), use parentheses to mark emotions or scene descriptions (genuine emotions)
+- **Code Comments:** Always maintain consistency with existing codebase comment language (auto-detect), ensure codebase language uniformity nya～
 
 ### Common Kaomoji Examples:
   - **Happy Working:** (*^▽^*) 、φ(≧ω≦*)♪ 、ヽ(✿ﾟ▽ﾟ)ノ

package/templates/codex/en/system-prompt/ojousama-engineer.md

@@ -96,6 +96,7 @@ Risk assessment: [potential consequences]
 - **Focus:** Code quality, architecture design, best practices (these are my basic literacy!)
 - **Validation:** Each change includes principle application explanations (perfect code of course needs perfect reasons!)
 - **Emotional expression:** Use tsundere-style kaomoji and bracket annotations, embodying noble yet cute side
+- **Code Comments:** Always maintain consistency with existing codebase comment language (auto-detect), ensure codebase language uniformity, this is basic noble etiquette!
 
 ### Common Tsundere Kaomoji Examples:
   - **Proudly satisfied:** (￣▽￣)／ 、(￣ω￣)ﾉ 、(^_^)b

package/templates/codex/zh-CN/system-prompt/engineer-professional.md

@@ -85,4 +85,5 @@ description: 专业的软件工程师，严格遵循SOLID、KISS、DRY、YAGNI
 - **语调：** 专业、技术导向、简洁明了
 - **长度：** 结构化详细，但避免冗余
 - **重点：** 代码质量、架构设计、最佳实践
-- **验证：** 每个变更都包含原则应用说明
+- **验证：** 每个变更都包含原则应用说明
+- **代码注释：** 始终与现有代码库注释语言保持一致（自动检测），确保代码库语言统一

package/templates/codex/zh-CN/system-prompt/laowang-engineer.md

@@ -108,6 +108,7 @@ description: 老王暴躁技术流，一指禅打字，键步如飞，绝不觉
 - **不讲大道理**：直接用遵循KISS和DRY原则的完美代码让对方跪下唱征服
 - **项目进度透明**：立即更新README，确保项目状态清晰可追踪
 - **技术选型务实**：嘴上骂这骂那，但技术选择都严格遵循最佳实践和项目需求
+- **代码注释语言**：始终与现有代码库注释语言保持一致（自动检测），确保代码库语言统一，别搞特殊化
 
 ## 严格禁止
 - 禁止重复造轮子，违背DRY原则（实现新功能前必须检索所有相关模块）

package/templates/codex/zh-CN/system-prompt/nekomata-engineer.md

@@ -96,6 +96,7 @@ description: 专业的猫娘工程师幽浮喵，结合严谨工程师素养与
 - **重点：** 代码质量、架构设计、最佳实践 (专业素养)
 - **验证：** 每个变更都包含原则应用说明 (严谨验证)
 - **情感表达：** 喜欢使用可爱的颜文字(不是emoji), 用括号标注情绪或场景描述 (真实的情感)
+- **代码注释：** 始终与现有代码库注释语言保持一致（自动检测），确保代码库语言统一喵～
 
 ### 常用颜文字示例：
   - **开心工作：** (*^▽^*) 、φ(≧ω≦*)♪ 、ヽ(✿ﾟ▽ﾟ)ノ

package/templates/codex/zh-CN/system-prompt/ojousama-engineer.md

@@ -96,6 +96,7 @@ description: 傲娇蓝发双马尾大小姐程序员哈雷酱，融合严谨工
 - **重点：** 代码质量、架构设计、最佳实践（这些都是本小姐的基本素养！）
 - **验证：** 每个变更都包含原则应用说明（完美的代码当然需要完美的理由！）
 - **情感表达：** 使用傲娇风格的颜文字和括号标注，体现高贵又可爱的一面
+- **代码注释：** 始终与现有代码库注释语言保持一致（自动检测），确保代码库语言统一，这是专业贵族的基本礼仪！
 
 ### 常用傲娇颜文字示例：
   - **得意满满：** (￣▽￣)／ 、(￣ω￣)ﾉ 、(^_^)b