Skip to content
Back to search

xiaowan-wechat-layout-lite

按小晚的审美和编辑判断,为任意来源的长文制作舒适的手机阅读排版,支持有首屏/无首屏、已有配图整理、找图与生图、横方封面母图、简介与发布检查。适用于本地稿、Markdown、文档、网页或X长文的公众号排版、断行和密度优化、粘贴修复;内容来源不决定版式。默认保留原文,身份配色可配置,gzh-design只提供底层HTML能力。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/cyberxiaowan--xiaowan-wechat-layout-skill/badge.svg)](/listings/cyberxiaowan--xiaowan-wechat-layout-skill)

HTML

<a href="/listings/cyberxiaowan--xiaowan-wechat-layout-skill"><img src="/api/listings/cyberxiaowan--xiaowan-wechat-layout-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

方式一:一条提示词安装或更新两个 Skill

把下面整段复制给 Codex:

请帮我安装并验证以下两个 Codex Skill:

1. gzh-design
   https://github.com/isjiamu/gzh-design-skill

2. xiaowan-wechat-layout-lite
   https://github.com/cyberxiaowan/xiaowan-wechat-layout-skill

要求:
- 先检查本机已安装的 Skills;
- 缺少哪个就从对应 GitHub 仓库安装;
- 如果 xiaowan-wechat-layout-lite 已存在,先备份旧目录,再用仓库最新版更新;
- gzh-design 已存在时不要覆盖用户自定义主题;只确认它结构完整、可以被调用;
- 安装到 Codex 的 Skills 目录;
- 检查两个目录都包含有效的 SKILL.md;
- 告诉我安装或更新结果,以及新开 Codex 任务后如何调用。

方式二:Mac 一键安装

下载并解压仓库后,双击 `install.command`。它会更新公开 Skill;若本机缺少 `gzh-design`,会自动安装底层依赖。

安装完成后,新开一个 Codex 任务即可使用。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 144 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: xiaowan-wechat-layout-lite
  3. description: 按小晚的审美和编辑判断,为任意来源的长文制作舒适的手机阅读排版,支持有首屏/无首屏、已有配图整理、找图与生图、横方封面母图、简介与发布检查。适用于本地稿、Markdown、文档、网页或X长文的公众号排版、断行和密度优化、粘贴修复;内容来源不决定版式。默认保留原文,身份配色可配置,gzh-design只提供底层HTML能力。
  4. ---
  5. # @小晚不在 · 公众号排版
  6. 以舒适的长文阅读体验为目标:理解文章的推进、轻重与停顿,把小晚的审美和编辑判断转成可执行的排版。素材可以来自本地稿、文档或网页,X 仅是一种获取渠道。`gzh-design` 提供底层 HTML 能力,不接管主题选择。提供完整同款与无首屏两个版本,两者共用小晚的排版系统。风格选择与内容编辑权限独立:选择同款不等于授权写稿或改变文章结构。
  7. ## 固定组件与语义判断分开验收
  8. 开工读取 xiaowan-preset.md 的完整组件清单,结束逐项目视回查:无底色、图片细框、章节英文小标不能在换文章时丢失。reading-contract.md决定如何分段与强调;不是靠满足行数就算排版完成。
  9. ## 已确认版式优先
  10. 先读 [references/reading-contract.md](references/reading-contract.md)。它覆盖下文及旧参考中与实际发布版冲突的首屏、强调和段落规则。
  11. ## 使用前提与优先级
  12. 1. 生成 HTML 前读取已安装 `gzh-design/SKILL.md` 及适用组件;若未安装,按宿主安装流程使用原项目:
  13. `https://github.com/isjiamu/gzh-design-skill`
  14. 2. 优先级固定为:用户本次要求 > 用户已经确认的本篇同款排版记录与历史发布稿 > 本 Skill 的通用判断标准 > `gzh-design` 主题默认值。
  15. 3. 本 Skill 不内置作者头像、IP、署名或私人素材。优先使用用户自己的内容资产。
  16. 4. 若用户说“正文已定稿”“不要改字”,内容逻辑诊断只提示风险,不改正文。
  17. 5. 若用户只反馈局部问题,只调整对应层,不重做已确认部分。
  18. ## 只选择是否保留首屏
  19. 两个版本共用阅读层级与排版规则;个人信息、IP、栏目名称及整体配色可配置。先读 [personalization.md](references/personalization.md),复用已有配置,再补齐必要信息:
  20. 1. **完整同款版**:保留首屏外框、刊头/日期、左标题右 IP、黑色编者按栏及提炼后的短摘要。
  21. 2. **无首屏版**:不生成上述首屏模块,直接进入文章正文;两版正文都完整保留原文第一段;无首屏版不插入首屏新增摘要。平台标题留给平台标题字段,不在正文重复制作题图卡。
  22. 用户已指定或本篇已有选择时直接沿用;首次缺少配置时一次性确认首屏及个人信息偏好;配色默认沿用预设,也可调整,不要求用户填写字号段距。
  23. 两版都读取 [references/xiaowan-preset.md](references/xiaowan-preset.md) 与 [references/layout-standard.md](references/layout-standard.md)。正文、章节、重点、配图、结尾和全部间距一致;有无首屏是唯一模式差异。用户单独提出的局部调整优先,但主题与身份配置独立于首屏模式。
  24. ## 再选择工作模式
  25. ### 模式 A:逻辑诊断+同款排版
  26. 仅适用于用户明确希望诊断、改稿或“一起优化后排版”;给出参考图本身不等于要求改稿。
  27. 1. 读取 [content-logic.md](references/content-logic.md),先输出内容逻辑卡;
  28. 2. 确定是否保留首屏,读取同款预设与固定排版参数;应用使用者个人配置;
  29. 3. 涉及正文调整时先确认调整;纯排版在已有授权和已选风格内直接推进。
  30. 不要把诊断直接变成全文重写。先说明问题、影响和调整建议;只有用户授权后才改正文。
  31. ### 模式 B:正文已定稿,只排版
  32. 这是普通长文排版的默认模式,用户明确要求不改文字时尤其严格。跳过结构改稿,从内容标记、视觉脚本、配图和 HTML 开始;仍检查章节职责、图片证据和手机断行,但不得为版面擅自删句。
  33. ### 模式 C:已有 HTML,只做审美与发布检查
  34. 先判断问题属于内容结构、信息层级、阅读节奏、装饰、强调、图片证据还是平台兼容,再局部修改。以公众号后台和手机预览为最终权威。
  35. 完整状态与放行条件见 [workflow.md](references/workflow.md)。
  36. ## 第一层:内容逻辑
  37. 内容逻辑不是给所有文章套同一结构,而是确认文章完成了它自己的任务。
  38. 排版前至少回答:
  39. - 读者是谁,为什么要继续看;
  40. - 全文真正想让读者记住什么;
  41. - 每个章节承担什么不同职责;
  42. - 案例、观点、方法和结论是否互相重复;
  43. - 哪些判断缺少事实、例子、图片或数据;
  44. - 结尾要完成理解、行动还是情绪收束。
  45. 按文章类型选择判断方式,不默认使用品牌案例模板。详细诊断框架见 [content-logic.md](references/content-logic.md)。
  46. ## 第二层:同款版式适配
  47. 以已发布文章、固定参数及组件为准,判断本篇内容适合哪些已有组件。作者头像、IP、署名使用使用者自己的资产;缺少 IP 时省略图片槽位,不分发 AI呀。
  48. 文章类型只影响案例/步骤/引用等组件的选择,不自动改变基础排版参数;主题配色与身份按使用者配置。已定稿内容不擅自改写;不把内部分析标签写入正文。
  49. ## 第三层:排版执行
  50. 1. 冻结唯一正文,建立段落清单;
  51. 2. 为图片建立证据表,明确每张图必须解释什么;
  52. 3. 根据内容结构和所选首屏版本完成手机端视觉脚本;
  53. 4. 调用 `gzh-design` 的兼容组件生成基础 HTML,使用共享同款参数,不重新选择主题;
  54. 组件结构优先复制 [assets/template-snippets.html](assets/template-snippets.html)(已确认参数的首屏、章节头、图框、三种强调、作者框与段距片段);gzh-design 未安装时以该模板为准,不自行另写组件。
  55. 5. 用本 Skill 的逻辑、审美和移动端规则覆盖冲突的通用默认值;
  56. 6. 输出干净正文、带复制按钮的预览版和无本地图片依赖的发布稳定版;
  57. 7. 完整任务按 [视觉与发布交付](references/visual-delivery.md) 完成配图、封面母图、平台简介和作者区;局部修改不扩大任务;
  58. 8. 在 `375px` 与 `390px` 宽度检查全篇及检查脚本的有效覆盖;
  59. 9. 复制进公众号后台,检查图片、字号、颜色、乱码、错位、空白与断行;
  60. 10. 把最终人工调整区分为单篇特例或稳定偏好,回写本篇同款排版记录。
  61. ## 非机械覆盖规则
  62. - 不机械执行 `gzh-design` 的“每段 1~3 个下划线”。强调频率由本篇同款排版记录、文章密度和语义重要性决定;没有明确偏好时默认克制。
  63. - 不机械添加目录、引言卡、边框、竖线或色块。组件必须服务当前文章的阅读任务。
  64. - 小晚同款可复用本 Skill 公开提供的版式;分析其他参考时提取层级、节奏、密度与装饰逻辑,不复制他人私人识别资产。
  65. - 不把一次反馈写成所有文章的硬规则。只有用户明确要求,或同一偏好重复出现,才沉淀为长期标准。
  66. ## 核心移动端原则
  67. 1. **首屏完整**:有首屏保留已确认组件,无首屏通过原文开头层次引导阅读;两版均不添加背景色。
  68. 2. **层级清楚**:新章节一眼可见,依靠字号、颜色、粗细和留白,不滥用线条切割。
  69. 3. **节奏舒适**:段落、图片与观点块交替出现,避免连续拥挤或大片无意义空白。
  70. 4. **段距分层**:同一论点内的小段保持紧凑,只在新论点、标题和图片之间拉开距离,不把大段距机械套到每一段。
  71. 5. **重点完整且同字号**:宁可少强调,也不高亮半句;行内重点继承正文字号,只改变字重、颜色或下划线,同一句不叠加多种强调。
  72. 6. **语义节奏**:保留原文短句、解释和清单的关系;连续三四段后检查自然转折,不按行数强制强调或插图。
  73. 7. **首屏适配**:主标题合计最多两行,黑底栏一行;先优化宽度与主副标题层级,标题必须醒目且大于正文,不为两行缩成小字,不硬裁;图注按需添加(默认11px),不机械逐图注释或重复署源;同源图片可文末统一来源,必要说明与来源同时出现时分行。
  74. 8. **页面边距**:两版使用同一边距配置,平台外层与正文内层不重复缩进;参数只读layout-standard.md。
  75. 9. **结尾不做假交互**:可保留结尾外框、收束文案和署名式文字,只删除点赞、在看、收藏等不可点击的图标、标签与仿按钮。
  76. 10. **图片有证据**:图片解释正文,不只是填补版面;多图按同组关系与手机可读性决定是否合成。
  77. 11. **真实可发布**:浏览器预览不等于公众号效果,必须完成真实粘贴与手机预览。
  78. 收到模糊反馈时按 [feedback-guide.md](references/feedback-guide.md) 分类处理;交付前运行 [release-checklist.md](references/release-checklist.md)。
  79. ## 完成标准
  80. - 已理解文章的阅读任务;仅在用户要求诊断时交付内容逻辑卡,不把内部分析塞进正文;
  81. - 本篇同款排版记录能够解释本次视觉选择,而不是只写“高级、简洁”;
  82. - 正文没有被擅自改写或漏段;
  83. - 手机端层级、节奏、断行、强调和图片关系清楚;
  84. - HTML 可复制到公众号,且后台无丢图、乱码、错位和异常空白;
  85. - 完整交付含封面母图、横方裁切预览、简介及发布检查;未验证项如实列明;
  86. - 最终调整区分通用规则、执行漏洞、个人配置及本篇特例,验证后再沉淀。
  87. 阅读验收必读 reading-contract.md 当前强制规则:首屏醒目标题与提炼短摘要(不是原文第一段)、两版原文完整保留、正文最多6行、长文语义区隔、不堆竖屏多图、章节编号不拆行。
  88. 完整排版交付必须执行 reading-contract.md 的执行关卡,强调须先按 reading-contract.md“逐屏识别”列出每屏的概念、并列标签与短动作再定样式:概念/标签用橙、短动作用橙下划线、黑粗只给核心判断;只有黑粗的屏须注明纯叙述理由。运行 scripts/audit_preview.cjs并查看全篇,记录密度预警的处理。仅声明“已检查375/390px”不构成完成。
  89. ## 输入与执行边界
  90. 收到长文先复用现有正文、图片、封面标题和已认可版式,默认进入“正文已定稿,只排版”。仅当用户要求诊断/改稿才进入内容共创,不强制每次先提交逻辑卡。网络内容先获取完整原文与图片,保留归属和链接;获取失败说明缺口,不拼凑。X 长文的 API 不返回图片在正文中的位置:须打开原文页面核对每张图的锚点段落;无法核对时按语义推断,并在交付与问题清单中逐图标注“图位推断”,不得当作已确认。多平台任务共用冻结正文,但各自适配标题、图片、简介和发布字段;公众号有无首屏不等于两种平台格式。
  91. 首次使用只问影响结果的缺失偏好;已有配置直接复用。完整排版默认包含有需要的找图/生图、封面及发布准备;用户只要局部排版则按局部范围。新增配图先判断必要性,不为凑数量消耗生成额度。公开发布按当前授权执行,保存草稿不等于已发布。
  92. 更新前辨认实际 Skill 名称、内容与来源;公开包、个人配置和未验收候选不能仅凭目录名互相替代。公开包不携带作者的IP原图、私稿或账号配置。已认可文章是局部修复基线,不被旧参数覆盖。
  93. 发布准备须读 visual-delivery.md 的“文末署名与引流检查”,包含图片内入口;保留归属,按授权减少营销转化,不读取用户禁止访问的私人聊天。
  94. 文末统一为配置化个人介绍区,可含真实公众号链接/名片;不得因引流检查一概删掉。源稿与草稿读回均清查尾部多余可见空行,具体判断见 visual-delivery.md。
  95. **X→公众号尾部**:X 原文末尾的平台尾巴(个人简介、关注我/引导互动、@账号、x.com 链接、私信、付费社群/1V1咨询推广)属于平台尾部,不属于冻结正文。保留最后一个真实正文段原样;尾巴替换为 assets/template-snippets.html 的公众号作者框,其后加 11px 灰色来源行「原文发布于 X @账号 · 日期」。结构:末段正文 → 48px → 作者框 → 来源行。商业转化文案仅在用户确认后保留;必要归属(如配图工具/合作署名)可保留并标 data-tail-confirmed。差异写入交付记录;不断言“一定违规”。与上条一致:真实公众号名片/链接可以保留,不机械全删。
README.md · README · 168 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # @小晚不在 · 公众号排版
  2. 仓库地址:https://github.com/cyberxiaowan/xiaowan-wechat-layout-skill
  3. 这是 @小晚不在 在实际制作公众号长文时,基于多年内容工作、多轮截图反馈、手机端修改和真实发布复盘沉淀出的公开 Skill。
  4. 它建立在甲木 × 摸鱼小李制作的
  5. [gzh-design](https://github.com/isjiamu/gzh-design-skill) 之上:底层负责生成公众号兼容 HTML,本项目负责**任意来源长文的阅读判断、同款排版、配图、封面母图、简介与发布检查**。已有稿默认保留原文;只有用户要求才进行结构诊断或改稿。X只是输入来源之一。
  6. ## 两个版本,只区别有没有首屏
  7. - **完整同款**:保留小晚发布版的首屏外框、刊头、右侧 IP、黑色编者按栏和导语结构。
  8. - **无首屏**:直接进入正文,不制作首屏卡;首屏新增摘要省略,原文第一段与后文完整保留。
  9. 其他处理全部相同:字体、字号、字间距、两侧边距、段距、章节层级、标题与正文间距、图文上下间距、强调和结尾。首次可配置首屏、个人信息与主题配色;两版共享同一配置,无需填写字号段距。
  10. AI呀与私人素材不随包分发,替换为使用者自己的 IP/署名。调用名仍为 `xiaowan-wechat-layout-lite`。
  11. ## 它真正提供什么
  12. ### 1. 内容逻辑诊断
  13. 按文章理解阅读路径;只有用户请求诊断时才展开以下分析:
  14. - 文章写给谁,为什么值得继续看;
  15. - 全文真正想让读者记住什么;
  16. - 每个章节分别承担什么职责;
  17. - 哪些内容重复,哪些判断缺少证据;
  18. - 结尾应该完成理解、行动还是情绪收束。
  19. 它不会默认把所有文章套成品牌案例文,也不会未经允许直接重写全文。
  20. ### 2. 同款版式适配
  21. 它会结合用户自己的已发布文章、参考图、品牌资产和反馈,把“看起来不舒服”翻译成可执行的视觉判断:
  22. - 层级是否清楚;
  23. - 每屏信息是否过密;
  24. - 文字、图片和重点句的节奏是否舒适;
  25. - 横线、竖线、色块和外框是否过多;
  26. - 标题是否出现 2~3 字孤行;
  27. - 重点是否只高亮了半句;
  28. - 图片是否真的解释了正文;
  29. - 哪些调整值得写进自己的个人风格卡。
  30. 两版共用小晚同款规则,仅首屏模块不同。
  31. ### 3. 排版与发布执行
  32. - 调用 `gzh-design` 生成公众号 HTML;
  33. - 生成干净正文、带复制按钮的预览版和发布稳定版;
  34. - 多图进入公众号前预先拼好;
  35. - 检查约 390px 手机宽度;
  36. - 粘贴到公众号后台检查丢图、乱码、错位和断行;
  37. - 把最终人工调整区分为单篇特例或长期偏好。
  38. ## 实际案例
  39. [![@小晚不在公众号排版案例](docs/wechat-layout-showcase.jpg)](https://mp.weixin.qq.com/s/EKjNjihmkXBYgao16m5ztQ?scene=1)
  40. [查看完整公众号文章](https://mp.weixin.qq.com/s/EKjNjihmkXBYgao16m5ztQ?scene=1)
  41. 这张长图是 @小晚不在 使用底层排版能力,再经过多轮人工判断和修改得到的**共创案例**,用于展示“如何从反馈中建立自己的规则”,同款模式复用其中的版式语言、配色和阅读节奏,实际结构按正文适配,不保证逐像素复刻。AI呀、署名及文章素材需要换成使用者自己的资产。
  42. 示意图仅用于展示排版效果;文章中的品牌图片版权归原品牌及原媒体所有。
  43. ## 安装
  44. ### 方式一:一条提示词安装或更新两个 Skill
  45. 把下面整段复制给 Codex:
  46. ```text
  47. 请帮我安装并验证以下两个 Codex Skill:
  48. 1. gzh-design
  49. https://github.com/isjiamu/gzh-design-skill
  50. 2. xiaowan-wechat-layout-lite
  51. https://github.com/cyberxiaowan/xiaowan-wechat-layout-skill
  52. 要求:
  53. - 先检查本机已安装的 Skills;
  54. - 缺少哪个就从对应 GitHub 仓库安装;
  55. - 如果 xiaowan-wechat-layout-lite 已存在,先备份旧目录,再用仓库最新版更新;
  56. - gzh-design 已存在时不要覆盖用户自定义主题;只确认它结构完整、可以被调用;
  57. - 安装到 Codex 的 Skills 目录;
  58. - 检查两个目录都包含有效的 SKILL.md;
  59. - 告诉我安装或更新结果,以及新开 Codex 任务后如何调用。
  60. ```
  61. ### 方式二:Mac 一键安装
  62. 下载并解压仓库后,双击 `install.command`。它会更新公开 Skill;若本机缺少 `gzh-design`,会自动安装底层依赖。
  63. 安装完成后,新开一个 Codex 任务即可使用。
  64. ## 直接使用小晚同款
  65. ```text
  66. 用 $xiaowan-wechat-layout-lite 按小晚同款排版这篇文章。
  67. 正文不要改,标题在左,我的 IP 在右;没有 IP 就省略。
  68. 生成可复制 HTML,检查 375px 和 390px 手机效果。
  69. ```
  70. ## 三种工作入口
  71. ### 完整共创:先理逻辑,再定审美,最后排版
  72. ```text
  73. 用 $xiaowan-wechat-layout-lite 处理这篇公众号文章。
  74. 先诊断内容逻辑,不要直接重写;再结合我的参考图和历史文章,
  75. 整理一张个人风格卡。等我确认后,再生成可复制的公众号 HTML。
  76. ```
  77. ### 正文已定稿:只排版
  78. ```text
  79. 用 $xiaowan-wechat-layout-lite 排版这篇公众号文章。
  80. 正文已经定稿,不要改文字。根据我的参考和个人风格卡完成手机端排版,
  81. 再生成可复制的 HTML,并检查 390px 预览和公众号粘贴稳定性。
  82. ```
  83. ### 已有 HTML:只做审美与发布检查
  84. ```text
  85. 用 $xiaowan-wechat-layout-lite 检查这份公众号 HTML。
  86. 先判断问题属于内容层级、阅读节奏、装饰、强调、图片还是平台兼容,
  87. 只修改对应层,不要重做已确认的部分。
  88. ```
  89. ## 默认视觉起点
  90. 用户尚未形成个人风格时,可以暂时从以下参数开始:
  91. - 正文:`15px / #4f504b / 2` 行距、`0.05px` 字距;
  92. - 页面边距:平台外层与正文内层分开核验,避免重复缩进;
  93. - 章节强调:赭金 `#b17816`;
  94. - 正文、首屏框、图片框和个人介绍区不添加背景色,随平台底色;首屏黑色小标栏保留;
  95. - 少线条、少外框,优先靠层级与留白组织文章;
  96. - 同一论点内保持紧凑,只在新论点、标题和图片之间拉开距离;
  97. - 重点与正文同字号,只改变字重、颜色或下划线,并覆盖完整语义;
  98. - 保留语义分段,只在大层级与连续长文的自然转折处增加留白;
  99. - 同组多图按手机可读性决定是否预合成;
  100. - 最终以公众号后台和手机预览为准。
  101. 完整同款与无首屏均沿用固定参数,仅是否生成首屏模块不同。
  102. ## 边界
  103. - 它可以诊断内容逻辑,但不会替作者决定观点;
  104. - 它可以在授权后调整结构或文字,但不会默认重写正文;
  105. - 它可以分析参考图的层级、密度和节奏,但不会复制他人的 IP 与完整版式;
  106. - 它不会把品牌案例、教程、访谈和个人复盘强行排成同一种文章;
  107. - 它不包含 `gzh-design` 源码,也不包含 @小晚不在 的私人文章、AI呀素材或业务资料。
  108. ## 授权与致谢
  109. - 排版底层:甲木 × 摸鱼小李的 `gzh-design`;
  110. - 内容逻辑、审美共创与移动端工作流:@小晚不在;
  111. - 本项目采用 `AGPL-3.0-or-later`;
  112. - 使用者应替换为自己的合法图片、IP、署名和内容资产。
  113. 详见 [NOTICE.md](NOTICE.md)。
  114. ## 首次个人配置
  115. 提供文章和素材后,可选择首屏、栏目名称、自己的IP、个人介绍和配色。已确认配置保存在工作目录 `.wechat-layout/profile.json`,不进入公开Skill包。后续直接沿用;两种首屏共用配置。图文按阅读需要安排,资料来源按文章实际情况显示,转载保留原作者署名。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.