PTC 模式：希望为工具 SDK 提供精简模式（输出类型 / 描述可降级）

[JakeLi168]

PTC 模式：希望为工具 SDK 提供精简模式（输出类型 / 描述可降级）

背景

• 环境：DSH NEXT 桌面壳，内嵌 DSH 0.2.1-rc.4；agent preset 默认 ptc。
• PTC 模式下原生工具 schema 不下发，模型通过系统提示词中的 TypeScript SDK（ToolArgsMap / ToolOutputMap）获取参数名、必填、类型、描述与返回类型。工具少时这个设计很顺。
• 我的实例装的插件较多，工具面到 158 个，系统提示词里的 SDK 段约 187K 字符（≈46.8K token，按 4 字符/token 粗估）。这不是 bug，是规模上来后的成本问题。

实测数据（单实例，时点快照）

项	数值
系统提示词正文	209,142 字符
其中 SDK 段	187,120 字符（≈46.8K token）
参数块 ToolArgsMap	147,536 字符
输出类型 ToolOutputMap	38,835 字符（≈9.7K token，占 SDK 约 21%）

单工具示例（参数块字符数）：task_board_create 4,060、task_board_list 3,385、comfyui_run 2,559、agent_teams_create_task 2,449、de_prompts 2,333。这些大多是低频工具；近两周里 task_board_create 9 次、task_board_list 20 次、agent_teams 多数为 0 次。

关闭两个插件后（ego-browser 35 个工具、web-ui-ssh 6 个工具），系统段从 52.3K 降到约 42.7K，进一步说明工具面是主要变量。

希望的能力（均为 opt-in，不改默认行为）

1. ptc.sdk.outputTypes: "full" | "summary" | "none"（默认 full）
   • summary：保留顶层字段名/类型，嵌套结构折叠为 Record<string, JsonValue> 或注释；
   • none：输出 JsonValue / unknown，并在 SDK 里注明“返回结构以实际结果为准”。
2. ptc.sdk.docs: "full" | "compact"（默认 full）
   • compact 保留首句 + 枚举/格式/大小限制/默认值，去掉叙述、示例与重复协议说明。
3. 可选（可后置）：ptc.sdk.maxChars 预算——超出时优先压缩零调用工具。

取舍说明

• 我理解 typed tool returns 是有意设计（仓库 .agents/notes/implemented/feature/2026-07-20-ptc-typed-tool-returns.md），所以不建议默认删输出类型；建议 opt-in，summary 档保留顶层类型，尽量减少“模型猜返回结构”。
• 如果官方认为输出类型不可省，只做 docs: compact 也有收益（本实例参数块 147K 字符，压缩 20–30% 约 3–5K token）。
• 不建议做“按需加载工具描述”这类大改；先给一个静态开关即可。

环境与统计方法

• 版本：0.2.1-rc.4（app.asar 内 @deepseek-ai/dsh-tools），macOS。
• 统计：读取会话 v4 日志 request/header 的 system 段，按字符数 / 4 估算 token（非精确 tokenizer，仅用于量级比较）。
• 0.2.2 未做代码级比对（本机网络访问 npm/GitHub 受阻），上述数据均来自 0.2.1-rc.4。

附：工具族分布（参数块字符数，不含 ego）

工具族	工具数	参数块字符	近两周调用
核心（bash/read/edit 等）	47	33,973	高频
memory-evolve（de_*）	13	17,142	de_session 70，其余低
task-board	8	15,765	0–24
agent-teams	14	15,252	≤7
mnemon	17	13,622	中频
dsh-browser	13	10,613	browser_call 755
media-kit	6	7,305	2–11
ssh	6	4,171	5
合计	124	117,843	—