dsh-anchored-standard的Resident目录与按需解锁机制dev_tool_search工具搜索模式完整教程【免费下载链接】dsh-anchored-standardTwo-phase DeepSeek Harness preset: Minimal-aligned bootstrap, then full Standard tools (Project2 98/99)项目地址: https://gitcode.com/gh_mirrors/ds/dsh-anchored-standarddsh-anchored-standard 是一个面向 DeepSeek Harness 的两阶段 agent 预设首条请求用最小的 Minimal 工具对引导会话晋升后进入小型Resident常驻工具目录重型 Standard 工具不再一次性倒出而是通过dev_tool_search按需解锁。本文带你从零理解这套工具搜索模式Resident 目录里有什么、何时晋升、如何用三种模式搜索并解锁工具以及如何验证它真正生效。一、先搞懂什么是 Resident 目录 传统 Standard 预设会把约 25 个工具一次性全部暴露给模型。实测发现晋升时整目录倒出反而会把模型轨迹拉回 standard-like 行为即晋升后回退问题。dsh-anchored-standard 的解法是晋升后只保留一个小型常驻集合其余工具全部藏起来、随取随用。Resident 目录由三部分组成组成工具作用bootstrap 工具对bash、str_replace_editor官方 Minimal 预设的真实工具对全程可见发现工具dev_tool_search、skill_search、skill_load按需解锁的入口已解锁工具模型通过dev_tool_search显式解锁的一切随任务需要动态增长常驻集合的源码定义见 shared/tool-bootstrap.mjs术语解释可查阅 README.zh-CN.md。二、会话两阶段生命周期何时进入 Resident 阶段整个预设的生命周期只有三个阶段变化点新手记住一张图就够了bootstrap 阶段请求 #1模型只看到bashstr_replace_editor两个工具且 AGENTS.md 摘要、技能目录提醒等自动注入全部关闭——这是锚定Minimal 轨迹的关键。晋升promotion默认promoteOn: either即首次持久tool/call或首次assistant/message先到者为准会话立即晋升。resident 阶段请求 #2 起工具目录切换为 Resident 集合标准上下文注入恢复。 两个对新手很实用的细节即使首条回复是纯文字完全不调用工具会话也会在请求 #2 自动晋升不会被困死在 bootstrap 阶段晋升判定基于持久化会话事件重启、恢复会话都不会丢失阶段状态。晋升逻辑实现见 shared/tool-bootstrap.mjs。三、dev_tool_search 三种搜索模式核心教程dev_tool_search是整个按需解锁机制的核心。它的设计很巧妙工具描述本身就是一份能力索引主动告诉模型哪些事你现在做不到、该先来这里搜而不是让模型用 bash 硬凑。完整实现见 shared/dev-tool-search.mjs。模式 1按关键词搜索 —— 用query参数{query: web}搜索范围是完整组装目录包括当前目录里还没有的工具命中的是工具名称 描述首行精确同名匹配排在最前其余按命中词数降序排列最多返回 25 条。模式 2按精确名称解锁 —— 用toolNames参数{toolNames: [web_search]}解锁后的工具从下一个请求起可见且整个会话期间持续有效。这是唯一能让重型工具现身的途径。模式 3搜索 解锁一步到位推荐{query: web, toolNames: [web_search]}一次调用既确认存在又完成解锁省掉一个来回。这正是工具描述中官方给出的示例用法见 shared/dev-tool-search.mjs。⚠️ 搜索结果为空 ≠ 工具不存在这里有个新手最容易踩的坑。早期实现采用所有关键词必须全部命中AND匹配长自然语言查询例如 file edit write replace script root permissions会一条都搜不到。现已改为计分匹配精确名优先命中任一关键词即可上榜。即便如此仍建议用 1–2 个短关键词查询搜索为空但任务明确需要某个工具时直接用toolNames按精确名解锁结果被截断时超过 25 条补充关键词缩小范围。计分排序与空结果提示逻辑见 shared/dev-tool-search.mjs。四、哪些能力可以按需解锁工具描述内嵌了一份解锁索引模型看到任务需要下列任何能力时应优先调dev_tool_search而不是绕过能力可解锁工具联网搜索web_search子代理委派subagent/subagent_fork/list_subagent_models多代理工作流workflow、ralph长期目标create_goal/get_goal/update_goal图片读取read_image后台任务job_list/job_output/job_kill多代理控制interrupt_agent/send_message/list_agents任务跟踪todo_write询问用户ask_user_question完整清单见 shared/dev-tool-search.mjs。五、解锁为什么掉不了线持久化机制 很多工具预设的解锁只存在于内存里会话一恢复就消失。这里的做法更稳每次dev_tool_search解锁都会作为持久tool/call事件的参数写入会话日志组装下一次请求的工具目录时插件扫描全部持久事件把toolNames里的名字重新纳入 keep 集合因此 resume、reload 之后之前解锁的工具原样保留晋升判定本身也是每进程每会话只扫描一次、之后 O(1)。关键实现见 shared/tool-bootstrap.mjs配套的零依赖测试在 test/dev-tool-search.test.mjsnpm test可运行脚本定义见 package.json。六、兄弟工具skill_search 与 skill_load同样的搜索模式也用在技能Skill上预设不再把约 9KB 的技能目录整段注入提示词那会干扰轨迹而是提供两个小工具skill_search按关键词搜技能只返回名称和摘要skill_load按精确名加载单个技能的完整说明注入到下一个请求。三者dev_tool_search/skill_search/skill_load共同构成 Resident 目录的发现层源码见 preset/skill-search.mjs。七、验证 dev_tool_search 是否生效5 个检查点 ✅安装后建议导出会话 JSONL 检查request/header事件按官方复现清单逐项确认首请求的tools数组恰好是[bash, str_replace_editor]首请求消息中无 AGENTS.md 摘要、无技能目录提醒首次工具调用或首次助手回复后下一份 header 出现 Resident 目录bootstrap 对 三个发现工具后续请求保持该 Resident 集只通过dev_tool_search显式解锁才增长标准上下文注入已恢复。完整清单见 README.md 或中文文档 README.zh-CN.md。八、安装与关键配置速查每个模式目录自包含单独复制即可安装将preset/目录复制到~/.dsh/.agent-presets/anchored-standard后重启 DeepSeek Harness新建空会话并选择Anchored Standard (experimental)。新手只需关注两处配置行tool-bootstrap 行晋升与 bootstrap 目录开关preset/agent.cordis.yml ——bootstrapTools、promoteOn、compactionTools等dev-tool-search 行按需解锁入口preset/agent.cordis.yml。其余键的完整说明在 README.zh-CN.md 的配置参考表中。⚠️ 提醒预设与 shell 访问具有相同信任等级安装前请先审阅各模式目录下的.mjs插件文件另外插件不发起任何网络请求、不添加遥测。小结Resident 目录 2 个常驻工具对 3 个发现工具 你解锁的一切dev_tool_search三种模式搜、解、一步到位让重型工具永远一次调用之遥而持久化事件保证解锁跨重启不掉线。理解这套机制后你就可以在保持 Minimal 轨迹优势的同时自由取用 Standard 的完整能力了。【免费下载链接】dsh-anchored-standardTwo-phase DeepSeek Harness preset: Minimal-aligned bootstrap, then full Standard tools (Project2 98/99)项目地址: https://gitcode.com/gh_mirrors/ds/dsh-anchored-standard创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考