DeepSeek Harness 插件：lightroom-py（掛載 Python 庫控制 Lightroom Classic）

前言¶

DeepSeek Harness（DSH）遵循「一切皆插件」的理念，旨在將外部服務能力掛載爲原生工具。這個插件將 lightroom-py MCP 服務器掛載爲 dsh 工具，讓智能體可以直接通過 DeepSeek Harness 與 Adobe Lightroom Classic 進行交互。

插件介紹¶

插件名爲 dsh-lightroom-py，版本 0.1.0。它包含在 lightroom-py 倉庫的 dsh/ 目錄中，是一個純配置包。核心 Python 庫來自 PyPI，通過 pip install lightroom-py 安裝。插件配置文件位於 package.json，其中 dsh.bundle.patch 指向 ./cordis.patch.yml。

核心功能¶

該插件基於 lightroom-py 庫，提供以下能力：

目錄管理：打開目錄、查看信息與統計。
照片操作：列表、計數、按路徑查找；支持按評分、ISO、相機、鏡頭、關鍵詞、日期、顏色標籤、文件格式等過濾。
選擇與導航：選擇當前照片、全選/反選/擴展、上下張導航。
標記系統：旗標（標記/拒絕/清除）、星級、顏色標籤循環。
元數據編輯：添加關鍵詞（支持層級）、星級、顏色標籤、設置 IPTC（標題、版權等）。
XMP 處理：寫入/讀取 XMP，支持 ExifTool 快速路徑。
開發模塊：
- 全局：應用預設、粘貼設置、獲取設置、重置。
- 參數化：裁剪、HSL、色彩分級、變換、鏡頭校正、校準、細節、效果。
- 曲線：獲取/設置/預設/線性/S 曲線。
- 快照與版本：創建快照、查看過程版本。
- 重置：針對裁剪、遮罩、紅眼、變換的重置命令。
遮罩：
- 讀取與清除：列出遮罩、清除遮罩。
- 創建：支持徑向遮罩（已驗證端到端）和線性遮罩。
- AI 計算路徑：通過預設 + 導出觸發 LR 的 AI 更新。
集合管理：列表、創建、添加、移除、刪除、獲取照片。
庫功能：列出文件夾、導出（支持水印、銳化、調整大小、DPI、文件名模板）、製作虛擬副本、堆棧。
編輯-在：導出到磁盤並運行外部工具。
開發工具：重載橋接、執行 Lua、查看日誌。
服務管理：macOS 下的服務安裝、卸載與狀態檢查。

安裝與啓用¶

插件的核心邏輯在 lightroom-py 包中，DSH 配置位於倉庫的 dsh/ 目錄。

安裝 Python 庫：

    pip install lightroom-py

配置文件結構：
- cordis.patch.yml：DSH 打補丁配置。
- dsh/：DSH 插件目錄。
- SKILL.md：技能說明文檔。
- LICENSE：MIT 許可證。

典型用法¶

安裝完成後，可以通過 CLI 調用 lightroom-py 的功能：

初始化：

    lightroom setup

    lightroom catalog open ~/Pictures/Lightroom/MyCatalog.lrcat
    lightroom photos list --rating ">=4" --iso ">=400" --since 2026-01-01 --json

創建徑向遮罩：

    lightroom develop mask create-radial --left 0.05 --right 0.5 --top 0.4 --bottom 0.95 --exposure 1.0 --name "subject-brighten" --selection

導出照片：

    lightroom library export ~/Desktop/finals

適用場景與注意¶

適用場景：
適合需要通過代碼或智能體自動化處理 Lightroom Classic 工作流的開發者。

注意事項：
* 許可與歸屬：這是一個非官方項目，遵循 MIT 許可證，與 Adobe 無關聯。
* macOS 權限：LaunchAgents 需要完全磁盤訪問權限才能讀取 ~/Documents、~/Desktop 等目錄下的文件。
* Windows 兼容性：目前 Windows 版本需要手動啓動 Bridge 服務，暫無 LaunchAgent 等效方案。
* 功能限制：由於 Adobe SDK 的缺口，以下功能暫不可用：AI 降噪計算、畫筆遮罩創建、紅眼消除、照片刪除、虛擬副本刪除、以及 Lightroom Cloud (LR CC)。
* DSH 生態：此插件屬於社區插件，目錄位於獨立站點，與 DeepSeek / 幻方無官方從屬關係。

總結¶

該插件通過掛載 lightroom-py，爲 DeepSeek Harness 提供了控制 Lightroom Classic 的能力。它覆蓋了從元數據管理到遮罩創建的廣泛功能，適合需要程序化處理攝影工作流的場景。完整文檔與源碼可參考 GitHub 倉庫。