wjx-cli 0.1.13 → 0.1.14

package/README.md

@@ -85,8 +85,8 @@ npm install -g wjx-cli
 ### 从源码安装（开发者）
 
 ```bash
-git clone https://codeup.aliyun.com/6445da2d020eabef3107e22e/wjxfc/wjxagents.git
-cd wjxagents/wjx-ai-kit
+git clone https://github.com/wjxcom/wjx-ai-kit.git
+cd wjx-ai-kit
 npm install
 npm run build --workspace=wjx-api-sdk
 npm run build --workspace=wjx-cli

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

@@ -1,20 +1,61 @@
 ---
 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 69 subcommands across 15 modules.
+homepage: https://www.wjx.cn
+version: 1.0.0
 ---
 
 # wjx-cli 使用指南
 
 wjx-cli 是问卷星 OpenAPI 的命令行工具。所有命令格式：`wjx <模块> <操作> [选项]`。
 
+## 触发场景
+
+以下情况应直接使用本 Skill：
+
+- 用户提到「问卷」「调查」「收集」「表单」「投票」「考试」「测评」「满意度」「NPS」「问卷星」「wjx」等关键词
+- 用户说「帮我做个调查」「创建问卷」「查看答卷」「分析数据」「导出数据」等
+- 用户需要管理通讯录、部门、子账号、SSO 等企业功能
+
+### 模糊场景
+
+| 用户表述 | 处理方式 |
+|---------|---------|
+| 「帮我做个调查/问卷」 | `wjx survey create-by-text --text "..."` |
+| 「做个考试/测验」 | `wjx survey create-by-text --text "..." --type 6` |
+| 「做个投票」 | `wjx survey create-by-text --text "..." --type 3` |
+| 「做个表单/报名表」 | `wjx survey create-by-text --text "..." --type 7` |
+| 「看看问卷结果」 | 先 `wjx survey list` 找 vid，再 `wjx response report --vid <vid>` |
+| 「导出答卷数据」 | `wjx response download --vid <vid>` |
+| 「分析 NPS 得分」 | `wjx analytics nps --scores "[9,10,7,3]"` |
+| 「导入联系人」 | `wjx contacts add --users '[...]'`（需 `WJX_CORP_ID`） |
+| 「查看问卷链接」 | `wjx survey url --vid <vid>` |
+
 ## 安装与配置
 
+### 快速安装（推荐）
+
+```bash
+./setup.sh -y    # 自动检测环境 → 安装 wjx-cli → 引导获取 API Key → 配置 → 验证
+```
+
+### 手动安装
+
 ```bash
 npm install -g wjx-cli
 wjx init              # 交互式配置：API Key、Base URL、Corp ID → ~/.wjxrc
 wjx doctor            # 检查连接状态
 ```
 
+### 其他选项
+
+```bash
+./setup.sh       # 交互式安装
+./setup.sh -c    # 仅检查环境
+./setup.sh -v    # 验证安装
+./setup.sh -h    # 显示帮助
+```
+
 ## 全局选项
 
 | 选项 | 说明 |
@@ -24,7 +65,7 @@ wjx doctor            # 检查连接状态
 | `--dry-run` | 预览 API 请求，不实际发送 |
 | `--stdin` | 从 stdin 读取 JSON 参数（可访问 SDK 全部参数） |
 
-## 命令总览（15 模块，58 命令）
+## 命令总览（15 模块，69 命令）
 
 | 模块 | 命令 | 说明 |
 |------|------|------|
@@ -46,7 +87,7 @@ wjx doctor            # 检查连接状态
 
 ## 核心工作流
 
-### 1. 创建问卷（推荐：DSL 文本格式）
+### 工作流 1：创建问卷（DSL 文本格式）
 
 ```bash
 # AI Agent 推荐使用 DSL 文本格式
@@ -65,7 +106,7 @@ wjx survey create-by-text --text "问卷标题
 
 JSON 创建或复制问卷见 [references/survey-commands.md](references/survey-commands.md)。
 
-### 2. 查询与分析答卷
+### 工作流 2：查询与分析答卷
 
 ```bash
 wjx response report --vid 12345           # 统计报告（建议第一步）
@@ -81,7 +122,7 @@ wjx analytics decode --submitdata "1\$1}2\$3|4"
 
 完整答卷查询参数（筛选、分页、条件）见 [references/response-commands.md](references/response-commands.md)。
 
-### 3. 管理通讯录与账号
+### 工作流 3：管理通讯录与账号
 
 ```bash
 wjx contacts add --users '[{"userid":"u1","name":"Alice","mobile":"13800000001"}]'
@@ -92,6 +133,24 @@ wjx account add --subuser user1 --password pass123 --role 1
 
 角色编号：1=系统管理员, 2=问卷管理员, 3=统计查看, 4=完整查看。所有参数见 [references/contacts-commands.md](references/contacts-commands.md)。
 
+### 工作流 4：考试/测评问卷
+
+```bash
+# 创建考试问卷（type=6）
+wjx survey create-by-text --text "JavaScript 基础测验
+
+1. typeof null 的结果是？[单选题]
+\"null\"
+\"undefined\"
+\"object\"
+\"boolean\"
+
+2. 请解释闭包的概念 [填空题]" --type 6
+
+# 也可使用示例文件
+wjx survey create-by-text --file examples/exam_survey.txt --type 6
+```
+
 ## 常用枚举值
 
 | 参数 | 值 |
@@ -101,6 +160,48 @@ wjx account add --subuser user1 --password pass123 --role 1
 | 下载格式 (`--suffix`) | 0=CSV, 1=SAV, 2=Word |
 | 排序方式 (`--sort`) | 0=升序, 1=降序 |
 
+## 常见错误与处理
+
+| 错误信息 | 原因 | 解决方案 |
+|---------|------|---------|
+| `API Key is required` | 未配置 API Key | 运行 `wjx init` 或设置 `WJX_API_KEY` 环境变量 |
+| `Invalid API Key` | API Key 错误或过期 | 登录问卷星重新获取 API Key |
+| `vid is required` | 未指定问卷 ID | 先 `wjx survey list` 查看问卷列表获取 vid |
+| `Corp ID is required` | 通讯录操作需企业 ID | 运行 `wjx init` 配置 `WJX_CORP_ID` |
+| `Network Error` | 网络连接问题 | 检查网络，或用 `--dry-run` 预览请求 |
+
+## 环境变量
+
+| 变量 | 必填 | 说明 |
+|------|:---:|------|
+| `WJX_API_KEY` | 是 | 问卷星 OpenAPI API Key |
+| `WJX_CORP_ID` | 否 | 企业通讯录 ID（通讯录相关操作需要） |
+| `WJX_BASE_URL` | 否 | 自定义 API 基础域名（默认 `https://www.wjx.cn`） |
+
+凭据优先级：`--api-key` 参数 > 环境变量 > `~/.wjxrc` 配置文件。
+
+## 目录结构
+
+```
+wjx-cli-use/
+├── SKILL.md                              # 本文档（AI 读取入口）
+├── README.md                             # 场景化宣传文档
+├── package.json                          # 元数据
+├── setup.sh                              # 环境检测与安装脚本
+├── pack_skill.sh                         # 打包分发 zip
+├── examples/                             # DSL 示例文件
+│   ├── nps_survey.txt                    # NPS 调查示例
+│   ├── satisfaction_survey.txt           # 满意度调查示例
+│   └── exam_survey.txt                   # 考试问卷示例
+└── references/                           # 详细参考文档（按需读取）
+    ├── dsl-syntax.md                     # DSL 语法，28 种题型标签
+    ├── survey-commands.md                # survey 模块全部子命令
+    ├── response-commands.md              # 答卷查询、筛选、下载
+    ├── contacts-commands.md              # 通讯录、部门、管理员、标签、子账号、SSO
+    ├── analytics-commands.md             # NPS/CSAT/异常检测/数据解码
+    └── question-types.md                 # 题型编码映射表
+```
+
 ## 参考文件（按需读取）
 
 - [DSL 语法](references/dsl-syntax.md) — create-by-text 的完整 DSL 格式，28 种题型标签

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wjx-cli",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "问卷星 (Wenjuanxing) CLI — AI Agent 原生命令行工具",
   "main": "dist/index.js",
   "bin": {
@@ -30,8 +30,8 @@
   "type": "module",
   "repository": {
     "type": "git",
-    "url": "https://codeup.aliyun.com/6445da2d020eabef3107e22e/wjxfc/wjxagents.git",
-    "directory": "wjx-ai-kit/wjx-cli"
+    "url": "https://github.com/wjxcom/wjx-ai-kit.git",
+    "directory": "wjx-cli"
   },
   "dependencies": {
     "commander": "^14.0.3",