astrbot_plugin_imagestudio/README.md

41 行
2.4 KiB
Markdown

2026-07-04 22:51:52 +08:00
# AstrBot ImageStudio
ImageStudio 是一个给 AstrBot 使用的角色资产与生图工作台插件。它把角色档案、工作流、素材库、衣橱、队列、日志和模型能力探测放在同一个插件里,方便后续为角色持续生成、筛选和管理图片。
2026-07-04 22:51:52 +08:00
## 现在能用什么
2026-07-04 22:51:52 +08:00
- 查看插件运行概览、队列状态、最近任务和最近图片。
- 创建角色档案,维护基础设定、外观提示词、风格提示词和默认模型路由。
- 创建角色工作流,按节点生成、重试、采纳、选择或归档图片。
- 管理素材库、素材分类、衣橱条目,并做每日穿搭匹配。
- 查看任务队列、失败任务、死信队列、生成日志、错误日志和审计日志。
- 探测 OpenAI 兼容生图接口的能力,保存模型/路线能力档案。
- 默认使用 SQLite;在配置 PostgreSQL 后可以切换到 PG 数据库。
- 提供 AstrBot 插件卡片概览页,也提供独立的星图导航工作台入口。
2026-07-04 22:51:52 +08:00
## 怎么打开
2026-07-04 22:51:52 +08:00
在 AstrBot 插件页面打开 ImageStudio 时,默认看到的是轻量星图概览页:它用于确认插件状态、队列、最近图片和快捷入口。
2026-07-04 22:51:52 +08:00
完整工作台在概览页的“工作台”入口里,路径由 AstrBot 挂载到:
2026-07-04 22:51:52 +08:00
```text
/api/v1/plugins/extensions/astrbot_plugin_imagestudio/web
2026-07-04 22:51:52 +08:00
```
## 当前 UI 状态
2026-07-06 04:33:14 +08:00
插件卡片页目前是轻量入口,这是有意保留的 AstrBot 内嵌页面,不代表后端功能只有这一页。
2026-07-06 04:33:14 +08:00
独立工作台已经切换为星图导航页:左侧图标导航用于切换概览、生成、队列、图库、角色、素材、设置和日志;顶部提供功能搜索、日夜主题、通知和调色盘;主区域聚合当前队列、最近图片、智能工作建议和右侧性能监控。
当前导航页已接入 `dashboard/summary`、`jobs`、`logs/generation` 和 `logs/errors` 等真实接口,并为接口失败、空队列、无图片和日志为空的情况提供可读状态。后续详情页会继续沿用这套导航入口接入更完整的生成、图库、角色和设置操作流。
2026-07-06 04:33:14 +08:00
## 配置说明
2026-07-04 22:51:52 +08:00
AstrBot 小齿轮设置用于安装后最常改的项目:默认模型、私伴插件集成、SQLite/PG 数据库配置。
2026-07-04 22:51:52 +08:00
更完整的配置、导出、导入、校验、差异对比和快照回滚在独立工作台的“设置”页里。
2026-07-04 22:51:52 +08:00
安装、打包、数据库和 smoke 测试命令见 [INSTALL.md](INSTALL.md)。