chore(release): 发布 v1.14.1

Author: codertesla

CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.14.1] - 2026-07-11
+### Fixed
+- **Changelog popup**: Toggling the setting applies without reload; when the popup is off, the last-seen version is still tracked so enabling later does not replay stale update notices.
+- **Custom provider errors**: Missing Base URL / Model shows a localized message with an **Open Settings** action instead of a generic failure.
+- **Legacy override migration**: Partial `providerOverrides` entries now merge missing fields from legacy per-provider keys instead of skipping the whole provider.
+- **Auto Push misconfig**: Warn on activate (not only when the setting changes) if Auto Push is on while Auto Commit is off.
+
+### Changed
+- Generate / Set API Key wait for settings migration to finish so upgrades do not briefly use pre-migration defaults.
+
 ## [1.14.0] - 2026-07-10
 ### Changed
 - **Settings reorganization**: Split into **WTF Commit** (basics) and **WTF Commit › Advanced** so everyday options (provider, languages, auto commit/push, confirms) are not buried under prompt/diff/endpoint knobs.

README.md

@@ -64,11 +64,11 @@ Other triggers: ✨ on the Source Control title bar, or Command Palette → **`W
 
 > Prefer review-only? Turn **Auto Commit** off — the message stays in Source Control for you to edit and commit manually.
 
-## 🆕 Latest (v1.14.0)
+## 🆕 Latest (v1.14.1)
 
-- **Simpler settings**: Everyday options live under **WTF Commit**; prompt, endpoints, and diff limits moved to **WTF Commit › Advanced**.
-- **Clearer language names**: **Commit Message Language** (vs UI Language); old `language` / `customLanguage` keys migrate automatically.
-- **One override path**: Built-in provider endpoints use **Provider Overrides** only (legacy per-provider keys migrate on activate).
+- **Smoother settings UX**: Changelog popup reacts without reload; Auto Push misconfig warns on startup.
+- **Clearer Custom setup errors**: Missing Base URL / Model opens Settings instead of a generic failure.
+- **Safer upgrades**: Partial provider overrides merge legacy endpoint fields; generate waits for settings migration.
 
 > See [CHANGELOG](CHANGELOG.md) for earlier releases.
 

README_zh.md

@@ -64,11 +64,11 @@
 
 > 只想生成信息、自己点提交？把 **Auto Commit** 关掉即可。
 
-## 🆕 最新更新（v1.14.0）
+## 🆕 最新更新（v1.14.1）
 
-- **设置更清爽**：日常选项在 **WTF Commit**；Prompt、端点、diff 限制移到 **WTF Commit › Advanced**。
-- **语言命名更清晰**：**Commit Message Language**（与 UI Language 区分）；旧的 `language` / `customLanguage` 会自动迁移。
-- **端点覆盖统一**：内置服务商只走 **Provider Overrides**（遗留的 per-provider key 启动时迁移）。
+- **设置体验更顺**：更新日志弹窗无需重载即可生效；Auto Push 配置不当会在启动时提醒。
+- **Custom 报错更清楚**：缺少 Base URL / Model 时直接引导打开设置，而不是笼统失败。
+- **升级更稳**：部分 Provider Overrides 会补齐遗留端点字段；生成前等待设置迁移完成。
 
 > 更早版本的更新说明请查看 [CHANGELOG](CHANGELOG.md)。
 

package.json

@@ -2,7 +2,7 @@
   "name": "wtf-commit",
   "displayName": "WTF Commit",
   "description": "AI commit messages from your git diff. Conventional Commits, your own API key — DeepSeek, Gemini, OpenAI, and more.",
-  "version": "1.14.0",
+  "version": "1.14.1",
   "license": "MIT",
   "publisher": "codertesla",
   "icon": "icon.png",
@@ -168,7 +168,7 @@
           "wtfCommit.changelogPopup": {
             "type": "boolean",
             "default": false,
-            "description": "Show a notification with a View Changelog action after the extension is updated.",
+            "description": "Show a notification with a View Changelog action after the extension is updated. Takes effect immediately when toggled.",
             "order": 1
           },
           "wtfCommit.warnOnTruncatedDiff": {

src/commands/generate.ts

@@ -10,6 +10,7 @@ import {
 import { readExtensionConfig, getSecretKeyName } from '../config';
 import { resolveRepository, collectStageablePaths } from '../git';
 import { DiffPreparationError, getOptimizedDiff } from '../diff';
+import { IncompleteProviderConfigError } from '../provider-config';
 import { buildProviderEndpoint, callLLM } from '../llm/provider';
 import { classifyPushFailure, formatPushFailureMessage } from '../push-failure';
 import { createStreamingSink, restoreIntent, restoreIntentOnAbort } from '../ui';
@@ -406,6 +407,19 @@ export async function runGenerate(context: vscode.ExtensionContext): Promise<voi
       return;
     }
 
+    if (error instanceof IncompleteProviderConfigError) {
+      const messageKey =
+        error.field === 'baseUrl' ? 'providerBaseUrlMissing' : 'providerModelMissing';
+      const action = await vscode.window.showErrorMessage(
+        t(messageKey, { provider: error.provider }),
+        t('openSettings')
+      );
+      if (action === t('openSettings')) {
+        void vscode.commands.executeCommand('workbench.action.openSettings', 'wtfCommit');
+      }
+      return;
+    }
+
     if (error instanceof RequestFailure) {
       if (error.code === 'cancelled') {
         restoreIntentOnAbort(repositoryForRestore?.inputBox, intentForRestore);

src/extension.ts

@@ -14,7 +14,7 @@ export function activate(context: vscode.ExtensionContext) {
 
   logInfo('Extension activated');
 
-  migrateLegacySettings().catch((error) => {
+  const settingsReady = migrateLegacySettings().catch((error) => {
     logError('Failed to migrate legacy settings', error);
   });
 
@@ -52,23 +52,29 @@ export function activate(context: vscode.ExtensionContext) {
       if (event.affectsConfiguration('wtfCommit.uiLanguage')) {
         syncUiLanguage();
       }
-      if (event.affectsConfiguration('wtfCommit.autoPush')) {
+      if (event.affectsConfiguration('wtfCommit.autoPush') || event.affectsConfiguration('wtfCommit.autoCommit')) {
         void warnIfAutoPushWithoutAutoCommit();
       }
+      if (event.affectsConfiguration('wtfCommit.changelogPopup')) {
+        void syncChangelogTracking(context);
+      }
     })
   );
 
-  maybeShowChangelog(context);
+  void syncChangelogTracking(context);
+  void warnIfAutoPushWithoutAutoCommit();
 
   checkFirstUseGuidance(context).catch((error) => {
     logError('Failed to check first-use guidance', error);
   });
 
   context.subscriptions.push(
     vscode.commands.registerCommand('wtf-commit.setApiKey', async () => {
+      await settingsReady;
       await runSetApiKey(context);
     }),
     vscode.commands.registerCommand('wtf-commit.generate', async () => {
+      await settingsReady;
       await runGenerate(context);
     }),
     vscode.commands.registerCommand('wtf-commit.showOutput', () => {
@@ -107,13 +113,29 @@ async function warnIfAutoPushWithoutAutoCommit(): Promise<void> {
 
 export function deactivate() {}
 
-function maybeShowChangelog(context: vscode.ExtensionContext): void {
-  if (!vscode.workspace.getConfiguration('wtfCommit').get<boolean>('changelogPopup', false)) {
+/**
+ * Track extension version for changelog notices.
+ * When the popup is off, still advance lastVersion so enabling later does not
+ * replay stale update toasts for versions the user already ran.
+ */
+async function syncChangelogTracking(context: vscode.ExtensionContext): Promise<void> {
+  const popupEnabled = vscode.workspace
+    .getConfiguration('wtfCommit')
+    .get<boolean>('changelogPopup', false);
+  if (popupEnabled) {
+    await checkChangelog(context);
     return;
   }
-  checkChangelog(context).catch((error) => {
-    logError('Failed to check changelog', error);
-  });
+  await advanceLastVersionQuietly(context);
+}
+
+async function advanceLastVersionQuietly(context: vscode.ExtensionContext): Promise<void> {
+  const currentVersion = String(context.extension.packageJSON.version);
+  const lastVersion = context.globalState.get<string>('wtfCommit.lastVersion');
+  if (currentVersion === lastVersion) {
+    return;
+  }
+  await context.globalState.update('wtfCommit.lastVersion', currentVersion);
 }
 
 async function checkChangelog(context: vscode.ExtensionContext): Promise<void> {

src/i18n.ts

@@ -58,6 +58,8 @@ export type MessageKey =
   | 'dontRemindMe'
   | 'openSourceControl'
   | 'openSettings'
+  | 'providerBaseUrlMissing'
+  | 'providerModelMissing'
   | 'cancel'
   | 'readyToCommit'
   | 'commit'
@@ -145,6 +147,10 @@ const en: Dictionary = {
   dontRemindMe: "Don't Remind Me",
   openSourceControl: 'Open Source Control',
   openSettings: 'Open Settings',
+  providerBaseUrlMissing:
+    'Base URL is missing for {provider}. Set it under Settings → WTF Commit › Advanced (Custom Base URL, or Provider Overrides for built-ins).',
+  providerModelMissing:
+    'Model is missing for {provider}. Set it under Settings → WTF Commit › Advanced (Custom Model, or Provider Overrides for built-ins).',
   cancel: 'Cancel',
   readyToCommit: 'Ready to commit',
   commit: 'Commit',
@@ -225,6 +231,10 @@ const zh: Dictionary = {
   dontRemindMe: '不再提醒',
   openSourceControl: '打开源代码管理',
   openSettings: '打开设置',
+  providerBaseUrlMissing:
+    '{provider} 缺少 Base URL。请在设置 → WTF Commit › Advanced 中配置（Custom 用 Base URL；内置服务商用 Provider Overrides）。',
+  providerModelMissing:
+    '{provider} 缺少 Model。请在设置 → WTF Commit › Advanced 中配置（Custom 用 Model；内置服务商用 Provider Overrides）。',
   cancel: '取消',
   readyToCommit: '准备提交',
   commit: '提交',

src/provider-config.ts

@@ -8,6 +8,22 @@ export interface ProviderConfigInput {
   customModel?: string;
 }
 
+export type IncompleteProviderField = 'baseUrl' | 'model';
+
+export class IncompleteProviderConfigError extends Error {
+  constructor(
+    public readonly provider: ProviderName,
+    public readonly field: IncompleteProviderField
+  ) {
+    super(
+      field === 'baseUrl'
+        ? `Base URL is missing for ${provider}.`
+        : `Model is missing for ${provider}.`
+    );
+    this.name = 'IncompleteProviderConfigError';
+  }
+}
+
 export function resolveProviderConfig(input: ProviderConfigInput): { baseUrl: string; model: string } {
   const baseUrl = input.providerBaseUrl?.trim()
     || (input.provider === 'Custom' ? input.customBaseUrl?.trim() : undefined)
@@ -17,14 +33,10 @@ export function resolveProviderConfig(input: ProviderConfigInput): { baseUrl: st
     || (input.provider !== 'Custom' ? PROVIDERS[input.provider].model : '');
 
   if (!baseUrl) {
-    throw new Error(
-      `Base URL is missing for ${input.provider}. For Custom, set Base URL under Settings → WTF Commit › Advanced; for built-ins, use Provider Overrides.`
-    );
+    throw new IncompleteProviderConfigError(input.provider, 'baseUrl');
   }
   if (!model) {
-    throw new Error(
-      `Model is missing for ${input.provider}. For Custom, set Model under Settings → WTF Commit › Advanced; for built-ins, use Provider Overrides.`
-    );
+    throw new IncompleteProviderConfigError(input.provider, 'model');
   }
 
   return { baseUrl, model };

src/settings-migrate.ts

@@ -1,6 +1,7 @@
 import * as vscode from 'vscode';
 import { PROVIDER_NAMES } from './types';
 import { logInfo } from './log';
+import { mergeLegacyProviderOverride } from './settings-resolve';
 
 type ProviderOverride = { baseUrl?: string; model?: string };
 type ConfigTarget = vscode.ConfigurationTarget.Global | vscode.ConfigurationTarget.Workspace | vscode.ConfigurationTarget.WorkspaceFolder;
@@ -62,7 +63,10 @@ async function migrateLegacyProviderKeys(config: vscode.WorkspaceConfiguration):
     if (Object.keys(merged.additions).length === 0) {
       continue;
     }
-    const next = { ...merged.existing, ...merged.additions };
+    const next: Record<string, ProviderOverride> = { ...merged.existing };
+    for (const [provider, entry] of Object.entries(merged.additions)) {
+      next[provider] = entry;
+    }
     await config.update('providerOverrides', next, target);
     logInfo(`Migrated legacy per-provider endpoint settings into providerOverrides (${targetLabel(target)})`);
   }
@@ -77,18 +81,12 @@ function collectLegacyOverridesForTarget(
   const additions: Record<string, ProviderOverride> = {};
 
   for (const provider of PROVIDER_NAMES) {
-    if (existing[provider]?.baseUrl || existing[provider]?.model) {
-      continue;
-    }
     const baseUrl = readScopedString(config, `${provider}.baseUrl`, target);
     const model = readScopedString(config, `${provider}.model`, target);
-    if (!baseUrl && !model) {
-      continue;
+    const merged = mergeLegacyProviderOverride(existing[provider], { baseUrl, model });
+    if (merged) {
+      additions[provider] = merged;
     }
-    additions[provider] = {
-      ...(baseUrl ? { baseUrl } : {}),
-      ...(model ? { model } : {}),
-    };
   }
 
   return { existing, additions };

src/settings-resolve.ts

@@ -33,3 +33,31 @@ export function readProviderOverride(
     model: entry?.model?.trim() || undefined,
   };
 }
+
+/**
+ * Merge legacy per-provider fields into an existing override entry.
+ * Only fills missing fields — never overwrites an explicit override value.
+ * Returns undefined when nothing new would be added.
+ */
+export function mergeLegacyProviderOverride(
+  existing: ProviderOverride | undefined,
+  legacy: { baseUrl?: string; model?: string }
+): ProviderOverride | undefined {
+  const baseUrl = legacy.baseUrl?.trim() || undefined;
+  const model = legacy.model?.trim() || undefined;
+  if (!baseUrl && !model) {
+    return undefined;
+  }
+
+  const next: ProviderOverride = { ...(existing || {}) };
+  let changed = false;
+  if (!next.baseUrl && baseUrl) {
+    next.baseUrl = baseUrl;
+    changed = true;
+  }
+  if (!next.model && model) {
+    next.model = model;
+    changed = true;
+  }
+  return changed ? next : undefined;
+}