Skip to content

FAQ

FAQ

  • 模型切换：在 config.yaml 改 openai.model_name
  • 验证过程中出现错误怎么办：使用 Ctrl+C 进入交互模式，通过 status 查看当前状态，使用 help 获取调试命令。
  • Check 失败：先 ReadTextFile 阅读 reference_files；再按返回信息修复，循环 RunTestCases → Check
  • 自定义阶段：修改 ucagent/lang/zh/config/default.yaml 的 stage；或用 --override 临时覆盖
  • 添加工具：ucagent/tools/ 下新建类，继承 UCTool，运行时 --ex-tools YourTool
  • MCP 连接失败：检查端口/防火墙，改 --mcp-server-port；无嵌入可加 --no-embed-tools
  • 只读保护：通过 --no-write/--nw 指定路径限制写入（必须位于 workspace 内）

UCAgent 闪退，如何恢复验证流程？

  • 确保 UCAgent 和目前正在使用的 Code Agent(如 Qwen Code Cli)都已经退出，若没有则手动退出
  • 重新启动 UCAgent，它会自动继续之前的工作流
  • 重新启动 Code Agent 并输入“继续”即可恢复之前的验证流程

为什么快速启动找不到 config.yaml/定制流程时找不到 config.yaml?

  • 使用 pip 安装后并没有config.yaml那个文件，所以在快速启动的启动 MCP Server没有加--config config.yaml这个选项。
  • 可以通过在工作目录添加config.yaml文件并且加上--config config.yaml参数来启动；也可以使用克隆仓库来使用 UCAgent 的方式来解决。

运行中如何调整消息窗口与 token 上限？

  • 在 TUI 输入：message_config 查看当前配置；
  • 设置：message_config max_keep_msgs 8 或 message_config max_token 4096；
  • 作用范围：影响会话历史裁剪与送入 LLM 的最大 token 上限（通过 Summarization/Trim 节点生效）。

文档中的 “CK bug” 要改吗？

  • 是。术语统一为 “TC bug”。同时确保 bug 文档里的 <TC-*> 能匹配失败用例（文件/类/用例名）。

为什么找不到 WriteTextFile 工具？

  • 该工具已移除。请改用 EditTextFile（支持 overwrite/append/replace 三种模式）或其他文件工具（Copy/Move/Delete 等）。