问卷网 Skill 综合评估
核心用法
问卷网 Skill 是问卷网（wenjuan.com）官方推出的在线问卷调查工具，覆盖调研（survey）、测评/考试（assess）、投票/评选（vote）、表单/报名（form）四大核心场景。用户可通过统一入口 workflow_create_and_publish.js 完成从创建到发布的完整流程，支持多种题目来源：默认模板、本地 JSON 文件（-f）、远程链接（--url）、标准输入（--stdin），以及 txt/docx/xlsx/pdf 等设计稿格式（需先转为 JSON）。
关键区分点：创建时必须显式指定 --type，避免将投票、表单、测评误作为默认的 survey 类型，否则题型与后台能力不匹配。
显著优点
- 全流程覆盖：创建→编辑→发布→数据查看→原始导出，完整闭环
- 格式兼容性强：支持 Word、Excel、PDF 等常见文档导入
- 实时数据洞察：
overview_stats提供即时答卷数、浏览量、完成率；open_report自动打开可视化报表页 - 安全机制完善：编辑前自动执行「停止收集+项目归档」双保险，防止数据污染
- 签名认证统一：编辑、导出、统计等操作均采用
generate_sign.js同源签名，降低对接成本
潜在缺点与局限性
- 强制归档流程：编辑任何内容前必须先停止收集并归档，频繁修改时效率受限
- 文档预处理门槛：docx/xlsx/pdf 需人工或脚本预转为 JSON，非原生直传
- Token 生命周期短：JWT 过期后需重新扫码登录，无自动刷新机制
- 手机号绑定前置：首次发布强制绑定手机号，增加新用户摩擦
- WorkerBuddy 环境限制：无图形界面时需手动复制二维码链接到本地浏览器扫码
适合人群
- 市场调研、学术研究、活动组织者需快速搭建专业问卷
- 企业 HR、培训师需 360 评估、考试测评、满意度调查
- 社群运营者需投票评选、报名表单、趣味测试
- 数据分析师需批量导出原始答卷进行深度加工
常规风险
| 风险类型 | 具体表现 | 缓解措施 |
|---------|---------|---------|
| 数据丢失风险 | 编辑中强制归档可能中断正在进行的回收 | 提前规划回收时段，避免高峰期修改 |
| 凭证泄露风险 | `~/.wenjuan/token.json` 存储敏感令牌 | 确保目录权限 600，勿提交到版本控制 |
| 签名过期风险 | 时间戳有效期短，请求延迟可能导致 401 | 失败时自动重生成签名重试 |
| 类型误配风险 | 投票/表单/测评错用 survey 类型导致功能缺失 | 严格按场景传 `--type` 参数 |
| 版本兼容风险 | Node.js 18+ 要求，旧环境可能无法运行 | 先用 `setup.sh -c` 检测环境 |
技术实现亮点
- 采用 ai_skills 统一签名体系（
appkey/web_site/timestamp/signature） token_store.js实现多层级凭证管理（项目级 → 用户级 → 环境变量）project_edit_guard.js守卫模式确保编辑操作的原子性与数据一致性