query-database

SKILL.md

查询 mercury-server 的 SQLite 数据库,获取真实的运行数据来回答用户问题。当用户的问题涉及数据库查询时,直接执行查询,不需要先问用户是否需要帮忙查

使用步骤

  1. 了解表结构:先用 Read 工具读取 $PROJECT_DIR/docs/db-schema.md,了解可用的表和字段
  2. 定位数据库:通过 Bash 执行 echo $SQLITE_DB_PATH 获取路径
  3. 执行查询:使用 sqlite3 命令行工具

安全规则

  • 必须加 -readonly 参数,防止误操作
  • 仅允许 SELECT 查询,禁止任何写操作(INSERT/UPDATE/DELETE/DROP 等)
  • 必须加 LIMIT,避免大结果集(建议 LIMIT 50)

查询命令格式

sqlite3 -readonly -header -column "$SQLITE_DB_PATH" "SELECT ... LIMIT 50"

注意事项

  • 时间字段为 UTC+8 格式(YYYY-MM-DD HH:MM:SS
  • messages 字段是 JSON 数组,内容可能很长,查询时建议只取 length(messages) 或不 SELECT 该字段
  • 使用中文回复查询结果的含义,不要直接输出原始 JSON
Installs
2
First Seen
Apr 8, 2026