文颜 CLI 文档中心
欢迎使用 文颜 CLI (Wenyan CLI) 官方文档。本项目是文颜核心能力的命令行封装，旨在为开发者和高级用户提供最灵活、最强大的发布能力。
快速索引
1. 入门指南
2. 核心功能文档
- 发布命令 (Publish) - 深入了解本地发布、远程发布及参数说明。
- 主题管理 (Theme) - 如何查看内置主题、使用自定义 CSS。
- 凭据管理 (Credential) - 管理多个公众号账号。
- 素材处理 - 图片路径解析规则与封面设置。
3. 进阶玩法
- 外部 Token 导入 - 在多系统共用公众号时如何接入。
- 发布“小绿书” - 快速发布多图片消息格式。
- CI/CD 集成 - 如何通过管道或 URL 进行自动化分发。
架构与部署
文颜 CLI 支持两种运行模式，以适应不同的网络环境：
本地模式 (Local Mode)
直接在本地终端调用微信 API。简单快速，但需要本地固定 IP 并加入白名单。
客户端模式 (Client-Server Mode)
将 CLI 作为客户端，连接到部署在云端的 Wenyan Server。
- Server 部署指南 - 快速启动 Express 服务端。
- Docker 部署 - 使用容器一键化部署环境。
命令参考
| 命令 | 核心用途 | 文档链接 |
|---|---|---|
publish | 发布文章至公众号/平台 | 详细说明 |
render | 渲染 Markdown 为 HTML | - |
theme | 管理和应用排版样式 | 详细说明 |
credential | 维护公众号访问凭据 | 详细说明 |
serve | 启动远程发布服务端 | 详细说明 |
常见问题 (FAQ)
- 图片上传失败？ 检查本地路径是否正确，或 IP 是否在白名单。
- 样式不生效？ 确保引用的主题名称正确，或检查自定义 CSS 语法。
- 如何同时发往多个号？ 参考多公众号发布。
💡 提示： 本文档随项目持续更新。如遇问题，请查阅 GitHub Issues。