Skip to content

工具与权限

Agent 能做什么

Agent 通过工具与你的项目交互。只读操作自动执行,写入和命令操作需要你确认。

能力工具需要你确认
读取文件filesystem_read_file
搜索文件内容filesystem_grep
搜索文件路径filesystem_glob
写入文件filesystem_write_file
编辑文件filesystem_edit
执行命令bash视风险而定
抓取网页webfetch
管理任务列表todo_write
保存/读取/删除记忆memo_*
启动子代理spawn_subagent

通过 MCP 配置注册的外部工具也会出现在列表中,命名空间为 mcp.<server-id>.<tool>。接入方式见 MCP 工具接入

权限审批

当 Agent 请求写入文件或执行命令时,TUI 会弹出确认界面:

text
◆ NEO wants to run: filesystem_write_file
  path: src/main.go
  content: (428 bytes)

  [Allow] [Ask] [Deny]
  • Allow:允许执行,且记住决策——后续相同操作不再询问
  • Ask:每次都询问(默认)
  • Deny:拒绝本次执行

怎么选

你的场景建议
连续重构,已确认安全Allow — 减少打断
阅读未知仓库,先观察Ask — 每次确认
涉及不想改的目录或高风险命令Deny — 直接阻断

Full Access 模式

! 键可以启用 Full Access,跳过所有权限审批。

WARNING

Full Access 会跳过所有审批,包括破坏性操作。确认你了解风险后再启用。

命令风险分类

Bash 命令不是一律审批——NeoCode 会按风险分类处理:

分类示例处理方式
只读git statusgit logls自动放行
本地变更git commitgo build需要确认
远端交互git pushgit fetch需要确认
破坏性git reset --hardrm需要确认
无法判断复合命令、解析失败需要确认

文件操作范围

所有文件操作限制在当前工作区内,路径穿越和符号链接逃逸会被拦截。

下一步

围绕真实命令、配置与主链路整理的 NeoCode 用户指南。