Menú
后端服务启动与数据库操作规范。在需要启动后端服务、运行 API 测试、执行数据库迁移或遇到连接错误时激活，确保使用正确的命令和流程。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
GitHub Release 发布操作规范。在需要发布版本、上传安装包到 GitHub Release 时激活，确保使用正确的命令和流程。
确认/删除等交互弹框统一使用 showTolyPopPicker 底部弹出样式。在需要弹出确认框、删除确认、操作选择时激活，确保交互风格一致。
功能归档规范。在归档功能版本、更新功能网、创建存档快照时激活，确保节点编号正确、网络图完整。
使用 tolyui_mediax 实现媒体预览。适用于图片九宫格展示、全屏预览、手势缩放、视频播放、Hero 动画等场景。
Flutter Widget/Page 组件代码评审技能。在需要审查组件代码质量、发现设计问题时激活，确保输出结构化的问题清单和改进建议。
Flutter Widget/Page 组件重构执行技能。在需要对组件执行拆分、提取、简化时激活，确保按正确手法重构并验证通过。
| name | server-operations |
| description | 后端服务启动与数据库操作规范。在需要启动后端服务、运行 API 测试、执行数据库迁移或遇到连接错误时激活，确保使用正确的命令和流程。 |
| metadata | {"model":"manual","last_modified":"Wed, 18 Jun 2026 00:00:00 GMT"} |
PoolTimedOut、Connection refused 等连接错误时永远使用 python scripts/server/start.py，禁止直接 cargo run。
该脚本自动处理：PostgreSQL 启动 → 停旧进程 → cargo build → cargo run。
# 1. 启动（长时间运行命令）
control_pwsh_process(action="start", command="python scripts/server/start.py", cwd="项目根目录绝对路径")
# 2. 等待启动完成
execute_pwsh(command="Start-Sleep -Seconds 10")
# 3. 验证成功（确认输出含 "listening on"）
get_process_output(terminalId=xxx, lines=10)
| 现象 | 原因 | 解法 |
|---|---|---|
PoolTimedOut | PostgreSQL 没启动 | start.py 自动处理，检查日志 |
Failed to remove exe | 旧进程锁文件 | start.py 自动 taskkill |
| 端口 9600 占用 | 旧进程未退出 | start.py 自动停止 |
control_pwsh_process(action="stop", terminalId=xxx)
# 执行单个迁移
$env:PGPASSWORD="postgres"; psql -h localhost -U postgres -d flash_im -f "server/migrations/xxx.sql"
# 重置数据库
python scripts/server/reset_db.py
# 查询数据
$env:PGPASSWORD="postgres"; psql -h localhost -U postgres -d flash_im -c "SELECT ..."
cargo run（不启动 PostgreSQL）cargo build