Apache-2.0 开源桥接插件：让 DeepSeek Harness 通过 10 个 agent 工具、同源 HTTP 任务接口与 11 个配套技能，全本地驱动 ArtCraft 旗下 13 个创意应用（PhotoCraft、FilmCraft、EffectCraft、LightCraft、FigCraft 等），无需云端、无需 FFmpeg。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-10-31
许可证
Apache-2.0
01它能帮你完成什么？
在 DeepSeek Harness 对话里直接操作 ArtCraft 工作室应用——批量给分镜帧调色锐化、无头执行 CLI 剪辑、渲染动态标题、合成并导出成片
落在调用方指定路径的真实成品文件：调色后的图片，带 EBU R128 响度归一与烧录字幕的 H.264 / ProRes / DNxHR 成片，EffectCraft 标题（MP4 / ProRes / Lottie）
用 DeepSeek Harness 做 AI 短剧或其他内容流水线的用户，想要可复现的无头剪辑而不是手动开应用
通过 JSON 控制通道实时驱动正在运行的 ArtCraft 应用——现场微调调色、刷时间线、摆放轨道素材、截取画面
对运行中的 FilmCraft（9876）、EffectCraft（9877）、VectorCraft（7979）或 LightCraft（7980）发送同步控制指令——FilmCraft 提供 650+ 引擎命令，时间支持秒 / 帧 / 时间码
希望 agent 在自己正盯着的应用窗口里实时干活、而不是一次性无头运行的创作者
02如何接入 DeepSeek Harness？
前置条件
- DeepSeek Harness（桌面版），Harness 支持的任意平台
- 需要的 ArtCraft 应用，从 getartcraft.com 或 storytold 的 GitHub Releases 获取——Windows/Linux 的 portable/安装包自带 CLI 可执行文件，macOS 以单独公证 zip 提供（作者已测试版本：PhotoCraft 0.9、FilmCraft 0.8、EffectCraft 早期）
- 无需其他依赖——不需要 Python、不需要 FFmpeg，ArtCraft 应用自带编解码器
安装步骤
- 01
把插件放到磁盘上：克隆本仓库——任意文件夹都可以，惯例是放在 Harness 工作区里、与其他本地插件并列
- 02
在 Harness profile 里注册：在 profile 的 package.json dependencies 中加入 "@ninkch/dsh-artcraft": "^0.1.1"（来自 npm；本地开发可用 link: 指向本仓库），并把包名加入 dsh.profile.bundles，然后运行 pnpm install --dir C:/Users/<you>/.dsh/profiles/desktop 并重启一次 Harness（Host 侧代码在启动时加载）
- 03
配置 artcraft.config.json（从 artcraft.config.json.example 复制；推荐放在 C:\Users\<you>\.dsh\artcraft.config.json）：设置 bins.*——目录、可执行文件完整路径或 PATH 里的裸命令名均可——以及控制端口（filmcraft 9876 / effectcraft 9877）；该文件每次请求都会重新读取，改路径无需重启
验证接入成功
- 在任意 Harness 对话里让 agent 运行 artcraft_status——bins.*.found 全部亮绿灯即安装完成
03DSH 适配与能力边界
原生 DSH 插件：在 DSH Host 内注册 10 个 artcraft_* agent 工具与同源 HTTP 路由（/artcraft/api/*），由 Host 以子进程运行 ArtCraft 家族 CLI，并通过 127.0.0.1 上的 JSON 控制通道驱动运行中的应用
对话中的 10 个 agent 工具
任意 Harness 对话里的自然语言请求——由 agent 自己组合工具→工具链健康检查（artcraft_status）、同步 CLI 执行（artcraft_cli）、控制通道指令（artcraft_control）、桥接文件操作（artcraft_fs）、13 应用能力目录（artcraft_apps）、运行状态探测（artcraft_live）、插件自更新（artcraft_update）
以子进程方式运行家族 CLI在调用方指定的绝对路径读写文件同源 HTTP 任务接口（/artcraft/api/*）
POST /artcraft/api/job 携带 { bin, args, outputs }，轮询 GET /artcraft/api/job?id=…，POST /artcraft/api/job/cancel 取消→完整任务生命周期：running/done/failed/timeout 状态、stdout/stderr 尾部日志、产物统计；文件下载流式传输、最大 2 GB
每次请求上传上限 320 MB长渲染作为子进程运行，不阻塞请求周期运行中应用的实时控制通道
应用名（filmcraft 9876 / effectcraft 9877 / vectorcraft 7979 / lightcraft 7980）或显式端口，加引擎指令，如 timeline.place、effects.setParam、ui.screenshot→对运行中应用的同步 JSON 控制调用——filmcraft-cli commands 列出 650+ 引擎命令；时间支持秒、帧或时间码
通道仅限回环且无认证；需先以 --control <port> 启动应用随附的 craft 技能包（11 个技能）
在 agent 会话内按需加载（英文索引见 skills/README.md）→操作方法论——artcraft-ops、镜头语言、剪辑节奏、色彩与光、声音设计、动效/VFX、交付 QC、风格圣经、影片拉片、批量流水线、多机位剪辑
交付 QC 与专家配方
成品文件路径（可选 platform/kind）用于 QC；任务意图用于配方→覆盖 video/audio/image/pdf/doc/sheet/deck/fig/cad 的 ok/warn/fail/manual 检查并附修复命令；8 个内置工作流与 14 条任务→技能→命令链
家族安装自动发现
当前 artcraft.config.json 的状态→自动补齐缺失的 bins 路径并修正过期路径（配置自修复）
自修复时会改写 artcraft.config.json 的路径
04适合谁？何时不该用？
适合
- 用 DeepSeek Harness 做 AI 短剧或其他内容流水线的用户，想要可复现的无头剪辑而不是手动开应用
- 希望 agent 在自己正盯着的应用窗口里实时干活、而不是一次性无头运行的创作者
不适合
- HTTP 接口无任何认证，依托仅监听回环地址的 Harness web 服务器——把该端口当作可信本机资源，不要暴露到网络，必要时在前面加带认证的反向代理。子进程被锁定在 13 个白名单家族 CLI 内，控制通道只拨 127.0.0.1。一切本地运行：无云端往返、无账号、无遥测。
05兼容性、维护与安全提示
- HTTP 接口无任何认证，依托仅监听回环地址的 Harness web 服务器——把该端口当作可信本机资源，不要暴露到网络，必要时在前面加带认证的反向代理。子进程被锁定在 13 个白名单家族 CLI 内，控制通道只拨 127.0.0.1。一切本地运行：无云端往返、无账号、无遥测。
- macOS 的应用构建不捆绑家族 CLI——以单独公证 zip 提供。作者已测试版本：PhotoCraft 0.9、FilmCraft 0.8、EffectCraft（早期）。
- 所有路径参数必须是绝对路径（或 base 绝对目录 + 相对 rel）。对话调用默认落在当前会话工作区，画布类前端指向自己的项目文件夹——文件位置由调用方决定。
- PhotoCraft 的控制通道是带认证的变体，PdfCraft 则基于文件；两者都被刻意不代理——这两个应用用无头 CLI 即可覆盖。其余应用使用动态端口：以 app --port PORT 启动，再把 port 传给 artcraft_control。
- 长任务以子进程运行：插件重载时会按设计杀掉所有子任务；卡住的任务可通过 GET /artcraft/api/job 连日志列出并按 id 取消。
Apache-2.0 · 持续维护中（最新发布 v0.3.4，2026-10-29）
06常见问题
ArtCraft 是什么？
ArtCraft 是一套共 13 个免费、fair-source 的创意应用，用纯 Rust 从零重写了 Adobe 系列工作室软件：PhotoCraft（对标 Photoshop）、VectorCraft（Illustrator）、FilmCraft（Premiere Pro）、LightCraft（Lightroom）、PdfCraft（Acrobat）、EffectCraft（After Effects）、DesignCraft（InDesign）、WordCraft（Word）、DeckCraft（PowerPoint）、GridCraft（Excel）、CADCraft（AutoCAD）、SoundCraft（Pro Tools）和 FigCraft（对标 Figma）。它的超能力在于：每个菜单项、滑杆和对话框都是一条命令，可以通过无头 CLI、JSON 控制通道或 MCP server 驱动。
ArtCraft 与 Adobe 是什么关系？
它不是 Adobe 的产品，而是独立重写的开源替代品——按品类对标（PhotoCraft 对应 Photoshop、FilmCraft 对应 Premiere Pro、LightCraft 对应 Lightroom、FigCraft 对应 Figma），但由 ArtCraft 团队用 Rust 从零开发。本插件不打包任何 ArtCraft 应用代码，只调用其公开自动化接口（无头 CLI + JSON 控制通道），应用本身适用各自的许可证。
PhotoCraft / FilmCraft 的 CLI 怎么装？
从 getartcraft.com 或 storytold 的 GitHub Releases 下载应用。Windows 与 Linux 的 portable/安装包自带 CLI 可执行文件（photocraft-cli.exe 等）；macOS 以单独公证 zip 提供。作者已测试版本：PhotoCraft 0.9、FilmCraft 0.8、EffectCraft（早期）。在 artcraft.config.json 的 bins.* 里填路径，或运行 artcraft_discover 自动补齐并修复路径。
怎么把 dsh-artcraft 装进 DeepSeek Harness？
在 Harness profile 的 package.json 里把 "@ninkch/dsh-artcraft": "^0.1.1" 加入 dependencies 与 dsh.profile.bundles，运行 pnpm install --dir C:/Users/<you>/.dsh/profiles/desktop 并重启 Harness；再配置 artcraft.config.json，最后在对话里用 artcraft_status 验证——bins.*.found 全绿即安装完成。插件也发布在 GitHub：NINKCH/dsh-artcraft。
输出文件放在哪里？需要联网或 FFmpeg 吗？
路径由调用方决定：对话调用默认落在当前会话工作区，画布类前端写在自己的项目文件夹，所有路径参数必须是绝对路径。一切都在本地运行——无云端往返、无账号、无遥测——也不需要 Python 或 FFmpeg，ArtCraft 应用自带编解码器。
07相关的 DSH 工作流
modlens
作者 liustack
The first vision plugin for DeepSeek Harness, and the vision bridge for every text-only coding agent. Paste an image, get structured JSON evidence (OCR, layout, semantics). | 全网最强 DeepSeek Harness 外挂视觉插件，为 DeepSeek、GLM 等纯文本模型外挂视觉能力，粘贴图片即得结构化 JSON 证据（OCR、版面、语义）。
agent-vision-toolkit
作者 anionex
为纯文本模型"看图“设计更好的视觉工具箱和技能，支持多图理解，图片问答，前端UI还原、GUI 自动化等，并可选无缝接入多个主流agent，直接识别粘贴图片｜ A vision toolkit and skill designed for text-only llms — image Q&A, long-screenshot OCR, frontend UI restoration, and GUI automation, with optional seamless integration for Codex, Claude Code, Pi, Oh My Pi, and OpenCode
dsh-vision-router
作者 ysr666
为纯文本 DeepSeek Harness 智能体提供「视觉」能力，内置免密钥视觉链路与像素级视觉工具，一条命令安装，无需 Python。
dsh-image-gen
作者 shanliuling
可在对话内生成、编辑、对比图像；内置 500 + 提示词、图库、多模型工作流，支持 ComfyUI。AI image studio for DeepSeek Harness — generate, edit & compare images in chat, with 500+ prompts, gallery, multi-model workflows and ComfyUI.
08数据与来源
Drive the open-source ArtCraft studio apps — PhotoCraft, FilmCraft, EffectCraft — from DeepSeek Harness, in chat or from…
The plugin registers ten tools. The agent composes them, so plain language works:
- **In the browser** — a same-origin HTTP API (`/artcraft/api/*`) that any Harness web UI can call,
This plugin (`@ninkch/dsh-artcraft`): **Apache-2.0** — see [LICENSE](LICENSE). It ships none of the
can be driven from a headless CLI, a JSON control channel, or an MCP server.
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-10-31。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。