@deepseek-ai/dsh-tool-web 0.1.5-rc.2 → 0.1.6-alpha.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.i18n.yaml CHANGED
@@ -3,4 +3,4 @@
3
3
  # after editing either side, bring the other along and re-record with:
4
4
  # pnpm run verify-translation-pairing --write packages/web/tool-web/README.md
5
5
  README.md: 33ed07491928e310010f3555f510b5c4fccd1fbc
6
- README.zh.md: 8bad7503553c25fc4bb2ae05fd6c8377b9f2ed01
6
+ README.zh.md: ae67cd1e3abe31652e2d93dc17499dcda662b73f
package/README.zh.md CHANGED
@@ -9,7 +9,7 @@ kind: "package-reference"
9
9
 
10
10
  ## 概述
11
11
 
12
- `dsh-tool-web` 让模型使用 `web_search` 搜索 web,并使用 `web_fetch` 取回页面。当 agent 需要当前信息或完整来源文本时选择它,并通过包配置独立启用任一工具。结果会把提供方控制的文本标记为外部不可信数据,而抓取到的 HTML 会排除活动与隐藏内容。如果配置的提供方缺失或不可用,工具仍保持可见,并返回模型可据此采取行动的结构化错误。超时与结果大小上限属于部署设置,而非模型参数。
12
+ `dsh-tool-web` 让模型使用 `web_search` 搜索 web,并使用 `web_fetch` 取回页面。当 agent(智能体)需要当前信息或完整来源文本时选择它,并通过包配置独立启用任一工具。结果会把提供方控制的文本标记为外部不可信数据,而抓取到的 HTML 会排除活动与隐藏内容。如果配置的提供方缺失或不可用,工具仍保持可见,并返回模型可据此采取行动的结构化错误。超时与结果大小上限属于部署设置,而非模型参数。
13
13
 
14
14
  ## 目录
15
15
 
@@ -103,7 +103,7 @@ schema 校验会在执行前拒绝缺失或非数组的 `queries` 字段、非
103
103
  | [`src/index.ts`](src/index.ts) | 插件入口:配置 schema、启用状态、超时预算、工具注册 |
104
104
  | [`src/search.ts`](src/search.ts) | `web_search` 工具:参数校验、查询扇出、合并、格式化、呈现元数据 |
105
105
  | [`src/fetch.ts`](src/fetch.ts) | `web_fetch` 工具:HTML→markdown 转换、输出上限、格式化、呈现元数据 |
106
- | — | 不发布运行时不变式伴生入口;约定在工具处强制执行。 |
106
+ | — | 不发布运行时不变量配套入口;这个面向模型的适配器没有独立的生命周期事件流;执行关系由它调用的能力 seam 负责。 |
107
107
 
108
108
  ### 搜索流程
109
109
 
@@ -248,7 +248,7 @@ schema 校验会在执行前拒绝缺失或非数组的 `queries` 字段以及
248
248
 
249
249
  这些限制说明工具在哪些情况下不完整或需要部署配合。它们是当前包约束。
250
250
 
251
- - **没有覆盖整个批次的原生搜索计数器**:`searchMaxQueries` 限制 `ctx.web.search` 调用数,但提供方可以在每次调用内执行多次原生搜索;例如,配置了 `maxUses` 的模型型提供方最多可以执行 `searchMaxQueries × maxUses` 次原生搜索,`searchMaxResults` 只限制返回给调用方的组合来源。部署通过这些独立的消费方与提供方设置控制成本,因为服务不知道提供方内部的搜索计量单位。
251
+ - **没有覆盖整个批次的原生搜索计数器**:`searchMaxQueries` 限制 `ctx.web.search` 调用数,但提供方可以在每次调用内执行多次原生搜索;例如,配置了 `maxUses` 的以模型为后端的提供方最多可以执行 `searchMaxQueries × maxUses` 次原生搜索,`searchMaxResults` 只限制返回给调用方的组合来源。部署通过这些独立的消费方与提供方设置控制成本,因为服务不知道提供方内部的搜索计量单位。
252
252
  - **HTML→markdown 转换会省略无法安全表示的输入**——[turndown](https://github.com/mixmark-io/turndown) 会通过真实 DOM 转换至多 `fetchMaxOutputChars` 个源字符。512 层嵌套守卫与转换异常会产生固定省略标记,而不是返回原始 HTML;表格 `colspan` 仍不受支持,因为 GFM 无法表示跨列单元格([已归档的依赖决策](../../../.agents/notes/archived/simplification/2026-07-26-turndown-for-tool-web-html-markdown.md))。
253
253
  - **面向模型的接口有意保持精简,后续扩展暂缓**:`max_results` 保持为配置上限(不是模型参数),`web_fetch` 只接受 `url`(没有 `format`/`prompt`/LLM(大语言模型)摘要模式);两项都列为 [seam Agent Note](../../../.agents/notes/implemented/architecture/2026-06-24-web-capability-seam.zh.md) 中的后续步骤。
254
254
  - **公开抓取不请求审批**——随产品交付的 `cordis`、`code` 与 `standard` preset 在所有 sandbox 和审批模式下公开 `web_fetch`。HTTP 提供方会阻止非公开目标,但模型仍可向公开 URL 发送数据。需要逐次确认的部署必须添加 `tools/pre-execute` 策略或禁用抓取。
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@deepseek-ai/dsh-tool-web",
3
3
  "description": "Model-facing web tools (web_search, web_fetch) over the DeepSeek Harness web capability seam (ctx.web)",
4
- "version": "0.1.5-rc.2",
4
+ "version": "0.1.6-alpha.2",
5
5
  "publishConfig": {
6
6
  "access": "public"
7
7
  },
@@ -28,31 +28,31 @@
28
28
  "license": "MIT",
29
29
  "peerDependencies": {
30
30
  "@deepseek-ai/cordis": "^4.0.2",
31
- "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
32
- "@deepseek-ai/dsh-system-prompt": "^0.1.5-rc.2",
33
- "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
34
- "@deepseek-ai/dsh-web": "^0.1.5-rc.2"
31
+ "@deepseek-ai/dsh-llm": "^0.1.6-alpha.2",
32
+ "@deepseek-ai/dsh-system-prompt": "^0.1.6-alpha.2",
33
+ "@deepseek-ai/dsh-tools": "^0.1.6-alpha.2",
34
+ "@deepseek-ai/dsh-web": "^0.1.6-alpha.2"
35
35
  },
36
36
  "dependencies": {
37
37
  "@joplin/turndown-plugin-gfm": "^1.0.67",
38
38
  "turndown": "^7.2.4",
39
- "@deepseek-ai/dsh-util-values": "^0.1.5-rc.2",
39
+ "@deepseek-ai/dsh-util-values": "^0.1.6-alpha.2",
40
40
  "@deepseek-ai/schemastery": "^3.18.2"
41
41
  },
42
42
  "devDependencies": {
43
43
  "@types/turndown": "^5.0.6",
44
44
  "@deepseek-ai/cordis": "^4.0.2",
45
- "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
46
- "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
47
- "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
48
- "@deepseek-ai/dsh-spill-local": "^0.1.5-rc.2",
49
- "@deepseek-ai/dsh-system-prompt": "^0.1.5-rc.2",
50
- "@deepseek-ai/dsh-tool-call-timeout-policy": "^0.1.5-rc.2",
51
- "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
52
- "@deepseek-ai/dsh-web": "^0.1.5-rc.2",
53
- "@deepseek-ai/dsh-web-fetch-http": "^0.1.5-rc.2",
54
- "@deepseek-ai/dsh-scope": "^0.1.5-rc.2",
55
- "@deepseek-ai/dsh-spill-policy": "^0.1.5-rc.2",
56
- "@deepseek-ai/dsh-web-search-exa": "^0.1.5-rc.2"
45
+ "@deepseek-ai/dsh-agent": "^0.1.6-alpha.2",
46
+ "@deepseek-ai/dsh-llm": "^0.1.6-alpha.2",
47
+ "@deepseek-ai/dsh-session": "^0.1.6-alpha.2",
48
+ "@deepseek-ai/dsh-spill-policy": "^0.1.6-alpha.2",
49
+ "@deepseek-ai/dsh-system-prompt": "^0.1.6-alpha.2",
50
+ "@deepseek-ai/dsh-tool-call-timeout-policy": "^0.1.6-alpha.2",
51
+ "@deepseek-ai/dsh-tools": "^0.1.6-alpha.2",
52
+ "@deepseek-ai/dsh-web": "^0.1.6-alpha.2",
53
+ "@deepseek-ai/dsh-web-fetch-http": "^0.1.6-alpha.2",
54
+ "@deepseek-ai/dsh-web-search-exa": "^0.1.6-alpha.2",
55
+ "@deepseek-ai/dsh-scope": "^0.1.6-alpha.2",
56
+ "@deepseek-ai/dsh-spill-local": "^0.1.6-alpha.2"
57
57
  }
58
58
  }