SuperAPI AI 工具集

mixseek-debug

智能体与模型

查看项目

更新于 10-15 21:13

技能介绍

用途:该技能用于为 MixSeek-Plus 启用调试功能并控制日志输出,便于诊断代理运行时的问题、确认运行行为。

主要能力与环境变量:

  • MIXSEEK_VERBOSE(1 或 true):统一调试模式,同时开启 MCP 工具日志、mixseek.member_agents(DEBUG)与 claudecode_model(DEBUG)。
  • CLAUDECODE_MODEL_LOG_LEVEL=DEBUG:仅对 claudecode-model 包输出日志。
  • MIXSEEK_LOGFIRE(1 或 true):启用 Logfire 插桩,用于 pydantic-ai 追踪,需预先配置 Logfire。 一般调试仅需 MIXSEEK_VERBOSE=1。

使用方式: 1)确认当前环境变量,可运行脚本:bash skills/mixseek-debug/scripts/check-debug-env.sh 2)CLI 运行(在命令前设环境变量): MIXSEEK_VERBOSE=1 uv run mskp team "任务" --config configs/agents/team.toml CLAUDECODE_MODEL_LOG_LEVEL=DEBUG uv run mskp team "任务" --config configs/agents/team.toml MIXSEEK_VERBOSE=1 MIXSEEK_LOGFIRE=1 uv run mskp team "任务" --config configs/agents/team.toml 也可用 export MIXSEEK_VERBOSE=1 对当前会话生效,用 unset MIXSEEK_VERBOSE 关闭。 3)Python API: import mixseek_plus mixseek_plus.enable_verbose_mode() mixseek_plus.patch_core() 用 mixseek_plus.disable_verbose_mode() 关闭。也可直接设 os.environ["MIXSEEK_VERBOSE"]="1" 后调用 mixseek_plus.patch_core();该方式无上下文管理器,需手动清理。

日志输出:控制台按 [Tool Start]/[Tool Done]/[Tool Result Preview] 格式打印;Member Agent 文件日志输出到 $MIXSEEK_WORKSPACE/logs/member-agent-YYYY-MM-DD.log,含工具调用参数、耗时、状态、追踪信息与错误堆栈。

限制与排查:日志缺失常因环境变量未设、未调用 patch_core() 或日志 handler 未配置;找不到文件日志多因未设 MIXSEEK_WORKSPACE;日志过多可只开 CLAUDECODE_MODEL_LOG_LEVEL=DEBUG,或单独调整 logging.getLogger 级别;Logfire 追踪不显示需先 logfire.configure()。调试完成后应 unset 相关变量或调用 disable_verbose_mode()。具体安装与依赖细节暂未提供。