尧图网站建设 
如何使用Terax AI代理Plan模式、子代理与TERAX.md项目记忆实战指南【免费下载链接】terax-aiLightweight (7MB) Terminal-first AI-native dev workspace项目地址: https://gitcode.com/GitHub_Trending/te/terax-aiTerax AI 是一个轻量级约 7MB的终端优先 AI 原生开发工作区内置代理式 AI 侧边栏支持 Plan 模式、子代理Subagent和 TERAX.md 项目记忆三大核心能力让你用自带密钥或本地模型安全地指挥 AI 完成多步开发任务。本文将手把手带你上手这三项功能。 一、先认识 Terax AI 的 AI 代理打开 Terax AI 后右侧 AI 侧边栏就是一个完整的编程代理它能读取/搜索代码库在获得你的批准后写入文件、执行命令并支持会话持久化、语音输入和文件附件。它的工具分两类自动执行read_file、list_directory、fs_search、fs_grep等只读工具直接运行需审批write_file、edit、run_command等修改类工具会弹出确认卡片你点确认后才真正执行实现见 tools.ts这意味着 AI 的任何写操作都在你的掌控之下。 二、Plan模式先出方案再动手改Plan模式Plan Mode是处理多步骤任务的安全阀开启后AI 的所有修改不会直接落盘而是进入一个待审队列你可以逐条审查 diff、删除不想要的改动最后一键全部应用。开启与退出 Plan 模式在 AI 输入框Composer中直接输入斜杠命令/plan # 切换开启/关闭 /plan off # 明确退出命令的解析逻辑在 slashCommands.ts 中切换后会弹出 Plan mode on/off 提示。审阅与批量应用开启 Plan 模式后让 AI 干活所有write_file/edit/multi_edit/create_directory操作都会先入队队列定义见 planStore.ts。此时界面会浮出Plan review面板面板支持三种操作操作说明逐条删除移掉不想应用的单个改动Clear All清空整个待审队列Apply All按队列顺序全部写入磁盘审阅面板组件为 PlanDiffReview.tsx每条改动都会显示文件名、新增/删除行数统计方便你快速判断改动规模。 实战建议重构、跨文件改名、批量升级依赖这类高风险多步任务优先开 Plan 模式跑一遍审阅通过再放行。 三、子代理Subagent只读侦察兵子代理是主代理通过run_subagent工具派生的专职小代理各自拥有独立的系统提示词和只读工具白名单最多运行 12 步后即返回精简摘要——既不会误改代码也不会无限消耗 token。Terax AI 内置了 4 个子代理定义见 registry.ts子代理用途适用场景Explore只读代码库探索定位文件、追踪引用、梳理架构Code review代码评审检查正确性、架构、性能、安全问题Security安全审计注入、鉴权绕过、密钥泄漏等General通用研究跨多文件的多步调研所有子代理只能用read_file、list_directory、grep、glob四个只读工具执行器会过滤掉修改类工具并禁止嵌套派生见 runSubagent.ts。使用方式你不需要显式调用直接用自然语言委派即可帮我派一个 Explore 子代理找到所有读取数据库连接串的地方 告诉我文件路径和行号。主代理会调用run_subagent派生对应子代理界面上能看到Spawning explore subagent的步骤标签标签映射见 agent.ts子代理返回带文件路径 行号的简明结论供主代理继续行动。 技巧调研类问题交给子代理主代理上下文不会被大量文件内容占满回答更快、更省。 四、TERAX.md项目级长期记忆TERAX.md是 Terax AI 的项目记忆文件放在工作区根目录作用类似 AGENTS.md / CLAUDE.md每次对话系统会自动读取它并注入系统提示词的## PROJECT — TERAX.md段落加载逻辑见 transport.ts让 AI 始终了解项目背景。几个关键机制大小上限 32 KB超出部分截断所以保持精炼30 秒缓存修改文件后最多 30 秒生效无需重开应用文件不存在时静默跳过不影响使用用 /init 一键生成第一次接触老项目时在输入框输入/initAI 会自动扫描工作区用 grep/glob/文件读取梳理后生成一份不超过 200 行的 TERAX.md内容涵盖项目简介、构建/测试/开发命令、架构总览、命名约定与坑点、入口文件路径生成模板见 slashCommands.ts。写入仍需你审批一次。参考 Terax 项目自己维护的 TERAX.md它既是代理记忆也是活的架构文档记录了质量门槛、架构分层和平台约定——AI 每次改动前都会先读文档输出自然贴合项目规范。 五、三者组合的典型工作流一个推荐的多步任务组合拳/init新项目/老项目接手时生成 TERAX.md建立项目记忆/plan开启 Plan 模式下达大任务例如把 X 模块重构为 Y让主代理派 Explore 子代理先摸清现状再出改动方案在Plan review面板逐条审阅 diff删掉不需要的 hunkApply All放行改动必要时再派Code review / Security 子代理复查/plan off退出进入正常开发节奏这样记忆 规划 侦察 审批四层配合AI 代理既高效又可控。❓ 常见问题速查Plan 模式和审批卡片有什么区别审批卡片是每次写操作都弹Plan 模式则把整个任务的所有修改攒成队列一次性批量审阅、批量放行适合改动多的任务。TERAX.md 和 AGENTS.md 能共存吗Terax 优先读取根目录的TERAX.md作为代理记忆。建议只维护一份避免信息冲突。子代理会改代码吗不会。四个内置子代理都被锁定为只读工具白名单只能读、搜、列目录并返回摘要。更多细节可查阅项目文档 docs/architecture/ai-subsystem.md 与 docs/architecture/security-model.md。【免费下载链接】terax-aiLightweight (7MB) Terminal-first AI-native dev workspace项目地址: https://gitcode.com/GitHub_Trending/te/terax-ai创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何使用Terax AI代理？Plan模式、子代理与TERAX.md项目记忆实战指南
如何使用Terax AI代理Plan模式、子代理与TERAX.md项目记忆实战指南【免费下载链接】terax-aiLightweight (7MB) Terminal-first AI-native dev workspace项目地址: https://gitcode.com/GitHub_Trending/te/terax-aiTerax AI 是一个轻量级约 7MB的终端优先 AI 原生开发工作区内置代理式 AI 侧边栏支持 Plan 模式、子代理Subagent和 TERAX.md 项目记忆三大核心能力让你用自带密钥或本地模型安全地指挥 AI 完成多步开发任务。本文将手把手带你上手这三项功能。 一、先认识 Terax AI 的 AI 代理打开 Terax AI 后右侧 AI 侧边栏就是一个完整的编程代理它能读取/搜索代码库在获得你的批准后写入文件、执行命令并支持会话持久化、语音输入和文件附件。它的工具分两类自动执行read_file、list_directory、fs_search、fs_grep等只读工具直接运行需审批write_file、edit、run_command等修改类工具会弹出确认卡片你点确认后才真正执行实现见 tools.ts这意味着 AI 的任何写操作都在你的掌控之下。 二、Plan模式先出方案再动手改Plan模式Plan Mode是处理多步骤任务的安全阀开启后AI 的所有修改不会直接落盘而是进入一个待审队列你可以逐条审查 diff、删除不想要的改动最后一键全部应用。开启与退出 Plan 模式在 AI 输入框Composer中直接输入斜杠命令/plan # 切换开启/关闭 /plan off # 明确退出命令的解析逻辑在 slashCommands.ts 中切换后会弹出 Plan mode on/off 提示。审阅与批量应用开启 Plan 模式后让 AI 干活所有write_file/edit/multi_edit/create_directory操作都会先入队队列定义见 planStore.ts。此时界面会浮出Plan review面板面板支持三种操作操作说明逐条删除移掉不想应用的单个改动Clear All清空整个待审队列Apply All按队列顺序全部写入磁盘审阅面板组件为 PlanDiffReview.tsx每条改动都会显示文件名、新增/删除行数统计方便你快速判断改动规模。 实战建议重构、跨文件改名、批量升级依赖这类高风险多步任务优先开 Plan 模式跑一遍审阅通过再放行。 三、子代理Subagent只读侦察兵子代理是主代理通过run_subagent工具派生的专职小代理各自拥有独立的系统提示词和只读工具白名单最多运行 12 步后即返回精简摘要——既不会误改代码也不会无限消耗 token。Terax AI 内置了 4 个子代理定义见 registry.ts子代理用途适用场景Explore只读代码库探索定位文件、追踪引用、梳理架构Code review代码评审检查正确性、架构、性能、安全问题Security安全审计注入、鉴权绕过、密钥泄漏等General通用研究跨多文件的多步调研所有子代理只能用read_file、list_directory、grep、glob四个只读工具执行器会过滤掉修改类工具并禁止嵌套派生见 runSubagent.ts。使用方式你不需要显式调用直接用自然语言委派即可帮我派一个 Explore 子代理找到所有读取数据库连接串的地方 告诉我文件路径和行号。主代理会调用run_subagent派生对应子代理界面上能看到Spawning explore subagent的步骤标签标签映射见 agent.ts子代理返回带文件路径 行号的简明结论供主代理继续行动。 技巧调研类问题交给子代理主代理上下文不会被大量文件内容占满回答更快、更省。 四、TERAX.md项目级长期记忆TERAX.md是 Terax AI 的项目记忆文件放在工作区根目录作用类似 AGENTS.md / CLAUDE.md每次对话系统会自动读取它并注入系统提示词的## PROJECT — TERAX.md段落加载逻辑见 transport.ts让 AI 始终了解项目背景。几个关键机制大小上限 32 KB超出部分截断所以保持精炼30 秒缓存修改文件后最多 30 秒生效无需重开应用文件不存在时静默跳过不影响使用用 /init 一键生成第一次接触老项目时在输入框输入/initAI 会自动扫描工作区用 grep/glob/文件读取梳理后生成一份不超过 200 行的 TERAX.md内容涵盖项目简介、构建/测试/开发命令、架构总览、命名约定与坑点、入口文件路径生成模板见 slashCommands.ts。写入仍需你审批一次。参考 Terax 项目自己维护的 TERAX.md它既是代理记忆也是活的架构文档记录了质量门槛、架构分层和平台约定——AI 每次改动前都会先读文档输出自然贴合项目规范。 五、三者组合的典型工作流一个推荐的多步任务组合拳/init新项目/老项目接手时生成 TERAX.md建立项目记忆/plan开启 Plan 模式下达大任务例如把 X 模块重构为 Y让主代理派 Explore 子代理先摸清现状再出改动方案在Plan review面板逐条审阅 diff删掉不需要的 hunkApply All放行改动必要时再派Code review / Security 子代理复查/plan off退出进入正常开发节奏这样记忆 规划 侦察 审批四层配合AI 代理既高效又可控。❓ 常见问题速查Plan 模式和审批卡片有什么区别审批卡片是每次写操作都弹Plan 模式则把整个任务的所有修改攒成队列一次性批量审阅、批量放行适合改动多的任务。TERAX.md 和 AGENTS.md 能共存吗Terax 优先读取根目录的TERAX.md作为代理记忆。建议只维护一份避免信息冲突。子代理会改代码吗不会。四个内置子代理都被锁定为只读工具白名单只能读、搜、列目录并返回摘要。更多细节可查阅项目文档 docs/architecture/ai-subsystem.md 与 docs/architecture/security-model.md。【免费下载链接】terax-aiLightweight (7MB) Terminal-first AI-native dev workspace项目地址: https://gitcode.com/GitHub_Trending/te/terax-ai创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考