thinkthinking

面向 LLM Agent、自动化脚本与开发者 的本地 CLI 工具箱。把 Markdown 一键转成微信公众号兼容 HTML 并直接发布草稿——所有命令输出统一 JSON，Claude Code / Codex 等 Agent 可稳定解析。

thinkthinking 是一个 Go 编写的单文件二进制 CLI。第一期聚焦微信公众号能力：

wechat convert — Markdown → 微信公众号兼容 HTML（CJK 自动空格、列表转 section、外链转脚注、暗黑模式、::: 容器块、120 字节摘要等修复一应俱全）。
wechat post — 一步发布草稿：自动转换 → 上传正文本地图片并回填 URL → 上传封面 → 写入草稿箱。

转换逻辑移植自经过实战验证的 wewrite pipeline。所有命令默认输出统一 JSON envelope（JSON 走 stdout，日志走 stderr），天然适配 Agent 与脚本。

安装

npm（推荐）

npm install -g @thinkthinking/cli

npm 包是 Go 二进制的分发壳：通过 optionalDependencies 把各平台二进制拆成独立子包，安装时自动只下载匹配你系统的那一个，装完即用——无 postinstall、无运行时下载，运行时不依赖 Node。

一键脚本

curl -fsSL https://raw.githubusercontent.com/thinkthinking/cli/master/scripts/install.sh | bash

从源码构建

git clone https://github.com/thinkthinking/cli.git
cd cli
make build      # 产物在 bin/thinkthinking

验证安装：

thinkthinking --version

快速开始

# 1. 初始化用户配置 ~/.thinkthinking/config.yaml
thinkthinking init

# 2. 配置微信公众号凭证
thinkthinking config set wechat.app_id     wx_your_appid
thinkthinking config set wechat.app_secret your_appsecret

# 3. Markdown → 微信公众号 HTML
thinkthinking wechat convert article.md

# 4. 一步发布为草稿（自动转换 + 上传正文图片与封面）
thinkthinking wechat post article.md \
  --title "文章标题" --author "你的名字" --cover cover.jpg

命令一览

命令	说明
`thinkthinking -v` / `--version`	输出版本信息
`thinkthinking init [--local] [--force]`	创建用户级（或项目级）配置
`thinkthinking config path`	输出配置文件路径与加载状态
`thinkthinking config get <key>`	读取配置项
`thinkthinking config set <key> <value>`	设置配置项
`thinkthinking config list`	输出完整配置（敏感字段脱敏）
`thinkthinking wechat convert <file>`	Markdown → 微信公众号 HTML
`thinkthinking wechat post <file>`	发布微信公众号草稿

全局 flags：--config --pretty --quiet --no-color --trace-id --verbose。

提示：Agent 可对任意命令加 -h 查看完整用法与示例，例如 thinkthinking wechat -h、thinkthinking wechat post -h。

wechat convert

正文文件作为位置参数传入（也兼容 --input / --stdin）：

thinkthinking wechat convert article.md
thinkthinking wechat convert article.md --output dist/article.html
thinkthinking wechat convert article.md --theme midnight
thinkthinking wechat convert --stdin < article.md

内置主题：default、minimal、midnight、newspaper、tech-modern。可在 ~/.thinkthinking/themes/ 或 ./.thinkthinking/themes/ 放置同名 YAML 覆盖内置主题。

兼容增强（默认开启，可用 flag 关闭）：

--no-darkmode 关闭暗黑模式属性注入
--no-footnotes 关闭外链转脚注
--no-containers 关闭 :::callout / :::timeline / :::dialogue / :::quote / :::highlight / :::summary 容器块

如何把内容正确放进公众号编辑器

⚠️ 不要把 convert 打印的 HTML 文本直接复制粘贴进公众号——会显示成 HTML 源码，而非排版。

原因：微信编辑器只有在系统剪贴板携带 text/html 富文本类型时才会渲染粘贴内容。终端里 convert | pbcopy 或从 .html 文件复制，剪贴板只有纯文本（text/plain），微信便把标签当字面量插入。转换出的 HTML 本身是正确、微信兼容的——问题只在「怎么投递」。三种正确方式：

方式	命令	适用场景
剪贴板（仅 macOS）	`convert --copy`	终端最快：写入富文本剪贴板，到公众号 `Cmd+V` 直接渲染
浏览器预览页（全平台）	`convert --preview`	最稳：打开预览页肉眼校对排版，点「复制到公众号」按钮再粘贴
草稿 API（推荐给 Agent）	`wechat post`	全自动：直接写进公众号草稿箱，无需剪贴板，见下节

# macOS：转换并写入剪贴板，然后去公众号 Cmd+V
thinkthinking wechat convert article.md --copy

# 任意平台：生成预览页并打开浏览器，页面内一键复制
thinkthinking wechat convert article.md --preview

--copy 成功后 JSON 含 "copied": true；非 macOS 返回 PLATFORM_NOT_SUPPORTED，请改用 --preview 或 --output。
--preview 成功后 JSON 含 preview_path（预览文件路径）与 opened（是否成功唤起浏览器）。
--copy / --preview / --output 可叠加使用。

wechat post

把一篇文章发布为草稿。正文文件作为位置参数传入，按后缀自动判断类型——.md / .markdown 自动转换，.html / .htm 直接当正文。--title、--author、--cover 三者必填。

# 从 Markdown（自动转换 + 上传正文本地图片）
thinkthinking wechat post article.md \
  --title "标题" --author "你的名字" --cover cover.jpg

# 从已有 HTML（直传，不转换）
thinkthinking wechat post article.html \
  --title "标题" --author "你的名字" --cover cover.jpg

参数	必填	说明
`<file>`	✅	正文文件，按后缀自动判断：`.md`/`.markdown` 转换，`.html`/`.htm` 直传
`--title`	✅	文章标题
`--author`	✅	作者
`--cover`	✅	本地封面图路径，上传为 `thumb_media_id`
`--theme, -t`		主题名（仅 `.md` 正文生效，默认读配置）
`--digest`		摘要（默认用转换生成的摘要）
`--no-upload-images`		禁用正文本地图片自动上传

正文中的本地图片会自动上传到微信并回填 URL；远程 http(s) 图片跳过。
执行前自动进行凭证预检，缺失时返回结构化 WECHAT_AUTH_ERROR 并附配置路径与环境变量提示。

微信公众号配置流程

使用 wechat 命令前，需要先在微信公众平台获取凭证并配置到本地。

1. 获取 AppID 与 AppSecret

登录微信公众平台，进入「设置与开发 → 基本配置」。
获取或重置 AppID、AppSecret（AppSecret 仅展示一次，请立即保存）。
在「基本配置」中配置 IP 白名单：将调用机器的公网出口 IP 加入白名单，否则 access_token 与后续接口会被拒绝。
进入「设置与开发 → 接口权限」，确认以下接口可用：素材管理、草稿箱、发布能力。

2. 配置本地凭证

方式一：CLI 写入（推荐）

thinkthinking init
thinkthinking config set wechat.app_id     wx_your_appid
thinkthinking config set wechat.app_secret your_appsecret
thinkthinking config list                   # 验证（敏感字段已脱敏）

方式二：手动编辑配置文件

配置就是一个纯文本 YAML 文件，可以直接用任意编辑器打开修改：

# 先创建配置文件（若还没有）
thinkthinking init

# 查看文件路径
thinkthinking config path

# 直接打开编辑（任选其一）
vim  ~/.thinkthinking/config.yaml
code ~/.thinkthinking/config.yaml      # VS Code
open ~/.thinkthinking/config.yaml      # macOS 用默认程序打开

把 app_id、app_secret 填进去保存即可：

wechat:
  app_id: "wx_your_appid"
  app_secret: "your_appsecret"
  default_author: "你的名字"
  default_theme: "default"

路径固定、跨平台一致——用户级 ~/.thinkthinking/config.yaml，项目级 ./.thinkthinking/config.yaml（用 thinkthinking init --local 创建）。

方式三：环境变量（适合 CI/CD）

export WECHAT_APP_ID=wx_your_appid
export WECHAT_APP_SECRET=your_appsecret

3. 验证配置

thinkthinking config list    # 查看当前配置（敏感字段脱敏）
thinkthinking config path    # 查看配置文件路径与加载状态

参考链接：微信公众平台 · 开发概述 · 获取 access_token · 新增草稿

配置

配置文件固定路径（跨平台一致）：

用户级：~/.thinkthinking/config.yaml
项目级：./.thinkthinking/config.yaml

优先级（高 → 低）：CLI flags > 环境变量 > 项目配置 > 用户配置 > 默认值。

完整示例：

wechat:
  app_id: ""
  app_secret: ""
  access_token: ""
  default_author: "thinkthinking"
  default_theme: "default"

output:
  pretty: false
  quiet: false

环境变量

凭证可通过环境变量提供（优先级高于配置文件）：

环境变量	对应配置
`WECHAT_APP_ID`	`wechat.app_id`
`WECHAT_APP_SECRET`	`wechat.app_secret`
`WECHAT_ACCESS_TOKEN`	`wechat.access_token`
`WECHAT_AUTHOR`	`wechat.default_author`
`WECHAT_THEME`	`wechat.default_theme`

JSON 输出规范

所有命令默认输出统一 envelope。JSON 走 stdout，日志/警告走 stderr，Agent 可稳定 parse stdout。

成功：

{ "ok": true, "data": { }, "error": null }

失败：

{ "ok": false, "data": null, "error": { "code": "WECHAT_AUTH_ERROR", "message": "...", "details": { } } }

错误码：INVALID_INPUT CONFIG_ERROR FILE_NOT_FOUND MARKDOWN_CONVERT_ERROR WECHAT_AUTH_ERROR WECHAT_API_ERROR NETWORK_ERROR PLATFORM_NOT_SUPPORTED INTERNAL_ERROR。

架构

cmd/thinkthinking        # 入口
internal/
  cli/                   # 参数解析 → 调 service → 输出 JSON
  app/                   # Application Container（装配所有 service）
  core/
    wechat/              # 转换 pipeline、草稿服务、微信 client（含内嵌主题）
    output/              # 统一 JSON envelope
  config/                # 配置加载/读写（koanf 多源合并）
  logging/ storage/ server/ tui/ version/

核心能力沉淀在 internal/core，CLI 只是入口之一。未来的 TUI / GUI / Local API 复用同一套 core。

Roadmap

TUI（Bubble Tea 交互式界面）
Local API server / GUI（复用 core service）
MCP server（让 Agent 直接调用 thinkthinking tools）
小绿书（图片消息）草稿
更多个人工具：文章处理、内容发布、文件转换、AI 辅助写作、知识库整理

开发

make build      # 构建
make test       # 测试
make lint       # gofmt 检查 + go vet
make fmt        # 格式化
make snapshot   # 本地试构建跨平台产物

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 11 Commits
.github/workflows		.github/workflows
assets		assets
cmd/thinkthinking		cmd/thinkthinking
examples		examples
internal		internal
npm		npm
scripts		scripts
.gitignore		.gitignore
.goreleaser.yaml		.goreleaser.yaml
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
go.mod		go.mod
go.sum		go.sum

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

thinkthinking

安装

npm（推荐）

一键脚本

从源码构建

快速开始

命令一览

wechat convert

如何把内容正确放进公众号编辑器

wechat post

微信公众号配置流程

1. 获取 AppID 与 AppSecret

2. 配置本地凭证

方式一：CLI 写入（推荐）

方式二：手动编辑配置文件

方式三：环境变量（适合 CI/CD）

3. 验证配置

配置

环境变量

JSON 输出规范

架构

Roadmap

开发

License

About

Uh oh!

Releases 4

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

thinkthinking

安装

npm（推荐）

一键脚本

从源码构建

快速开始

命令一览

wechat convert

如何把内容正确放进公众号编辑器

wechat post

微信公众号配置流程

1. 获取 AppID 与 AppSecret

2. 配置本地凭证

方式一：CLI 写入（推荐）

方式二：手动编辑配置文件

方式三：环境变量（适合 CI/CD）

3. 验证配置

配置

环境变量

JSON 输出规范

架构

Roadmap

开发

License

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 4

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages