lumina-dsh

dsh plugin --profile web add lumina-dsh

Lumina · 光

DSH 的 Photoshop 后期套件：用脚本驱动本机 Adobe Photoshop 做游戏截图 / 照片后期 —— 常驻会话、参数化 recipe、自动出片、客观质检、风格 LUT、HDR 高光重建、可选超分与像素级视觉检视。

Lumina 是一个 DSH 宿主插件（bundle）。它把「命令行调 PS」这种每轮要权限审批、6 秒冷启动、手写 JSX、静默失效试错的流程，变成 ≈5 秒一轮 + 自动指标 + 可复现参数 的日常出片工具：

• 常驻 Photoshop 会话：一次冷启动，之后每张图 ~5 秒；崩溃/被杀后自动重启重试。
• 参数化 recipe：19 个调色配方 + 5 档内置风格 LUT；参数全部可深合并覆盖、可追加版本迭代，风格本身是热加载的数据包（新增/替换不用重启，也能做成纯参数预设）。
• 通用画幅：游戏截图、真实照片、竖拍/方图/超宽图都能跑；只有检测置信度高的截图 UI 条才会被裁掉。
• 自动模式：丢一张图即可——自动裁 UI 条、判定角色/风景、按需 HDR 高光重建、套用验收过的初稿参数。
• 可选超分预处理：低清/小图可先接外部 AI 超分（Real-ESRGAN / waifu2x 等），没有外部工具时用内置 Lanczos 兜底，再走 HDR 重建与调色。
• 客观质检：高光溢出、锐度、中间调、饱和度、输出尺寸，达不达标直接列出来；auto 模式还能自愈重跑。
• 每任务工程目录：原图、实际执行的 JSX、PSD、成品、前后指标、1:1 对比图、版本历史全部落盘可复现。
• 视觉工具：高倍坐标网格看图、像素探针、原生分辨率文本像素图——不受图像 token 上限限制。

截图

自动 · 风景（HDR 重建 + 前后对比） · 自动 · 角色（cinema 风格 LUT）

 · 

风格库 5 档对比（原图 → natural → cinema → vivid → still → soft）：

工具

工具 · 作用

ps_grade · 对图片执行 recipe：自动建工程目录、通用自动判断（截图/照片、清晰度、UI 条、EXIF 方向，低清模糊自动超分，坏引擎自动回落）、调色/分层、出 PNG/PSD、生成含 1:1 细节的前后对比图、算指标、跑质量校验。可带 project 追加新版本调参；crop:{"mode":"none"} 保留完整分辨率。

ps_measure · 任意图片的质量指标（亮度分布、高光/暗部溢出、饱和度、锐度、尺寸、UI 条）+ 自动评估：模糊度、噪声、EXIF 方向、照片/截图判断。不修改文件。

ps_state · Photoshop 会话状态、LUT 目录、案例库、热加载风格包、超分设置、可用 recipe / 风格、最近工程列表。start=true 预热，quit=true 释放内存。

vision_zoom · 高分辨率看图：区域放大 + 原图坐标网格 + 边缘叠加 + 标记点，直接把图返回给模型看。

vision_probe · 像素探针：读取指定坐标/线段上采样点的精确 RGB、亮度、边缘强度。

vision_textmap · 把图片区域渲染成原生分辨率「文本像素图」，不受图像 token/尺寸上限限制。

安装

环境要求

Photoshop 兼容矩阵：2025（26.x）✅ 已实测；2020–2024 预期支持（旧版 Select Subject 失败会自动回退出图）；2019 及更早不保证；PS Elements / macOS 不支持（插件依赖 Windows COM）。

• Windows 10/11 + Adobe Photoshop（开发与验收于 Photoshop 2025；ps_grade 依赖 Windows COM，更早版本未验证）。
• DSH 桌面端（宿主插件运行在 DSH 宿主进程，才能启动 Photoshop COM）。
• Node.js ≥ 20（DSH 自带运行时即可）。
• Python 3.10+，带 numpy、Pillow（DSH 自带运行时已包含；独立使用时装一下即可）。

Photoshop 的安装路径不需要配置：自动化通过系统里 Photoshop 的 COM 注册启动；

只有风格 LUT 需要找到 Presets/3DLUTs，会自动探测（见下文），特殊安装可配 lutDir。

从 npm 安装（推荐）

dsh plugin --profile <profile> add lumina-dsh

桌面 App：设置 → 插件 → 安装组合包 → lumina-dsh。

安装后重启一次 DSH，然后在对话里说 hilumina：插件会自检依赖/GPU/磁盘与完整超分档位，确认输出文件夹和 CUDA 兜底模型，之后直接丢图即可。

本地开发请用下方的源码安装方式。

本地源码安装（开发用）

把本仓库放到任意目录，在 DSH profile 里以 link: / file: 依赖安装并加入 bundle 列表，例如

C:\Users\<you>\.dsh\profiles\<profile>\package.json：

{
  "dependencies": {
    "lumina-dsh": "link:C:/path/to/lumina-oss"
  },
  "dsh": {
    "profile": {
      "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "lumina-dsh"]
    }
  }
}

安装依赖（或直接把仓库目录软链到 <profile>/node_modules/lumina-dsh）后重启 DSH。

插件里的 cordis.patch.yml 会自动注册 ps_grade / ps_measure / ps_state /

vision_zoom / vision_probe / vision_textmap 六个工具。

配置（可选）

所有配置项都可省略；未写的项使用下表的默认值。cordis.patch.yml 配置示例：

- insert:
    - id: photoshop
      name: 'lumina-dsh'
      config:
        projectRoot: 'D:/Photos/Lumina'   # 默认 <home>/Lumina
        # pythonPath: 'C:/Python312/python.exe'   # 默认用 DSH 自带 Python
        # lutDir: 'C:/Program Files/Adobe/Adobe Photoshop 2025/Presets/3DLUTs'
        # casesFile: 'D:/Photos/Lumina/.lumina-cases.json'
        psWaitMs: 90000        # 冷启动 Photoshop 最长等待
        opTimeoutMs: 240000    # 单张图处理超时
        maxViewDimension: 4096 # vision_zoom 最大视图尺寸

配置项 · 默认值 · 说明

projectRoot · <home>/Lumina · 每个任务的工程目录建在这里；也支持 LUMINA_PROJECT_ROOT 环境变量

pythonPath · 自动 · Python 解释器；也支持 LUMINA_PYTHON / DSH_PYTHON

lutDir · 自动探测 · Photoshop Presets/3DLUTs 目录；也支持 LUMINA_LUT_DIR

casesFile · <home>/.lumina/auto-cases.json · 可写的风格案例库；也支持 LUMINA_CASES_FILE

casesSeedFile · <package>/assets/auto-cases.json · 只读种子案例库（发布包为空/不存在）

stylesFile · <home>/.lumina/styles.json · 热加载用户风格包（同名覆盖内置风格）；也支持 LUMINA_STYLES_FILE

superResolution · 关闭 · 超分预处理默认参数（见「超分预处理」）；fallback 控制坏引擎回落

assess · 内置阈值 · 可覆盖通用自动判断阈值：{minLongEdge, blurThreshold, maxBlurUpscaleEdge, maxLongEdge, photoRecipe}

psWaitMs / opTimeoutMs · 90000 / 240000 · 启动等待 / 单步超时（毫秒）

maxViewDimension · 4096 · vision_zoom 输出图像上限（模型侧图像尺寸上限）

更多环境变量别名：LUMINA_CASES_SEED、LUMINA_STYLES_FILE、DSH_LUMINA_LUT_DIR、DSH_LUMINA_CASES_FILE、DSH_PHOTOSHOP_PROJECT_ROOT、DSH_PHOTOSHOP_PYTHON、DSH_VISION_PYTHON；排障时设 LUMINA_DEBUG=1（或 DSH_PHOTOSHOP_DEBUG=1）输出宿主侧调试日志。

用户配置文件（本机设置，不进仓库/发布包）

不想改插件配置、又要把工程和运行数据放到别的盘时，用用户配置文件：

<home>/.lumina/config.json（或环境变量 LUMINA_CONFIG 指向任意路径）

// C:/Users/<you>/.lumina/config.json —— 例如全部放 D 盘
{
  "projectRoot": "D:/Photos/LuminaProjects",  // 工程目录（成品/PSD/对比图都在里面）
  "dataDir": "D:/Photos/LuminaData",          // 案例库/风格包/缓存等运行数据的默认目录
  "lutDir": "D:/PS/Presets/3DLUTs",           // 可选：非标准 Photoshop 安装位置
  "stylesFile": "D:/Photos/LuminaData/styles.json",  // 可选：显式指定（否则 <dataDir>/styles.json）
  "casesFile": "D:/Photos/LuminaData/auto-cases.json",
  "superResolution": { "enabled": true, "mode": "auto", "minLongEdge": 1600, "scale": 2 }
}

完整优先级：插件配置（cordis.patch.yml） > 环境变量 > 用户配置文件 > 内置默认。

用户文件在插件加载时读取（改完重启/重载 DSH 生效）；案例库与风格包本身仍是每次调用热加载。

可以直接复制仓库里的示例：assets/config.example.json → <home>/.lumina/config.json，再按自己的盘符改路径（示例把工程与运行数据都放在 D:/Lumina）。

快速开始

首次安装：在对话里说 hilumina（或「初始化」）。插件会自检依赖/配置、探测 GPU 显存/磁盘/运行时，展示完整档位表（SUPIR(扩散) → HAT/DAT → UltraSharp/Remacri → Real-ESRGAN → waifu2x → Lanczos，含状态/体积/适配器/许可）与当前引擎链，然后每次都会明确询问两项：输出文件夹（当前值，可改）和 CUDA 兜底模型（SUPIR 仍是链上最高优先）。缺的档位可一键后台下载；ps_state 传 onboard:true, forceAsk:true 会额外加一条写入确认（首次装机/测试用）。

// 零提示词：丢一张截图，自动出片
{ "source": "C:/Photos/MyScreenshot.png", "auto": true }

// 指定 recipe + 标题
{ "source": "C:/Photos/MyScreenshot.png", "recipe": "clean-premium", "tit

…(truncated)