dsh-photocraft

使用

把待处理图片放进 Windows 的 %LOCALAPPDATA%\dsh-photocraft\workspace，或 macOS 的 ~/Library/Application Support/dsh-photocraft/workspace。插件中的相对路径从该目录开始，输出也保存在这里。

对 dsh 说：

使用 PhotoCraft 创建一张 1200×800 的宣传图，背景深蓝，白色标题“周末摄影展”，加入黄色圆形装饰。生成预览，保存 poster.pcraft 和 poster.png。先通过 command_list 确认命令及参数。

或者：

用 PhotoCraft 打开 workspace 中的 input.jpg，提高亮度和对比度，缩放到宽度 1600 像素，保持比例，导出 output.jpg，不覆盖原图。

工具前缀	用途
mcp__photocraft__*	无界面编辑、保存、批处理、预览、切换和关闭文档
mcp__photocraft_ui__*	桌面编辑、界面检查、画笔鼠标事件、菜单、截图

两个后端拥有独立文档会话。要交换文档，先保存，再在另一端打开。桌面入口自动启动本机 PhotoCraft，不会将编辑界面嵌入 dsh 网页。多个客户端共享桌面窗口，请避免同时修改同一文档。断开 MCP 不会关闭桌面，防止丢失未保存的工作。

上游 MCP 在两个模式下都会列出全部工具，但 ui_* 和 control_call 只能用桌面入口；doc_select 和 doc_close 只能用无界面入口。桌面标签页操作走 control_call。

配置与排错

以下环境变量需要在启动 dsh 之前设置：

变量	默认值 / 用途
PHOTOCRAFT_DSH_HOME	Windows：%LOCALAPPDATA%/dsh-photocraft；Mac：~/Library/Application Support/dsh-photocraft；安装器和插件必须使用同一路径
PHOTOCRAFT_DSH_PWSH	pwsh；可指定 PowerShell 7 可执行文件绝对路径
PHOTOCRAFT_DSH_PORT	17878；桌面本机控制端口

读写权限限定在安装目录的 workspace 下。令牌和日志保存在 state，不会提交到 GitHub。自定义安装位置时，设置 PHOTOCRAFT_DSH_HOME 后再运行安装器，并让启动 dsh 的终端使用同一变量。

• 找不到运行时：先完成安装第 2 步；检查上述变量。
• 找不到 pwsh：安装 PowerShell 7，重新打开终端；或设置 PHOTOCRAFT_DSH_PWSH。
• 端口被占用：关闭旧 PhotoCraft 桥接进程，或设置另一个 PHOTOCRAFT_DSH_PORT。测试脚本另提供 -Port 参数。
• 桌面启动失败：查看 state/app.stderr.log。本版已使用安全渲染模式，但仍需要可用的桌面会话。
• Mac 首次启动可能出现“Switched to CPU rendering”提示，选择 Keep Using CPU 即可继续。两个 Mac CI 的截图中均出现此提示，编辑、保存与截图调用仍通过；本版不声称验证 GPU 加速。
• 路径拒绝：将图片放入 workspace；不要使用 .. 越界访问。
• 安装包校验失败：不要跳过校验；删除下载缓存里的损坏 ZIP 后重新下载。