链路一：AI 全链路（无稿用户）
research_topic → generate_article → format_wechat_html → generate_cover → create_wechat_draft

链路二：文档上传（有稿用户）
upload_docx → format_wechat_html → generate_cover → create_wechat_draft

pip install -r requirements.txt

cp config/wechat_accounts.example.json config/wechat_accounts.json
# 编辑 config/wechat_accounts.json，填入你的 AppID 和 AppSecret

export PENPULSE_API_KEY="your-api-key"          # 大模型 API Key
export PENPULSE_DASHSCOPE_KEY="your-dashscope-key"  # 通义万相 API Key（封面图用）
export PENPULSE_API_BASE="https://api.qfapi.cn/v1"  # 大模型 API 地址

# STDIO 模式（用于 Claude Desktop / Cursor 等）
python mcp_server.py

# HTTP 模式（用于远程调用）
python -m uvicorn mcp_server:app --host 0.0.0.0 --port 8080

{
  "mcpServers": {
    "penpulse": {
      "command": "python",
      "args": ["/path/to/penpulse/mcp_server.py"],
      "env": {
        "PENPULSE_API_KEY": "your-api-key",
        "PENPULSE_DASHSCOPE_KEY": "your-dashscope-key"
      }
    }
  }
}

你：帮我写一篇关于荆州端午文旅数据的公众号文章并发布

→ research_topic("荆州 端午 文旅")
→ generate_article("荆州端午文旅数据", style="humor")
→ format_wechat_html(markdown, template_id="journal")
→ generate_cover(title, style="culture")
→ create_wechat_draft(title, html, cover_url)
→ 返回草稿预览链接

你：帮我把 /path/to/article.docx 排版发布

→ upload_docx("/path/to/article.docx")
→ format_wechat_html(markdown, template_id="auto")
→ generate_cover(title)
→ create_wechat_draft(title, html, cover_url)
→ 返回草稿预览链接

from modules.publisher import add_account

add_account({
    "id": "my-account",
    "name": "我的公众号",
    "appid": "wx1234567890abcdef",
    "appsecret": "your-appsecret-here",
    "author_name": "作者名"
})

penpulse/
├── mcp_server.py          # MCP Server 入口
├── modules/
│   ├── __init__.py
│   ├── research.py        # 选题搜索
│   ├── writer.py          # AI 写作
│   ├── doc_reader.py      # Word 文档读取
│   ├── formatter.py       # 公众号排版
│   ├── cover.py           # 封面图生成
│   └── publisher.py       # 公众号发布
├── config/
│   └── wechat_accounts.example.json
├── requirements.txt
└── README.md