Repository navigation
Releases: yangsir2077/pixel-loom
Release list
Pixel Loom 0.7.17 · 创作协作与工作流精简
Pixel Loom(像素织机)0.7.17 公开测试版,源码采用 MIT 开源许可。
本次更新
- 可选创作协作:沿用同一份任务记录,按需规划画面、光照和局部细节;一张对照图查看整体、局部及参考。
- 客户端生图衔接:由用户选择原生绘制或外部生图路线。MCP 可整理需求、预览原图与自动像素底稿,调整尺寸/色数后保存为独立工程。应用本身不调用生图模型、不存储 API 密钥。
- 减少重复:精简无关指南、重复步骤和重复画面;调整同一张生成图时,可以省去重复传回已查看的原图。普通绘制无需走额外流程。
- 数据与兼容保护:保留原有绘画、图层、动画、抠图、项目历史、审查及 Aseprite JSON/Godot 导出。候选过期或输入发生变化会明确拒绝;重复提交不会生成重复工程,保存异常提供恢复信息。
- 更干净的发布包:只收录正式说明和完整源码、测试,排除本地设计草稿和运行缓存。
下载与启动
直接使用请下载 pixel-loom-0.7.17-windows-x64.zip,完整解压后运行根目录 打开像素织机.cmd,或 app/PixelLoom.exe。无需另装 Python,保留整个 app 文件夹与 _internal。
pixel-loom-0.7.17-source.zip、GitHub 的 Source code 和 git clone 是源码,不含便携版 exe。
升级前保存作品并关闭旧版窗口。AI 客户端改用新版 app/PixelLoomMCP.exe --mcp,重新加载 MCP 后调用 pixel_onboard 确认连接。新增方法由 MCP 内置说明按需提供,无需另发工作流文档;抠图、补图和动画仍按用户需要使用。
验证
本机完成 284 项单元测试(282 项通过,2 项因 Windows 符号链接权限跳过)、34 组流程回归,以及打包后的新客户端和双客户端并发测试。对应源码提交还通过 GitHub 的 Windows/Linux、Python 3.11/3.12 四组自动测试。校验值见 SHA256SUMS.txt,详细范围见 validation-report.json。这些测试验证软件流程,不是所有 AI 美术能力的保证。
0.7.16 等历史版本保留,各版本拥有独立标签和下载附件。
Pixel Loom 0.7.16 · 动作审查与游戏引擎导出
Pixel Loom(像素织机)0.7.16 公开测试版,源码采用 MIT 开源许可。
下载与启动
- 直接使用 Windows 应用:下载 pixel-loom-0.7.16-windows-x64.zip。
- 完整解压
PixelLoom文件夹,双击根目录的 打开像素织机.cmd,或运行app/PixelLoom.exe。无需另装 Python,保留整个app文件夹及_internal运行库。 pixel-loom-0.7.16-source.zip、git clone和 GitHub 的 Source code 是源码,不包含可直接运行的 exe。- 附件
SHA256SUMS.txt提供校验值,validation-report.json提供测试结果与对应源码提交。
主要改动
- 按动作审查、整图集导出:idle、run 等动作可分别设置审查要求;各动作通过后可合并导出整张图集。只修改一个动作时,未受影响动作的通过记录继续有效。整图约束、未命名帧及图层范围仍会检查。
- 新增可选引擎格式:在原来的导出窗口选择 Aseprite JSON Hash、Array 或 Godot 4 SpriteFrames。原生 JSON 保持默认,既有读取方式不变。Godot 格式同时输出 PNG、JSON 和相对引用的
.tres,保留动作、逐帧时长与循环/单次要求。 - 更清楚的 API 校验:未知参数不会静默成功;审查报错指出缺失、未知或重复的检查项,接受一致的结论同义词。设置默认合并,可显式替换或清空。
- 减少重复传输:保存、反馈、审查设置和提交支持可选简短回复;已有完整回复兼容保留。工具说明按需读取,不加入写死的成品。
- 连接与定位修正:界面生成的 MCP 配置携带当前数据目录和工作区;遇到正在运行的不同版本会明确提示。AI 审查图统一采用从 0 开始的源帧号,编辑器时间轴显示习惯保留。
- 导出保护保留:正式导出仍需要当前范围的通过记录,草稿需显式选择;多文件导出共用覆盖保护,避免同名旧 Godot 资源引用不匹配的新图集。
升级与 MCP
先保存工程,关闭旧版应用及占用旧版的 MCP 服务,将新版解压到独立文件夹。已有作品与项目记录保留在用户数据目录。
AI 客户端使用新版 app/PixelLoomMCP.exe --mcp;路径变化后,在 更多 → MCP 首次接入配置 获取新版配置并重新加载 MCP。自定义数据目录/工作区请使用界面生成的完整参数。接入后调用 pixel_onboard,再按需读取自带制作、检查和导出指南,无需额外提供工作流文档。
Godot 使用 PNG 与 .tres 配套导入,并设置最近邻过滤。需要逐像素保留半透明光晕颜色时,在 Godot 的 PNG Import 中关闭 Process → Fix Alpha Border 后 Reimport;工具不会修改用户的引擎工程设置。Aseprite JSON 是交换格式,不是 .aseprite 工程。
验证
- 本地 257 项单元测试:255 通过,2 项因符号链接环境条件跳过;13 组便携 MCP 回归通过。
- 重新执行 6 项目游戏素材流程;四种图集格式像素一致,原生场景 PNG 与 48 帧 GIF 保持一致。
- Godot 4.6.3 实际导入、21 帧游戏素材核对及循环/单次播放测试通过。
- 全新 AI 仅依靠 MCP 内置说明完成分层创作、局部反馈修改、旧版保留、检查和三种格式导出;Godot 另作实际验证。此测试不保证不同 AI 的画技与耗时一致。
- 最终便携包解压校验通过;未包含用户作品、会话令牌或个人客户端配置。Windows 便携版经过本地验证;未实际执行 Unity、Phaser 导入器。
Pixel Loom 0.7.15 · 简洁工作区与滚动修复
Pixel Loom(像素织机)0.7.15 公开测试版,源码采用 MIT 开源许可。
布局与使用体验
- 合并顶栏,突出画布;绘画时右侧分为 图层 / 调色 / 操作,图层列表独立伸展,不再被长调色板挤走。
- 帧时长与播放速度集中到时间轴;从预览返回绘画时记住上次的编辑面板。
- 统一暗色、字号、间距、工具图标、平面页签和滚动条;支持的 Windows 系统使用深色标题栏。
修复
- 修复多图层和长图层名无法完整查看、刷新后跳回顶部的问题。
- 修复色块和嵌套列表抢走滚轮事件,以及时间轴后续帧被裁切的问题;按实际按钮位置定位当前帧。
- 项目列表和工作流进度刷新保留阅读位置;为版本记录、固定部位、命令列表和存储详情补齐滚动入口。
- 保留绘画、动画、按需抠图、截图反馈、项目版本、清理、导入保存导出及原有 MCP 工具;旧工程可继续打开,文件格式不变。
下载与使用
Windows 用户下载 pixel-loom-0.7.15-windows-x64.zip,完整解压后运行根目录 打开像素织机.cmd,或 app/PixelLoom.exe;无需另装 Python,保留整个 app 文件夹及 _internal 运行库。
git clone、Source code 和 *-source.zip 是源码,不包含便携版 exe。更新前保存工程并关闭旧应用;MCP 使用包内 app/PixelLoomMCP.exe --mcp,替换应用后在 AI 客户端重新加载 MCP。
验证
- 本机及全新源码环境:208 项单元测试通过,2 项因本机符号链接限制跳过;10组源码 MCP、10组便携版 MCP、14组本机界面流程通过。
- 解压下载包后再次验证5组 MCP;包内 133份源码与本次提交逐文件一致,1267个运行文件校验通过。两份可执行文件各44个应用代码模块与源码一致,7份流程指南一致,附28项依赖组件许可。
- Windows/Linux × Python3.11/3.12 四组 CI 通过;附源码、SHA-256 校验值和验证报告。
源码提交:5b77d8def0ffec3e05d59bfa88bea4998aeeedb1。
Pixel Loom 0.7.14 · 工作流整合与 MCP 传输优化
Pixel Loom(像素织机)0.7.14 公开测试版,完整源码采用 MIT 开源许可。
工作流与检查
- MCP 自带按任务读取的说明:文字静态创作、图片转像素、局部修改、按需补齐和动画。默认先完成静态作品和干净的可编辑物件层。
- 图片转换保留自动底稿的尺寸、调色板和合成效果;隐藏区域未要求补齐时保留未补状态,动画由用户另行要求。仅打开工程或导入参考不会自动开始制作。
- 新增
pixel_task保存简短任务摘要、进度、图层检查和下一步。检查过的像素改动后会标为待重看;记录不改画布、不增加绘画版本,保存在本机数据目录。 - 用独立图层预览检查残片、边界和遮挡归属,再检查合成;沿用现有逐帧/时序验收、撤销和历史版本。不是自动语义分割或内置成品生成器。
更少重复传输
pixel_onboard(task=..., compact=True)引导新 AI 读取对应说明,无需用户额外发送工作流文档。- 简要状态/回复、条件状态和未变预览复用;详细操作参数按需读取,保留旧接口完整调用方式。
region_copy新增 polygon/holes 蒙版复制,保留原图 RGBA,方便 AI 以原生操作拆分可见物件。- 修复简要验证/版本对比中的信息缺失,明确项目 ID 与文档 ID 的区别和恢复方法。
桌面与兼容
- 项目多时可以滚动、使用左右箭头或完整列表;切换和缩放窗口后自动显示当前项目。
- “更多 → AI 工作流与进度”按需查看,不增加常驻侧栏。
- 原有手动画图、动画、按需抠图、导入导出、保存、撤销和历史版本继续保留。旧工程无需迁移,不自动拆层或补绘。
下载与升级
下载 pixel-loom-0.7.14-windows-x64.zip,完整解压 PixelLoom 文件夹,双击根目录 打开像素织机.cmd,或运行 app/PixelLoom.exe。无需另装 Python,请保留完整 app 文件夹。
git clone、Code → Download ZIP、Source code 和 *-source.zip 提供源码,不带便携版 exe。
升级前保存工程并关闭旧应用。MCP 指向新版 app/PixelLoomMCP.exe --mcp,重新连接后调用 pixel_onboard 检查版本和能力;路径改变时可从“更多 → MCP 首次接入配置”重新获取配置。工作摘要和迭代记录位于本机数据目录,单独复制 .pixloom 不会复制这些本机记录。
验证
- 本机及全新源码环境:208 项单元测试通过,2 项因本机符号链接限制跳过;10组源码 MCP、10组便携版 MCP、12组本机界面流程通过。
- 解压下载包后再次验证5组 MCP;包内 131份源码与本次提交逐文件一致,1267个运行文件校验通过。两份可执行文件各44个应用代码模块与源码一致,7份流程指南一致,附28项依赖组件许可。
- Windows/Linux × Python3.11/3.12 四组 CI 通过;附源码、SHA-256 校验值和验证报告。
三名全新上下文 AI 仅从 MCP 自带说明完成了隔离场景测试,覆盖静态创作、分层、动画、局部修改、抠图、版本与边界情况;发现未授权补齐需求时保留中间工程并报告问题。它们测试的是简单夹具,不能保证所有 AI 或复杂人物都具有相同的美术水平。图层归属和画面美感仍需 AI 实际看图判断。
源码提交:f02146562b59ec20bc440bac4651a17fed56ded5。
Pixel Loom 0.7.13 · 按需去背景与 MCP 工具
Pixel Loom(像素织机)0.7.13 公开测试版,完整源码采用 MIT 开源许可。
下载与启动(先看这里)
- 普通使用者选择本页 Assets(资源) 中的 pixel-loom-0.7.13-windows-x64.zip。
- 完整解压,打开解压得到的 PixelLoom 文件夹,双击 打开像素织机.cmd;或进入 app 文件夹双击 PixelLoom.exe。
- 保留完整的 app 文件夹(包括 PixelLoomMCP.exe 和 _internal)。便携版无需另外安装 Python。
git clone、Code → Download ZIP、*-source.zip 和 Source code 下载的是源码,不包含便携版 exe。 从源码运行时先进入含 pyproject.toml 的 project 目录,再按源码启动说明安装依赖并启动。
桌面编辑器叫 PixelLoom.exe,不是 Pixel_workbench.exe。AI 客户端使用 app/PixelLoomMCP.exe 的真实绝对路径,参数为 --mcp;读取说明本身不会注册 MCP。升级前保存作品,更新后重新加载 MCP。
最新使用手册(已修订下载和启动说明) · 统一入口与常见问题
按需去背景
- 入口:导入参考 → 去背景。默认导入、生成像素底稿和绘画都不自动抠图,需要时才打开。
- 并排查看原图和透明效果,支持点选背景、去除强度、柔和边缘、保护区域及去除蒙版;确认后才应用。
- 保留原图和原文件,每次调整从原图重新计算。支持抠图撤销、重做、恢复原图及透明 PNG 导出;已经画好的画布像素保持不变。
- 调参后预览尚未完成或尚未应用时,拦住导出,避免导出旧效果;过期或失效的预览需要重新查看和确认。
AI / MCP 使用
pixel_onboard和工具说明提供按需使用入口,pixel_help(topic="cutout")自带适用条件、参数、检查和修边方法,无需另发文档。pixel_cutout_preview返回原图、抠图效果、去除蒙版及preview_id,预览不修改数据。用base_preview_id增量调参,可保留上一份预览的保护区域。pixel_cutout提供应用、撤销、重做、恢复原图及导出;校验实际工程与参考版本,拒绝旧预览。
这是本地颜色、连通区域与蒙版处理,不内置语义分割模型,不下载模型或上传图片。适合纯色和简单背景;复杂场景、同色衣物、发丝、玻璃等仍可能需要保护区域或蒙版精修。参考图最长边上限1024像素,抠图 PNG 使用该存储尺寸;动画输入仅处理第一帧。含抠图参数的工程请使用0.7.13打开。
验证
- 本机及源码包全新环境:189 项单元测试通过,2 项跳过。
- 9组源码 MCP、9组 Windows 便携版 MCP、10组本机界面流程通过;覆盖按需使用、预览、调整、保护、撤销/重做、导出、失效预览拒绝和原图保留。
- 发布包解压后验证接入、抠图、工作流发现和成品检查;包内 121份源码文件与本次 Git 提交逐文件一致,1940个运行文件校验通过。
- Windows/Linux × Python3.11/3.12 四组 CI 通过。附带47项依赖组件许可声明、SHA-256校验值和验证报告。
源码提交:c837dae4065bc8655a7583a6a8776d66271f8525。
Pixel Loom 0.7.12 · MCP 制作与检查工作流
Pixel Loom(像素织机)0.7.12 公开测试版,完整源码采用 MIT 开源许可。
MCP 自带制作与检查工作流
- 新接入的 AI 调用
pixel_onboard,即可获得简明制作步骤和下一步读取入口,无需使用者另外提供工作流文件。 pixel_help(topic="workflow"):明确规格、设计轮廓与配色、分层、原生绘图、分批迭代。pixel_help(topic="animation_workflow"):固定与运动部分、支点和时序、可选的客户端坐标计算、清空旧运动像素、避免残影。pixel_help(topic="inspection_workflow"):查看全帧、局部、真实时序与首尾,修复后重新取证,如实验收并保存导出。- 支持资源的客户端也可读取
pixel-loom://workflow;绘制、动画及完成检查提示词同步提供方法入口。 - 指南随便携版 MCP 程序分发,按需读取;未新增成品预设、内置绘画模型、任意脚本执行器或复杂界面。画面设计与看图判断仍由接入的 AI 完成。
下载与接入
Windows 下载 pixel-loom-0.7.12-windows-x64.zip,完整解压 PixelLoom 文件夹,运行 打开像素织机.cmd 或 app/PixelLoom.exe。便携版附带运行库、完整源码与说明,无需单独安装 Python,请保留整个 app 文件夹。
升级前保存工程并关闭旧窗口;客户端命令指向新版 app/PixelLoomMCP.exe,参数 --mcp,重新加载 MCP 后调用 pixel_onboard 确认版本。目录变化时可从“更多 → MCP 首次接入配置”获取配置。普通图片默认只转换自动像素底稿。
验证
- 本机与源码包全新环境:176 项单元测试通过、2 项环境相关测试跳过。
- 8 组源码 MCP、8 组原生便携版 MCP 流程及本机界面基本流程通过。
- 两个全新标准 MCP 会话仅通过工具说明发现三份指南,并验证绘制、残点修复、旧检查失效、重新验收、保存和导出。此项验证协议流程,不等同于测试所有 AI 模型的美术水平。
- 发布包解压后的接入、工作流和自检流程通过;Windows 包内 115 份源码文件与本次 Git 提交逐文件一致,1940 个运行文件校验通过。
- Windows/Linux × Python 3.11/3.12 四组 CI 通过。保留47项依赖组件的许可声明,附件提供源码、SHA-256校验值与验证报告。
源码提交:01e2f602bf24cfe8c1bce4c7c07a84207ef60bf3。
新对话接入验证
已在不继承旧聊天、未提供额外工作流文档或现成素材的全新对话中验证:AI 从 0.7.12 MCP 自带说明发现制作、动画与检查方法,使用通用原生绘图工具完成 64×64、12 帧、1.2 秒透明循环的魔法提灯。AI 自行检查全帧与时序、修正亮度突变,保存了包含 6 个图层的可编辑工程,并导出 GIF 和 PNG。
Pixel Loom 0.7.11 · 存储管理与 AI 清理
Pixel Loom(像素织机)0.7.11 公开测试版,源码采用 MIT 开源许可。
存储管理与 AI 清理
- 更多 → 存储管理:查看占用、预览清理范围,再执行清理。
- 项目 → 版本记录:多选删除旧版本、★ 标记保留;默认保护最新及标记保留的版本。
- 项目管理 → 已删除:选中项目后彻底清理。普通删除仍可恢复,彻底清理不可撤销。
- 新增 MCP
pixel_storage(统计/只读预览)和pixel_cleanup(执行具体计划)。pixel_help(topic="cleanup")提供中文用户指令与准确操作的对应说明。 - 用户可以直接对自己的 AI 说:“清理缓存,作品和历史不要动”“当前项目只保留最近20版,标记保留的别删”“删除我选中的旧版本”。已明确授权的同一范围无需反复询问;模糊的“清理一下”只处理无用缓存。
- 工程、目标文件或保留标记变化后,旧计划失效;重复执行已完成计划只返回原结果。当前作品、独有的未保存恢复稿、使用中的检查预览、外部原件、应用运行库及客户端配置受保护。不会自动删除历史作品。
- 项目、版本、清理清单按需分页返回;大量数据分批清理,一份版本与说明不拆开,已删除项目的文件清完后才移除记录。清理结果包含实际删除数量、释放空间及失败项。
下载与连接
Windows 下载 pixel-loom-0.7.11-windows-x64.zip,完整解压 PixelLoom 文件夹,运行 打开像素织机.cmd 或 app/PixelLoom.exe。便携版附带运行库、完整源码和说明,无需另装 Python,请保留整个 app 文件夹。
升级前保存工程、关闭旧版窗口;重新打开新版并重新加载 AI 客户端的 MCP。MCP 入口是 app/PixelLoomMCP.exe --mcp,路径变化时从“更多 → MCP 首次接入配置”获取配置。调用 pixel_onboard 确认连接;普通图片仍默认只转换自动像素底稿。
验证
- 本机 171 项单元测试通过,2 项环境相关测试跳过;9 组界面、7 组源码 MCP、7 组原生便携版 MCP 流程通过。
- 独立源码环境及下载包本地解压后,通过公开、项目迭代和双客户端清理流程;包内源码与本次 Git 提交一致。两个原生入口各38个应用模块与源码核对一致,1937个运行文件校验通过。
- Windows/Linux × Python3.11/3.12 四组 CI 通过。附件提供源码、SHA-256 校验值和验证报告,保留47项依赖组件的许可声明。
源码提交 cec87f40127e7e7c8508d9e9dfae34bd250c9fbd。
Pixel Loom 0.7.10 · AI 工具与项目版本记录
Pixel Loom(像素织机)0.7.10 公开测试版,源码采用 MIT 开源许可。
定位与改动
这是一套给用户自己的 AI 使用的像素创作工具,配套工具说明和 MCP 接口;桌面编辑器让用户直观看到结果、自行创作、修正细节,并完成导入、保存与导出。内容、风格和动作由用户及其 AI 决定。
- 移除写死的像素特效生成器、相关 MCP 工具和自动载入的示例作品。保留通用像素绘图、图层、逐帧动画、局部检查、预览、撤销和基础文件功能。
- 项目 → 版本记录:AI 每批修改自动保留完整可编辑版本,显示时间、来源和修改说明。保存前的底稿迭代也会归入项目。
- 在一个窗口选择版本,与当前效果并排播放或逐帧比较,再“选用这版,继续修改”。项目身份保持不变,当前版与其他迭代保留;选用本身也可撤销。历史窗口打开后若作品发生改动,需要刷新后再选择。
- 通过已有
pixel_projects使用versions、version_preview、use_version,AI 使用说明包含观察令牌、实际图像对比和不覆盖作品的流程。记录保存在本机用户数据目录,不随单个.pixloom文件复制,不自动清除。 - 旧 0.7.9 工程的像素、图层、帧时长与旧元数据仍可完整打开和保存,不会执行生成器。
下载与使用
Windows 下载 pixel-loom-0.7.10-windows-x64.zip,完整解压 PixelLoom 文件夹,运行 打开像素织机.cmd 或 app/PixelLoom.exe。便携包附带运行库、完整源码和使用文档,无需另装 Python;保留整个 app 文件夹和 _internal。
升级前保存工程并关闭旧版窗口。MCP 客户端注册 app/PixelLoomMCP.exe --mcp,路径变化时在“更多 → MCP 首次接入配置”获取配置,并重新加载 MCP。调用 pixel_onboard 确认连接。普通图片默认转换为自动像素底稿;艺术重绘需用户明确要求。
验证
- 本机:156 项单元测试通过,1 项环境相关测试跳过;8 组界面、6 组源码 MCP、6 组便携版 MCP 流程通过。
- 独立环境安装源码 ZIP 后,单元测试与公开 MCP/版本迭代流程通过;Windows 下载包本地解压后,再次通过公开 MCP 与双客户端迭代流程。
- 两个原生入口各 36 个应用模块与源码一致;1937 个运行文件校验通过。包内项目源码对应本次 Git 提交,保留 47 项依赖组件的许可声明。
- Windows/Linux × Python 3.11/3.12 四组 CI 通过。附带源码、SHA-256 校验值和验证报告。
对应源码提交 31b7f670c19d4d904102554537a757a8163a34dd。