ghostwriter-cli 0.1.0__tar.gz

ghostwriter_cli-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,21 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+      - run: pip install -e ".[dev]"
+      - run: python -m pytest tests/ -v
+      - run: pip install build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

ghostwriter_cli-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+__pycache__/
+config.json
+*.pyc
+dist/
+*.egg-info/
+.pytest_cache/

ghostwriter_cli-0.1.0/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## 0.1.0 (2025-06-17)
+
+- Initial PyPI release.
+- Markdown → Ghost Lexical publishing.
+- Ghost → WeChat draft sync with HTML processing pipeline.
+- CLI: `list`, `publish`, sync, and `--preview` commands.

ghostwriter_cli-0.1.0/CLAUDE.md

@@ -0,0 +1,113 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project overview
+
+ghostwriter is a Python CLI that implements a **Markdown → Ghost → WeChat** publishing pipeline. Write Markdown, publish to a Ghost blog, and sync to a WeChat Official Account draft.
+
+## Commands
+
+```bash
+# Install (from PyPI)
+pip install ghostwriter-cli
+
+# Install (editable, with dev deps)
+pip install -e ".[dev]"
+
+# Run tests
+python -m pytest tests/ -v
+
+# CLI
+ghostwriter list                              # list Ghost posts
+ghostwriter publish article.md                # publish Markdown to Ghost
+ghostwriter publish article.md --draft --wechat
+ghostwriter <article-id>                      # sync Ghost→WeChat
+ghostwriter --preview <article-id>            # preview HTML, no draft
+ghostwriter config                            # show config (secrets masked)
+ghostwriter config set <key> <value>          # write config key
+ghostwriter config path                       # print config file path
+```
+
+## Configuration architecture
+
+Two-tier system, env vars take priority:
+
+1. **Environment variables** (primary, CI/Docker):
+   `GHOSTWRITER_GHOST_API_URL`, `GHOSTWRITER_GHOST_ADMIN_KEY_ID`,
+   `GHOSTWRITER_GHOST_ADMIN_KEY`, `GHOSTWRITER_WECHAT_APPID`,
+   `GHOSTWRITER_WECHAT_SECRET`
+
+2. **Config file** (fallback): `~/.config/ghostwriter/config.json`,
+   managed via `ghostwriter config set <key> <value>`
+
+`load_config()` validates all 5 required keys are present, exits with helpful
+error if any are missing. See `src/ghostwriter/config.py`.
+
+## Package structure
+
+```
+src/ghostwriter/
+├── __init__.py     # public API re-exports
+├── __main__.py     # python -m ghostwriter
+├── cli.py          # CLI dispatch: main(), sync_article, publish_md_to_ghost, _cmd_publish
+├── config.py       # load_config(), set_config_value(), show_config()
+├── ghost.py        # Ghost Admin API: JWT auth, CRUD, image upload, author lookup
+├── wechat.py       # WeChat API: token cache, material upload, draft creation
+├── cleaner.py      # _WeChatCleaner HTML parser + whitelists + clean_html_for_wechat
+├── pipeline.py     # process_html() + 14 transform stages (hr, table, links, lists, etc.)
+├── lexical.py      # md_to_ghost_lexical(): Markdown → Ghost Lexical JSON
+└── normalize.py    # normalize_title(): Unicode → ASCII for WeChat compatibility
+```
+
+## Architecture
+
+### 1. Ghost API layer (`ghost.py`)
+JWT auth (`get_ghost_token`) → generic `_api_request` helper used by
+`ghost_api_get/post/put/delete`. All Admin API calls go through path
+normalization: `{api_url.rstrip('/')}/{path.lstrip('/')}`.
+`upload_image_to_ghost` and `get_ghost_authors` build their own URLs (Content API).
+
+### 2. WeChat API layer (`wechat.py`)
+Token management with disk cache (`/tmp/wechat_token.json`), permanent
+material upload for images, draft creation. Token is cached until 60s
+before expiry.
+
+### 3. HTML processing pipeline (`pipeline.py`)
+**Core of Ghost→WeChat conversion.** Order is strict — reordering breaks things:
+
+1. Replace image URLs with WeChat CDN URLs
+2. Strip Ghost HTML comments (`<!--kg-card-*-->`)
+3. Convert `<hr>` → styled `<div>` (before whitelist)
+4. Convert `<table>` → inline-block `<span>` layout (before whitelist)
+5. Extract code blocks to placeholders (protect from filter)
+6. Three-level whitelist filter: tags → attributes → CSS properties
+7. Restore code blocks with WeChat-safe `<pre>` styling
+8. Apply default styles (heading sizes, inline code, blockquote)
+9. Flatten nested blockquotes
+10. Paragraph/image spacing
+11. Convert links to `text [url]`
+12. Convert `<ol>` → numbered `<p>`, `<ul>` → bullet `<p>`
+
+Whitelists live in `cleaner.py`: `WECHAT_SAFE_TAGS`, `WECHAT_SAFE_ATTRS`,
+`WECHAT_SAFE_STYLES`.
+
+### 4. Markdown → Ghost Lexical (`lexical.py`)
+Converts Markdown to Ghost Lexical JSON (not mobiledoc). Tables become
+`html` cards. Supports headings, code blocks, lists, hr, inline formatting
+(bold, italic, code, links).
+
+### 5. CLI (`cli.py`)
+Commands: `list`, `publish`, `config`, sync (by article ID or `--preview`).
+`main()` handles dispatch. `sync_article()` is the Ghost→WeChat flow.
+`publish_md_to_ghost()` handles Markdown→Ghost with author lookup fallback.
+
+## Key design decisions
+
+- **Code block protection:** Extracted to `__CODE_BLOCK_PLACEHOLDER__N__` before
+  the whitelist filter, restored afterward. Prevents filter from stripping tags.
+- **Author fallback chain:** Ghost Content API → hardcoded IDs for known slugs.
+- **WeChat constraints:** Author ≤8 bytes, digest ≤120 bytes, titles must not
+  contain Unicode special characters (normalized via `normalize_title()`).
+- **Preview mode skips WeChat:** `--preview` only reads Ghost article and saves
+  HTML to `/tmp`, no WeChat credentials needed.

ghostwriter_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 yinguobing
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ghostwriter_cli-0.1.0/PKG-INFO

@@ -0,0 +1,172 @@
+Metadata-Version: 2.4
+Name: ghostwriter-cli
+Version: 0.1.0
+Summary: Markdown → Ghost → WeChat publishing pipeline
+Project-URL: Homepage, https://github.com/yinguobing/ghostwriter
+Author: yinguobing
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.9
+Requires-Dist: pyjwt>=2.0
+Requires-Dist: requests>=2.25
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# ghostwriter
+
+Markdown → Ghost → WeChat 发布管道。写一次，多处发布。
+
+```
+markdown → Ghost 博客 → 微信公众号
+```
+
+## 功能
+
+- **发布**：Markdown 文件直接发布到 Ghost 博客（Lexical 格式，编辑器可编辑）
+- **同步**：已发布的 Ghost 文章同步到微信公众号草稿箱
+- **全自动**：发布后一步同步到微信
+
+## 安装
+
+```bash
+# 从 PyPI 安装（推荐）
+pip install ghostwriter-cli
+
+# 或从源码安装（开发模式）
+git clone https://github.com/yinguobing/ghostwriter.git
+cd ghostwriter
+pip install -e ".[dev]"
+```
+
+## 配置
+
+支持两种配置方式（环境变量优先）：
+
+### 方式 1：环境变量（推荐用于 CI/Docker）
+
+```bash
+export GHOSTWRITER_GHOST_API_URL="https://yinguobing.com"
+export GHOSTWRITER_GHOST_ADMIN_KEY_ID="your_key_id"
+export GHOSTWRITER_GHOST_ADMIN_KEY="your_hex_secret"
+export GHOSTWRITER_WECHAT_APPID="your_wechat_appid"
+export GHOSTWRITER_WECHAT_SECRET="your_wechat_secret"
+```
+
+### 方式 2：配置文件（适合本地使用）
+
+```bash
+# 交互式设置
+ghostwriter config set ghost.api_url https://yinguobing.com
+ghostwriter config set ghost.admin_key_id your_key_id
+ghostwriter config set ghost.admin_key your_hex_secret
+ghostwriter config set wechat.appid your_wechat_appid
+ghostwriter config set wechat.secret your_wechat_secret
+
+# 查看当前配置（密钥已脱敏）
+ghostwriter config
+```
+
+配置文件保存在 `~/.config/ghostwriter/config.json`。
+
+可选字段：
+```bash
+# 作者映射（Ghost Content API 不可用时的离线回退）
+ghostwriter config set authors.<slug> <ghost_author_id>
+```
+
+**Ghost Admin API Key 获取：**
+Ghost 后台 → Settings → Advanced → Integrations → Add custom integration → 复制 `Admin API Key`（格式为 `key_id:hex_secret`，拆成两段填入）
+
+**微信 AppID/Secret 获取：**
+[微信公众平台](https://mp.weixin.qq.com) → 设置与开发 → 基本配置
+
+## 用法
+
+### 列出 Ghost 文章
+
+```bash
+ghostwriter list
+```
+
+### 发布 Markdown 到 Ghost
+
+```bash
+# 直接发布
+ghostwriter publish article.md
+
+# 指定标题和标签
+ghostwriter publish article.md --title "我的文章" --tags Ghost,开源
+
+# 指定作者（slug，默认 xiaohei）
+ghostwriter publish article.md --author guobing
+
+# 先存草稿
+ghostwriter publish article.md --draft
+
+# 发布后自动同步到微信
+ghostwriter publish article.md --wechat
+```
+
+### 同步 Ghost 文章到微信草稿
+
+```bash
+# 先列出文章获取 ID
+ghostwriter list
+
+# 同步指定文章
+ghostwriter <article-id>
+
+# 预览 HTML（不创建草稿）
+ghostwriter --preview <article-id>
+```
+
+## 管道说明
+
+### Markdown → Ghost（`publish` 命令）
+
+将 Markdown 文件转换为 Ghost 的 **Lexical 格式**（基于 `@tryghost/kg-lexical-html-renderer`），支持：
+
+- 标题（h1~h6）
+- 段落、粗体、斜体、行内代码、链接
+- 围栏代码块（带语言标记）
+- 表格（以 HTML card 渲染）
+- 有序/无序列表
+- 分割线
+
+转换后的文章在 Ghost 编辑器里可以正常编辑。
+
+### Ghost → 微信（`sync` 命令）
+
+从 Ghost API 获取文章 HTML，经过多层处理管道后推送到微信公众号草稿箱：
+
+1. 图片上传到微信永久素材，替换为 CDN 地址
+2. 白名单三层过滤（标签/属性/样式）
+3. 代码块保护与恢复
+4. 微信不支持的标签转换（table → div, ol/ul → 前缀段落, hr → 分隔线）
+5. 默认样式补全
+
+## 项目结构
+
+```
+ghostwriter/
+├── pyproject.toml          # 项目元数据、构建配置
+├── src/ghostwriter/        # 源码包
+│   ├── cli.py              # CLI 入口与命令分发
+│   ├── config.py           # 配置文件加载
+│   ├── ghost.py            # Ghost Admin API 客户端
+│   ├── wechat.py           # 微信公众号 API 客户端
+│   ├── cleaner.py          # HTML 白名单过滤器
+│   ├── pipeline.py         # Ghost → 微信 HTML 处理管道
+│   ├── lexical.py          # Markdown → Ghost Lexical 转换器
+│   └── normalize.py        # Unicode 标题规范化
+├── tests/                  # 单元测试（pytest，74个）
+└── docs/                   # 项目页面
+```
+
+## 注意事项
+
+- 微信草稿标题限制：Unicode 特殊字符（弯引号、破折号等）会触发 45003 错误，脚本会自动处理
+- 作者字段在微信公众号中限制 8 字节
+- 代码块使用 `<pre>` + 语言标签的样式方案，微信中可用
+- `--wechat` 参数需要在 Ghost API 中能通过 slug 查到刚发布的文章

ghostwriter_cli-0.1.0/README.md

@@ -0,0 +1,157 @@
+# ghostwriter
+
+Markdown → Ghost → WeChat 发布管道。写一次，多处发布。
+
+```
+markdown → Ghost 博客 → 微信公众号
+```
+
+## 功能
+
+- **发布**：Markdown 文件直接发布到 Ghost 博客（Lexical 格式，编辑器可编辑）
+- **同步**：已发布的 Ghost 文章同步到微信公众号草稿箱
+- **全自动**：发布后一步同步到微信
+
+## 安装
+
+```bash
+# 从 PyPI 安装（推荐）
+pip install ghostwriter-cli
+
+# 或从源码安装（开发模式）
+git clone https://github.com/yinguobing/ghostwriter.git
+cd ghostwriter
+pip install -e ".[dev]"
+```
+
+## 配置
+
+支持两种配置方式（环境变量优先）：
+
+### 方式 1：环境变量（推荐用于 CI/Docker）
+
+```bash
+export GHOSTWRITER_GHOST_API_URL="https://yinguobing.com"
+export GHOSTWRITER_GHOST_ADMIN_KEY_ID="your_key_id"
+export GHOSTWRITER_GHOST_ADMIN_KEY="your_hex_secret"
+export GHOSTWRITER_WECHAT_APPID="your_wechat_appid"
+export GHOSTWRITER_WECHAT_SECRET="your_wechat_secret"
+```
+
+### 方式 2：配置文件（适合本地使用）
+
+```bash
+# 交互式设置
+ghostwriter config set ghost.api_url https://yinguobing.com
+ghostwriter config set ghost.admin_key_id your_key_id
+ghostwriter config set ghost.admin_key your_hex_secret
+ghostwriter config set wechat.appid your_wechat_appid
+ghostwriter config set wechat.secret your_wechat_secret
+
+# 查看当前配置（密钥已脱敏）
+ghostwriter config
+```
+
+配置文件保存在 `~/.config/ghostwriter/config.json`。
+
+可选字段：
+```bash
+# 作者映射（Ghost Content API 不可用时的离线回退）
+ghostwriter config set authors.<slug> <ghost_author_id>
+```
+
+**Ghost Admin API Key 获取：**
+Ghost 后台 → Settings → Advanced → Integrations → Add custom integration → 复制 `Admin API Key`（格式为 `key_id:hex_secret`，拆成两段填入）
+
+**微信 AppID/Secret 获取：**
+[微信公众平台](https://mp.weixin.qq.com) → 设置与开发 → 基本配置
+
+## 用法
+
+### 列出 Ghost 文章
+
+```bash
+ghostwriter list
+```
+
+### 发布 Markdown 到 Ghost
+
+```bash
+# 直接发布
+ghostwriter publish article.md
+
+# 指定标题和标签
+ghostwriter publish article.md --title "我的文章" --tags Ghost,开源
+
+# 指定作者（slug，默认 xiaohei）
+ghostwriter publish article.md --author guobing
+
+# 先存草稿
+ghostwriter publish article.md --draft
+
+# 发布后自动同步到微信
+ghostwriter publish article.md --wechat
+```
+
+### 同步 Ghost 文章到微信草稿
+
+```bash
+# 先列出文章获取 ID
+ghostwriter list
+
+# 同步指定文章
+ghostwriter <article-id>
+
+# 预览 HTML（不创建草稿）
+ghostwriter --preview <article-id>
+```
+
+## 管道说明
+
+### Markdown → Ghost（`publish` 命令）
+
+将 Markdown 文件转换为 Ghost 的 **Lexical 格式**（基于 `@tryghost/kg-lexical-html-renderer`），支持：
+
+- 标题（h1~h6）
+- 段落、粗体、斜体、行内代码、链接
+- 围栏代码块（带语言标记）
+- 表格（以 HTML card 渲染）
+- 有序/无序列表
+- 分割线
+
+转换后的文章在 Ghost 编辑器里可以正常编辑。
+
+### Ghost → 微信（`sync` 命令）
+
+从 Ghost API 获取文章 HTML，经过多层处理管道后推送到微信公众号草稿箱：
+
+1. 图片上传到微信永久素材，替换为 CDN 地址
+2. 白名单三层过滤（标签/属性/样式）
+3. 代码块保护与恢复
+4. 微信不支持的标签转换（table → div, ol/ul → 前缀段落, hr → 分隔线）
+5. 默认样式补全
+
+## 项目结构
+
+```
+ghostwriter/
+├── pyproject.toml          # 项目元数据、构建配置
+├── src/ghostwriter/        # 源码包
+│   ├── cli.py              # CLI 入口与命令分发
+│   ├── config.py           # 配置文件加载
+│   ├── ghost.py            # Ghost Admin API 客户端
+│   ├── wechat.py           # 微信公众号 API 客户端
+│   ├── cleaner.py          # HTML 白名单过滤器
+│   ├── pipeline.py         # Ghost → 微信 HTML 处理管道
+│   ├── lexical.py          # Markdown → Ghost Lexical 转换器
+│   └── normalize.py        # Unicode 标题规范化
+├── tests/                  # 单元测试（pytest，74个）
+└── docs/                   # 项目页面
+```
+
+## 注意事项
+
+- 微信草稿标题限制：Unicode 特殊字符（弯引号、破折号等）会触发 45003 错误，脚本会自动处理
+- 作者字段在微信公众号中限制 8 字节
+- 代码块使用 `<pre>` + 语言标签的样式方案，微信中可用
+- `--wechat` 参数需要在 Ghost API 中能通过 slug 查到刚发布的文章