[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80315":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":13,"stars7d":13,"stars30d":15,"stars90d":14,"forks30d":14,"starsTrendScore":16,"compositeScore":17,"rankGlobal":8,"rankLanguage":8,"license":18,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":19,"hasPages":19,"topics":21,"createdAt":8,"pushedAt":8,"updatedAt":22,"readmeContent":23,"aiSummary":24,"trendingCount":14,"starSnapshotCount":14,"syncStatus":13,"lastSyncTime":25,"discoverSource":26},80315,"PixAI","fengxinzi-mulan\u002FPixAI","fengxinzi-mulan",null,"TypeScript",76,10,68,2,0,8,6,3.12,"Other",false,"main",[],"2026-06-12 02:04:00","# PixAI\n\nPixAI 是一个桌面图片生成工作台，支持 Windows 和 macOS，使用 Electron、React 和 TypeScript 构建，支持接入 OpenAI-compatible 图片生成接口。\n\n它面向本地化的 AI 绘画工作流：在多会话中管理提示词、参考图和生成参数，将生成结果保存到本地 SQLite 历史库，并提供图库检索、预览、收藏、复制、下载和参数回填。\n\n## 界面截图\n\n### 控制台\n\n![控制台界面](https:\u002F\u002Ftncache1-f1.v3mh.com\u002Fimage\u002F2026\u002F05\u002F11\u002F9ea034f922a51ecbdc2f9c8db47b006a.png)\n\n### 预览\n\n![预览界面](https:\u002F\u002Ftncache1-f1.v3mh.com\u002Fimage\u002F2026\u002F05\u002F11\u002F976f85bdb54668c3ecbebf9a052f86b9.png)\n\n### 图库\n\n![图库界面](https:\u002F\u002Ftncache1-f1.v3mh.com\u002Fimage\u002F2026\u002F05\u002F11\u002F1019050da0e76d8d7efcf8a81fb61eea.png)\n\n## 功能特性\n\n- OpenAI-compatible 接口：配置 `baseURL`、`apiKey`、图片模型和提示词辅助模型。\n- 文生图与图生图：支持会话参考图，调用 `\u002Fv1\u002Fimages\u002Fgenerations` 和 `\u002Fv1\u002Fimages\u002Fedits`。\n- 多会话工作台：每个会话独立保存 prompt 草稿、模型、比例、尺寸、质量、数量和高级参数。\n- 提示词库：内置场景模板，可检索、复制并一键套用到当前会话。\n- 并发生成与单图取消：当 `n > 1` 时并发请求，单张完成后立即写入历史并更新工作区。\n- 提示词辅助：支持一键生成灵感提示词，并对当前提示词进行丰富和优化。\n- 本地图库：支持搜索、排序、筛选、收藏、删除、批量下载、作为参考图图生图和参数回填。\n- 图片预览：支持智能缩放、滚轮缩放、拖拽平移、左右切换、复制、下载和系统全屏。\n- 本地持久化：使用 SQLite 保存会话、生成轮次和图片历史，生成图片保存到本地文件夹。\n- 桌面体验：支持白天\u002F黑夜主题、可收起设置面板、可拖拽调整会话栏宽度。\n\n## 技术栈\n\n- Electron 34\n- Electron Vite\n- React 19\n- TypeScript 5\n- Zustand\n- better-sqlite3\n- Vitest\n- electron-builder\n\n## 环境要求\n\n- Windows 10 或更高版本，支持 x64 与 ia32 安装包\n- macOS 13 或更高版本，支持 Intel x64 与 Apple Silicon arm64 安装包\n- Node.js 22 或兼容版本\n- pnpm 10\n- 可用的 OpenAI-compatible API Key\n\n项目声明的包管理器为：\n\n```text\npnpm@10.26.2\n```\n\n## 快速开始\n\n安装依赖：\n\n```powershell\npnpm install\n```\n\n启动开发环境：\n\n```powershell\npnpm dev\n```\n\n`pnpm dev` 会先按当前系统架构重建本地原生依赖，避免在切换过 x64 \u002F ia32 打包后出现模块架构不匹配。\n\n打开应用后，在右侧设置面板填写：\n\n- `baseURL`：默认 `https:\u002F\u002Fapi.openai.com`\n- `apiKey`：图片生成服务的 API Key\n- 默认图片模型：默认 `gpt-image-2`\n- 提示词辅助模型：默认 `gpt-5.4-mini`\n\n## 常用脚本\n\n```powershell\npnpm dev      # 启动 Electron + Vite 开发环境\npnpm test     # 运行单元测试\npnpm build    # TypeScript 检查并构建主进程、preload 和 renderer\npnpm preview  # 预览已构建应用\npnpm dist     # 构建当前平台安装包\n```\n\n安装包输出到：\n\n```text\ndist\u002F\n```\n\nWindows 安装包文件名会包含架构后缀，例如：\n\n```text\nPixAI Setup 1.1.2-x64.exe\nPixAI Setup 1.1.2-ia32.exe\n```\n\nmacOS 安装包文件名会包含平台和架构后缀，例如：\n\n```text\nPixAI-1.1.2-mac-x64.dmg\nPixAI-1.1.2-mac-arm64.dmg\nPixAI-1.1.2-mac-x64.zip\nPixAI-1.1.2-mac-arm64.zip\n```\n\n## 发布 Releases\n\nGitHub Releases 由 `.github\u002Fworkflows\u002Frelease.yml` 自动完成。\n\n1. 更新 `package.json` 里的版本号。\n2. 创建并推送 tag：\n\n```powershell\ngit tag v1.1.2\ngit push origin v1.1.2\n```\n\n也可以在 GitHub Actions 页面手动运行 workflow，并填写 `tag`。\n\nworkflow 会自动：\n\n- 运行测试和构建检查\n- 分别打包 Windows `x64` \u002F `ia32` 安装包\n- 分别打包 macOS `x64` \u002F `arm64` 安装包\n- 将安装包和 Windows blockmap 上传到对应 GitHub Release\n\n生成的 Release 资产包含：\n\n```text\nPixAI Setup \u003Cversion>-x64.exe\nPixAI Setup \u003Cversion>-ia32.exe\nPixAI-\u003Cversion>-mac-x64.dmg\nPixAI-\u003Cversion>-mac-arm64.dmg\nPixAI-\u003Cversion>-mac-x64.zip\nPixAI-\u003Cversion>-mac-arm64.zip\n```\n\n## 本地数据\n\n开发环境下，数据保存在项目根目录的 `data\u002F` 目录。Windows 打包安装后，数据保存在安装目录同级的 `PixAI-data\u002F` 目录，例如安装到 `D:\\Apps\\PixAI` 时数据目录为 `D:\\Apps\\PixAI-data`；macOS 打包后，数据保存在应用的用户数据目录下。\n\n从旧版本升级时，如果发现旧的 `安装目录\\data` 存在且新的 `PixAI-data\u002F` 尚未初始化，应用会在启动时自动迁移旧数据，避免安装新版时清空历史。\n\n```text\ndata\u002F\n├─ settings.json\n├─ pixai.sqlite\n├─ images\u002F\n└─ reference-images\u002F\n```\n\n- `settings.json`：服务配置和 API Key 存储状态。\n- `pixai.sqlite`：会话、生成轮次、图片历史和参考图索引。\n- `images\u002F`：生成后的图片文件。\n- `reference-images\u002F`：导入或从历史复制出的参考图文件。\n\nAPI Key 会优先使用 Electron `safeStorage` 加密保存；当系统不支持加密时，会降级保存到本地设置文件，应用会在界面中提示该状态。\n\n## 项目结构\n\n```text\nsrc\u002F\n├─ main\u002F          # Electron 主进程、IPC、SQLite、设置、图片请求、文件处理\n├─ preload\u002F       # 安全暴露给 renderer 的 window.pixai API\n├─ renderer\u002F      # React 前端界面\n└─ shared\u002F        # 主进程、preload、renderer 共享类型与工具\n\ndocs\u002F             # 设计方案与实现总结\ndata\u002F             # 开发环境本地数据，未纳入版本控制\nout\u002F              # 构建输出\ndist\u002F             # 安装包输出\n```\n\n## 接口配置\n\nPixAI 默认按 OpenAI-compatible 规范请求：\n\n```text\nPOST {baseURL}\u002Fv1\u002Fimages\u002Fgenerations\nPOST {baseURL}\u002Fv1\u002Fimages\u002Fedits\nPOST {baseURL}\u002Fv1\u002Fresponses\n```\n\n图片生成请求由当前会话参数决定，包括 prompt、模型、尺寸、质量、输出格式、背景、审核等级、流式参数和参考图。提示词辅助功能使用 `\u002Fv1\u002Fresponses`。\n\n## 测试与质量\n\n运行全部测试：\n\n```powershell\npnpm test\n```\n\n运行构建检查：\n\n```powershell\npnpm build\n```\n\n当前测试覆盖了图片参数构造、生成进度、取消逻辑、错误详情、设置存储、历史筛选、工作区摘要、预览元数据和批量下载等核心逻辑。\n\n## 文档\n\n- [设计方案](docs\u002F设计方案.md)\n- [实现总结](docs\u002F实现总结.md)\n\n## 贡献\n\n欢迎通过 Issue 或 Pull Request 反馈问题和改进建议。\n\n建议在提交前运行：\n\n```powershell\npnpm test\npnpm build\n```\n\n提交 PR 时请说明：\n\n- 变更目的\n- 主要实现方式\n- 测试结果\n- 可能影响的数据或配置\n\n## 许可证\n\n本项目采用 [PolyForm Noncommercial License 1.0.0](LICENSE)。\n\n你可以将本项目用于个人学习、研究、实验和非商业二次开发。未经 PixAI 明确书面授权，不得将本项目或其衍生作品用于商业用途。\n\n该许可证包含非商业限制，因此本项目属于 source-available 软件，不属于 OSI 定义下的开源软件。如需商业授权，请联系项目作者。\n","PixAI 是一个基于 Electron、React 和 TypeScript 构建的桌面图片生成工作台，支持 Windows 和 macOS。该项目的核心功能包括通过 OpenAI-compatible 接口进行文生图和图生图操作，多会话管理，以及本地化数据存储与检索。用户可以在多个会话中独立保存提示词、参考图及生成参数，并将结果保存到 SQLite 数据库中。此外，它还提供了丰富的图库管理和预览功能，如智能缩放、滚轮缩放等。PixAI 适用于需要在本地环境中进行高效 AI 绘画创作的工作流场景，尤其适合那些希望保留完整创作历史并能方便地回溯和再利用素材的设计师或艺术家使用。","2026-06-11 04:00:18","CREATED_QUERY"]