SuperAPI AI 工具集

zsxq-shared

编程与开发

查看项目

更新于 10-16 09:45

技能介绍

用途:本技能是 zsxq-cli 的共享规则,指导使用者通过命令行操作知识星球资源,并为其他 zsxq-* 技能提供通用约定。

主要命令:认证与诊断包括 auth login(OAuth 设备授权码登录,首次使用、token 过期或切换账户时)、auth status(查看当前登录账户,加 --json 输出 JSON)、auth logout(清除本地凭据)、doctor(诊断配置与 keychain 认证状态)、config show(显示版本与配置,加 --json)。底层接口调用包括 api list(列出可用工具及参数)、api call <tool>(配 --params '<json>')、api raw(配 --method --path,直接调用原始 HTTP 接口)。

认证方式:采用 OAuth 2.0 设备授权码流程(RFC 8628),token 存于系统 Keychain 并永久有效。运行 auth login 后输出 verification_uri 与 user_code,用户完成授权后 CLI 自动轮询并保存 token。

接口调用:列表/查询类优先用 api call,如 get_self_info、search_groups、get_user_footprints(不传 group_id 查所有星球,传则限定单星球);api raw 主要用于 api call 未覆盖的写入接口,其响应已去除三层嵌套。

链接拼接:主题电脑端 https://wx.zsxq.com/group/{group_id}/topic/{topic_id},手机端 https://wx.zsxq.com/mweb/views/topicdetail/topicdetail.html?topic_id={topic_id}&group_id={group_id};星球电脑端 https://wx.zsxq.com/group/{group_id},手机端 https://wx.zsxq.com/mweb/views/topic/topic.html?group_id={group_id}。分享时同时给出两端链接。

限制与安全:token 禁止明文输出或分享;写入/删除前必须确认用户意图;ID 不确定时先查询再写入。各命令通用错误处理:401/未登录需重新 auth login;403 需切换账户或加入星球;404 需核对 ID;参数缺失用查询命令补齐;分页时间须用上一页返回的 next_end_time / create_time 原值。本技能还规定了 NPS 反馈提示的触发与排除场景、每会话最多提示一次、score 不得自动赋值、suggestion 需用户确认等约束。更多细节暂未提供。