OpenSearch 描述文档是声明 Web 搜索服务的 XML 文件，需以 UTF-8 编码，根元素为 ，含 ShortName、Description、Url（含 {searchTerms} 占位符）等必需字段，并通过 HTML 标签声明以便浏览器发现。
基本结构与必需字段
XML 必须以 UTF-8 编码，根元素为 <opensearchdescription></opensearchdescription>，并声明命名空间：xmlns="http://a9.com/-/spec/opensearch/1.1/"
必需子元素包括：
- ShortName：≤16 字符的简短名称（如 “MySite Search”）
- Description：≤1024 字符的说明（如 “Search articles on MySite”）
-
Url：含
type和template属性的搜索端点，rel="search"表示默认搜索；支持 {searchTerms} 占位符
Url 元素写法与参数支持
<url></url> 是关键部分，常见写法如下：
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
- GET 请求（最常用）：
<url type="text/html" method="get" template="https://example.com/search?q={searchTerms}"></url> - 支持多个参数（用 & 连接）：
template="https://example.com/s?k={searchTerms}&lang=zh&format=json" - 支持可选占位符：
{searchTerms}（必填）、{language}、{inputEncoding}、{outputEncoding} - 若需 POST 请求，设
method="post"，但多数浏览器仅支持 GET
可选但推荐的增强字段
提升兼容性与体验，建议补充：
-
Image：16×16 或 64×64 PNG 或 ICO 图标（用于地址栏显示）
<image height="16" width="16" type="image/x-icon">https://example.com/favicon.ico</image> - InputEncoding 和 OutputEncoding：明确声明编码（通常为 UTF-8）
-
Tags：空格分隔的关键词（如
<tags>search site example</tags>） - Developer、Contact、Attribution：归属信息（非强制）
完整示例（可直接保存为 opensearch.xml）
<?xml version="1.0" encoding="UTF-8"?>
<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/">
<ShortName>MyBlog Search</ShortName>
<Description>Search posts and tutorials on MyBlog</Description>
<Tags>blog tutorial dev</Tags>
<Contact>admin@myblog.com</Contact>
<Url type="text/html" method="get"
template="https://myblog.com/search?q={searchTerms}&src=os"/>
<InputEncoding>UTF-8</InputEncoding>
<OutputEncoding>UTF-8</OutputEncoding>
<Image height="16" width="16" type="image/x-icon">
https://myblog.com/favicon.ico
</Image>
</OpenSearchDescription>
https://example.com/opensearch.xml），并在网站 HTML 的 <link rel="search" type="application/opensearchdescription+xml" title="MyBlog Search" href="/opensearch.xml"> 声明，浏览器才能自动发现。
不复杂但容易忽略编码声明和 Url template 中的 {searchTerms} 占位符格式。 
