SuperAPI AI 工具集

zsxq-topic

编程与开发

查看项目

更新于 10-16 09:45

技能介绍

用途:在知识星球(zsxq)内进行主题与评论的全流程管理,覆盖搜索、查看、发布、编辑、评论、回复、回答提问、删除,以及精华、标签、提问记录等管理操作。

核心概念:主题由 topic_id 标识,类型包括 talk(普通图文帖)、q&a(提问)、task(作业)、solution(作业答案)。评论由 comment_id 标识,支持楼中楼(replied_comment_id)。星主可将主题设为精华。

主要能力(Shortcut 优先使用,命令形如 zsxq-cli topic +<verb> [flags]):+search 星球内全文搜索;+detail 获取单条主题详情;+create 发布 talk 类型主题;+edit 编辑自己发布的主题;+reply 发表评论或楼中楼回复;+answer 对 q&a 主题发布官方回答。以上写操作需确认内容后执行。

aPI 高级操作(zsxq-cli api call):get_topic_comments(topic_id, limit, index,分页取评论)、set_topic_digested(设置/取消精华,需星主权限)、set_topic_tags(主题标签)、get_self_question_topics(查看自己发起的提问,含未答/已答)、get_self_answer_topics(查看别人向自己发起的提问)。

删除主题通过原始 HTTP:api raw --method DELETE --path /v2/topics/<topic_id>,删除后不可恢复。

使用说明:首次使用或遇到认证错误(401 / token 过期 / not logged in)时,先读 ../zsxq-shared/SKILL.md 了解登录与 API 调用约定;已登录账户日常调用无需每次重读。

限制:+create 仅支持 talk 类型;精华设置需星主权限;删除不可恢复。其余未在资料中说明的功能、收费与价格暂未提供。