暂无描述
查找文件
2026-07-05 22:11:17 +08:00
adapters Resolve WebUI static assets 2026-07-05 22:11:17 +08:00
assets_builtin chore: initialize v3 plugin scaffold 2026-07-04 22:51:52 +08:00
backend Preflight asset pack media files 2026-07-05 21:38:38 +08:00
core Execute storage migration copies 2026-07-05 21:46:07 +08:00
data chore: initialize v3 plugin scaffold 2026-07-04 22:51:52 +08:00
database Persist review policy settings 2026-07-05 21:10:21 +08:00
engines Add review policy backend endpoints 2026-07-05 19:20:54 +08:00
frontend Add storage migration apply control 2026-07-05 21:51:49 +08:00
pages/imagestudio Persist review policy settings 2026-07-05 21:10:21 +08:00
tests Resolve WebUI static assets 2026-07-05 22:11:17 +08:00
web Add storage migration apply control 2026-07-05 21:51:49 +08:00
.gitignore feat: add mounted web ui shells 2026-07-05 09:24:00 +08:00
__init__.py chore: initialize v3 plugin scaffold 2026-07-04 22:51:52 +08:00
_conf_schema.json chore: initialize v3 plugin scaffold 2026-07-04 22:51:52 +08:00
config.yaml feat: add backend foundation and database selection 2026-07-04 23:08:05 +08:00
DEVELOPMENT.md feat: add profile route handlers 2026-07-05 00:20:59 +08:00
imagestudio_api_contract_v3_ui_adjusted.md feat: consume UI actions in plugin page 2026-07-05 16:32:03 +08:00
imagestudio_codex_hermes_dev_flow_v3.md chore: initialize v3 plugin scaffold 2026-07-04 22:51:52 +08:00
imagestudio_full_plugin_dev_doc_v3_ui_adjusted.md feat: consume UI actions in plugin page 2026-07-05 16:32:03 +08:00
main.py Expose plugin entrypoint helpers 2026-07-05 22:07:36 +08:00
metadata.yaml chore: initialize v3 plugin scaffold 2026-07-04 22:51:52 +08:00
README.md feat: add profile route handlers 2026-07-05 00:20:59 +08:00

AstrBot ImageStudio

AstrBot ImageStudio is an AstrBot role asset production and image-generation workspace plugin.

It provides two UI surfaces:

  • AstrBot Plugin Page UI for lightweight status, queue, recent jobs, and quick entry points.
  • Standalone Web UI mounted under AstrBot's plugin extension route for the full workspace.

Both UIs share one backend API, database, queue model, VFS media layer, material library, wardrobe system, and audit trail.

Development Baseline

Use the v3 documents as the source of truth:

  1. imagestudio_full_plugin_dev_doc_v3_ui_adjusted.md
  2. imagestudio_api_contract_v3_ui_adjusted.md
  3. imagestudio_codex_hermes_dev_flow_v3.md

Older v0.1 planning is superseded by v3. In v3, the central fact chain is:

character_profiles
  -> profile_workflows
  -> workflow_nodes
  -> generation_tasks
  -> generation_images

Current Stage

This repository has completed S0-1 and started the S0 backend foundation.

Implemented foundation:

  • v3 directory and configuration baseline.
  • Common API response helpers matching the v3 contract.
  • Request context and permission guard helpers.
  • Database helper with SQLite default and optional PostgreSQL selection.
  • Initial audit_logs migration and audit recording service.
  • character_profiles migration, repository, service, and audit-backed create/update/delete.
  • profile_workflows and workflow_nodes migrations, repositories, services, and audit-backed create/update.
  • generation_images migration, repository, service, selected-state exclusivity, archive/delete metadata semantics, and audit logging.
  • ui/bootstrap and dashboard/summary service/route handlers with v3 response wrapping.
  • Profile CRUD and quick profile draft route handlers.

Next tasks:

  1. S2-4 workflows, nodes, and images routes.
  2. S2-5 jobs placeholders and settings current/schema.
  3. S2-6 storage status and media sign placeholders.
  4. S3 mount Plugin Page UI and Standalone Web UI through AstrBot.
  5. S4 single image mock flow and generation task lifecycle.

Repository Layout

main.py
metadata.yaml
_conf_schema.json
config.yaml
adapters/
core/
engines/
backend/
database/
assets_builtin/
pages/imagestudio/
web/
frontend/
data/

The root directory is the plugin repository root. Do not introduce a second backend service or a standalone web port.

Non-Negotiable Rules

  • Standalone Web UI must be served by AstrBot plugin extension routes.
  • Plugin Page UI and Standalone Web UI must call the same backend API.
  • Frontend code must not read or construct real disk paths.
  • API keys and tokens must not be returned to the frontend in plain text.
  • Every write operation must record audit_logs.
  • Generated images must have generation_images records.
  • Media access must go through signed media APIs.