图序社区版 v0.7.1

本版修复生图恢复、供应商错误提示、文档导入导出和图片检查后的导航，并改进 Codex 原生连接探测。下载 v0.7.1 · 本版更新说明

把文章变成可审阅的配图方案，再把选中的画面插入文档。

图序是一个本地运行的开源文章配图工作台。你可以导入科普、新闻、小说或报告，检查建议图位，用简单导演台选择风格、明暗和物体摆放，确认后生成、选图并导出新文档。生成结果需要人工审阅。

Tuxu Community is a local-first, open-source article illustration workbench. Review image suggestions, adjust simple visual direction, approve generation with your own provider or a supported Codex host, then export an editable document. See the short English introduction.

界面预览

图序电影式首页

简明导演台

现有截图展示八套早期首页和六个关键页面。工作台截图使用明确标注的模拟数据。查看界面截图 · 查看新增场景

已有功能

一键生成与人工设置可切换：新导入文章可一次授权本地分析、语义配图、自动选用全部有效图片并导出图文文档；最多5张，每张一次，失败或结果未知停止，原稿不覆盖。
工作台支持日间、夜间和跟随系统。跟随系统按电脑本地时间切换，07:00 至 19:00 前为浅色，其余时间为深色。一键制作与外观
内置视觉导演通过 Ollama 执行文章分析、提示词编写与可选的本地图片检查。自动检查默认关闭，开启后仅用于新授权。内置视觉导演设置
导入 DOCX、Markdown、TXT 或粘贴文字；本地 Ollama 分析文章并建议图位。
对照原文修改配图描述、段落位置、图注和比例；支持保存零图方案。
简单导演台：14 种风格选项、3 档明暗、可选背景、物体拖放与九宫格位置。相机、光线与精确数值默认折叠。
根据段落语义推荐画风并标注“（推荐）”，新图位默认采用推荐，手动选择保存后优先。
全部生图路线的完整提示词均由本机 Ollama 生成，云端生图 API 不替代本地文字分析。
生图前明确确认服务、画面范围和尝试上限；修改方案后重新授权。
自带 API 密钥（BYOK）接入豆包/火山方舟或 GPT 兼容图像 API，也可使用本地 ComfyUI。
本机智能体自动生图：一次本机设置后，已授权任务由固定本机 runner 自动执行、验证并回填；包含 Codex 原生模式与通用 runner 协议，见本机智能体设置。不附带账号、密钥或生图额度。
通用 CLI / 本机 HTTP 适配器与配置模板，支持连接其他具备生图能力的本机智能体；文字模型参数与最低硬件估算。
提供 Hugging Face 官方模型和 Ollama 量化版下载入口与安装说明；图序默认使用本机 Q4_K_M 量化版。
候选图片人工选用，轻度中值降噪与 Lanczos 插值放大，导出 DOCX、Markdown 图片包和 HTML；不覆盖原稿。
本地任务记录、版本失效检查、未决请求恢复与云模型验证状态。

“候选模型可见”“API 配置完整”“实际生图成功”是不同状态。供应商权限、账户状态和输出效果以你的实际调用为准。社区版不附带账号、密钥或模型权重，使用上述公开模型入口自行安装。

快速开始

需要 Python 3.12+、Node.js 22.18+ 和 npm。支持 macOS/Linux。Windows 可在 WSL 的 Linux 环境中尝试运行；本版本不支持原生 Windows。全文分析需要一个已安装、运行的 Ollama 模型；本地生图模型是可选项。

从本仓库获取源码后，在仓库目录执行：

./setup.sh
./start.sh

打开 http://127.0.0.1:8766。停止服务：

./stop.sh

应用使用独立的 TuxuCommunity 用户数据目录。需要自定义时，在启动前设置 TUXU_DATA_DIR；不要把密钥、稿件或数据库加入 Git。

完整步骤见安装与运行和模型配置。

文字模型下载

Hugging Face 官方 Qwen2.5-VL-7B-Instruct 提供上游开源模型，许可为 Apache-2.0。Ollama qwen2.5vl:7b 是图序当前使用的 Q4_K_M 量化包，约6GB。两者是同一基础模型的不同发布格式，原始权重不直接替代 Ollama 模型包，内存估算也不同。详见模型来源与安装。

ollama pull qwen2.5vl:7b

启动 Ollama 服务后，在图序中使用相同模型名。需要准备应用的 Python/Node 运行环境和自己的生图工具；不附带账号或额度。Mac 的 M1/16GB起点估算仅针对该量化版，详见硬件估算。

从文章到文档

导入有权使用的文章，选择本地文章理解模型，开始分析。
对照原文检查建议，修改或删除图位；不需要插图时可保存零图方案。
进入导演台，选择风格、明暗和大致摆放，保存画面设置。
选择已配置的生图路线，核对外发范围并确认授权，再提交生成。
检查真实图片中的物体数量、文字、事实和构图，选用合适候选。
检查插入预览、图注与编号，导出新文档，并在 Word/WPS 等阅读软件中复核分页。

更多操作见使用说明。

开源与私有边界

本仓库包含公开的通用分析/生图基础模板、简易视觉映射和工作流实现，采用 Apache-2.0。前端只展示简短画面描述，不直接显示完整生成文本；这属于界面与数据输出设计，不代表源码模板保密。

高级私有模板、私有策略、收费托管服务及其运营系统不包含在本仓库中，也不是运行社区版的前提。第三方模型、API、字体和素材各自适用其许可及服务条款。

当前局限

AI 可能遗漏主体、增添物件、生成畸形或错误文字；风格和明暗是生成指导，物体方框不是像素级位置锁定。
科研与新闻画面应明确标注为生成示意，不能冒充实验结果、现场照片或证明材料。
DOCX 导入与重建导出不承诺保留所有复杂排版、公式、修订、脚注、浮动对象或原分页；请保留原文件并人工复核。
“降噪与放大”是传统图像处理，不是 AI 超分；不会修复缺失主体和事实错误。
当前以本机单用户使用为目标，不包含公网账户体系、多租户、计费或生产云部署。
Codex 原生模式要求兼容 CLI 与用户自己的 ChatGPT 登录态及可用图片工具。配置完整不等于账户能力或生成成功；不支持时明确停止，未决请求不自动重发。图像计算可能发生在智能体提供方，不能将“本机调用”解释为离线免费生图。

详细边界见使用说明和安全说明。

参与开发

参见开发说明和贡献指南。请使用自制或明确授权的最小样稿，区分 Mock 验证与真实模型输出。报告安全问题前先阅读安全报告方式，不要在公开 Issue 上传密钥、数据库或完整稿件。

电影式首页与统一工作台

十八套场景按访问随机取用，避免相邻访问重复。同次访问保持同一场景。新增视频以首帧静图淡化衔接重播，关闭动效或启用系统的减少动态效果设置时显示静图。界面说明