zsxq-shared
知识星球 CLI 共享基础:认证登录(auth login/logout/status)、配置诊断(doctor/config show)、通用 API 调用规范(api list/api call/api raw 调用底层接口或原始 HTTP 接口)、星球与主题分享链接拼接(电脑端 / 手机端)、写入与删除操作的安全规则、常见错误码处理(401 token 过期、缺参数等)。当用户首次登录、退出登录、查看认证状态、调用 zsxq-cli api raw / api call、需要拼接知识星球分享链接,或遇到认证或 HTTP 错误时使用。
Security Assessment
About zsxq-shared
The zsxq-shared skill provides a comprehensive command-line interface (CLI) framework for interacting with the ZhiShiXingQiu (Knowledge Planet) platform. It simplifies authentication, configuration diagnostics, API access, and link sharing for both groups and topics. By centralizing these operations, the skill ensures users can efficiently manage their Knowledge Planet resources while avoiding common pitfalls such as token expiration, missing parameters, or improper write/delete operations. It is designed for users who need a reliable way to automate or assist in accessing ZSXQ data and functionality, especially when native shortcuts are insufficient.
Key features include OAuth 2.0 device authorization for secure login, diagnostic commands to verify CLI configuration and authentication, and flexible API interaction via both high-level `api call` commands and low-level `api raw` HTTP requests. Users can easily list available tools, invoke APIs with JSON parameters, and handle responses in a simplified format. Additionally, the skill provides templates for generating shareable links for topics and groups on desktop and mobile platforms, enforces safety rules for write/delete operations, and includes guidance on submitting NPS feedback based on user interactions and error conditions.
This skill is ideal for developers, AI agents, or power users who need precise control over Knowledge Planet operations from the command line. Common use cases include automating group or topic queries, managing personal footprints across multiple groups, safely performing content creation or deletion, and assisting users with feedback submission. By offering structured commands, error handling, and secure token management, zsxq-shared is targeted at anyone needing efficient, reliable, and secure CLI access to Knowledge Planet resources.
FAQ
How do I log in to Knowledge Planet using this skill?
Use the `zsxq-cli auth login` command, which starts the OAuth 2.0 device authorization process. Follow the provided verification URL and user code to authorize the CLI, which will then store a permanent token in the system keychain.
Can I call APIs that are not covered by the standard CLI commands?
Yes, you can use `zsxq-cli api raw` to directly invoke HTTP endpoints that may not have dedicated CLI wrappers. This allows write operations or access to newer features not yet integrated into `api call`.
What should I do if I encounter a 401 or 403 error?
A 401 indicates token expiration or missing login; you should run `zsxq-cli auth login`. A 403 means you lack permission to access the resource; consider switching accounts or joining the relevant group.
Are there safety measures for write or delete operations?
Yes, the skill enforces confirmation before performing write or delete actions, ensuring that users verify target IDs and confirm their intentions to prevent accidental modifications.
Which platforms and tools does this skill require?
The skill depends on the `zsxq-cli` binary and is compatible with any environment where this CLI is supported. It requires system keychain access for token storage.
Install zsxq-shared
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
unnoo/zsxq-skill