OmniPublish V2.0 — 单机版工作台

全链路多平台发帖工作台。6 步流水线自动推进，一次多平台并行分发，SQLite 零配置单机运行。

激活时立即执行

当用户调用 /omnipublish 时，立即运行以下状态检查和启动流程：

# 1. 检查服务状态
curl -sf http://127.0.0.1:9527/api/ping

# 2. 如未运行，用 launcher.py 启动（自动处理 venv / 前端构建 / config）
python "$SKILL_DIR/launcher.py" start

# 3. 在浏览器打开（Windows）
start http://127.0.0.1:9527
# Mac/Linux:
# open http://127.0.0.1:9527

服务就绪后告知用户：

• 访问地址：http://127.0.0.1:9527
• 默认账号：admin / admin123

项目位置

技能目录：$SKILL_DIR（.claude/skills/omnipublish/）
项目根目录：$SKILL_DIR 上三级（launcher.py 自动推导）

launcher.py 做的事：

1. 创建 Python venv（首次）
2. pip install 依赖
3. npm build 前端（首次，约 1-2 分钟）
4. 后台启动 python backend/main.py
5. 等待 /api/ping 就绪

常用操作命令（Bash 工具执行）

# 启动
python "$SKILL_DIR/launcher.py" start

# 停止
python "$SKILL_DIR/launcher.py" stop

# 重启
python "$SKILL_DIR/launcher.py" restart

# 状态
python "$SKILL_DIR/launcher.py" status

# 查看日志
tail -f "$SKILL_DIR/../../../logs/server.log"

本地 API（WebFetch 工具调用）

基础地址：http://127.0.0.1:9527

GET  /api/ping                健康检查 → {"ok":true}
POST /api/auth/login          登录 {username, password}
GET  /api/tasks               任务列表
GET  /api/platforms           业务线列表
GET  /api/stats/overview      统计数据
GET  /docs                    Swagger 交互式文档

登录示例：

curl -X POST http://127.0.0.1:9527/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"admin123"}'

技术栈

目录结构

OmniPublish/                         ← 项目根（$SKILL_DIR/../../../）
├── .claude/skills/omnipublish/
│   ├── SKILL.md                     ← 本文件
│   └── launcher.py                  ← 自适应启动器
├── config.json                      ← 运行时配置（首次自动创建）
├── data/omnipub.db                  ← SQLite 数据库（自动创建）
├── logs/server.log                  ← 服务日志
├── backend/                         ← FastAPI 后端
│   ├── main.py
│   ├── database.py                  ← SQLite + asyncpg 兼容层
│   ├── routers/
│   └── services/
└── frontend/
    ├── src/                         ← Vue 源码
    └── dist/                        ← 构建产物（首次运行自动生成）

流水线步骤

配置文件

config.json（从 config.json.example 自动创建）：

{
  "api_key": "sk-xxx",       // LLM API 密钥（AI 文案，可不填）
  "api_base": "https://api.openai.com",
  "server": { "port": 9527, "auth_token": "change-me" },
  "crypto": { "appkey": "", "aes_key": "", "aes_iv": "" }
}

修改后：python "$SKILL_DIR/launcher.py" restart

调试命令

# 查看实时日志
tail -f "$SKILL_DIR/../../../logs/server.log"

# 检查数据库
sqlite3 "$SKILL_DIR/../../../data/omnipub.db" ".tables"

# 检查 FFmpeg
ffmpeg -version

# 重置管理员密码
cd "$SKILL_DIR/../../../backend"
python -c "
import asyncio, bcrypt
from database import get_pool
async def reset():
    pool = await get_pool()
    async with pool.acquire() as conn:
        h = bcrypt.hashpw(b'newpass123', bcrypt.gensalt()).decode()
        await conn.execute(\"UPDATE users SET password=? WHERE username='admin'\", h)
        print('密码已重置为 newpass123')
asyncio.run(reset())
"

开发规范

• Python：snake_case 函数，PascalCase 类，async/await IO，asyncio.to_thread() 耗时操作
• Vue：TypeScript 严格模式，状态统一 Pinia，上一步不清除数据，变更后 saveDraft()

常见问题