PixelRunner

Photoshop 里的 AI 修图工作台

选区捕获、RunningHub 工作流、提示词模板、AI 优化、常用修图工具、辉光预览，一块面板里全部搞定。

为什么需要它 · 核心功能 · 快速上手 · 开发与构建

一句话介绍

PixelRunner（小T修图助手）是一个面向 Photoshop 的 UXP 插件。它把 Photoshop 和 RunningHub 图像工作流接在一起，让你可以在 PS 里直接框选画面、提交 AI 任务、等待结果、自动贴回图层。

如果你平时要反复做这些事：

• 从 Photoshop 导出局部图像。
• 打开网页或别的工具上传图片。
• 复制粘贴提示词和参数。
• 等任务完成后下载结果。
• 再把图片拖回 Photoshop 对齐。
• 下次换一个工作流，又要重新配一遍。

PixelRunner 想解决的就是这条来回折腾的链路。它把“修图动作”和“AI 工作流”合到 Photoshop 面板里，让创作过程更像一次连续操作，而不是在多个窗口之间搬运素材。

为什么需要 PixelRunner

以前的流程	使用 PixelRunner 后
手动导出选区或整图	在 PS 内一键捕获当前选区或文档
去网页上传图片	插件直接提交 RunningHub 工作流
反复复制提示词	模板、快捷入口和应用参数本地保存
盯着任务状态刷新	插件内显示任务进度，可取消和追踪
下载结果再拖回 PS	任务完成后自动贴回 Photoshop
常用修图动作分散在菜单里	黑白观察、中性灰、盖印、模糊、锐化等集中在工具箱
辉光效果靠试错	先在插件内预览，再确认写回图层

适合谁

PixelRunner 对这几类用户尤其有用：

用户	能得到什么
修图师	把局部重绘、细节增强、风格化处理接进 Photoshop 工作流
摄影后期	选区捕获、结果回贴、观察层和中性灰等工具集中管理
AI 绘图用户	保存常用应用、提示词模板和快捷入口，减少重复输入
RunningHub 用户	把网页工作流变成 Photoshop 内的可复用面板
插件开发者	参考 UXP Host + WebView 的插件架构和桥接方式

核心优势

1. 不离开 Photoshop

PixelRunner 的核心体验是“在 PS 里完成 AI 往返”。你可以直接使用当前文档或选区作为输入，任务完成后结果会回到 Photoshop，不需要手动导出、下载、拖拽和重新对齐。

2. 小白也能跑工作流

你不需要理解复杂接口。保存 RunningHub API Key 后，把应用 ID 或链接填进插件，PixelRunner 会解析应用输入项，并自动生成表单。该填图片的地方捕获图片，该填文字的地方写提示词。

3. 常用配置可以沉淀下来

PixelRunner 不只是“跑一次任务”。它可以保存：

• RunningHub 应用
• 应用参数
• 提示词模板
• 快捷入口
• AI 优化应用 ID
• 并发、轮询、超时等运行设置

这意味着你可以把常用工作流整理成自己的修图工具箱。

4. AI 任务状态可见、可控

提交任务后，插件会显示运行状态，支持多任务并发、取消任务、超时追踪和任务完成回贴。比起把任务扔出去之后盲等，PixelRunner 更适合真实生产里的反复试错。

5. 修图工具和 AI 工具在同一个面板

修图不是只有 AI。PixelRunner 也内置了一组高频 Photoshop 辅助工具，让你在使用 AI 前后都能快速处理画面。

核心功能

RunningHub 任务工作台

工作台是 PixelRunner 的主场。它负责选择应用、填写参数、捕获图片、提交任务和接收结果。

能力	说明
应用解析	支持通过 RunningHub 应用 ID 或链接解析应用输入结构
动态表单	根据应用输入项自动生成图片、文本、数字等参数表单
图片捕获	可捕获 Photoshop 当前选区或当前文档
任务提交	在插件内提交 RunningHub 图像任务
状态追踪	显示任务运行、成功、失败、超时等状态
结果回贴	任务完成后自动把结果贴回 Photoshop
并发控制	支持配置最大并发任务数
任务取消	支持取消进行中的任务

应用管理

把常用 RunningHub 应用保存起来，之后就不用每次重新找链接、重新填参数。

支持：

• 保存应用
• 修改应用名称和描述
• 删除应用
• 搜索应用
• 排序应用
• 解析应用输入项
• 查看最近一次解析调试信息

提示词模板

常用 prompt 可以保存成模板，在工作台中快速插入。

适合保存：

• 人像修图提示词
• 产品图优化提示词
• 局部重绘提示词
• 风格化提示词
• 负向描述
• 常见画质增强描述

模板支持保存、删除、搜索、排序、导入和导出。

快捷入口

快捷入口适合把一个常用应用和它的非图片参数固定下来。之后只需要在 Photoshop 里框选区域，点击入口就能跑。

这对于固定工作流很省时间，例如：

• 一键局部精修
• 一键皮肤细节优化
• 一键背景补全
• 一键服装纹理增强
• 一键产品图清理

AI 优化提示词

PixelRunner 可以使用参考图和当前主 prompt，调用你配置的 RunningHub AI 优化应用，生成更清晰、更适合图像工作流使用的提示词。

它的设计比较克制：AI 返回结果不会自动覆盖原 prompt，而是先展示在弹窗里。你确认之后，可以选择“替换当前”或“追加到当前”。

Photoshop 工具箱

内置工具箱聚合了一组修图时经常用到的动作：

工具	用途
黑白观察层	快速观察明暗、结构和脏点
中性灰图层	辅助 Dodge & Burn 修图
盖印图层	快速生成当前可见效果图层
高斯模糊	调用 Photoshop 模糊能力
智能锐化	快速进入锐化流程
高反差保留	常见质感和锐化辅助
内容识别填充	调用 Photoshop 原生填充能力
选择并遮住	快速打开原生选区优化面板

辉光预览面板

辉光模块用于制作高光扩散和梦幻光感。它会先捕获当前图像，在插件内预览辉光效果。你可以调节强度、半径、阈值、饱和度等参数，满意后再应用到 Photoshop。

这个流程的好处是：

• 先预览，再写回。
• 减少大图层反复交换。
• 更容易控制高光范围。
• 结果图层适合在 Photoshop 中继续调整。

使用流程

打开 Photoshop
  ↓
加载 PixelRunner 插件
  ↓
在设置页保存 RunningHub API Key
  ↓
添加或解析 RunningHub 应用
  ↓
回到工作台选择应用
  ↓
框选 Photoshop 区域或使用当前文档
  ↓
填写 prompt 和参数
  ↓
提交任务
  ↓
等待结果自动贴回 Photoshop

快速上手

1. 准备环境

你需要：

• Adobe Photoshop 26.0 或更高版本
• Adobe UXP Developer Tool
• Node.js 18 或更高版本
• npm
• RunningHub API Key

2. 获取项目

git clone https://github.com/XIAOTsune/PixelRunner.git
cd PixelRunner/PixelRunner

3. 安装依赖并构建

npm install
npm run build

4. 在 UXP Developer Tool 中加载

1. 打开 Adobe UXP Developer Tool。
2. 点击 Add Plugin。
3. 选择 PixelRunner/manifest.json。
4. 点击 Load 或 Watch。
5. 在 Photoshop 中打开 Plugins -> Development -> PixelRunner（小T修图助手）。

5. 第一次使用

1. 打开插件设置页。
2. 填入 RunningHub API Key。
3. 添加一个 RunningHub 应用 ID 或应用链接。
4. 回到工作台选择应用。
5. 在 Photoshop 中框选区域，或使用当前文档作为输入。
6. 填写提示词和参数，提交任务。

项目结构

.
├── LICENSE
├── README.md
├── .gitignore
└── PixelRunner/
    ├── app.html                 # WebView 主界面
    ├── app.css                  # WebView 样式
    ├── index.html               # UXP Host Shell
    ├── manifest.json            # Adobe UXP 插件清单
    ├── package.json
    ├── package-lock.json
    ├── pages/                   # 独立帮助页面
    ├── icons/                   # 插件图标与界面素材
    ├── video/                   # 提示音等静态资源
    ├── scripts/                 # 构建与打包脚本
    ├── docs/                    # 技术方案和开发记录
    └── src/
        ├── host/                # Photoshop、UXP、RunningHub 桥接能力
        ├── webview/             # UI、状态、任务、模板、辉光等逻辑
        ├── host-entry.js
        └── webview-entry.js

开发与构建

进入插件目录：

cd PixelRunner

安装依赖：

npm install

构建插件 bundle：

npm run build

开发时监听构建：

npm run build:watch

检查构建产物是否与源码同步：

npm run check:dist

生成测试包：

npm run package:test

生成正式发布包：

npm run package:release

开发约定

• 正式源码入口是 src/host-entry.js 和 src/webview-entry.js。
• Photoshop、UXP、RunningHub 相关桥接能力放在 src/host/。
• UI、状态、任务列表、模板、快捷入口、辉光预览等逻辑放在 src/webview/。
• 不直接编辑 dist/*.bundle.js。
• 不提交 node_modules/、dist/、release/ 或本地打包文件。
• 修改源码后建议执行 npm run build。

构建产物说明

以下内容会被 .gitignore 忽略：

• node_modules/
• dist/
• release/
• .ccx、.zip、.tgz 等打包结果
• .env、日志、编辑器缓存和本地临时文件

克隆仓库后执行 npm install && npm run build 即可重新生成运行所需的 bundle。

隐私与安全

PixelRunner 不需要你把任何密钥提交到仓库。RunningHub API Key 保存在本机 UXP 存储中，用于向 RunningHub 提交任务和查询状态。

请不要提交：

• 真实 API Key、Token、Cookie 或账号凭证。
• 私人调试日志。
• 本地构建包和历史发布包。
• 只在个人机器上有效的绝对路径。

常见问题

PixelRunner 是独立软件吗？

不是。PixelRunner 是 Photoshop UXP 插件，需要在 Photoshop 和 UXP Developer Tool 中加载。

必须有 RunningHub 账号吗？

如果你要使用 AI 工作流提交、任务查询和结果回贴，就需要 RunningHub API Key。工具箱中的部分 Photoshop 辅助能力不依赖 RunningHub。

为什么仓库里没有 dist？

dist/ 是构建产物，可以通过 npm run build 重新生成。开源仓库只保留源码、资源、脚本和文档，方便长期维护。

小白能用吗？

可以。第一次配置会稍微多一步：安装依赖、构建、用 UXP Developer Tool 加载插件、保存 RunningHub API Key。配置完成后，日常使用主要是在插件面板里选择应用、框选图片、填写提示词和提交任务。

路线方向

PixelRunner 会继续围绕一个目标迭代：让 Photoshop 内的 AI 修图流程更顺手。

接下来值得继续增强的方向：

• 更清晰的新手引导。
• 更稳定的任务失败诊断。
• 更完善的 AI 优化提示词历史。
• 更强的辉光预览和 GPU 加速体验。
• 更方便的应用、模板、快捷入口分享方式。

许可证

PixelRunner 使用 Apache License 2.0 开源。

Copyright 2026 XIAOTsune