智蛙Skill

概述

智蛙公考练习

用于三类科目练习：申论批改、行测选择题判题与解析、面试文字作答评估。不提供正式考试成绩保证。音视频须先由宿主转成文字，图片须先识别并由用户确认答案内容。首次使用和额度说明见 [使用指南](references/user-guide.md)。

三科目能力

三科均先查询真实分类，再受控抽取一道安全题面；分类可选，不提供自由分页浏览或题目详情。

• 申论：抽取题目与材料；提交完整文字答案后异步批改，获取结构化结果与 HTML 报告。
• 行测：抽取题目与选项；用户提交答案前不展示正确答案、解析或解题思路，收到用户答案后才调用判题并返回判定与解析。行测判题不消耗 Skills 批改额度。
• 面试：抽取题目后评估文字作答，支持查询批改进度、获取报告。音视频须先转成文字。

额度不足与购买

计费提交前先查询剩余额度。额度不足时停止新的申论或面试计费提交，引导用户登录套餐中心，使用微信或支付宝完成支付。支付后重新查询额度，确认充足再继续；不新增支付 MCP 工具、不代用户下单、不索取或处理支付信息，不编造或硬编码价格、套餐金额或剩余额度。

安装完成后的用户介绍

安装完成后，主动向用户汇总本 Skill 的用途，不直接展示本文件全文，也不只返回文件路径。先简要说明安装结果，如实区分已安装、待配置 Key、连接已验证或尚未验证；本地语法与运行时检查通过不代表服务连接成功。

根据本说明及当前服务实际可用工具，主动逐项介绍三科目能力：

• 练习抽题：先查询真实科目分类，再按科目抽取一道安全题面；分类可选，不提供自由分页浏览或题目详情。
• 申论批改：提交完整答案，获取批改报告与改进建议。
• 行测练习：先只展示题目和选项；收到用户答案后才调用判题，返回对错和解析，不提前展示正确答案、解析或解题思路。
• 面试练习：评估文字作答；音视频须先由宿主转成文字。
• 任务跟踪：查询批改进度，中断后恢复已有任务，不重复提交。
• 历史报告：查找历史批改结果，获取 HTML 报告并提供本地文件路径。
• 报告风格：查看、保存和选择申论或面试的讲解风格，仅影响之后新提交的任务。
• 连接与额度：检查服务连接，查询剩余可用额度；额度不足时引导用户到套餐中心购买。

未验证的能力应说明待确认，不把未开放能力宣传为可用；图片须先识别并由用户确认答案，不承诺直接上传本地图片。最后提供 2～3 个当前可用能力的自然语言示例，如「帮我找一道申论题」「查看我最近的批改报告」「看看有哪些申论报告风格」，邀请用户开始使用。不要为了演示自动提交收费任务，不回显 Key，不默认展开安装目录、内部服务地址或脚本审查细节。

选择调用入口

Host 已发现智蛙原生 MCP 工具时，先调用 check_connection，成功后按对应学科的工具流程执行。未发现时使用本包 scripts/washine.mjs；不要求安装 Connector，也不执行 setup.sh。一次任务始终使用同一路径。

CLI 需要 Node.js 20+。执行 node –version、node –check scripts/washine.mjs 和node scripts/washine.mjs –check-runtime。缺少依赖时给出安装指引，不能假设运行时已切换。路径包含空格时必须正确引用。CLI 根据脚本位置定位配置。

配置凭据

CLI 从 Skill 根目录 config.json 读取唯一字段 ZHIWA_API_KEY。用户提供 Key 后写入该文件，尽可能设置为仅当前用户可读写；勿回显 Key 或写入日志、命令参数、文档和版本控制。原生 MCP 使用 Host 的安全凭据配置。Key 无效时引导用户到接入中心更换；不自动切换到另一套调用入口。服务地址由发布包提供，用户只需要 Key。不要要求用户填写内部服务地址。更新 Skill 时，使用本包首页提供的环境专属更新地址：https://skills.zhiwagk.com/skill/washine-skill.zip；不得切换到其他环境的安装包。

CLI 命令

node scripts/washine.mjs help
node scripts/washine.mjs --help
node scripts/washine.mjs --check-runtime
node scripts/washine.mjs list-tools
node scripts/washine.mjs check
node scripts/washine.mjs usage
node scripts/washine.mjs list-practice-categories --subject xingce
node scripts/washine.mjs draw-practice-question --subject xingce [--category 分类]
node scripts/washine.mjs grade --question-id ID --answer-file PATH --client-request-id REQUEST_ID
node scripts/washine.mjs grade --question-id ID --stdin --client-request-id REQUEST_ID
node scripts/washine.mjs grade --question-id ID --image-upload-ref REF --client-request-id REQUEST_ID
node scripts/washine.mjs list-styles --subject essay
node scripts/washine.mjs get-style --subject essay --style-id ID
node scripts/washine.mjs save-style --style-file PATH
node scripts/washine.mjs get-style-selection --subject interview
node scripts/washine.mjs select-style --subject interview --style-id ID
node scripts/washine.mjs select-style --subject interview
node scripts/washine.mjs delete-style --style-id ID
node scripts/washine.mjs grade-xingce --answers-file PATH --client-request-id REQUEST_ID
node scripts/washine.mjs grade-interview --question-id ID --answer-file PATH [--used-time 95] [--question-type 题型] --client-request-id REQUEST_ID
node scripts/washine.mjs list-reports --type all --page 1 --page-size 10
node scripts/washine.mjs resume --task-id ID --type interview
node scripts/washine.mjs report --task-id ID --type essay

help / --help / -h 本地打印可用命令（不连 MCP）。list-tools 调用服务端 tools/list，用于无 Host 原生发现时确认 MCP 实际暴露的工具（含风格相关）；不替代 Host 的协议发现。

答案文件为 UTF-8。行测文件为 {"真实题目ID":"A"} 的 JSON 对象，多选使用 "AC"。三类提交命令（grade / grade-xingce / grade-interview）均可用 –stdin 代替文件参数，只能选择一种输入来源。抽题参数为 --subject 与可选 --category。CLI stdout 为一个最终 JSON，进度在 stderr；报告正文只保存在用户指定目录或默认报告目录，不打印答案全文。

三类练习流程

练习抽题：list_practice_categories → draw_practice_question。先按科目获取后端真实分类（不含题目数量），分类可选。申论为 {category, label}，展示 label、抽题传 category 编号（1–5）；行测/面试为分类名字符串，抽题传名称。分类不存在与题量为零共用报错：「没有可用练习题，请更换科目或分类」。抽题结果含安全题面与 questionId；提交用 questionId + clientRequestId。先查询剩余额度，再提交用户提供的完整答案。费用提示不阻塞已授权的批改。

行测：draw_practice_question(subject=xingce) → grade_xingce（clientRequestId 必填）。questionId 来自同一次抽题结果；提交时以 questionId 绑定；提交后立即返回对错和解析，不需要轮询，也不消耗 Skills 批改额度。

面试：draw_practice_question(subject=interview) → grade_interview（questionId + clientRequestId）→ get_interview_task_status → get_interview_report → open_interview_report。面试单题评估消耗 1 次 Skills 批改额度；失败会自动退回。仍需有效 Key，不要推断为永久免费。

幂等与恢复

每次新作答先生成 clientRequestId；相同提交的重试必须使用相同 ID 和相同答案。CLI 支持 –client-request-id，并在发送前保存最小恢复记录；不保存凭据和输入答案。不同作答必须使用新 ID，不能通过换 ID 重试结果未知的旧任务。收到 taskId 后仅查询状态，不能重新创建。按服务端 retryAfterSeconds 轮询至 completed、failed 或 cancelled。CLI 等待上限为 15 分钟；超时使用 resume –task-id ID，面试加 –type interview（本地记录存在时可自动识别）。报告阶段失败仅使用 report 重试。网络中断时保留返回的 taskId 和 clientRequestId。

failed/cancelled（退出码 5）时解释 errorMessage/error，不再打开报告，且不可恢复；题目分值异常属于题目配置问题，不能声称用户答案得了零分。仅 completed 后获取结构化报告，再打开 HTML。HTML 资源为 type=resource、mimeType=text/html、base64 blob。CLI 原子写入本地 HTML 和 JSON，申论保存到 washine/reports/essays/智蛙-申论--<YYYYMMDD-HHmmssSSS>.html，面试保存到 washine/reports/interview/智蛙-面试--<YYYYMMDD-HHmmssSSS>.html，同名 .json 为结构化报告。时间戳由本机生成报告文件时产生。返回 reportFile、reportUri 和 reportJsonFile。交付报告文件，避免向用户输出 HTML 源码。不支持 HTML 的宿主可用报告文件由浏览器打开，不声称已经自动打开。

历史列表使用真实 taskId。type=essay 读取申论报告，type=interview 读取面试报告；打开工具必须与报告类型匹配。新面试任务按用户归属，同一账户换 Key 可以继续读取。旧版面试报告首次通过仍有效的原 Key 访问后迁移；原 Key 已撤销时需要人工核验恢复。

报告风格（风格化方法）

智蛙支持账号级「报告风格」：导入符合 washine-report-style/v1 的 Markdown 风格 Skill，并按题型（申论 / 面试）在账号上启用；新提交的申论/面试任务会快照当前对应题型选择，用于教学文案（原因说明、修改建议、训练动作），不改变既有评分分数结构。这不是 config.json 字段，也不是聊天自由文本里的“请用某某风格”临时参数。

• 接入中心网页「报告风格」页：导入、更新、启用、删除；申论与面试均可启用。
• 原生 MCP：list_styles / get_style / save_style / get_style_selection / select_style / delete_style。
• Skill CLI：list-styles / get-style / save-style / get-style-selection / select-style / delete-style。未发现原生工具时，可用 CLI 或引导用户到接入中心网页管理，不要回答“不支持风格化”。
• list-styles / list_styles 返回 { styles: 风格对象数组 }，空列表为 []。
• 仅对新任务生效；历史报告与在途任务不受影响。

申论图片作答

grade_essay 接受文字答案，或 { type: "image", uploadRef }（图片须已由上游上传并识别）。CLI：--image-upload-ref REF；与 --answer-file / --stdin 互斥。CLI 不上传本地图片，勿伪造 uploadRef。

错误与数据

退出码：0 成功；2 参数/输入问题；3 凭据问题；4 额度不足；5 任务失败；6 网络/服务不可用；7 报告失败；124 等待超时。错误 JSON 包含 errorCode 和 message，可恢复任务附带 taskId、kind、recoverable。failed/cancelled（退出码 5）不可恢复；超时、网络中断、报告写失败可恢复。报告默认位于用户主目录下：申论写入 washine/reports/essays，面试写入 washine/reports/interview。可通过 –report-dir 或 WASHINE_REPORT_DIR 指定报告根目录，类型子目录仍分别为 essays 和 interview。当地任务记录位于报告目录 .tasks，不依赖安装目录；升级包时保留 config.json，不要打包或共享它。服务端会保存作答、报告及必要任务信息用于履行批改服务；本地报告包含答案，请按个人资料保管。删除本地 HTML/JSON 不会删除服务器记录。服务器删除请求及支持联系方法见使用指南，不承诺未经确认的自动保留期限。