yangsir2077 / pixel-loom

# Pixel Loom · 像素织机
**0.7.17 公开测试版**：增加可选的整体／局部创作协作和客户端生图衔接，精简重复说明与预览传输。原有绘画、图层、动画、抠图、项目版本及引擎导出功能保留。源码采用 MIT 开源许可，历史版本可在发布页中分别下载。
## ⬇ 下载 Windows 便携版 · 0.7.17
下载后**完整解压**，双击 **打开像素织机.cmd** 即可使用，无需安装 Python。
查看发布页、版本说明与校验值 · 使用说明 · 反馈问题
> **想直接使用，请点上面的 Windows 下载链接。** 本页的 `git clone`、**Code → Download ZIP**、`*-source.zip` 和 **Source code** 下载的是源码，不包含可直接运行的 `app` 文件夹或 exe。
**Windows 便携版 · 使用者和 AI 的统一入口**
新增按需去背景：**导入参考 → 去背景**。原图/效果预览、点背景、强度调整、保护区域、应用/撤销/重做及透明 PNG 导出；默认导入和转换不自动抠图。AI 可从 MCP 内置说明发现并使用。
这是一个面向 AI 的像素创作工具，也是供用户查看、创作和修改作品的可视化编辑器。AI 通过 MCP 和配套说明使用通用绘图与动画工具；用户直观看结果、手动修细节，并使用导入、保存和导出等基础功能。普通使用不需要打开源码或测试文件，也不需要单独安装 Python。
0.7.12 已加入 MCP 自带制作与检查流程：新接入的 AI 从 `pixel_onboard` 取得方法入口，按需读取制作、动画和检查指南，无需使用者另发工作流文档。
0.7.10 专注通用绘图、图层、动画编辑、检查与 MCP 工具。内容、风格和动作由使用者自己的 AI 决定；不提供写死的特效生成器，不自动载入示例作品。0.7.9 工程仍能完整打开和编辑。
**项目 → 版本记录** 自动保留 AI 的每批修改。查看时间、说明和来源，并排播放或逐帧比较，选用喜欢的一版继续编辑；当前版和其他迭代都会保留，不必新建一堆项目。用户明确选择清理时可删除旧版本，默认保护最新和标记保留的版本。
## 1. 先打开应用
1. 下载 **pixel-loom-0.7.17-windows-x64.zip**，或在发布页的 **Assets（资源）** 中选择这个文件。
2. 完整解压，打开解压得到的 **PixelLoom** 文件夹；不要直接在压缩包里运行。
3. 双击根目录的 **打开像素织机.cmd**，或进入 **app** 文件夹双击 **PixelLoom.exe**。Windows 便携版不需要另装 Python。
 [code] 
### 已经 git clone，却找不到 exe？
这是源码下载方式的正常结果。**直接使用请下载 Windows 便携版**；想从源码运行，按第 6 节先进入 `project` 目录安装依赖再启动。
| 你要做什么 | 使用哪个入口 |
|---|---|
| 打开便携版画画、看作品 | `打开像素织机.cmd`，或 `app/PixelLoom.exe` |
| 让 AI 接入便携版 | 在 AI 客户端注册 `app/PixelLoomMCP.exe`，参数 `--mcp` |
| 从源码运行／开发 | 先进入含 `pyproject.toml` 的 `project` 目录，见第 6 节 |
如果你已经进入 `app` 目录，直接运行里面的 `PixelLoom.exe`。`pixel_workbench` 是源码模块名；当前桌面程序名是 `PixelLoom.exe`，无需寻找 `Pixel_workbench.exe`。`PixelLoomMCP.exe` 由 AI 客户端启动，手动双击后的控制台不是编辑器窗口。
启动后会显示使用说明。点击“了解，进入”、按 Esc 或关闭说明即可直接使用全部功能。打赏完全自愿；选择 5／10／15／20 元后显示作者提供的对应微信收款图，不检测付款、不解锁额外功能。
**分发应用时，保留整个 `app` 文件夹。** `_internal` 是必需运行库，不能只拿走一个 exe。普通使用者只需要应用和这份说明。
### 检查更新
“更多 → 检查更新”可查看新版本、更新说明并打开 Windows 便携版下载。桌面启动后也会在后台检查；发现新版显示可关闭的提醒，不打断绘画。成功检查后，24 小时内不重复自动查询，手动检查不受这个间隔限制。
更新窗口可关闭启动检查，也可选择是否包含公开测试版（0.x 版本默认包含）。离线或查询失败时，软件继续正常使用，仍可直接打开发版页面。只有点击下载或发布页按钮时才打开浏览器，不自动安装或覆盖程序。
版本检查只请求 GitHub 的公开发布信息，不上传作品、参考图、工程路径或 AI 客户端配置；偏好和检查时间保存在用户数据目录，不在交付目录。无窗口 MCP 服务不会自动检查网络。旧用户需要先手动安装包含此功能的版本，之后才能收到提醒。
## 2. 目录说明
 [code] 
`project/tests` 是用于维护项目的正式测试代码，保留它便于开源贡献者验证修改；它不属于日常使用流程。测试日志、临时工程、验证环境和构建缓存不放在此交付目录中。
作品、参考图和历史记录保存在用户数据目录，通常不在这里。同一台电脑看到旧作品，是应用读取了已有用户资料。整理本目录不会删除这些作品。
## 3. 给 AI：接手后按这个顺序
接入后不需要使用者额外提供制作文档：读取 `pixel_onboard.creation_workflow.read_next`，调用 `pixel_help(topic="workflow")`；动画任务再读 `animation_workflow`，交付前读 `inspection_workflow`。指南随 MCP 返回，包含造型/分层、可选客户端坐标计算、清理旧运动像素、看图修正和完整自检；不包含成品生成器。资源客户端也可读取 `pixel-loom://workflow`。AI 仍需具备看图和设计能力，流程不能保证所有模型达到相同水平。
1. 找到名称以 `pixel_onboard` 结尾的 MCP 工具并调用 `{}`。客户端可能添加前缀，不要写死完整工具名。**读取本说明不会自动建立 MCP 连接。**
2. 读取返回的 `current_document`、`document_id`、`revision`、实际保存路径、图层、帧、参考、反馈和自检状态，再查看实际图像。不要假定是空白工程。
3. 新作品用 `pixel_projects(action="new")`；已有作品的新动作或变体先 `fork`。先保存当前作品，不能把待机覆盖成行走。修用户指出的问题时继续对应项目，不擅自删除或替换其他作品。
4. 用 `pixel_help(operation="polygon")` 等查询准确参数；不确定的批次先 `pixel_validate`，再 `pixel_edit`。每次写入带上最近实际读