更新与排障

本页覆盖 Chat2DB CLI 的更新、卸载、安装日志和常见恢复命令。更新或卸载前建议先运行：

chat2db version --json
chat2db status --json

更新 CLI

从官方 CDN 更新当前 CLI：

chat2db update --json

更新指定路径：

chat2db update --target ~/.local/bin/chat2db --json

更新后确认版本：

chat2db version --json

卸载当前 CLI 二进制：

chat2db uninstall --cli --yes

预览卸载，不删除文件：

chat2db uninstall --cli --dry-run --json

卸载 Pro：

chat2db uninstall --edition pro --yes --json

卸载 Local：

chat2db uninstall --edition local --yes --json

预览卸载两个 edition：

chat2db uninstall --edition all --dry-run --json

卸载命令会校验应用身份，并默认保留用户数据。执行前请确认 edition 和目标路径。

后台安装时，日志会写入本机状态目录。查看安装日志：

chat2db logs install --edition pro

持续跟随日志：

chat2db logs install --edition pro --follow

logs 输出是文本流，不要加 --json。

停止 Pro 的应用、runtime 和 MCP：

chat2db stop --edition pro --all --json

停止 Local：

chat2db stop --edition local --all --json

只停止 CLI runtime：

chat2db runtime stop --edition pro --json

只关闭 MCP：

chat2db mcp disable --edition pro --json

chat2db version --json
chat2db --help

如果本文档和 --help 不一致，以本机 --help 为准。

chat2db status --json

优先读取 next_action，它通常会给出当前状态下最直接的恢复命令。

chat2db runtime status --edition pro --json
chat2db runtime start --edition pro --json

如果 runtime 仍然不可用，先停止再启动：

chat2db runtime stop --edition pro --json
chat2db runtime start --edition pro --json

chat2db mcp status --edition all --json
chat2db mcp restart --edition pro --json

如果 Pro / Local 端口冲突，停止不用的 edition：

chat2db stop --edition local --all --json

先确认数据源存在：

chat2db db datasources --edition pro --json

再测试连接：

chat2db db connection-test --data-source-id <data-source-id> --json

最后再执行 SQL：

chat2db sql query \
  --data-source-id <data-source-id> \
  --database postgres \
  --schema public \
  --sql 'select 1' \
  --json

排障时不要把以下内容贴到公开渠道：

可以保留命令名、错误码、脱敏后的 endpoint、edition、版本号和 next_action。