[Bug/反馈] PTC 全量展开 MCP 工具 SDK，缺少渐进披露入口（附 session 实测与 V4 文档勘误）

[VirgilMing]

问题

在当前 master 的内置 MCP + PTC 接入路径上，连接一个提供 46 个工具的 FoxMCP 后，即使当前任务不涉及浏览器，全部 46 个工具的描述、参数及输出类型声明仍会出现在系统提示的 ToolArgsMap / ToolOutputMap 中。模型直接可调用的原生工具虽然只有 run_code，但 MCP 工具的声明文本仍然全部占据上下文。

当前缺少内置的“工具目录／搜索 → 按需取得完整声明 → 激活调用”配置入口。希望该路径也能支持渐进披露，而不是只能在启动时永久裁剪工具。

关联已有提案 #9670、#11718 和激活机制讨论 #9143。本帖补充 PTC 路径的 session 实测，以及当前 master 中一处与实现不一致的 V4 文档说明；仅给 MCP 定义补 deferLoading 并不能处理 PTC 已生成的系统提示文本。

环境与最小配置

• 检查日期：2026-11-02。
• Arch Linux，Node.js v26.13.0，从源码启动 Web profile。
• 仓库及相关包版本：0.2.2-alpha.2。
• 提交：ce7073d51254c26cd63b22a60835b8f948deb447，检查时与上游 master 一致；工作区无修改。
• Provider / model：deepseek-official / deepseek-flash。
• Preset：ptc。
• FoxMCP：Streamable HTTP，tools/list 实测返回 46 个工具。

相关 profile patch：

- insert:
    - id: mcp-foxmcp
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: foxmcp
        transport: streamable-http
        url: http://localhost:3000/mcp

- id: agent-preset-registry
  name: '@deepseek-ai/dsh-agent-preset-registry'
  config:
    default: standard
    selectedDefault: ptc

复现与观测

1. 启动提供多个工具的 MCP server，使用上面的内置 MCP client 配置连接，选择 PTC preset。
2. 开始一个普通文字对话，尚未调用该 MCP server 的工具。
3. 检查 session 日志中的有效 system/message 与 request/header。
4. 在系统提示中搜索 interface ToolArgsMap、interface ToolOutputMap 和 mcp__foxmcp__，与请求头的原生工具列表对照。

本机真实会话日志的聚合结果：

指标	结果
系统提示文本长度	74,107 字符
ToolArgsMap 顶层工具条目	79
其中 mcp__foxmcp__* 条目	46
ToolOutputMap 顶层工具条目	79
其中 mcp__foxmcp__* 条目	46
request/header.header.tools	仅 run_code

这里区分了两个证据：MCP 的 tools/list 只证明服务端提供哪些工具；session 中的系统提示才证明这 46 个工具的声明确实进入了模型上下文。以上数字是字符数与条目数，不把它们当成精确 token 数，也不把常驻上下文等同于每轮全部按未缓存输入计费。

源码路径

以下链接固定到上述提交：

1. MCP 全量发现和注册：遍历 response.tools 构造并注册每个定义。配置 schema 中没有按需发现或延迟模式入口。
2. PTC 的提示生成：describe() 只提供 run_code 的原生 schema，但 tools:sdk 对所有传入定义生成声明。
3. TypeScript SDK 生成：逐项写入描述、参数及输出类型，没有按 deferLoading 延迟生成 SDK 文本的分支。
4. 底层 deferLoading 定义 已存在，但提供方的原生工具延迟加载与 PTC 的系统提示文本披露是不同层，不能假定添加一个标记就解决两者。

PTC README 已说明当前固定开销与可见工具定义数量成正比，因此这里报告的是内置 MCP/PTC 组合的上下文开销及功能缺口，并非声称 README 已承诺渐进披露。

期望行为

希望为内置 MCP client 提供可选的按需发现模式，并让 PTC 的 SDK 提示配合：

• 首轮只暴露轻量目录或搜索入口，未选中的工具不展开完整声明。
• 模型检索并选择工具后，再提供对应参数／输出说明，并使该工具可执行。
• 在同一会话转入浏览器任务时仍可取得完整能力，不要求预先永久禁用工具组。
• 明确 native 与 PTC 两条路径、提供方不支持时的行为，以及工具集变化对前缀缓存的影响。

master 已有 ctx.tools.register(definition, { when }) 条件可见性基础设施，社区也已有 #11709 的插件方案；本报告针对的是内置 MCP + PTC 组合尚无该配置入口。FoxMCP 的启动参数可以静态减少暴露的工具，但无法替代会话内按需发现。

附：V4 文档状态与代码不一致

英文 V4 说明第 102 行 仍写着：

No shipped profile emits developer records; provider serialization, automatic emission and UI support remain deferred.

中文版同处 也保留了对应说明。

至少其中“提供方序列化、自动发出仍未实现”的状态与当前代码不符：

• agent-loop/src/agent.ts 已在工具集合变化时生成 tool-addition / tool-removal，写入 developer/message。
• llm-deepseek/src/serialize.ts 已序列化这两种更新块；同文件第 160–165 行 已发送 defer_loading。

建议同步修正文档中这两部分的实现状态，并明确“底层更新协议已支持”与“内置 MCP/PTC 按需发现入口尚未提供”的区别。