dsh-tinyfish-search v0.1.4 — adapt to deepseek-harness 0.1.2-alpha.3

Adapted to DeepSeek Harness 0.1.2-alpha.3 (master) — devDependencies now pin @deepseek-ai/dsh-web and @deepseek-ai/dsh-llm at 0.1.2-alpha.3, @deepseek-ai/schemastery moves to 3.18.2 (the revision the alpha.3 checkout builds against), and @deepseek-ai/cordis stays at 4.0.2. The ctx.web provider contract is unchanged between 0.1.2-alpha.2 and 0.1.2-alpha.3, so no provider code changes were required; the full test suite passes against the new package set. The request user-agent header now reports dsh-tinyfish-search/0.1.4.

适配 DeepSeek Harness 0.1.2-alpha.3（master） — devDependencies 锁定 @deepseek-ai/dsh-web、@deepseek-ai/dsh-llm 至 0.1.2-alpha.3，@deepseek-ai/schemastery 升至 3.18.2（alpha.3 检出所依赖的版本），@deepseek-ai/cordis 保持 4.0.2。从 0.1.2-alpha.2 到 0.1.2-alpha.3，ctx.web 提供方契约没有变化，因此无需改动提供方代码；全部测试在新区间依赖下通过。请求的 user-agent 归属头现在上报 dsh-tinyfish-search/0.1.4。

v0.1.3 — adapt to deepseek-harness 0.1.2-alpha.2

What's new / 更新内容

Adapted to DeepSeek Harness 0.1.2-alpha.2 / 适配 DeepSeek Harness 0.1.2-alpha.2

• devDependencies now pin @deepseek-ai/dsh-web / @deepseek-ai/dsh-llm at 0.1.2-alpha.2 and @deepseek-ai/cordis at 4.0.2; the @deepseek-ai/dsh-web peer range now starts at 0.1.2-alpha.2 / devDependencies 锁定 @deepseek-ai/dsh-web、@deepseek-ai/dsh-llm 至 0.1.2-alpha.2、@deepseek-ai/cordis 至 4.0.2；@deepseek-ai/dsh-web 的 peer 区间下限升至 0.1.2-alpha.2。
• The ctx.web provider contract (WebSearchProvider / WebSearchRequest / WebSearchResult / WebError) is unchanged in this harness release — no provider code changes required; the full test suite passes against the new package set / 该版 harness 的 ctx.web 提供方契约没有变化，无需改动提供方代码；全部测试在新区间依赖下通过。
• The request user-agent header now reports dsh-tinyfish-search/0.1.3 / 请求 user-agent 头现在上报 dsh-tinyfish-search/0.1.3。

Full details: CHANGELOG.md / 完整说明见 CHANGELOG。

v0.1.2

The bundle patch now ships the documented config scaffolding — bundle patch 现在随包附带文档化的 config 脚手架。

Fixed / 修复

• cordis.patch.yml now carries the documented config block on the dsh-tinyfish-search row (apiKey / apiKeyEnv / baseURL, all commented out — shipped defaults apply until a later layer overrides the row), matching the README "Configure" example. The patch regression test guards it.
• cordis.patch.yml 的 dsh-tinyfish-search 行现在携带 README「配置」一节所示的 config 块（apiKey / apiKeyEnv / baseURL，均为注释示例——在更后层覆盖该行之前均使用默认值），并由 patch 回归测试守护。

Changed / 变更

• The request user-agent attribution header now reports the package version (dsh-tinyfish-search/0.1.2).
• 请求的 user-agent 归属头现在上报包版本（dsh-tinyfish-search/0.1.2）。

Full changelog / 完整更新说明: https://github.com/maxwell-feng/dsh-tinyfish-search/blob/main/CHANGELOG.md
Diff / 变更对比: v0.1.1...v0.1.2

v0.1.0 — dsh-tinyfish-search 首发 / Initial Release

v0.1.0 — dsh-tinyfish-search 首发 / Initial Release

中文

TinyFish 搜索后端插件：把 DeepSeek Harness 内置的 web_search 工具接入 TinyFish Search API。

• 在 web 能力缝（ctx.web）上注册 TinyFish 网页搜索提供方（ID：tinyfish），内置 web_search 改为调用 GET https://api.search.tinyfish.ai，不再走 DeepSeek 的 Anthropic 兼容端点。
• 每次搜索不消耗一次模型调用——纯 REST GET 请求，携带 X-API-Key 头；TinyFish Search 在任意钱包余额下免费。
• 结果归一化（title / snippet / url / date → WebSearchSource），按 URL 去重，并在请求层提前遵守 maxResults 上限。
• 配置（bundle patch 层）：apiKey（secret 角色）、apiKeyEnv（默认 TINYFISH_API_KEY）、baseURL（默认 TinyFish 官方端点）。
• 错误映射遵循缝接口词表：WEB_PROVIDER_CREDENTIAL_MISSING / WEB_PROVIDER_ERROR / WEB_ABORTED。
• 以可安装 bundle 发布（dsh.bundle + cordis.patch.yml）：dsh plugin --profile web add dsh-tinyfish-search
• 8 项单元测试全部通过（node:test，mock fetch）；真实密钥端到端实测通过。
• 安装与配置详见 README（中英双语）。

已知限制

• 目前只透出缝接口的 query / maxResults；TinyFish 的扩展参数（location、language、domain_type、recency_minutes 等）暂未透传。

English

A TinyFish-backed search provider plugin for DeepSeek Harness: reroutes the built-in web_search tool to the TinyFish Search API.

• Registers a TinyFish web search provider (ID: tinyfish) on the web capability seam (ctx.web); the built-in web_search now calls GET https://api.search.tinyfish.ai instead of the DeepSeek Anthropic-compatible endpoint.
• No LLM turn is consumed per search — a plain REST GET with the X-API-Key header; TinyFish Search is free at any wallet balance.
• Normalizes results (title / snippet / url / date → WebSearchSource), dedupes by URL, and honors maxResults early at the request layer.
• Config (bundle patch layer): apiKey (secret role), apiKeyEnv (default TINYFISH_API_KEY), baseURL (default TinyFish canonical endpoint).
• Errors follow the seam vocabulary: WEB_PROVIDER_CREDENTIAL_MISSING / WEB_PROVIDER_ERROR / WEB_ABORTED.
• Ships as an installable bundle (dsh.bundle + cordis.patch.yml): dsh plugin --profile web add dsh-tinyfish-search
• All 8 unit tests pass (node:test, mocked fetch); live end-to-end search verified with a real key.
• Installation and configuration: see the README (bilingual).

Known limitations

• Only the seam's query / maxResults surface is exposed so far; TinyFish extras (location, language, domain_type, recency_minutes, …) are not forwarded yet.