@klarkxy/dsh-web-search-manager 0.2.5 → 0.3.0

package/README.md

@@ -4,7 +4,7 @@
 
 [简体中文](docs/README.zh-CN.md)
 
-Choose which service answers the model's web searches, set request limits, and let the model read public web pages — all from one settings page.
+Choose which service answers the model's web searches, set request limits, and let the model read public web pages — all from one settings page, with a tab each for search, page reading, and request limits.
 
 ## Install
 
@@ -12,17 +12,21 @@ Choose which service answers the model's web searches, set request limits, and l
 dsh plugin --profile web add @klarkxy/dsh-web-search-manager
 ```
 
-Replace `web` with your profile name, restart DSH Web, and open **Plugins → Web Search**.
+Replace `web` with your profile name, restart DSH Web, and open **Plugins → Web Search**. Restart DSH after plugin updates too; refreshing the page alone does not load updated search code.
 
 ## Set up search
 
-DuckDuckGo works out of the box with no key. You can also enable DeepSeek Search, Exa, Brave, Bocha, Serper, Firecrawl, or Tavily by entering their API keys. Drag the list to set the order; each search uses the first ready service. Search services added by other plugins, such as Zhihu, appear in the same list.
+DuckDuckGo works out of the box with no key. You can also enable DeepSeek Search, Exa, Brave, Bocha, Serper, Firecrawl, Tavily, Perplexity, or You.com by entering their API keys. Drag the list to set the order; each search uses the first ready service. Search services added by other plugins, such as Zhihu, appear in the same list. New services are not enabled automatically.
 
-**Request limits** sets the number of results, queries per call, the total timeout, and the maximum page length.
+The **Settings** tab sets the number of results, queries per call, the total timeout, and the maximum page length.
 
 ## Read web pages
 
-Turn on **Web fetch** to let the model read public pages. By default pages are read through the free Jina Reader, falling back to a direct request if that fails.
+Turn on **Read web pages**, enable the services you want to use, and drag them or use the up/down arrow keys to set their priority. Each fetch uses the first configured, available service. Fetch services connected by other plugins also appear in the list; new services need to be enabled manually. Services that are temporarily unloaded keep their selection and position.
+
+Your previously selected fetch service is kept as the first entry. The bundled **Read web pages** service uses the free Jina Reader, falling back to one direct request if that fails. Services supplied by the host or other plugins use their own fetching method.
+
+You can also enable **Firecrawl** to read Markdown pages with the same API key as Firecrawl search. Search and page reads are billed separately. Newly added services stay outside your priority lists until you enable them. Perplexity uses its Search API without generating answers; You.com returns web and news snippets without requesting extra full-page extraction.
 
 ## Give the tools to the model
 
@@ -36,9 +40,11 @@ The model then gets `web_search` and `web_fetch` while search and fetch are turn
 
 ## Limits
 
-- Paid services may charge for searches; the plugin's counts are not a bill.
-- Fetched page addresses are sent to Jina; do not fetch URLs containing private tokens.
-- Failed searches do not switch to another service automatically.
+- Paid services may charge for search or fetch requests; the plugin's counts are not a bill.
+- When using the bundled Jina Reader, page addresses are sent to Jina; do not fetch URLs containing private tokens.
+- Firecrawl page reads require a page status code and final URL in the service response; missing metadata produces an error. Its page content may come from the service's cache. URLs are sent to the selected fetch service.
+- Failed search or fetch requests do not switch to another service in the list automatically.
+- Cancellation and timeouts ask the active service to stop and wait for it to finish cleaning up. A third-party service that ignores cancellation can delay the result and plugin unloading; the plugin cannot forcibly stop code running inside DSH.
 
 ## License
 

package/docs/README.zh-CN.md

@@ -4,7 +4,7 @@
 
 [English](../README.md)
 
-在一个设置页里选择由哪个服务回答模型的网络搜索、设置请求限制，并让模型读取公开网页。
+在一个设置页里选择由哪个服务回答模型的网络搜索、设置请求限制，并让模型读取公开网页。搜索服务、网页读取和请求限制各占一个页签。
 
 ## 安装
 
@@ -12,17 +12,21 @@
 dsh plugin --profile web add @klarkxy/dsh-web-search-manager
 ```
 
-把 `web` 换成你的 profile 名，重启 DSH Web 后打开「插件 → 网页搜索」。
+把 `web` 换成你的 profile 名，重启 DSH Web 后打开「插件 → 网页搜索」。更新插件后也需要重启 DSH；仅刷新页面不会加载新版搜索代码。
 
 ## 配置搜索
 
-DuckDuckGo 默认可用，无需密钥。也可以填写 API Key 启用 DeepSeek 搜索、Exa、Brave、博查、Serper、Firecrawl 或 Tavily。拖拽列表调整顺序，每次搜索使用第一个就绪的服务。其他插件提供的搜索服务（例如知乎）也会出现在同一列表中。
+DuckDuckGo 默认可用，无需密钥。也可以填写 API Key 启用 DeepSeek 搜索、Exa、Brave、博查、Serper、Firecrawl、Tavily、Perplexity 或 You.com。拖拽列表调整顺序，每次搜索使用第一个就绪的服务。其他插件提供的搜索服务（例如知乎）也会出现在同一列表中。新服务不会自动开启。
 
-「请求限制」用于设置结果条数、每次调用的查询数、总超时和网页正文长度上限。
+「设置」页签用于设置结果条数、每次调用的查询数、总超时和网页正文长度上限。
 
 ## 读取网页
 
-打开「网页读取」后，模型可以读取公开网页。默认通过免费的 Jina Reader 读取，失败时改为直接请求一次。
+打开「网页读取」后，选择参与读取的服务，拖拽或用上下方向键调整优先顺序。每次读取使用第一个已配置且可用的服务；其他插件接入的网页读取服务也会出现在列表中，新服务需要手动开启。暂时未加载的服务会保留原有选择和顺序。
+
+原先选中的读取服务会保留为列表中的首项。内置「网页读取」通过免费的 Jina Reader 读取，失败时改为直接请求一次；如果使用宿主或其他插件的服务，则按该服务的方式读取。
+
+也可以开启 **Firecrawl** 读取 Markdown 网页，与 Firecrawl 搜索共用 API Key；搜索与网页读取分别计费。新增服务需要手动加入优先列表。Perplexity 使用 Search API，不生成回答；You.com 返回网页与新闻摘要，不额外请求全文提取。
 
 ## 让模型使用
 
@@ -37,8 +41,10 @@ DuckDuckGo 默认可用，无需密钥。也可以填写 API Key 启用 DeepSeek
 ## 限制
 
 - 付费服务可能按次收费；插件的计数不是账单。
-- 读取网页时，网址会发送给 Jina，请勿读取包含私密令牌的链接。
-- 搜索失败时不会自动换用其他服务。
+- 使用内置 Jina Reader 时，网址会发送给 Jina，请勿读取包含私密令牌的链接。
+- Firecrawl 网页读取要求服务返回网页状态码和最终网址，缺失时会报错；正文可能来自服务缓存。读取的网址会发送给所选服务。
+- 搜索或网页读取请求失败时，不会自动换用列表中的其他服务。
+- 取消与超时会请求当前服务停止，并等待其完成清理。忽略取消的第三方服务可能延迟结果返回和插件卸载；插件无法强制终止 DSH 进程内运行的代码。
 
 ## 许可证