القائمة
后端服务启动与数据库操作规范。在需要启动后端服务、运行 API 测试、执行数据库迁移或遇到连接错误时激活，确保使用正确的命令和流程。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف 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