wechat-publisher-yashu by steelan9199/wechat-publisher
npx skills add https://github.com/steelan9199/wechat-publisher --skill wechat-publisher-yashu将本地 Markdown 文章一键发布到微信公众号草稿箱。
如果默认配置发布失败,或用户想使用自己的公众号,指导用户按以下步骤获取:
前往控制台我的业务/公众号基础信息下方就能看到"AppID"开发秘钥下方就能看到"AppSecret"根据用户需求执行不同的操作流程:
当用户说"我要预览主题"或类似表达时:
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
当用户需要将 Markdown 文章发布到微信公众号时,按以下步骤执行:
确保环境满足要求:
Node.js >= 20.20.1
安装依赖(已安装时会快速跳过)
npm install --prefix "C:/Users/YourName/.qoder/skills/wechat-publisher-yashu"
npm install --prefix "/Users/yourname/.qoder/skills/wechat-publisher-yashu"
向用户确认以下配置信息:
| 字段键名 (Key) | 必填 | 参数说明 |
|---|---|---|
markdownFilePath | 是 | Markdown 文件路径 。本地要发布的文章文件绝对路径。 |
APP_ID | 否 | 微信 AppID 。微信开发者平台的 AppID。 |
APP_SECRET | 否 | 微信 AppSecret 。微信开发者平台的 AppSecret。 |
AUTHOR | 否 | 文章作者名称 。在公众号文章中显示的作者名。 |
coverFilePath | 否 | 封面图片路径 。文章封面的本地文件路径。 |
title | 否 | 文章标题 。未指定时默认使用文件名作为标题。 |
theme | 否 | 渲染主题 。使用 themes 目录下的主题文件(默认使用蓝色主题)。 |
prefix | 否 | 文章前缀 。见下方[配置生成]中的决策逻辑 。用户未指定时严禁自行发挥。 |
suffix | 否 | 文章后缀 。见下方[配置生成]中的决策逻辑 。用户未指定时严禁自行发挥。 |
所有可选参数均有默认值(来自
config.default.json),用户不提供时自动使用默认值。
生成逻辑:
读取本地 config.default.json 内容。
将 markdownFilePath 更新为用户提供的文章路径。
参数填充决策树(核心逻辑) : 针对 prefix (前缀) 和 suffix (后缀) 以及其他可选参数,必须 严格执行以下判断流程:
config.json 中 "prefix": "大家好"。config.default.json 中的原始值,不 做任何修改或生成。config.default.json 中已有的默认值。将 config.default.json 中的相对路径转换为绝对路径(<技能目录绝对路径> + 文件名)。
写入config.json。
⚠️ 关键格式说明:
在生成 JSON 内容时,严禁 对prefix 和 suffix 字段的值进行二次转义. 举例说明: 假设用户提供的prefix是"我是文章的前缀\n"
"prefix": "我是文章的前缀\n""prefix": "我是文章的前缀\\n"路径格式说明:
配置文件中的路径必须统一使用正斜杠 /:
"D:/software/wechat-publisher-yashu/cover.jpg""D:\\software\\wechat-publisher-yashu\\cover.jpg"config.json 示例:
{
"markdownFilePath": "D:/Documents/公众号教程/文章.md",
"title": "文章标题",
"theme": "blue",
"AUTHOR": "文章作者名称",
"prefix": "(此处应是用户指定的内容,或 config.default.json 的原值)",
"suffix": "(此处应是用户指定的内容,或 config.default.json 的原值)",
"APP_ID": "微信开发者平台的APP_ID",
"APP_SECRET": "微信开发者平台的APP_SECRET",
"coverFilePath": "D:/software/wechat-publisher-yashu/cover.jpg"
}
发布失败时的配置处理:
如果发布返回 invalid appid 或 invalid appsecret 错误,提示用户提供正确的 APP_ID 和 APP_SECRET,更新 config.json 后重新发布。
重要提示:
markdownFilePath 指向的文件路径正确即可⚠️ 重要:必须通过 config.json 文件传递参数,不要直接在命令行传递 --file/--app-id/--app-secret 等参数!
注意:终端只传递 --config 参数,指向生成的 config.json 文件。
⚠️ 必须使用绝对路径执行命令 (避免 Windows 跨盘符切换目录失败):
# 将 <技能目录> 替换为实际路径
node "<技能目录>/index.js" --config "<技能目录>/config.json"
# Windows 示例
node "C:/Users/YourName/.qoder/skills/wechat-publisher-yashu/index.js" --config "C:/Users/YourName/.qoder/skills/wechat-publisher-yashu/config.json"
# Mac/Linux 示例
node "/Users/yourname/.qoder/skills/wechat-publisher-yashu/index.js" --config "/Users/yourname/.qoder/skills/wechat-publisher-yashu/config.json"
❌ 错误示例(不要这样做):
# 相对路径在 Windows 跨盘符时可能失败
node index.js --config ./config.json
# 不要直接传递参数
node index.js --file xxx.md --app-id xxx --app-secret xxx
向用户报告发布结果:
电脑 IP 不在公众号 IP 白名单中
ipinvalid appsecret :AppSecret 已被重置或输入错误
invalid appid :AppID 输入错误
在 Windows 环境下更新 config.json 时,可能会遇到以下问题:
| 问题 | 原因 | 解决方案 |
|---|---|---|
Access denied | 尝试直接写入技能目录下的文件,超出工作目录权限 | 使用 Node.js 脚本间接写入 |
| 中文/特殊字符转义错误 | 命令行解析中文标题、问号等字符时出错 | 使用临时 JS 脚本文件避免命令行转义 |
| 引号嵌套问题 | PowerShell 或 CMD 中引号嵌套导致解析失败 | 使用 JS 文件存储配置对象 |
方法:使用临时 Node.js 脚本
在技能目录下创建临时脚本 update-config.js,然后通过 Node.js 执行:
// update-config.mjs
import { writeFileSync } from "fs";
const config = {
markdownFilePath: "Markdown文件的绝对路径",
title: "文章标题",
AUTHOR: "作者名称",
prefix: "文章前缀\n",
suffix: "文章后缀\n",
APP_ID: "你的AppID",
APP_SECRET: "你的AppSecret",
coverFilePath: "封面图片的绝对路径",
theme: "主题名称(如:blue)",
};
writeFileSync("技能目录/config.json", JSON.stringify(config, null, 2));
console.log("Config updated successfully");
执行命令:
node "update-config.js的绝对路径"
优势:
?)的转义问题图片格式 :支持 JPG、PNG
图片位置 :markdown 文章中的图片必须与 markdown 文件在同一目录
图片引用格式 :支持标准 markdown 图片语法,如 
聊天格式 :支持一左一右的气泡对话格式
示例:
>L: 左侧对话内容
>R: 右侧对话内容
>L: 又一句左侧内容
>R: 又一句右侧内容
5. 禁止行为 :
* 严禁读取 `wechat-publisher-yashu` 目录下的 `index.js` 文件(约 82KB),该代码已经加密混淆
* 严禁从文章内容中自动提取图片作为封面
当用户需要预览主题效果时,请直接提供在线预览链接:
🔗 主题预览地址 :https://5g6pxtj3zg.coze.site/
该网站使用一个固定的包含各种元素的 markdown 文章来展示不同主题的实际效果,方便用户选择合适的文章渲染风格。
主题文件在技能的themes文件夹中, 一共 17 个json主题文件,
用户可以随意修改, 或者让 AI 生成新的主题文件, 数据结构与已有主题文件保持一致即可.
系统提供 17 种文章渲染主题,每种主题都有独特的视觉风格:
Weekly Installs
116
Repository
GitHub Stars
3
First Seen
Feb 21, 2026
Security Audits
Installed on
gemini-cli113
github-copilot113
codex113
opencode113
kimi-cli112
amp112
GitHub Actions 官方文档查询助手 - 精准解答 CI/CD 工作流问题
43,400 周安装