@lexiaowen/md2wechat-new 0.1.0

package/LICENSE

@@ -0,0 +1,236 @@
+md2wechat Source Available License
+Based on Business Source License 1.1
+
+===========================================================
+PARAMETERS
+===========================================================
+
+Licensor:             geekjourneyx
+
+Licensed Work:        md2wechat
+                      The Licensed Work is (c) 2024-2026 geekjourneyx.
+                      "Licensed Work" includes the CLI source code, themes,
+                      layout modules, prompt templates, skill definitions,
+                      and all associated documentation and assets in this
+                      repository.
+
+Additional Use Grant: You may make production use of the Licensed Work
+                      solely for the following Personal Non-Commercial
+                      Purposes, free of charge and without further
+                      authorization:
+
+                      (a) Individual content creation: creating and
+                          publishing articles, posts, or media for your own
+                          personal WeChat Official Account, social media,
+                          blogs, or other personal channels, provided you
+                          do not receive direct commercial compensation for
+                          that specific content. Passive income such as
+                          platform advertising revenue shares (e.g., WeChat
+                          Traffic Owner program) does not constitute direct
+                          commercial compensation under this clause.
+
+                      (b) Learning and research: reading, modifying, or
+                          adapting the Licensed Work for your own
+                          understanding or for academic/educational purposes.
+
+                      (c) Evaluation: testing and evaluating the Licensed
+                          Work for your own non-commercial assessment.
+
+                      (d) Non-profit use: use by registered non-profit
+                          organizations for non-commercial activities.
+
+                      (e) Contributions: submitting modifications,
+                          improvements, or bug fixes back to this project.
+
+                      Any use not listed above — including any Commercial
+                      Purpose as defined below — requires a separate written
+                      commercial license from the Licensor.
+
+                      "Commercial Purpose" means:
+
+                      (i)   offering the Licensed Work, or any product or
+                            service substantially derived from or powered by
+                            the Licensed Work (including its themes, layout
+                            modules, or prompt templates), to third parties
+                            for a fee or other commercial consideration;
+
+                      (ii)  using the Licensed Work internally within any
+                            for-profit organization in connection with
+                            revenue-generating activities;
+
+                      (iii) incorporating the Licensed Work or its assets
+                            (themes, layout modules, prompt templates) into
+                            any paid software product, paid template, paid
+                            subscription service, paid training course, or
+                            paid private community;
+
+                      (iv)  using the Licensed Work to deliver services to
+                            paying clients (design, formatting, publishing,
+                            consulting, or similar services);
+
+                      (v)   rebranding, white-labeling, or redistributing
+                            the Licensed Work or any substantially similar
+                            product under a different name or brand, whether
+                            or not the underlying code is modified, for any
+                            commercial purpose;
+
+                      (vi)  using the Licensed Work, its documentation,
+                            prompt templates, layout module definitions, or
+                            theme assets as training data or fine-tuning
+                            data for any machine learning or artificial
+                            intelligence model intended for commercial use.
+
+Change Date:          2030-01-01
+
+Change License:       Apache License, Version 2.0
+
+Commercial Licensing: For commercial use authorization, please contact:
+                      Email:   skrphper@gmail.com
+                      Website: https://jieni.ai
+                      X:       https://x.com/seekjourney
+                      WeChat:  search "极客杰尼", leave a message stating
+                               "商业授权 / Commercial License"
+
+===========================================================
+NOTICE
+===========================================================
+
+Business Source License 1.1
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+This License does not grant you any right in any trademark, logo, or trade
+name of the Licensor or its affiliates, including "md2wechat" and "极客杰尼".
+
+===========================================================
+TERMS
+===========================================================
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first
+publicly available distribution of a specific version of the Licensed Work
+under this License, whichever comes first, the Licensor hereby grants you
+rights under the terms of the Change License, and the rights granted in the
+paragraph above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may
+vary for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified
+copy of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+===========================================================
+中文说明（Chinese Summary）
+===========================================================
+
+本许可证基于 Business Source License 1.1（BUSL-1.1），并附加个人使用扩展条款。
+如本中文说明与上方英文条款存在歧义，以英文条款为准。
+
+本作品（"Licensed Work"）包含 md2wechat 的 CLI 源代码、主题、高级排版模块、
+Prompt 模板、Skill 定义，及本仓库中全部相关文档与资产。
+
+版权所有 © 2024–2026 geekjourneyx
+
+─────────────────────────────────────────
+一、允许的使用（个人免费，无需授权）
+─────────────────────────────────────────
+
+以下场景无需申请授权，可免费使用：
+
+  • 个人内容创作：将 md2wechat 用于为自己的微信公众号、小红书、B站、
+    YouTube、个人博客等渠道创作内容，前提是该内容不直接产生商业收益。
+    注：通过微信流量主、平台创作者激励计划获得的广告分成或打赏收入，
+    视为非直接商业报酬，个人创作者可免费使用。若账号以企业或品牌名义
+    运营并产生直接商业收益，则属于商业用途，须获得授权。
+
+  • 学习与研究：阅读源码、修改代码用于自我学习，或用于学术/教育目的。
+
+  • 评估与测试：非商业目的的功能体验和测试。
+
+  • 非营利组织：已登记注册的非营利组织用于非商业活动。
+
+  • 贡献代码：向本项目提交修改、改进或 Bug 修复。
+
+─────────────────────────────────────────
+二、禁止的使用（须事先获得书面商业授权）
+─────────────────────────────────────────
+
+以下场景属于商业用途，未经授权不得使用：
+
+  • 将本作品（或基于本作品的主题、排版模块、Prompt 模板等衍生成果）作为
+    产品或服务对第三方收费提供；
+
+  • 在任何营利性组织中将本作品用于与商业运营直接相关的内部工作流；
+
+  • 基于本作品构建付费软件产品、付费模板、付费订阅服务、付费培训课程或
+    付费私享社群；
+
+  • 使用本作品为付费客户提供设计、排版、发布等交付服务（外包、咨询等）；
+
+  • 对本作品进行改名（Rebrand）、贴牌（White-label）或以不同品牌名义
+    重新分发，无论底层代码是否经过修改，均须获得商业授权；
+
+  • 将本作品的源代码、文档、Prompt 模板、排版模块定义或主题资产用作任何
+    以商业为目的的机器学习或人工智能模型的训练数据或微调数据。
+
+违反以上任一条款，即视为侵权，将自动终止你在本许可证下的全部权利。
+
+─────────────────────────────────────────
+三、自动开源日期（Change Date）
+─────────────────────────────────────────
+
+2030 年 1 月 1 日之后，本作品各版本将自动以 Apache License 2.0 授权发布。
+在此日期之前，上述商业用途限制持续有效。
+
+─────────────────────────────────────────
+四、商业授权联系方式
+─────────────────────────────────────────
+
+如需获得商业授权，请通过以下任一方式联系作者：
+
+  邮件：skrphper@gmail.com
+  官网：https://jieni.ai
+  X / Twitter：https://x.com/seekjourney
+  微信公众号：极客杰尼（搜索「极客杰尼」，留言备注「商业授权」）
+
+─────────────────────────────────────────
+五、关于历史版本
+─────────────────────────────────────────
+
+本项目在此许可证生效前的历史版本以 MIT 许可证发布，该授权不受本许可证
+影响。本许可证自其生效提交（commit）起，适用于所有后续版本。
+
+─────────────────────────────────────────
+六、免责声明
+─────────────────────────────────────────
+
+本作品按「现状」提供，不附带任何明示或默示担保。作者不对因使用本作品
+造成的任何直接或间接损失承担责任。

package/README.md

@@ -0,0 +1,279 @@
+# md2wechat-new
+
+`md2wechat-new` 是一个面向微信公众号创作和发布的命令行工具。它把 Markdown 转成适合微信公众号编辑器的 HTML，支持本地预览、图片上传、草稿创建、已有 HTML 上传，以及通过可配置的 OpenAI-compatible 文本 API 进行排版转换。
+
+这个分支保留原项目的 AI 模式，同时把旧的固定 API 服务替换为可配置 provider：
+
+- OpenAI
+- DeepSeek
+- 硅基流动 SiliconFlow
+- 任意 OpenAI-compatible API
+
+## 功能概览
+
+| 能力 | 说明 |
+| --- | --- |
+| Markdown 转微信 HTML | `convert` 支持 API 模式和 AI 模式 |
+| 可配置文本 API | 通过配置文件或环境变量切换 OpenAI、DeepSeek、SiliconFlow、custom |
+| 本地预览 | `preview` 或 `convert --preview`，不上传图片、不创建草稿 |
+| 微信草稿箱 | `convert --draft` 可转换后直接创建草稿 |
+| 已有 HTML 上传 | `upload_html` 可把转换好的 HTML 直接创建为微信草稿 |
+| 图片素材上传 | `upload_image`、`download_and_upload`、`--upload` |
+| AI 图片 | `generate_cover`、`generate_infographic`、`generate_image` |
+| 写作辅助 | `write`、`humanize` |
+| Agent 友好 | `--json`、`capabilities`、`themes`、`providers`、`layout` |
+
+## 快速开始
+
+### 1. 本地构建
+
+```bash
+cd /Users/leo/Desktop/project/md2wechat-new
+go build -o md2wechat ./cmd/md2wechat
+./md2wechat version --json
+```
+
+如果你已经发布 npm 包，也可以安装：
+
+```bash
+npm install -g @lexiaowen/md2wechat-new
+md2wechat version --json
+```
+
+npm 包安装时会从 GitHub Release 下载二进制。正式给别人使用前，需要先发布对应版本的 GitHub Release 资产。
+
+发布 Release 后，也可以用固定版本安装脚本：
+
+```bash
+curl -fsSL https://github.com/LeXiaoWen/md2wechat-new/releases/download/v0.1.0/install.sh | bash
+```
+
+macOS 用户如果维护了 Homebrew tap，也可以安装：
+
+```bash
+brew install lexiaowenn/tap/md2wechat-new
+```
+
+### 2. 初始化配置
+
+```bash
+./md2wechat config init
+```
+
+默认生成：
+
+```text
+~/.config/md2wechat-new/config.yaml
+```
+
+如果文件已存在，直接编辑它即可。
+
+### 3. 配置文本 API
+
+DeepSeek 示例：
+
+```yaml
+api:
+  convert_mode: "api"
+  default_theme: "default"
+  text_provider: "deepseek"
+  text_key: "sk-..."
+  text_base_url: "https://api.deepseek.com"
+  text_model: "deepseek-chat"
+  text_temperature: 0.2
+```
+
+硅基流动示例：
+
+```yaml
+api:
+  convert_mode: "api"
+  default_theme: "default"
+  text_provider: "siliconflow"
+  text_key: "sk-..."
+  text_base_url: "https://api.siliconflow.cn/v1"
+  text_model: "Qwen/Qwen2.5-72B-Instruct"
+  text_temperature: 0.2
+```
+
+OpenAI 示例：
+
+```yaml
+api:
+  convert_mode: "api"
+  default_theme: "default"
+  text_provider: "openai"
+  text_key: "sk-..."
+  text_base_url: "https://api.openai.com/v1"
+  text_model: "gpt-4.1-mini"
+  text_temperature: 0.2
+```
+
+### 4. 配置微信公众号
+
+如果要上传图片或创建草稿，还需要配置：
+
+```yaml
+wechat:
+  appid: "你的微信公众号 AppID"
+  secret: "你的微信公众号 AppSecret"
+```
+
+并在微信公众号后台把当前机器公网 IP 加入 IP 白名单。详细说明见 [docs/WECHAT-CREDENTIALS.md](docs/WECHAT-CREDENTIALS.md)。
+
+### 5. 转换文章
+
+```bash
+./md2wechat inspect article.md
+./md2wechat convert article.md --preview
+./md2wechat convert article.md -o output.html
+```
+
+安装到 PATH 后，通用命令写法是：
+
+```bash
+md2wechat inspect article.md
+md2wechat preview article.md
+md2wechat convert article.md --preview
+```
+
+创建微信草稿：
+
+```bash
+./md2wechat convert article.md --draft --cover cover.jpg
+```
+
+已有 HTML 直接上传：
+
+```bash
+./md2wechat upload_html output.html --title "文章标题" --cover cover.jpg
+```
+
+## 转换模式
+
+### API 模式
+
+默认模式。CLI 会调用你配置的 OpenAI-compatible `/chat/completions` 接口，把 Markdown 转成最终 HTML。
+
+```bash
+./md2wechat convert article.md --mode api -o output.html
+```
+
+特点：
+
+- 需要 `TEXT_API_KEY` 或配置文件中的 `api.text_key`
+- 支持 OpenAI、DeepSeek、SiliconFlow、custom
+- 适合稳定、自动化、本地批处理
+- 可直接配合 `--draft` 创建微信草稿
+
+### AI 模式
+
+AI 模式不会调用文本 API，而是生成可交给外部 AI/Agent 的排版提示和结构化输出。
+
+```bash
+./md2wechat convert article.md --mode ai --theme autumn-warm --json
+```
+
+适合你想让 Claude、Codex 或其他 Agent 接管 HTML 生成的场景。
+
+## 常用命令
+
+```bash
+# 查看当前配置
+./md2wechat config show --format json
+
+# 校验配置
+./md2wechat config validate
+
+# 检查文章 metadata 和发布风险
+./md2wechat inspect article.md --json
+
+# 本地预览
+./md2wechat preview article.md
+
+# 转换为 HTML
+./md2wechat convert article.md -o output.html
+
+# 上传图片并替换 HTML 图片链接
+./md2wechat convert article.md --upload -o output.html
+
+# 转换并创建微信草稿
+./md2wechat convert article.md --draft --cover cover.jpg
+
+# 已有 HTML 创建草稿
+./md2wechat upload_html output.html --title "标题" --author "作者" --digest "摘要" --cover cover.jpg
+
+# 上传单张图片到微信永久素材
+./md2wechat upload_image cover.jpg
+
+# 发现可用主题、图片 provider、能力
+./md2wechat themes list --json
+./md2wechat providers list --json
+./md2wechat capabilities --json
+```
+
+## 配置优先级
+
+从高到低：
+
+1. 环境变量
+2. 配置文件
+3. 默认值
+
+默认配置文件搜索顺序：
+
+1. `~/.config/md2wechat-new/config.yaml`
+2. `~/.md2wechat.yaml`
+3. `./md2wechat-new.yaml`
+
+常用环境变量：
+
+```bash
+export TEXT_PROVIDER="deepseek"
+export TEXT_API_KEY="sk-..."
+export TEXT_API_BASE="https://api.deepseek.com"
+export TEXT_MODEL="deepseek-chat"
+export TEXT_TEMPERATURE="0.2"
+
+export WECHAT_APPID="..."
+export WECHAT_SECRET="..."
+```
+
+## 文档入口
+
+- [文档索引](docs/README.md)
+- [新手快速开始](docs/QUICKSTART.md)
+- [安装指南](docs/INSTALL.md)
+- [配置指南](docs/CONFIG.md)
+- [完整使用指南](docs/USAGE.md)
+- [本地初始化到微信公众号草稿全流程](docs/LOCAL_TO_WECHAT_GUIDE.md)
+- [微信凭证与 IP 白名单](docs/WECHAT-CREDENTIALS.md)
+- [高级排版模块](docs/LAYOUT.md)
+- [故障排查](docs/TROUBLESHOOTING.md)
+
+## 发布 npm 包
+
+当前 npm 包名：
+
+```text
+@lexiaowen/md2wechat-new
+```
+
+本地发布：
+
+```bash
+npm login
+npm publish --access public --otp=你的6位验证码
+```
+
+发布后安装：
+
+```bash
+npm install -g @lexiaowen/md2wechat-new
+```
+
+注意：npm 包的 `postinstall` 会下载 GitHub Release 里的二进制文件。发布 npm 前，应先推送 GitHub 仓库并创建同版本 Release。
+
+## License
+
+See [LICENSE](LICENSE).

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@lexiaowen/md2wechat-new",
+  "version": "0.1.0",
+  "description": "Configurable-provider fork of the md2wechat CLI.",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LeXiaoWen/md2wechat-new.git"
+  },
+  "homepage": "https://github.com/LeXiaoWen/md2wechat-new#readme",
+  "bugs": {
+    "url": "https://github.com/LeXiaoWen/md2wechat-new/issues"
+  },
+  "bin": {
+    "md2wechat": "scripts/run.js"
+  },
+  "scripts": {
+    "pack:check": "npm pack --json --dry-run",
+    "postinstall": "node scripts/install.js"
+  },
+  "files": [
+    "scripts/install.js",
+    "scripts/run.js",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}