【免费下载链接】denovaAn AI creative platform for novel writing and AI generated RPG, with built-in support for AI agents, Skills, subagent workflows, automations, image generation, and version control.项目地址https://gitcode.com/gh_mirrors/den/denova点击查看免费下载Denova 是一个面向小说写作与 AI 角色扮演游戏的 AI 创作平台它的 Agent 能直接读取项目文件、执行 shell 命令、委派子任务。这篇文章带你完整拆解 Denova 内置工具链中 filesystem、shell 与 task 三大工具组的设计与实现每个工具的输入边界、结果如何压缩回模型上下文、以及权限与恢复机制如何兜底帮助你理解一个生产级 Agent 工具链是怎么搭出来的。一、先看全景内置工具从哪里来所有模型可见的工具都集中在 agent/tool/builtin/ 包中。包注释doc.go用文件命名把职责划分得很清楚文件前缀职责*_tool.go/*_tools.go模型可见的工具定义workspace_*本地工作区适配与搜索行为shell_*命令执行与跨平台进程处理task_*任务委派与本地执行器toolset_*组合并初始化工具集 工具不是零散注册的而是通过 toolset_builders.go 中的Workspace、Shell、Tasks等构建函数按“能力组”打包。例如Workspace会根据访问模式装配read、glob、grep读写模式下再追加write、editShell则按平台自动选择 bash 或 pwsh。每个工具都携带一个由配置摘要计算的稳定Identity用于缓存与能力校验——这是整个工具链可测试、可换实现的基础。二、filesystem 工具read、glob、grep、write、edit 五件套read一个工具多种适配器read的设计很巧妙模型只看到一个工具背后是一组ReadAdapterread_tool.go。本地文本文件、目录结构、甚至图片都通过各自的适配器路由每个适配器自带精确的参数 schema 并在选中后二次校验。结果统一为带行号、分页游标offset/limit/total的有界内容避免大文件撑爆上下文。glob 与 grep发现文件、搜索内容两者定义在 filesystem_search_tools.goglob回答“哪些路径匹配这个模式”一次可传多个文件/目录/glob 模式结果去重并有数量上限支持cursor翻页grep直接使用 ripgrep 语法如rg -n TODO|FIXME agent internal但从不经过 shell——只解析 Denova 支持的rg字面语法杜绝了命令注入风险。两者共享SearchResult结构条目列表 截断标记 下一页游标 警告把本地进程细节挡在模型可见接口之外。write 与 edit可审阅的原子修改写操作通过MutationAdapter注入workspace_mutation_tools.go产品层负责审阅历史、并发控制与结构化回执write整体替换一个文件内容上限 16 MiBedit基于同一份原始快照做多条精确替换old_string/new_string任一匹配失败则整个文件不动保证原子性也支持operationdelete删文件。这就是为什么 Denova 的 Agent 改稿后你能在工作台里逐文件“撤销整组 / 审阅”——变更都是可回放、可审计的结构化操作。三、shell 工具bash 与 pwsh 的受控执行shell 工具定义在 shell_tools.go核心是一个CommandRunner接口本地实现见 shell_local_runner.go。值得学习的设计点结构化状态而非裸错误结果分为success/failed/cancelled/timed_out四类。命令退出码非零是“预期的结构化结果”模型能据此自我修正而不是一次不透明的报错明确的恢复建议失败会附带recovery提示比如超时时建议“缩小命令或显式调大timeout_seconds”输出必有界结果先序列化一个 JSON 信封状态、退出码、工作目录、截断标记剩余预算才给 stdout/stderr超长输出会截断并落为 artifact完整产物文件模型只拿到可读路径和大小安全上限命令正文最大 1 MiB、环境变量 128 项 / 64 KiB可选 PTY 与超时PowerShell 引擎会显式报告是 pwsh 还是 Windows PowerShell 兜底。四、task 工具send、await 与 list_agentstask 工具组定义在 agent_send.go一次send最多携带 32 条操作每条独立成败action作用delegate创建隔离的子 Session Run立即返回message给已有子会话补充上下文不打唤醒followup排队的后续任务steer向正在运行的 Run 注入高优先级指令interrupt/resume在安全边界暂停 / 继续同一 Runabort仅终止指定 Run几个关键约束体现得淋漓尽致回执 ≠ 完成delegate返回 receipt 只表示命令被持久化受理结果通过完成邮箱mailbox自动送达父 Agent 应“继续做独立工作”而不是忙等await 只用于真实依赖task_wait_tool.go 的await等待 1~32 个目标timeout_ms0表示只读一次有界状态就绪指“完成、暂停或交互边界”而非成功冷重启可恢复本地执行器 task_local_executor.go 不维护权威任务表TaskRefagent/session/run足以在进程重启后重新打开子会话并挂回 Run。五、三条贯穿始终的设计哲学边界先行命令 1 MiB、文件 16 MiB、工具结果统一MaxResultBytes有界投影——模型上下文永远不会被单次输出打爆接口即契约ReadAdapter、CommandRunner、MutationAdapter、TaskExecutor都是宿主可替换的接缝工具层只管模型可见语义宿主注入本地或远程实现失败可恢复结构化状态 recovery建议 幂等键idempotency_key让模型和用户都有明确的下一步。想动手体验可以直接阅读 agent/README.md 中“完整组合”示例tools.Workspacetools.Shelltools.Tasks三行代码即可装配出本文拆解的完整工具链。理解这些内置工具的设计也帮你为自己的 Agent 产品设计出同样稳健的工具边界。赞分享【免费下载链接】denovaAn AI creative platform for novel writing and AI generated RPG, with built-in support for AI agents, Skills, subagent workflows, automations, image generation, and version control.项目地址https://gitcode.com/gh_mirrors/den/denova点击查看免费下载相关推荐openJiuwen agent-core DeepAgent 内置工具体系文件系统、Shell、多模态与渐进式工具发现openJiuwen agent core DeepAgent 内置工具体系文件系统、Shell、多模态与渐进式工具发现 本文基于 openJiuwen ag人工智能大模型AI Agent工具调用工作流编排提示工程openJiuwen agent-core 团队生成工具按角色拆分spawn_member 拆分为四个 role 专属工具的架构设计与实现openJiuwen agent core 团队生成工具按角色拆分spawn_member 拆分为四个 role 专属工具的架构设计与实现 导读 本文基于 o人工智能大模型AI Agent工具调用工作流编排提示工程VoltAgent 工具系统实战指南:用 createTool 为 Agent 添加自定义工具、动态工具与 Provider 内置工具VoltAgent 工具系统实战指南:用 createTool 为 Agent 添加自定义工具、动态工具与 Provider 内置工具 本文基于官方配方文档 TAI Agent人工智能大模型RAGAgent 记忆Agent 工作流AI 评测可观测性MCP 服务语音上一篇mbake未来路线图即将推出的7大令人期待的新功能下一篇Docker SDK for Python终极安全指南保护容器环境的10个关键步骤创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
【免费下载链接】denovaAn AI creative platform for novel writing and AI generated RPG, with built-in support for AI agents, Skills, subagent workflows, automations, image generation, and version control.项目地址https://gitcode.com/gh_mirrors/den/denova点击查看免费下载Denova 是一个面向小说写作与 AI 角色扮演游戏的 AI 创作平台它的 Agent 能直接读取项目文件、执行 shell 命令、委派子任务。这篇文章带你完整拆解 Denova 内置工具链中 filesystem、shell 与 task 三大工具组的设计与实现每个工具的输入边界、结果如何压缩回模型上下文、以及权限与恢复机制如何兜底帮助你理解一个生产级 Agent 工具链是怎么搭出来的。一、先看全景内置工具从哪里来所有模型可见的工具都集中在 agent/tool/builtin/ 包中。包注释doc.go用文件命名把职责划分得很清楚文件前缀职责*_tool.go/*_tools.go模型可见的工具定义workspace_*本地工作区适配与搜索行为shell_*命令执行与跨平台进程处理task_*任务委派与本地执行器toolset_*组合并初始化工具集 工具不是零散注册的而是通过 toolset_builders.go 中的Workspace、Shell、Tasks等构建函数按“能力组”打包。例如Workspace会根据访问模式装配read、glob、grep读写模式下再追加write、editShell则按平台自动选择 bash 或 pwsh。每个工具都携带一个由配置摘要计算的稳定Identity用于缓存与能力校验——这是整个工具链可测试、可换实现的基础。二、filesystem 工具read、glob、grep、write、edit 五件套read一个工具多种适配器read的设计很巧妙模型只看到一个工具背后是一组ReadAdapterread_tool.go。本地文本文件、目录结构、甚至图片都通过各自的适配器路由每个适配器自带精确的参数 schema 并在选中后二次校验。结果统一为带行号、分页游标offset/limit/total的有界内容避免大文件撑爆上下文。glob 与 grep发现文件、搜索内容两者定义在 filesystem_search_tools.goglob回答“哪些路径匹配这个模式”一次可传多个文件/目录/glob 模式结果去重并有数量上限支持cursor翻页grep直接使用 ripgrep 语法如rg -n TODO|FIXME agent internal但从不经过 shell——只解析 Denova 支持的rg字面语法杜绝了命令注入风险。两者共享SearchResult结构条目列表 截断标记 下一页游标 警告把本地进程细节挡在模型可见接口之外。write 与 edit可审阅的原子修改写操作通过MutationAdapter注入workspace_mutation_tools.go产品层负责审阅历史、并发控制与结构化回执write整体替换一个文件内容上限 16 MiBedit基于同一份原始快照做多条精确替换old_string/new_string任一匹配失败则整个文件不动保证原子性也支持operationdelete删文件。这就是为什么 Denova 的 Agent 改稿后你能在工作台里逐文件“撤销整组 / 审阅”——变更都是可回放、可审计的结构化操作。三、shell 工具bash 与 pwsh 的受控执行shell 工具定义在 shell_tools.go核心是一个CommandRunner接口本地实现见 shell_local_runner.go。值得学习的设计点结构化状态而非裸错误结果分为success/failed/cancelled/timed_out四类。命令退出码非零是“预期的结构化结果”模型能据此自我修正而不是一次不透明的报错明确的恢复建议失败会附带recovery提示比如超时时建议“缩小命令或显式调大timeout_seconds”输出必有界结果先序列化一个 JSON 信封状态、退出码、工作目录、截断标记剩余预算才给 stdout/stderr超长输出会截断并落为 artifact完整产物文件模型只拿到可读路径和大小安全上限命令正文最大 1 MiB、环境变量 128 项 / 64 KiB可选 PTY 与超时PowerShell 引擎会显式报告是 pwsh 还是 Windows PowerShell 兜底。四、task 工具send、await 与 list_agentstask 工具组定义在 agent_send.go一次send最多携带 32 条操作每条独立成败action作用delegate创建隔离的子 Session Run立即返回message给已有子会话补充上下文不打唤醒followup排队的后续任务steer向正在运行的 Run 注入高优先级指令interrupt/resume在安全边界暂停 / 继续同一 Runabort仅终止指定 Run几个关键约束体现得淋漓尽致回执 ≠ 完成delegate返回 receipt 只表示命令被持久化受理结果通过完成邮箱mailbox自动送达父 Agent 应“继续做独立工作”而不是忙等await 只用于真实依赖task_wait_tool.go 的await等待 1~32 个目标timeout_ms0表示只读一次有界状态就绪指“完成、暂停或交互边界”而非成功冷重启可恢复本地执行器 task_local_executor.go 不维护权威任务表TaskRefagent/session/run足以在进程重启后重新打开子会话并挂回 Run。五、三条贯穿始终的设计哲学边界先行命令 1 MiB、文件 16 MiB、工具结果统一MaxResultBytes有界投影——模型上下文永远不会被单次输出打爆接口即契约ReadAdapter、CommandRunner、MutationAdapter、TaskExecutor都是宿主可替换的接缝工具层只管模型可见语义宿主注入本地或远程实现失败可恢复结构化状态 recovery建议 幂等键idempotency_key让模型和用户都有明确的下一步。想动手体验可以直接阅读 agent/README.md 中“完整组合”示例tools.Workspacetools.Shelltools.Tasks三行代码即可装配出本文拆解的完整工具链。理解这些内置工具的设计也帮你为自己的 Agent 产品设计出同样稳健的工具边界。赞分享【免费下载链接】denovaAn AI creative platform for novel writing and AI generated RPG, with built-in support for AI agents, Skills, subagent workflows, automations, image generation, and version control.项目地址https://gitcode.com/gh_mirrors/den/denova点击查看免费下载相关推荐openJiuwen agent-core DeepAgent 内置工具体系文件系统、Shell、多模态与渐进式工具发现openJiuwen agent core DeepAgent 内置工具体系文件系统、Shell、多模态与渐进式工具发现 本文基于 openJiuwen ag人工智能大模型AI Agent工具调用工作流编排提示工程openJiuwen agent-core 团队生成工具按角色拆分spawn_member 拆分为四个 role 专属工具的架构设计与实现openJiuwen agent core 团队生成工具按角色拆分spawn_member 拆分为四个 role 专属工具的架构设计与实现 导读 本文基于 o人工智能大模型AI Agent工具调用工作流编排提示工程VoltAgent 工具系统实战指南:用 createTool 为 Agent 添加自定义工具、动态工具与 Provider 内置工具VoltAgent 工具系统实战指南:用 createTool 为 Agent 添加自定义工具、动态工具与 Provider 内置工具 本文基于官方配方文档 TAI Agent人工智能大模型RAGAgent 记忆Agent 工作流AI 评测可观测性MCP 服务语音上一篇mbake未来路线图即将推出的7大令人期待的新功能下一篇Docker SDK for Python终极安全指南保护容器环境的10个关键步骤创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
