feat(ext): 发布 1.3.0 版本并优化交互体验

- 新增状态栏 `✨ WTF` 快捷按钮，支持一键生成提交信息。
- 新增首次安装引导，提示用户配置 API Key。
- 移除快捷键焦点限制，支持在全局（包括源代码管理面板）触发。
- 升级 `@types/node` 至 18.x，增强 ESLint 类型感知检查规则。
- 优化 `.vscodeignore` 以减小插件安装包体积。

Author: codertesla

.vscodeignore

@@ -1,21 +1,22 @@
-.vscode/**
-.vscode-test/**
+# Source & config (not needed at runtime)
 src/**
-.gitignore
-.yarnrc
-vsc-extension-quickstart.md
+**/*.ts
+**/*.map
 **/tsconfig.json
 **/eslint.config.mjs
-**/*.map
-**/*.ts
 **/.vscode-test.*
 
-# Environment files (contains sensitive data)
+# VS Code development
+.vscode/**
+.vscode-test/**
+
+# Environment files
 .env
 .env.local
+.env.example
 
 # Development files
-.vsix
+*.vsix
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
@@ -27,6 +28,14 @@ pnpm-lock.yaml
 package-lock.json
 yarn.lock
 
-# Documentation & Process
+# Documentation & process (not needed in VSIX)
 UPDATEFLOW.md
+.DS_Store
+.git/**
+.gitignore
+
+# Test output
 out/test/**
+
+# Asset drafts
+assets/icon-drafts/**

CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to the "wtf-commit" extension will be documented in this fil
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.0] - 2025-05-15
+### Added
+- **Status Bar Button**: A persistent `$(sparkle) WTF` button in the status bar for one-click commit message generation — no need to remember the shortcut.
+- **First-Use Guidance**: New users are greeted with a welcome notification prompting them to set up an API key, instead of discovering the requirement only after triggering generation.
+
+### Changed
+- **Keybinding Always Available**: Removed the `editorTextFocus` restriction from `Cmd+Alt+G` / `Ctrl+Alt+G`. The shortcut now works from anywhere — including the Source Control panel.
+- **Node Types Upgraded**: `@types/node` upgraded from `16.x` to `18.x`, matching the VS Code extension host runtime.
+- **Stronger ESLint Rules**: Added `no-explicit-any`, `no-unused-vars`, `consistent-type-imports`, `prefer-const`, `no-console`, and `no-duplicate-imports` rules with type-aware linting.
+- **Cleaner VSIX Package**: `.vscodeignore` now explicitly excludes `.env.example`, `.DS_Store`, `.git/`, and `assets/icon-drafts/`.
+
 ## [1.2.1] - 2025-05-15
 ### Changed
 - **Temperature Default**: Changed default temperature from `0.7` to `1.0`, aligning with recommendations from Gemini, DeepSeek, and other modern model providers.

README.md

@@ -11,12 +11,13 @@ Links: [GitHub](https://github.com/codertesla/wtf-commit) | [Open VSX](https://o
 
 WTF Commit is a minimalist VS Code extension that uses AI to generate concise and meaningful Git commit messages from your staged changes (or working tree changes).
 
-## 🆕 Latest (v1.2.1)
+## 🆕 Latest (v1.3.0)
 
-- **Temperature Default → 1.0**: Aligns with recommendations from Gemini, DeepSeek, and other modern providers.
-- **Removed MiniMax**: Removed from built-in providers. Use Custom provider if needed.
-- **Automatic Retry**: Transient failures (network, 5xx, timeout) now retry up to 2 times with backoff.
-- **Better Error Messages**: Missing config for Custom provider now shows actionable guidance.
+- **Status Bar Button**: Persistent `✨ WTF` button in the status bar — one click to generate.
+- **First-Use Guidance**: Welcome notification guides new users to set up an API key on first install.
+- **Keybinding Always Available**: `Cmd+Alt+G` / `Ctrl+Alt+G` now works from anywhere, including the Source Control panel.
+- **Stronger Linting**: Type-aware ESLint with `consistent-type-imports`, `no-explicit-any`, `prefer-const`, and more.
+- **Node 18 Types**: Upgraded `@types/node` to match the VS Code extension host runtime.
 
 ## 🚀 Features
 

README_zh.md

@@ -11,12 +11,13 @@
 
 WTF Commit 是一款简约的 VS Code 扩展，利用 AI 根据您暂存的更改（或工作区更改）生成简洁且有意义的 Git 提交信息。
 
-## 🆕 最新更新（v1.2.1）
+## 🆕 最新更新（v1.3.0）
 
-- **Temperature 默认值 → 1.0**：与 Gemini、DeepSeek 等主流模型推荐值对齐。
-- **移除 MiniMax**：从内置服务商列表中移除，如需使用可通过 Custom 自定义。
-- **自动重试**：网络错误和瞬时 API 故障（5xx、超时）现在会自动重试最多 2 次，减少偶发失败。
-- **更友好的错误提示**：Custom 服务商缺少配置时，现在会给出具体的设置路径引导。
+- **状态栏按钮**：新增常驻 `✨ WTF` 状态栏按钮，点击即可生成，无需记忆快捷键。
+- **首次使用引导**：新用户首次安装后会收到欢迎通知，引导设置 API Key。
+- **快捷键全局可用**：`Cmd+Alt+G` / `Ctrl+Alt+G` 不再限制于编辑器焦点，在 Source Control 面板等任何位置均可触发。
+- **更强的代码规范**：ESLint 新增 `consistent-type-imports`、`no-explicit-any`、`prefer-const` 等类型感知规则。
+- **Node 18 类型**：`@types/node` 升级至 18.x，与 VS Code 扩展宿主运行时对齐。
 
 ##  功能特性
 

eslint.config.mjs

@@ -1,27 +1,50 @@
 import typescriptEslint from "typescript-eslint";
 
-export default [{
+export default [
+  {
     files: ["**/*.ts"],
-}, {
+    ignores: ["**/test/**"],
+  },
+  {
     plugins: {
-        "@typescript-eslint": typescriptEslint.plugin,
+      "@typescript-eslint": typescriptEslint.plugin,
     },
 
     languageOptions: {
-        parser: typescriptEslint.parser,
-        ecmaVersion: 2022,
-        sourceType: "module",
+      parser: typescriptEslint.parser,
+      ecmaVersion: 2022,
+      sourceType: "module",
+      parserOptions: {
+        projectService: true,
+      },
     },
 
     rules: {
-        "@typescript-eslint/naming-convention": ["warn", {
-            selector: "import",
-            format: ["camelCase", "PascalCase"],
-        }],
+      // Naming
+      "@typescript-eslint/naming-convention": ["warn", {
+        selector: "import",
+        format: ["camelCase", "PascalCase"],
+      }],
 
-        curly: "warn",
-        eqeqeq: "warn",
-        "no-throw-literal": "warn",
-        semi: "warn",
+      // Type safety
+      "@typescript-eslint/no-explicit-any": "warn",
+      "@typescript-eslint/no-unused-vars": ["warn", {
+        argsIgnorePattern: "^_",
+        varsIgnorePattern: "^_",
+      }],
+      "@typescript-eslint/consistent-type-imports": ["warn", {
+        prefer: "type-imports",
+        fixStyle: "inline-type-imports",
+      }],
+
+      // Code quality
+      curly: "warn",
+      eqeqeq: "warn",
+      "no-throw-literal": "warn",
+      semi: "warn",
+      "prefer-const": "warn",
+      "no-console": "warn",
+      "no-duplicate-imports": "warn",
     },
-}];
+  },
+];

package.json

@@ -2,7 +2,7 @@
   "name": "wtf-commit",
   "displayName": "WTF Commit",
   "description": "AI-powered Git commit message generator",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "license": "MIT",
   "publisher": "codertesla",
   "icon": "icon.png",
@@ -47,8 +47,7 @@
       {
         "command": "wtf-commit.generate",
         "key": "ctrl+alt+g",
-        "mac": "cmd+alt+g",
-        "when": "editorTextFocus"
+        "mac": "cmd+alt+g"
       }
     ],
     "configuration": {
@@ -136,7 +135,7 @@
         },
         "wtfCommit.temperature": {
           "type": "number",
-          "default": 1.0,
+          "default": 1,
           "minimum": 0,
           "maximum": 2,
           "description": "Temperature for AI generation. Lower values produce more deterministic results.",
@@ -164,7 +163,7 @@
   },
   "devDependencies": {
     "@types/mocha": "^10.0.10",
-    "@types/node": "16.x",
+    "@types/node": "~18.19.130",
     "@types/vscode": "^1.70.0",
     "@vscode/test-cli": "^0.0.12",
     "@vscode/test-electron": "^2.5.2",

pnpm-lock.yaml

@@ -1,7 +1,7 @@
 import * as vscode from 'vscode';
 import {
-  ExtensionConfig,
-  ProviderName,
+  type ExtensionConfig,
+  type ProviderName,
   PROVIDER_NAMES,
   PROVIDERS,
   DEFAULT_PROVIDER,
@@ -19,12 +19,12 @@ export function readExtensionConfig(): ExtensionConfig {
 
   // 1. Try to read provider-specific overrides
   const overrides = config.get<Record<string, { baseUrl?: string; model?: string }>>('providerOverrides') || {};
-  let providerBaseUrl = overrides[provider]?.baseUrl?.trim() || config.get<string>(`${provider}.baseUrl`)?.trim();
-  let providerModel = overrides[provider]?.model?.trim() || config.get<string>(`${provider}.model`)?.trim();
+  const providerBaseUrl = overrides[provider]?.baseUrl?.trim() || config.get<string>(`${provider}.baseUrl`)?.trim();
+  const providerModel = overrides[provider]?.model?.trim() || config.get<string>(`${provider}.model`)?.trim();
 
   // 2. Try to read global overrides
-  let globalBaseUrl = config.get<string>('baseUrl')?.trim();
-  let globalModel = config.get<string>('model')?.trim();
+  const globalBaseUrl = config.get<string>('baseUrl')?.trim();
+  const globalModel = config.get<string>('model')?.trim();
 
   let baseUrl = providerBaseUrl || globalBaseUrl || '';
   let model = providerModel || globalModel || '';

src/config.ts

@@ -1,9 +1,9 @@
 import * as vscode from 'vscode';
 import * as path from 'path';
 import {
-  Repository,
-  RepositoryState,
-  Change,
+  type Repository,
+  type RepositoryState,
+  type Change,
   GitStatus,
   MAX_DIFF_CHARS,
   MAX_DIFF_FILE_CHARS,

src/diff.ts

@@ -3,7 +3,7 @@ import { promisify } from 'node:util';
 import * as vscode from 'vscode';
 import { 
   PROVIDER_NAMES, 
-  ProviderName, 
+  type ProviderName, 
   RequestFailure, 
   DEFAULT_TIMEOUT_MS,
   type Repository,
@@ -33,10 +33,23 @@ export function activate(context: vscode.ExtensionContext) {
 
   logInfo('Extension activated');
 
+  // Status bar button for quick access
+  const statusBarItem = vscode.window.createStatusBarItem(vscode.StatusBarAlignment.Left, 100);
+  statusBarItem.command = 'wtf-commit.generate';
+  statusBarItem.text = '$(sparkle) WTF';
+  statusBarItem.tooltip = 'WTF Commit: Generate commit message';
+  statusBarItem.show();
+  context.subscriptions.push(statusBarItem);
+
   checkChangelog(context).catch((error) => {
     logError('Failed to check changelog', error);
   });
 
+  // First-use guidance: prompt to set API key if none configured
+  checkFirstUseGuidance(context).catch((error) => {
+    logError('Failed to check first-use guidance', error);
+  });
+
   const setApiKeyDisposable = vscode.commands.registerCommand('wtf-commit.setApiKey', async () => {
     await runSetApiKey(context);
   });
@@ -452,3 +465,34 @@ async function checkChangelog(context: vscode.ExtensionContext): Promise<void> {
 
   await context.globalState.update('wtfCommit.lastVersion', currentVersion);
 }
+
+async function checkFirstUseGuidance(context: vscode.ExtensionContext): Promise<void> {
+  const dismissed = context.globalState.get<boolean>('wtfCommit.guidanceDismissed');
+  if (dismissed) {
+    return;
+  }
+
+  // Check if any provider has an API key configured
+  const hasAnyKey = await Promise.all(
+    PROVIDER_NAMES.map((name) => context.secrets.get(getSecretKeyName(name)))
+  ).then((keys) => keys.some(Boolean));
+
+  if (hasAnyKey) {
+    // User already has at least one key — no guidance needed
+    await context.globalState.update('wtfCommit.guidanceDismissed', true);
+    return;
+  }
+
+  const action = await vscode.window.showInformationMessage(
+    'Welcome to WTF Commit! Set up an API key to start generating commit messages with AI.',
+    'Set API Key',
+    'Dismiss'
+  );
+
+  if (action === 'Set API Key') {
+    void vscode.commands.executeCommand('wtf-commit.setApiKey');
+  }
+
+  // Don't show again regardless of choice
+  await context.globalState.update('wtfCommit.guidanceDismissed', true);
+}