偏好设置 (EXTEND.md)

使用 Bash 检查 EXTEND.md 是否存在（优先级顺序）：

# 首先检查项目级
test -f .canghe-skills/canghe-post-to-wechat/EXTEND.md && echo "project"

# 然后检查用户级（跨平台：$HOME 在 macOS/Linux/WSL 上有效）
test -f "$HOME/.canghe-skills/canghe-post-to-wechat/EXTEND.md" && echo "user"

┌────────────────────────────────────────────────────────┬───────────────────┐ │ 路径 │ 位置 │ ├────────────────────────────────────────────────────────┼───────────────────┤ │ .canghe-skills/canghe-post-to-wechat/EXTEND.md │ 项目目录 │ ├────────────────────────────────────────────────────────┼───────────────────┤ │ $HOME/.canghe-skills/canghe-post-to-wechat/EXTEND.md │ 用户主目录 │ └────────────────────────────────────────────────────────┴───────────────────┘

┌───────────┬───────────────────────────────────────────────────────────────────────────┐ │ 结果 │ 操作 │ ├───────────┼───────────────────────────────────────────────────────────────────────────┤ │ 找到 │ 读取、解析、应用设置 │ ├───────────┼───────────────────────────────────────────────────────────────────────────┤ │ 未找到 │ 运行首次设置 (references/config/first-time-setup.md) → 保存 → 继续 │ └───────────┴───────────────────────────────────────────────────────────────────────────┘

EXTEND.md 支持：默认主题 | 默认发布方法 (api/browser) | 默认作者 | 默认开启评论开关 | 默认仅粉丝可评论开关 | Chrome 配置文件路径

首次设置：references/config/first-time-setup.md

最低支持键（不区分大小写，接受 1/0 或 true/false）：

推荐的 EXTEND.md 示例：

default_theme: default
default_publish_method: api
default_author: 苍何
need_open_comment: 1
only_fans_can_comment: 0
chrome_profile_path: /path/to/chrome/profile

值优先级：

1. CLI 参数
2. 前置元数据
3. EXTEND.md
4. 技能默认值

预检检查（可选）

首次使用前，建议运行环境检查。用户可以选择跳过。

npx -y bun ${SKILL_DIR}/scripts/check-permissions.ts

检查项：Chrome、配置文件隔离、Bun、辅助功能、剪贴板、粘贴按键、API 凭据、Chrome 冲突。

如果任何检查失败，根据项目提供修复指导：

图文消息发布

适用于带有多张图片（最多 9 张）的短消息：

npx -y bun ${SKILL_DIR}/scripts/wechat-browser.ts --markdown article.md --images ./images/
npx -y bun ${SKILL_DIR}/scripts/wechat-browser.ts --title "标题" --content "内容" --image img.png --submit

详情请参阅 references/image-text-posting.md。

文章发布工作流程

复制此清单，并在完成项目时勾选：

发布进度：
- [ ] 步骤 0：加载偏好设置 (EXTEND.md)
- [ ] 步骤 1：确定输入类型
- [ ] 步骤 2：检查 markdown-to-html 技能
- [ ] 步骤 3：转换为 HTML
- [ ] 步骤 4：验证元数据（标题、摘要、封面）
- [ ] 步骤 5：选择方法并配置凭据
- [ ] 步骤 6：发布到微信
- [ ] 步骤 7：报告完成情况

步骤 0：加载偏好设置

检查并加载 EXTEND.md 设置（参见上文的偏好设置部分）。

关键：如果未找到，请在执行任何其他步骤或提问之前完成首次设置。

解析并存储这些默认值以供后续步骤使用：

• default_author
• need_open_comment (默认 1)
• only_fans_can_comment (默认 0)

步骤 1：确定输入类型

纯文本处理：

1. 从内容生成 slug（前 2-4 个有意义的单词，kebab-case）
2. 创建目录并保存文件：

mkdir -p "$(pwd)/post-to-wechat/$(date +%Y-%m-%d)"

# 保存内容到：post-to-wechat/yyyy-MM-dd/[slug].md

3. 继续作为 markdown 文件处理

Slug 示例：

• "Understanding AI Models" → understanding-ai-models
• "人工智能的未来" → ai-future (为 slug 翻译成英文)

步骤 2：检查 Markdown 转 HTML 技能

跳过条件：输入是 .html 文件

技能发现：

# 检查 canghe-markdown-to-html 是否存在
test -f skills/canghe-markdown-to-html/SKILL.md && echo "found"

当未找到时：

未找到 markdown-to-html 技能。

建议安装：
https://github.com/JimLiu/canghe-skills/blob/main/skills/canghe-markdown-to-html/SKILL.md

选项：
A) 取消 - 先安装该技能
B) 继续 - 手动提供 HTML 文件

步骤 3：将 Markdown 转换为 HTML

跳过条件：输入是 .html 文件

1. 询问主题偏好（除非在 EXTEND.md 或 CLI 中指定）：

1. 执行转换（使用发现的技能）：

npx -y bun ${MD_TO_HTML_SKILL_DIR}/scripts/main.ts <markdown_file> --theme <theme>

1. 解析 JSON 输出 以获取：htmlPath, title, author, summary, contentImages

步骤 4：验证元数据

检查从步骤 3 提取的元数据（或直接 HTML 输入的 HTML 元标签）。

自动生成逻辑：

• 标题：第一个 H1/H2 标题，或第一句话
• 摘要：第一段，截断至 120 个字符

封面图片检查（article_type=news 必需）：

1. 如果提供了 CLI --cover 则使用。
2. 否则使用前置元数据 (coverImage, featureImage, cover, image)。
3. 否则检查文章目录默认路径：imgs/cover.png。
4. 否则回退到第一个内联内容图片。
5. 如果仍然缺失，停止并在发布前请求封面图片。

步骤 5：选择发布方法并配置

询问发布方法（除非在 EXTEND.md 或 CLI 中指定）：

如果选择 API - 检查凭据：

# 检查项目级
test -f .canghe-skills/.env && grep -q "WECHAT_APP_ID" .canghe-skills/.env && echo "project"

# 检查用户级
test -f "$HOME/.canghe-skills/.env" && grep -q "WECHAT_APP_ID" "$HOME/.canghe-skills/.env" && echo "user"

如果凭据缺失 - 引导设置：

未找到微信 API 凭据。

获取凭据：
1. 访问 https://mp.weixin.qq.com
2. 转到：开发 → 基本配置
3. 复制 AppID 和 AppSecret

保存到哪里？
A) 项目级：.canghe-skills/.env (仅限此项目)
B) 用户级：~/.canghe-skills/.env (所有项目)

选择位置后，提示输入值并写入 .env：

WECHAT_APP_ID=<用户输入>
WECHAT_APP_SECRET=<用户输入>

步骤 6：发布到微信

API 方法：

npx -y bun ${SKILL_DIR}/scripts/wechat-api.ts <html_file> [--title <title>] [--summary <summary>] [--author <author>] [--cover <cover_path>]

draft/add 载荷规则：

• 使用端点：POST https://api.weixin.qq.com/cgi-bin/draft/add?access_token=ACCESS_TOKEN
• article_type：news (默认) 或 newspic
• 对于 news，包含 thumb_media_id (封面是必需的)
• 始终解析并发送：
  • need_open_comment (默认 1)
  • only_fans_can_comment (默认 0)
• author 解析：CLI --author → 前置元数据 author → EXTEND.md default_author

如果脚本参数未暴露两个评论字段，仍要确保最终的 API 请求体包含解析后的值。

浏览器方法：

npx -y bun ${SKILL_DIR}/scripts/wechat-article.ts --html <html_file>

步骤 7：完成报告

对于 API 方法，包含草稿管理链接：

微信发布完成！

输入：[类型] - [路径]
方法：API
主题：[主题名称]

文章：
• 标题：[标题]
• 摘要：[摘要]
• 图片：[N] 张内联图片
• 评论：[开启/关闭]，[仅粉丝/所有用户]

结果：
✓ 草稿已保存到微信公众号
• media_id：[media_id]

后续步骤：
→ 管理草稿：https://mp.weixin.qq.com (登录后进入「内容管理」→「草稿箱」)

创建的文件：
[• post-to-wechat/yyyy-MM-dd/slug.md (如果是纯文本)]
[• slug.html (已转换)]

对于浏览器方法：

微信发布完成！

输入：[类型] - [路径]
方法：浏览器
主题：[主题名称]

文章：
• 标题：[标题]
• 摘要：[摘要]
• 图片：[N] 张内联图片

结果：
✓ 草稿已保存到微信公众号

创建的文件：
[• post-to-wechat/yyyy-MM-dd/slug.md (如果是纯文本)]
[• slug.html (已转换)]

详细参考

功能对比

先决条件

对于 API 方法：

• 微信公众号 API 凭据
• 步骤 5 中的引导设置，或手动在 .canghe-skills/.env 中设置

对于浏览器方法：

• Google Chrome
• 首次运行：登录微信公众号（会话会保留）

对于 Markdown 转换：

• 一个 markdown-to-html 技能（例如 canghe-markdown-to-html）
• 如果未安装，工作流程将建议安装

配置文件位置（优先级顺序）：

1. 环境变量
2. <cwd>/.canghe-skills/.env
3. ~/.canghe-skills/.env

故障排除

扩展支持

通过 EXTEND.md 进行自定义配置。有关路径和支持的选项，请参阅偏好设置部分。

每周安装次数

103

仓库

freestylefly/ca…e-skills

GitHub 星标数

182

首次出现

2026 年 2 月 24 日

安全审计

Gen Agent Trust HubPassSocketFailSnykFail

安装于

github-copilot102

gemini-cli102

codex102

kimi-cli102

cursor102

opencode102