{"id":"ab825427-7c9e-4441-ba65-3df7b974ec56","entityType":"agent","slug":"clawhub-zsxq-zsxq-shared","name":"【官方】知识星球·登录配置","canonicalUrl":"https://www.xpersona.co/agent/clawhub-zsxq-zsxq-shared","canonicalPath":"/agent/clawhub-zsxq-zsxq-shared","generatedAt":"2026-10-10T17:37:42.763Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T15:20:10.055Z","emptyReason":null},"description":"知识星球 CLI 共享基础：认证登录（auth login/logout/status）、配置诊断（doctor/config show）、通用 API 调用规范（api list/api call/api raw 调用底层接口或原始 HTTP 接口）、星球与主题分享链接拼接（电脑端 / 手机端）、写入与删除操作... Skill: 【官方】知识星球·登录配置 Owner: zsxq Summary: 知识星球 CLI 共享基础：认证登录（auth login/logout/status）、配置诊断（doctor/config show）、通用 API 调用规范（api list/api call/api raw 调用底层接口或原始 HTTP 接口）、星球与主题分享链接拼接（电脑端 / 手机端）、写入与删除操作... Tags: latest:1.3.1 Version history: v1.3.1 | 2026-05-22T07:27:12.852Z | auto - Expanded documentation in SKILL.md with a detailed index, command summary, and structured common error handling section. - Added an explic","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.4K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s17dz3yf3n26zg8jbw21a6ae7186nhvm:zsxq-shared","sourceUrl":"https://clawhub.ai/zsxq/zsxq-shared","homepage":"https://clawhub.ai/zsxq/skills/zsxq-shared","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/zsxq/zsxq-shared","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/zsxq/skills/zsxq-shared","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":63,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"知识星球 CLI 共享基础：认证登录（auth login/logout/status）、配置诊断（doctor/config show）、通用 API 调用规范（api list/api call/api raw 调用底层接口或原始 HTTP 接口）、星球与主题分享链接拼接（电脑端 / 手机端）、写入与删除操作..."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T15:20:10.055Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T15:20:10.055Z","emptyReason":null},"stars":null,"forks":null,"downloads":1363,"packageName":null,"latestVersion":"1.3.1","tractionLabel":"1.4K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T15:20:10.055Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T15:20:10.055Z","lastCrawledAt":"2026-10-10T15:20:10.055Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T15:20:10.055Z","lastVerifiedAt":null,"highlights":[{"version":"1.3.1","createdAt":"2026-05-22T07:27:12.852Z","changelog":"- Expanded documentation in SKILL.md with a detailed index, command summary, and structured common error handling section. - Added an explicit \"反馈提醒（NPS）\" section describing when and how to prompt users for product/CLI feedback, including stepwise guidance and trigger/exclusion scenarios. - Clarified safe operation rules when performing write/delete actions, emphasizing explicit user intent confirmation. - Provided clearer distinctions between different command usages (e.g., \"api call\" vs \"api raw\") and best practice recommendations for each. - Enhanced instructions for share link generation, now with prominent templates for both desktop and mobile. - Improved error solution table for 401/403/404, missing parameter, and time format issues.","fileCount":3,"zipByteSize":5503},{"version":"0.1.1","createdAt":"2026-05-14T09:11:39.063Z","changelog":"新增知识星球官方账号连接能力，支持登录授权、认证状态查看、退出登录、配置诊断，并为其他知识星球 Skill 提供共享使用基础。","fileCount":2,"zipByteSize":2248},{"version":"0.1.0","createdAt":"2026-04-19T14:30:44.617Z","changelog":"Initial release of zsxq-shared with authentication and diagnostics features: - Adds CLI-based login/logout using OAuth 2.0 device flow, with tokens securely stored. - Supports status checks for authentication and configuration. - Provides troubleshooting tips and command examples for common scenarios. - Enables direct access to zsxq-cli's API tools for advanced usage. - Emphasizes security rules for token handling and user confirmation before write/delete actions.","fileCount":2,"zipByteSize":1963}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17dz3yf3n26zg8jbw21a6ae7186nhvm:zsxq-shared","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zsxq-zsxq-shared/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zsxq-zsxq-shared/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zsxq-zsxq-shared/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-zsxq-zsxq-shared/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-zsxq-zsxq-shared/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-zsxq-zsxq-shared/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T17:37:42.762Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zsxq-zsxq-shared/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zsxq-zsxq-shared/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zsxq-zsxq-shared/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zsxq-zsxq-shared/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-10T15:20:10.055Z","emptyReason":null},"readme":"Skill: 【官方】知识星球·登录配置\n\nOwner: zsxq\n\nSummary: 知识星球 CLI 共享基础：认证登录（auth login/logout/status）、配置诊断（doctor/config show）、通用 API 调用规范（api list/api call/api raw 调用底层接口或原始 HTTP 接口）、星球与主题分享链接拼接（电脑端 / 手机端）、写入与删除操作...\n\nTags: latest:1.3.1\n\nVersion history:\n\nv1.3.1 | 2026-05-22T07:27:12.852Z | auto\n\n- Expanded documentation in SKILL.md with a detailed index, command summary, and structured common error handling section.\n- Added an explicit \"反馈提醒（NPS）\" section describing when and how to prompt users for product/CLI feedback, including stepwise guidance and trigger/exclusion scenarios.\n- Clarified safe operation rules when performing write/delete actions, emphasizing explicit user intent confirmation.\n- Provided clearer distinctions between different command usages (e.g., \"api call\" vs \"api raw\") and best practice recommendations for each.\n- Enhanced instructions for share link generation, now with prominent templates for both desktop and mobile.\n- Improved error solution table for 401/403/404, missing parameter, and time format issues.\n\nv0.1.1 | 2026-05-14T09:11:39.063Z | user\n\n新增知识星球官方账号连接能力，支持登录授权、认证状态查看、退出登录、配置诊断，并为其他知识星球 Skill 提供共享使用基础。\n\nv0.1.0 | 2026-04-19T14:30:44.617Z | auto\n\nInitial release of zsxq-shared with authentication and diagnostics features:\n\n- Adds CLI-based login/logout using OAuth 2.0 device flow, with tokens securely stored.\n- Supports status checks for authentication and configuration.\n- Provides troubleshooting tips and command examples for common scenarios.\n- Enables direct access to zsxq-cli's API tools for advanced usage.\n- Emphasizes security rules for token handling and user confirmation before write/delete actions.\n\nArchive index:\n\nArchive v1.3.1: 3 files, 5503 bytes\n\nFiles: skill-card.md (2002b), SKILL.md (8540b), _meta.json (130b)\n\nFile v1.3.1:SKILL.md\n\n---\nname: zsxq-shared\nversion: 1.3.1\ndescription: \"知识星球 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 错误时使用。\"\nmetadata:\n  requires:\n    bins: [\"zsxq-cli\"]\n  cliHelp: \"zsxq-cli auth --help\"\n---\n\n# zsxq-cli 共享规则\n\n本技能指导你如何通过 zsxq-cli 操作知识星球资源，以及有哪些注意事项。\n\n## 索引\n\n- [Commands](#commands) — 认证、诊断、底层 API 调用命令一览\n- [认证](#认证) — OAuth 设备授权码流程\n- [直接调用 API](#直接调用-api) — `api call` / `api raw` 详细用法与示例\n- [链接拼接](#链接拼接) — 主题/星球分享链接（电脑端 / 手机端）\n- [安全规则](#安全规则) — Token、写入确认、ID 查询前置\n- [反馈提醒（NPS）](#反馈提醒nps) — 何时主动建议用户提交 NPS 反馈\n- [常见错误处理](#常见错误处理) — 通用错误（401/403/404/参数缺失/分页时间格式）\n\n## Commands\n\n| 命令 | 说明 |\n|------|------|\n| `zsxq-cli auth login` | OAuth 设备授权码登录（首次使用、token 过期或切换账户时） |\n| `zsxq-cli auth status` | 查看当前登录账户（默认表格，加 `--json` 输出 JSON） |\n| `zsxq-cli auth logout` | 清除本地凭据 |\n| `zsxq-cli doctor` | 诊断 CLI 配置与 keychain 认证状态 |\n| `zsxq-cli config show` | 显示版本信息与当前配置（加 `--json` 输出 JSON） |\n| `zsxq-cli api list` | 列出所有可用底层接口工具及参数 |\n| `zsxq-cli api call <tool>` | 调用底层接口工具，需配 `--params '<json>'` |\n| `zsxq-cli api raw` | 直接调用原始 HTTP 接口（需 `--method` `--path`） |\n\n详细用法见下面各小节。\n\n## 认证\n\nzsxq-cli 使用 **OAuth 2.0 设备授权码流程（RFC 8628）** 认证，token 存储在系统 Keychain 中，永久有效。\n\n### OAuth 登录流程\n\n`zsxq-cli auth login` 启动后：\n1. 命令输出一个 `verification_uri` 链接和 `user_code`\n2. 用户在手机或浏览器中打开链接，完成授权\n3. CLI 自动轮询，授权完成后自动保存 token\n\n> 当你作为 AI Agent 帮用户登录时，在后台运行 `zsxq-cli auth login`，读取输出后将授权链接提供给用户，等待用户完成授权。\n\n## 直接调用 API\n\n当 Shortcut 无法满足需求时，可以直接调用底层接口（参数与方法见上面 Commands 表）。\n\n`api call` 示例：\n\n```bash\nzsxq-cli api call get_self_info --params '{}'\nzsxq-cli api call search_groups --params '{\"keyword\":\"Go语言\"}'\n\n# 跨星球查询当前用户主题足迹（不传 group_id 即查所有星球）\nzsxq-cli api call get_user_footprints --params '{\"user_id\":\"123456\"}'\n# 限定单个星球\nzsxq-cli api call get_user_footprints --params '{\"user_id\":\"123456\",\"group_id\":\"123456789\"}'\n```\n\n`api raw` 示例：\n\n```bash\nzsxq-cli api raw --method GET --path /v3/users/self\n\n# --body 支持简写，自动包装 req_data\nzsxq-cli api raw --method PUT --path /v2/topics/123 --body '{\"text\":\"新内容\"}'\n```\n\n> 列表/查询类操作请优先使用 `api call`（如 `get_group_topics`），`api raw` 主要用于 `api call` 尚未覆盖的写入接口。\n>\n> `api raw` 响应已去除三层嵌套，直接返回数据内容。\n\n## 链接拼接\n\n当用户需要分享链接时，使用以下模板拼接。输出时同时提供电脑端和手机端两个版本。\n\n### 主题链接\n\n- 电脑端：`https://wx.zsxq.com/group/{group_id}/topic/{topic_id}`\n- 手机端：`https://wx.zsxq.com/mweb/views/topicdetail/topicdetail.html?topic_id={topic_id}&group_id={group_id}`\n\n### 星球链接\n\n- 电脑端：`https://wx.zsxq.com/group/{group_id}`\n- 手机端：`https://wx.zsxq.com/mweb/views/topic/topic.html?group_id={group_id}`\n\n## 安全规则\n\n- **Token 是登录凭证**，禁止在终端明文输出或分享给他人\n- **写入/删除操作前必须确认用户意图**（发帖、编辑、评论、回答、创建笔记、删除主题或笔记、提交 NPS 反馈等）\n- 不确定 group_id / topic_id / note_id 时，先用查询命令确认，再执行写入或删除\n\n## 反馈提醒（NPS）\n\n当用户在使用 zsxq-* skill 过程中遇到「适合反馈给知识星球官方」的场景时，AI 应在完成主任务后顺带一句提示用户考虑提交 NPS 反馈（[`zsxq-cli user +nps`](../zsxq-user/references/zsxq-user-nps.md)）。\n\n### 触发场景\n\n| # | 场景 | 信号 | 标签 |\n|---|------|------|---------------|\n| 1 | 用户表达对知识星球产品本身的不满 | 自然语言：抱怨产品规则 / 抱怨体验 / 「这功能怎么这么难用」 | `#产品建议#` |\n| 2 | 用户的需求知识星球产品侧不存在能力 | AI 排查后确认接口/能力在产品上根本没有（不是 CLI 没封装） | `#产品建议#` |\n| 3 | zsxq-cli / skill 工具侧未封装 | `api list` 中找不到对应工具，且 `api raw` 也无现成 path | `#工具反馈#` |\n| 4 | 同一命令多次重试仍失败、用户明显受挫 | 同一会话内对同一目标的命令连续失败 ≥ 3 次，且失败原因不属于排除清单 | `#工具反馈#` |\n\n### 排除场景（不触发提示）\n\n下列错误属于「用户自查可解 / 状态类错误」，应走对应的解决路径而非反馈，与下面 [`## 常见错误处理`](#常见错误处理) 表对齐：\n\n- `401` / `not logged in` → 引导 `auth login`\n- `403` / 无权限 → 提示切换账户或加入星球\n- `404` / 资源不存在 → 重新核对 ID\n- `--<flag> is required` 等参数缺失 → 用查询命令补齐\n- `--end-time` 解析失败等格式错误 → 参见下面 ## 常见错误处理 表的格式说明\n\n### 提示流程\n\n```text\n[1] 命中触发场景\n[2] AI 一句话提示（不打断主任务）\n    示例：\"顺带一提：刚刚这个场景比较适合反馈给知识星球官方，\n           你需要的话我可以帮你提交一条 NPS 反馈。\"\n[3] 用户拒绝 → 回到主任务，会话内不再提\n    用户接受 ↓\n[4] AI 协助起草：\n    - 询问 score（1–10），不自动赋值\n    - 起草 suggestion（≤ 500 字），以 #产品建议# 或 #工具反馈# 开头\n    - 把 score 与 suggestion 全文复述给用户确认\n[5] 用户确认 → 执行 zsxq-cli user +nps\n    用户改稿 → 回到 [4] 修订\n```\n\n### 关键约束\n\n- **每会话最多 1 次**：同一会话内只提示一次；发过就不再主动重复，除非用户后续主动询问。\n- **附带不替代**：第 [2] 步是附带的，不能让反馈提示中断或替换主任务的解决路径。先解决用户的事，再顺口提一句。\n- **score 必须问用户**：第 [4] 步起草不替代用户判断，score 不能自动赋值。\n- **suggestion 必须复述确认**：AI 起草后必须把 score 与 suggestion 全文复述给用户确认，用户改稿后回 [4] 修订。\n- **tag 写在 suggestion 正文开头**：`#产品建议#` / `#工具反馈#` 不占用 score 字段，让官方读到原文时就有分流标记。\n\n详见 [`zsxq-user-nps`](../zsxq-user/references/zsxq-user-nps.md)。\n\n## 常见错误处理\n\n下表覆盖所有 zsxq-cli 命令通用的错误。各命令的 reference 文档只列出与该命令直接相关的特殊错误（如 `--score must be 1–10`、`code: 100262 无权限删除`），通用错误一律回到这里。\n\n| 错误 | 原因 | 解决方案 |\n|------|------|---------|\n| `authentication failed (HTTP 401)` / `not logged in` | Token 无效、过期或未登录 | 运行 `zsxq-cli auth login` 重新登录 |\n| 403 / 无权限 / 不可访问 | 当前账户无访问目标资源的权限 | 切换到正确账户，或加入对应星球后重试 |\n| 404 / 资源不存在 | group_id / topic_id / note_id 等无效或对应资源已被删除 | 重新核对 ID；可用 `group +list`、`topic +search`、`note +list` 等查询 |\n| `--<flag> is required` | 缺少必填参数 | 用对应查询命令获取后再填，例如 group_id 用 `group +list`、topic_id 用 `topic +search` |\n| `--end-time` 解析失败 | 分页时间格式错误 | 使用上一页 JSON 中返回的 `next_end_time` / `create_time` 原值 |\n\nFile v1.3.1:_meta.json\n\n{\n  \"ownerId\": \"kn7dxggz98t1mjmzn9jmtbva1d855kbt\",\n  \"slug\": \"zsxq-shared\",\n  \"version\": \"1.3.1\",\n  \"publishedAt\": 1779434832852\n}\n\nFile v1.3.1:skill-card.md\n\n## Description:\n\nProvides shared Knowledge Planet CLI guidance for authentication, diagnostics, direct API calls, share-link construction, safe write/delete rules, NPS feedback prompts, and common error handling.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[zsxq](https://clawhub.ai/user/zsxq)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and agents use this skill to operate zsxq-cli for Knowledge Planet authentication, account diagnostics, direct API calls, share-link generation, and safe handling of write or delete workflows.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill can guide zsxq-cli actions against a user's Knowledge Planet account, including raw API calls, writes, deletes, and NPS feedback submission.\n\nMitigation: Review and explicitly approve write, delete, raw API, and feedback actions before execution, and confirm resource IDs before modifying or deleting content.\n\nRisk: Authentication tokens grant account access and could be exposed if printed or shared.\n\nMitigation: Do not display, log, or share authentication tokens; use zsxq-cli status and diagnostic commands without revealing credentials.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/zsxq/skills/zsxq-shared)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Shell commands, Configuration, API calls]\n\n**Output Format:** [Markdown guidance with inline shell command examples and URL templates]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires zsxq-cli and an authenticated Knowledge Planet account for account operations.]\n\n## Skill Version(s):\n\n1.3.1 (source: SKILL.md frontmatter and server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v0.1.1: 2 files, 2248 bytes\n\nFiles: SKILL.md (3672b), _meta.json (130b)\n\nFile v0.1.1:SKILL.md\n\n---\nname: zsxq-shared\nversion: 1.0.0\ndescription: \"知识星球 CLI 共享基础：认证登录（auth login/logout）、查看认证状态、诊断配置。当用户需要首次登录、退出登录、查看认证状态、或遇到认证错误时触发。\"\nmetadata:\n  requires:\n    bins: [\"zsxq-cli\"]\n  cliHelp: \"zsxq-cli auth --help\"\n---\n\n# zsxq-cli 共享规则\n\n本技能指导你如何通过 zsxq-cli 操作知识星球资源，以及有哪些注意事项。\n\n## 认证\n\nzsxq-cli 使用 **OAuth 2.0 设备授权码流程（RFC 8628）** 认证，token 存储在系统 Keychain 中，永久有效。\n\n### 登录\n\n```bash\n# 发起登录（会输出一个授权链接，用户在手机/浏览器中打开并授权）\nzsxq-cli auth login\n```\n\n登录流程：\n1. 命令输出一个 `verification_uri` 链接和 `user_code`\n2. 用户在手机或浏览器中打开链接，完成授权\n3. CLI 自动轮询，授权完成后自动保存 token\n\n> 当你作为 AI Agent 帮用户登录时，在后台运行 `zsxq-cli auth login`，读取输出后将授权链接提供给用户，等待用户完成授权。\n\n### 查看认证状态\n\n```bash\nzsxq-cli auth status        # 表格显示当前登录账户\nzsxq-cli auth status --json # JSON 格式输出\n```\n\n### 退出登录\n\n```bash\nzsxq-cli auth logout        # 清除本地凭据\n```\n\n### 配置诊断\n\n```bash\nzsxq-cli doctor             # 检查 CLI 配置和 keychain 认证状态\nzsxq-cli config show        # 显示版本信息和当前配置\nzsxq-cli config show --json # JSON 格式\n```\n\n## 直接调用 API\n\n当 Shortcut 无法满足需求时，可以直接调用底层 MCP 工具：\n\n```bash\nzsxq-cli api list                           # 列出所有可用 MCP 工具及参数\nzsxq-cli api call <tool> --params '<json>'  # 调用指定工具\nzsxq-cli api raw --method GET --path /v3/users/self\n```\n\n示例：\n\n```bash\nzsxq-cli api call get_self_info --params '{}'\nzsxq-cli api call search_groups --params '{\"keyword\":\"Go语言\"}'\nzsxq-cli api call get_user_footprints --params '{\"user_id\":\"123456\",\"group_id\":\"123456789\"}'\n\n# 推荐：对通用 HTTP API 使用显式参数的 raw 子命令\nzsxq-cli api raw --method GET --path /v2/groups/123456789/topics --query '{\"count\":10}'\n\n# --body 支持简写，自动包装 req_data\nzsxq-cli api raw --method PUT --path /v2/topics/123 --body '{\"text\":\"新内容\"}'\n```\n\n> `api raw` 响应已去除三层嵌套，直接返回数据内容。\n\n## 链接拼接\n\n当用户需要分享链接时，使用以下模板拼接。输出时同时提供电脑端和手机端两个版本。\n\n### 主题链接\n\n- 电脑端：`https://wx.zsxq.com/group/{group_id}/topic/{topic_id}`\n- 手机端：`https://wx.zsxq.com/mweb/views/topicdetail/topicdetail.html?topic_id={topic_id}&group_id={group_id}`\n\n### 星球链接\n\n- 电脑端：`https://wx.zsxq.com/group/{group_id}`\n- 手机端：`https://wx.zsxq.com/mweb/views/topic/topic.html?group_id={group_id}`\n\n## 安全规则\n\n- **Token 是登录凭证**，禁止在终端明文输出或分享给他人\n- **写入/删除操作前必须确认用户意图**（发帖、评论、创建笔记等）\n- 不确定 group_id / topic_id 时，先用查询命令确认，再执行写入\n\n## 常见错误处理\n\n| 错误 | 原因 | 解决方案 |\n|------|------|---------|\n| `authentication failed (HTTP 401)` | Token 无效或过期 | 重新运行 `zsxq-cli auth login` |\n| `not logged in` | 未完成登录 | 运行 `zsxq-cli auth login` |\n| `--group-id is required` | 缺少必填参数 | 先用 `zsxq-cli group +list` 查询 group_id |\n| `--topic-id is required` | 缺少必填参数 | 先用 `zsxq-cli group +topics` 或 `topic +search` 查询 topic_id |\n\nFile v0.1.1:_meta.json\n\n{\n  \"ownerId\": \"kn7dxggz98t1mjmzn9jmtbva1d855kbt\",\n  \"slug\": \"zsxq-shared\",\n  \"version\": \"0.1.1\",\n  \"publishedAt\": 1778749899063\n}\n\nArchive v0.1.0: 2 files, 1963 bytes\n\nFiles: SKILL.md (2990b), _meta.json (130b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: zsxq-shared\nversion: 1.0.0\ndescription: \"知识星球 CLI 共享基础：认证登录（auth login/logout）、查看认证状态、诊断配置。当用户需要首次登录、退出登录、查看认证状态、或遇到认证错误时触发。\"\nmetadata:\n  requires:\n    bins: [\"zsxq-cli\"]\n  cliHelp: \"zsxq-cli auth --help\"\n---\n\n# zsxq-cli 共享规则\n\n本技能指导你如何通过 zsxq-cli 操作知识星球资源，以及有哪些注意事项。\n\n## 认证\n\nzsxq-cli 使用 **OAuth 2.0 设备授权码流程（RFC 8628）** 认证，token 存储在系统 Keychain 中，永久有效。\n\n### 登录\n\n```bash\n# 发起登录（会输出一个授权链接，用户在手机/浏览器中打开并授权）\nzsxq-cli auth login\n```\n\n登录流程：\n1. 命令输出一个 `verification_uri` 链接和 `user_code`\n2. 用户在手机或浏览器中打开链接，完成授权\n3. CLI 自动轮询，授权完成后自动保存 token\n\n> 当你作为 AI Agent 帮用户登录时，在后台运行 `zsxq-cli auth login`，读取输出后将授权链接提供给用户，等待用户完成授权。\n\n### 查看认证状态\n\n```bash\nzsxq-cli auth status        # 表格显示当前登录账户\nzsxq-cli auth status --json # JSON 格式输出\n```\n\n### 退出登录\n\n```bash\nzsxq-cli doctor             # 诊断配置和认证是否正常\n```\n\n### 配置诊断\n\n```bash\nzsxq-cli doctor             # 检查 CLI 配置和 keychain 认证状态\nzsxq-cli config show        # 显示版本信息和当前配置\nzsxq-cli config show --json # JSON 格式\n```\n\n## 直接调用 API\n\n当 Shortcut 无法满足需求时，可以直接调用底层 MCP 工具：\n\n```bash\nzsxq-cli api list                           # 列出所有可用 MCP 工具及参数\nzsxq-cli api call <tool> --params '<json>'  # 调用指定工具\nzsxq-cli api raw --method GET --path /v3/users/self\n```\n\n示例：\n\n```bash\nzsxq-cli api call get_self_info --params '{}'\nzsxq-cli api call search_groups --params '{\"keyword\":\"Go语言\"}'\nzsxq-cli api call get_user_footprints --params '{\"user_id\":\"123456\",\"group_id\":\"123456789\"}'\n\n# 推荐：对通用 HTTP API 使用显式参数的 raw 子命令\nzsxq-cli api raw --method GET --path /v2/groups/123456789/topics --query '{\"count\":10}'\n```\n\n## 安全规则\n\n- **Token 是登录凭证**，禁止在终端明文输出或分享给他人\n- **写入/删除操作前必须确认用户意图**（发帖、评论、创建笔记等）\n- 不确定 group_id / topic_id 时，先用查询命令确认，再执行写入\n\n## 常见错误处理\n\n| 错误 | 原因 | 解决方案 |\n|------|------|---------|\n| `authentication failed (HTTP 401)` | Token 无效或过期 | 重新运行 `zsxq-cli auth login` |\n| `not logged in` | 未完成登录 | 运行 `zsxq-cli auth login` |\n| `--group-id is required` | 缺少必填参数 | 先用 `zsxq-cli group +list` 查询 group_id |\n| `--topic-id is required` | 缺少必填参数 | 先用 `zsxq-cli group +topics` 或 `topic +search` 查询 topic_id |\n\nFile v0.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn7dxggz98t1mjmzn9jmtbva1d855kbt\",\n  \"slug\": \"zsxq-shared\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1776609044617\n}","readmeExcerpt":"Skill: 【官方】知识星球·登录配置 Owner: zsxq Summary: 知识星球 CLI 共享基础：认证登录（auth login/logout/status）、配置诊断（doctor/config show）、通用 API 调用规范（api list/api call/api raw 调用底层接口或原始 HTTP 接口）、星球与主题分享链接拼接（电脑端 / 手机端）、写入与删除操作... Tags: latest:1.3.1 Version history: v1.3.1 | 2026-05-22T07:27:12.852Z | auto - Expanded documentation in SKILL.md with a detailed index, command summary, and structured common error handling section. - Added an explic","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"zsxq-cli api call get_self_info --params '{}'\nzsxq-cli api call search_groups --params '{\"keyword\":\"Go语言\"}'\n\n# 跨星球查询当前用户主题足迹（不传 group_id 即查所有星球）\nzsxq-cli api call get_user_footprints --params '{\"user_id\":\"123456\"}'\n# 限定单个星球\nzsxq-cli api call get_user_footprints --params '{\"user_id\":\"123456\",\"group_id\":\"123456789\"}'"},{"language":"bash","snippet":"zsxq-cli api raw --method GET --path /v3/users/self\n\n# --body 支持简写，自动包装 req_data\nzsxq-cli api raw --method PUT --path /v2/topics/123 --body '{\"text\":\"新内容\"}'"},{"language":"text","snippet":"[1] 命中触发场景\n[2] AI 一句话提示（不打断主任务）\n    示例：\"顺带一提：刚刚这个场景比较适合反馈给知识星球官方，\n           你需要的话我可以帮你提交一条 NPS 反馈。\"\n[3] 用户拒绝 → 回到主任务，会话内不再提\n    用户接受 ↓\n[4] AI 协助起草：\n    - 询问 score（1–10），不自动赋值\n    - 起草 suggestion（≤ 500 字），以 #产品建议# 或 #工具反馈# 开头\n    - 把 score 与 suggestion 全文复述给用户确认\n[5] 用户确认 → 执行 zsxq-cli user +nps\n    用户改稿 → 回到 [4] 修订"},{"language":"bash","snippet":"# 发起登录（会输出一个授权链接，用户在手机/浏览器中打开并授权）\nzsxq-cli auth login"},{"language":"bash","snippet":"zsxq-cli auth status        # 表格显示当前登录账户\nzsxq-cli auth status --json # JSON 格式输出"},{"language":"bash","snippet":"zsxq-cli auth logout        # 清除本地凭据"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: zsxq-shared\nversion: 1.3.1\ndescription: \"知识星球 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 错误时使用。\"\nmetadata:\n  requires:\n    bins: [\"zsxq-cli\"]\n  cliHelp: \"zsxq-cli auth --help\"\n---\n\n# zsxq-cli 共享规则\n\n本技能指导你如何通过 zsxq-cli 操作知识星球资源，以及有哪些注意事项。\n\n## 索引\n\n- [Commands](#commands) — 认证、诊断、底层 API 调用命令一览\n- [认证](#认证) — OAuth 设备授权码流程\n- [直接调用 API](#直接调用-api) — `api call` / `api raw` 详细用法与示例\n- [链接拼接](#链接拼接) — 主题/星球分享链接（电脑端 / 手机端）\n- [安全规则](#安全规则) — Token、写入确认、ID 查询前置\n- [反馈提醒（NPS）](#反馈提醒nps) — 何时主动建议用户提交 NPS 反馈\n- [常见错误处理](#常见错误处理) — 通用错误（401/403/404/参数缺失/分页时间格式）\n\n## Commands\n\n| 命令 | 说明 |\n|------|------|\n| `zsxq-cli auth login` | OAuth 设备授权码登录（首次使用、token 过期或切换账户时） |\n| `zsxq-cli auth status` | 查看当前登录账户（默认表格，加 `--json` 输出 JSON） |\n| `zsxq-cli auth logout` | 清除本地凭据 |\n| `zsxq-cli doctor` | 诊断 CLI 配置与 keychain 认证状态 |\n| `zsxq-cli config show` | 显示版本信息与当前配置（加 `--json` 输出 JSON） |\n| `zsxq-cli api list` | 列出所有可用底层接口工具及参数 |\n| `zsxq-cli api call <tool>` | 调用底层接口工具，需配 `--params '<json>'` |\n| `zsxq-cli api raw` | 直接调用原始 HTTP 接口（需 `--method` `--path`） |\n\n详细用法见下面各小节。\n\n## 认证\n\nzsxq-cli 使用 **OAuth 2.0 设备授权码流程（RFC 8628）** 认证，token 存储在系统 Keychain 中，永久有效。\n\n### OAuth 登录流程\n\n`zsxq-cli auth login` 启动后：\n1. 命令输出一个 `verification_uri` 链接和 `user_code`\n2. 用户在手机或浏览器中打开链接，完成授权\n3. CLI 自动轮询，授权完成后自动保存 token\n\n> 当你作为 AI Agent 帮用户登录时，在后台运行 `zsxq-cli auth login`，读取输出后将授权链接提供给用户，等待用户完成授权。\n\n## 直接调用 API\n\n当 Shortcut 无法满足需求时，可以直接调用底层接口（参数与方法见上面 Commands 表）。\n\n`api call` 示例：\n\n```bash\nzsxq-cli api call get_self_info --params '{}'\nzsxq-cli api call search_groups --params '{\"keyword\":\"Go语言\"}'\n\n# 跨星球查询当前用户主题足迹（不传 group_id 即查所有星球）\nzsxq-cli api call get_user_footprints --params '{\"user_id\":\"123456\"}'\n# 限定单个星球\nzsxq-cli api call get_user_footprints --params '{\"user_id\":\"123456\",\"group_id\":\"123456789\"}'\n```\n\n`api raw` 示例：\n\n```bash\nzsxq-cli api raw --method GET --path /v3/users/self\n\n# --body 支持简写，自动包装 req_data\nzsxq-cli api raw --method PUT --path /v2/topics/123 --body '{\"text\":\"新内容\"}'\n```\n\n> 列表/查询类操作请优先使用 `api call`（如 `get_group_topics`），`api raw` 主要用于 `api call` 尚未覆盖的写入接口。\n>\n> `api raw` 响应已去除三层嵌套，直接返回数据内容。\n\n## 链接拼接\n\n当用户需要分享链接时，使用以下模板拼接。输出时同时提供电脑端和手机端两个版本。\n\n### 主题链接\n\n- 电脑端：`https://wx.zsxq.com/group/{group_id}/topic/{topic_id}`\n- 手机端：`https://wx.zsxq.com/mweb/views/topicdetail/topicdetail.html?topic_id={topic_id}&group_id={group_id}`\n\n### 星球链接\n\n- 电脑端：`https://wx.zsxq.com/group/{group_id}`\n- 手机端：`https://wx.zsxq.com/mweb/views/topic/topic.html?group_id={group_id}`\n\n## 安全规则\n\n- **Token 是登录凭证**，禁止在终端明文输出或分享给他人\n- **写入/删除操作前必须确认用户意图**（发帖、编辑、评论、回答、创建笔记、删除主题或笔记、提交 NPS 反馈等）\n- 不确定 group_id / topic_id / note_id 时，先用查询命令确认，再执行写入或删除\n\n## 反馈提醒（NPS）\n\n当用户在使用 zsxq-* skill 过程中遇到「适合反馈给知识星球官方」的场景时，AI 应在完成主任务后顺带一句提示用户考虑提交 NPS 反馈（[`zsxq-cli user +nps`](../zsxq-user/references/zsxq-user-nps.md)）。\n\n### 触发场景\n\n| # | 场景 | 信号 | "},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7dxggz98t1mjmzn9jmtbva1d855kbt\",\n  \"slug\": \"zsxq-shared\",\n  \"version\": \"1.3.1\",\n  \"publishedAt\": 1779434832852\n}"},{"path":"skill-card.md","content":"## Description:\n\nProvides shared Knowledge Planet CLI guidance for authentication, diagnostics, direct API calls, share-link construction, safe write/delete rules, NPS feedback prompts, and common error handling.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[zsxq](https://clawhub.ai/user/zsxq)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and agents use this skill to operate zsxq-cli for Knowledge Planet authentication, account diagnostics, direct API calls, share-link generation, and safe handling of write or delete workflows.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill can guide zsxq-cli actions against a user's Knowledge Planet account, including raw API calls, writes, deletes, and NPS feedback submission.\n\nMitigation: Review and explicitly approve write, delete, raw API, and feedback actions before execution, and confirm resource IDs before modifying or deleting content.\n\nRisk: Authentication tokens grant account access and could be exposed if printed or shared.\n\nMitigation: Do not display, log, or share authentication tokens; use zsxq-cli status and diagnostic commands without revealing credentials.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/zsxq/skills/zsxq-shared)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Shell commands, Configuration, API calls]\n\n**Output Format:** [Markdown guidance with inline shell command examples and URL templates]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires zsxq-cli and an authenticated Knowledge Planet account for account operations.]\n\n## Skill Version(s):\n\n1.3.1 (source: SKILL.md frontmatter and server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"知识星球 CLI 共享基础：认证登录（auth login/logout/status）、配置诊断（doctor/config show）、通用 API 调用规范（api list/api call/api raw 调用底层接口或原始 HTTP 接口）、星球与主题分享链接拼接（电脑端 / 手机端）、写入与删除操作... Skill: 【官方】知识星球·登录配置 Owner: zsxq Summary: 知识星球 CLI 共享基础：认证登录（auth login/logout/status）、配置诊断（doctor/config show）、通用 API 调用规范（api list/api call/api raw 调用底层接口或原始 HTTP 接口）、星球与主题分享链接拼接（电脑端 / 手机端）、写入与删除操作... Tags: latest:1.3.1 Version history: v1.3.1 | 2026-05-22T07:27:12.852Z | auto - Expanded documentation in SKILL.md with a detailed index, command summary, and structured common error handling section. - Added an explic","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":986,"uniquenessScore":50,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T15:20:10.055Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T15:20:10.055Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T17:37:42.763Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}