Skip to content

topmindspace/topmind-writing-skills / topmind-wechat-post

topmind-wechat-post

Verified

创作、整理和排版公众号文章;支持工具/插件推荐结构、产品实测评测、深度解读与叙事随笔,从选题或底稿到 Markdown,按需导出内联 HTML、预览与上传清单。公众号短文用 topmind-briefs,独立改稿用 topmind-revise。

FileKindSize
.gitignoreother31 B
README.en.mdmarkdown2.0 KB
README.mdmarkdown2.2 KB
SKILL.mdskill md5.5 KB
assets/themes/amber-review.jsonconfig979 B
assets/themes/graphite.jsonconfig971 B
assets/themes/md3-business-blue.jsonconfig895 B
assets/themes/minimal-ink.jsonconfig965 B
assets/themes/newsprint.jsonconfig936 B
assets/themes/tech-blue.jsonconfig957 B
examples/01-公众号-整理书架.mdmarkdown1.7 KB
examples/02-公众号-第一次养绿植.mdmarkdown1.8 KB
examples/README.mdmarkdown667 B
knowledge/README.mdmarkdown9.4 KB
knowledge/cards/atlas-local-fix.mdmarkdown781 B
knowledge/cards/brief-news-to-post.mdmarkdown3.0 KB
knowledge/cards/brief-news.mdmarkdown916 B
knowledge/cards/brief-paper.mdmarkdown760 B
knowledge/cards/brief-tools.mdmarkdown617 B
knowledge/cards/brief-value-first.mdmarkdown3.1 KB
knowledge/cards/cover-abstract.mdmarkdown1.3 KB
knowledge/cards/cover-brief.mdmarkdown1.3 KB
knowledge/cards/cover-collage.mdmarkdown1.3 KB
knowledge/cards/cover-color.mdmarkdown1.2 KB
knowledge/cards/cover-culture.mdmarkdown1013 B
knowledge/cards/cover-editorial.mdmarkdown1.2 KB
knowledge/cards/cover-material.mdmarkdown1.3 KB
knowledge/cards/cover-photo.mdmarkdown1.1 KB
knowledge/cards/cover-playful.mdmarkdown1.0 KB
knowledge/cards/cover-scene.mdmarkdown962 B
knowledge/cards/cover-series.mdmarkdown1017 B
knowledge/cards/cover-typography.mdmarkdown1.3 KB
knowledge/cards/creative-choice.mdmarkdown807 B
knowledge/cards/crop-independent.mdmarkdown719 B
knowledge/cards/de-ai-mechanisms.mdmarkdown3.6 KB
knowledge/cards/experience-loop.mdmarkdown801 B
knowledge/cards/format-fidelity.mdmarkdown501 B
knowledge/cards/format-layouts.mdmarkdown502 B
knowledge/cards/poster-paging.mdmarkdown726 B
knowledge/cards/poster-structure.mdmarkdown646 B
knowledge/cards/poster-voices.mdmarkdown530 B
knowledge/cards/reference-reading.mdmarkdown857 B
knowledge/cards/revise-depth.mdmarkdown677 B
knowledge/cards/revise-feedback.mdmarkdown609 B
knowledge/cards/revise-learn-from-edits.mdmarkdown3.1 KB
knowledge/cards/revise-preserve.mdmarkdown788 B
knowledge/cards/viral-mechanisms.mdmarkdown535 B
knowledge/cards/viral-observation.mdmarkdown544 B
knowledge/cards/viral-play-dumb.mdmarkdown2.8 KB
knowledge/cards/viral-replies.mdmarkdown722 B
knowledge/cards/visual-density-and-evidence.mdmarkdown2.8 KB
knowledge/cards/voice-peer-stance.mdmarkdown2.7 KB
knowledge/cards/wechat-decide.mdmarkdown746 B
knowledge/cards/wechat-explain.mdmarkdown820 B
knowledge/cards/wechat-plugin-and-review.mdmarkdown2.5 KB
knowledge/cards/wechat-story.mdmarkdown798 B
knowledge/cards/x-adapt.mdmarkdown643 B
knowledge/cards/x-argument.mdmarkdown770 B
knowledge/cards/x-evidence.mdmarkdown608 B
knowledge/index.jsonconfig39.9 KB
package.jsonmanifest464 B
references/case-notes.mdmarkdown1.9 KB
references/core-voice.mdmarkdown9.9 KB
references/creative-practice.mdmarkdown5.0 KB
references/de-ai-rules.mdmarkdown17.9 KB
references/element-spec.mdmarkdown9.7 KB
references/image-sourcing.mdmarkdown2.7 KB
references/information-design.mdmarkdown5.0 KB
references/knowledge-library.mdmarkdown5.5 KB
references/known-pits.mdmarkdown3.9 KB
references/platform-cover-specs.mdmarkdown7.4 KB
references/platform-operations.mdmarkdown12.2 KB
references/research-mode.mdmarkdown1.6 KB
references/revision-workflow.mdmarkdown5.9 KB
references/social-writing-principles.mdmarkdown7.7 KB
references/theme-map.mdmarkdown6.6 KB
references/typography-rules.mdmarkdown1.6 KB
references/wechat-constraints.mdmarkdown7.2 KB
references/workflow.mdmarkdown6.5 KB
references/workspace.mdmarkdown2.3 KB
references/writing-quality.mdmarkdown2.0 KB
references/x-delivery-contract.mdmarkdown3.6 KB
references/x-post-format.mdmarkdown2.5 KB
scripts/article_scaffold.pyscript5.6 KB
scripts/audit-provenance.pyscript14.9 KB
scripts/audit_css.pyscript1.1 KB
scripts/audit_docs.pyscript3.1 KB
scripts/audit_skill.pyscript3.1 KB
scripts/audit_styles.pyscript1.6 KB
scripts/check_article.pyscript13.9 KB
scripts/count_words.pyscript3.0 KB
scripts/de_ai_lint.pyscript41.5 KB
scripts/info_design_hints.pyscript14.2 KB
scripts/knowledge.pyscript11.8 KB
scripts/lint-wechat.pyscript18.5 KB
scripts/lint_x_post.pyscript20.0 KB
scripts/md2wechat.pyscript83.6 KB
scripts/negative_tests.pyscript24.9 KB
scripts/new-article.pyscript10.3 KB
scripts/package_skill.pyscript6.6 KB
scripts/push-to-topstream.pyscript9.7 KB
scripts/revise_check.pyscript15.2 KB
scripts/scan_ai_flavor.pyscript2.6 KB
scripts/scan_ai_flavor_builtin.pyscript6.5 KB
scripts/sync-mapping.pyscript8.4 KB
scripts/sync-status.pyscript6.9 KB
scripts/wechat_paths.pyscript4.7 KB

references/theme-map.md

View on GitHub
# 题材 → 主题映射

「按题材分主题」的规约。主题文件在 `assets/themes/*.json`,
命令行 `--theme` 选主题,`--list-themes` 看全部,`genre:题材` 按题材自动选。

## 已注册主题

| 主题 | 标识 | 主色 | 标题样式 | 圆角 | 适用题材 |
|---|---|---|---|---|---|
| 极简黑白灰 | `minimal-ink` | `#A6524A` 砖红 | number | 4px | **默认**、观点、深度分析、随笔 |
| 科技蓝 | `tech-blue` | `#185FA5` 蓝 | number | 6px | 教程、实操、工具测评、建站 |
| 石墨灰阶 | `graphite` | `#52525B` 石墨 | underline | 0px | 技术说明、专业评论、方法、原理 |
| 报纸纸感 | `newsprint` | `#8C5A3C` 棕(衬线) | center | 0px | 复盘、特稿、行业观察、长文 |
| 琥珀评测 | `amber-review` | `#B45309` 琥珀 | number | 6px | 评测、模型评测、数据对比、榜单、速览 |

```bash
# 看清单
python3 scripts/md2wechat.py --list-themes

# 指定主题(三种写法都可以)
--theme amber-review        # 标识
--theme 琥珀评测            # 中文名
--theme genre:评测          # 按题材自动选
```

## 选题材的原则

**要点**:主题跟着**题材**走,不跟着心情走。同一个题材永远用同一套主题,
读者才能形成视觉记忆。换题材时才换主题。

| 判断依据 | 走哪个主题 |
|---|---|
| 有大量数据对比、榜单、多维评分 | 琥珀评测 |
| 有步骤、命令、可复现的操作过程 | 科技蓝 |
| 讲原理、讲机制、专业观点输出,需要克制 | 石墨灰阶 |
| 讲一个完整案例的来龙去脉、时间跨度长 | 报纸纸感 |
| 观点表达、行业观察、随笔,没有明显题材特征 | 极简黑白灰(默认) |

**题材交叉时**(如"带步骤的模型评测"):看**读者来干什么**。
来抄操作步骤的 → 科技蓝;来看结论和数据的 → 琥珀评测。

## 主题之间保持一致的东西(硬约束)

换主题**只换色彩与标题形态**,以下参数在所有主题间保持一致,不要随手改:

| 参数 | 统一值 | 理由 |
|---|---|---|
| 正文字号 | 16px | 公众号长文阅读舒适区 |
| 行高 | 1.75(报纸纸感 1.8) | 低于 1.7 会挤 |
| 段间距 | 22px(报纸纸感 24px) | 与行高成比例 |
| 对齐 | `left` | 中文 `justify` 会产生「河流」并触发格式告警 |
| 章节编号 | 手写「一、」「二、」原样保留;整篇都没写时才由排版层生成 | 见 `element-spec.md`「章节编号」;自动编号时末章收束类用 `∞` |
| 强调规则 | 源稿只用加粗和引用块;强调占比 < 20% | 与主题无关,是阅读规律 |

**这些是阅读规律,不是审美偏好**,任何主题都不该改。

## 每套主题要提供的字段(硬约束:渲染脚本依赖)

新增主题时字段缺一个,就会继承默认主题的值——**这正是历史 bug 的成因**:
`tech-blue` 当年只写了 14 个字段,`mark_bg` 落到默认主题的砖红浅底 `#FAF0EE`,
一套蓝色主题里冒出砖红高亮,于是从来没人敢用它。现在 `load_theme()` 会按各自主色
自动派生 `accent_light` / `accent_soft`,但**其余字段仍需显式写全**。

```jsonc
{
  "id": "标识(英文,命令行用)",
  "name": "中文名",
  "genre": ["题材1", "题材2"],        // `--theme genre:题材` 按此匹配,也用于 --list-themes 展示

  // 主色三件套:派生色可不写(自动按 accent 算),写了则以文件为准
  "accent": "#______",               // 唯一强调色
  "accent_light": "#______",         // 下划线色(兼容渲染旧稿 ++x++)
  "accent_soft": "#______",          // 高亮底 / 徽章底

  // 文字四级
  "text": "#______",                 // 正文
  "text_strong": "#______",          // 加粗、标题
  "text_muted": "#______",           // 斜体、脚注
  "text_light": "#______",           // 图注、数值说明、导读截断提示

  // 面与线
  "surface": "#______",              // 卡片底(stat/引用/签名/导读共用)
  "border": "#______",               // 表格线、金句上下框线
  "img_border": "#______",           // 图片描边

  // 代码块:色板按 accent 自动生成,配色方案二选一
  "code_bg": "#______",
  "code_text": "#______",
  "code_scheme": "mono",             // mono(推荐,只用主色+明暗)| palenight(不推荐)

  // 四种语义色(容器左边框)
  "c_note": "#______", "c_tip": "#______",
  "c_warn": "#______", "c_danger": "#______",

  // 形态
  "radius": "0px | 4px | 6px",       // 全主题统一圆角;直角最保守
  "h2_style": "number | bar | underline | center | plain",
  "line_height": "1.75",
  "para_gap": "22px",
  "align": "left",
  "font_size": "16px",

  // 结构组件
  "toc": true, "toc_max": 5, "toc_min_h2": 4, "toc_min_chars": 2000,
  "table_max_cols": 3,               // 超过就转卡片化

  "font_stack": "...", "mono_stack": "..."
}
```

## 加一套新主题的步骤

1. 在 `assets/themes/` 写 `{id}.json`,字段按上表写全
2. 跑 `python3 scripts/md2wechat.py --list-themes` 确认能被列出
3. 用一篇真实稿跑一遍,确认 `合规自检` 为 0 ERROR:
   `python3 scripts/md2wechat.py --input 稿.md --out-dir ./out --slug t --theme {id}`
4. 在本文件的主题表里登记一行
5. 目视核对:**下划线色、高亮底、代码块关键字色是否都跟本主题主色同源**
   (不同源 = 又出现了色彩外溢)

## 主题与视觉层级的配合

各强调手段在所有主题下的表现(下划线、高亮只用于兼容渲染旧稿里的扩展标记,新稿不写):

| 手段 | 主题相关性 |
|---|---|
| 主色加粗 / 深色底白字引用 | 用 `text_strong`,**不用 accent**——浅色主题下 accent 加粗不够重 |
| 下划线 `accent_light`(兼容) | 浅色主题用浅色调(砖红→`#E3BAB3`);深色主题用主色本身(石墨→`#52525B`) |
| 底色 `surface` + 左边框 `accent` | 全主题统一结构,只换色 |

石墨灰阶的下划线特意用主色本身而不是浅色调:灰色主题里浅灰下划线几乎看不见,
起不到标记作用。**下划线色的选择标准是「能不能看见」,不是「够不够淡」。**

### `h2_style` 会连带影响导读

导读(前言看点)的标记跟随 `h2_style`:带编号的主题(`minimal-ink`/`tech-blue`/`amber-review`)
导读也编号,末章收束类同为 `∞`;不带编号的主题(`graphite` 下划线 / `newsprint` 上下框线)
导读只能用中性圆点。**换主题时导读会自动跟着变,不用手改**——但如果发现"导读有 01、正文没编号",
那是渲染器 bug,不是主题配置问题。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall