server-operations
星标12
分支2
更新时间2026年6月19日 00:11
后端服务启动与数据库操作规范。在需要启动后端服务、运行 API 测试、执行数据库迁移或遇到连接错误时激活，确保使用正确的命令和流程。
安装
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
SKILL.md
readonly
下载
相关职业SOC
基于 SOC 职业分类
菜单
后端服务启动与数据库操作规范。在需要启动后端服务、运行 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