---
title: spireai
canonical_url: "https://www.modelscope.ai/studios/moyang303/spireai"
md_url: "https://www.modelscope.ai/studios/moyang303/spireai.md"
repository: moyang303/spireai
chinese_name: SpireAI
last_updated: 2026-10-02
sdk_type: docker
downloads: 0
stars: 0
---

# spireai

> spireai - An interactive demo by moyang303 on ModelScope. AI 对话驱动的杀戮尖塔 2 模组创作工作室

moyang303/spireai is an interactive demo (Studio) on ModelScope. built with docker. also known as 「SpireAI」.

- **Repository**: moyang303/spireai
- **SDK**: docker
- **Downloads**: 0
- **Stars**: 0
- **Last updated**: 2026-10-02

Source: https://www.modelscope.ai/studios/moyang303/spireai

---

# SpireAI

AI 对话驱动的《杀戮尖塔 2》模组创作工作室。

**React 19 + TypeScript / Go / PostgreSQL 16 / Modal Volume**

## 界面

- 完整公开首页、登录注册和卡牌式项目大厅。
- 创建项目时由玩家填写 Mod ID，不再随机生成；保留大小写，3–61 个英文字母或数字、以字母开头，并检查关键字和保留文件名。项目内部 ID 与 Mod ID 独立，已有项目不变。
- 三栏创作工作台：左侧全局会话，中间 AI 对话（同一轮回复的工具调用合并为“工作记录”），右侧可拖拽宽度的项目空间；窄屏下两侧改为抽屉。
- 聊天中按会话切换模型和思考强度（与模型并排的档位菜单，附说明与强度刻度），档位读取各模型独立配置，运行中切换仅影响下一条消息；可编辑已发送的提问：之后的对话被移除，再按新内容重新生成。没有相关文件或依赖改动时只回退对话，保留其他对话和手动改动；确需恢复项目时，先预览并确认影响，再以新版本恢复检查点，原版本仍在历史中。管理员可添加、编辑、启停、删除模型并设置默认模型，自行配置可选档位、默认强度、接口、密钥和参数。
- 模型支持三种接口协议：Chat Completions、OpenAI Responses、Anthropic Messages（均使用官方 SDK），可选 Bearer / x-api-key 鉴权。
- 模型计费：按美元/百万 tokens 配置输入、输出、缓存读写价格与长上下文档位，可从 models.dev 一键获取；每次任务冻结价格。聊天框旁显示本对话 tokens、缓存命中与估算费用，账号页显示个人用量，后台概览按模型、用户和天统计费用。
- 上游模型返回的思考内容独立展示，默认折叠，支持流式追加及刷新后查看；复制回复仅复制正文。
- 源码只读预览、引用到聊天、素材上传、版本恢复、源码和模组下载。
- 公共推荐目录＋项目私有依赖；NuGet、ZIP/DLL、GitHub Release 和自己的成功构建产物均可加入项目。
- 依赖添加、移除、升级先解析后应用；自动识别对应游戏版本自带的运行库，补齐编译引用但不打进模组包，仍检查缺失和版本冲突；历史恢复和历史编译绑定当时的依赖与环境快照。
- 后台管理提示词、用户配额、四类任务并发、构建资源与费用估算、依赖源和配额、模型运行策略与参数边界、游戏环境以及站点内容；历史任务保留配置快照。
- 游戏资料按版本完整同步到服务器本地磁盘，全用户共享只读本地检索；后台管理准备进度、取消重试、完整校验和安全清理，未就绪版本不会接受新创作任务。多流并发下载，容器替换后自动重新准备。
- 「游戏资料」后台页：游戏源码（扫描并登记云端新版本、准备与校验）、附加资料（精修的模组教程与 API 速查，按项目依赖解锁，例如安装 BaseLib 后才可读 BaseLib 教程）与游戏更新流程；`scripts/publish_library.py` 并发上传新版本资料。
- 存储卷按云账号分组，进入账号查看其存储卷；后台与项目上传均并发分片。
- 编译失败只输出精简的编译日志与错误汇总（附修复提示），不再出现 Python 报错堆栈。
- 全新管理后台：云账号、存储卷、用户与项目、任务、审计、模型与存储配置、远程终端。
- 「羊皮纸与余烬」设计：暖纸色浅色主题与炉火深色主题，可跟随系统；支持手机、平板、桌面，全局命令面板（Ctrl/⌘K）与完整键盘操作。
- 首页、路由、弹窗抽屉、列表与聊天采用 120–300ms 克制动效，支持减少动态效果。

## 后端

- Go 主服务通过标准 PostgreSQL 驱动保存业务元数据，独立 worker 通过内部接口执行任务。
- 正文、模型上下文、工具结果、日志及依赖快照使用带校验和的不可变内容引用；大型内容保存在 Modal 卷中，数据库只保留有界元数据。
- `postgresql-studio` 的独立 `pgbridge` 进程提供回环 TCP 连接；应用不包含魔搭数据库协议适配器。
- 持久任务队列、租约代次、幂等工具执行和短事务版本提交。
- 文件目录与内容分离，增量版本、默认 8 MiB 的持久协商分片、校验和、断点续传及范围下载。
- SSE 历史恢复；原生模型工具、计划、问题、只读调查与隔离编译。
- 官方 `openai-go` 处理请求与流解析；历史参考 OpenCode 的持久摘要和近期上下文机制，跨任务保留工具结果，不再固定截取最近 40 条消息。
- 小型 Python gRPC 适配层接入 Modal／Beam SDK。
- 魔搭 ModelScope Docker 部署，独立站点访问，监听 7860。

## 目录

```text
spireai-go/                 当前 Go 主项目（含配套前端与云适配器）
  go.mod / go.sum           Go 模块与依赖
  server/                  Go API、数据库、任务与 AI 引擎
  web/                     React 全站源码（架构与约定见 web/README.md）
  connectors/cloud/        云 SDK、隔离编译及管理员终端适配
  tooling/                 .NET 元数据、NuGet 版本与框架解析工具
  contracts/               内部 Protobuf 协议
  deploy/                  魔搭构建环境元数据
  scripts/                 本地开发与容器进程管理
  tests/                   浏览器与跨服务验收
  bin/、data/、.env         本机构建产物、运行数据与配置（不提交）
spireai-web/                旧 Python Web 项目及保留数据（与 Go 项目同级）
spireai-modal/              旧 Modal 项目及保留数据（与 Go 项目同级）
docs/                      架构、部署、接口与验证文档
archive/                   非运行所需的本地资料
  artifacts/               临时产物归档（不提交）
.github/                   仓库级 CI 配置
Dockerfile / .dockerignore  仓库级 Docker／魔搭部署入口
```

开发、构建与测试以 `spireai-go/` 为工作目录；Docker 构建仍以仓库根目录为上下文。既有 `.venv/` 保留在仓库根目录，避免移动虚拟环境导致启动器中的绝对路径失效。归档不参与当前项目的构建或运行；原有配置、数据库和保留资料仅移动，不删除。

## 启动

需要 Go 1.26+、Node.js 22.12+、Python 3.11+、.NET SDK 9 和 PostgreSQL 16+。先创建空数据库并配置 `DATABASE_URL`。`spireai-go/scripts/dev.py` 会构建 .NET 依赖工具。以下命令从仓库根目录执行：

```powershell
python -m venv .venv
cd spireai-go
..\.venv\Scripts\python.exe -m pip install -r connectors/cloud/requirements.txt
# 从 spireai-go/.env.example 创建同目录下的 .env，填写初始管理员密码。
..\.venv\Scripts\python.exe scripts/dev.py
```

访问 `http://127.0.0.1:7860`。开发环境可以使用本地对象目录；生产环境在管理后台配置云存储后创建项目。

当前部署说明：[PostgreSQL 部署与本地开发](docs/DEPLOYMENT.md) · [魔搭历史部署记录](docs/MODELSCOPE.md) · [架构](docs/ARCHITECTURE.md) · [接口](docs/API.md) · [验证记录](docs/VERIFICATION.md)

## 检查

在 `spireai-go/` 中执行：

```powershell
# 设置 TEST_DATABASE_URL，指向可创建和删除测试 schema 的独立 PostgreSQL 测试库。
go test ./server/... -short
go vet ./server/...
..\.venv\Scripts\python.exe tests/browser_acceptance.py
```

前端在 `spireai-go/web/` 中运行 `npm ci`、`npm run build`（含类型检查）和 `npm run test:unit`，在 `spireai-go/` 中运行 `python scripts/check_style.py` 检查设计系统与 CSP 规则；Docker 在仓库根目录运行 `docker build -t spireai:v2 .`。测试使用临时数据库和模拟模型。云资源实测与 Docker／魔搭上线验收的实际状态见验证记录。

当前版本只初始化空 PostgreSQL schema，并严格验证结构版本和指纹，不提供旧业务 SQLite 的读取、迁移或自动兼容。已发布的上一结构版本需在备份后由运维执行 `spireai-manage migrate` 显式升级（启动时从不自动升级）。一次性数据提取与重建在应用之外进行。游戏资料中的只读 SQLite 检索索引属于可重建缓存，不是业务数据库。密钥、数据库、用户文件、游戏资料和构建产物不提交 Git。

本机七个 Modal 账号的只读核查结果与精确清理命令见 [云卷清理清单](docs/MODAL_CLEANUP.md)。