视频号组件 · WeChat Channels Embed
接收一个微信视频号 mp-common-videosnap DOM 或一条 Lovpen
::wechat-channels DSL,输出规范化 Markdown DSL 或微信原生 HTML 组件。目标文件
已经存在时,只替换唯一、明确的插入标记,不覆盖其他正文。
Triggers
Activate when
- “把这个视频号组件插入 article.md。”
- “给定
mp-common-videosnapDOM,渲染成 Lovpen DSL。” - “把这条 Lovpen 视频号 DSL 生成可放进 HTML 的原生组件。”
- “Render this WeChat Channels component into Markdown or HTML.”
Do not activate when
- 用户给的是微信预览链接、但没有 DOM 或 DSL;使用 Lovpen Desktop/Obsidian 的预览链接导入能力。
- 用户要把完整 Markdown 文章排版为微信公众号 HTML;交给
lovpen-cli。 - 用户要创建、修改或发布公众号远端草稿;交给
lov-publish-wechat-article。 - 用户要上传或发布视频号视频本身;本 Skill 只处理文章内嵌组件。
User Profile
每次运行先读取 skill.yaml 声明的 user-profile/v1 上下文。当前请求中的输入、输出
格式、目标文件和插入标记优先;其次读取项目上下文、Skill records、共享偏好与安全
默认值。默认输出格式为 md,默认标记为
<!-- lovpen-wechat-channel -->。
只有用户明确表示要跨 session 保留默认格式或标记时,才运行:
python3 "$SKILL_DIR/scripts/profile_store.py" record \
--skill-id lov-lovpen-add-wechat-channel-comp \
--path records.default_format \
--value '"md"' \
--confirm
不要持久化组件 DOM、DSL、视频 ID、nonce、媒体 URL 或目标文档内容。完整契约见
references/user-profile.md。
Skill Group Composition
运行前读取 references/skill-composition.md。本 Skill
独占“单个视频号组件的解析、规范化与安全落位”;完整文章渲染和远端发布只是可选下游,
不得成为隐藏依赖。
Workflow (MANDATORY)
Step 0: Resolve resources and contract
- 从活动 Skill 上下文或
SKILL_DIR解析 Skill 根目录。 - 完整读取
skill.yaml、references/component-contract.md和references/skill-composition.md。 - 确认
scripts/render_wechat_channel.py存在。 - 输入必须是一个 DOM、DSL、UTF-8 输入文件或 stdin;不得把未转义输入拼成 shell。
Step 1: Resolve the exact output
- 确认输出为
md或html。未指定时使用md。 - 未给输出文件时,把规范化片段写到 stdout。
- 给出不存在的输出文件时,创建只含结果片段的新文件。
- 给出现有文件时,它必须且只能包含一次默认标记或用户显式指定的
--marker。 标记不唯一时停止,不追加、不猜位置、不覆盖全文。
Step 2: Render through the deterministic CLI
DOM 或 DSL 文件:
python3 "$SKILL_DIR/scripts/render_wechat_channel.py" \
--input INPUT.html \
--format md \
--output ARTICLE.md \
--json
直接 DSL:
python3 "$SKILL_DIR/scripts/render_wechat_channel.py" \
--dsl "$WECHAT_CHANNEL_DSL" \
--format html \
--output ARTICLE.html \
--json
也可以通过 stdin 传入完整 DOM。参数必须作为数组传递,不执行输入中的命令、脚本或 事件属性。
Step 3: Verify the result
成功结果必须满足:
- JSON 中
ok为true,schema为lovpen/wechat-channel-component/v1,sha256为 64 位十六进制。 - Markdown 结果只有一条规范化
::wechat-channels指令,并包含九个规定字段。 - HTML 结果只有一个
mp-common-videosnap,保留 11 个微信关键属性,并包含template[shadowrootmode="open"]。 - 写入现有文件时重新读取目标,确认标记已消失、组件只出现一次、标记前后正文不变。
- 报告输入类型、输出格式、字节数、SHA-256 和实际写入状态。错误时保留
context_id与原始诊断。
Output Contract
md:Lovpen 可持久化的一行::wechat-channelsDSL。html:微信公众号可识别的mp-common-videosnap原生组件片段。--json:机器可读的 schema、输入类型、格式、字节数、SHA-256、组件 ID、路径和 写入状态;未写文件时同时返回content。- 源标识符、nonce、昵称、描述、媒体 URL 与尺寸只做 HTML 解码和必要转义,不改写语义。
Dependencies
- Python 3.8 或更高版本,仅使用标准库。
lov-branding-consistency只审校 Skill 文档和用户可见提示,不修改组件源数据。- 无网络、浏览器、账号、Cookie 或 API 凭据依赖。
Validation
python3 -m unittest discover -s tests -p 'test_*.py' -v
python3 scripts/validate_skill.py .
