前言¶
在 DSH 里若要让模型驱动本机 Adobe Photoshop，常见做法是每次迭代都走命令行或 JSX：权限弹窗、冷启动大约数秒、手写脚本、失败时往往没有明确指标。Lumina（lumina-dsh）是面向 DeepSeek Harness 的 bundle 插件，把上述循环收成「常驻 PS 会话 + 参数化配方 + 一次调用出图 + 客观 QA + 可选超分与高倍视觉检查」。下面介绍它是什么、提供哪些工具，以及如何安装与启用。
这是什么¶
lumina-dsh（仓库 Rainnnnnnny/lumina-dsh）由维护者 Rainnnnnnny 发布，在社区目录中归类为工作流。一句话定位：在 Windows 上通过 DSH 宿主进程调用 Photoshop COM，对游戏截图或照片做分级调色、分层 HDR、多区域蒙版、可选 AI 超分，并输出可复现的项目文件夹与质量指标。
插件当前 npm 包版本为 1.1.11（MIT 许可证），要求 DSH >=0.2.0-rc.2 <0.3.0、Node.js ≥ 20。
核心功能¶
资料中明确的能力包括：
- 常驻 Photoshop 会话：一次冷启动后，单张处理约 5 秒量级；崩溃或被 kill 后会自动重启并重试。
- 参数化配方：19 条 grading recipes + 5 个内置 style LUT；参数可 deep-merge 覆盖，可迭代追加版本；风格包为可热加载的数据（无需重启即可增删或只改预设参数）。
- 任意画幅：截图、照片、人像/方图/超宽均可；高置信度检测到的截图 UI 条会被裁掉。
- Auto 模式：放入图片即可——裁 UI、判断人物/风景、按需 HDR 高光重建、应用接受的 draft 预设。
- 可选超分预处理：小图或细节不足时可先走外部 AI upscaler（如 Real-ESRGAN / waifu2x）；未配置外部工具时用内置 Lanczos，再进入 HDR 与调色。
- 客观 QA：高光 clipping、锐度、中间调、饱和度、输出尺寸等 pass/fail 直接列出；Auto 模式可自愈并重跑。
- 按任务的项目目录：源图、实际执行的 JSX、PSD、成品、前后指标、1:1 对比图、完整版本历史均持久化。
- Vision 工具：高倍查看（坐标网格）、像素探针、原生分辨率文本像素图，不受图像 token 上限约束。
工具一览¶
| 工具 | 作用 |
|---|---|
ps_grade |
对单张图跑配方：建项目目录、通用自动评估（截图/照片、锐度、UI 条、EXIF、低清/模糊时可选超分、损坏引擎自动降级）、分层调色、写 PNG/PSD、生成 1:1 前后对比图、算指标并 QA。可传 project 追加参数版本；crop:{"mode":"none"} 保留全分辨率。 |
ps_measure |
对任意图像算质量指标（亮度分布、高光/阴影 clipping、饱和度、锐度、尺寸、UI 条）及自动评估（模糊、噪声、EXIF、截图/照片判定），不改文件。 |
ps_state |
查看 PS 会话、LUT 目录、case bank、热加载风格包、超分设置、可用 recipes/styles、近期项目；start=true 预热，quit=true 释放内存。 |
vision_zoom |
区域放大 + 原图坐标网格 + 边缘叠加 + 标记，把图直接交回模型。 |
vision_probe |
指定坐标或线段采样点的 RGB、亮度、边缘强度。 |
vision_textmap |
将区域渲染为原生分辨率「文本像素图」。 |
环境与限制¶
- Photoshop：2025（26.x）已测；2020–2024 预期可用（旧版
Select Subject失败会优雅降级）；2019 及更早不支持；Photoshop Elements / macOS 不支持（依赖 Windows COM）。 - 系统：Windows 10/11 + Adobe Photoshop + DSH 桌面应用（宿主进程内运行插件，才能启动 PS COM）。
- 运行时：Node.js ≥ 20（DSH 自带运行时即可）；Python 3.10+ 及
numpy、Pillow（DSH 捆绑环境已含；独立使用时需自行安装）。
Photoshop 安装路径一般无需配置（通过系统 COM 注册启动）；仅 style LUT 需要 Presets/3DLUTs，可自动探测；非常规安装可设 lutDir。
安装与启用¶
推荐从 npm 安装（命令须与 README 一致）：
dsh plugin --profile <profile> add lumina-dsh
桌面端也可：Settings → Plugins → install bundle → lumina-dsh。
安装后重启 DSH 一次，在对话中说 hilumina：插件会自检依赖、GPU/磁盘、完整超分 tier ladder，确认输出目录与 CUDA fallback 模型，即可开始处理图像。
本地开发可用 checkout：在 profile 的 package.json 里以 link: / file: 依赖加入 lumina-dsh，并在 dsh.profile.bundles 中列入 bundle 名，重启 DSH；cordis.patch.yml 会注册上述六个工具。
可选配置示例（键均可省略，用默认值）：
- insert:
- id: photoshop
name: 'lumina-dsh'
config:
projectRoot: 'D:/Photos/Lumina' # 默认 <home>/Lumina
psWaitMs: 90000 # PS 冷启动最长等待
opTimeoutMs: 240000 # 单张操作超时
maxViewDimension: 4096 # vision_zoom 最大视图边长
常用配置项：projectRoot（亦支持 LUMINA_PROJECT_ROOT）、pythonPath（LUMINA_PYTHON / DSH_PYTHON）、lutDir（LUMINA_LUT_DIR）、casesFile、stylesFile（热加载用户风格包）、superResolution、assess 等，详见仓库 README 配置表。
典型用法¶
经过上面的安装与 hilumina 自检后，在 DSH 对话中让模型调用工具即可，例如：
- 用
ps_state且start=true预热 Photoshop，并查看当前 recipes、styles、超分设置。 - 对一张截图或照片调用
ps_grade（可只传路径走 Auto，或指定 recipe / 风格与参数覆盖）；需要保留全帧时传crop:{"mode":"none"}。 - 调参后向同一
project再跑ps_grade，在项目目录里对比版本历史与 QA 指标。 - 出图前或单独诊断时用
ps_measure看 clipping、锐度等，不修改源文件。 - 核对局部高光、色边或锐度时，用
vision_zoom/vision_probe/vision_textmap做像素级检查。
每个任务的项目文件夹位于配置的 projectRoot（默认用户目录下 Lumina），内含可复现的 JSX、PSD、成品与对比图。
适用场景与注意¶
适合在 Windows + 本机 Photoshop 环境下，需要把「截图/照片后期」纳入 DSH 工作流、且希望参数可版本化、结果可 QA 的开发者或内容作者。Auto 模式面向「丢图即出 accepted draft」；精细控制则依赖 19 条 recipe 与可热加载的风格包。
务必注意：
- 插件在 当前 DSH 进程权限下运行，会通过 COM 驱动本机 Photoshop 并读写项目目录；安装前应阅读源码与 MIT 许可证，确认符合你的安全与合规要求。
- 仅 Windows；无 Photoshop 或期望在 macOS 上 COM 自动化时，此插件不适用。
- DSH 社区插件目录（如 SkillHub 上的 lumina-dsh 页）为独立站点，与 DeepSeek / 幻方无官方从属关系；生态理念是「一切皆插件」，本文事实以仓库 README 与 package 元数据为准。
结尾¶
Lumina-dsh 把命令行驱动 PS 的高摩擦迭代，收成常驻会话、配方化调色、HDR 与可选超分、客观 QA 以及高倍视觉工具的组合。若你在 DSH 里处理游戏截图或照片后期，可按上文命令安装 bundle，重启后说 hilumina 完成自检，再通过六个工具接入日常交付。
- 目录页：https://www.skillhub.cn/plugins/Rainnnnnnny/lumina-dsh
- GitHub：https://github.com/Rainnnnnnny/lumina-dsh
