Como usar
- Copie o comando e verifique o pacote antes de instalar no seu ambiente de agente.
- Consulte no original as ferramentas, credenciais e ambientes necessários.
- Descreva os dados de entrada e a entrega esperada; confira a saída com as fontes.
npx skills add https://github.com/zjp1997720/zhijian-skills --skill wechat-stylerAntes de começar
- A instalação não inclui assinatura de modelo, franquia API ou acesso aos seus arquivos.
- Estrelas e instalações indicam atividade, não um teste independente de qualidade ou segurança.
Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.
WeChat Styler
把已定稿或已授权排版的 Markdown 转成可评审公众号 HTML。默认保留正文并自动加入智见品牌首尾引导(默认 Flow 纸色底 GIF,SVG 为 --cta-style svg 备用);组件改写、主题开场动画和微信编辑器注入按需加载。

分支路由
先选分支,再读取对应 reference。默认转换无需读取组件、动画或编辑器细则。
| 用户需求 | 执行分支 | 读取 |
|---|---|---|
| 公众号排版、HTML、换主题、批量转换 | 默认转换 | references/conversion-workflow.md;主题需要判断时再读 references/theme-guide.md |
| 结构化组件、丰富排版、开场动画 | 组件与动画 | 默认转换 reference + references/component-guide.md + references/svg-animation-design.md |
| 注入公众号、保存草稿、核验编辑器中的成品 | 编辑器注入 | references/opencli-injection.md + references/wechat-compatibility.md |
| 修改 Zhijian 主题视觉基线 | 主题维护 | references/zhijian-theme-baseline.md + references/theme-guide.md |
任务中出现新需求时只补读新增分支。
授权与能力边界
- 用户已授权排版且正文、主题明确时,简报选择并直接生成 HTML 预览,不重复确认。只有缺口会改变原意、关键表达方向或交付格式且无法推断时才问;先完成不受影响的部分。
- 预览生成、编辑器写入和草稿保存是不同动作。沿用会话中已有授权;没有编辑器写入或保存授权时,只交付 HTML 与核验结果。
- 某后端因能力缺失而不可用时,可以选择已授权且满足注入验收条件的后端。遇到明确的权限拒绝或安全策略拒绝时必须停止并报告,不能换工具、CDP、浏览器自动化或间接脚本绕过。
- 不修改输入 Markdown;组件分支在内存或临时文件中改写。
工作流
1. 默认转换
默认保留正文、不增加正文组件;转换器自动加入品牌开头与结尾引导(默认 Flow 生成的纸色底 GIF,--cta-style svg 切回透明内联 SVG)。开场互斥、关闭方式与素材维护见 references/brand-cta.md;每次转换读取该规则。按 references/conversion-workflow.md 选择主题与参数、运行转换并完成最小 QA。用户只给文件路径时默认使用 zhijian。
2. 组件与动画
组件分支先通过严格段落密度门,再按 component-density 在内存中改写 Markdown。默认 standard,只有用户明确要求“克制”或“丰富、激进、多用组件”时改为 restrained 或 rich。
执行时遵守:
- 金句、NOTE、WARNING 和其他组件替换对应原文,不在正文后重复同一意思。
:::compare、:::flow、:::timeline独占一行且前后留空行;矩阵对比保留 table。- 卡片只放短文本;组件数量、横向布局和完整语法按
references/component-guide.md。 - 从正文推断开场标题、副标题和不超过 3 个标签;模板选择与 SVG 技术边界按
references/svg-animation-design.md。 - 话题标签:frontmatter 没有
topics时,从正文选 3–4 个写入转换用的 frontmatter(或传--topics):栏目/合集标签固定在首位,再加 2–3 个对准目标读者或本篇主题的话题;不用「人工智能」「AI」这类泛词,品牌或产品名只在正文确实展示该产品时使用,不超过公众号上限 10 个。用户指定标签或明确不要时照办(--topics none)。 xiaolan-terminal只在用户明确要求小蓝、智见小蓝或品牌 IP 时使用。- 生成前完成组件 reference 中的检查清单,然后运行转换与移动端视觉 QA。
3. 质量验收
正式候选必须满足:
- 严格段落密度门通过;不靠缩小字号、放大行高或增加组件掩盖阅读墙。
- 390px 视口无横向溢出、坏图和图片 URL 异常重复;图片去重检查为严格模式。
- 引用、标题层级、暖陶色基线和卡片在移动端显示正常。
- 组件没有重复正文,围栏没有泄漏,正文语义未被改写。
- 代码围栏中的换行编译为显式
<br>;不能只依赖\n与white-space:pre-wrap。 - 兼容硬规则按
references/wechat-compatibility.md通过后,才进入编辑器注入。
4. 编辑器注入
仅在授权范围内按 references/opencli-injection.md 执行。发布命令始终带 --report;保存草稿后必须以页面可见信号或报告中的新 appmsgid / 历史变化核对真实保存,不把命令成功当作保存证据。
报告至少保留:阶段、脱敏错误、图片状态、封面策略、代码块硬换行计数、正文首尾、草稿保存证据和可直接执行的恢复动作。失败后优先用只读验证定位,不盲目重复写入。
输出合同
- 默认输入
article.md,输出同目录article_wechat.html;也可显式指定输出路径。 - 输出为完整内联样式 HTML,可复制或在获授权后注入公众号编辑器。
- 占位图、参数、主题、输出路径和命令见
references/conversion-workflow.md。 - 品牌引导位于文章首尾,正文中间使用静态组件。明确启用 SVG 开场动画时只保留结尾引导。
- 开场动画承担文章标题:启用
--cover时自动移除正文开头的一级标题(首个非空行的# 标题),动画标题依次取--cover-title、frontmatter.title、该一级标题;正文中段的一级标题不受影响,确需保留时传--keep-h1。 - 话题标签渲染在正文末尾(结尾引导之前),结构复刻公众号编辑器原生
a.wx_topic_link,斜体 14px;注入后编辑器识别为话题,保存即生效。
References
| 文件 | 何时读取 |
|---|---|
references/conversion-workflow.md | 默认转换、参数、主题、占位符与 390px QA |
references/theme-guide.md | 主题选择、YAML 参数或扩展主题 |
references/component-guide.md | 组件语法、密度预算、改写与检查清单 |
references/svg-animation-design.md | 动画模板选择、SVG 技术约束与回归要求 |
references/wechat-compatibility.md | 公众号兼容硬规则 |
references/opencli-injection.md | 已授权的编辑器注入、封面、图片、保存证据与恢复 |
references/zhijian-theme-baseline.md | Zhijian 主题样式锁与移动端视觉基线 |
版本: 1.18.2 · 作者: 大鹏

