后备命令处理_add-fallback-commands-北京尧图网络

以下为本文档的中文说明该技能指导开发者如何为VS Code命令面板Command Palette扩展添加后备命令功能实现全面搜索行为。当用户在命令面板中输入的查询无法匹配任何顶层命令时后备命令会被触发使扩展能充当全面处理器。使用场景包括创建公式计算器输入即计算、网页搜索扩展对未匹配的查询直接发起搜索、文件路径打开器直接解析输入为路径、shell命令执行器从搜索栏运行系统命令以及任何需要捕获用户全部输入的场景。核心特点在于其无干扰的触发机制用户无需选择特定扩展或调用特定命令只要输入的查询没有命中其他扩展的顶层命令后备命令就会自动生效。Microsoft官方内置的20个扩展中有14个使用了该机制足以证明其成熟度。工作流程简单清晰用户在命令面板键入查询如果无顶层命令匹配CmdPal向扩展请求后备结果扩展通过FallbackCommands()提供匹配项并显示给用户。核心原则是’最后的匹配者’——后备命令应当处理其他扩展都不处理的搜索查询而非抢在常规命令之前拦截输入。该技能还涵盖如何控制后备命令的触发优先级、如何显示进度反馈以应对耗时的后备查询以及如何避免与现有命令产生冲突的最佳实践。Add Fallback CommandsFallback commands are shown in Command Palette when no other results match the user’s query. They enable your extension to act as a catch-all handler — perfect for calculators, web search, command execution, file path opening, and more.When to Use This SkillAdding search functionality that responds to any user inputCreating a calculator that evaluates expressions as the user typesBuilding a web search that triggers on unmatched queriesOpening files or URLs typed directly into the paletteExecuting shell commands from the search barHow Fallback Commands WorkUser types a query in Command PaletteIf no top-level commands match, CmdPal asks extensions for fallback resultsYour extension’sFallbackCommands()provides items that respond to the queryThe fallback items can be static (always shown) or dynamic (filtered by query)Quick Start: Static FallbackOverrideFallbackCommands()in yourCommandProvider:publicpartialclassMyCommandsProvider:CommandProvider{privatereadonlyICommandItem[]_commands;privatereadonlyFallbackCommandItem[]_fallbacks;publicMyCommandsProvider(){DisplayNameWeb Search;IconnewIconInfo(\\uE721);// Search iconvarsearchPagenewWebSearchPage();_commands[newCommandItem(searchPage){TitleDisplayName}];_fallbacks[newFallbackCommandItem(searchPage){TitleSearch the web}];}publicoverrideICommandItem[]TopLevelCommands()_commands;publicoverrideIFallbackCommandItem[]FallbackCommands()_fallbacks;}Dynamic Fallback with DynamicListPageFor fallbacks that filter results based on the query, useDynamicListPage:internalsealedpartialclassWebSearchPage:DynamicListPage{privatestring_querystring.Empty;publicWebSearchPage(){IconnewIconInfo(\\uE721);TitleWeb Search;NameSearch;PlaceholderTextType to search...;}publicoverridevoidUpdateSearchText(stringoldSearch,stringnewSearch){_querynewSearch;RaiseItemsChanged();}publicoverrideIListItem[]GetItems(){if(string.IsNullOrWhiteSpace(_query))return[];return[newListItem(newOpenUrlCommand($https://www.google.com/search?q{Uri.EscapeDataString(_query)})){Title$Search Google for \\{_query}\\,IconnewIconInfo(\\uE721),},newListItem(newOpenUrlCommand($https://www.bing.com/search?q{Uri.EscapeDataString(_query)})){Title$Search Bing for \\{_query}\\,IconnewIconInfo(\\uE721),},];}}Responsive Fallback with CancellationFor expensive operations (API calls, file searches), use cancellation to stay responsive:internalsealedpartialclassSmartSearchPage:DynamicListPage{privateCancellationTokenSource?_cts;privateIListItem[]_results[];publicoverridevoidUpdateSearchText(stringoldSearch,stringnewSearch){// Cancel any in-flight search_cts?.Cancel();_ctsnewCancellationTokenSource();vartoken_cts.Token;_Task.Run(async(){// Debounce: wait for user to stop typingawaitTask.Delay(300,token);if(token.IsCancellationRequested)return;// Perform search_resultsawaitSearchAsync(newSearch,token);RaiseItemsChanged();},token);}publicoverrideIListItem[]GetItems()_results;privateasyncTaskIListItem[]SearchAsync(stringquery,CancellationTokentoken){// Your search logic here// Check token.IsCancellationRequested periodicallyreturn[];}}Real-World Examples (from built-in extensions)| Extension | Fallback Behavior ||-----------|------------------||Apps| Search installed applications by name ||Calc| Evaluate mathematical expressions directly ||Shell| Execute command-line commands ||WebSearch| Search the web with configured engine ||Indexer| Open files by path ||TimeDate| Parse time/date queries ||WindowsSettings| Jump to Windows Settings pages ||WinGet| Search WinGet packages ||WindowWalker| Find and switch to open windows |Key PointsFallbackCommands()returnsIFallbackCommandItem[](notICommandItem[])UseFallbackCommandItemwrapper (notCommandItem)Wrap aDynamicListPagefor query-reactive resultsCancel previous searches when new input arrivesKeep fallback responses fast — users expect instant resultsUsePlaceholderTexton your page to guide usersDocumentationExtension samplesExtensibility overview3c:[“ , ,,L3f”,null,{“content”:“$40”,“frontMatter”:{“name”:“add-fallback-commands”,“description”:“Add fallback commands to your Command Palette extension for catch-all search behavior. Use when asked to add search functionality, query matching, direct input handling, calculator-style evaluation, URL opening, command execution, or results that appear when no other extension matches. Used by 14 of 20 built-in extensions.”}}]3d:[“KaTeX parse error: Expected }, got EOF at end of input: …,children:[[”,“div”,null,{“className”:“flex items-center justify-between border-b border-border bg-muted/30 px-4 py-2.5”,“children”:[[“KaTeX parse error: Expected }, got EOF at end of input: …,children:[”,“span”,null,{“className”:“truncate text-xs font-medium text-muted-foreground”,“children”:“同仓库更多 Skills”}]}],[“KaTeX parse error: Expected EOF, got } at position 88: …ldren:同仓库}]]}̲],[”,“div”,null,{“className”:“p-4 sm:p-5”,“children”:[[“ , h 2 , n u l l , i d : r e l a t e d − s k i l l s − h e a d i n g , c l a s s N a m e : t e x t − 2 x l f o n t − s e m i b o l d t r a c k i n g − n o r m a l t e x t − f o r e g r o u n d , c h i l d r e n : 同仓库更多 S k i l l s ] , [ ,h2,null,{id:related-skills-heading,className:text-2xl font-semibold tracking-normal text-foreground,children:同仓库更多 Skills}],[,h2,null,id:related−skills−heading,className:text−2xlfont−semiboldtracking−normaltext−foreground,children:同仓库更多Skills],[”,“div”,null,{“className”:“mt-4 grid gap-3 sm:grid-cols-2”,“children”:[“L 41 , L41,L41,L42”,“L 43 , L43,L43,L44”,“L 45 , L45,L45,L46”]}]]}]]}]47:I[206516,[“/_next/static/chunks/051aanbhrv4br.js”,“/_next/static/chunks/0mizr60h7ayzt.js”,“/_next/static/chunks/0v9lm1dmbdoo-.js”,“/_next/static/chunks/0rxr1j1j3j-.r.js”,“/_next/static/chunks/02ftybezfvqjd.js”,“/_next/static/chunks/0.v9ksvnnj8ia.js”,“/_next/static/chunks/0bn6id96nx3k.js,“/_next/static/chunks/13ybnhn37c.tc.js”,“/_next/static/chunks/0_fnrdtruz8uf.js”,“/_next/static/chunks/0r6l15utt1mwb.js”,“/_next/static/chunks/0dm9a5into854.js”,/_next/static/chunks/07k6hqoibtcn.js”,“/next/static/chunks/0b4cao.4y…j.js”,“/_next/static/chunks/02i-n28z7kjd0.js”],“default”]

后备命令处理_add-fallback-commands

相关推荐

3分钟掌握SKkeeper：Blender形状键保护终极方案

【限时公开】国家人工智能标准化总体组内部文档节选：《AI Token参考架构V1.2》核心条款逐条解读（仅剩最后87份授权访问码）

Spring相关的API

更多资讯

文档审查与人员访谈的双重验证技术解析

零基础学黑客技术：从Linux到渗透测试的完整自学路线与靠谱网站推荐

黑客技术实战解析：从社会工程学到内网渗透的完整攻击链

深度学习核心模型全解析：CNN、LSTM、Transformer与实战路线

gpt6实测：3D建模、电路原理图与Codex编码实战全记录

Zookeeper权限机制详解：从ACL认证到服务端校验的完整指南

今日更新

基于高阶循环谱的MPSK载波频率估计与MATLAB实现

MiniPdf方：.NET开源Office转PDF的高效解决方案

Solon AI v3.10：Java全栈智能体开发框架解析

本周精选

AI驱动的自动化专利分析平台技术解析

LeetCode-Go 题解：1252. Cells with Odd Values in a Matrix（奇数值单元格计数）双解法剖析

在线答疑系统Java毕设实战：Spring Boot前后端分离与状态流转

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？