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

scripts/wechat_paths.py

View on GitHub
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""wechat_paths.py — 公众号交付包与 topstream 的路径解析(new-article / sync-* / push-to-topstream 共用)。

不写死任何个人路径、类别编号或年份。解析顺序(命中即用):

交付包根(base)
  1. CLI `--base <专题目录>`
  2. 环境变量 `TOPMIND_WECHAT_BASE`(兼容旧名 `TOPMIND_WECHAT_PACKAGE_ROOT`)
  3. 工作区发现:CLI `--workspace` → 环境变量 `TOPMIND_WORKSPACE`
     - 类别目录按**名称**找,不按编号:`TOPMIND_WECHAT_CATEGORY`(完整目录名)优先,
       否则依次找名为「长文」「创作」「专题」的类别(形如 `NN-长文` / `NN 长文` / `长文`)
     - 专题目录:`TOPMIND_WECHAT_TOPIC`,否则 `{当年}-公众号`(年份取运行当天,不写死)
     - 先用已存在的 `<类别>/<专题>`;都不存在时用第一个已存在的类别 + 专题名(由调用方决定是否创建)
  4. 以上都没有 → 返回 None,调用方报错并提示传 `--base` 或设 `TOPMIND_WORKSPACE`

topstream(可选)
  CLI `--topstream` → 环境变量 `TOPSTREAM_ROOT`(兼容 `TOPMIND_TOPSTREAM`)→ None(跳过 notes 相关校验)
"""
from __future__ import annotations

import datetime
import os
import re

# 公众号交付包所在类别的候选名称(按优先级)。只认名称,编号随工作区模板变化。
CATEGORY_NAMES = ("长文", "创作", "专题")

_CAT_RE = re.compile(r"^(?:\d+[- ]?)?(.+)$")


def _abs(p):
    return os.path.abspath(os.path.expanduser(p))


def default_topic(today=None):
    env = os.environ.get("TOPMIND_WECHAT_TOPIC")
    if env:
        return env.strip()
    year = (today or datetime.date.today()).year
    return "%d-公众号" % year


def find_category_dirs(workspace):
    """返回工作区里按 CATEGORY_NAMES 优先级排列的类别目录(绝对路径)。"""
    explicit = os.environ.get("TOPMIND_WECHAT_CATEGORY")
    if explicit:
        p = os.path.join(workspace, explicit.strip())
        return [p] if os.path.isdir(p) else []
    try:
        entries = sorted(e for e in os.listdir(workspace)
                         if os.path.isdir(os.path.join(workspace, e)))
    except OSError:
        return []
    out = []
    for name in CATEGORY_NAMES:
        for e in entries:
            m = _CAT_RE.match(e)
            if m and m.group(1).strip() == name:
                out.append(os.path.join(workspace, e))
    return out


def resolve_workspace(cli_workspace=None):
    ws = cli_workspace or os.environ.get("TOPMIND_WORKSPACE")
    return _abs(ws) if ws else None


def resolve_base(cli_base=None, cli_workspace=None, today=None):
    """交付包根;解析不到返回 None。"""
    if cli_base:
        return _abs(cli_base)
    env = os.environ.get("TOPMIND_WECHAT_BASE") or os.environ.get("TOPMIND_WECHAT_PACKAGE_ROOT")
    if env:
        return _abs(env)
    ws = resolve_workspace(cli_workspace)
    if not ws:
        return None
    topic = default_topic(today)
    cats = find_category_dirs(ws)
    for cat in cats:
        p = os.path.join(cat, topic)
        if os.path.isdir(p):
            return p
    if cats:
        return os.path.join(cats[0], topic)
    return None


def resolve_topstream(cli_topstream=None):
    if cli_topstream:
        return _abs(cli_topstream)
    env = os.environ.get("TOPSTREAM_ROOT") or os.environ.get("TOPMIND_TOPSTREAM")
    return _abs(env) if env else None


MISSING_BASE = (
    "✗ 找不到公众号交付包根目录。\n"
    "  传 --base <专题目录>,或设置环境变量:\n"
    "    export TOPMIND_WECHAT_BASE=/path/to/<类别>/<年份>-公众号\n"
    "    export TOPMIND_WORKSPACE=/path/to/topmind-workspace   # 按名称发现「长文/创作/专题」类别\n"
    "  可选:TOPMIND_WECHAT_CATEGORY=<类别目录名>、TOPMIND_WECHAT_TOPIC=<专题目录名>"
)


def require_base(cli_base=None, cli_workspace=None):
    base = resolve_base(cli_base, cli_workspace)
    if not base:
        raise SystemExit(MISSING_BASE)
    return base


LEGACY_DRAFT = "公众号稿.md"


def find_draft(pkg):
    """在一个文章目录里找源稿,返回 (路径, 结构) 或 (None, None)。

    - 新结构(默认):<文章名>/<文章名>.md,状态只记在 frontmatter,目录名不随状态变;
    - 旧结构(只读兼容):<YYYY-MM-DD-短名>[-released]/公众号稿.md,不自动迁移。
    """
    if not os.path.isdir(pkg):
        return None, None
    legacy = os.path.join(pkg, LEGACY_DRAFT)
    if os.path.isfile(legacy):
        return legacy, "legacy"
    name = os.path.basename(os.path.normpath(pkg))
    art = os.path.join(pkg, name + ".md")
    if os.path.isfile(art):
        return art, "article"
    return None, None
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