| name | zsxq-publisher |
| description | 知识星球内容发布工具（二次封装版）。
架构原则：
- 大部分操作直接透传到 OpenClaw 官方 zsxq skills（zsxq-cli / zsxq-group / zsxq-topic / zsxq-user / zsxq-note）
- 仅"发布带图长文章"需要本 skill 自持编排逻辑（官方 skills 未覆盖此流程）
认证：统一走 zsxq-cli auth login（Keychain 管理），不再依赖 auth.json。
触发词：发布到知识星球、zsxq-publisher、知识星球发布、发布话题、发布文章、带图发布
|
| allowed-tools | Bash, Read, Write, Glob, Grep |
| mode-command | false |
知识星球发布工具（zxsq-publisher）
架构说明
本 skill 是对 OpenClaw 官方 zsxq skills 的二次封装：
| 操作类型 | 处理方式 |
|---|
| 查询星球 / 话题 / 用户 | 透传到 zsxq-cli 官方工具 |
| 发布普通帖子（talk） | 透传到 zsxq-cli topic +create |
| 发布长文章（article + 配图） | 本 skill 自持，调用 zsxq-cli api raw 实现两步流程 |
| 认证管理 | 统一走 zsxq-cli auth login（不再用 auth.json） |
为什么文章发布需要自持？ 官方 zsxq-cli topic +create 仅支持纯文本/图片混合的 talk 类型。
带图长文章需要：①先调 /v2/articles 创建文章，②再调 /v2/groups/{id}/topics 引用文章。
这条两步流程官方 skills 未封装，所以需要本 skill 自行编排。
星球配置
配置文件位于 ~/.private_key/zsxq-publish/：
| 星球名称 | group_id | 类型 |
|---|
| AI编程与自动化 | 28882452841521 | 付费（默认发布目标） |
| 人工智能成长写作 | 51128824585884 | 免费 |
- 默认 group_id 从
~/.private_key/zsxq-publish/user_config.json 读取
- 发布标题规则：使用笔记原标题，不使用 Notion「发布标题」字段（与其他平台不同）
运行器
RUN = "skills/zsxq-publisher/scripts/run.py"
命令参考
1. 认证相关（透传官方）
python "${RUN}" main.py check-auth
python "${RUN}" main.py login
zsxq-cli group +list
认证由 zsxq-cli 管理（Keychain），登录一次后长期有效。
2. 查询类（透传官方）
zsxq-cli topic +search --group-id <id> --query "<关键词>"
zsxq-cli topic +detail --topic-id <id>
zsxq-cli api call get_user_footprints --params '{"user_id":"...","group_id":"..."}'
3. 发布普通话题（透传官方）
python "${RUN}" main.py topic --text "内容" --title "标题" --tags "标签1,标签2"
zsxq-cli topic +create --group-id <id> --title "标题" --content "正文"
4. 发布长文章（含配图）— 本 skill 自持
python "${RUN}" main.py article --file "./weekly_report.md" --title "周报标题" --tags "周报"
python "${RUN}" main.py article --file "./report.md" --image "./cover.png" --title "标题"
发布流程（两步）：
- 上传图片到知识星球 CDN（image_id）
POST /v2/articles 创建文章（带 image_ids）POST /v2/groups/{id}/topics 创建引用文章的主题
标题规则：始终使用 --title 传入笔记原标题，不使用 Notion「发布标题」字段（与其他平台不同）。
5. 话题预览（显式调用，非默认）
发布前可生成本地 HTML 预览确认话题渲染效果，默认不生成，只在用户明确要求时才执行。
预览脚本逻辑（内联运行）：
import re, sys
sys.path.insert(0, 'skills/zsxq-publisher/scripts')
from publisher import build_summary
md = open("<article.md>", encoding="utf-8").read()
title = "<原始笔记标题>"
article_url = "https://articles.zsxq.com/id_<article_id>.html"
summary = build_summary(md)
topic_text = f"<b>{title}</b>\n\n{summary}\n\n详细步骤见文章：\n{article_url}"
确认无误后再调用 api_raw 发布话题。话题摘要中 **bold** 会渲染为 <strong>bold</strong>（平台支持 HTML 标签）。
5. 自动判断模式
python "${RUN}" main.py publish --file "./content.md" --tags "标签"
认证与权限说明
- 无需 auth.json：认证统一由
zsxq-cli 管理（OAuth → Keychain）
- 登录一次后长期有效：通常数周到数月
- 权限范围：当前登录账号有权限的所有星球
与官方 zsxq skills 的分工
| 场景 | 使用方式 |
|---|
| 查询星球成员、搜索话题 | 直接用 zsxq-cli group +list / zsxq-cli topic +search |
| 发布普通帖子 | 直接用 zsxq-cli topic +create |
| 发布带图长文章 | 通过 zsxq-publisher：本 skill 编排两步流程 |
| 管理笔记、回复评论 | 直接用 zsxq-cli note / zsxq-cli topic +reply |
依赖
zsxq-cli（必须，已包含在 OpenClaw 官方技能中）- Python 3.9+
requests（图片上传用，已在 .venv 中）
安全注意
- 发布前确认目标星球和内容（不可撤销的公开操作）
- 不确定 group_id 时先查询再操作
