posterchanai

<div align="center"> <img src="static/mascot/mascot-happy-front-05.png" alt="Poster-chan mascot" width="200" /> # Poster-chan AI ### 您的私人 AI 助手 — 自主托管、私有且功能强大 **核心内置 Nostr 支持：** 内置的基于 PostgreSQL 的信任网络中继（web-of-trust relay）作为数据存储 — 您的设置、账户和 AI 聊天记录都是 **加密的 Nostr 事件，您拥有所有权**，应用程序的界面是一个完整的赛博朋克 **Nostr 网络客户端**。一个 FastAPI 后端同时处理聊天、图像生成、语音、电子邮件、新闻、种子下载以及在 **Telegram、Matrix、Misskey、Pleroma 和 Nostr** 上运行的自主机器人。支持云端 LLMs 或完全本地化。您的硬件、您的密钥、您的规则。 [](https://www.python.org/) [](https://fastapi.tiangolo.com/) [](docs/NOSTR_DATASTORE.md) [](https://www.postgresql.org/) [](#chat--ai) [](#quick-start-backend-and-web-ui) [](#requirements) [](LICENSE) [快速开始](#quick-start-backend-and-web-ui) · [功能](#features) · [机器人与社交](#bots--social) · [文档](#documentation) </div> --- ## 为什么选择 Poster-chan？ - 🟣 **Nostr 原生数据存储** — 内置的 **信任网络中继**（基于 PostgreSQL）是事实的源头。设置、账户、API 密钥和 AI 聊天记录作为 **NIP-44 加密的 `kind-30078` 事件**，由您的节点签名 — 不是某些应用数据库中的行。 使用您的 **Nostr 密钥**（NIP-07/NIP-46）登录，网页界面是一个完整的 Nostr 客户端。 没有 SQLite，没有您无法控制的专有模式。 - 🏠 **真正自主托管** — 在您自己的服务器上运行，无需遥测，单管理员多用户。您的对话和密钥从未离开您的网络；唯一的本地秘密是一个被 gitignore 的密钥文件。 - 🔌 **引入任意模型** — 云端（任何 OpenAI 兼容的 API）或本地：**Ollama** 或 **llama.cpp**（CPU / CUDA / HIP / **Intel Arc SYCL**）。在多个后端之间进行轮询负载均衡。 - 🤖 **也是一个机器人平台** — 驱动一切从 **Telegram & Matrix**，并从单个管理员选项卡运行自主的 **Pleroma / Misskey / Matrix / Nostr** 机器人。 - 🎨 **不仅仅是聊天** — 图像生成、TTS/STT、网站截图、YouTube/X 总结和下载、媒体工具、交互式学习闪卡、电子邮件、新闻、金融、种子下载 — 所有这些都位于一个聊天框后面。 - 🛠️ **可定制和诚实** — 薄路由器、逻辑服务、交互式安装程序和 OpenAI 兼容的 `/v1/` 端点，代理编码客户端（例如 opencode）可以针对您的本地模型驱动。 > 将任何 OpenAI 兼容的工具指向 `http://your-box:3051/v1/`，您就拥有了一个私有、具有函数调用能力的模型服务器。打开网页界面，您就拥有了一个完整的助手。链接一个机器人，它就在您的口袋里。 --- ## 功能 ### 聊天与 AI - **流式聊天**，支持多段对话、历史记录和可选的 Markdown/格式化 - **OpenAI 兼容的 API**，位于 `/v1/`，适用于兼容的客户端和工具，包括 **函数/工具调用**，以便代理编码客户端（例如 opencode）可以驱动您的本地模型 - **推荐的编码模型：** [Qwen3-Coder-30B-A3B-Instruct](https://huggingface.co/unsloth/Qwen3-Coder-30B-A3B-Instruct-GGUF) (`IQ4_XS`, MoE ~3B 激活，~16GB) — 目前在此多步骤代理构建中可靠性最高的本地模型；它可以一键完成小型应用，而 8–14B 模型会卡住。 需要 12GB+ 的 GPU（12–16GB 卡的部分 CPU 外设；保留 `ollama_num_ctx` 为 `auto`）。对于较小的 GPU，`Qwen3.5-9B-Claude-Code` 是轻量级备用。 在 **管理员 → AI 设置 → 代理/工具模型**（`llm_tools_model`）中设置一次服务器范围内的模型 — 用于每个带有工具的 `/v1` 请求 *和* `node agent` 命令（网页界面 + Telegram），而纯聊天则保留在默认模型上。 - **本地或远程 LLM**：Ollama 或 llama-cpp-python（CPU / CUDA / HIP / Intel Arc SYCL） - **负载均衡**：在多个聊天服务器之间轮询负载均衡 - **意图检测** 和斜杠风格的 **命令**（例如 `/mail`、`/image`、`/search`） ### 语音与媒体 - **文本转语音（TTS）** 和 **语音转文本（STT）**；Edge TTS 和可配置的后端 - **图像生成**：ComfyUI（外部）或原生 diffusers（SDXL）；支持多个图像服务器 - **音乐生成**（`musicgeni`）：通过自托管的 [ACE-Step](https://github.com/ace-step/ACE-Step-1.5) 服务器（适合 12 GB GPU）从文本生成歌曲；负载均衡 + VRAM 交换，像图像生成一样，带有口语水印。 网页界面 + Telegram。 参见 [docs/MUSIC.md](docs/MUSIC.md) - **视频生成**（`videogeni`）：原生进程内文本转视频，通过 **diffusers** — 指向 *任何* 模型（Wan2.1 / LTX / CogVideoX，自动检测）以匹配您的 GPU；在 CUDA / Intel Arc（XPU）/ AMD（ROCm）上运行，负载均衡 + VRAM 交换跨节点像图像生成一样，带有品牌水印和可选的 720p/1080p 提升。 网页界面 + Telegram。 参见 [docs/VIDEO.md](docs/VIDEO.md) - **网站截图**：使用 `screenshot <url>` 命令（也称为 `shot` / `ss`）进行完整页面捕获 — 在网页界面、Telegram 和 Matrix 中有效。 使用无头 Chrome（JS 感知，因此 SPA 渲染）或 Firefox 备用（参见 [要求](#requirements)）。 - **YouTube / X**：从其 **转录本** 总结视频（因此摘要和链接帖子反映实际内容，而不是页面），获取缩略图，或使用 `ytdl` 命令 **下载** 音频（MP3）/ 视频 — 在网页界面、Telegram、Matrix、Misskey 和 Pleroma 中。 视频下载可以修剪和/或缩小为一个命令（`ytdl video <url> clip 0:10 0:30 compress`）；Telegram 还提供这些作为下载后的按钮 ### PIM 与生产力 - **电子邮件**：通过 IMAP/SMTP 读取和发送邮件 - **新闻**：RSS 样式的新闻源，带有摘要（`news` / `dailynews`） - **财务（预算管理器）**：每用户预算摘要、账单和付款来自聊天（`budget`、`bills`、`pay`、`addbill`）对抗自托管的预算管理器应用 - **待办事项**：来自聊天的快速个人任务列表（`todo`) - **种子下载**：内置种子客户端 + **TorrentGalaxy** 搜索和 **nyaa.si** 动漫搜索（`torrents`、`nyaa`) - **文件存储**：每个用户和每个对话的文件存储；网页界面中的文件管理器 - **媒体工具**：上传文件并 `compress` 它（图像/视频 — H.264，具有可用 GPU 加速），`clip <start> <end>` 视频到时间段，或 `convert` 图像↔PDF — 所有这些都在网页界面、Telegram 和 Matrix 中共享 - **闪卡（学习工具）**：上传 **PDF、图像、幻灯片（PPTX）或 Word 文档（DOCX）** 并发送 `flashcards`（或 `cards`/`study`/`quiz`）以生成 **交互式多项选择题** — LLM 编写问题、选项和解释（数学问题包括工作步骤）。 网页界面显示动画卡片，具有即时 ✓/✗ 反馈和 KaTeX 渲染的数学；Telegram 显示图像卡片，具有答案按钮（点击 **🎴 Flashcards** 上传后）和运行的分数。 文本 PDF/幻灯片效果最佳；图像 OCR 较弱（在 Telegram 上，将截图作为 *文件* 发送，而不是压缩照片） - **提醒**（`remind`）：用纯语言设置提醒 — `remind open the oven in 10m`，`remind me next tuesday to call mom` — LLM 解析时间（确切的相对短语，如 `in 10s` 直接解析）。后台调度器在 **网页界面**（全屏弹出窗口 + 提示音，如果您在线）和 **Telegram** 上提醒您，如果链接了。 `reminders` 列出您的待处理提醒，每个都有可点击的 **取消**。您的时区从 **浏览器自动检测**（IANA 时区，DST 感知）— 无需设置 — 因此当您旅行时，时间随您而变化。 ### 机器人与社交 - **机器人管理器（管理员 → 机器人）**：运行自主的 Fediverse 机器人 — Pleroma/Misskey 回复机器人、 Matrix 机器人，nitter 中继，以及 blockbot/welcome/report/hashtag/unfollow 守护进程 — 来自单个管理员选项卡（添加/编辑、开/关、实时状态），由数据库支持。 机器人框架 **捆绑在此仓库中**（`botframework/`）并在进程中监督；无需单独的仓库或手动编辑的配置文件。 参见 [机器人管理器](docs/BOTS.md)。 - **Telegram 和 Matrix 机器人** 驱动聊天、命令和媒体来自您的手机 - **社交发布到 **Misskey**、**Pleroma/Mastodon**、**Matrix** 和 **Nostr**：将任何回复、链接或主题变成帖子，使用 `post` 命令（重写、逐字或您自己的指令）。 参见 [从机器人进行社交发布](#social-posting-from-the-bots)。 - **社交通知中继**：转发 Misskey/Pleroma/Matrix/Nostr 的提及/回复/DM 到 Telegram 并直接在聊天中回复。 参见 [社交通知到 Telegram](#social-notifications-to-telegram)。 - **Nostr**（密钥对身份 — 无实例，无注册）：运行 **Nostr 回复机器人** 并链接您的 `nsec` 以发布和回复。 处理提及、回复、反应、转发，以及 `geni`/图像 **效果** 和 **Nitter→Nostr** 源；发布到 **多个中继**；上传媒体到 **Blossom**（BUD-02）或 **NIP-96** 主机（例如 nostr.build）嵌入 `imeta`; 支持 **NIP-05** 验证。 机器人仅在实际被提及时（第一个提及/直接回复 — 无线程垃圾邮件）回复，**按发送者速率限制**（具有豁免列表），并且所有机器人/社交出口可以通过内置的 **Tor** 代理。 纯 Python 签名（BIP-340） — 无原生依赖项。 - **Fediverse 时间线 → Matrix 房间**：镜像一个 Misskey/Pleroma 时间线（首页/全局/本地）到单个 Matrix 房间，具有头像 + 名称、自定义表情符号、内联图像（作为标题）、引用帖子和 **对话分组为 Matrix 线程**（回复线程在其父节点下；缺少的祖先被回填）。 成员直接从 Element 操作，每个用户在其 **自己的** 链接的 Fediverse 账户（按规范 AP URI 分辨）： - **反应** ❤/任意表情符号 → 收藏（Misskey 保留确切的表情符号） · **🔁** → 提升 - **发布** 顶级消息 → 新状态（带有图像） · **在线程中回复** → 回复（自动提及作者） - **快捷方式**：`boost` / `fav` / `quote <comment>` - **分享→提升/引用**：粘贴帖子的 matrix.to 链接（添加评论以引用）以提升/引用原始作品并保留作者 - **直接消息** 保持私密 — 接收的 DM 显示在这里（不在共享房间）并且回复使其直接发送；使用 `dm @user@host <message>`（Pleroma/Mastodon）发送新的消息（Pleroma/Mastodon）。 - **Nitter 帖卡**：每个用户 Nitter（X/Twitter）RSS 源渲染为图像“帖卡”并发送到您的链接的 Telegram 聊天。 - **翻译**：翻译文本或已回复的消息到任何语言（`translate`），在网页界面、Telegram 和 Matrix 中共享。 ### 可扩展性和管理员 - **4chan** 集成（可选） - **远程节点管理**：从聊天或 Telegram 运行 OS 命令，带有长期运行的后台作业和 **工具调用的代理模式**（一个节点或所有节点）流式传输每个步骤。 参见 [远程节点管理](#remote-node-management)。 - **管理员面板**：用户、API 密钥、LLM/图像/电子邮件设置、systemd 服务设置 - **多用户**：可选的注册、电子邮件验证和配额 --- ## 要求 - **Python 3.10+** - （可选）**GPU** 和本地 LLM（Ollama、llama-cpp-python、IPEX-LLM）和图像生成（ComfyUI 或原生 diffusers） - （可选）**无头 Chrome/Chromium** 用于 `screenshot` 命令（通过 DevTools 协议 — 完整的页面感知，因此 SPA 渲染而不是空白）： - Gentoo: `emerge www-client/google-chrome`（或 `www-client/chromium`) - Debian/Ubuntu: `apt install chromium`（或安装 `google-chrome-stable`) --- ## 快速开始（后端和网页界面） > **推荐：Docker Compose（选项 A）。** PostgreSQL 是 **两个存储库**，用于 **应用程序** 和 **内置的 Nostr 中继**，因此 **在每个设置中都需要它** — 而 Compose 文件会将其启动并自动连接。 Bare-metal 安装（B）和手动设置（C）也有效，但您必须自行配置 PostgreSQL（安装程序可以做到这一点）。 Plain `docker run` 没有 Postgres 将不会启动。 ### 选项 A：Docker Compose（完全推荐） 一个 Ubuntu 镜像构建支持 **CPU、NVIDIA（CUDA）、AMD（ROCm）或 Intel Arc（XPU）** — 选择加速器并带有构建参数。它 **启动**：本地 LLM + 图像后端，自动下载推荐的聊天模型，并在 AMD 上一次运行时自动检测并行 GPU 覆盖并持久化 MIOpen 内核缓存以实现快速图像生成。 组合文件启动 **PostgreSQL**（唯一的数据存储）以便使用。 ```bash # compose（推荐 — 同时启动 Postgres）：cpu | cuda | rocm | intel | nostr docker compose --profile rocm up -d --build ``` 在 **http://localhost:3051/client** 打开 **http://localhost:3051** 并使用您的 **Nostr 密钥**（NIP-07/NIP-46）登录。 GPU 内核驱动程序来自主机（CUDA 工具包 / `amdgpu` / `i915`）；用户空间 + GPU 编译的 `llama-cpp` 被编译到镜像中。 完整的矩阵 — GPU 运行标志、模型自动下载、选择项（Tor/代理/种子下载）、opencode/OpenAI 客户端配置 — 在 **[docs/DOCKER.md](docs/DOCKER.md)** 中。 > **🟣 只想要一个 Nostr 中继 + 客户端，而不需要 AI？** `docker compose --profile nostr up -d --build` 构建一个小 (~2 GB) 镜像，**没有 AI 堆栈** — 自主中继 + Nostr 网页客户端 + Blossom。 参见 [docs/DOCKER.md](docs/DOCKER.md#nostr-only-no-ai). **生产环境：** 使用 nginx 在 HTTPS 和您的域名（以及一个真正的 `wss://…/relay`）前面进行配置 — 模板和指南在 **[docs/NGINX.md](docs/NGINX.md)** 中。 ### 选项 B：安装程序（Linux，推荐裸金属） 安装程序设置虚拟环境、依赖项、可选的 GPU 后端（LLM 和图像）、**配置 PostgreSQL**（必需 — 唯一的数据存储），并且可以配置 systemd 服务。 （如果您不想自己管理 Postgres，请改用 **选项 A / Docker Compose**。） 1. **克隆并进入项目：** ```bash git clone <your-repo-url> posterchanai cd posterchanai ``` 2. **运行安装程序：** ```bash chmod +x install.sh ./install.sh ``` 按照提示：它首先询问 **完整** 与 **仅限 Nostr**（中继 + Nostr 网页客户端 + Blossom，*无 AI* — 轻量级，无 GPU）。 对于完整版本，它然后检测您的 GPU，让您选择 LLM 后端（Ollama、llama-cpp 等）和图像后端（ComfyUI 或原生），创建虚拟环境，安装 Python 依赖项，并可选地设置 systemd 服务。 3. **启动服务器（如果不使用 systemd）：** ```bash ./start.sh ``` 或使用 systemd：`sudo systemctl start posterchanai-cpu`（或安装过程中选择的服务名称）。 4. **打开网页界面**，位于 **http://localhost:3051**（或您的机器 IP）。 登录或注册，如果启用。 **安装程序选项：** `./install.sh --help` 用于查看用法； `./install.sh --packages` 打印您的发行版所需的系统软件包。 ### 选项 C：手动设置（所有平台） 1. **克隆并进入项目：** ```bash cd posterchanai ``` 2. **创建虚拟环境并安装依赖项：** ```bash python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate pip install -r requirements.txt ``` 3. **运行服务器：** ```bash python run.py ``` 默认情况下：**http://0.0.0.0:3051** 4. **在浏览器中打开网页界面：** **http://localhost:3051**。 登录或注册，如果启用。 ### 其他选项 - **端口：** `python run.py --port 8080` 或设置 `POSTERCHANAI_PORT=8080` - **启动脚本：** 如果存在 `./start.sh`，则使用它来启动服务器。 --- ## 配置 - 复制 **`.env.example`** 到 **`.env`** 并进行调整（可选）。 - 首次运行时会创建一个 **SQLite** 数据库；使用网页界面和管理员面板进行配置： - LLM 后端（Ollama、llama-cpp、IPEX）和模型 - 图像生成（ComfyUI URL 或原生） - TTS/STT、电子邮件、插件 - 参见 **`docs/`** 以获取详细的安装说明（IPEX、nginx 等）。 社交机器人发帖 在 **用户设置 → / Pleroma / Matrix** 中连接社交账户，然后使用 **Telegram** 或 **Matrix** `post` 命令进行发布。 **Telegram** - 回复任何消息（机器人的答案、链接、图片）并发送： | 命令 | 功能 | | --- | --- | | `post` | 将回复内容重写为引人入胜的帖子 | | `post raw` | 按照原样分享回复内容 — 不重别名：`verbatim`、`as-is`、`exact`） | | `post <instructions>` | 按照您的指示重写，例如 `post professional`、`post funny and short`、`post don't` | 机器人随后会显示分享按钮（**key / Pleroma / Matrix**、**🚀 Post to All**、**❌ Skip**），适用于您连接的平台。回复图片会分享图片本身情况下，源 URL 会被追加；`post don't include links`（或“no links”、“without url”等）会省略它。 **Matrix** - 回复消息（提及机器人）**或** 在行内输入内容： | 命令 | 功能 | | --- | --- | | reply + `post` | 将回复消息重写为帖子 | | reply + `post raw` | 原样分享回复消息 | | reply + `post <instructions>` | 按照您的指示重写回复消息 | | `post <url>` | 获取链接帖子（追加 URL） | | `post <topic 编写关于该主题的帖子 | | `post raw <text>` | 原样保存 `<text>`，不重写 | | `share` | 将上一次 `post` 发布平台（`share matrix>` 选择一个房间）交通知到 Telegram 的 **Misskey / Pleroma / Matrix** 账户的新通知转发到链接的 Telegram天室，并回复它们，无需离开 Telegram用户设置 → Telegram → "Relay social notifications to Telegram"**（管理员还必须Admin → Services → Relay** 中打开，其中设置了轮询。 - 新的、回复、私信、反应/增强会被- **在 Telegram 中回复** 转发消息以在源平台上响应 — 会作为原始帖子的回复（继承其可见性）或发送到 Matrix 房间。 - **Pleroma / Misskey:** 私信可见性提及，因此它们作为普通通知到达并转发完整内容；您的回复保持 `direct`。 - **Matrix** 转发规则：**房间** 转发每个传入消息；**群组房间** 仅转发提及您的消息；您自己的消息永远不会被转发，第一个轮询会设置一个光标而不会回填历史记录。 - **加密（E2EE）Matrix 私信** 无法解密（中继没有 E2EE 支持），因此您会收到 **"🔒 您收到了一条加密消息 — 打开 Element"** 通知（每个房间每个轮询一次）。由于大多数客户端中的私信默认加密，因此这是常见情况；未加密的私信会完整转发。 - **Misskey** 必须 **重新连接一次** （用户设置 → Misskey），以便新令牌包含 `read:notifications` 权限。Pleroma 和 Matrix 无需更改。 ### 远程节点管理 从聊天室或 Telegram 运行机器人的操作系统命令。 在 **Admin → Services → Remote Node Management** 中启用，列出节点（每行一个，格式为 `name|user@host` 或 `name|local` 表示本机），并选择哪些用户可以使用（管理员始终可以使用）。远程节点通过 **SSH** 访问它们不需要安装任何东西，只需 posterchanai SSH 公钥 `authorized_keys` 中即可。这适用于任何可通过 SSH 访问的设备：服务器、路由器、交换机等。 | 命令 | 功能 | | --- | --- | | `node <name> <command>` | 在节点上运行 shell 命令。快速命令会内联返回；长时间运行的命令会成为后台作业 | | `node all <command>` | 在所有配置的节点上并行运行命令，并显示每个结果（`all` 作为节点名称保留） | | `node agent <name> <goal>` | 代理模式 — AI 调用 `run_command` 工具，读取每个结果，并朝着您的目标迭代。使用原生工具调用和代理调优模型；每个步骤流式传输到您的聊天室 | | `node agent all <goal>` | 在所有配置的节点上运行代理，朝着相同的目标（顺序；每个节点输出标记） | | `node list` | 显示配置的节点 | | `node jobs` | 列出您的近期作业 | | `node log <id>` | 显示作业 | | `node kill <id>` | 停止正在运行的作业 | 后台作业在服务器端继续运行；当作业完成时，您会收到 Telegram 私信（如果您的账户已链接）或使用 `node log <id>` 查看。 在代理模式下，每个命令都受限于超时（杀死并控/挂起的命令，以免循环死锁），并在自己的进程组中运行，以免任何东西被遗弃。 > ⚠️ **此功能按设计为无限制命令执行** — 没有确认步骤或命令允许列表。仅在受信任的私有部署上启用此功能，并保持允许用户列表严格。设置 **作业超时** （和 **代理步骤超时**），如果您想要一个硬杀死开关。 ### Telegram 大文件（可选） 云 Telegram Bot API 将机器人限制为下载 **20 MB** 以下的文件，因此 `compress`/`clip`/`convert`/`translate` 仅在小上传时有效（网页 UI 和 Matrix 没有此限制）。要提升到 **~2 GB**，运行本地 Bot API 服务器： 1. 在 **Admin → Services → Telegram Bot** 中，输入您的 **API ID** 和 **API Hash** （来自 https://my.org）并保存。 2. 设置 — `./install.sh` 并选择 **选项 5** （*Telegram Bot API 附加组件，仅限*，它仅针对现有安装设置服务器并从数据库读取凭证），或直接运行： ```bash ./scripts/setup-telegram-local-api.sh # 根据需要使用 sudo ``` 3. 返回管理 UI，点击 **测试本地服务器** （它应该变为绿色），然后勾选 **使用本地 Bot API 服务器** 和 **设置 Webhook**。（安装程序/脚本也会为您设置这些。） ### 更新（选项 6） 要升级现有安装，请重新运行 `./install.sh` 并选择 **选项 6（更新）**。它会升级 posterchanai Python 依赖项，并可选地重建本地 Telegram Bot API 服务器（`REBUILD`），然后重新启动服务。在 **Intel Arc** 安装中，它会将脆弱的 pin（`torch`/`torchvision` XPU 构建，`transformers` ）冻结在其已安装中，因此升级永远不会拉取 CPU 火炬超过 XPU 构建 — 冲突的升级被跳过而不是允许破坏 Arc 环境。 > 注意：`sync.sh` 部署 **代码**（git pull + 重启）；它 **不** 触及 Python 依赖 Telegram 服务器二进制文件。使用 **选项 6** 进行依赖项升级。 项目布局 | 路径 | 描述 | |------|-------------| | `app/` | FastAPI 应用程序、路由器（身份验证、聊天、管理员、TTS、STT、邮件、种子下载、机器人等）、服务 | | `botframework/` | 合并的自主机器人框架（Pleroma/Misskey/Matrix/nitter 监听器 + 由 `app/services/bot_manager_service.py` 启动。参见 [docs/BOTS.md](docs/BOTS.md) | | `templates/` | Jinja2 HTML（登录、聊天、管理员、模态窗口） | | `static/` |JS、图标、吉祥物资产 | | `run.py` | 服务器入口icorn） | | `requirements.txt` |依赖项 | | `install.sh` | 交互式安装程序（Linux） | | `docs/` | [ADVANCED.md](docs/ADVANCED.md) （LLM、图像、负载均衡）、IPEX、nginx 等 | --- ## 文档 - **[docs/DOCKER.md](docs/DOCKER.md)** — 快速 Docker 镜像（CPU / NVIDIA / AMD / Intel Arc）：构建矩阵、GPU 运行标志、模型自动下载、选择加入和 OpenAI 客户端/开放代码设置 - **[docs/BOTS.md](docs/BOTS.md)** — 机器人管理器：合并的 `botframework/`、管理员 → 机器人、每个机器人配置、单个服务器端点和每个节点切换 - **[docs/ADVANCED.md](docs/ADVANCED.md)** — LLM 后端、图像生成、负载均衡、Intel IPEX - **docs/** —、nginx 和其他功能文档 --- ## 许可证 **Poster-chan AI** 是免费软件，在 **[GNU 通用公共许可证 v3.0](LICENSE)** 下发布。您可以自由使用、研究、分享和修改它 — 如果您分发版本，您必须在 GPLv3 下传递相同的自由。有关完整文本，请参见 [`LICENSE`](LICENSE)。 ## 贡献 欢迎提出问题和拉取请求。保持更改小且与一致（薄路由器，服务中的逻辑）；参见 [`CLAUDE.md`](CLAUDE.md) 以了解代码库约定。