yichen-x-slicer

Yichen X Slicer（逸尘 X 切片）

Turn one public X status URL into a complete 3:4 image sequence. Use sunset（落日琥珀版）unless the user explicitly chooses another template.

Run

1. Resolve the directory containing this SKILL.md as SKILL_DIR.
2. Choose a new output directory under the current task's user-facing outputs/ directory. Never overwrite or delete an earlier run.
3. Run. This default command generates the image sequence, image ZIP, and MP4:

"<node-bin>" "$SKILL_DIR/scripts/yichen_x_slicer.mjs" \
  --url "<x-status-url>" \
  --output "<absolute-output-directory>"

Use the bundled Codex Node.js executable when available. The script locates bundled Playwright automatically; if discovery fails, set YICHEN_X_SLICER_PLAYWRIGHT_MODULE to <workspace-node-packages>/playwright/index.mjs after loading workspace dependencies.

The default template is sunset. To override it:

"<node-bin>" "$SKILL_DIR/scripts/yichen_x_slicer.mjs" \
  --url "<x-status-url>" \
  --template editorial \
  --output "<absolute-output-directory>"

Use --template all only when the user asks to compare every style. Use --list-templates to print the registry. Read templates.md only when choosing or explaining a non-default template.

Generate images without a video only when the user explicitly asks for images only:

"<node-bin>" "$SKILL_DIR/scripts/yichen_x_slicer.mjs" \
  --url "<x-status-url>" \
  --images-only \
  --output "<absolute-output-directory>"

The normal workflow appends one verified MP4 per selected template after PNG and ZIP verification. With --template all, generate 11 separate videos; never mix templates into one timeline. --images-only is an explicit opt-out. Read video.md for the fixed timing, source-audio, and verification contract.

When another workflow needs a faithful local Markdown source rather than visual slices, use the isolated source bridge:

"<node-bin>" "$SKILL_DIR/scripts/yichen_x_slicer.mjs" \
  --url "<x-status-url>" \
  --source-only \
  --output "<absolute-output-directory>"

--source-only reuses the same verified routing and downloader but does not render. Read source-only.md before invoking or consuming this mode; it defines the five-output contract, Thread markers, media ordering, and mandatory native-MP4 binding.

Content contract

• Keep the author header's right-side label visually blank on every frame.
• For a normal Post, include only that Post's own text and media.
• For a Quote Post, include only the focal Post's own text and media; ignore the Quote completely.
• For a Thread, include the verified same-author direct-reply chain and each selected node's own media.
• For a Thread containing Quotes, ignore every Quote. Skip a node that becomes empty after its Quote-only URL is removed and has no own media.
• Exclude other-author replies, side branches, comments, Quote media, and Quote metrics.
• When a selected Post or Thread node has a native video, keep its poster in the PNG/ZIP deliverables but play the complete native video visual inside the same media stage in the final MP4. Never silently substitute the poster for the moving video.
• When that selected native video has a valid source audio stream, retain its own audio over the matching source-video interval on that page and keep it aligned with the source picture. If it has no source audio stream, keep that interval silent. Never include audio from Quote media.

Read content-routing.md when diagnosing routing, branches, missing Thread nodes, or quote_only exclusions.

Visual contract

• Fix every final image at 1080×1440（3:4）.
• Keep the complete source slice centered; split long text across consecutive frames instead of shrinking it below the readable limit or cropping it.
• Fit each source image with contain; verify the rendered image bounds remain fully inside the media stage.
• Add no visible English outside original text, account handles, and original URLs.
• Outside the source card, keep only one short source-derived hook and up to three verified snapshot metrics: reads, likes, and bookmarks. Omit a metric when the source does not provide it; never turn missing data into zero.
• Use the small source avatar only in the author header; do not reuse it decoratively.

Verify and deliver

For --source-only, use the separate verification and delivery checklist in source-only.md, not the visual-render checklist below.

For the normal rendering mode, require all of the following before reporting completion:

1. qa-report.json has zero failures.
2. manifest.json records the requested template and sunset when no template was passed.
3. All PNGs are 1080×1440 and the normalized selected text is completely covered in order.
4. source-label is empty and visually zero-sized on every frame.
5. No Quote text, Quote media, or excluded Thread node appears in the outputs.
6. The ZIP contains only numbered final PNGs, and its entries match current PNG hashes.
7. Inspect contact-sheet.png visually, then inspect the densest text frame and every media frame at full size.

Unless --images-only was explicitly requested, also require:

8. Every MP4 has one 1080×1440 H.264 video stream at 30fps. It has one audio stream if and only if at least one selected non-Quote native video has a valid source audio stream; otherwise it has zero audio streams.
9. The frame count and duration exactly match the fixed-reading-v1 plan in video.md, including the complete probed visual duration of every native video page.
10. Text and photo reading holds are completely static; added motion appears only inside each four-frame page transition. Native video pages may contain only their source motion, with no added shake, pan, zoom, crop, or loop.
11. The complete MP4 decodes without errors, and manifest/QA hashes match the delivered file.
12. For every native video page, QA proves that the downloaded MP4 fully decodes, records whether its source has audio, and confirms that transition-free near-start, middle, and near-end source frames match their corresponding embedded frames in the final timeline. For a source-audio page, QA proves the complete transition-free source interval plus every four-frame transition against an independently rebuilt source-audio timeline, and verifies the full sample-accurate complement outside permitted source-audio ranges. For a source-silent page, QA proves that the matching interval is silent. No final audio may appear outside source-audio video-page intervals, and the manifest must bind the artifact to current script/test hashes and FFmpeg/ffprobe versions.

Return links to index.html, contact-sheet.png, the final ZIP, and every verified MP4. State the selected template, frame count, routed input type, and any quote_only exclusions. Omit the MP4 only for an explicit --images-only request.

Boundaries

• Read only public X data anonymously through FxTwitter; do not use X login state or cookies.
• Accept runtime media only from HTTPS pbs.twimg.com or video.twimg.com, including every redirect hop. Native MP4 downloads must remain on exact host video.twimg.com. Reject local paths, file:/data: URLs, oversized responses, wrong MIME types, non-image signatures, and non-MP4 video signatures.
• Fail closed when a Thread node has an invalid numeric status ID, the focal author identity is missing, or a Quote t.co URL cannot be resolved from top-level URL entities.
• In --source-only, fail with x_article_route_required when any top-level node in the verified same-author chain signals an X Article, including a pure Article card excluded from ordinary text/media selection; this bridge must not turn an Article teaser into the source body.
• Do not operate WeChat, Jianying, or any publishing UI.
• Do not generate or add TTS, voice-over, BGM, or music. The only permitted audio is the original audio carried by a selected non-Quote native video, placed on that video's matching page timeline; do not synthesize an empty audio stream when none of the selected videos has audio.
• Generate the fixed-timing video by default. Suppress it only through an explicit --images-only request; do not add other video pacing modes or free-form FFmpeg filters.
• Do not delete prior outputs. If a target exists, let the script create a -run-N sibling.