XHH Console · 小黑盒 AI 工作台

Overview

XHH Console 是一套面向小黑盒的自托管 AI 内容运营工作台。它把社区选题、图文草稿、评论收件箱、自动化任务与发送回执放在同一个界面中，让内容从生成到审核再到发布有清楚的状态和记录。

项目于 2026 年 10 月从原 Go 版机器人迁移至 Python，随后增加 Web 控制台、持久化发送队列、通行密钥登录和云端部署。它面向个人管理使用，支持管理多个小黑盒账号。

Problem

自动生成内容只是流程中的一步。实际使用还需要确认发往哪个账号、哪个帖子、采用什么可见范围，以及失败之后能否再次发送。如果生成、审核、发送和重试散落在脚本与平台页面之间，很容易丢失上下文，或在请求超时后重复发布。

因此，这个项目把重点放在可检查的内容流程：保存草稿、核对目标、明确审核、按序发送，并把不确定的远端结果留给人工核对。

Features

• 内容工作台：生成和编辑帖子与评论，结合帖子正文及图片上下文起草回复，管理本地配图、社区和话题，保存待审核内容与发送历史。
• 自动化任务：在界面中配置发帖、评论与回复任务，管理话题来源、提示词、执行间隔和账号发送额度；任务默认暂停并要求审核，可按需配置自动执行。
• 评论收件箱：集中查看本人帖子的评论，保留原帖上下文，再选择生成回复或人工处理。
• 批量审核与发送队列：按任务类型、来源任务和关键词筛选待审核内容，确认正文、账号、目标与可见范围后批量入队；后台单消费者依次发送，关闭或刷新页面后队列继续运行。
• 消息盒子：持久保存入队提示与执行回执，支持未读筛选、批量已读及历史清理；消息清理不影响内容历史。
• 多账号与模型配置：扫码登录小黑盒账号，分别配置 AI 服务与提示词，并将发帖、评论和回复额度分开管理。
• 桌面与手机界面：采用深色金色视觉与统一的 XHH 标志，窄屏下调整导航、审核内容和消息面板布局。

Architecture

浏览器：原生 JavaScript / CSS
             │ HTTP API
             ▼
FastAPI + Uvicorn
   ├─ 内容工作台、收件箱与账号管理
   ├─ 自动化调度、审核与单消费者发送队列
   ├─ OpenAI 兼容模型接口与 MCP stdio 工具
   └─ 小黑盒接口适配、图片上传与回执处理
             │
             ▼
SQLite：账号配置、任务、内容历史、发送账本、队列与消息

Web 控制台使用 SQLite 保存运行状态；旧版 CLI 作为独立入口保留，并支持 SQLite 或 PostgreSQL。前端直接使用原生 JavaScript 与 CSS，无需另设前端框架构建流程。

Engineering decisions

• 生成与发布分离：先保存可编辑内容，再由审核流程决定是否发送；模型生成文案，不替用户决定账号、发布范围或定时参数。
• 不自动重发不确定请求：远端请求超时或进程中断后，相关记录标记为 unknown，须核对平台实际结果。已有发送账本、内容指纹与队列保留状态共同限制重复执行；这不等于承诺跨外部系统的绝对一次投递。
• 队列状态持久化：入队时整批校验并在事务内保留内容，防止同一内容同时被编辑或重复发送。重启时恢复可继续的队列项，将已经进入远端写入但没有回执的项留待核对。
• 控制台访问保护：云端通过 HTTPS、访问码会话、CSRF 校验及通行密钥保护管理入口。多账号是平台账号管理能力，控制台本身不是多租户权限系统。
• 加密备份与隔离恢复：通过 SQLite 在线备份取得一致性快照，使用 AES-256-GCM 加密并以 RSA-OAEP 封装密钥，配套隔离恢复及完整性检查。

Development and status

2026 年 10 月已完成 Python 迁移、图文发布、控制台、云端调度、手机布局、通行密钥、批量审核、发送队列、消息盒子和品牌资源上线。

AI 配图已在本地实现并通过模拟接口验证，支持为帖子生成配图；截至本次整理，它尚未部署到生产，也未以真实付费生图服务验收。

项目以模拟平台与模型接口、临时数据库进行自动化验证，覆盖发送状态、重复确认、超时、重启恢复、访问鉴权与额度等路径。真实平台接口与模型能力仍取决于对应账号、服务及平台变化。

Credits

Python 迁移与控制台扩展基于 SomeOvO/xhhRobot 的原 Go 实现。本条目描述的是当前 Python 实现及其新增工作台能力。

该项目包含账号与运行数据，当前不提供真实控制台的公开演示入口。封面为沿用项目标志与配色绘制的流程示意，不是生产数据截图。

公开的 mock 演示站 复用工作台界面，账号、帖子、评论和运行结果均为虚构示例。生成、登录、审核与发送只在浏览器内模拟，刷新后重置；不连接真实平台、生产数据或付费模型。演示中的 AI 配图是本地功能预览，返回固定示例图片。