@ninkch/dsh-artcraft 0.0.0-stage → 0.2.0

package/README.zh-CN.md

@@ -0,0 +1,284 @@
+<div align="center">
+
+# ArtCraft Bridge
+
+**用 DeepSeek Harness 在对话里、或在你的前端界面中，驱动开源创作套件 ArtCraft —— PhotoCraft · FilmCraft · EffectCraft**
+
+[English](README.md) | [简体中文](README.zh-CN.md)
+
+`@ninkch/dsh-artcraft` · DeepSeek Harness 插件 · Apache-2.0
+
+</div>
+
+---
+
+## 为什么做这个
+
+[ArtCraft](https://getartcraft.com/apps) 是一套用纯 Rust 从零重写的免费公平源代码（fair source）
+Adobe 对标工具：
+**PhotoCraft**（对标 Photoshop）、**FilmCraft**（对标 Premiere Pro）、**EffectCraft**（对标 After
+Effects）等。它们有一个大多数桌面软件都不具备的共同基因：**每个菜单项、滑块、对话框都是一条
+命令**，而同一套命令既能从无头 CLI 调用，也能走 JSON 控制通道或 MCP——这些 App 从第一天起
+就是为 agent 设计的。
+
+本插件把这套自动化面接进 DeepSeek Harness，让 AI 不只是"谈论"这些软件，而是真的**操作**它们：
+
+- **对话里** —— 四个 Agent 工具，任何 Harness 会话都能检查工具链、执行 CLI 命令、向运行中的
+  App 发控制通道命令、在专属数据目录里读写文件。
+- **浏览器里** —— 同源 HTTP API（`/artcraft/api/*`），任何 Harness 前端都能直接调用：无 CORS、
+  无密钥。它为 [无限画布 / infinite-canvas](../dsh-infinite_canvas/README.md)（节点式 AI 短剧
+  分镜画布）而建，但任何前端都可用。
+- **磁盘上** —— 每台机器一个 `dataRoot`，素材、工程文件、渲染产物按项目分区
+  （`media/ · craft/ · out/`），生成式流水线与桌面应用在同一片地基上会合。
+
+典型的 AI 短剧闭环：模型生成分镜图 → PhotoCraft 批量调色锐化 → EffectCraft 渲染动态片头 →
+FilmCraft 剪辑、调色、混音、烧字幕 → 导出 H.264。"生成"之后的每一步都由本插件无头驱动。
+
+## 整体结构
+
+```
+┌──────────────── DeepSeek Harness 网页端（浏览器）────────────────┐
+│   以无限画布为例：① 上传资产  ② 发起任务  ③ 取回产物              │
+└─────────────────────────────┬───────────────────────────────────┘
+                              ▼  同源 fetch，无 CORS
+┌──────────────── DSH Host · @ninkch/dsh-artcraft ────────────────┐
+│   HTTP 路由 /artcraft/api/*   +   Agent 工具 artcraft_*           │
+│        → 子进程（各 CLI）        → TCP 控制通道                     │
+└──────┬───────────────────────┬───────────────────────┬───────────┘
+       ▼                       ▼                       ▼
+  photocraft-cli          filmcraft-cli          effectcraft-cli
+  批量调色、PSD 编辑       EDL/XML 进出、剪辑调色  .ecproj(JSON) 渲染、
+  （无头）                 混音导出                Lottie 导出
+       └───────────────────────┴───────────────────────┘
+                               ▼
+              <dataRoot>/<项目>/{media, craft, out}
+```
+
+全流程本地运行：不联网、无账号、无遥测。
+
+## 环境要求
+
+- **DeepSeek Harness** 桌面版（Harness 支持的任意平台）。
+- **ArtCraft 应用** —— 从 [getartcraft.com](https://getartcraft.com/apps) 或
+  [storytold GitHub Releases](https://github.com/storytold) 按需下载。Windows 与 Linux 的
+  portable/安装包内置 CLI（`photocraft-cli.exe` 等）；macOS 的 CLI 是单独的公证 zip。
+  已验证版本：PhotoCraft 0.6、FilmCraft 0.5、EffectCraft（早期构建）。
+- 其他什么都不需要：无 Python、无 FFmpeg —— ArtCraft 自带编解码器。
+
+## 安装
+
+**1. 把本仓库放到磁盘任意位置**（放进 Harness 工作区、与其他本地插件平级是惯例）。
+
+**2. 在 Harness profile 中注册。** profile 是一个 pnpm 包目录：
+`C:\Users\<你>\.dsh\profiles\<profile>\`（桌面版默认 `desktop`）。改两处：
+
+```jsonc
+// profile 下的 package.json
+{
+  "dependencies": {
+    // ...已有依赖...
+    "@ninkch/dsh-artcraft": "^0.1.1",                                    // ← 来自 npm
+    // 或者，本地开发时用 link 指向本仓库：
+    // "@ninkch/dsh-artcraft": "link:D:/code/deepseek-plugin/dsh-artcraft"
+  },
+  "dsh": { "profile": { "bundles": [
+    // ...已有 bundles...
+    "@ninkch/dsh-artcraft"                                               // ← 加入白名单
+  ] } }
+}
+```
+
+然后建立链接并重启一次 Harness（Host 侧代码只在启动时加载）：
+
+```sh
+pnpm install --dir C:/Users/<你>/.dsh/profiles/desktop
+```
+
+> 若你的 Harness 版本带有"从文件夹安装插件"的管理界面，用它也行 —— 最终落盘的就是上面两行。
+
+**3. 配置** `index.js` 旁边的 `artcraft.config.json`（从 `artcraft.config.json.example` 复制；
+该文件已 gitignore，且每次请求都会重读 —— 改路径无需重启）：
+
+```jsonc
+{
+  "dataRoot": "D:/craft-workspace",              // 素材与产物的根目录
+  "bins": {
+    // 三种写法：目录（自动拼接 <名>-cli 可执行文件）、完整 exe 路径、或走 PATH 的裸命令名
+    "photocraft":  "C:/craft/photocraft-0.6.0-windows-x64-portable",
+    "filmcraft":   "C:/craft/filmcraft-0.5.0-windows-x64-portable",
+    "effectcraft": "C:/craft/effectcraft-windows-x64-portable"
+  },
+  "control": { "filmcraft": 9876, "effectcraft": 9877 }
+}
+```
+
+**4. 验证。** 在任意 Harness 对话里让 AI 执行 `artcraft_status`，`bins.*.found` 全绿即就绪。
+
+## 在对话里驱动
+
+插件注册四个工具，agent 自行编排，所以自然语言直接可用：
+
+> *"把 `demo/media` 里的 PNG 都用柔和 S 曲线调色、智能锐化 80，结果放进 `demo/out/graded`。"*
+
+这句话背后通常是：
+
+```
+artcraft_cli  { bin:"photocraft", args:["batch","--actions","demo/craft/grade.json",
+                                        "--in","demo/media","--out","demo/out/graded"] }
+```
+
+| 工具 | 用途 |
+|---|---|
+| `artcraft_status` | 工具体检：CLI 是否找到、数据目录、控制端口、进行中的任务 |
+| `artcraft_cli` | 同步执行任意 CLI 子命令（`photocraft-cli run/batch`、`filmcraft-cli commands` 等） |
+| `artcraft_control` | 向**运行中**的 FilmCraft / EffectCraft 控制通道发一条命令 |
+| `artcraft_fs` | 在 `dataRoot` 内 list / stat / 读 / 写 / 建目录（写 `grade.json`、取回 `.ecproj` 等） |
+
+## 在浏览器里驱动
+
+同源 HTTP，JSON 进出。核心模式是**任务生命周期**——发起、轮询、取回，长渲染不占用请求周期：
+
+```
+POST /artcraft/api/job      { "bin":"effectcraft",
+                              "args":["render","--comp","Main",
+                                      "--out","demo/out/intro.mp4","demo/craft/intro.ecproj"],
+                              "outputs":["demo/out/intro.mp4"] }
+                         →  { "id":"7f2c…" }
+
+GET  /artcraft/api/job?id=7f2c…&tail=30
+                         →  { "status":"running|done|failed|timeout",
+                              "stdout":"…尾部日志…", "stderr":"…",
+                              "outputs":[{"rel":"demo/out/intro.mp4","exists":true,"size":812345}] }
+
+GET  /artcraft/api/file?rel=demo/out/intro.mp4        → 原始字节（流式）
+POST /artcraft/api/job/cancel  { "id":"7f2c…" }
+```
+
+全部路由：
+
+| 路由 | 用途 |
+|---|---|
+| `GET /artcraft/api/status` | 工具体检（与 `artcraft_status` 同数据） |
+| `GET /artcraft/api/projects` | `dataRoot` 下的项目目录 |
+| `POST /artcraft/api/fs?action=write&rel=…` | 写文件 —— 原始字节流（Blob 直传）或 JSON `{rel, text\|base64}` |
+| `GET /artcraft/api/fs?op=list\|stat\|readtext&rel=…` | 读目录、元数据、小文本 |
+| `GET /artcraft/api/file?rel=…` | 下载文件 —— 流式，上限 2 GB |
+| `POST /artcraft/api/job` · `GET ?id=…` · `POST /artcraft/api/job/cancel` | 任务生命周期，含产物探测与日志尾部 |
+| `POST /artcraft/api/control` | 控制通道同步调用 |
+
+上传单次上限 320 MB（原始路径 Blob 直传，无需 base64）；下载流式上限 2 GB。
+所有路径参数相对 `dataRoot` 且被限制在其中。
+
+## 控制通道：驱动正在运行的 App
+
+CLI 是无头、一次性的。想边看边调 —— 调色、扒片 —— 就带控制通道启动桌面 App，实时对话：
+
+```sh
+filmcraft --control 9876      # 或设 FILMCRAFT_CONTROL_PORT；仅回环监听
+```
+
+```jsonc
+POST /artcraft/api/control
+{ "app": "filmcraft", "method": "engine.execute",
+  "params": { "command": "timeline.place",
+              "params": { "item": 1, "track": "V1", "seconds": 0, "duration": 1270080000000 } } }
+
+// 给 87 号片段上一条 Lumetri 曲线……
+{ "command": "effects.setParam",
+  "params": { "clip": 87, "effect": "lumetri", "param": "curve_luma",
+              "value": [[0,0],[0.25,0.21],[0.75,0.82],[1,1]] } }
+
+// ……再看一眼 App 里长什么样
+{ "method": "ui.screenshot", "params": { "path": "frame.png" } }
+```
+
+时间可传 `seconds` / `frame` / `timecode`（FilmCraft 内部以每秒 254,016,000,000 tick 计）。
+`filmcraft-cli commands` 列出全部 650+ 引擎命令；协议详见
+[filmcraft/docs/control-protocol.md](https://github.com/storytold/filmcraft/blob/main/docs/control-protocol.md)。
+EffectCraft 同族协议，端口默认 9877。
+
+> PhotoCraft 的控制通道是带鉴权的变体，本插件**有意不代理** —— PhotoCraft 走无头 CLI 足够。
+
+## 与无限画布（infinite-canvas）协作
+
+两个插件零代码耦合，只在 HTTP 和磁盘布局上会合。画布侧：
+
+1. 把生成的资产（IndexedDB Blob）同步进 `<项目>/media/`；
+2. 以 `<项目>/craft/` 里的工程文件发起 PhotoCraft / FilmCraft / EffectCraft 任务；
+3. 从 `<项目>/out/` 取回成片入库。
+
+如果你要做类似的前端，照此契约即可：项目名作文件夹名、保持 `media · craft · out` 三件套，
+一切自然组合。
+
+## 常用配方
+
+**分镜图统一调色** —— `demo/craft/grade.json`：
+
+```json
+{ "actions": [
+  { "cmd": "layer.newAdjustmentLayer.curves", "params": { "points": [[0,0],[64,48],[192,212],[255,255]] } },
+  { "cmd": "filter.sharpen.smartSharpen",     "params": { "amount": 80 } }
+] }
+```
+
+```sh
+photocraft-cli batch --actions demo/craft/grade.json --in demo/media --out demo/out/graded
+```
+
+**告别浏览器录屏的成片** —— 画布把分镜导出为 FCP7 XML（`xmeml`）或 CMX3600 EDL 写入
+`demo/craft/timeline.xml`；FilmCraft 导入后自动关联 `demo/media/`，导出 H.264（Windows 走
+NVENC 硬编）、ProRes、DNxHR，附 EBU R128 响度归一与字幕烧录。交换格式是 FilmCraft 自动化
+最划算的地方 —— EDL/XML 是纯文本，你的流水线本来就会写。
+
+**动画字幕即代码** —— EffectCraft 工程（`.ecproj`）是版本化 JSON，模型可以直接写、也可以填
+模板。渲染成 MP4/ProRes —— 带 alpha 的 ProRes 4444 可直接叠进 FilmCraft 当图形层 —— 或导出
+**Lottie**，在网页里内联播放。
+
+## 排错
+
+- **`bins.*.found: false`** —— 核对上面的路径写法；CLI 必须在 App 目录旁（或在 `PATH`）。
+  改 `artcraft.config.json` 下一次请求即生效。
+- **`/artcraft/api/*` 返回 404** —— bundle 没在 profile 注册（见"安装"），或注册后没重启。
+  对话里调 `artcraft_status` 是最快探针。
+- **控制通道连接失败** —— App 必须以 `--control <端口>` 启动；通道仅回环且无鉴权，端口上
+  不会有别的应答者。
+- **任务卡住** —— `GET /artcraft/api/job` 带日志列出全部任务，按 id 取消；插件重载会按设计
+  终止所有子任务。
+- **路径越界报错** —— 设计如此：所有文件参数必须落在 `dataRoot` 之内。
+
+## 安全与信任模型
+
+HTTP 面无鉴权，挂在 Harness Web 服务之下（仅回环监听）—— 把端口当本机可信处理，**不要暴露
+到网络**；确需远程请加带鉴权的反向代理。子进程锁定三个白名单可执行文件；文件访问锁定
+`dataRoot`；控制通道只会拨 `127.0.0.1`。
+
+## 发布
+
+本插件已发布到 npm：**[`@ninkch/dsh-artcraft`](https://www.npmjs.com/package/@ninkch/dsh-artcraft)**
+（带 scope 的包发布时需要 `npm publish --access public`）。使用时把包名加进 Harness profile 的
+`dependencies` 与 `dsh.profile.bundles`（见"安装"），profile 里跑一次 `pnpm install` 即可。
+本地开发则把依赖换成 `"link:<本仓库路径>"`。包名必须一致的三处：profile 的 `package.json`
+（依赖 + bundles）、本仓库的 `cordis.patch.yml`。
+
+GitHub 上传本仓库即可：`README.md` 英文优先，附
+[简体中文](README.zh-CN.md) 对照。
+
+**发版走 npm Trusted Publishing**（GitHub Actions OIDC —— 无令牌、无 OTP）：
+`.github/workflows/publish.yml` 在 `v*` 标签推送时触发；npm 包侧的可信发布指向
+`NINKCH/dsh-artcraft` / `publish.yml`。发版流程：改 `version` → 提交 → `git tag v0.x.y && git push origin v0.x.y`。
+
+## 许可
+
+**本插件（`@ninkch/dsh-artcraft`）：Apache-2.0**（见 [LICENSE](LICENSE)）。不包含 ArtCraft 应用的任何代码 —— 只调用其公开自动化面
+（无头 CLI + JSON 控制通道）。
+
+**ArtCraft 各应用本身并非 OSI 开源**：它们采用 **ArtCraft License (WIP)** —— 一种 "fair source"
+（公平源代码）许可（[全文见 NOTICE.md](NOTICE.md)）。给构建在其上的使用者划重点：
+
+- ✅ 免费使用；可为私人目的备份、复制、修改、编译
+- ✅ **用这些应用创作的所有媒体完全归你** —— 渲染出的短剧成片就是你的商业资产，没有附加条件
+- ❌ 不得把应用当作自己的软件出售；不得用其代码开发竞品
+- ❌ 不得在 fork 中移除社区/捐赠链接；未经许可不得用 ArtCraft 名称、Logo 或吉祥物做商业宣传
+- 🤝 团队公开承诺：若业务终结，软件将转为 OSI 认可的开源许可
+
+对 AI 短剧工作室的务实解读：本地随便用，别动应用里的社区链接，卖你的片子——而不是卖应用。

package/artcraft.config.json.example

@@ -0,0 +1,12 @@
+{
+  "dataRoot": "D:/craft-workspace",
+  "bins": {
+    "photocraft": "C:/craft/photocraft-0.6.0-windows-x64-portable",
+    "filmcraft": "C:/craft/filmcraft-0.5.0-windows-x64-portable",
+    "effectcraft": "C:/craft/effectcraft-0.1.0-windows-x64-portable"
+  },
+  "control": {
+    "filmcraft": 9876,
+    "effectcraft": 9877
+  }
+}

package/client.js

@@ -0,0 +1,181 @@
+// @ninkch/dsh-artcraft — client half.
+// 侧栏 "ArtCraft" 按钮 + 面板：工具链状态 / 自更新（检查 + 一键应用）。
+window.__ModuleLoader__.load({
+  id: '@ninkch/dsh-artcraft',
+  factory(require) {
+    const React = require('react');
+    const h = React.createElement;
+    const { useState, useEffect, useCallback, useRef } = React;
+
+    const NS = 'artcraft';
+    const PANEL_ID = 'artcraft';
+    const API = '/artcraft/api';
+
+    const CSS = `
+.dshac-panel { padding: 14px; font-size: 13px; line-height: 1.5; overflow: auto; height: 100%; box-sizing: border-box; }
+.dshac-h { font-size: 14px; font-weight: 600; margin: 0 0 10px; display: flex; align-items: center; gap: 8px; }
+.dshac-card { border: 1px solid var(--dsw-border-primary, rgba(128,128,128,.35)); border-radius: 10px; padding: 12px; margin-bottom: 12px; }
+.dshac-title { font-weight: 600; margin-bottom: 8px; display: flex; justify-content: space-between; align-items: center; }
+.dshac-row { display: flex; align-items: center; gap: 8px; margin: 4px 0; }
+.dshac-dot { width: 9px; height: 9px; border-radius: 50%; flex: none; }
+.dshac-dot.ok { background: #34c759; } .dshac-dot.bad { background: #ff5f57; } .dshac-dot.unknown { background: #8e8e93; }
+.dshac-mono { font-family: ui-monospace, Consolas, monospace; font-size: 12px; word-break: break-all; }
+.dshac-muted { opacity: .65; font-size: 12px; }
+.dshac-btn { border: 1px solid var(--dsw-border-primary, rgba(128,128,128,.4)); background: transparent; color: inherit;
+  border-radius: 7px; padding: 4px 12px; font-size: 12px; cursor: pointer; }
+.dshac-btn:hover:not(:disabled) { background: rgba(128,128,128,.15); }
+.dshac-btn:disabled { opacity: .5; cursor: default; }
+.dshac-btn.primary { background: rgba(80,120,255,.25); }
+.dshac-out { white-space: pre-wrap; font-family: ui-monospace, Consolas, monospace; font-size: 11px;
+  background: rgba(128,128,128,.12); border-radius: 7px; padding: 8px; margin-top: 8px; max-height: 180px; overflow: auto; }
+.dshac-note { margin-top: 8px; color: var(--dsw-alias-state-warning-primary, #d69e2e); font-size: 12px; }
+.dshac-ok { color: var(--dsw-alias-state-success-primary, #34c759); }
+`;
+
+    async function api(path, opts) {
+      const ctrl = typeof AbortController !== 'undefined' ? new AbortController() : null;
+      const timer = ctrl ? setTimeout(() => ctrl.abort(), 30000) : null;
+      try {
+        const res = await fetch(API + path, { ...(opts || {}), signal: ctrl ? ctrl.signal : undefined });
+        const j = await res.json().catch(() => ({}));
+        if (!res.ok) throw new Error(j.error || ('HTTP ' + res.status));
+        return j;
+      } finally { if (timer) clearTimeout(timer); }
+    }
+
+    function Dot({ ok }) {
+      return h('span', { className: 'dshac-dot ' + (ok === true ? 'ok' : ok === false ? 'bad' : 'unknown') });
+    }
+
+    function PanelIcon() {
+      return h('svg', { width: 18, height: 18, viewBox: '0 0 20 20', fill: 'none' },
+        h('rect', { x: 3, y: 3, width: 14, height: 14, rx: 3, stroke: 'currentColor', 'stroke-width': 1.5 }),
+        h('path', { d: 'M6.5 10h4M8.5 8v4', stroke: 'currentColor', 'stroke-width': 1.5, 'stroke-linecap': 'round' }),
+        h('circle', { cx: 13.5, cy: 13, r: 1.6, fill: 'currentColor' }),
+      );
+    }
+
+    function ArtCraftPage() {
+      const [status, setStatus] = useState(null);
+      const [statusErr, setStatusErr] = useState(null);
+      const [upd, setUpd] = useState(null);
+      const [busy, setBusy] = useState('');
+      const [out, setOut] = useState('');
+      const [needRestart, setNeedRestart] = useState(false);
+      const alive = useRef(true);
+      useEffect(() => () => { alive.current = false; }, []);
+
+      const loadStatus = useCallback(async () => {
+        try {
+          const s = await api('/status');
+          if (!alive.current) return;
+          setStatus(s); setStatusErr(null);
+        } catch (e) {
+          if (!alive.current) return;
+          setStatusErr(String(e.message || e));
+        }
+      }, []);
+      const checkUpdate = useCallback(async () => {
+        setBusy('check'); setOut('');
+        try {
+          const u = await api('/update/check');
+          if (!alive.current) return;
+          setUpd(u);
+          setOut(u.updateAvailable
+            ? `有新版本：${u.latest}（当前 ${u.current}），安装方式：${u.mode === 'git' ? 'git 仓库' : 'npm 安装'}`
+            : `已是最新${u.latest ? '（npm latest ' + u.latest + '）' : ''}${u.note ? ' · ' + u.note : ''}`);
+        } catch (e) { if (alive.current) setOut('检查失败：' + String(e.message || e)); }
+        finally { if (alive.current) setBusy(''); }
+      }, []);
+      const applyUpdate = useCallback(async () => {
+        setBusy('apply'); setOut('');
+        try {
+          const r = await api('/update/apply', { method: 'POST', headers: { 'content-type': 'application/json' }, body: '{}' });
+          if (!alive.current) return;
+          setOut((r.output || String(r.message || '')) + (r.needRestart ? '\n\n✅ 更新完成 —— 请重启 DeepSeek Harness 后生效。' : ''));
+          if (r.needRestart) setNeedRestart(true);
+        } catch (e) { if (alive.current) setOut('更新失败：' + String(e.message || e)); }
+        finally { if (alive.current) setBusy(''); }
+      }, []);
+
+      useEffect(() => { loadStatus(); checkUpdate(); }, [loadStatus, checkUpdate]);
+
+      const bins = status?.bins ?? {};
+      const binRow = (key, label) => {
+        const b = bins[key];
+        return h('div', { className: 'dshac-row' },
+          h(Dot, { ok: b ? b.found : null }),
+          h('span', null, label),
+          b?.found ? null : h('span', { className: 'dshac-muted' }, b?.note || '未配置'),
+        );
+      };
+
+      return h('div', { className: 'dshac-panel' },
+        h('div', { className: 'dshac-h' }, 'ArtCraft Bridge',
+          status ? h('span', { className: 'dshac-muted' }, 'v' + status.version) : null),
+
+        statusErr
+          ? h('div', { className: 'dshac-card' },
+              h('div', { className: 'dshac-title' }, '未连接'),
+              h('div', { className: 'dshac-muted' }, statusErr + ' —— 插件可能未注册或 Harness 需要重启。'))
+          : h('div', { className: 'dshac-card' },
+              h('div', { className: 'dshac-title' }, '工具链',
+                h('button', { className: 'dshac-btn', onClick: loadStatus, disabled: busy !== '' }, '刷新')),
+              binRow('photocraft', 'PhotoCraft (CLI)'),
+              binRow('filmcraft', 'FilmCraft (CLI)'),
+              binRow('effectcraft', 'EffectCraft (CLI)'),
+              status?.dataRoot ? h('div', { className: 'dshac-row dshac-muted' },
+                '数据目录：', h('span', { className: 'dshac-mono' }, status.dataRoot.path)) : null),
+
+          h('div', { className: 'dshac-card' },
+            h('div', { className: 'dshac-title' }, '插件更新',
+              h('button', { className: 'dshac-btn primary', onClick: checkUpdate, disabled: busy !== '' },
+                busy === 'check' ? '检查中…' : '检查更新')),
+            upd
+              ? h('div', { className: 'dshac-row' },
+                  h('span', null, '当前 v' + (upd.current ?? '?')),
+                  h('span', { className: 'dshac-muted' }, '→'),
+                  h('span', { className: upd.updateAvailable ? 'dshac-ok' : 'dshac-muted' },
+                    'npm latest v' + (upd.latest ?? '—')),
+                  upd.mode ? h('span', { className: 'dshac-muted' },
+                    '（' + (upd.mode === 'git' ? 'git 仓库 · ' + (upd.branch || '?') + (upd.gitClean === false ? ' · 有本地改动' : ' · 工作区干净') : 'npm 安装') + '）') : null)
+              : h('div', { className: 'dshac-muted' }, '尚未检查'),
+            h('div', { style: { marginTop: '8px' } },
+              h('button', {
+                className: 'dshac-btn primary',
+                onClick: applyUpdate,
+                disabled: busy !== '' || !upd?.updateAvailable,
+                title: upd?.updateAvailable ? '' : '先检查更新，有新版本才可应用',
+              }, busy === 'apply' ? '更新中…' : '一键更新')),
+            needRestart ? h('div', { className: 'dshac-note' }, '更新已写入 —— 重启 DeepSeek Harness 后生效。') : null,
+            out ? h('div', { className: 'dshac-out' }, out) : null),
+      );
+    }
+
+    return {
+      inject: ['slots', 'locale'],
+      apply(ctx) {
+        ctx.effect(() => ctx.locale.register(NS, { zh: { panel: 'ArtCraft' }, en: { panel: 'ArtCraft' } }), 'artcraft: dictionaries');
+        ctx.effect(() => {
+          const el = document.createElement('style');
+          el.id = 'dshac-styles';
+          el.textContent = CSS;
+          document.head.appendChild(el);
+          return () => el.remove();
+        }, 'artcraft: styles');
+        ctx.slots.inject('sidebar.panellist', () => ctx.slots.register({
+          name: 'sidebar.panellist',
+          id: PANEL_ID,
+          order: 101,
+          label: () => 'ArtCraft',
+          locale: NS,
+        }, PanelIcon));
+        ctx.slots.inject('main', () => ctx.slots.register({
+          name: 'main',
+          key: PANEL_ID,
+          locale: NS,
+        }, ArtCraftPage));
+      },
+    };
+  },
+});

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+- insert:
+    - id: artcraft
+      name: '@ninkch/dsh-artcraft'
+      config: {}