dsh-ptc-tool-search

在 PTC 会话里，Harness 往往一次性把大量工具定义塞进 SDK，每一轮对话都要重复携带这些上下文，多轮下来累计输入 token 会迅速膨胀。PTC Tool Search 面向「先少暴露、按需补齐」的场景：新建 PTC Agent 起初只看到 tool_search 与它自带的工具，只有在 run_code 里完成搜索并结束该次调用后，下一轮才会把所选工具的定义写回 SDK，从而在保留完整对话历史的前提下，把「还没用到的工具」从持续计费与注意力成本里挪出去。

核心能力是接入官方 Harness 作用域工具注册表，提供确定性的词面匹配搜索：不联网、不用向量，优先精确可调用名，也支持简短的英文能力关键词。搜索结果是累积的——同一会话里选过的工具会留在当前 Agent 的可见面；重建 Agent、重启或恢复会话则需要重新发现。配置项可控制是否对新 Agent 启用、单次返回条数、查询与描述长度上限；禁用或卸载插件并新建 PTC 会话即可回到完整 SDK 可见性，无需改应用或代理。

README 中的固定四轮工作流重复实测显示，在 GPT 与 Muse 上平均累计输入约可减半，首次请求输入也可大幅下降，但发现会带来额外模型往返，输出 token 与活跃耗时未必同步下降，且未缓存输入可能上升——这些数字用于对比同一模型下的 A/B，并不等同于账单节省。适合在工具目录持续变长、又希望控制 PTC 多轮会话上下文体积的团队与个人；若你依赖一次性全量工具面、或无法接受多一轮发现成本，则更适合保持默认全量 SDK。