金数据

要解决的问题

金数据的表单搭建与数据管理长期只能在网页后台完成。新建一张问卷要逐个拖字段、配选项、设显示规则；清理脏数据要把导出的 Excel 手工筛一遍；改个选项文案还要担心历史数据引用失效。当这些步骤需要重复几十次时，手工点击就成了主要成本。

技能如何工作

这个技能把金数据平台封装成一组 MCP 工具，让 Agent 用自然语言驱动表单的创建、复制、移动、字段编辑、主题修改，以及 entries 的增删改查与导出。

核心流程大致是：

• 先看再动：操作未知表单前先调 get_form 拿到字段结构，包括每个字段的 api_code、选项的 choices[].api_code 和表格的 dimensions[].api_code。写入数据的键必须是 api_code，传中文 label 会被服务端静默丢弃。
• 过滤下推：查询用 list_entries 的 filters=[{field, operator, value}]，单次上限 50 条，超出用 serial_number 游标翻页，比拉全量再本地筛快得多。
• 先列再改：批量更新或删除前先拉出命中记录展示给用户，确认后逐条循环调用 update_entry 或 delete_entry，每 20 条汇报一次进度。
• 永不主动开 PUT：update_entry 默认走 PATCH，只改提供的字段；is_put=true 会清空未提供的字段，只有在用户明确说「整条替换」且已列全字段时才允许，并需二次确认。
• 脱敏输出：手机号、邮箱、身份证默认打码，除非用户明确要求原文。

表单场景也分得很清楚：普通表单用 create_form，考试表单用 create_exam_form（支持答案与自动判分），测评表单用 create_evaluation_form（支持选项计分与维度报告）。

适用边界

技能只处理金数据线上平台（jinshuju.net）的操作。以下场景应该直接交给通用能力，不要调用任何 MCP 工具：

• 用代码或前端项目从零开发表单、问卷、评估系统；
• 处理本地文件、Excel / CSV 或文档分析；
• 图片、账单、票据的 OCR 识别；
• 物流、监控等与金数据无关的自动化。

另有几条容易踩的坑：选项字段必须传 api_code 而不是中文文案，否则返回 400；like 不支持 SQL 通配符，传「张%」会按字面匹配；field_rules 是全量替换语义，只传新增规则会静默清空其余规则，改动前要先带 include_field_rules=true 读全量再合并；删除字段或选项前先用 check_field_data 查，has_data=true 意味着历史数据会被永久清除。

MCP 不可用时，技能会明确告知用户并引导排查端点与认证方式，不会改用浏览器自动化或直接调 REST API 绕过——这类非标方式会产生中文乱码和字段不兼容的错误表单。