@lincyaw/skills 1.0.0-rc.81 → 1.0.0-rc.83

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lincyaw/skills",
3
- "version": "1.0.0-rc.81",
3
+ "version": "1.0.0-rc.83",
4
4
  "description": "Presmium's bundled authoring, animation, presentation and plugin-development skills for coding agents",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
@@ -36,7 +36,7 @@
36
36
  ],
37
37
  "dependencies": {
38
38
  "jiti": "^2.7.0",
39
- "@lincyaw/kernel": "1.0.0-rc.81"
39
+ "@lincyaw/kernel": "1.0.0-rc.83"
40
40
  },
41
41
  "presmium": {
42
42
  "skills": [
package/skills/index.json CHANGED
@@ -12,8 +12,8 @@
12
12
  "references/publishing.md",
13
13
  "references/writing.md"
14
14
  ],
15
- "version": "1.0.0-rc.81",
16
- "hash": "397f196b7cfb7c6cee70f213d803fe94a95bf78f97d194b003bb6ead4bce7ebe"
15
+ "version": "1.0.0-rc.83",
16
+ "hash": "6f39b876ee7b202d7b547c74ab23484e380032add3e58e46df03da4bca3ec59d"
17
17
  },
18
18
  {
19
19
  "name": "presmium-animate",
@@ -545,7 +545,7 @@
545
545
  "references/team.md",
546
546
  "references/timeline.md"
547
547
  ],
548
- "version": "1.0.0-rc.81",
548
+ "version": "1.0.0-rc.83",
549
549
  "hash": "129ae2099f0a5313ae0c3f09e7408fb81701e70a05f413e465aa911ec1548cad"
550
550
  },
551
551
  {
@@ -556,7 +556,7 @@
556
556
  "references/plugin.md",
557
557
  "references/testing.md"
558
558
  ],
559
- "version": "1.0.0-rc.81",
559
+ "version": "1.0.0-rc.83",
560
560
  "hash": "96422f5cef6a97bba23c9c67b7fb0ee491b18f01f789e262ca24b274e7fabaa1"
561
561
  }
562
562
  ]
@@ -58,6 +58,16 @@ Documents created in Studio declare the standard production plugins and lecture
58
58
 
59
59
  Put lecture renderer options in `metadata.renderers.lecture`. Put timing and voice choice only in `production`: document defaults, optional section overrides and step overrides. A voice source is `none`, TTS with an actual engine/voice, or a recording asset. Do not keep a second `voice` or timing decision on renderer options, a step or narration text.
60
60
 
61
+ Save video export defaults in `metadata.renderers.lecture.video`, then use MCP `build` with target `video`:
62
+
63
+ ```json
64
+ { "video": { "burn": "zh-CN", "contactSheet": true, "size": [1280, 720], "fps": 30 } }
65
+ ```
66
+
67
+ The object accepts only `burn` (a nonempty caption language), `contactSheet` (boolean), `size` (positive integer width and height), and `fps` (greater than 0 and at most 60). Omitted fields keep the defaults: no burned captions, no contact sheet, 1920 × 1080 and 30 fps. Explicit `presmium-lecture export` arguments override these saved defaults; both entry points use the same export pipeline. Encoder locations belong to the operator's environment (`PRESMIUM_FFMPEG`), never the document. A successful contact sheet appears beside the video in the job's returned files; without FFmpeg, the video remains available but the sheet is not produced. Burning captions does not generate voiceover: for an explicitly silent preview use `production.defaults.voiceSource: { "type": "none" }` and authored hold timing.
68
+
69
+ Explicitly silent scripts are split into readable caption groups using their confirmed utterance duration, with `proportional` display timing. This creates no audio word alignment or manual timing evidence. A transcoder can reuse public `captionGroups`, `captionChunks` and `captionWidth` from `@lincyaw/addon-lecture/domain`; choose a smaller chunk budget or explicit line breaks when the target subtitle renderer cannot wrap CJK text.
70
+
61
71
  In Studio, use Settings → Voice Service (also linked from Video Production → Voiceover). The page defaults to Volcengine speech synthesis 2.0 and accepts a speech-console API Key, or an access token with its matching optional App ID. No Secret Key or console-version choice is needed. Empty inputs keep saved credentials; a new key without an App ID switches to API-key authentication. Save applies immediately; it does not select a voice or generate audio. Credentials stay in the local operator directory outside the workspace and are never returned by reads. Check Configuration only checks the saved local configuration; real provider permissions are checked by explicit playback, a confirmed sample, or batch generation after the service is enabled. Clearing the saved key restores any launch-environment fallback.
62
72
 
63
73
  Without the studio, `presmium speech key set [<dir>]` saves the Volcengine speech API key in the same file: it reads the key from standard input (typed without echo, or piped: `presmium speech key set . < key.txt`), never from an argument. `presmium speech key status [<dir>]` says whether a key is configured and whether it is saved on this machine or comes from `PRESMIUM_SPEECH_VOLCENGINE_KEY`, never showing it; `presmium speech key clear [<dir>]` removes the saved one. `<dir>` is the workspace or a document in it (default `.`); `PRESMIUM_OPERATOR_DIR` names another operator directory, as for `presmium serve`.
@@ -125,6 +135,6 @@ Set the longest the video may be in the lecture renderer options: `metadata.rend
125
135
 
126
136
  A step whose visible blocks are all limited to other forms (`only` without `lecture`, such as a sources page whose text has `only: ["web"]`) and that has no narration, recording or audio clip, and no `{cue}next` of an earlier narration moves into, is not in the lecture: the video, the plan, the captions and the chapters leave it out, and a page whose steps are all like that is left out whole. It needs no production override to hide it.
127
137
 
128
- MCP `get_voiceover_status` returns eight rows by default (up to twenty) within a 7168-character JSON budget. Follow `nextCursor` as `cursor` for further step targets, unbound pages and job summaries; source or preview changes require a fresh first page. Use `get_voiceover_job` for complete task details. Continuation carries its own version binding; no extra verification arguments are needed.
138
+ MCP `get_voiceover_status` automatically prepares the current saved document when its compiled result is missing or stale; do not open a preview or read an IR resource as a separate warm-up. It never generates audio. Source changes during preparation and stale generation revisions remain conflicts. Capabilities and voice catalogues do not compile scenes; job discovery and cancellation remain available without compilation. The status returns eight rows by default (up to twenty) within a 7168-character JSON budget. Follow `nextCursor` as `cursor` for further step targets, unbound pages and job summaries; source or preview changes require a fresh first page. Use `get_voiceover_job` for complete task details. Continuation carries its own version binding; no extra verification arguments are needed.
129
139
 
130
140
  MCP `get_voice_catalog` and `get_voiceover_jobs` also use bounded pages (default eight, maximum twenty). Follow `nextCursor` with the same original filters. Job admission, polling and cancellation summarize large step selections and mark shortened detail. To read exact task fields, use `get_voiceover_job` with `path`, for example `["job","scope","targets"]`; `path: []` selects everything. Small selections return `encoding: "value"`; large ones return JSON-text fragments. Follow the cursor with the same job query, assemble the decoded text, then parse it. The cursor carries the field, offset and consistency check; no extra verification arguments.