Zsxq User

# user +footprints（查看主题足迹）

本 skill 对应 shortcut：`zsxq-cli user +footprints`。

查看当前用户在**所有星球**中最近发过的主题，按时间倒序排列。

## 命令

```bash
# 查看最近 20 条足迹（表格显示）
zsxq-cli user +footprints

# 指定数量
zsxq-cli user +footprints --limit 30

# JSON 格式（含完整字段）
zsxq-cli user +footprints --json

# 翻页（使用上一页返回的 create_time 作为游标）
zsxq-cli user +footprints --end-time "2025-11-01T00:00:00.000+0800"
```

## 参数

| 参数 | 必填 | 说明 |
|------|------|------|
| `--limit <n>` | 否 | 返回条数，默认 20，最大 30 |
| `--end-time <time>` | 否 | 分页游标，传入上一页最后一条的 `create_time` |
| `--json` | 否 | 输出原始 JSON |

## 输出（表格模式）

| TOPIC ID | TYPE | TITLE / DIGEST | GROUP | CREATED AT |
|----------|------|----------------|-------|------------|
| 111222333444 | talk | 示例主题标题 | 示例星球 | 2026-04-10T09:00:00.000+0800 |

## 说明

跨星球查询。与 `group +topics` 的区别：

| | `user +footprints` | `group +topics` |
|---|---|---|
| 范围 | **所有星球** | 单个星球 |
| 内容 | 用户在各星球发过的主题 | 星球内最新主题 |
| 必填参数 | 无 | `--group-id` |

## 错误说明

| 症状 | 可能原因 | 处理 |
|------|---------|------|
| 返回空列表 | 当前账户近期未在任何星球发主题 | 正常情况，无需处理 |

通用错误（401、`--end-time` 格式错误等）见 [zsxq-shared](../../zsxq-shared/SKILL.md#常见错误处理)。

## 参考

- [zsxq-user-info](zsxq-user-info.md) — 查看用户 ID 等基本信息
- [zsxq-group-topics](../../zsxq-group/references/zsxq-group-topics.md) — 查看单个星球的主题列表
- [zsxq-shared](../../zsxq-shared/SKILL.md)


# user +info（查看个人资料）

本 skill 对应 shortcut：`zsxq-cli user +info`。

获取当前登录账户的完整个人资料，包括 user_id、昵称、地区、认证状态、订阅信息等。

## 命令

```bash
# 查看个人资料（JSON 输出）
zsxq-cli user +info

# 使用 --json 标志（效果相同，+info 始终输出 JSON）
zsxq-cli user +info --json
```

## 参数

| 参数 | 必填 | 说明 |
|------|------|------|
| `--json` | 否 | 输出原始 JSON（+info 默认即 JSON 输出） |

## 输出字段说明

```json
{
  "user": {
    "user_id": "123456",
    "name": "示例用户",
    "unique_id": "demo_user",
    "location": "示例城市",
    "avatar_url": "https://..."
  },
  "identity_status": "authenticated",
  "subscribed_wechat": true,
  "accounts": {
    "wechat": {
      "name": "示例微信昵称"
    }
  }
}
```

字段含义：

- `user.user_id`：用户 ID，是 `get_user_footprints`、`get_user_groups` 等 API 的参数
- `user.unique_id`：唯一标识（类似用户名）
- `identity_status`：实名认证状态，`authenticated` 表示已实名
- `subscribed_wechat`：是否关注公众号
- `accounts`：第三方账户绑定信息

## 说明

- 常用于获取 `user_id` 给其他命令使用，或在切换账户后核对当前登录身份

## 错误说明

| 症状 | 可能原因 | 处理 |
|------|---------|------|
| 输出账户与预期不符 | 当前 keychain 中保存的是其他账户 | `zsxq-cli auth logout` 后重新登录 |

通用错误（401 等）见 [zsxq-shared](../../zsxq-shared/SKILL.md#常见错误处理)。

## 参考

- [zsxq-shared](../../zsxq-shared/SKILL.md) — 认证与登录
- [zsxq-group-list](../../zsxq-group/references/zsxq-group-list.md) — 查看星球列表


# user +nps（提交 NPS 反馈）

> **版本要求：** 需要 `zsxq-cli` ≥ **0.4.6**。低于该版本时 `+nps` 不存在，命令会被识别为未知 shortcut。

本 skill 对应 shortcut：`zsxq-cli user +nps`。

向知识星球官方提交 NPS（Net Promoter Score，净推荐值）反馈，包含 1–10 分的推荐分数和文字建议。

> [!CAUTION]
> 这是**写入操作** —— 反馈会发送给知识星球官方。执行前必须向用户确认：
> 1. 推荐分数（`--score`，1–10 的整数）
> 2. 文字建议内容（`--suggestion`，必填，500 字以内）

## 命令

```bash
# 提交分数 + 文字建议（两者均必填）
zsxq-cli user +nps \
  --score 9 \
  --suggestion "希望增加更多互动功能"
```

## 参数

| 参数 | 必填 | 说明 |
|------|------|------|
| `--score <n>` | **是** | NPS 推荐分数，整数 1–10（1 = 完全不推荐，10 = 极力推荐） |
| `--suggestion <text>` | **是** | 文字建议，最长 500 字。建议以 `#产品建议#` 或 `#工具反馈#` 开头标注问题性质，便于官方分流 |
| `--json` | 否 | 输出原始 JSON |

## 输出

```
✓ NPS feedback submitted
```

## 说明

- 提交无频率限制，可多次提交。AI 在执行前仍应每次都向用户确认内容，避免误触发
- NPS 分数语义：
  - 推荐者（Promoters）9–10：忠实用户，会主动推荐
  - 中立者（Passives）7–8：满意但不会主动推荐
  - 贬损者（Detractors）1–6：不满意，可能有负面口碑
- 主动触发场景：当用户在使用 skill 过程中表达对产品不满、产品缺能力、CLI 工具未封装、或多次重试受挫时，参见 [zsxq-shared 反馈提醒](../../zsxq-shared/SKILL.md#反馈提醒nps)。

## 推荐工作流

```bash
# 第一步：与用户确认分数和建议
# AI 复述分数与建议内容，并核对建议字数 ≤ 500，等待用户确认

# 第二步：执行提交
zsxq-cli user +nps --score 9 --suggestion "希望增加更多互动功能"
```

## 失败语义

提交失败即原子回滚 —— 不会留下半成品反馈记录。重试前请先确认参数是否合法。

## 错误说明

| 错误 | 原因 | 解决方案 |
|------|------|---------|
| 提示仅列出 `+footprints` / `+info` 等 shortcut，未识别 `+nps` | 当前 zsxq-cli 版本低于 0.4.6 | 运行 `npm i -g zsxq-cli@latest` 升级，再用 `zsxq-cli config show` 确认版本 ≥ 0.4.6 |
| `--score must be 1–10` | 分数超出范围或非整数 | 改为 1–10 的整数 |
| `--suggestion exceeds