~/.xfg-zsxq/groups.json

   browser action=act target=host ref=<发送按钮ID> kind=click
   

知识星球自动化技能

支持发帖、回帖、浏览帖子、检查通知、自动回帖等完整功能。

⚡ 快速开始

1. 配置 Cookie

执行技能目录下的脚本：
bash

添加星球配置

node {skills}/scripts/zsxq.js config add \ --url https://wx.zsxq.com/group/星球ID \ --cookie 你的完整Cookie

获取 Cookie 方法：

1. 1. 登录 https://wx.zsxq.com
2. 按 F12 → Network 标签
3. 点击任意请求（如 api.zsxq.com）
4. 复制 Request Headers 中的完整 Cookie 头值

2. 查看本地已保存配置信息

bash

执行命令返回本地保存的知识星球ID等信息

node zsxq.js config list

或者读取用户主目录的下的文件获取已保存的信息
bash
~/.xfg-zsxq/groups.json

---

📝 发帖

bash

简单文字发帖

node zsxq.js post --text 今天分享一个技术心得...

带图片发帖（最多9张）

node zsxq.js post --text 内容 --images /path/a.jpg,/path/b.png

从文件读取内容

node zsxq.js post --file /tmp/post.txt

---

📖 浏览帖子

bash

查看最新帖子（脚本）

node zsxq-auto-check.js

或直接用 curl/API

curl https://api.zsxq.com/v2/groups/{group_id}/topics?count=10 \ -H cookie: $COOKIE

---

💬 回复帖子（浏览器自动化）

回复功能使用浏览器自动化：

1. 1. 打开星球页面

javascript exec command=open https://wx.zsxq.com/group/星球ID

1. 2. 获取页面快照

javascript browser action=snapshot target=host refs=aria

1. 3. 点击评论按钮（找到对应帖子的评论按钮 ref）

javascript browser action=act target=host ref=<评论按钮ID> kind=click

1. 4. 输入回复内容

javascript browser action=act target=host ref=<输入框ID> kind=type text=回复内容

1. 5. 发送评论

javascript browser action=act target=host ref=<发送按钮ID> kind=click

---

📝 发布文章

bash

发布到草稿箱（默认）

node zsxq-auto-post-article.js --cookie xxx --title 文章标题 --content

文章内容

更新已有草稿（指定article_id）

node zsxq-auto-post-article.js --cookie xxx --title 标题 --content

内容

--article 文章ID

若需直接诶发布为文章，建议先保存为草稿后再发布

node zsxq-auto-post-article.js --cookie xxx --title 文章标题 --content

文章内容

--publish true --article 文章ID

🔔 检查通知

bash
node zsxq-auto-check.js

参数：

• - --scope all - 所有动态（默认）
• --scope related - 与我相关（被圈、评论等）
• --count 30 - 获取数量

---

🕐 设置定时任务

当需要自动检查通知时，创建 cron 任务：

bash

使用 cron 工具创建每30分钟检查一次的任务

在 OpenClaw 中说设置定时任务即可自动创建

📁 References 路由表

当需要详细参考信息时，按需加载以下文件：

文件	用途	何时读取
references/api.md	API 接口文档	发帖/浏览/上传图片时
references/usage.md

详细使用指南 | 需要批量发帖/Git集成时 |
| references/faq.md | 常见问题解答 | 遇到错误时 |
| references/signature.md | 签名生成方法 | 需要手动生成签名时 |
| references/token-config.md | Token 配置说明 | 配置 Cookie/Token 时 |
| references/puppeteer.md | 浏览器自动化 | 使用自动回复功能时 |

---

📁 API 接口状态

功能	接口	方法	状态
发帖	/v2/groups/{group_id}/topics	POST	⚠️ 需有效 Cookie
发布草稿文章

/v2/articles/drafts | POST | ⚠️ 需有效 Cookie |
| 浏览帖子 | /v2/groups/{group_id}/topics | GET | ✅ 正常 |
| 回复帖子 | /v2/topics/{topic_id}/comments | POST | ⚠️ 需浏览器自动化 |
| 获取动态 | /v2/dynamics?scope=all | GET | ✅ 正常 |

---

🔧 常见问题

❌ 发帖失败 (code: 1004/1059)

原因： Cookie 已过期或无效

解决方法：

1. 1. 登录 https://wx.zsxq.com
2. 按 F12 → Network
3. 复制新的 Cookie
4. 更新配置：

bash
node zsxq.js config add --url https://wx.zsxq.com/group/ID --cookie 新Cookie

❌ 回复帖子失败

原因： API 回复有频率限制

解决方法： 使用浏览器自动化方式回复（见上方教程）

---

🔐 Cookie 格式

确保 Cookie 包含以下关键字段：

zsxqaccesstoken=xxx; sensorsdata2015jssdkcross=xxx; sajssdk2015crossnewuser=1; abtest_env=product

---

📁 项目结构

xfg-zsxq-skills/
├── SKILL.md # 技能文档
├── README.md # 说明文档
├── scripts/ # 可执行脚本
│ ├── zsxq.js # 主脚本（配置/发帖/浏览）
│ ├── zsxq-auto-check.js # 自动检查通知
│ ├── zsxq-auto-reply.js # 自动回复（浏览器自动化）
│ ├── zsxq-auto-post.js # 发帖脚本
│ ├── zsxq-auto-post-article.js # 发布文章
│ └── zsxq-cron-setup.js # 定时任务设置
└── references/ # 参考文档（按需加载）
├── api.md # API 接口文档
├── usage.md # 详细使用指南
├── faq.md # 常见问题
├── signature.md # 签名生成
├── token-config.md # Token 配置
└── puppeteer.md # 浏览器自动化

注意：references 目录下的文件不会自动加载到上下文，仅在需要时由 AI 自行读取。

---

参考

• - 知识星球网页版：https://wx.zsxq.com
• 配置文件：~/.xfg-zsxq/groups.json
• 脚本目录：xfg-zsxq-skills/scripts