调试命令指南

本文档介绍偏向技术调试和系统维护的命令。它们通常用于：

• 调试模型与提示词行为
• 查看执行记录
• 调整系统配置
• 执行运维级操作

风险提示

这类命令通常具备较高权限，可能影响系统稳定性、数据状态或运行结果。请在理解命令作用的前提下使用。

适用场景

调试命令更适合：

• 超级管理员
• 运维人员
• 插件开发者
• 需要定位复杂问题的高级用户

如果你只是做日常管理，建议优先阅读：

• 基础命令指南
• 命令中心（即将发布）

代码执行与执行记录

exec

用于在沙盒环境中执行 Python 代码并返回结果。

示例：

exec print("Hello World")
exec import os; print(os.getcwd())
exec 1 + 1

适合：

• 快速验证环境
• 检查依赖或路径
• 复现简单逻辑问题

code_log

用于查看代码执行记录。

示例：

code_log
code_log -2
code_log 1

适合：

• 回看最近一次执行了什么
• 对照输出定位错误

系统消息与调试模式

system

向当前聊天添加系统消息，并可用于驱动 Agent 继续处理。

示例：

system 请介绍一下你自己
system 当前任务：分析用户提供的数据

适合：

• 测试 Agent 行为
• 注入额外上下文
• 验证提示词和系统消息的影响

debug_on / debug_off

用于切换提示词调试模式。

适合：

• 观察当前提示词与上下文的影响
• 排查响应异常
• 暂时从角色化输出切换到偏技术分析视角

配置管理

conf_show

查看某项配置，或列出可动态修改的配置项。

示例：

conf_show
conf_show AI_GENERATE_TIMEOUT

conf_set

动态修改配置项。

示例：

conf_set AI_GENERATE_TIMEOUT=60
conf_set ENABLE_DEBUG_MODE=true

conf_reload

重新加载配置文件。

conf_save

把当前配置写回配置文件。

模型与运行状态检查

不同环境中的可用调试命令可能不完全相同，但这一类命令通常包括：

• 模型测试
• 日志查看
• 错误检查
• 系统状态输出

它们的共同目标是帮助你回答这些问题：

• 模型是否可用
• 当前错误发生在哪里
• 是配置问题、模型问题还是运行时问题

使用建议

• 调试命令优先在测试环境或低风险频道执行。
• 对带写入、重建、清理性质的命令，先确认影响范围。
• 如果只是想看命令状态和输出，优先使用 WebUI 中的命令中心和命令输出页。

继续阅读

• 命令中心（即将发布）
• 工作区总览（即将发布）
• 工作区定时器（即将发布）