@q253595422/dsh-imagegen-video 1.8.0 → 1.9.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,26 +1,94 @@
1
1
  # Changelog
2
2
 
3
- This project is a fork of [dsh-imagegen](https://github.com/dickpy/dsh-imagegen).
4
- The fork starts from the upstream **v1.6.8** release source, which is preserved as
5
- the first commit (`baseline: upstream @dickpy/dsh-imagegen v1.6.8 source`). Every
6
- commit after that is this fork's own work.
7
-
8
- The list below describes the fork's delta against that baseline. Commit-level
9
- detail is in `git log 9305f9f..HEAD`.
3
+ Releases are listed newest first. Commit-level detail is in `git log`.
4
+ Attribution for third-party code is in [NOTICE](./NOTICE).
10
5
 
11
6
  ## Releases
12
7
 
8
+ ### 1.9.3 — session images, PPT delivery, and xAI Grok video
9
+
10
+ Upstream 1.9.1 + 1.9.2 landed here, alongside this repository's own fixes.
11
+
12
+ - **A host Agent failure is reported as itself.** Model and execution errors are
13
+ kept (and redacted) instead of surfacing as "no final PPTX was produced";
14
+ a run with no reply points at the default-model connection and tool setup.
15
+ - **The upstream skill's own `final/` deck is collected.** Only a run summary
16
+ marked complete with a passed validation report qualifies, and the deck is
17
+ still checked for PPTX structure and page count — an intermediate page file
18
+ never becomes the result.
19
+ - **PPT configuration opens in place.** The dialog reuses the generation
20
+ settings' own fields rather than reaching for the host settings button by DOM
21
+ lookup, with Escape, focus containment and return-to-trigger.
22
+ - **Uploads become a thumbnail grid** with an add tile: preview, reorder, delete,
23
+ and the order is the slide order.
24
+ - **The result pane shows only the final PPTX**, auto-opened: left column for
25
+ sources and options, right for the deck with page thumbnails, previous/next,
26
+ expand and download. Narrow screens go single-column with the source list
27
+ scrolling on its own. A task diagnostic entry exports the run's identifiers,
28
+ a failed preview can be retried, and the download survives the error.
29
+ - **Conversation tool results show their images again.** The renderer reads DSH's
30
+ persisted result metadata, so text-to-image, image-to-image and task-query
31
+ results all display thumbnails and open the original; older sessions keep
32
+ working through their image content blocks and JSON references, and a repeated
33
+ attachment appears once. Images stay UI data — what the model receives is
34
+ still text.
35
+ - **`format v4 message requires a producer-owned source kind` is fixed.** A PPT
36
+ run's first message carries `plugin:dsh-imagegen` instead of the v4-rejected
37
+ plugin wrapper; cast-heavy canvas skills share the fix.
38
+ - **Grok video speaks xAI's own contract.** A new `xai` family submits to
39
+ `/v1/videos/generations` and reads `request_id`, polls
40
+ `/v1/videos/{request_id}` for `video.url` / `video.duration`, and reports
41
+ `failed` and `expired` as failures. The body sends a numeric `duration`, a
42
+ lowercase `resolution` and `image: { url }`. The `xai-grok` preset ships
43
+ `grok-imagine-video-1.5` and `-lite`.
44
+ - **The narrow centre column stays usable.** Below 760px the conversation row
45
+ sizes to its content, the studio scrolls as a whole, and the config column no
46
+ longer stretches the layout — the generate button and the canvas stay reachable.
47
+ - **Desktop updates run through the launcher's install hook** and verify what it
48
+ actually reports: installed bundle, version, exit code and error code are each
49
+ checked, and an unverifiable result fails rather than claiming success.
50
+
51
+ ### 1.9.0 — images to an editable PPTX
52
+
53
+ A standalone conversion workspace, reached from any finished image.
54
+
55
+ - **A PPT workspace of its own.** Upload PNG / JPG / WebP — up to 12, 20 MB each —
56
+ reorder or remove the thumbnails (the order is the slide order), and convert.
57
+ The run reports its real state: running, cancellable, done with a download, or
58
+ failed; the inputs stay put so a deck can be converted again.
59
+ - **Every result can start a conversion.** Text-to-image, image-to-image,
60
+ the multi-model comparison cards and the full-screen preview each gained a
61
+ "make an editable PPT" action that carries the image into the workspace.
62
+ - **A PPT section in the settings card.** Install or update the official skill,
63
+ install and check the isolated `editppt` Python environment, configure the
64
+ image API and an optional PaddleOCR token. Keys go through the existing
65
+ redacted secret storage and never enter the task prompt.
66
+ - **OCR is a choice, not a requirement.** PaddleOCR, or the offline text
67
+ detection that ships with the conversion.
68
+ - **A conversion that produced nothing is reported as failed.** No final PPTX, an
69
+ invalid ZIP, or a page-count mismatch all fail loudly; a task interrupted by a
70
+ host restart shows as interrupted and can be started again.
71
+ - **PPT routes validate before they run.** The client sends asset ids only and the
72
+ host rebuilds the URL, so a caller cannot point the conversion at an arbitrary
73
+ address; image count, asset-id syntax and the OCR flag are checked up front,
74
+ and the refusal names what is missing. Covered by `C6c4`.
75
+ - **The nav scrolls on a phone.** At ≤760px the top nav scrolls horizontally
76
+ instead of pushing entries off-screen, and settings summaries wrap.
77
+
78
+ Prerequisites: Python 3.10+, a configured default model, skills and long tasks
79
+ enabled, and an Agent preset with file and command tools. Multi-page runs use the
80
+ skill's own page tasks, which need sub-agent support in the preset.
81
+
13
82
  ### 1.8.0 — multi-reference editing, a template drawer, and honest wait states
14
83
 
15
- Four capabilities absorbed from upstream v1.8.0–v1.8.3, each ported file by file
16
- against our own tree (the two histories share no ancestor). Everything below is
17
- now this repository's code; the version number is ours.
84
+ Four capabilities: multi-reference editing, a template drawer, wait states that
85
+ show they are waiting, and results that are no longer cropped.
18
86
 
19
87
  - **Image editing takes up to five reference images.** The first stays in
20
88
  `image` and the rest travel in `images`, so a single-reference provider still
21
89
  sees exactly one image and every existing request shape is unchanged. The
22
- engine half of this was already present and byte-identical to upstream; what
23
- was missing was the panel: the form held one `refImage`, so the protocol could
90
+ engine half of this was already present; what was missing was the panel: the
91
+ form held one `refImage`, so the protocol could
24
92
  never be reached from the UI. It now holds a list, with multi-select, drag,
25
93
  paste, per-image removal, a preview with arrow-key paging, and the documented
26
94
  limits (5 images, 10 MiB each, 16 MiB total) enforced in one place
@@ -33,7 +101,7 @@ now this repository's code; the version number is ours.
33
101
  can be dragged from its left edge or expanded to the full workspace, goes
34
102
  full-width on phones, searches across every library, and keeps the last 24
35
103
  used templates for one-click reuse. A picked prompt can replace the composer
36
- text or be appended to it. Two things upstream dropped were kept on purpose:
104
+ text or be appended to it. Two things were kept on purpose:
37
105
  `favorites: null` still means "not loaded yet" (so a failed read shows an
38
106
  unknown star and a retry, not a wall of un-favourited cards), and the shared
39
107
  roving-tabindex helper still walks the source tabs.
@@ -48,23 +116,34 @@ now this repository's code; the version number is ours.
48
116
  instead of having its edges cut off. The ecommerce cards keep their `cover`
49
117
  override — that rule is what stops a product shot from being letterboxed.
50
118
 
51
- Two deliberate departures from upstream:
119
+ Two deliberate choices:
52
120
 
53
- - **Desktop updates still explain themselves.** Upstream v1.8.2 restores
54
- in-panel updates when the host exposes an install hook, and otherwise shows a
55
- bare hint. We took the first half — `updateInstallTarget()` reports
121
+ - **Desktop updates still explain themselves.** In-panel updates run when the
122
+ host exposes an install hook, and otherwise show an explanation rather than a
123
+ bare hint. `updateInstallTarget()` reports
56
124
  `cli` / `host` / `host-managed`, and the `host` path installs the exact Release
57
125
  tarball through the host and then verifies `application`, exit code, bundle
58
126
  name and version, falling back to the installed manifest when an older host
59
127
  omits the version (an unverifiable install is a failure, never a success) —
60
- but kept `ManualUpdateRequiredError` for the managed case, because our panel
128
+ and `ManualUpdateRequiredError` stays for the managed case, because the panel
61
129
  renders a copyable command from `details.tarballUrl` and a one-line hint would
62
130
  lose that.
63
- - **One primary label in the template detail view.** Upstream renames the button
64
- to "Replace" once the composer holds text. Ours says "Use this prompt" in both
131
+ - **One primary label in the template detail view.** The button does not get
132
+ renamed to "Replace" once the composer holds text. It says "Use this prompt" in both
65
133
  cases and adds a separate "Add" button only when there is something to append
66
134
  to, so the primary action never changes meaning under the user.
67
135
 
136
+ One gate added after 1.8.0 shipped:
137
+
138
+ - **A version bump without its notes is now a failure.** This release reached
139
+ the Release page without `docs/releases/v1.8.0.md`, so `release.yml` fell back
140
+ to GitHub's auto-generated "Full Changelog: <compare link>" line — a ::warning
141
+ in a log nobody reads — and the tag froze that one-line page the moment it was
142
+ created. `verify-pack.mjs` now requires `docs/releases/v<version>.md` to exist
143
+ and to be inside the archive (it is in `files`), which runs in CI before
144
+ anything is packed. Two negative cases prove the assertion: bumping `version`
145
+ with no notes file, and dropping `docs/releases` from `files`.
146
+
68
147
  ### 1.7.8 — the manifest stops claiming a package the host already provides
69
148
 
70
149
  One packaging correction, no behaviour change.
@@ -84,8 +163,8 @@ One packaging correction, no behaviour change.
84
163
 
85
164
  ### 1.7.7 — deleting becomes undoable, the poster editor arrives, and the update chain stops lying
86
165
 
87
- Three user-visible failures and one piece of upstream functionality, plus the
88
- release process itself moving onto a machine that runs the gates.
166
+ Three user-visible failures and one new feature, plus the release process itself
167
+ moving onto a machine that runs the gates.
89
168
 
90
169
  - **Deleting a gallery entry no longer destroys its bytes.** Removal was an
91
170
  unlink, so every history row and canvas node still holding that URL turned
@@ -101,7 +180,7 @@ release process itself moving onto a machine that runs the gates.
101
180
  and the purge confirmation's count could all have broken silently. Each has a
102
181
  check now, and the section stopped printing its own count heading directly
103
182
  under the toggle that already says it.
104
- - **The poster editor is ported from upstream v1.7.0.** Text and logo layers are
183
+ - **The poster editor is new.** Text and logo layers are
105
184
  composited over an image node locally with Canvas 2D — no model call, no
106
185
  quota. Saving uploads the flattened bitmap as a new image node and stores the
107
186
  recipe in that node's `metadata.poster` (the new node is wired to its source),
@@ -121,8 +200,8 @@ release process itself moving onto a machine that runs the gates.
121
200
  other two, so the flag-only reading targeted the wrong profile for every
122
201
  Desktop user — even a successful update left the running host on the old
123
202
  plugin. DSH Desktop's profile is locked by the CLI — spawning it anyway
124
- produced a bare "update failed" with no cause, the dead end in upstream issue
125
- #41 — so that profile now throws `ManualUpdateRequiredError`
203
+ produced a bare "update failed" with no cause — so that profile now throws
204
+ `ManualUpdateRequiredError`
126
205
  (`update-manual-required`) carrying the archive URL, and the panel shows a
127
206
  copyable install command instead of a scary error. A failed spawn keeps the
128
207
  last three lines of the CLI's stderr (`STDERR_LIMIT` 4 000 chars) so a pnpm
@@ -278,7 +357,7 @@ included on their licences, takes the library from 5 sources / 2462 cases to
278
357
  Two things: a full pass over the plugin's UI, driven by real defects rather than
279
358
  taste (the theme no longer leaks into component internals, and the layer order is
280
359
  written down in one place), and a failed call that can actually be explained —
281
- including on the video chain, which upstream's version of that work did not cover.
360
+ including on the video chain, where a failed render had nowhere to be inspected.
282
361
 
283
362
  - **The nav follows the host theme at runtime.** `GooeyNav` had its four colors
284
363
  baked in as literals and detected the surface only once, at mount. Switching
@@ -326,12 +405,6 @@ including on the video chain, which upstream's version of that work did not cove
326
405
 
327
406
  #### The record of a failed call, and the video chain made equal to it
328
407
 
329
- Upstream's diagnostics work (#38) is part of this release. Their history and ours
330
- share no ancestor — this fork's baseline is a squash of v1.6.8 — so `git merge`
331
- is refused outright and the work landed as a file-level port rather than a merge.
332
- Attribution for their code is in [NOTICE](./NOTICE). The version line here is this
333
- repository's own and does not follow theirs.
334
-
335
408
  - **Diagnostics: every failed upstream attempt is now on the record.** A new
336
409
  in-memory ring buffer (200 entries, cleared on restart, never written to disk)
337
410
  keeps the *final* request URL, the HTTP status, the network code
@@ -346,9 +419,9 @@ repository's own and does not follow theirs.
346
419
  - **The studio no longer hides behind the plugin-market page.** Both live in the
347
420
  same `main` slot, so switching from the conversation to the studio left two
348
421
  panels in the column. The keyed slot now yields for non-conversation content.
349
- - **The video chain records into the same buffer.** Upstream's #38 covered
350
- images only, so a user whose images worked and whose videos did not had
351
- nowhere to look — and `DiagnosticPhase` could not even name the video legs.
422
+ - **The video chain records into the same buffer.** A user whose images work and
423
+ whose videos do not would otherwise have nowhere to look — and
424
+ `DiagnosticPhase` could not even name the video legs.
352
425
  Video is submit → poll → download rather than one synchronous call, so each leg
353
426
  is its own phase (`video-submit` / `video-poll` / `video-download`), and
354
427
  "the render never started" is now distinguishable from "the status endpoint
@@ -405,7 +478,7 @@ repository's own and does not follow theirs.
405
478
  node guard accepted only `image` / `text` / `file` / `config` while
406
479
  `CanvasNodeType` also declares `video`, so `coerceDocument` returned undefined
407
480
  and `save()` answered `malformed canvas document`. Video nodes on the canvas
408
- are this fork's headline feature, which made the feature unusable end to end:
481
+ are this plugin's headline feature, which made the feature unusable end to end:
409
482
  place a clip, and the canvas stopped saving.
410
483
 
411
484
  No suite caught it because the canvas-video suite answers `/canvas/save` with a
@@ -523,17 +596,14 @@ closes the class of gaps that let a release go out with no automated check.
523
596
  - The issue templates lost a duplicated install-method option and an
524
597
  outdated version placeholder.
525
598
 
526
- ### 1.7.0 — first published release of the fork
599
+ ### 1.7.0 — first published release
527
600
 
528
- The fork's first published release. It ships as a **GitHub Release asset**
601
+ This project's first published release. It ships as a **GitHub Release asset**
529
602
  (`q253595422-dsh-imagegen-video-1.7.0.tgz`), not as an npm package. Everything in
530
- "What the fork adds" below is in this release.
603
+ "What this plugin adds" below is in this release.
531
604
 
532
- - **The version line is this repository's own.** It starts at 1.7.0 rather than
533
- continuing upstream's 1.6.x, because this fork is an independent project and
534
- its releases are not upstream releases. (At the time, 1.6.8 would also have
535
- looked like it *predated* the very baseline it derives from, since upstream's
536
- own line had moved on.)
605
+ - **The version line is this project's own.** It starts at 1.7.0, so these
606
+ version numbers never collide with another plugin's release line.
537
607
  - **No absolute paths ship in the tarball.** `lib/` is published (it is in
538
608
  `files`), and Rolldown stamps each module's id into a `//#region <id>` banner
539
609
  that survives into the bundle. The CSS Modules virtual id used to be the CSS
@@ -552,11 +622,11 @@ The fork's first published release. It ships as a **GitHub Release asset**
552
622
  by name (the package archive for this version first), so a release that also
553
623
  carries another version-named archive cannot win by alphabetical accident.
554
624
 
555
- ## What the fork adds
625
+ ## What this plugin adds
556
626
 
557
- ### Video generation (the original motivation for the fork)
627
+ ### Video generation (the original motivation)
558
628
 
559
- Upstream generates images only. The fork adds a complete video pipeline:
629
+ A complete video pipeline, from the contract layer to the studio UI:
560
630
 
561
631
  - **Contract layer** — video types and the `VIDEO_API` route family, a video
562
632
  model catalog with per-family request shaping (`src/video-engine.ts`,
@@ -611,13 +681,13 @@ Select two or more video nodes and stitch them into one clip with the local
611
681
  - The sidebar refreshes the clip list when a render finishes, so a new row
612
682
  appears without a page reload.
613
683
 
614
- ### Fixes to inherited behaviour
684
+ ### Fixes to the image chain
615
685
 
616
- - **The update check no longer points at upstream.** `src/updater.ts` carried
617
- `PACKAGE_NAME = '@dickpy/dsh-imagegen'` and upstream's GitHub Releases API URL,
618
- so this fork's "check for updates" would have offered upstream's release notes
619
- and installed upstream's package over itself. Both now point at this
620
- repository. (Same class of problem as the package rename below.)
686
+ - **The update check points at this repository.** `src/updater.ts` carried
687
+ `PACKAGE_NAME = '@dickpy/dsh-imagegen'` and that project's GitHub Releases API
688
+ URL, so "check for updates" would have offered another package's release notes
689
+ and installed it over this plugin. Both now point at this repository. (Same
690
+ class of problem as the package rename below.)
621
691
  - The video studio composer was capped at 420px while an empty column took the
622
692
  remaining width; it now uses the full panel width (guarded by
623
693
  `scripts/verify-video-layout.mjs`).
@@ -631,8 +701,8 @@ Select two or more video nodes and stitch them into one clip with the local
631
701
 
632
702
  ### This repository's identity
633
703
 
634
- The fork publishes under its own name so it cannot be confused with, or
635
- mistaken for, upstream:
704
+ The plugin publishes under its own name so it cannot be confused with, or
705
+ mistaken for, another package:
636
706
 
637
707
  | Where | Value |
638
708
  | --- | --- |
@@ -642,8 +712,8 @@ mistaken for, upstream:
642
712
  | update check (`src/updater.ts`) | this repository |
643
713
 
644
714
  The npm package name is `@q253595422/dsh-imagegen-video` as well, but nothing is
645
- published there: the fork distributes through GitHub Releases, so both the README
646
- and the in-app update button install the release asset. `src/updater.ts` reads the
715
+ published there: releases go through GitHub Releases, so both the README and the
716
+ in-app update button install the release asset. `src/updater.ts` reads the
647
717
  asset URL from the release itself and refuses to install a release that carries no
648
718
  archive, rather than falling back to a registry spec that would resolve to nothing.
649
719
 
@@ -651,13 +721,12 @@ The **runtime identity is deliberately left alone**: the `/api/dsh-imagegen/*`
651
721
  route family, the `dsh-imagegen` settings namespace, the `~/.dsh/dsh-imagegen/`
652
722
  data root and the `dsh-imagegen:*` client events/storage keys all keep their
653
723
  inherited names. Renaming them would orphan the settings and data of anyone
654
- switching between the two installs, and the route prefix is upstream's design,
655
- not this fork's.
724
+ switching between the two installs, and the route prefix predates this plugin.
656
725
 
657
726
  ### Test infrastructure
658
727
 
659
- Upstream ships one smoke suite. The fork adds offline suites that run without
660
- network access or paid upstream calls, plus a guard for each defect found:
728
+ The offline suites run without network access or paid upstream calls, plus a
729
+ guard for each defect found:
661
730
 
662
731
  | Suite | Covers |
663
732
  | --- | --- |
@@ -674,17 +743,17 @@ Browser-dependent suites **skip loudly and exit 0** when the browser or
674
743
  `ffmpeg` is missing, so a contributor without those tools gets a clear "not
675
744
  verified" instead of a false failure.
676
745
 
677
- ## Configuration notes for this fork
746
+ ## Configuration notes
678
747
 
679
748
  - The `@q253595422/dsh-imagegen-video` package **cannot be installed alongside
680
- upstream `@dickpy/dsh-imagegen`**: both register the same
749
+ `@dickpy/dsh-imagegen`**: both register the same
681
750
  `/api/dsh-imagegen/*` route family and both inject the same UI panel. The
682
- route prefix is inherited from upstream, not introduced here.
751
+ route prefix predates this plugin.
683
752
  - Data (history, gallery, canvases, settings) lives under
684
- `~/.dsh/dsh-imagegen/` and keeps the inherited name, so it is *shared* with an
685
- upstream install. Back it up before switching between the two.
753
+ `~/.dsh/dsh-imagegen/` and keeps that name, so it is *shared* with an install
754
+ of `@dickpy/dsh-imagegen`. Back it up before switching between the two.
686
755
 
687
- ## Not in this fork
756
+ ## Not in this plugin
688
757
 
689
758
  - No paid upstream verification is performed by the test suites; all upstream
690
759
  interactions are replayed from fixtures.
package/LICENSE CHANGED
@@ -188,7 +188,7 @@
188
188
 
189
189
  Copyright 2026 q253595422
190
190
 
191
- This product is a fork of dsh-imagegen
191
+ This product includes code from dsh-imagegen
192
192
  (https://github.com/dickpy/dsh-imagegen). See NOTICE and
193
193
  THIRD_PARTY_NOTICES.md for the full attribution.
194
194
 
package/NOTICE CHANGED
@@ -1,29 +1,16 @@
1
1
  dsh-imagegen-video
2
2
  Copyright 2026 q253595422
3
3
 
4
- This product is a derivative work of dsh-imagegen:
4
+ This product includes code from dsh-imagegen:
5
5
 
6
6
  dsh-imagegen
7
7
  Copyright dickpy
8
8
  https://github.com/dickpy/dsh-imagegen
9
9
  Licensed under the Apache License, Version 2.0
10
10
 
11
- The upstream source this fork derives from is the v1.6.8 release source
12
- (github.com/dickpy/dsh-imagegen, tag v1.6.8). Every file that existed
13
- upstream is carried over unchanged except where the fork deliberately
14
- modified it; the fork's own changes are enumerated in CHANGELOG.md.
11
+ That attribution covers every part of this product that derives from that
12
+ project, whichever release it came from. Changes made here are this project's
13
+ own and are recorded in CHANGELOG.md.
15
14
 
16
- The fork also incorporates upstream code from LATER releases, taken
17
- selectively and re-applied by hand rather than merged (the two histories
18
- share no common ancestor). Each such incorporation is recorded in
19
- CHANGELOG.md under the release that carries it; for example the diagnostic
20
- record added in this fork's v1.7.5 includes upstream's diagnostics store and
21
- the failure-recording call sites from upstream issue #38. Upstream copyright
22
- and the Apache-2.0 license above cover that code as well.
23
-
24
- In all cases the fork is an independent project: it does not track upstream's
25
- release line or version numbers, and upstream functionality is adopted only
26
- when it is wanted.
27
-
28
- Third-party components bundled or referenced by this project are listed
29
- in THIRD_PARTY_NOTICES.md, which is carried over from upstream.
15
+ Third-party components bundled or referenced by this project are listed in
16
+ THIRD_PARTY_NOTICES.md.
package/README.md CHANGED
@@ -1,9 +1,8 @@
1
1
  # dsh-imagegen-video
2
2
 
3
- > **这是 [dickpy/dsh-imagegen](https://github.com/dickpy/dsh-imagegen) 的衍生版(fork)。**
4
- > 上游只做生图;本仓库在上游 v1.6.8 源码基础上增加了**完整的生视频链路**与
5
- > **画布视频节点、片段拼接**。上游的署名与许可证见 [NOTICE](./NOTICE),
6
- > 本仓库相对上游改了什么见 [CHANGELOG.md](./CHANGELOG.md)。
3
+ > **图片与视频一体化的 DSH 生图 / 生视频插件。**
4
+ > 生图之外,本仓库提供**完整的生视频链路**,以及**画布视频节点、片段拼接**。
5
+ > 各版本的改动见 [CHANGELOG.md](./CHANGELOG.md),第三方代码归属见 [NOTICE](./NOTICE)。
7
6
 
8
7
  <div align="center">
9
8
  <a href="https://github.com/q253595422/dsh-imagegen-video/releases"><img src="https://img.shields.io/github/v/release/q253595422/dsh-imagegen-video?color=cb3837&label=release" alt="Latest release" /></a>
@@ -16,7 +15,7 @@
16
15
 
17
16
  <p><strong>在 DeepSeek Harness 里,生成、编辑、管理,一站完成;图片与视频同一套工作流。</strong></p>
18
17
  <p><strong>快速导航</strong></p>
19
- <p><a href="#quick-start">🚀 快速开始</a> · <a href="#canvas">无限画布</a> · <a href="#compose">片段拼接</a> · <a href="#ecommerce">电商套图</a> · <a href="#txt2img">文生图 / 图生图</a> · <a href="#txt2video">生视频</a> · <a href="#gallery">模板 / 画廊</a> · <a href="#configuration">模型配置</a> · <a href="#community">交流群</a> · <a href="#upstream">上游与授权</a></p>
18
+ <p><a href="#quick-start">🚀 快速开始</a> · <a href="#canvas">无限画布</a> · <a href="#compose">片段拼接</a> · <a href="#ecommerce">电商套图</a> · <a href="#txt2img">文生图 / 图生图</a> · <a href="#txt2video">生视频</a> · <a href="#gallery">模板 / 画廊</a> · <a href="#configuration">模型配置</a> · <a href="#community">交流群</a> · <a href="#license">授权与致谢</a></p>
20
19
  </div>
21
20
 
22
21
  <a id="sponsor"></a>
@@ -30,7 +29,7 @@
30
29
  | <a href="https://github.com/jev-chat/jev-chat-jarvis"><img src="docs/images/sponsor-jevchat.png" width="170" alt="jev-chat" /></a> | **[jev-chat](https://github.com/jev-chat/jev-chat-jarvis)** — 聊天辅助决策工具:回复前先读懂对方意图与当下风险,再给出可一键填入的草稿,发不发由你。Android · Windows · macOS · iOS,MIT。<br><br>官网 `chatjevs.com` |
31
30
  | <a href="https://mrday.one/"><img src="docs/images/sponsor-mrdayone.png" width="170" alt="Mr. Day One" /></a> | **[Mr. Day One](https://mrday.one/)** — AI 原生编辑器,把仓库、终端和诊断信息接进同一条智能体回路:改代码、跑测试、读报错、再复审结果。<br><br>`https://mrday.one` |
32
31
  | <a href="https://harnesscatalog.com/"><img src="docs/images/sponsor-harnesscatalog.png" width="170" alt="Harness Catalog" /></a> | **[Harness Catalog](https://harnesscatalog.com/)** — DeepSeek Harness 插件目录:逐个评测、给出真实安装命令,并说明什么场景该用它。本项目已收录其中。<br><br>[dsh-imagegen-video 条目](https://harnesscatalog.com/plugins/dsh-imagegen-video/) |
33
- | <a href="http://82.157.4.13/"><img src="docs/images/sponsor-leon.png" width="170" alt="莱昂 LEON" /></a> | **[莱昂 LEON](http://82.157.4.13/)** — AI 电商操盘手 × GEO 顾问:把电商一线经验蒸馏成可审计的方法论与 AI 工作流,提供 GEO 品牌托管、电商方法论体系搭建与多智能体工作流定制。<br><br>`http://82.157.4.13/` |
32
+ | <a href="http://82.157.4.13/"><img src="docs/images/sponsor-leon.png" width="170" alt="莱昂 LEON" /></a> | **[莱昂 LEON](http://82.157.4.13/)** — AI 电商操盘手 × GEO 顾问:把电商一线经验蒸馏成可审计的方法论与 AI 工作流,提供 GEO 品牌托管、电商方法论体系搭建与多智能体工作流定制。<br><br>点击名称或徽章访问站点 |
34
33
 
35
34
  > **以上是赞助位,不是中立推荐。** 七项均由第三方独立维护:两家 API 网关的
36
35
  > 可用模型、价格、限流与稳定性,桌面客户端、移动应用与编辑器的兼容性、稳定性
@@ -59,10 +58,9 @@ dsh plugin --profile web add https://github.com/q253595422/dsh-imagegen-video/re
59
58
  dsh plugin --profile web add ./q253595422-dsh-imagegen-video-1.7.8.tgz
60
59
  ```
61
60
 
62
- > ⚠️ **不要与原版 `@dickpy/dsh-imagegen` 同时安装。** 两者注册的是同一套
63
- > `/api/dsh-imagegen/*` 路由和同一个 UI 面板(该路由前缀继承自上游,不是本
64
- > 衍生版引入的),同时启用会冲突。数据目录 `~/.dsh/dsh-imagegen/` 也与上游
65
- > **共用**,切换前请先备份。详见 [上游与授权](#upstream)。
61
+ > ⚠️ **不要与 `@dickpy/dsh-imagegen` 同时安装。** 两者注册的是同一套
62
+ > `/api/dsh-imagegen/*` 路由和同一个 UI 面板,同时启用会冲突。数据目录
63
+ > `~/.dsh/dsh-imagegen/` 也是两者共用的,切换前请先备份。详见 [授权与致谢](#license)。
66
64
 
67
65
  安装后重启 `dsh web`,侧边栏会出现「生图」入口。到「设置 → 生图配置」添加提供方、填写 API 地址与密钥、检测并选择生图模型,保存后即可开始创作。Windows 若遇 PowerShell 脚本策略限制,请使用 `dsh.cmd`。
68
66
 
@@ -72,7 +70,7 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-1.7.8.tgz
72
70
  - **让 Agent 安装:**把上面的安装命令发给 DSH、Codex 或其他 coding agent。
73
71
  - **指定版本:**把 URL 里的 `v1.7.8` 与文件名里的版本号换成目标版本,或从 [GitHub Releases](https://github.com/q253595422/dsh-imagegen-video/releases) 下载对应版本的 tgz 后安装。
74
72
  - **升级:**重复执行 `add` 命令指向新版本即可;插件也会在面板中提示新版本。更新后重启 `dsh web`。
75
- - **DSH Desktop 用户:**宿主 CLI 不允许写入 `desktop` 这个 profile,所以面板不会假装去更新,而是直接给出可复制的命令和下载地址,由你自己执行——这与上游 issue #41 里「更新失败但看不到原因」是两回事。
73
+ - **DSH Desktop 用户:**宿主 CLI 不允许写入 `desktop` 这个 profile,所以面板不会假装去更新,而是直接给出可复制的命令和下载地址,由你自己执行——不会只甩一句「更新失败」而没有原因。
76
74
  - 渠道配置、历史记录和画廊数据保存在 DSH 宿主侧,正常升级不会清空。
77
75
 
78
76
  </details>
@@ -136,7 +134,7 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-1.7.8.tgz
136
134
 
137
135
  <a id="txt2img"></a>
138
136
 
139
- 输入提示词即可生成,也可上传参考图进行编辑。图生图支持**多张参考图**(最多 5 张,单张 10 MiB、合计 16 MiB):可多选、拖拽或粘贴,逐张移除,缩略图里用方向键翻看。请求形状按协议族各自整形——第一张始终在 `image`,其余在 `images`,所以只接受单张的上游看到的仍是一张图;面板会在提交前就按模型能力拦下超额张数,而不是让上游默默截断。此外支持多张结果、比例与清晰度设置、任务队列、历史恢复和全屏预览。
137
+ 输入提示词即可生成,也可上传参考图进行编辑。图生图支持**多张参考图**(最多 5 张,单张 10 MiB、合计 16 MiB):可多选、拖拽或粘贴,逐张移除,缩略图里用方向键翻看。请求形状按协议族各自整形——第一张始终在 `image`,其余在 `images`,所以只接受单张的渠道看到的仍是一张图;面板会在提交前就按模型能力拦下超额张数,而不是让服务端默默截断。此外支持多张结果、比例与清晰度设置、任务队列、历史恢复和全屏预览。
140
138
 
141
139
  <div align="center">
142
140
  <img src="docs/images/image-generation-studio-four.png" alt="文生图与图生图工作台" width="100%" />
@@ -148,7 +146,7 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-1.7.8.tgz
148
146
 
149
147
  ### 生视频
150
148
 
151
- 在「生视频」标签页里写视频描述,选择视频模型、比例、分辨率与时长即可提交。视频在上游是**异步渲染**:宿主先提交任务、再按协议族轮询,渲染完成后把成片以文件落盘,并在面板内直接播放;渲染通常需要数分钟,期间可以关闭页面,任务仍在宿主继续执行。
149
+ 在「生视频」标签页里写视频描述,选择视频模型、比例、分辨率与时长即可提交。视频是**异步渲染**:宿主先提交任务、再按协议族轮询,渲染完成后把成片以文件落盘,并在面板内直接播放;渲染通常需要数分钟,期间可以关闭页面,任务仍在宿主继续执行。
152
150
 
153
151
  **视频模型按渠道单独配置**,与图片模型分开:渠道里的「视频模型」目录决定该渠道能用哪些视频模型,因为视频走的是提交+轮询协议,和图片的同步返回不是一回事。
154
152
 
@@ -206,14 +204,14 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-1.7.8.tgz
206
204
 
207
205
  - API 请求经 DSH 宿主转发;密钥保存在本机设置中,不直接暴露给浏览器。
208
206
  - 历史、画廊、画布和图片保存在 DSH 数据目录 `~/.dsh/dsh-imagegen/`,由你控制。
209
- - 生图与图生图会把提示词或参考图发送给所配置的上游服务;请按服务商政策处理敏感内容。
207
+ - 生图与图生图会把提示词或参考图发送给所配置的 API 服务商;请按服务商政策处理敏感内容。
210
208
  - 内置轻量技能会把所选内容发送给配置的聊天模型。图片转 PPT 的 PPTX 在本地生成,由原生文字与基础矢量形状组成,不会把整张原图直接铺成幻灯片背景;结果需人工检查。
211
209
  - 外部重任务技能可能读写本机文件并执行命令;运行前请确认技能可信、输入内容可共享。
212
- - 生图会消耗上游 API 额度;请人工检查生成结果。不要把 API 密钥贴到 Issue、日志或截图中。
213
- - **诊断日志**(两个工作台右上角):失败的上游请求会留在本机内存里
210
+ - 生图会消耗 API 服务商额度;请人工检查生成结果。不要把 API 密钥贴到 Issue、日志或截图中。
211
+ - **诊断日志**(两个工作台右上角):失败的 API 请求会留在本机内存里
214
212
  (最多 200 条,重启即清空,不写磁盘,不产生后台请求),
215
213
  可一键复制后贴进 Issue。记录含实际请求地址、HTTP 状态、网络错误码、耗时、
216
- 体积与上游原始响应;**密钥已在写入前脱敏**(`Bearer` 令牌、查询串密钥、
214
+ 体积与服务商原始响应;**密钥已在写入前脱敏**(`Bearer` 令牌、查询串密钥、
217
215
  内联 base64 均替换为占位符,API Key 只记「是否发送」)。
218
216
  生图与生视频写同一个缓冲:视频的提交 / 轮询 / 下载三条腿各自标记。
219
217
 
@@ -230,26 +228,21 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-1.7.8.tgz
230
228
  > [Issues](https://github.com/q253595422/dsh-imagegen-video/issues) 提问题,
231
229
  > 并提醒维护者换一张新码。安全敏感的问题不要发在群里,也不要贴 API 密钥。
232
230
 
233
- <a id="upstream"></a>
234
- ## 上游与授权
231
+ <a id="license"></a>
232
+ ## 授权与致谢
235
233
 
236
- 本仓库是 [dickpy/dsh-imagegen](https://github.com/dickpy/dsh-imagegen) 的衍生版,按
237
- [Apache-2.0](./LICENSE) 发布。上游的版权与来源见 [NOTICE](./NOTICE);本仓库相对
238
- 上游 v1.6.8 的全部改动逐条列在 [CHANGELOG.md](./CHANGELOG.md)。
234
+ 本项目按 [Apache-2.0](./LICENSE) 发布。各版本的改动逐条列在
235
+ [CHANGELOG.md](./CHANGELOG.md);第三方代码与素材的版权、许可与来源见
236
+ [NOTICE](./NOTICE) 与 [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md)。
239
237
 
240
- > **本仓库是独立项目,不跟随上游版本线。** 上游源码只在 fork 时一次性取用(基线
241
- > v1.6.8),此后本仓库按自己的节奏发版(当前 v1.7.8)。上游后续版本的功能会**按需**
242
- > 吸收进来——例如失败可查的诊断日志(上游 #38)——吸收后即为本仓库自己代码的一部分,
243
- > 版本号仍是本仓库的。因为两边历史没有共同祖先,吸收是**逐文件移植**,不是 `git merge`。
238
+ **核心能力**:生图(文生图 / 图生图 / 多参考图编辑)、生视频(文生视频 / 图生视频 /
239
+ 首尾帧 / 多参考图)、图片转可编辑 PPT(最多 12 张,每张一页)、无限画布(图片与视频节点、
240
+ 片段拼接、技能)、电商套图、模板库与画廊。
244
241
 
245
- **这个衍生版做了什么**:上游只有生图。本仓库在上游源码上补齐了生视频链路
246
- (异步提交/轮询、视频渠道目录、视频标签页、Agent 视频工具),并把视频接进
247
- 无限画布(视频节点、片段拼接、视频节点与图片节点同一套控制)。
242
+ **支持与问题反馈请提到本仓库的 Issues**([Bug 报告](https://github.com/q253595422/dsh-imagegen-video/issues/new?template=bug_report.yml) · [功能建议](https://github.com/q253595422/dsh-imagegen-video/issues/new?template=feature_request.yml) · [全部 Issues](https://github.com/q253595422/dsh-imagegen-video/issues))。
248
243
 
249
- **支持与问题反馈请提到本仓库的 Issues**([Bug 报告](https://github.com/q253595422/dsh-imagegen-video/issues/new?template=bug_report.yml) · [功能建议](https://github.com/q253595422/dsh-imagegen-video/issues/new?template=feature_request.yml) · [全部 Issues](https://github.com/q253595422/dsh-imagegen-video/issues)),不要提到上游仓库 —— 上游并不维护这里的代码。上游的 QQ 交流群与本仓库无关,这里不代为宣传。
250
-
251
- **与上游不能共存**:两者注册同一套 `/api/dsh-imagegen/*` 路由与同一个 UI
252
- 面板,同时安装会冲突;数据目录 `~/.dsh/dsh-imagegen/` 也是共用的。要换回
244
+ **与 `@dickpy/dsh-imagegen` 不能共存**:两者注册同一套 `/api/dsh-imagegen/*` 路由与
245
+ 同一个 UI 面板,同时安装会冲突;数据目录 `~/.dsh/dsh-imagegen/` 也是共用的。要换回
253
246
  原版,请先卸载本插件。
254
247
 
255
248
  <details>
@@ -268,6 +261,19 @@ pnpm run test:negative
268
261
  把每处修复对应的缺陷重新注回**仓库副本**,要求对应检查变红,
269
262
  工作树不被改动。
270
263
 
264
+ 跟进本项目的上游发布:
265
+
266
+ ```bash
267
+ pnpm run upstream:check # 有新版本时退出码为 1
268
+ pnpm run upstream:plan # 生成移植报告到 .upstream/<版本>/report.md
269
+ pnpm run upstream:adopt v1.8.3 # 记录「已整合到哪个版本」
270
+ ```
271
+
272
+ `upstream:plan` 会把每个改动文件按**能否干净应用到当前树**分类:新增(整份复制)、
273
+ 可直接应用、冲突(需人工读)、本项目自有(视频链、发布说明、授权,不覆盖)。
274
+ 它只生成报告,不改任何源码。GitHub Actions 每六小时跑一次检测,有新版本时
275
+ 自动开一条带报告的 issue。
276
+
271
277
  本地打包并安装到 DSH 验收:
272
278
 
273
279
  ```bash
@@ -275,7 +281,7 @@ pnpm pack --pack-destination .
275
281
  dsh plugin --profile web add ./q253595422-dsh-imagegen-video-<版本>.tgz
276
282
  ```
277
283
 
278
- 仓库里的离线套件不需要网络与付费上游调用;需要浏览器或 `ffmpeg` 的检查在缺
284
+ 仓库里的离线套件不需要网络与付费 API 调用;需要浏览器或 `ffmpeg` 的检查在缺
279
285
  少工具时会**明确跳过并返回成功**,而不是伪装成失败。并行跑构建与测试请用
280
286
  `./scripts/with-lock.sh`,它会把整棵工作树串行化。
281
287
 
@@ -285,4 +291,4 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-<版本>.tgz
285
291
 
286
292
  [Apache-2.0](./LICENSE)
287
293
 
288
- 上游与本仓库的署名见 [NOTICE](./NOTICE)。内置模板所引用的第三方项目与许可见 [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md)。
294
+ 版权归属与第三方许可见 [NOTICE](./NOTICE) 与 [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md)。
@@ -1,6 +1,6 @@
1
1
  # v1.7.1 · 补上 1.7.0 漏发的两条修复,并补齐发布卫生
2
2
 
3
- > 本仓库自己的发布说明。相对上游 v1.6.8 的完整改动见 [CHANGELOG.md](../../CHANGELOG.md)。
3
+ > 各版本改动见 [CHANGELOG.md](../../CHANGELOG.md)。
4
4
 
5
5
  1.7.0 的 Release 资产上传时,有两条修复还没落地;而版本号没有跟着升,导致应用内
6
6
  更新按钮**永远不会亮**(`updateAvailable` 用严格大于比较),用户也就永远收不到它们。
@@ -1,6 +1,6 @@
1
1
  # v1.7.2 · 视频节点此前根本无法保存
2
2
 
3
- > 本仓库自己的发布说明。相对上游 v1.6.8 的完整改动见 [CHANGELOG.md](../../CHANGELOG.md)。
3
+ > 各版本改动见 [CHANGELOG.md](../../CHANGELOG.md)。
4
4
 
5
5
  **带视频节点的画布存不下来。** 宿主的画布节点守卫只接受
6
6
  `image` / `text` / `file` / `config`,而 `CanvasNodeType` 里还声明了 `video`,
@@ -1,6 +1,6 @@
1
1
  # v1.7.3 · 数据根支持 `~`,拖拽柄跟随界面语言
2
2
 
3
- > 本仓库自己的发布说明。相对上游 v1.6.8 的完整改动见 [CHANGELOG.md](../../CHANGELOG.md)。
3
+ > 各版本改动见 [CHANGELOG.md](../../CHANGELOG.md)。
4
4
 
5
5
  两个都不大、但都属于「用户照直写就会踩」的问题。
6
6
 
@@ -1,6 +1,6 @@
1
1
  # v1.7.4 · 三条「用户看得见、但只在特定时序下才发生」的修复
2
2
 
3
- > 本仓库自己的发布说明。相对上游 v1.6.8 的完整改动见 [CHANGELOG.md](../../CHANGELOG.md)。
3
+ > 各版本改动见 [CHANGELOG.md](../../CHANGELOG.md)。
4
4
 
5
5
  三条都是失败率问题:不容易撞上,撞上一次就没有绕过的办法。
6
6