wjx-cli 0.1.9 → 0.1.11

package/bundled/wjx-cli-expert.md

@@ -0,0 +1,102 @@
+---
+name: wjx-cli-expert
+description: 问卷星 CLI 专家子Agent，通过 wjx 命令行工具完成问卷创建、数据回收、分析等全部操作
+model: sonnet
+tools:
+  - Bash
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+---
+
+# 问卷星 CLI 专家 Agent
+
+你是问卷星（Wenjuanxing）平台操作专家。你通过 `wjx` 命令行工具完成所有问卷星相关任务。
+
+## 可用技能
+
+你有一个配套的 CLI 使用指南技能，位于 `wjx-skills/wjx-cli-use/`：
+
+- **`wjx-skills/wjx-cli-use/SKILL.md`** — ���令总览、核心工作流、常用枚举值
+- **`wjx-skills/wjx-cli-use/references/`** — 按需查阅的详细参考：
+  - `dsl-syntax.md` — DSL 文本语法（create-by-text 用）
+  - `survey-commands.md` — survey 模块全部参数
+  - `response-commands.md` — response 模块全部参数
+  - `contacts-commands.md` — contacts/department/admin/tag/account/sso 参数
+  - `analytics-commands.md` — analytics 本地分析命令
+  - `question-types.md` — q_type/q_subtype 完整映射表
+
+**工作方式：先读 SKILL.md 获取全局视图，遇到具体参数问题时再读对应的 references 文件。**
+
+## 你的职责
+
+1. **问卷设计与创建** — 根据用户需求设计问卷，优先使用 `wjx survey create-by-text`
+2. **数据回收与查询** — 查询答卷、下载报告、监控回收进度
+3. **数据分析** — NPS/CSAT 计算、异常检测、趋势对比
+4. **通讯录管理** — 联系人/部门/标签的增删改查
+5. **账号与权限** — 子账号管理、SSO 链接生成
+
+## 环境检查
+
+在执行任务前，先确认 CLI 已配置：
+
+```bash
+wjx doctor
+```
+
+未配置则引导用户运行 `wjx init` 或设置 `WJX_API_KEY` 环境变量。
+
+## 工作原则
+
+### 创建问卷
+
+1. 优先用 `wjx survey create-by-text --text "..."` — 需要 DSL 语法时读 `references/dsl-syntax.md`
+2. 创建前用 `--dry-run` 预览解析结果
+3. 创建后用 `wjx survey get --vid N` 验证
+4. 向用户提供编辑链接：`wjx survey url --mode edit --activity N`
+5. 向用户提供预览链接：通过 SDK 的 `buildPreviewUrl` 或告知用户在编辑页面预览
+
+### 考试问卷注意事项
+
+- 创建考试问卷时 `--type 6`，考试中的单选/多选/填空自动变为考试题型
+- **API 限制**：考试的正确答案和每题分值无法通过 API 设置，创建后必须提供 `wjx survey url --mode edit --activity N` 编辑链接，指引用户在网页端手动配置答案与评分
+- 创建考试后使用 `wjx survey update-settings --vid N --time_setting '...'` 设置考试时间限制
+
+### 查询数据
+
+1. `wjx response report --vid N` — 统计概览（首选）
+2. `wjx response query --vid N` — 明细数据
+3. `wjx response download --vid N` — 批量导出
+
+### 分析数据
+
+获取数据 → `analytics decode` 解码 → 选择分析方法（nps/csat/anomalies）→ 给出结论
+
+### 参数不确定时
+
+用 CLI 内置参考：`wjx reference dsl`、`wjx reference question-types` 等，或读取对应的 references 文件。
+
+### 安全原则
+
+- **破坏性操作执行前必须确认**：`survey delete`、`response clear`、`survey clear-bin`
+- 批量操作先告知影响范围
+- 首次操作用 `--dry-run` 预览
+
+### 输出规范
+
+- JSON 输出到 stdout，错误输出到 stderr
+- 退出码：0=成功，1=API/认证错误，2=输入错误
+- 向用户报告时提供关键信息（vid、URL、数量等）
+
+## 常见错误与处理
+
+| 错误信息 | 原因 | 处理方式 |
+|---------|------|---------|
+| "该问卷没有题目" | 尝试发布空问卷 | 先添加题目再发布 |
+| "状态不能直接更新到X" | 违反状态转换规则 | 遵循合法路径：0→1→2↔1, 1/2→3。不可跳过中间状态 |
+| "username参数有误" | 用户名不匹配 | 从 `wjx survey list` 返回的 `creater` 字段获取正确用户名 |
+| 下载/报告请求超时 | 大数据量生成耗时 | 耗时操作已使用120s超时，可重试一次 |
+| `wjx contacts query` 返回空 | uid 不精确 | uid 必须完全匹配，不支持模糊搜索或通配符 |
+| 多项填空创建失败 | 缺少填空占位符 | 题目文本中必须包含 `{_}` 占位符 |

package/bundled/wjx-cli-use/SKILL.md

@@ -0,0 +1,111 @@
+---
+name: wjx-cli-use
+description: Guide for using wjx-cli (Wenjuanxing CLI) to create surveys, query responses, and analyze data. Use when the user wants to interact with the Wenjuanxing (问卷星) platform via CLI commands, including creating surveys with specific question types, querying response data, managing contacts, or performing analytics. Covers all 58 subcommands across 15 modules.
+---
+
+# wjx-cli 使用指南
+
+wjx-cli 是问卷星 OpenAPI 的命令行工具。所有命令格式：`wjx <模块> <操作> [选项]`。
+
+## 安装与配置
+
+```bash
+npm install -g wjx-cli
+wjx init              # 交互式配置：API Key、Base URL、Corp ID → ~/.wjxrc
+wjx doctor            # 检查连接状态
+```
+
+## 全局选项
+
+| 选项 | 说明 |
+|------|------|
+| `--api-key <key>` | API Key（覆盖环境变量/配置文件） |
+| `--table` | 输出为可读表格（默认 JSON） |
+| `--dry-run` | 预览 API 请求，不实际发送 |
+| `--stdin` | 从 stdin 读取 JSON 参数（可访问 SDK 全部参数） |
+
+## 命令总览（15 模块，58 命令）
+
+| 模块 | 命令 | 说明 |
+|------|------|------|
+| `survey` | list, get, create, create-by-text, delete, status, settings, update-settings, tags, tag-details, clear-bin, upload, export-text, url | 问卷增删改查与配置 |
+| `response` | query, realtime, download, submit, modify, clear, report, winners, 360-report, count | 答卷数据操作 |
+| `contacts` | query, add, delete | 联系人管理（需要 WJX_CORP_ID） |
+| `department` | list, add, modify, delete | 部门管理 |
+| `admin` | add, delete, restore | 管理员管理 |
+| `tag` | list, add, modify, delete | 标签管理 |
+| `user-system` | add-participants, modify-participants, delete-participants, bind, query-binding, query-surveys | 用户系统（已过时） |
+| `account` | list, add, modify, delete, restore | 子账号管理 |
+| `sso` | subaccount-url, user-system-url, partner-url | SSO 链接生成 |
+| `analytics` | decode, nps, csat, anomalies, compare, decode-push | 本地分析（无需 API Key） |
+| `init` | （独立命令） | 交互式配置向导 |
+| `doctor` | （独立命令） | 环境诊断 |
+| `completion` | bash, zsh, fish, install | Shell 自动补全 |
+| `skill` | install, update | 管理 Claude Code 技能（安装/更新 wjx-cli-use） |
+| `update` | （独立命令） | 自更新 wjx-cli 到最新版本 |
+
+## 核心工作流
+
+### 1. 创建问卷（推荐：DSL 文本格式）
+
+```bash
+# AI Agent 推荐使用 DSL 文本格式
+wjx survey create-by-text --text "问卷标题
+
+可选描述
+
+1. 题目文本[单选题]
+选项A
+选项B
+
+2. 另一个题目[填空题]"
+```
+
+考试问卷加 `--type 6`。完整 DSL 语法（含 28 种题型标签）见 [references/dsl-syntax.md](references/dsl-syntax.md)。
+
+JSON 创建或复制问卷见 [references/survey-commands.md](references/survey-commands.md)。
+
+### 2. 查询与分析答卷
+
+```bash
+wjx response report --vid 12345           # 统计报告（建议第一步）
+wjx response query --vid 12345            # 答卷明细数据
+wjx response download --vid 12345         # 批量导出（CSV/SAV/Word）
+wjx response count --vid 12345            # 答卷总数
+
+# 本地分析（无需 API）
+wjx analytics nps --scores "[9,10,7,3,8]"
+wjx analytics csat --scores "[4,5,3,5,2]"
+wjx analytics decode --submitdata "1\$1}2\$3|4"
+```
+
+完整答卷查询参数（筛选、分页、条件）见 [references/response-commands.md](references/response-commands.md)。
+
+### 3. 管理通讯录与账号
+
+```bash
+wjx contacts add --users '[{"userid":"u1","name":"Alice","mobile":"13800000001"}]'
+wjx department add --depts '["研发部/后端"]'
+wjx admin add --users '[{"userid":"u1","role":2}]'
+wjx account add --subuser user1 --password pass123 --role 1
+```
+
+角色编号：1=系统管理员, 2=问卷管理员, 3=统计查看, 4=完整查看。所有参数见 [references/contacts-commands.md](references/contacts-commands.md)。
+
+## 常用枚举值
+
+| 参数 | 值 |
+|------|-----|
+| 问卷类型 (`--type`) | 1=调查, 2=测评, 3=投票, 6=考试, 7=表单 |
+| 问卷状态 (`--state`) | 1=发布, 2=暂停, 3=删除 |
+| 下载格式 (`--suffix`) | 0=CSV, 1=SAV, 2=Word |
+| 排序方式 (`--sort`) | 0=升序, 1=降序 |
+
+## 参考文件（按需读取）
+
+- [DSL 语法](references/dsl-syntax.md) — create-by-text 的完整 DSL 格式，28 种题型标签
+- [问卷命令](references/survey-commands.md) — survey 模块全部子命令参数、JSON 创建格式、设置
+- [答卷命令](references/response-commands.md) — 查询筛选、submitdata 格式、下载选项
+- [通讯录命令](references/contacts-commands.md) — 联系人、部门、管理员、标签、子账号、SSO
+- [分析命令](references/analytics-commands.md) — NPS/CSAT/CES 公式、异常检测、数据解码
+- [题型编码](references/question-types.md) — 完整 q_type/q_subtype 映射表

package/bundled/wjx-cli-use/references/analytics-commands.md

@@ -0,0 +1,159 @@
+# Analytics Commands Reference
+
+> 所有分析命令**本地运行**，无需 API Key 或网络连接。
+> 所有命令支持 `--stdin` 传入 JSON 参数。
+
+## wjx analytics decode
+
+解码答卷提交数据（submitdata 格式）。
+
+```bash
+wjx analytics decode --submitdata "1\$1}2\$3|4}3\$hello"
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--submitdata <s>` | 是 | 提交数据字符串 |
+
+### submitdata 编码格式
+
+| 分隔符 | 含义 |
+|--------|------|
+| `}` | 题目之间分隔 |
+| `$` | 题号与答案分隔 |
+| `\|` | 多选选项之间分隔 |
+
+示例：`1$1}2$3|4}3$hello` → 第1题选1，第2题选3和4，第3题填"hello"
+
+## wjx analytics nps
+
+计算 Net Promoter Score（净推荐值）。
+
+```bash
+wjx analytics nps --scores "[9,10,7,3,8,10,9,6,8,10]"
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--scores <json>` | 是 | 评分 JSON 数组（0-10 分） |
+
+**NPS = 推荐者% - 贬损者%**（范围 -100 ~ +100）
+
+| 类别 | 分数范围 |
+|------|---------|
+| 推荐者 (Promoters) | 9-10 |
+| 被动者 (Passives) | 7-8 |
+| 贬损者 (Detractors) | 0-6 |
+
+| 评级 | NPS 范围 |
+|------|---------|
+| 优秀 | > 70 |
+| 良好 | 50-70 |
+| 一般 | 0-50 |
+| 较差 | < 0 |
+
+## wjx analytics csat
+
+计算 Customer Satisfaction Score（客户满意度）。
+
+```bash
+wjx analytics csat --scores "[4,5,3,5,2,4,5]"
+wjx analytics csat --scores "[6,7,5,7,3,6,7]" --scale "7-point"
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--scores <json>` | 是 | 评分 JSON 数组 |
+| `--scale <s>` | 否 | 量表类型：`"5-point"`（默认）或 `"7-point"` |
+
+**CSAT = 满意人数 / 总人数 × 100%**
+
+| 量表 | 满意阈值 |
+|------|---------|
+| 5-point | 4-5 分 |
+| 7-point | 5-7 分 |
+
+| 评级 | CSAT 范围 |
+|------|----------|
+| 优秀 | > 90% |
+| 良好 | 75-90% |
+| 一般 | 50-75% |
+| 较差 | < 50% |
+
+## wjx analytics anomalies
+
+检测异常答卷模式。
+
+```bash
+wjx analytics anomalies --responses '[{"submitdata":"1$1}2$1","inputcosttime":5},{"submitdata":"1$2}2$3","inputcosttime":120}]'
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--responses <json>` | 是 | 答卷数据 JSON 数组 |
+
+检测 6 种异常模式：
+1. **直线作答** — 所有题目选同一个答案
+2. **速度异常** — 完成时间 < 中位数的 30%
+3. **IP 重复** — 同一 IP 多次提交
+4. **时间聚集** — 短时间内大量提交
+5. **答案雷同** — 多份答卷内容近乎相同
+6. **矩阵直线** — 矩阵题每行选同一值
+
+## wjx analytics compare
+
+对比两组指标数据。
+
+```bash
+wjx analytics compare --set_a '{"nps":45,"csat":78}' --set_b '{"nps":52,"csat":85}'
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--set_a <json>` | 是 | 指标集 A JSON 对象（`{"指标名":数值}`） |
+| `--set_b <json>` | 是 | 指标集 B JSON 对象（`{"指标名":数值}`） |
+
+显著性阈值：|变化率| > 10% 视为显著变化。
+
+## wjx analytics decode-push
+
+解码问卷星 Webhook 推送回调数据。
+
+```bash
+wjx analytics decode-push --payload '<加密数据>' --app_key '<AppKey>'
+wjx analytics decode-push --payload '<加密数据>' --app_key '<AppKey>' --signature '<签名>' --raw_body '<原始请求体>'
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--payload <s>` | 是 | 加密数据 |
+| `--app_key <s>` | 是 | AppKey |
+| `--signature <s>` | 否 | X-Wjx-Signature 签名（用于验证） |
+| `--raw_body <s>` | 否 | 原始请求体（用于签名验证） |
+
+### Webhook 推送字段
+
+| 字段 | 说明 |
+|------|------|
+| vid | 问卷编号 |
+| jid | 答卷编号 |
+| submitdata | 编码的答卷数据 |
+| submittime | 提交时间 |
+| source | 来源（1=PC, 2=手机, 3=微信） |
+| ip | 客户端 IP |
+
+### 加密方式
+
+Webhook 数据使用 AES-128-CBC 加密：
+- Key = MD5(appKey) 前 16 字符
+- Padding: PKCS7
+- IV = 密文前 16 字节
+- 签名验证：通过 X-Wjx-Signature 头进行 SHA1 验证
+
+---
+
+## CES 参考（Customer Effort Score，客户费力度）
+
+非 CLI 命令，但分析时常用的参考指标：
+- 量表：1-7（越低越好，表示客户越省力）
+- 优秀：< 2，良好：2-3，一般：3-5，较差：> 5

package/bundled/wjx-cli-use/references/contacts-commands.md

@@ -0,0 +1,330 @@
+# Contacts, Departments, Admins, Tags, Accounts & SSO
+
+> 通讯录相关操作需要 `WJX_CORP_ID`（通过 `wjx init` 配置或环境变量）。
+> 所有通讯录命令支持 `--corpid <s>` 覆盖默认值。
+
+## Contacts 模块
+
+### wjx contacts query
+
+```bash
+wjx contacts query --uid user001
+wjx contacts query --uid user001 --corpid CORP123
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--uid <s>` | 是 | 用户编号（唯一标识） |
+| `--corpid <s>` | 否 | 通讯录编号 |
+
+### wjx contacts add
+
+批量添加或更新联系人（最多 100 人）。userid 已存在则更新。
+
+```bash
+wjx contacts add --users '[{"userid":"u1","name":"Alice","mobile":"13800000001","email":"a@b.com","department":"研发部/后端","tags":"学历/本科"}]'
+wjx contacts add --users '[...]' --auto_create_udept --auto_create_tag
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--users <json>` | 是 | 用户列表 JSON 数组 |
+| `--corpid <s>` | 否 | 通讯录编号 |
+| `--auto_create_udept` | 否 | 自动创建不存在的部门 |
+| `--auto_create_tag` | 否 | 自动创建不存在的标签 |
+
+**users 数组每项字段**：`userid`(必填), `name`(必填), `nickname`, `mobile`, `email`, `department`(用/分隔层级), `tags`(格式:组/标签), `birthday`, `gender`(0=保密/1=男/2=女), `pwd`
+
+### wjx contacts delete
+
+批量删除联系人（**不可逆**）。
+
+```bash
+wjx contacts delete --uids "user001,user002"
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--uids <s>` | 是 | 用户编号列表，逗号分隔 |
+| `--corpid <s>` | 否 | 通讯录编号 |
+
+---
+
+## Department 模块
+
+### wjx department list
+
+```bash
+wjx department list
+wjx department list --corpid CORP123
+```
+
+### wjx department add
+
+```bash
+wjx department add --depts '["研发部/后端", "产品部"]'
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--depts <json>` | 是 | 部门路径 JSON 数组，用 / 分隔层级 |
+| `--corpid <s>` | 否 | 通讯录编号 |
+
+### wjx department modify
+
+```bash
+wjx department modify --depts '[{"id":"dept123","name":"新名称","order":10}]'
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--depts <json>` | 是 | 部门对象 JSON 数组，每项含 id(必填), name, order(>0 且 <999999) |
+| `--corpid <s>` | 否 | 通讯录编号 |
+
+### wjx department delete
+
+```bash
+wjx department delete --type 1 --depts '["dept123"]'
+wjx department delete --type 2 --depts '["研发部"]' --del_child
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--type <s>` | 是 | "1"=按 ID 删除, "2"=按名称删除 |
+| `--depts <json>` | 是 | 部门标识 JSON 数组（ID 或名称） |
+| `--corpid <s>` | 否 | 通讯录编号 |
+| `--del_child` | 否 | 同时删除子部门 |
+
+---
+
+## Admin 模块
+
+### wjx admin add
+
+批量添加或修改管理员（最多 100 人）。
+
+```bash
+wjx admin add --users '[{"userid":"u1","role":2}]'
+wjx admin add --users '[{"userid":"u1","role":0,"confidential":true,"effective_date":"2026-12-31","remark":"临时管理员"}]'
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--users <json>` | 是 | 管理员 JSON 数组 |
+| `--corpid <s>` | 否 | 通讯录编号 |
+
+**users 数组每项字段**：`userid`(必填), `role`(必填: 0=系统管理员, 1=分组管理员, 2=问卷管理员, 3=统计查看, 4=完整查看, 5=部门管理员), `confidential`(是否保密), `effective_date`(有效期 yyyy-MM-dd), `remark`(备注, 最多 50 字)
+
+### wjx admin delete
+
+```bash
+wjx admin delete --uids "u1,u2"
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--uids <s>` | 是 | 管理员用户编号，逗号分隔（最多 100） |
+| `--corpid <s>` | 否 | 通讯录编号 |
+
+### wjx admin restore
+
+```bash
+wjx admin restore --uids "u1,u2"
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--uids <s>` | 是 | 管理员用户编号，逗号分隔（最多 100） |
+| `--corpid <s>` | 否 | 通讯录编号 |
+
+---
+
+## Tag 模块
+
+### wjx tag list
+
+```bash
+wjx tag list
+```
+
+### wjx tag add
+
+```bash
+wjx tag add --child_names '["学历/本科", "学历/硕士", "年龄/18-35"]'
+wjx tag add --child_names '["职级/初级", "职级/高级"]' --is_radio   # 单选标签组
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--child_names <json>` | 是 | 标签路径 JSON 数组，格式 "组/标签名" |
+| `--corpid <s>` | 否 | 通讯录编号 |
+| `--is_radio` | 否 | 标签组为单选（默认多选） |
+
+### wjx tag modify
+
+```bash
+wjx tag modify --tp_id "tag123" --tp_name "新组名"
+wjx tag modify --tp_id "tag123" --child_names '[{"id":"child1","name":"新标签名"}]'
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--tp_id <s>` | 是 | 标签组 ID（从 tag list 获取） |
+| `--tp_name <s>` | 否 | 新标签组名称 |
+| `--child_names <json>` | 否 | 子标签 JSON 数组，每项含 id 和 name |
+| `--corpid <s>` | 否 | 通讯录编号 |
+
+### wjx tag delete
+
+```bash
+wjx tag delete --type 1 --tags '["tag123"]'
+wjx tag delete --type 2 --tags '["学历"]'
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--type <s>` | 是 | "1"=按 ID, "2"=按名称 |
+| `--tags <json>` | 是 | 标签标识 JSON 数组 |
+| `--corpid <s>` | 否 | 通讯录编号 |
+
+---
+
+## Account 模块（子账号管理）
+
+### wjx account list
+
+```bash
+wjx account list
+wjx account list --role 2 --name_like "张"
+```
+
+| Flag | 说明 |
+|------|------|
+| `--subuser <s>` | 精确匹配用户名 |
+| `--name_like <s>` | 名称模糊搜索（最多 10 字符） |
+| `--role <n>` | 按角色筛选 |
+| `--group <n>` | 按分组筛选 |
+| `--page_index <n>` | 页码 |
+| `--page_size <n>` | 每页数量 |
+| `--mobile <s>` | 按手机号筛选 |
+
+### wjx account add
+
+```bash
+wjx account add --subuser user1 --password pass123 --role 1
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--subuser <s>` | 是 | 子账号用户名 |
+| `--password <s>` | 否 | 密码 |
+| `--mobile <s>` | 否 | 手机号 |
+| `--email <s>` | 否 | 邮箱 |
+| `--role <n>` | 否 | 1=系统管理员, 2=问卷管理员, 3=统计查看, 4=完整查看 |
+| `--group <n>` | 否 | 分组 ID |
+
+### wjx account modify
+
+```bash
+wjx account modify --subuser user1 --role 2
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--subuser <s>` | 是 | 子账号用户名 |
+| `--mobile <s>` | 否 | 手机号 |
+| `--email <s>` | 否 | 邮箱 |
+| `--role <n>` | 否 | 角色（1-4） |
+| `--group <n>` | 否 | 分组 ID |
+
+注意：不支持修改密码。
+
+### wjx account delete
+
+```bash
+wjx account delete --subuser user1
+```
+
+### wjx account restore
+
+```bash
+wjx account restore --subuser user1 --mobile 13800000001
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--subuser <s>` | 是 | 子账号用户名 |
+| `--mobile <s>` | 否 | 手机号 |
+| `--email <s>` | 否 | 邮箱 |
+
+---
+
+## SSO 模块（本地 URL 生成，无需 API Key）
+
+### wjx sso subaccount-url
+
+生成子账号免密登录链接。
+
+```bash
+wjx sso subaccount-url --subuser admin1
+wjx sso subaccount-url --subuser admin1 --role_id 2 --url "https://example.com/dashboard"
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--subuser <s>` | 是 | 子账号用户名 |
+| `--mobile <s>` | 否 | 手机号 |
+| `--email <s>` | 否 | 邮箱 |
+| `--role_id <n>` | 否 | 角色 ID（1-4） |
+| `--url <s>` | 否 | 登录后跳转地址 |
+| `--admin <n>` | 否 | 设为 1 以主账号身份登录 |
+
+### wjx sso user-system-url
+
+生成用户系统参与者登录链接。
+
+```bash
+wjx sso user-system-url --u admin --system_id 100 --uid user001
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--u <s>` | 是 | 账户用户名 |
+| `--system_id <n>` | 是 | 用户系统 ID |
+| `--uid <s>` | 是 | 参与者 ID |
+| `--uname <s>` | 否 | 参与者姓名 |
+| `--udept <s>` | 否 | 参与者部门 |
+| `--uextf <s>` | 否 | 扩展字段 |
+| `--upass <s>` | 否 | 密码 |
+| `--is_login <n>` | 否 | 是否登录（0 或 1） |
+| `--activity <n>` | 否 | 跳转到的问卷编号 |
+| `--return_url <s>` | 否 | 返回地址 |
+
+### wjx sso partner-url
+
+生成合作伙伴登录链接。
+
+```bash
+wjx sso partner-url --username partner1
+```
+
+| Flag | 必填 | 说明 |
+|------|------|------|
+| `--username <s>` | 是 | 合作伙伴用户名 |
+| `--mobile <s>` | 否 | 手机号 |
+| `--subuser <s>` | 否 | 子账号用户名 |
+
+---
+
+## User-System 模块（已过时）
+
+> 这些命令已标记 Deprecated，优先使用通讯录模块。仅在用户明确要求时使用。
+
+```bash
+wjx user-system add-participants --usid 100 --users '[{"uid":"u1","uname":"Alice","upass":"123"}]'
+wjx user-system modify-participants --usid 100 --users '[...]'
+wjx user-system delete-participants --usid 100 --uids '["u1","u2"]'
+wjx user-system bind --vid 12345 --usid 100 --uids '["u1"]'
+wjx user-system query-binding --vid 12345 --usid 100
+wjx user-system query-surveys --usid 100 --uid u1
+```