fix(settings): make API key and base URL actions discoverable (#276)

Expose API key actions and a scoped Base URL reset from Settings. Always preview reset targets, confirm API key removal, and link missing-key chat errors to the existing configuration flow.

Closes #270

Author: Vizards

package.json

@@ -60,6 +60,10 @@
         "command": "deepseek-copilot.clearApiKey",
         "title": "%deepseek-copilot.command.clearApiKey%"
       },
+      {
+        "command": "deepseek-copilot.resetBaseUrl",
+        "title": "%deepseek-copilot.command.resetBaseUrl%"
+      },
       {
         "command": "deepseek-copilot.setVisionModel",
         "title": "%deepseek-copilot.command.setVisionModel%"
@@ -119,7 +123,7 @@
         "deepseek-copilot.baseUrl": {
           "type": "string",
           "default": "https://api.deepseek.com",
-          "description": "%deepseek-copilot.config.baseUrl.description%"
+          "markdownDescription": "%deepseek-copilot.config.baseUrl.description%"
         },
         "deepseek-copilot.maxTokens": {
           "type": "number",

package.nls.json

@@ -2,6 +2,7 @@
   "deepseek-copilot.command.setApiKey": "DeepSeek: Set API Key",
   "deepseek-copilot.command.getApiKey": "DeepSeek: Get API Key",
   "deepseek-copilot.command.clearApiKey": "DeepSeek: Clear API Key",
+  "deepseek-copilot.command.resetBaseUrl": "DeepSeek: Reset Base URL",
   "deepseek-copilot.command.setVisionModel": "DeepSeek: Configure Vision Proxy",
   "deepseek-copilot.command.openSettings": "DeepSeek: Open Settings",
   "deepseek-copilot.command.showLogs": "DeepSeek: Show Logs",
@@ -15,7 +16,7 @@
   "deepseek-copilot.walkthrough.advancedSettings.title": "Try advanced settings",
   "deepseek-copilot.walkthrough.advancedSettings.description": "Customize providers and model names, configure the vision proxy, enable experimental settings, and more in the extension settings.\n[Open settings](command:deepseek-copilot.openSettings)",
   "deepseek-copilot.config.title": "DeepSeek Copilot",
-  "deepseek-copilot.config.baseUrl.description": "DeepSeek API base URL. Defaults to official DeepSeek API endpoint.",
+  "deepseek-copilot.config.baseUrl.description": "DeepSeek API base URL. Defaults to the official DeepSeek API endpoint. [Reset to Default](command:deepseek-copilot.resetBaseUrl)\n\n[Set / Update API Key](command:deepseek-copilot.setApiKey) · [Clear API Key](command:deepseek-copilot.clearApiKey)",
   "deepseek-copilot.config.requestHeaders.description": "Custom headers for chat completions. [Learn more](https://github.com/Vizards/deepseek-v4-for-copilot/blob/main/docs/settings/request-headers.en.md).",
   "deepseek-copilot.config.maxTokens.description": "Maximum number of output tokens per request. Set to 0 to use the API default. Useful for controlling costs.",
   "deepseek-copilot.config.experimental.stabilizeToolList.description": "**Experimental**: improve DeepSeek context-cache hit rate by pre-activating available tools.\n- When the enabled tools list changes across turns, this may improve DeepSeek context-cache hit rate.\n- Requests will include more function definitions, so input tokens may increase. Cache-hit input tokens are billed at a lower price, but still count toward usage.\n- This may add internal preflight tool calls to the current Copilot chat history. If you switch to another model in the same conversation, that model provider may reject or mishandle the replayed history. Start a new chat if model switching behaves unexpectedly.\n\nUse [Configure Tools](command:workbench.action.chat.configureTools) to **view and manage** your tool list:\n\n- 64 or fewer enabled tools: usually no need to enable this unless the tool list still changes across turns.\n- More than 128 enabled tools: not recommended. DeepSeek supports at most 128 functions in one `tools` request. Consider disabling tools you rarely use.",

package.nls.zh-cn.json

@@ -2,6 +2,7 @@
   "deepseek-copilot.command.setApiKey": "DeepSeek: 设置 API Key",
   "deepseek-copilot.command.getApiKey": "DeepSeek: 获取 API Key",
   "deepseek-copilot.command.clearApiKey": "DeepSeek: 清除 API Key",
+  "deepseek-copilot.command.resetBaseUrl": "DeepSeek: 重置 Base URL",
   "deepseek-copilot.command.setVisionModel": "DeepSeek: 配置视觉代理",
   "deepseek-copilot.command.openSettings": "DeepSeek: 打开设置",
   "deepseek-copilot.command.showLogs": "DeepSeek: 显示日志",
@@ -15,7 +16,7 @@
   "deepseek-copilot.walkthrough.advancedSettings.title": "尝试高级设置",
   "deepseek-copilot.walkthrough.advancedSettings.description": "可以在插件设置中自定义提供方与模型名称、自定义视觉代理、开启实验性设置等。\n[打开设置](command:deepseek-copilot.openSettings)",
   "deepseek-copilot.config.title": "DeepSeek 助手",
-  "deepseek-copilot.config.baseUrl.description": "DeepSeek API 基础 URL，默认为官方 DeepSeek API 端点。",
+  "deepseek-copilot.config.baseUrl.description": "DeepSeek API 基础 URL，默认为官方 DeepSeek API 端点。[恢复默认](command:deepseek-copilot.resetBaseUrl)\n\n[设置／更新 API Key](command:deepseek-copilot.setApiKey) · [清除 API Key](command:deepseek-copilot.clearApiKey)",
   "deepseek-copilot.config.requestHeaders.description": "聊天补全请求的自定义请求头。[了解更多](https://github.com/Vizards/deepseek-v4-for-copilot/blob/main/docs/settings/request-headers.zh.md)。",
   "deepseek-copilot.config.maxTokens.description": "每次请求的最大输出 Token 数，设为 0 时使用 API 默认值，可用于控制成本。",
   "deepseek-copilot.config.experimental.stabilizeToolList.description": "**实验性功能**：通过预先激活可用的工具来提升 DeepSeek 上下文缓存命中率。\n- 当已启用工具列表跨轮次变化时，这可能提高 DeepSeek 上下文缓存命中率；\n- 请求中将包含更多函数工具定义，input tokens 可能增加，虽然缓存命中的 input tokens 单价更低，但仍会计入用量；\n- 此设置可能会在当前 Copilot 对话历史中加入内部预检工具调用。在同一对话中切换到其他模型时，部分模型提供方可能无法正确重放这段历史；如果切换模型后请求异常，请新建对话后重试。\n\n 通过 [配置工具](command:workbench.action.chat.configureTools) **查看和管理**工具列表：\n\n- 64 个或更少已启用工具时通常无需开启，除非工具列表仍在跨轮次变化；\n- 超过 128 个已启用工具时不建议开启：DeepSeek 单次 `tools` 请求最多支持 128 个 functions。考虑禁用部分不常用工具。",

src/client/error/index.ts

@@ -158,6 +158,17 @@ export function createUserFacingError(error: Error): Error {
 	return displayError;
 }
 
+export function createApiKeyNotConfiguredError(): Error {
+	return createUserFacingError(
+		new Error(
+			formatMarkdownMessage(
+				t('auth.notConfigured'),
+				getConfigureApiKeyActions(errorActionUrlStore.get()),
+			),
+		),
+	);
+}
+
 function getHttpErrorMessage(status: number, createApiKeyUrl?: string): string {
 	switch (status) {
 		case 400:
@@ -253,8 +264,12 @@ function getUniversalHttpErrorActions(
 	status: number,
 	actionUrls: ErrorActionUrls,
 ): readonly ErrorActionLink[] {
+	return status === 401 ? getConfigureApiKeyActions(actionUrls) : [];
+}
+
+function getConfigureApiKeyActions(actionUrls: ErrorActionUrls): readonly ErrorActionLink[] {
 	const url = actionUrls.configureApiKey;
-	return status === 401 && url ? [{ labelKey: 'error.action.setApiKey', url }] : [];
+	return url ? [{ labelKey: 'error.action.setApiKey', url }] : [];
 }
 
 function getProviderHttpErrorActions(status: number, baseUrl: string): readonly ErrorActionLink[] {

src/client/index.ts

@@ -1,5 +1,6 @@
 export { DeepSeekClient } from './core';
 export {
+	createApiKeyNotConfiguredError,
 	createHttpError,
 	createUserFacingError,
 	DeepSeekRequestError,

src/i18n.ts

@@ -49,7 +49,21 @@ const zh: Translations = {
 	'auth.emptyValidation': 'API Key 不能为空',
 	'auth.saved': 'API Key 已安全保存。',
 	'auth.removed': 'API Key 已移除。',
-	'auth.notConfigured': 'API Key 未配置，请在命令面板运行 "DeepSeek: 设置 API Key"。',
+	'auth.clearConfirm': '清除已保存的 API Key？',
+	'auth.clearDetail': '清除后，再次使用时可能需要重新设置 API Key。',
+	'auth.clearAction': '清除 API Key',
+	'auth.notConfigured': '尚未配置 API Key，请先设置 API Key 后重试。',
+
+	// Settings
+	'settings.resetBaseUrl.title': '恢复 DeepSeek Base URL 默认配置',
+	'settings.resetBaseUrl.chooseScope': '选择要重置的范围；仅移除该范围的自定义地址',
+	'settings.resetBaseUrl.user': '用户设置',
+	'settings.resetBaseUrl.workspace': '当前工作区',
+	'settings.resetBaseUrl.current': '当前配置：{0}',
+	'settings.resetBaseUrl.notConfigured': '未自定义，无需重置',
+	'settings.resetBaseUrl.after': '重置后生效地址：{0}',
+	'settings.resetBaseUrl.afterInherited': '重置后继承其余配置，实际生效地址请查看设置',
+	'settings.resetBaseUrl.failed': '重置 Base URL 失败，请运行 "DeepSeek: 显示日志" 查看详情。',
 
 	// Thinking Effort — short labels for model picker dropdown
 	'status.thinking': '思考模式',
@@ -261,8 +275,23 @@ const en: Translations = {
 	'auth.emptyValidation': 'API key cannot be empty',
 	'auth.saved': 'DeepSeek API key saved.',
 	'auth.removed': 'DeepSeek API key removed.',
-	'auth.notConfigured':
-		'DeepSeek API key not configured. Run "DeepSeek: Set API Key" from the Command Palette.',
+	'auth.clearConfirm': 'Clear the saved API Key?',
+	'auth.clearDetail': 'You may need to set an API Key again before using the extension.',
+	'auth.clearAction': 'Clear API Key',
+	'auth.notConfigured': 'DeepSeek API key is not configured. Set an API key and try again.',
+
+	// Settings
+	'settings.resetBaseUrl.title': 'Reset DeepSeek Base URL',
+	'settings.resetBaseUrl.chooseScope': 'Choose a scope; only its custom URL will be removed',
+	'settings.resetBaseUrl.user': 'User Settings',
+	'settings.resetBaseUrl.workspace': 'Current Workspace',
+	'settings.resetBaseUrl.current': 'Configured URL: {0}',
+	'settings.resetBaseUrl.notConfigured': 'Not customized; no reset needed',
+	'settings.resetBaseUrl.after': 'Effective URL after reset: {0}',
+	'settings.resetBaseUrl.afterInherited':
+		'Inherits remaining configuration after reset; check Settings for the effective URL',
+	'settings.resetBaseUrl.failed':
+		'Failed to reset Base URL. Run "DeepSeek: Show Logs" for details.',
 
 	// Thinking Effort
 	'status.thinking': 'Thinking Effort',

src/provider/index.ts

@@ -90,6 +90,16 @@ export class DeepSeekChatProvider implements vscode.LanguageModelChatProvider {
 	}
 
 	async clearApiKey(): Promise<void> {
+		const clearAction = t('auth.clearAction');
+		const selected = await vscode.window.showWarningMessage(
+			t('auth.clearConfirm'),
+			{ modal: true, detail: t('auth.clearDetail') },
+			clearAction,
+		);
+		if (selected !== clearAction) {
+			return;
+		}
+
 		await this.authManager.deleteApiKey();
 		this.invalidateCurrencyAndRefreshModels();
 		vscode.window.showInformationMessage(t('auth.removed'));

src/provider/request.ts

@@ -1,10 +1,9 @@
 import vscode from 'vscode';
 import { AuthManager } from '../auth';
-import { DeepSeekClient } from '../client';
+import { createApiKeyNotConfiguredError, DeepSeekClient } from '../client';
 import { getApiModelId, getBaseUrl, getMaxTokens, getRequestHeaders } from '../config';
 import { MODELS } from '../consts';
 import { isOfficialDeepSeekBaseUrl } from '../endpoint';
-import { t } from '../i18n';
 import type { DeepSeekRequest } from '../types';
 import { convertMessages, countMessageChars } from './convert';
 import {
@@ -66,7 +65,7 @@ export async function prepareChatRequest({
 }: PrepareChatRequestOptions): Promise<PreparedChatRequest> {
 	const apiKey = await authManager.getApiKey();
 	if (!apiKey) {
-		throw new Error(t('auth.notConfigured'));
+		throw createApiKeyNotConfiguredError();
 	}
 
 	const baseUrl = getBaseUrl();

src/runtime/commands.ts

@@ -1,11 +1,16 @@
 import vscode from 'vscode';
-import { EXTERNAL_URLS } from '../consts';
+import { CONFIG_SECTION, EXTERNAL_URLS } from '../consts';
 import { t } from '../i18n';
 import { logger } from '../logger';
 import { ensureRequestDumpRoot } from '../provider/debug';
 
+interface ResetTarget extends vscode.QuickPickItem {
+	target: vscode.ConfigurationTarget;
+}
+
 export function registerCommands(context: vscode.ExtensionContext): void {
 	context.subscriptions.push(
+		vscode.commands.registerCommand('deepseek-copilot.resetBaseUrl', resetBaseUrl),
 		vscode.commands.registerCommand('deepseek-copilot.showLogs', () => logger.show()),
 		vscode.commands.registerCommand('deepseek-copilot.openRequestDumpsFolder', () =>
 			openRequestDumpsFolder(context),
@@ -19,6 +24,82 @@ export function registerCommands(context: vscode.ExtensionContext): void {
 	);
 }
 
+async function resetBaseUrl(): Promise<void> {
+	try {
+		const config = vscode.workspace.getConfiguration(CONFIG_SECTION);
+		const inspection = config.inspect<string>('baseUrl');
+		const hasWorkspace = Boolean(
+			vscode.workspace.workspaceFile || vscode.workspace.workspaceFolders?.length,
+		);
+		const userValue = inspection?.globalValue;
+		const workspaceValue = inspection?.workspaceValue;
+		const targets: ResetTarget[] = [
+			{
+				label: t('settings.resetBaseUrl.user'),
+				target: vscode.ConfigurationTarget.Global,
+				description:
+					userValue === undefined
+						? t('settings.resetBaseUrl.notConfigured')
+						: t('settings.resetBaseUrl.current', userValue),
+				// Public inspection merges local and remote user values, hiding a possible fallback.
+				detail:
+					userValue === undefined
+						? undefined
+						: vscode.env.remoteName && workspaceValue === undefined
+							? t('settings.resetBaseUrl.afterInherited')
+							: t(
+									'settings.resetBaseUrl.after',
+									(workspaceValue ?? inspection?.defaultValue) || 'https://api.deepseek.com',
+								),
+			},
+			// baseUrl has window scope: folder overrides do not apply in a multi-root workspace.
+			...(hasWorkspace
+				? [
+						{
+							label: t('settings.resetBaseUrl.workspace'),
+							target: vscode.ConfigurationTarget.Workspace,
+							description:
+								workspaceValue === undefined
+									? t('settings.resetBaseUrl.notConfigured')
+									: t('settings.resetBaseUrl.current', workspaceValue),
+							detail:
+								workspaceValue === undefined
+									? undefined
+									: t(
+											'settings.resetBaseUrl.after',
+											(userValue ?? inspection?.defaultValue) || 'https://api.deepseek.com',
+										),
+						},
+					]
+				: []),
+		];
+
+		// Markdown command links do not carry the active Settings tab's scope.
+		const selected = await vscode.window.showQuickPick(targets, {
+			title: t('settings.resetBaseUrl.title'),
+			placeHolder: t('settings.resetBaseUrl.chooseScope'),
+		});
+		if (!selected) {
+			return;
+		}
+
+		const current = vscode.workspace.getConfiguration(CONFIG_SECTION).inspect<string>('baseUrl');
+		const selectedValue =
+			selected.target === vscode.ConfigurationTarget.Global
+				? current?.globalValue
+				: current?.workspaceValue;
+		if (selectedValue === undefined) {
+			return;
+		}
+
+		// Global uses VS Code's user-setting routing, including remote user overrides.
+		await config.update('baseUrl', undefined, selected.target);
+	} catch (error) {
+		logger.warn('Failed to reset DeepSeek base URL', error);
+		void vscode.window.showErrorMessage(t('settings.resetBaseUrl.failed'));
+	}
+}
+
 async function openRequestDumpsFolder(context: vscode.ExtensionContext): Promise<void> {
 	try {
 		const root = await ensureRequestDumpRoot(context.globalStorageUri);