用途:该技能用于以最终用户身份操作 popopo.js 命令行客户端,把用户请求翻译成一条具体的 popopo 命令并执行。适用于需要安装并使用 popopo 命令、在鉴权与目标选择正确后执行读写操作的场景。
安装与快速验证:命令不可用时优先使用 bun i -g popopo.js 安装,然后执行 popopo --help 确认可用;先运行无害的只读命令验证安装,再运行最小命令确认鉴权与目标选择无误后才尝试写入流程。
使用方式:先确认所需标识符与鉴权状态再执行写操作;输出需要解析、比较或回引给用户时优先加 --json。探索未知状态时从只读命令入手,例如 me、lookup、user get、spaces get、lives get、list 或 current。需要命令目录或标志说明时再查阅 references/commands.md。
会话与输出:默认会话文件为 .popopo-session.json,可用 --session-file 覆盖;除传入 --no-persist 外,带鉴权的命令会自动持久化更新后的会话状态。对象结果即使不加 --json 也按格式化 JSON 打印,但流式与 watch 流程有自定义人类可读输出,因此输出稳定性重要时仍应加 --json。仅当默认资源路径缺失或调用方明确需要另一套资源时,才传 --strings <path>。
命令选择:鉴权命令用于登录、注册、凭据关联、手机验证与令牌查询;user 命令用于资料注册与字段更新;spaces 用于房间查询、连接信息、聊天消息与 watch 循环;lives 用于直播发现、进入、评论、选择、powers 与音频发布接收;skins、coins、invites、notifications、push、calls、tso 仅在请求明确指向相应领域时使用。
限制与注意事项:未使用过的命令需先从 popopo --help 或 references/commands.md 核对必填标志;在明确当前会话指向哪个账号与目标资源前避免写命令;自动化或重复调试时建议显式传入 --session-file、--space-key、--live-id、--user-id 等标识符;长时间运行的 watch 或音频命令应尽量设置超时或字节上限,以便可预期地终止。其他收费、平台与效果信息资料未提供。