{"id":"6dd679cf-522d-42d4-afee-98d9c9481a61","entityType":"agent","slug":"clawhub-bianmaxingkong-japanese-reading-grader","name":"日语朗读作业批改模板","canonicalUrl":"https://www.xpersona.co/agent/clawhub-bianmaxingkong-japanese-reading-grader","canonicalPath":"/agent/clawhub-bianmaxingkong-japanese-reading-grader","generatedAt":"2026-10-10T10:45:10.844Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T07:04:35.208Z","emptyReason":null},"description":"日语朗读作业批改（教师模式）——面向 A1/A2/B1 (JLPT N5/N4/N3) 日语学习者的朗读音频作业批改工具。ASR+声学粗筛自动检测漏读/语速/停顿；促音/长音/清浊仅输出候选。支持批量批改与归档，满分10分。 Skill: 日语朗读作业批改模板 Owner: bianmaxingkong Summary: 日语朗读作业批改（教师模式）——面向 A1/A2/B1 (JLPT N5/N4/N3) 日语学习者的朗读音频作业批改工具。ASR+声学粗筛自动检测漏读/语速/停顿；促音/长音/清浊仅输出候选。支持批量批改与归档，满分10分。 Tags: latest:2.2.3 Version history: v2.2.3 | 2026-08-18T11:26:20.526Z | user 相较此前版本的主要改进： - ASR 引擎升级为 faster-whisper（large-v3/medium 自适应） - 评分模型从扣分制重构为四维加权制（完整性/准确性/流畅度/发音质量） - 发音判定改为\"可疑候选定位+教师复核\"，不自动判错 - 新增置信度分级（高/中/低），分级驱动教师复核投入 - 最低分从6.0调整为完整0-10分区间 v2.2.","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.6K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s17f7de24jwye68xxaykgnjqwn8616wn:japanese-reading-grader","sourceUrl":"https://clawhub.ai/bianmaxingkong/japanese-reading-grader","homepage":"https://clawhub.ai/bianmaxingkong/skills/japanese-reading-grader","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/bianmaxingkong/japanese-reading-grader","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/bianmaxingkong/skills/japanese-reading-grader","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":64,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"日语朗读作业批改（教师模式）——面向 A1/A2/B1 (JLPT N5/N4/N3) 日语学习者的朗读音频作业批改工具。ASR+声学粗筛自动检测漏读/语速/停顿；促音/长音/清浊仅输出候选。支持批量批改与归档，满分10分。 Skill: 日语朗读作业批改模板 Owner: bianmaxingkong Summary"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T07:04:35.208Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T07:04:35.208Z","emptyReason":null},"stars":null,"forks":null,"downloads":1602,"packageName":null,"latestVersion":"2.2.3","tractionLabel":"1.6K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T07:04:35.179Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T07:04:35.208Z","lastCrawledAt":"2026-10-10T07:04:35.179Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T07:04:35.179Z","lastVerifiedAt":null,"highlights":[{"version":"2.2.3","createdAt":"2026-08-18T11:26:20.526Z","changelog":"相较此前版本的主要改进： - ASR 引擎升级为 faster-whisper（large-v3/medium 自适应） - 评分模型从扣分制重构为四维加权制（完整性/准确性/流畅度/发音质量） - 发音判定改为\"可疑候选定位+教师复核\"，不自动判错 - 新增置信度分级（高/中/低），分级驱动教师复核投入 - 最低分从6.0调整为完整0-10分区间","fileCount":3,"zipByteSize":9083},{"version":"2.2.2","createdAt":"2026-06-28T01:03:18.504Z","changelog":"修复搜索索引：更新displayName为中文","fileCount":3,"zipByteSize":6031},{"version":"2.2.1","createdAt":"2026-06-27T13:05:16.696Z","changelog":"重新发布以确保发布者关联正确，解决镜像站搜索索引问题。","fileCount":3,"zipByteSize":6847},{"version":"2.2.0","createdAt":"2026-06-27T12:59:50.506Z","changelog":"添加标准 YAML front matter，完善技能元数据，触发镜像站搜索索引同步。","fileCount":3,"zipByteSize":6998},{"version":"2.1.6","createdAt":"2026-06-20T14:35:17.304Z","changelog":"- Updated and streamlined the skill documentation for Japanese reading grading. - Scoring and error deduction rules clarified: total score now has a minimum of 7 points (was 6), deduction cap lowered to 3 points. - Revised level mapping and grading terminology from N5/N4/N3 to A1/A2/B1 (aligned with CEFR/JF Can-do). - Grading framework updated to use CAF (Complexity, Accuracy, Fluency) dimensions and weights. - Output report template and example standardized, with detailed file paths and processing flow. - Removed the sample file skill-card.md.","fileCount":3,"zipByteSize":5357},{"version":"2.1.5","createdAt":"2026-05-21T13:47:00.088Z","changelog":"- Expanded grading support from N5-N3 to full N5-N1 coverage. - Redesigned scoring: now starts from 10.0 points, deducting only for key serious errors (not cumulative). - New, broader error tolerance rules for beginner levels; advanced levels are stricter. - Simplified deduction to only three error types, each only counted once. - Improved, clearer report templates with structured praise and suggestions; removed emojis. - Updated encouragement and confidence protection: minimum score now 6.0; always praise first.","fileCount":3,"zipByteSize":4383},{"version":"2.1.4","createdAt":"2026-05-20T14:10:29.137Z","changelog":"1. 全新升级鼓励式评分体系，7分起步、加分宽松、扣分封顶，大幅提升评分友好度 2. 统一教师批改 / 学生自测双模式评分规则，保证公平性与一致性 3. 优化N5-N3水平分层扣分标准，更贴合日语学习者实际能力 4. 强化纠错机制：仅提示关键错误，小错误不扣分、同一错误只扣一次 5. 新增两轮AI校验逻辑，减少误判，不确定错误优先不判定 6. 学生自测模式体验升级，分数更合理、鼓励性更强，90%用户可达到优秀区间","fileCount":2,"zipByteSize":2667},{"version":"2.1.3","createdAt":"2026-05-18T13:34:49.247Z","changelog":"- 部分模板内容与分层标准进行调整，优化了学生能力描述和支持场景表达。 - 纠错模板和说明细化，纠错粒度为单词/词组级，“发音纠错”部分限制内容不宜过长。 - 明确所有一级反馈项（如评分结果、总体评价）需单独起行展示，纠错和建议用数字序号，禁止使用emoji。 - 默认学生水平为N5~N4时纠错项最多2条（影响语义错误优先），不显示分级标注和纠错等级说明。 - 支持类型由“单词朗读”合并入句子/课文/替换练习三类型。 - 补充了排版和输出规范说明，进一步明确输出结构。","fileCount":2,"zipByteSize":5841}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17f7de24jwye68xxaykgnjqwn8616wn:japanese-reading-grader","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bianmaxingkong-japanese-reading-grader/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bianmaxingkong-japanese-reading-grader/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bianmaxingkong-japanese-reading-grader/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-bianmaxingkong-japanese-reading-grader/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-bianmaxingkong-japanese-reading-grader/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-bianmaxingkong-japanese-reading-grader/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T10:45:10.843Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bianmaxingkong-japanese-reading-grader/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bianmaxingkong-japanese-reading-grader/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bianmaxingkong-japanese-reading-grader/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bianmaxingkong-japanese-reading-grader/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-10T07:04:35.208Z","emptyReason":null},"readme":"Skill: 日语朗读作业批改模板\n\nOwner: bianmaxingkong\n\nSummary: 日语朗读作业批改（教师模式）——面向 A1/A2/B1 (JLPT N5/N4/N3) 日语学习者的朗读音频作业批改工具。ASR+声学粗筛自动检测漏读/语速/停顿；促音/长音/清浊仅输出候选。支持批量批改与归档，满分10分。\n\nTags: latest:2.2.3\n\nVersion history:\n\nv2.2.3 | 2026-08-18T11:26:20.526Z | user\n\n相较此前版本的主要改进：\n- ASR 引擎升级为 faster-whisper（large-v3/medium 自适应）\n- 评分模型从扣分制重构为四维加权制（完整性/准确性/流畅度/发音质量）\n- 发音判定改为\"可疑候选定位+教师复核\"，不自动判错\n- 新增置信度分级（高/中/低），分级驱动教师复核投入\n- 最低分从6.0调整为完整0-10分区间\n\nv2.2.2 | 2026-06-28T01:03:18.504Z | user\n\n修复搜索索引：更新displayName为中文\n\nv2.2.1 | 2026-06-27T13:05:16.696Z | user\n\n重新发布以确保发布者关联正确，解决镜像站搜索索引问题。\n\nv2.2.0 | 2026-06-27T12:59:50.506Z | user\n\n添加标准 YAML front matter，完善技能元数据，触发镜像站搜索索引同步。\n\nv2.1.6 | 2026-06-20T14:35:17.304Z | user\n\n- Updated and streamlined the skill documentation for Japanese reading grading.\n- Scoring and error deduction rules clarified: total score now has a minimum of 7 points (was 6), deduction cap lowered to 3 points.\n- Revised level mapping and grading terminology from N5/N4/N3 to A1/A2/B1 (aligned with CEFR/JF Can-do).\n- Grading framework updated to use CAF (Complexity, Accuracy, Fluency) dimensions and weights.\n- Output report template and example standardized, with detailed file paths and processing flow.\n- Removed the sample file skill-card.md.\n\nv2.1.5 | 2026-05-21T13:47:00.088Z | user\n\n- Expanded grading support from N5-N3 to full N5-N1 coverage.\n- Redesigned scoring: now starts from 10.0 points, deducting only for key serious errors (not cumulative).\n- New, broader error tolerance rules for beginner levels; advanced levels are stricter.\n- Simplified deduction to only three error types, each only counted once.\n- Improved, clearer report templates with structured praise and suggestions; removed emojis.\n- Updated encouragement and confidence protection: minimum score now 6.0; always praise first.\n\nv2.1.4 | 2026-05-20T14:10:29.137Z | user\n\n1. 全新升级鼓励式评分体系，7分起步、加分宽松、扣分封顶，大幅提升评分友好度\n2. 统一教师批改 / 学生自测双模式评分规则，保证公平性与一致性\n3. 优化N5-N3水平分层扣分标准，更贴合日语学习者实际能力\n4. 强化纠错机制：仅提示关键错误，小错误不扣分、同一错误只扣一次\n5. 新增两轮AI校验逻辑，减少误判，不确定错误优先不判定\n6. 学生自测模式体验升级，分数更合理、鼓励性更强，90%用户可达到优秀区间\n\nv2.1.3 | 2026-05-18T13:34:49.247Z | user\n\n- 部分模板内容与分层标准进行调整，优化了学生能力描述和支持场景表达。\n- 纠错模板和说明细化，纠错粒度为单词/词组级，“发音纠错”部分限制内容不宜过长。\n- 明确所有一级反馈项（如评分结果、总体评价）需单独起行展示，纠错和建议用数字序号，禁止使用emoji。\n- 默认学生水平为N5~N4时纠错项最多2条（影响语义错误优先），不显示分级标注和纠错等级说明。\n- 支持类型由“单词朗读”合并入句子/课文/替换练习三类型。\n- 补充了排版和输出规范说明，进一步明确输出结构。\n\nv2.1.2 | 2026-05-17T09:47:51.174Z | user\n\nVersion 2.1.2 focuses on more lenient scoring and clarifies error judgment rules.\n\n- 评分维度调整，发音/语调/流畅度权重改为40/30/30，评分标准进一步放宽，允许初学者有小错仍获较高分。\n- 纠错数量限制调整，N5~N4最多指出2项错误，N3最多3项，N2最多4项（原N4为3项，N3为4项）。\n- 明确发音判错规则：同音词不判错，仅假名实际读错才扣分，反复犯同一错误只计一次。\n- 新增发音错误类型及判定标准说明，细化促音、长音、清浊、拨音等错误的定义与扣分方式。\n- 语调扣分要求放宽，疑问句稍有上扬即可，不再追究细微语调偏差。\n\nv2.1.1 | 2026-05-14T13:44:43.266Z | user\n\n**Major update: Added student-level differentiation, self-study mode, and adaptive feedback for Japanese reading grading.**\n\n- Introduced dual modes: Teacher grading (batch/class) and Student self-test (personalized feedback).\n- Added JLPT-based student ability levels (N5–N1) with adaptive scoring, error tolerance, and feedback limits.\n- Built-in adaptive learning: system analyzes recent errors/score trends, giving targeted exercise recommendations and automatic level suggestions.\n- Expanded supported task types: word, sentence, text, and substitution practice, with auto task detection.\n- Customizable grading and error feedback based on level—with error count and penalty dynamically adjusted.\n- Optional student progress tracking and ability grouping for in-depth teaching analysis.\n- New output formats: per-student detailed report, class summary with stratification, and adaptive practice advice.\n\nv2.1.0 | 2026-05-03T13:53:28.468Z | user\n\n- Major documentation update: added detailed SKILL.md with comprehensive usage instructions, grading standards, workflow, templates, and output specifications.\n- Clarified trigger conditions, required input parameters, and output report formats.\n- Included precise evaluation dimensions, scoring weights, conversion to 10-point scale, and feedback requirements.\n- Outlined workflow steps, error definitions, and class summary methods.\n- Listed all output files generated after grading.\n\nArchive index:\n\nArchive v2.2.3: 3 files, 9083 bytes\n\nFiles: skill-card.md (2242b), SKILL.md (17010b), _meta.json (142b)\n\nFile v2.2.3:SKILL.md\n\n--- \r\nname: japanese-reading-grader\r\ndisplay_name: 日语朗读作业批改\r\ndescription: A1/A2/B1(N5/N4/N3)日语朗读音频作业批改，faster-whisper ASR+声学双通道四维AI评测；支持单人/批量批改、纠错反馈、成绩归档；AI预批改，教师人工终审，满分10分。\r\n\r\n## 适用场景\r\n\r\n学生提交音频文件（MP3/MP4/M4A/WAV）朗读日语文本，教师需要：下载 → 转写 → 评分 → 纠错 → 录入成绩 → 生成班级汇总。\r\n\r\n## 作业基础信息\r\n\r\n| 项目 | 内容 |\r\n| :--- | :--- |\r\n| **适用对象** | A1/A2/B1 日语学习者（操作标签参考 JLPT N5/N4/N3） |\r\n| **作业形式** | 朗读音频 |\r\n| **总分** | 10 分 |\r\n\r\n---\r\n\r\n## 工作流程概览\r\n\r\n> Step0 标准文本准备 → Step1 音频预处理 → Step1.5 音频质量检测 → Step2 ASR+声学双通道分析 → Step2.5 ASR可靠性检测（置信度分级）→ Step3 四维 AI 评分 → Step4 教师复核 → Step5 成绩录入与反馈生成\r\n\r\n---\r\n\r\n## Step 0：标准文本准备\r\n\r\n1.  **标准答案存储路径**：`./answer/{COURSE_ID}_{ASSIGNMENT_ID}_answer.txt`\r\n2.  **文本格式要求**：\r\n    - 每行 1 个完整句子，无多余空格与换行\r\n    - 重点词汇标注假名\r\n    - 不含多余标点，便于音频转写对齐\r\n3.  **版本校验**：批改前确认标准答案与作业要求一致\r\n4.  **标准答案假名预处理**：\r\n    - 默认本地 `pykakasi`：离线生成假名序列用于辅助分析，确定性强、不上传任何学生数据\r\n    - 生成对照文件：`./answer/{COURSE_ID}_{ASSIGNMENT_ID}_kana_ref.txt`，结构：`原文句子｜规范化假名序列`，用于逐假名对齐比对。**该文件是准确性判定/同音词豁免/清浊·长短音核对的必需输入。**\r\n    - 如未安装 `pykakasi`（降级模式）：**不阻断评分，但强制将该生归入「中置信」分流教师复核**，并在批改日志记录降级原因\r\n\r\n---\r\n\r\n## Step 1：音频预处理\r\n\r\n- 批量转为 wav 格式，统一采样率\r\n- 存放路径：`./audio/{student_id}/`\r\n\r\n---\r\n\r\n## Step 1.5：音频质量检测\r\n\r\n检测项：\r\n- 有效语音比例\r\n- 音量范围\r\n- 背景噪声\r\n- 是否存在多人声音\r\n\r\n**异常处理**：音频质量不足 → 不评分 → 请求重新上传。\r\n\r\n---\r\n\r\n## Step 2：ASR + 声学双通道分析\r\n\r\n### 转写工具规格（强制）\r\n\r\n- **唯一转写工具**：`faster-whisper`\r\n- **仅允许模型**：`large-v3 fp16` / `medium`；禁用 `small` / `base` / `tiny` 及全部其他规格\r\n- **硬件调度**：有充足 GPU 用 `large-v3 fp16`；无 GPU 自动降级 `medium`\r\n- **固定开启** `word_timestamps=True` 输出词级时间戳\r\n\r\n系统同时处理两个分析通道（**双通道校验的基础**）：\r\n\r\n| 通道 | 用途 |\r\n| :--- | :--- |\r\n| **A. ASR 文本识别通道** | 辅助判断朗读内容完整性、辅助定位可能存在的发音异常、生成文本对齐候选 |\r\n| **B. 声学分析通道** | 输入原始 wav 音频，分析发音异常候选、音长变化、停顿、语速、节奏；用于发音质量评价及长音/促音/拨音/流畅度分析 |\r\n\r\n---\r\n\r\n## Step 2.5：ASR 可靠性检测\r\n\r\n系统综合判断以下方面：\r\n- 文本匹配程度\r\n- 音频质量\r\n- ASR 置信度\r\n- 对齐情况\r\n\r\n输出：**高 / 中 / 低置信度**（用于 Step 4 教师复核的投入分级）。\r\n\r\n### 置信度分级判定标准\r\n\r\n| 置信度 | 判定条件 |\r\n| :--- | :--- |\r\n| **高** | 文本匹配率 ≥90% 且 ASR 平均置信度 ≥0.8 且 音频信噪比 ≥20dB |\r\n| **中** | 文本匹配率 ≥70% 且 <90%，ASR 平均置信度 ≥0.5 且 <0.8 |\r\n| **低** | 文本匹配率 <70%，或 ASR 平均置信度 <0.5，或音频质量检测不通过 |\r\n\r\n> 置信度‑AI评分衔接规则\r\n> 1. **高、中置信度**：四维AI加权分数作为正式预评分，教师仅做异常修正；\r\n> 2. **低置信度**：AI四维加权分数仅作为后台诊断参考，**不计入、不对外展示，最终成绩完全由教师人工给出**。\r\n\r\n---\r\n\r\n## Step 3：四维 AI 评分\r\n\r\n### 评分原则\r\n\r\n1.  不影响理解的偏差不扣分\r\n2.  A1/A2 （N5/N4）阶段轻微发音偏差以反馈为主\r\n3.  不确定错误不扣分\r\n\r\n> 发音质量维度重要说明\r\n> 发音质量权重占比15%参与AI加权运算，但**该维度输出仅为趋势预估值，不能直接等价于发音错误**；系统不会依靠该维度自动判定促音、长音、清浊错误；所有发音类错误必须经教师试听复核确认后方可扣分。\r\n> 系统可自动化可靠指标仅为：语速、停顿时长、完整性（漏读/多读）、文本对齐。\r\n\r\n### 评分前置过滤规则（评分前必须执行）\r\n\r\n计算任何维度分数前，先筛除以下情况，**排除出扣分范围**：\r\n\r\n1.  **ASR 误识别**——不进入评分计算\r\n    - 人名、地名、汉字词、同音词差异\r\n    - 系统标记为“ASR疑似误识别”的项\r\n2.  **转写存疑**——不进入评分计算\r\n    - 系统置信度 < 0.5 的识别结果\r\n3.  **学习者自然偏差**——反馈但不扣分\r\n    - A1/A2 阶段轻微音长偏差、拨音不到位\r\n    - 语气词添加、促音/长音时长轻微不足\r\n\r\n### 音频层评价指标\r\n\r\n1.  **发音质量**：清音/浊音区别、拗音准确性、促音闭塞时间、长音持续时间、拨音鼻音实现\r\n2.  **流畅度**：平均语速、停顿次数、非正常停顿长度、重复修正次数\r\n3.  **节奏与韵律**：音节时长比例、长短音节比例、句末语调变化（B1以上参考，不作为 A1/A2 主要扣分依据）\r\n\r\n### 能力层级说明（双轨分级）\r\n\r\n| 能力层级 | 约对应 JLPT | 朗读评价重点 |\r\n| :--- | :--- | :--- |\r\n| **A1** | N5 | 准确朗读短句，掌握基础假名发音，长音/促音容错空间大 |\r\n| **A2** | N4 | 连贯朗读中等文本，区分常见清浊音，减少基础发音失误 |\r\n| **B1** | N3 | 流畅朗读长文本，发音稳定，具备自然的停顿与语调 |\r\n\r\n### AI 自动评分模型（四维加权·主线）\r\n\r\n| 评价维度 | 权重 | 数据来源 |\r\n| :--- | :--- | :--- |\r\n| **完整性 (Completeness)** | 35% | 文本 + 音频对齐 |\r\n| **准确性 (Accuracy)** | 30% | ASR + 音频分析 |\r\n| **流畅度 (Fluency)** | 25% | 停顿、语速、重复 |\r\n| **发音质量 (Phoneme Quality)** | 15% | 长音、促音、清浊候选 |\r\n\r\n**计算方式**：\r\n> `AI评分 = 完整性×35% + 准确性×30% + 流畅度×25% + 发音质量×15%`，换算为 10 分制。\r\n\r\n**权重调整说明**：基于实测，发音质量维度数据源（ASR 置信度 + 时长特征）可靠性有限，暂调低至 15%；差额补给完整性（音频有无语音的判断最为可靠），确保评分基础稳固。\r\n\r\n**系统说明**：当前版本发音质量评价基于 ASR 置信度 + 音频时长特征推断，非专业音素模型分析，结果作为辅助参考；教师复核时可重点核对发音相关扣分项。\r\n\r\n### 各维度判定规则\r\n\r\n| 发现的问题 | 归属维度 | 扣分规则 |\r\n| :--- | :--- | :--- |\r\n| ASR 缺了一段，音频对应位置无语音 | **完整性** | 扣分 |\r\n| ASR 缺了一段，但音频有语音（ASR 未识别出） | - | 不扣分，标记 ASR 误识别 |\r\n| 语速慢 / 停顿多 | **流畅度** | 扣分 |\r\n\r\n**促音/长音/清浊错误的边界归属原则**：\r\n- 影响词义（如「もっと」→「もと」、「おばさん」→「おばあさん」）→ **准确性**扣分\r\n- 不影响词义（如时长轻微不足但词义可辨）→ **发音质量**扣分\r\n- 不确定是否影响词义 → 不扣分，仅反馈\r\n\r\n1.  **完整性 (Completeness)**\r\n    - **一级依据**：音频时间段是否存在有效语音、是否明显跳过文本区域\r\n    - **二级依据**：ASR 文本对齐结果\r\n    - **规则**：**ASR 显示缺失但音频有对应语音 → 不判定漏读；只有音频无语音 + ASR 缺失才判定漏读。**\r\n\r\n2.  **准确性 (Accuracy)**\r\n    - 依据：ASR 文本一致性 + 音频发音特征\r\n    - **禁止仅依据 ASR 错误数量评分。**\r\n\r\n3.  **发音质量 (Pronunciation Quality)**\r\n    - 当前阶段：基于 ASR 声学置信度、音频清晰度、长音/促音候选检测，生成辅助评价\r\n    - **注意**：**非专业音素模型分析结果不得作为唯一扣分依据。**\r\n\r\n### 促音/长音判定校准约束\r\n\r\n促音/长音判定以假名序列 + 双通道比对为准，不依赖声学时长自动扣分。依据内部实测校准，声学时长的参考价值有限，故仅用作候选定位；实际扣分必须经教师复核试听确认后方可计入。可自动化的可靠指标为：语速、停顿时长、完整性（漏读/多读）、文本对齐。\r\n---\r\n\r\n## Step 4：教师复核\r\n\r\n### 置信度分级驱动复核投入\r\n\r\n| AI 置信度 | 教师操作 | 耗时 | 最终成绩 |\r\n| :--- | :--- | :--- | :--- |\r\n| **高** | 快速浏览评分报告，确认无异常后直接录入 | ≤5 秒 | 最终成绩 = AI 评分 |\r\n| **中** | 查看 AI 标记错误列表，播放错误片段（单条≤5s），确认或驳回 AI 判定 | ≤15 秒 | 最终成绩 = AI 评分（教师仅确认扣分项是否合理） |\r\n| **低** | 完整重听音频，人工逐项评分 | 约 2 分钟 | 最终成绩 = 教师评分 |\r\n\r\n> **核心原则**：教师不需要对每个学生逐项评分，仅在 AI 置信度低时进行完整人工评价；高/中置信度学生教师只需“确认”即可录入。\r\n\r\n### 人工复核调整规则（AI 异常修正）\r\n\r\n| 错误类型 | 调整分值 | 单类上限 | 说明 |\r\n| :--- | :--- | :--- | :--- |\r\n| 高置信度发音错误 | -0.5 | -1.5 | 经音频分析确认的促音、长音、清浊错误 |\r\n| 确认漏读/多读 | -0.5 | -1.5 | 音频无对应朗读内容 |\r\n| 明显停顿或中断 | -0.5 | -1.5 | 影响朗读完整性的停顿（超过 3 秒） |\r\n\r\n### 调整原则\r\n\r\n1.  人工调整仅用于修正 AI 评分异常，不替代 AI 综合评分。\r\n2.  以下情况不得扣分：ASR 误识别、汉字词识别错误、人名/地名识别偏差、同音词转换错误。\r\n3.  只有满足以下条件才扣分：音频证据明确、非 ASR 单独判断、对理解或朗读质量产生影响。\r\n4.  同类错误最多调整 1.5 分。\r\n5.  低置信度且 ASR 异常/音频质量不足 → 不评分，进入人工复核。\r\n\r\n> **最终成绩口径**以本页上方「置信度分级驱动复核投入」表格为准：\r\n> - 高/中置信度 → 教师仅确认、不逐项评分，最终成绩 = AI 评分；\r\n> - 低置信度 → 教师综合判断，AI 仅提供诊断参考，最终成绩 = 教师评分。\r\n\r\n---\r\n\r\n## 分级纠错规则（A1/A2/B1；操作标签参考 N5/N4/N3）\r\n\r\n### 篇幅定义\r\n\r\n- **短篇**：≤150 字\r\n- **长篇**：＞150 字\r\n\r\n### 纠错上限（按水平+篇幅）\r\n\r\n| 学生水平 | 短篇 | 长篇 |\r\n| :--- | :--- | :--- |\r\n| **A1** | 2 项 | 3 项 |\r\n| **A2** | 3 项 | 4 项 |\r\n| **B1** | 4 项 | 5 项 |\r\n\r\n### 纠错优先级（超过上限时）\r\n\r\n1.  影响语义的错误（清浊、长音、促音）\r\n2.  反复出现的高频错误\r\n3.  语调错误\r\n\r\n### 通用纠错原则\r\n\r\n- 优先纠正影响语义的关键错误\r\n- 同一错误只纠正一次\r\n- 先表扬优点，再提出改进建议\r\n- 不使用警示符号（如 ⚠），语气鼓励为主\r\n- 转写存疑、不确定的地方不纠错，一律不扣分\r\n- **「一句话建议」与「总体评价」不得重复**：一句话建议使用等级表固定标准化结论；总体评价必须基于具体转写内容生成，侧重归因与鼓励，不可复述一句话建议的标准措辞。\r\n- 练习建议数量与纠错输出项数一致，最多不超过纠错上限（如纠错 2 项，练习建议 2 条；不足上限时按实际纠错项数）。\r\n\r\n---\r\n\r\n## 强制校验流程（防误判）\r\n\r\n### 双通道校验机制\r\n\r\n系统同时检查：\r\n\r\n- **A. 文本通道**：Whisper 转写结果 → 判断漏读/多读/内容偏差\r\n- **B. 音频通道**：原始音频 → 判断发音质量/长音/促音/流畅度\r\n\r\n**只有两个通道同时支持时，AI 才生成“高置信度错误”；否则标记「需要教师复核」。**\r\n\r\n### 错误判定强制引用表\r\n\r\n> `pykakasi` 生成的标准假名序列仅用于文本规范化和音素对齐，不作为独立发音错误判定依据。\r\n\r\n| 错误类型 | 必须同时满足的条件 |\r\n| :--- | :--- |\r\n| **促音错误** | ① 标准文本存在「っ」 ② 音频分析**定位**该位置存在促音候选（仅作定位，不作自动扣分依据） ③ 影响节拍结构 ④ ASR 结果作为辅助 |\r\n| **长音错误** | ① 标准文本存在规范长音 ② 音频分析**定位**该位置存在长音候选（仅作定位，不作自动扣分依据） ③ 节拍比例异常 |\r\n| **清浊混淆** | ① 声学特征显示清浊差异 ② 多次稳定出现 ③ 非 ASR 单次错误 |\r\n| **漏读/跳读** | ① ASR 文本与标准文本不一致 ② 音频能量分析确认对应时间段不存在有效语音 |\r\n\r\n> **注**：促音/长音仅作**候选定位**，实际扣分须教师复核试听确认后计入（依据校准约束）；不采用时长阈值自动扣分。\r\n\r\n**本系统仅为教师辅助预批改工具，不能替代人工终审；所有自动判定的发音错误，教师批量复核后再录入最终成绩。**\r\n\r\n---\r\n\r\n## 等级划分\r\n\r\n| 分数区间 | 水平定位 | 一句话建议 |\r\n| :--- | :--- | :--- |\r\n| 9.0～10.0 | 优秀 | 朗读非常流畅，发音准确，继续保持 |\r\n| 8.0～8.9 | 良好 | 朗读整体不错，有少量细节可优化 |\r\n| 7.0～7.9 | 达标 | 朗读基本达标，建议针对弱项加强练习 |\r\n| 6.0～6.9 | 练习中 | 朗读基本完成，部分发音和流畅度仍需加强 |\r\n| 0～5.9 | 待加强 | 建议从基础发音开始巩固，每日跟读练习 5 分钟 |\r\n\r\n初级学习者采用鼓励性反馈原则，但系统保留 0～10 分完整评分范围。\r\n\r\n---\r\n\r\n## Step 5：成绩录入与反馈生成\r\n\r\n### 报告模板\r\n> 说明：下方为AI实际输出给教师‑学生的报告正文模板；花括号`{xxx}`为变量占位符；\r\n> 【发音可疑候选】块由AI自动填充可疑片段；教师试听确认后，将确认的错误迁移至【发音纠错】区块。\r\n\r\n学生姓名：{name}\r\n朗读总分：{score}/10分\r\n一句话建议：{level_suggestion}\r\n\r\n【总体评价】\r\n{positive_comment}，{constructive_feedback}。{encouragement}\r\n\r\n【发音纠错】\r\n原句：{original}学生读法：{student_reading}标准读法：{correct_reading}（{kana}）错误类型：{error_type}\r\n【练习建议】\r\n{suggestion_1}\r\n{suggestion_2}\r\n\r\n> **字段定义**：`{kana}` 为标准读法的假名注音，如汉字词「本」标注为「ほん」；`{level}` 为水平定位（优秀/良好/达标/练习中/待加强）；`{level_suggestion}` 为等级表中对应的一句话建议。\r\n\r\n### 输出排版规则\r\n\r\n- 评分结果、总体评价、朗读诊断、发音纠错、练习建议等所有一级反馈大项，必须单独另起一行\r\n- 发音纠错内部用 1、2 数字序号\r\n- 练习建议用 1、2 数字序号\r\n- 反馈中显示水平定位（优秀/良好/达标/练习中/待加强），不显示 CEFR 等级（A1/A2/B1）标注，也不显示纠错等级说明\r\n- 禁用 emoji、⚠ 等特殊符号\r\n- 评语长度 ≤ 1000 字符（适配平台限制）\r\n- 优先展示优点，再提 1–2 条最关键改进建议\r\n- 后台保存精确分数用于统计归档；反馈中展示总分及水平定位\r\n\r\n### 输出文件\r\n\r\n- 默认输出到聊天窗口。\r\n- 如教师需要归档，再生成报告文件：`./report/{student_id}.txt`。\r\n\r\n---\r\n\r\n## 批量处理规则\r\n\r\n1.  进度文件：`./progress/{course}_{task}_progress.json`\r\n2.  支持中断后继续执行\r\n3.  分批处理建议 ≤50 人/批\r\n4.  失败音频记录于 `./progress/{course}_{task}_failed.json`，含学生 ID、失败原因（格式不支持/音频损坏/时长过短）、时间戳；不影响整体流程，教师可随时查看失败列表。\r\n\r\n---\r\n\r\n## 核心原则\r\n\r\n1.  **综合评分**：AI 依据完整性、准确性、流畅度和发音质量生成基础评分。\r\n2.  **教师修正**：教师根据课堂目标和特殊情况进行最终调整。\r\n3.  **不确定时不判错**：转写存疑或判定不确定时，优先不判定为错误。\r\n4.  **鼓励为主**：从鼓励出发，微小误差不扣分。\r\n5.  **数据诚实**：发音质量维度数据源（ASR 置信度 + 时长特征）非专业音素模型，不确定时不判错，优先标记“待复核”交由教师确认。\r\n\r\n---\r\n\r\n## 注意事项\r\n\r\n- 评分前确认作业为手动发布分数\r\n- 成绩录入使用 `submission[posted_grade]`\r\n- Whisper 转写仅作参考，必须执行对齐校验\r\n- 严格按 A1/A2/B1 能力层级控制纠错数量\r\n- 评语简洁友好，不使用特殊符号\r\n---\n\nFile v2.2.3:_meta.json\n\n{\n  \"ownerId\": \"kn7cw3j55n4hxe9ze445qp81ks86150x\",\n  \"slug\": \"japanese-reading-grader\",\n  \"version\": \"2.2.3\",\n  \"publishedAt\": 1787052380526\n}\n\nFile v2.2.3:skill-card.md\n\n## Description:\n\nA1/A2/B1(N5/N4/N3)日语朗读音频作业批改，faster-whisper ASR+声学双通道四维AI评测；支持单人/批量批改、纠错反馈、成绩归档；AI预批改，教师人工终审，满分10分。\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[bianmaxingkong](https://clawhub.ai/user/bianmaxingkong)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nTeachers use this skill to pre-grade Japanese reading audio assignments for A1/A2/B1 learners, generate concise feedback, and support batch grading records. The skill is designed as an AI-assisted workflow with teacher review before final grades are recorded.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Student audio, scores, reports, and progress files may contain sensitive education data.\n\nMitigation: Use the skill only in authorized teaching contexts, keep generated files in restricted course folders, minimize student identifiers, and follow school retention rules for deletion or archival.\n\nRisk: ASR or acoustic analysis can misidentify pronunciation or reading errors, especially for low-confidence audio.\n\nMitigation: Use the skill's confidence tiers and require teacher review for low-confidence cases and pronunciation-sensitive deductions before recording final grades.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/bianmaxingkong/skills/japanese-reading-grader)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, guidance, configuration]\n\n**Output Format:** [Markdown or plain text feedback reports with scores, diagnostic notes, correction suggestions, and optional local report/progress file paths]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May produce per-student report text, batch progress records, failed-audio records, and teacher-review prompts for low-confidence or pronunciation-sensitive findings.]\n\n## Skill Version(s):\n\n2.2.3 (source: release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v2.2.2: 3 files, 6031 bytes\n\nFiles: skill-card.md (2261b), SKILL.md (8731b), _meta.json (142b)\n\nFile v2.2.2:SKILL.md\n\n---\nname: japanese-reading-grader\ndescription: \"日语朗读作业AI批改（教师模式）——支持音频转写、CEFR分级评价、纠错与成绩录入。\"\nuse_when: 教师批改日语朗读作业录音、朗读测试打分、批量评分与反馈\ntriggers:\n  - 日语朗读作业批改\n  - 日语朗读测试打分\n---\n\n## 适用场景\n\n学生提交音频文件（MP3/MP4/M4A/WAV）朗读日语文本，教师需要：\n下载 → 转写 → 评分 → 纠错 → 录入成绩 → 生成班级汇总\n\n## 作业基础信息\n\n1. **适用对象**：A1/A2/B1 日语学习者\n2. **作业形式**：朗读音频\n3. **总分**：10 分\n\n## 工作流程\n\n| 步骤 | 内容 |\n|------|------|\n| Step 0 | 前置准备（标准答案文本） |\n| Step 1 | 音频格式统一转换 |\n| Step 2 | Whisper medium 转写 |\n| Step 3 | 评分规则（CEFR 分级 + JLPT 级别参考） |\n| Step 4 | 录入成绩 |\n| Step 5 | 生成班级汇总 + 上传 |\n\n## Step 0：前置准备\n\n1. 标准答案文本存储路径：`./answer/{COURSE_ID}_{ASSIGNMENT_ID}_answer.txt`\n2. 文本格式要求：\n   - 每行 1 个完整句子，无多余空格与换行\n   - 重点词汇标注假名\n   - 不含多余标点，便于音频转写对齐\n3. 版本校验：批改前确认标准答案与作业要求一致\n\n## Step 1：音频格式统一转换\n\n- 批量转为 wav 格式，统一采样率\n- 存放路径：`./audio/{student_id}/`\n\n## Step 2：Whisper 转写\n\n- 本技能音频转写使用 Whisper medium 模型（本地运行），模型已固定，无需手动切换。\n\n```bash\n# MP4视频 → 音频预处理\nffmpeg -y -i \"input.mp4\" -vn -acodec pcm_s16le -ar 16000 -ac 1 /tmp/audio.wav\n\n# 固定medium模型日语转写\nwhisper /tmp/audio.wav --model medium --language ja --output_format txt\n```\n\n### 异常处理规则\n\n- 音频损坏/空文件/无法识别 → 标记「转写失败」\n- 自动移入 `./error_audio/`，触发人工复核\n- 跳过自动评分，不直接判定低分\n\n## Step 3：评分规则（鼓励导向）\n\n### 能力层级说明（双轨分级）\n\n正式口语能力框架遵循 **CEFR（欧洲语言共同参考框架）**；该框架共设A1、A2、B1、B2、C1、C2六个等级，本系统仅采用A1、A2、B1三个等级。\n\n| 正式能力层级 | 操作标签 | 会话评价重点 |\n|--------------|----------|--------------|\n| A1 | 约对应 JLPT N5级别 | 能围绕熟悉题目作简单、完整回答 |\n| A2 | 约对应 JLPT N4级别 | 能围绕日常话题进行较完整简单交流 |\n| B1 | 约对应 JLPT N3级别 | 能表达经历、理由和简单观点，注意连贯性 |\n\n> JLPT 没有口语考试；N5/N4/N3 仅作为词汇、语法和课程任务难度参考。\n\n### 计分规则\n\n- **基础分**：10.0 分\n- **计分公式**：总分 = 10.0 - 累计扣分\n- **约束**：7.0 ≤ 总分 ≤ 10.0\n- **扣分上限**：3.0 分（超过不再扣）\n\n### 错误类型与扣分值（仅3类）\n\n| 错误类型 | 扣分 | 说明 |\n|----------|------|------|\n| 严重发音错误 | -0.5 | 促音、长音、清浊混淆（三者任一出现） |\n| 漏读/多读整句 | -0.5 | 漏掉一整句 或 多读一整句 |\n| 中途中断/长时间停顿 | -0.5 | 朗读中途放弃，或停顿超过3秒 |\n\n**重要规则**：\n- 同一错误类型全篇**只扣一次**，不重复累计\n- 上述3类错误若同时出现，累计扣分（最多 -1.5，但扣分上限为 3.0）\n\n### 不扣分的情况\n\n- 句尾拖音、语气词（よ/ね）\n- 「は」vs「わ」、「を」vs「お」等微小识别差异\n- 语调轻微偏差、声调轻微偏差\n- 语速稍慢或稍快\n- 轻微卡顿（≤2处，每处<2秒）\n- 拨音（ん）偶尔读不到位（N5/N4 宽容）\n- 同一错误类型仅出现一次且不影响语义理解\n- 转写存疑、不确定是否为错误 → **不扣分**\n\n### SKILL评分维度（CAF三维框架，每题满分10分）\n\n| 维度 | 权重 | 评分要点 |\n|------|------|----------|\n| C 复杂性（Complexity） | 80% | 内容贴合与表达复杂度 |\n| A 准确性（Accuracy） | 10% | 语法、词汇、语音规范 |\n| F 流利度（Fluency） | 10% | 话语输出节奏、连贯性、停顿与沉默控制 |\n\n### 等级划分\n\n| 分数区间 | 等级 |\n|----------|------|\n| 8.0～10.0 | 优秀 |\n| 7.0～7.9 | 良好 |\n| 6.0～6.9 | 合格 |\n| 6.0以下 | 需加强 |\n\n## 分级纠错规则（A1/A2/B1；操作标签参考N5/N4/N3）\n\n### 篇幅定义\n\n- **短篇**：150字以内\n- **长篇**：150字以上\n\n### 纠错上限（按水平+篇幅）\n\n| 学生水平 | 短篇 | 长篇 |\n|----------|------|------|\n| A1 | 1项 | 2项 |\n| A2 | 2项 | 3项 |\n| B1 | 2项 | 3项 |\n\n### 纠错优先级（超过上限时）\n\n1. 影响语义的错误（清浊、长音、促音）\n2. 反复出现的高频错误\n3. 语调错误\n\n### 通用纠错原则\n\n- 优先纠正影响语义的关键错误\n- 同一错误只纠正一次\n- 先表扬优点，再提出改进建议\n- 不使用警示符号，语气鼓励为主\n- 转写存疑、不确定的地方不纠错\n\n## 强制校验流程（防误判）\n\n### 对齐校验（防止 Whisper 听错导致误判）\n\n批改前，必须逐句比较「Whisper 转写文本」与「标准答案文本」：\n\n- 如果转写文本与标准答案完全一致或仅尾音差异 → 继续批改\n- 如果转写文本与标准答案存在假名级别差异（如「学校」→「公園」）→ 该句不扣分，标记「转写存疑，请人工复核」\n- 如果转写文本缺失或多余整句 → 跳过该句，标记「可能漏读或多读，请人工复核」\n\n### 错误判定强制引用表\n\n每个潜在错误必须同时满足以下条件才能判定为对应类型：\n\n| 错误类型 | 必须同时满足的条件 |\n|----------|-------------------|\n| 促音错误 | ① 标准答案中有「っ」 ② 转写文本中该处完全无「っ」或明显替换为其他音 |\n| 长音错误 | ① 标准答案中有长音规则（あ段+あ等） ② 转写文本中该处为短音或断成两拍 |\n| 清浊混淆 | ① 标准答案为清音（か/さ/た/は行） ② 转写文本为对应浊音（が/ざ/だ/ば行），或反之 |\n| 漏读/跳读 | ① 标准答案中有该假名 ② 转写文本中完全无对应音节 |\n\n## Step 4：录入Canvas成绩\n\n```bash\npython3 scripts/grade_submission.py COURSE_ID ASSIGNMENT_ID USER_ID GRADE --comment \"评语内容\"\npython3 scripts/grade_submission.py COURSE_ID ASSIGNMENT_ID USER_ID GRADE --comment-file comment.txt\n```\n\n## Step 5：生成汇总 + 上传\n\n```bash\n# 生成班级汇总文件\npython3 scripts/generate_class_summary.py COURSE_ID ASSIGNMENT_ID [--class-name NAME]\n\n# 上传汇总表到Canvas\npython3 scripts/send_summary_message.py [--xlsx PATH]\n```\n\n## 反馈格式模板（无emoji）\n\n```\n学生姓名：{name}\n\n【评分结果】\n总分：{score}/10\n发音准确性：{pronunciation_score}/10\n语调与节奏：{intonation_score}/10\n流畅度：{fluency_score}/10\n\n【总体评价】\n{positive_comment}，{constructive_feedback}。{encouragement}\n\n【发音纠错】\n1. 原句：{original}\n   学生读法：{student_reading}\n   标准读法：{correct_reading}（{kana}）\n   错误类型：{error_type}\n\n【练习建议】\n1. {suggestion_1}\n2. {suggestion_2}\n```\n\n### 输出排版规则\n\n- 评分结果、总体评价、发音纠错、练习建议等所有一级反馈大项，必须单独另起一行\n- 发音纠错内部用 1、2 数字序号\n- 练习建议用 1、2 数字序号\n- 不显示等级标注和纠错等级说明\n- 禁用 emoji\n- 评语长度 ≤ 1000 字符（适配平台限制）\n- 优先展示优点，再提 1–2 条最关键改进建议\n\n### 输出文件\n\n- 输出路径：`./report/{student_id}.txt`\n\n## 批量处理规则\n\n1. 进度文件：`./progress/{course}_{task}_progress.json`\n2. 支持中断后继续执行\n3. 单次批量 ≤ 50 人，分批处理避免崩溃\n4. 失败音频自动标记，不影响整体流程\n\n## 核心原则\n\n1. **鼓励为主**：从 10 分起评，据实扣分，不刻意压低分数\n2. **只纠严重错误**：只纠正影响语义的明显发音错误，微小误差不计\n3. **同一错误只扣一次**：不重复扣分\n4. **不确定时不判错**：转写存疑或判定不确定时，优先选择不判定为错误\n5. **保护信心**：总分不低于 7 分，评语先表扬后建议\n\n## 注意事项\n\n- 评分前确认作业为手动发布分数\n- 成绩录入使用 submission[posted_grade]\n- Whisper 转写仅作参考，必须执行对齐校验\n- 鼓励为主，微小误差不扣分\n- 同一错误只扣一次\n- 严格按 A1/A2/B1 能力层级控制纠错数量（操作标签参考 N5/N4/N3 级别）\n- 评语简洁友好，不使用特殊符号\n- 所有规则以 references/workflow.md 为准\n\nFile v2.2.2:_meta.json\n\n{\n  \"ownerId\": \"kn7cw3j55n4hxe9ze445qp81ks86150x\",\n  \"slug\": \"japanese-reading-grader\",\n  \"version\": \"2.2.2\",\n  \"publishedAt\": 1782608598504\n}\n\nFile v2.2.2:skill-card.md\n\n## Description: <br>\n日语朗读作业AI批改（教师模式）——支持音频转写、CEFR分级评价、纠错与成绩录入。 <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[bianmaxingkong](https://clawhub.ai/user/bianmaxingkong) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nTeachers use this skill to grade Japanese reading-aloud audio submissions, transcribe audio with local Whisper, provide CEFR-aligned feedback, record Canvas grades, and generate class summaries. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The workflow can post Canvas grades and upload class summaries without an explicit confirmation step. <br>\nMitigation: Manually review every grade, comment, course ID, assignment ID, student ID, and summary file before running Canvas posting or upload commands. <br>\nRisk: Audio transcription uncertainty can lead to incorrect grading feedback. <br>\nMitigation: Use the artifact's alignment check against the standard answer and send uncertain, missing, extra, or failed transcriptions to manual review instead of automatic scoring. <br>\nRisk: Canvas credentials and permissions are not described by the artifact. <br>\nMitigation: Confirm credential storage, scope, and access controls before use, and run the workflow only for Canvas courses the user controls. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/bianmaxingkong/skills/japanese-reading-grader) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, guidance] <br>\n**Output Format:** [Markdown-style guidance with plain-text grading feedback and bash command examples] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Feedback comments are capped at 1000 characters; batch processing guidance limits a run to 50 students.] <br>\n\n## Skill Version(s): <br>\n2.2.2 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v2.2.1: 3 files, 6847 bytes\n\nFiles: _meta.json (142b), skill-card.md (1805b), SKILL.md (12804b)\n\nFile v2.2.1:SKILL.md\n\n---\r\nname: japanese-reading-grader\r\ndisplayName: 日语朗读作业批改模板\r\ndescription: >\r\n  日语朗读作业智能批改，支持双模式：教师批量批改 + 学生自适应自测。\r\n  覆盖 N5–N1 全级别，采用分层宽松评分、智能发音纠错、自动薄弱点分析及难度升降推荐。\r\n  适配单词、句子、课文、替换练习等全部作业类型。\r\nuse_when: 教师需要批量批改日语朗读作业，学生自主进行日语朗读练习和自测。\r\ntriggers:\r\n  - 日语朗读作业批改\r\n  - 朗读作业评分\r\n  - 日语发音纠错\r\n  - 日语朗读自测练习\r\n  - 日语作业批量评分\r\n---\r\n\r\n## 基本信息\r\n- 技能ID：japanese-reading-grader\r\n- 版本：2.1.1\r\n- 适用场景：\r\n  1. 课文朗读作业批改\r\n  2. 句子朗读作业批改\r\n  3. 单词朗读作业批改\r\n  4. 替换练习操练\r\n  5. 教师批量批改 / 学生自主自测\r\n  6. 学生历史成绩追踪与能力分层\r\n  7. 学生自适应学习\r\n- 目标用户：高校日语教师、日语学习者\r\n\r\n## 运行说明\r\n本技能使用 Whisper medium 模型进行本地语音转写。\r\n固定使用 medium 模型，不切换大小，适配笔记本电脑，避免爆显存、卡顿或崩溃。\r\n本技能支持课文朗读、句子朗读、单词朗读、替换练习四种发音作业，自动适配教师批改与学生自测双模式。\r\n\r\n## 支持练习类型（自动识别）\r\n- 单词朗读：单个或多个单词朗读\r\n- 句子朗读：句型例句朗读\r\n- 课文朗读：长篇课文完整朗读\r\n- 替换练习：按要求替换词汇后朗读句子\r\n\r\n## 学生水平分层（N5～N1）\r\n\r\n### 等级定义\r\n| 等级 | 能力描述 | 适用场景 |\r\n|------|----------|----------|\r\n| N5 | 入门级，能读假名和简单单词 | 初级教材第1-10课 |\r\n| N4 | 基础级，能读短句和简单课文 | 初级教材第11-20课 |\r\n| N3 | 进阶级，能读中长句和日常对话 | 中级教材前半 |\r\n| N2 | 准高级，能读复杂句和短文 | 中级教材后半 |\r\n| N1 | 高级，能读长文和自然语速 | 高级教材/新闻 |\r\n\r\n### 各层级评分差异\r\n| 等级 | 发音容忍度 | 语调要求 | 流畅度要求 | 纠错粒度 |\r\n|------|-----------|----------|-----------|----------|\r\n| N5 | 宽松（清浊/长音小错不扣分） | 基本升降调即可 | 允许较多卡顿 | 只纠致命错误 |\r\n| N4 | 中等（明显错误扣分） | 句尾调基本正确 | 允许少量停顿 | 纠主要错误 |\r\n| N3 | 较严（促音/长音严格） | 句中升降调关注 | 较流畅 | 纠大部分错误 |\r\n| N2 | 严格（接近母语标准） | 自然语调 | 无明显停顿 | 纠所有错误 |\r\n| N1 | 极严（细微差别也扣分） | 情感/强调语调 | 完全自然 | 精细纠错 |\r\n\r\n### 层级扣分系数\r\n| 错误类型 | N5 | N4 | N3 | N2 | N1 |\r\n|----------|----|----|----|----|----|\r\n| 促音错误 | 0.3 | 0.5 | 0.7 | 0.9 | 1.0 |\r\n| 长音错误 | 0.3 | 0.5 | 0.7 | 1.0 | 1.0 |\r\n| 清浊混淆 | 0.2 | 0.3 | 0.5 | 0.7 | 0.9 |\r\n| 拨音错误 | 0.2 | 0.3 | 0.5 | 0.9 | 1.0 |\r\n| 语调错误 | 0.1 | 0.2 | 0.3 | 0.5 | 0.7 |\r\n| 声调错误 | 0.1 | 0.2 | 0.4 | 0.6 | 0.8 |\r\n\r\n## 纠错数量限制（按水平分层）\r\n初学者工作记忆容量有限，情感过滤较强，过多反馈会打击信心、阻碍吸收。\r\n\r\n| 学生水平 | 最多纠错项数 | 说明 |\r\n|----------|-------------|------|\r\n| N5 | 2项 | 只纠正最严重的2个错误，保护学习信心 |\r\n| N4 | 3项 | 纠正主要错误，兼顾鼓励与指导 |\r\n| N3 | 4项 | 较全面纠错，学生已有一定吸收能力 |\r\n| N2 | 5项 | 接近全面纠错，能接受较多反馈 |\r\n| N1 | 不限 | 所有错误全部指出，追求精益求精 |\r\n\r\n### 纠错优先级\r\n当错误数量超过上限时，按以下优先级筛选：\r\n1. 影响语义的错误（清浊、长音、促音）\r\n2. 反复出现的高频错误\r\n3. 语调错误\r\n\r\n---\r\n\r\n# 学生自适应学习系统\r\n\r\n## 核心逻辑\r\n系统根据学生发音错误、流畅度、成绩趋势，自动判断薄弱点、动态调整难度，并推荐最适合的练习内容。\r\n\r\n## 自适应判断维度\r\n1. 发音错误类型（促音/长音/清浊/拨音）\r\n2. 错误频率与集中度\r\n3. 流畅度稳定性\r\n4. 水平进步速度\r\n\r\n## 自适应练习推荐\r\n| 主要错误类型 | 系统自动推荐练习 |\r\n|--------------|------------------|\r\n| 促音错误多 | 促音专项单词、句型朗读 |\r\n| 长音错误多 | 长音专项单词、句子朗读 |\r\n| 清浊混淆多 | 清浊对立词对比朗读 |\r\n| 拨音错误多 | 拨音单词、句型练习 |\r\n| 语调错误多 | 句型例句语调训练 |\r\n| 流畅度偏低 | 慢速短句 → 逐步提升语速 |\r\n\r\n## 自适应升降级规则\r\n### 自动升档\r\n- 最近3次成绩 ≥ 7.5\r\n- 无严重发音错误\r\n- 流畅度稳定提升\r\n→ 自动建议升级\r\n\r\n### 自动降档\r\n- 最近2次成绩 < 6.0\r\n- 基础性错误频繁\r\n→ 自动建议降级巩固\r\n\r\n### 维持当前等级\r\n- 有进步但未达标\r\n→ 继续当前水平，强化薄弱点\r\n\r\n---\r\n\r\n## 学生档案（可选功能）\r\n适用于教师长期追踪学生进步的场景，非必选。默认关闭。\r\n\r\n### 开启方式\r\n```json\r\n{\r\n  \"enable_student_profile\": true\r\n}\r\n```\r\n\r\n### 档案功能\r\n- 自动创建/更新学生档案\r\n- 记录历次成绩和错误类型\r\n- 自适应判断升档/降档\r\n- 生成个性化练习建议\r\n\r\n### 升档判断逻辑\r\n```python\r\ndef check_level_upgrade(profile):\r\n    history = profile[\"submission_history\"][-5:]\r\n    if len(history) >= 3:\r\n        recent_3 = history[-3:]\r\n        all_high_score = all(s[\"score\"] >= 7.5 for s in recent_3)\r\n        no_major_error = all(len(s[\"weak_points\"]) <= 2 for s in recent_3)\r\n        \r\n        if all_high_score and no_major_error:\r\n            return {\r\n                \"should_upgrade\": True,\r\n                \"from_level\": profile[\"current_level\"],\r\n                \"to_level\": next_level(profile[\"current_level\"]),\r\n                \"confidence\": \"高\",\r\n                \"suggestion\": f\"建议{profile['student_name']}尝试{next_level(profile['current_level'])}水平练习\"\r\n            }\r\n    return {\"should_upgrade\": False}\r\n```\r\n\r\n## 双模式使用规则\r\n\r\n### 教师批改模式\r\n上传：音频 + 课文/题目图片（或标准文本）+ 学生姓名 + 学生水平\r\n输出：完整评分报告 + 发音纠错 + 班级汇总 + 自适应学习建议\r\n\r\n### 学生自测模式\r\n上传：仅音频 + 自选水平\r\n输出：个人评分 + 发音纠错 + 练习建议 + 水平评估 + 自适应推荐\r\n无需图片、无需姓名\r\n\r\n## 触发条件\r\n自动识别：\r\n- 音频 + 图片（或文本）+ 姓名 → 教师批改模式\r\n- 仅音频 → 学生自测模式\r\n\r\n## 输入参数\r\n| 参数名 | 类型 | 必填 | 说明 |\r\n|--------|------|------|----------|\r\n| audio | 文件 | 是 | 单词/句子/课文/替换练习音频 |\r\n| image | 文件 | 否 | 原文图片（教师模式推荐） |\r\n| standard_text | 字符串 | 否 | 标准文本（优于图片OCR） |\r\n| student_name | 字符串 | 否 | 学生姓名（教师模式必填） |\r\n| student_level | 字符串 | 否 | N5/N4/N3/N2/N1（默认N5） |\r\n| class_id | 字符串 | 否 | 班级编号 |\r\n\r\n## 评分规则（统一10分制）\r\n\r\n### 评分维度\r\n| 维度 | 权重 | 评分标准 |\r\n|------|------|----------|\r\n| 发音准确性 | 70% | 假名、清浊音、长音、促音、拨音 |\r\n| 语调与节奏 | 10% | 句尾语调、升降调、停顿、节奏 |\r\n| 流畅度 | 20% | 无卡顿、无重复、表达自然 |\r\n\r\n### 最终总分档位\r\n| 最终得分 | 评价 |\r\n|----------|------|\r\n| 8.0–10.0 | 优秀 |\r\n| 7.0–7.9 | 良好 |\r\n| 6.0–6.9 | 中等 |\r\n| 6.0以下 | 待加强 |\r\n\r\n## 替换练习特殊规则\r\n- 教师需提供句型框架 + 允许替换词列表\r\n- 系统只检查句型结构 + 替换词合法性 + 发音正确性\r\n- 不将“替换词与原文不一致”视为错误\r\n\r\n## 输出模板\r\n\r\n### 个人报告模板\r\n```\r\n学生姓名：{name}\r\n当前水平：{current_level}\r\n本次表现：{level_performance}\r\n进步趋势：{trend}\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n【评分结果】\r\n一、总分：{score}/10\r\n\r\n二、各维度评分\r\n发音准确性：{pronunciation}/10\r\n语调与节奏：{intonation}/10\r\n流畅度：{fluency}/10\r\n\r\n三、总体评价\r\n{positive_comment}，{constructive_feedback}。{encouragement}\r\n\r\n四、发音纠错（最多{max_errors}项）\r\n1. 原句：{original}\r\n   学生读法：{student_reading}\r\n   标准读法：{correct_reading}（{kana}）\r\n   错误类型：{error_type}\r\n\r\n五、练习建议\r\n- {suggestion_1}\r\n- {suggestion_2}\r\n- 【升档建议】{promotion_advice}\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n【AI 自适应学习建议】\r\n本次薄弱点：{weak_points}\r\n推荐练习：{adaptive_exercise}\r\n下次建议难度：{next_level}\r\n推荐练习类型：{recommended_type}\r\n```\r\n\r\n### 班级汇总表模板\r\n【全班成绩汇总】\r\n| 姓名 | 当前水平 | 本次得分 | 本次表现 | 进步趋势 | 升档建议 |\r\n|------|----------|----------|----------|----------|----------|\r\n| {name} | {level} | {score} | {performance} | {trend} | {advice} |\r\n\r\n【班级分层统计】\r\n| 水平层级 | 人数 | 平均分 | 优秀率 | 良好率 | 待加强率 |\r\n|----------|------|--------|--------|--------|----------|\r\n| N5 | {n5_count} | {n5_avg} | {n5_excellent} | {n5_good} | {n5_weak} |\r\n| N4 | {n4_count} | {n4_avg} | {n4_excellent} | {n4_good} | {n4_weak} |\r\n| N3 | {n3_count} | {n3_avg} | {n3_excellent} | {n3_good} | {n3_weak} |\r\n| N2 | {n2_count} | {n2_avg} | {n2_excellent} | {n2_good} | {n2_weak} |\r\n| N1 | {n1_count} | {n1_avg} | {n1_excellent} | {n1_good} | {n1_weak} |\r\n\r\n## 工作流程\r\n```\r\n步骤1：接收输入\r\n步骤2：判断使用模式\r\n步骤3：自动识别练习类型\r\n步骤4：获取或创建学生档案\r\n步骤5：获取标准文本\r\n步骤6：音频转文字\r\n步骤7：逐句比对与评分\r\n步骤8：计算总分\r\n步骤9：生成纠错列表\r\n步骤10：自适应分析\r\n步骤11：更新学生档案\r\n步骤12：生成输出文件\r\n```\r\n\r\n## 评测规范\r\n评测原则:\r\n- 鼓励为主，评分适度放宽\r\n- 根据学生水平动态调整扣分力度\r\n- 只纠正影响语义的明显发音错误\r\n- 微小识别误差不予扣分\r\n- Whisper转写结果仅供参考\r\n- 纠错数量按水平分层限制\r\n\r\n⚠️ **同音异义词不判错规则**：\r\n- Whisper 是「音→文字」的转写模型，遇到同音词时会按上下文概率自动猜汉字\r\n- **判定依据是假名（读音），不是汉字**：只要假名读音与标准一致，即使转写汉字不同（如選択→洗濯、科学→化学等），**一律不视为发音错误，不扣分**\r\n- 只有当实际假名发音与标准不一致时（如 また→まだ、コマ→漏读）才判错\r\n- 常见同音词对：選択/洗濯=せんたく、科学/化学=かがく、試験/試練=しけん、公正/公正=こうせい、人口/人工=じんこう\r\n\r\n## 输出排版规则\r\n- 评分结果、总体评价、发音纠错、练习建议等所有一级反馈大项，必须单独另起一行\r\n- 发音纠错内部用 1、2 数字序号\r\n- 练习建议用 1、2 数字序号\r\n- 默认学生水平为 N5~N4，纠错上限为 2 项（影响语义优先）\r\n- 不显示等级标注和纠错等级说明\r\n- 禁用 ⚠ 等表情\r\n\r\n反馈要求:\r\n- 语言：中文\r\n- 纠错粒度：单词级或短语级\r\n- 必须标注：原句、学生读法、标准读法、错误类型\r\n- 文件编码：UTF-8\r\n- 禁止输出学生水平标注（如 N4、N5 等等级标签）\r\n- 禁止输出纠错等级限定类文字（如\"按 N4 水平最多 2 项纠错\"等说明）\r\n\r\n错误类型定义:\r\n| 错误类型 | 示例 |\r\n|----------|------|\r\n| 促音错误 | がっこう → がこう |\r\n| 长音错误 | おかあさん → おかさん |\r\n| 清浊混淆 | びょういん → ひょういん |\r\n| 拨音错误 | にほん → にほ |\r\n| 语调错误 | 句尾升调读成降调 |\r\n\r\n## 输出文件清单\r\n| 文件名 | 格式 | 说明 |\r\n|--------|------|------|\r\n| {学生姓名}_评分报告.txt | UTF-8文本 | 个人评分报告 + 自适应建议 |\r\n| 班级{班级号}_成绩汇总表.xlsx | Excel | 全班成绩 + 分层统计 |\r\n| 班级{班级号}_分层学情分析.txt | UTF-8文本 | 各层级表现分析 |\r\n| 班级{班级号}_升档推荐名单.txt | UTF-8文本 | 建议升档学生 |\r\n| 班级{班级号}_课堂讲评建议.txt | UTF-8文本 | 分层教学建议 |\r\n\r\n## 配置文件示例\r\n```json\r\n{\r\n  \"enable_student_profile\": false,\r\n  \"whisper_model\": \"medium\",\r\n  \"output_encoding\": \"UTF-8\"\r\n}\r\n```\n\nFile v2.2.1:_meta.json\n\n{\n  \"ownerId\": \"kn7cw3j55n4hxe9ze445qp81ks86150x\",\n  \"slug\": \"japanese-reading-grader\",\n  \"version\": \"2.2.1\",\n  \"publishedAt\": 1782565516696\n}\n\nFile v2.2.1:skill-card.md\n\n## Description: <br>\nGrades Japanese reading-aloud assignments and self-practice across N5-N1 levels, with pronunciation feedback, scoring, weak-point analysis, and practice recommendations. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[bianmaxingkong](https://clawhub.ai/user/bianmaxingkong) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nJapanese teachers use this skill to batch grade reading-aloud homework and generate individual or class reports. Japanese learners use it for self-assessment, pronunciation correction, and adaptive practice recommendations. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill may process student names, audio, scores, and generated reports that should be treated as sensitive. <br>\nMitigation: Use minimal identifiers, keep student profiles disabled unless needed, store generated reports in protected locations, and share class summaries only with authorized recipients. <br>\n\n\n## Reference(s): <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, configuration, guidance] <br>\n**Output Format:** [Text or Markdown reports with optional configuration JSON examples] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May produce individual grading reports, class summaries, weak-point analyses, promotion recommendations, and teaching suggestions.] <br>\n\n## Skill Version(s): <br>\n2.2.1 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v2.2.0: 3 files, 6998 bytes\n\nFiles: _meta.json (142b), skill-card.md (2222b), SKILL.md (12804b)\n\nFile v2.2.0:SKILL.md\n\n---\r\nname: japanese-reading-grader\r\ndisplayName: 日语朗读作业批改模板\r\ndescription: >\r\n  日语朗读作业智能批改，支持双模式：教师批量批改 + 学生自适应自测。\r\n  覆盖 N5–N1 全级别，采用分层宽松评分、智能发音纠错、自动薄弱点分析及难度升降推荐。\r\n  适配单词、句子、课文、替换练习等全部作业类型。\r\nuse_when: 教师需要批量批改日语朗读作业，学生自主进行日语朗读练习和自测。\r\ntriggers:\r\n  - 日语朗读作业批改\r\n  - 朗读作业评分\r\n  - 日语发音纠错\r\n  - 日语朗读自测练习\r\n  - 日语作业批量评分\r\n---\r\n\r\n## 基本信息\r\n- 技能ID：japanese-reading-grader\r\n- 版本：2.1.1\r\n- 适用场景：\r\n  1. 课文朗读作业批改\r\n  2. 句子朗读作业批改\r\n  3. 单词朗读作业批改\r\n  4. 替换练习操练\r\n  5. 教师批量批改 / 学生自主自测\r\n  6. 学生历史成绩追踪与能力分层\r\n  7. 学生自适应学习\r\n- 目标用户：高校日语教师、日语学习者\r\n\r\n## 运行说明\r\n本技能使用 Whisper medium 模型进行本地语音转写。\r\n固定使用 medium 模型，不切换大小，适配笔记本电脑，避免爆显存、卡顿或崩溃。\r\n本技能支持课文朗读、句子朗读、单词朗读、替换练习四种发音作业，自动适配教师批改与学生自测双模式。\r\n\r\n## 支持练习类型（自动识别）\r\n- 单词朗读：单个或多个单词朗读\r\n- 句子朗读：句型例句朗读\r\n- 课文朗读：长篇课文完整朗读\r\n- 替换练习：按要求替换词汇后朗读句子\r\n\r\n## 学生水平分层（N5～N1）\r\n\r\n### 等级定义\r\n| 等级 | 能力描述 | 适用场景 |\r\n|------|----------|----------|\r\n| N5 | 入门级，能读假名和简单单词 | 初级教材第1-10课 |\r\n| N4 | 基础级，能读短句和简单课文 | 初级教材第11-20课 |\r\n| N3 | 进阶级，能读中长句和日常对话 | 中级教材前半 |\r\n| N2 | 准高级，能读复杂句和短文 | 中级教材后半 |\r\n| N1 | 高级，能读长文和自然语速 | 高级教材/新闻 |\r\n\r\n### 各层级评分差异\r\n| 等级 | 发音容忍度 | 语调要求 | 流畅度要求 | 纠错粒度 |\r\n|------|-----------|----------|-----------|----------|\r\n| N5 | 宽松（清浊/长音小错不扣分） | 基本升降调即可 | 允许较多卡顿 | 只纠致命错误 |\r\n| N4 | 中等（明显错误扣分） | 句尾调基本正确 | 允许少量停顿 | 纠主要错误 |\r\n| N3 | 较严（促音/长音严格） | 句中升降调关注 | 较流畅 | 纠大部分错误 |\r\n| N2 | 严格（接近母语标准） | 自然语调 | 无明显停顿 | 纠所有错误 |\r\n| N1 | 极严（细微差别也扣分） | 情感/强调语调 | 完全自然 | 精细纠错 |\r\n\r\n### 层级扣分系数\r\n| 错误类型 | N5 | N4 | N3 | N2 | N1 |\r\n|----------|----|----|----|----|----|\r\n| 促音错误 | 0.3 | 0.5 | 0.7 | 0.9 | 1.0 |\r\n| 长音错误 | 0.3 | 0.5 | 0.7 | 1.0 | 1.0 |\r\n| 清浊混淆 | 0.2 | 0.3 | 0.5 | 0.7 | 0.9 |\r\n| 拨音错误 | 0.2 | 0.3 | 0.5 | 0.9 | 1.0 |\r\n| 语调错误 | 0.1 | 0.2 | 0.3 | 0.5 | 0.7 |\r\n| 声调错误 | 0.1 | 0.2 | 0.4 | 0.6 | 0.8 |\r\n\r\n## 纠错数量限制（按水平分层）\r\n初学者工作记忆容量有限，情感过滤较强，过多反馈会打击信心、阻碍吸收。\r\n\r\n| 学生水平 | 最多纠错项数 | 说明 |\r\n|----------|-------------|------|\r\n| N5 | 2项 | 只纠正最严重的2个错误，保护学习信心 |\r\n| N4 | 3项 | 纠正主要错误，兼顾鼓励与指导 |\r\n| N3 | 4项 | 较全面纠错，学生已有一定吸收能力 |\r\n| N2 | 5项 | 接近全面纠错，能接受较多反馈 |\r\n| N1 | 不限 | 所有错误全部指出，追求精益求精 |\r\n\r\n### 纠错优先级\r\n当错误数量超过上限时，按以下优先级筛选：\r\n1. 影响语义的错误（清浊、长音、促音）\r\n2. 反复出现的高频错误\r\n3. 语调错误\r\n\r\n---\r\n\r\n# 学生自适应学习系统\r\n\r\n## 核心逻辑\r\n系统根据学生发音错误、流畅度、成绩趋势，自动判断薄弱点、动态调整难度，并推荐最适合的练习内容。\r\n\r\n## 自适应判断维度\r\n1. 发音错误类型（促音/长音/清浊/拨音）\r\n2. 错误频率与集中度\r\n3. 流畅度稳定性\r\n4. 水平进步速度\r\n\r\n## 自适应练习推荐\r\n| 主要错误类型 | 系统自动推荐练习 |\r\n|--------------|------------------|\r\n| 促音错误多 | 促音专项单词、句型朗读 |\r\n| 长音错误多 | 长音专项单词、句子朗读 |\r\n| 清浊混淆多 | 清浊对立词对比朗读 |\r\n| 拨音错误多 | 拨音单词、句型练习 |\r\n| 语调错误多 | 句型例句语调训练 |\r\n| 流畅度偏低 | 慢速短句 → 逐步提升语速 |\r\n\r\n## 自适应升降级规则\r\n### 自动升档\r\n- 最近3次成绩 ≥ 7.5\r\n- 无严重发音错误\r\n- 流畅度稳定提升\r\n→ 自动建议升级\r\n\r\n### 自动降档\r\n- 最近2次成绩 < 6.0\r\n- 基础性错误频繁\r\n→ 自动建议降级巩固\r\n\r\n### 维持当前等级\r\n- 有进步但未达标\r\n→ 继续当前水平，强化薄弱点\r\n\r\n---\r\n\r\n## 学生档案（可选功能）\r\n适用于教师长期追踪学生进步的场景，非必选。默认关闭。\r\n\r\n### 开启方式\r\n```json\r\n{\r\n  \"enable_student_profile\": true\r\n}\r\n```\r\n\r\n### 档案功能\r\n- 自动创建/更新学生档案\r\n- 记录历次成绩和错误类型\r\n- 自适应判断升档/降档\r\n- 生成个性化练习建议\r\n\r\n### 升档判断逻辑\r\n```python\r\ndef check_level_upgrade(profile):\r\n    history = profile[\"submission_history\"][-5:]\r\n    if len(history) >= 3:\r\n        recent_3 = history[-3:]\r\n        all_high_score = all(s[\"score\"] >= 7.5 for s in recent_3)\r\n        no_major_error = all(len(s[\"weak_points\"]) <= 2 for s in recent_3)\r\n        \r\n        if all_high_score and no_major_error:\r\n            return {\r\n                \"should_upgrade\": True,\r\n                \"from_level\": profile[\"current_level\"],\r\n                \"to_level\": next_level(profile[\"current_level\"]),\r\n                \"confidence\": \"高\",\r\n                \"suggestion\": f\"建议{profile['student_name']}尝试{next_level(profile['current_level'])}水平练习\"\r\n            }\r\n    return {\"should_upgrade\": False}\r\n```\r\n\r\n## 双模式使用规则\r\n\r\n### 教师批改模式\r\n上传：音频 + 课文/题目图片（或标准文本）+ 学生姓名 + 学生水平\r\n输出：完整评分报告 + 发音纠错 + 班级汇总 + 自适应学习建议\r\n\r\n### 学生自测模式\r\n上传：仅音频 + 自选水平\r\n输出：个人评分 + 发音纠错 + 练习建议 + 水平评估 + 自适应推荐\r\n无需图片、无需姓名\r\n\r\n## 触发条件\r\n自动识别：\r\n- 音频 + 图片（或文本）+ 姓名 → 教师批改模式\r\n- 仅音频 → 学生自测模式\r\n\r\n## 输入参数\r\n| 参数名 | 类型 | 必填 | 说明 |\r\n|--------|------|------|----------|\r\n| audio | 文件 | 是 | 单词/句子/课文/替换练习音频 |\r\n| image | 文件 | 否 | 原文图片（教师模式推荐） |\r\n| standard_text | 字符串 | 否 | 标准文本（优于图片OCR） |\r\n| student_name | 字符串 | 否 | 学生姓名（教师模式必填） |\r\n| student_level | 字符串 | 否 | N5/N4/N3/N2/N1（默认N5） |\r\n| class_id | 字符串 | 否 | 班级编号 |\r\n\r\n## 评分规则（统一10分制）\r\n\r\n### 评分维度\r\n| 维度 | 权重 | 评分标准 |\r\n|------|------|----------|\r\n| 发音准确性 | 70% | 假名、清浊音、长音、促音、拨音 |\r\n| 语调与节奏 | 10% | 句尾语调、升降调、停顿、节奏 |\r\n| 流畅度 | 20% | 无卡顿、无重复、表达自然 |\r\n\r\n### 最终总分档位\r\n| 最终得分 | 评价 |\r\n|----------|------|\r\n| 8.0–10.0 | 优秀 |\r\n| 7.0–7.9 | 良好 |\r\n| 6.0–6.9 | 中等 |\r\n| 6.0以下 | 待加强 |\r\n\r\n## 替换练习特殊规则\r\n- 教师需提供句型框架 + 允许替换词列表\r\n- 系统只检查句型结构 + 替换词合法性 + 发音正确性\r\n- 不将“替换词与原文不一致”视为错误\r\n\r\n## 输出模板\r\n\r\n### 个人报告模板\r\n```\r\n学生姓名：{name}\r\n当前水平：{current_level}\r\n本次表现：{level_performance}\r\n进步趋势：{trend}\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n【评分结果】\r\n一、总分：{score}/10\r\n\r\n二、各维度评分\r\n发音准确性：{pronunciation}/10\r\n语调与节奏：{intonation}/10\r\n流畅度：{fluency}/10\r\n\r\n三、总体评价\r\n{positive_comment}，{constructive_feedback}。{encouragement}\r\n\r\n四、发音纠错（最多{max_errors}项）\r\n1. 原句：{original}\r\n   学生读法：{student_reading}\r\n   标准读法：{correct_reading}（{kana}）\r\n   错误类型：{error_type}\r\n\r\n五、练习建议\r\n- {suggestion_1}\r\n- {suggestion_2}\r\n- 【升档建议】{promotion_advice}\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n【AI 自适应学习建议】\r\n本次薄弱点：{weak_points}\r\n推荐练习：{adaptive_exercise}\r\n下次建议难度：{next_level}\r\n推荐练习类型：{recommended_type}\r\n```\r\n\r\n### 班级汇总表模板\r\n【全班成绩汇总】\r\n| 姓名 | 当前水平 | 本次得分 | 本次表现 | 进步趋势 | 升档建议 |\r\n|------|----------|----------|----------|----------|----------|\r\n| {name} | {level} | {score} | {performance} | {trend} | {advice} |\r\n\r\n【班级分层统计】\r\n| 水平层级 | 人数 | 平均分 | 优秀率 | 良好率 | 待加强率 |\r\n|----------|------|--------|--------|--------|----------|\r\n| N5 | {n5_count} | {n5_avg} | {n5_excellent} | {n5_good} | {n5_weak} |\r\n| N4 | {n4_count} | {n4_avg} | {n4_excellent} | {n4_good} | {n4_weak} |\r\n| N3 | {n3_count} | {n3_avg} | {n3_excellent} | {n3_good} | {n3_weak} |\r\n| N2 | {n2_count} | {n2_avg} | {n2_excellent} | {n2_good} | {n2_weak} |\r\n| N1 | {n1_count} | {n1_avg} | {n1_excellent} | {n1_good} | {n1_weak} |\r\n\r\n## 工作流程\r\n```\r\n步骤1：接收输入\r\n步骤2：判断使用模式\r\n步骤3：自动识别练习类型\r\n步骤4：获取或创建学生档案\r\n步骤5：获取标准文本\r\n步骤6：音频转文字\r\n步骤7：逐句比对与评分\r\n步骤8：计算总分\r\n步骤9：生成纠错列表\r\n步骤10：自适应分析\r\n步骤11：更新学生档案\r\n步骤12：生成输出文件\r\n```\r\n\r\n## 评测规范\r\n评测原则:\r\n- 鼓励为主，评分适度放宽\r\n- 根据学生水平动态调整扣分力度\r\n- 只纠正影响语义的明显发音错误\r\n- 微小识别误差不予扣分\r\n- Whisper转写结果仅供参考\r\n- 纠错数量按水平分层限制\r\n\r\n⚠️ **同音异义词不判错规则**：\r\n- Whisper 是「音→文字」的转写模型，遇到同音词时会按上下文概率自动猜汉字\r\n- **判定依据是假名（读音），不是汉字**：只要假名读音与标准一致，即使转写汉字不同（如選択→洗濯、科学→化学等），**一律不视为发音错误，不扣分**\r\n- 只有当实际假名发音与标准不一致时（如 また→まだ、コマ→漏读）才判错\r\n- 常见同音词对：選択/洗濯=せんたく、科学/化学=かがく、試験/試練=しけん、公正/公正=こうせい、人口/人工=じんこう\r\n\r\n## 输出排版规则\r\n- 评分结果、总体评价、发音纠错、练习建议等所有一级反馈大项，必须单独另起一行\r\n- 发音纠错内部用 1、2 数字序号\r\n- 练习建议用 1、2 数字序号\r\n- 默认学生水平为 N5~N4，纠错上限为 2 项（影响语义优先）\r\n- 不显示等级标注和纠错等级说明\r\n- 禁用 ⚠ 等表情\r\n\r\n反馈要求:\r\n- 语言：中文\r\n- 纠错粒度：单词级或短语级\r\n- 必须标注：原句、学生读法、标准读法、错误类型\r\n- 文件编码：UTF-8\r\n- 禁止输出学生水平标注（如 N4、N5 等等级标签）\r\n- 禁止输出纠错等级限定类文字（如\"按 N4 水平最多 2 项纠错\"等说明）\r\n\r\n错误类型定义:\r\n| 错误类型 | 示例 |\r\n|----------|------|\r\n| 促音错误 | がっこう → がこう |\r\n| 长音错误 | おかあさん → おかさん |\r\n| 清浊混淆 | びょういん → ひょういん |\r\n| 拨音错误 | にほん → にほ |\r\n| 语调错误 | 句尾升调读成降调 |\r\n\r\n## 输出文件清单\r\n| 文件名 | 格式 | 说明 |\r\n|--------|------|------|\r\n| {学生姓名}_评分报告.txt | UTF-8文本 | 个人评分报告 + 自适应建议 |\r\n| 班级{班级号}_成绩汇总表.xlsx | Excel | 全班成绩 + 分层统计 |\r\n| 班级{班级号}_分层学情分析.txt | UTF-8文本 | 各层级表现分析 |\r\n| 班级{班级号}_升档推荐名单.txt | UTF-8文本 | 建议升档学生 |\r\n| 班级{班级号}_课堂讲评建议.txt | UTF-8文本 | 分层教学建议 |\r\n\r\n## 配置文件示例\r\n```json\r\n{\r\n  \"enable_student_profile\": false,\r\n  \"whisper_model\": \"medium\",\r\n  \"output_encoding\": \"UTF-8\"\r\n}\r\n```\n\nFile v2.2.0:_meta.json\n\n{\n  \"ownerId\": \"kn7cw3j55n4hxe9ze445qp81ks86150x\",\n  \"slug\": \"japanese-reading-grader\",\n  \"version\": \"2.2.0\",\n  \"publishedAt\": 1782565190506\n}\n\nFile v2.2.0:skill-card.md\n\n## Description: <br>\nJapanese Reading Grader helps teachers batch-grade Japanese reading assignments and helps students self-assess pronunciation practice across N5-N1 levels. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[bianmaxingkong](https://clawhub.ai/user/bianmaxingkong) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal educators and Japanese learners use this skill to grade reading audio, identify pronunciation errors, generate learner feedback, summarize class performance, and recommend adaptive practice. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill can handle persistent student-identifying performance records. <br>\nMitigation: Use pseudonyms or student IDs where possible, avoid unnecessary student names, store generated reports securely, and delete profiles or reports when they are no longer needed. <br>\nRisk: Generated classroom reports and adaptive recommendations may influence grading or learning decisions. <br>\nMitigation: Have a teacher review scores, pronunciation corrections, and recommendations before using them for official assessment or student placement. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/bianmaxingkong/skills/japanese-reading-grader) <br>\n- [Publisher profile](https://clawhub.ai/user/bianmaxingkong) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Text, Markdown, Files, Configuration, Guidance] <br>\n**Output Format:** [Chinese UTF-8 text reports, Markdown-style tables, JSON configuration snippets, and optional Excel summaries] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Outputs can include student names, class identifiers, scores, pronunciation error categories, weak points, and adaptive practice recommendations.] <br>\n\n## Skill Version(s): <br>\n2.2.0 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v2.1.6: 3 files, 5357 bytes\n\nFiles: skill-card.md (2417b), SKILL.md (7105b), _meta.json (142b)\n\nFile v2.1.6:SKILL.md\n\n```markdown\r\n# 日语朗读作业批改 - 详细流程与评分规则\r\n\r\n## 适用场景\r\n\r\n学生提交音频文件（MP3/MP4/M4A/WAV）朗读日语文本，教师需要：\r\n下载 → 转写 → 评分 → 纠错 → 录入成绩 → 生成班级汇总\r\n\r\n## 一、作业基础信息\r\n\r\n1. 适用对象：A1/A2/B1 日语学习者\r\n# 分级纠错规则（A1 / A2 / B1 独立执行）\r\n    JF Can-do / CEFR + JLPT级别参考对应关系\r\n   A1 ≈ N5级别\r\n   A2 ≈ N4级别\r\n   B1 ≈ N3级别\r\n2. 作业形式：朗读音频\r\n3. 总分：10 分\r\n\r\n---\r\n\r\n## 二、前置准备（Step 0）\r\n\r\n1. 标准答案文本存储路径：`./answer/{COURSE_ID}_{ASSIGNMENT_ID}_answer.txt`\r\n2. 文本格式要求：\r\n   - 每行 1 个完整句子，无多余空格与换行\r\n   - 重点词汇标注假名\r\n   - 不含多余标点，便于音频转写对齐\r\n3. 版本校验：批改前确认标准答案与作业要求一致\r\n\r\n---\r\n\r\n## 三、音频处理流程（Step 1–2）\r\n\r\n1. 音频统一格式转换：\r\n   - 批量转为 wav 格式，统一采样率\r\n   - 存放路径：`./audio/{student_id}/`\r\n2. Whisper 语音转文字：\r\n   - 使用 medium 模型，固定不切换\r\n   - 输出纯文本文件\r\n   - 异常处理规则：\r\n     - 音频损坏/空文件/无法识别 → 标记「转写失败」\r\n     - 自动移入 `./error_audio/`，触发人工复核\r\n     - 跳过自动评分，不直接判定低分\r\n\r\n---\r\n\r\n## 四、评分规则（核心·鼓励版）\r\n\r\n### 4.1 基础分与总分规则\r\n\r\n**基础分：10.0 分**\r\n\r\n**计分公式：**\r\n```\r\n总分 = 10.0 - 累计扣分\r\n约束：7.0 ≤ 总分 ≤ 10.0\r\n```\r\n\r\n**扣分上限：3.0 分**（超过不再扣）\r\n\r\n---\r\n\r\n### 4.2 错误类型与扣分值（仅3类）\r\n\r\n| 错误类型 | 扣分 | 说明 |\r\n|----------|------|------|\r\n| 严重发音错误 | **-0.5** | 促音、长音、清浊混淆（三者任一出现） |\r\n| 漏读/多读整句 | **-0.5** | 漏掉一整句 或 多读一整句 |\r\n| 中途中断/长时间停顿 | **-0.5** | 朗读中途放弃，或停顿超过3秒 |\r\n\r\n**重要规则：**\r\n- 同一错误类型全篇**只扣一次**，不重复累计\r\n- 上述3类错误若同时出现，累计扣分（最多 -1.5，但扣分上限为 3.0）\r\n\r\n> 注：扣分上限 3.0 意味着理论上最多可扣 6 次（每类 2 次），但同一类型只扣一次，所以实际最多扣 1.5 分。此处保留 3.0 上限作为安全边界。\r\n\r\n---\r\n\r\n### 4.3 不扣分的情况\r\n\r\n- 句尾拖音、语气词（よ/ね）\r\n- 「は」vs「わ」、「を」vs「お」等微小识别差异\r\n- 语调轻微偏差、声调轻微偏差\r\n- 语速稍慢或稍快\r\n- 轻微卡顿（≤2处，每处<2秒）\r\n- 拨音（ん）偶尔读不到位（N5/N4 宽容）\r\n- 同一错误类型仅出现一次且不影响语义理解\r\n- 转写存疑、不确定是否为错误 → **不扣分**\r\n\r\n---\r\n\r\n### 4.4 评分维度（CAF三维框架，每题满分10分）\r\n| 维度 | 权重 | 评分要点 |\r\n|------|------|----------|\r\n| C 复杂性（Complexity） | 80% | 内容贴合与表达复杂度 |\r\n| A 准确性（Accuracy） |10% | 语法、词汇、语音规范 |\r\n| F 流利度（Fluency） | 10% | 话语输出节奏、连贯性、停顿与沉默控制容 |\r\n\r\n### 等级划分\r\n| 分数区间 | 等级 |\r\n|---------|------|\r\n| 8.0～10.0 | 优秀 |\r\n| 7.0～7.9 | 良好 |\r\n| 6.0～6.9 | 合格 |\r\n| 6.0以下 | 需加强 |\r\n\r\n-\r\n## 五、纠错规则（鼓励导向）\r\n\r\n### 5.1 篇幅定义\r\n- 短篇：150字以内\r\n- 长篇：150字以上\r\n\r\n### 5.2 纠错上限（按水平+篇幅）\r\n\r\n| 学生水平 | 短篇 | 长篇 |\r\n|----------|------|------|\r\n| A1 | 1项 | 2项 |\r\n| A2 | 2项 | 3项 |\r\n| B1 | 2项 | 3项 |\r\n\r\n### 5.3 纠错优先级（超过上限时）\r\n1. 影响语义的错误（清浊、长音、促音）\r\n2. 反复出现的高频错误\r\n3. 语调错误\r\n\r\n### 5.4 通用纠错原则\r\n- 优先纠正影响语义的关键错误\r\n- 同一错误只纠正一次\r\n- 先表扬优点，再提出改进建议\r\n- 不使用警示符号（如 ⚠），语气鼓励为主\r\n- 转写存疑、不确定的地方不纠错\r\n\r\n---\r\n\r\n## 六、强制校验流程（防误判）\r\n\r\n### 6.1 对齐校验（防止 Whisper 听错导致误判）\r\n\r\n批改前，必须逐句比较「Whisper 转写文本」与「标准答案文本」：\r\n\r\n- 如果转写文本与标准答案完全一致或仅尾音差异 → 继续批改\r\n- 如果转写文本与标准答案存在假名级别差异（如「学校」→「公園」）→ 该句不扣分，标记「转写存疑，请人工复核」\r\n- 如果转写文本缺失或多余整句 → 跳过该句，标记「可能漏读或多读，请人工复核」\r\n\r\n### 6.2 错误判定强制引用表\r\n\r\n每个潜在错误必须同时满足以下条件才能判定为对应类型：\r\n\r\n| 错误类型 | 必须同时满足的条件 |\r\n|----------|-------------------|\r\n| 促音错误 | ① 标准答案中有「っ」 ② 转写文本中该处完全无「っ」或明显替换为其他音 |\r\n| 长音错误 | ① 标准答案中有长音规则（あ段+あ等） ② 转写文本中该处为短音或断成两拍 |\r\n| 清浊混淆 | ① 标准答案为清音（か/さ/た/は行） ② 转写文本为对应浊音（が/ざ/だ/ば行），或反之 |\r\n| 漏读/跳读 | ① 标准答案中有该假名 ② 转写文本中完全无对应音节 |\r\n\r\n---\r\n\r\n## 七、报告输出\r\n\r\n### 7.1 个人评分报告模板\r\n\r\n```\r\n学生姓名：{name}\r\n\r\n【评分结果】\r\n总分：{score}/10\r\n发音准确性：{pronunciation_score}/10\r\n语调与节奏：{intonation_score}/10\r\n流畅度：{fluency_score}/10\r\n\r\n【总体评价】\r\n{positive_comment}，{constructive_feedback}。{encouragement}\r\n\r\n【发音纠错】\r\n1. 原句：{original}\r\n   学生读法：{student_reading}\r\n   标准读法：{correct_reading}（{kana}）\r\n   错误类型：{error_type}\r\n\r\n【练习建议】\r\n1. {suggestion_1}\r\n2. {suggestion_2}\r\n```\r\n\r\n### 7.2 输出排版规则\r\n\r\n- 评分结果、总体评价、发音纠错、练习建议等所有一级反馈大项，必须单独另起一行\r\n- 发音纠错内部用 1、2 数字序号\r\n- 练习建议用 1、2 数字序号\r\n- 不显示等级标注和纠错等级说明\r\n- 禁用 ⚠ 等 emoji\r\n- 评语长度 ≤ 1000 字符（适配平台限制）\r\n- 优先展示优点，再提 1–2 条最关键改进建议\r\n\r\n### 7.3 输出文件\r\n\r\n- 输出路径：`./report/{student_id}.txt`\r\n\r\n---\r\n\r\n## 八、批量处理规则\r\n\r\n1. 进度文件：`./progress/{course}_{task}_progress.json`\r\n2. 支持中断后继续执行\r\n3. 单次批量 ≤ 50 人，分批处理避免崩溃\r\n4. 失败音频自动标记，不影响整体流程\r\n\r\n---\r\n\r\n## 九、核心原则\r\n\r\n1. **鼓励为主**：从 10 分起评，据实扣分，不刻意压低分数\r\n2. **只纠严重错误**：只纠正影响语义的明显发音错误，微小误差不计\r\n3. **同一错误只扣一次**：不重复扣分\r\n4. **不确定时不判错**：转写存疑或判定不确定时，优先选择不判定为错误\r\n5. **保护信心**：总分不低于 7 分，评语先表扬后建议\r\n```\r\n\r\n---\n\nFile v2.1.6:_meta.json\n\n{\n  \"ownerId\": \"kn7cw3j55n4hxe9ze445qp81ks86150x\",\n  \"slug\": \"japanese-reading-grader\",\n  \"version\": \"2.1.6\",\n  \"publishedAt\": 1781966117304\n}\n\nFile v2.1.6:skill-card.md\n\n## Description: <br>\n为日语教师和学习者提供朗读作业批改流程，覆盖音频转写、宽松评分、发音纠错、薄弱点分析和练习建议生成。 <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[bianmaxingkong](https://clawhub.ai/user/bianmaxingkong) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nTeachers use this skill to batch grade Japanese reading audio for A1/A2/B1 learners, generate per-student feedback, and prepare class scoring records. Students may also use the workflow for adaptive self-checks when the same answer text and privacy controls are in place. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Student audio, transcripts, reports, and progress files may contain personal or educational records stored locally. <br>\nMitigation: Use a dedicated working directory, restrict access to generated files, and apply the school or organization's privacy and retention rules before using real submissions. <br>\nRisk: Local report files or moved failed audio files may overwrite or displace original student work if paths are reused. <br>\nMitigation: Back up originals, use unique report filenames, and review the error-audio folder before cleanup or resubmission. <br>\nRisk: Speech transcription uncertainty can lead to incorrect grading decisions. <br>\nMitigation: Treat failed or uncertain transcription as a manual review case before finalizing grades. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/bianmaxingkong/japanese-reading-grader) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown guidance with plain-text grading report templates and local file-path conventions] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Produces student-facing feedback, score summaries, review flags for failed or uncertain transcription, and local report/progress file paths.] <br>\n\n## Skill Version(s): <br>\n2.1.6 (source: server release metadata) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v2.1.5: 3 files, 4383 bytes\n\nFiles: skill-card.md (2249b), SKILL.md (5757b), _meta.json (142b)\n\nFile v2.1.5:SKILL.md\n\n---\r\nname: japanese-reading-grading\r\ndescription: \"日语朗读作业批改（双模式）。支持教师批量批改+学生自测打分，自动转写、N5-N1分层评分、发音纠错、成绩汇总、自适应升降级。兼容本地/Canvas环境，鼓励式评分。\"\r\n---\r\n\r\n# 日语朗读作业批改（双模式通用版）\r\n支持：**教师批改模式** / **学生自测模式**\r\n适用：N5/N4/N3/N2/N1 日语学习者 | 音频格式：MP3/MP4/M4A/WAV\r\n\r\n---\r\n\r\n## 一、工作总流程\r\nStep 1 → 加载标准文本 / 标准音频\r\nStep 2 → 音频预处理 + Whisper medium 转写\r\nStep 3 → 分层评分 + 鼓励式纠错\r\nStep 4 → 生成个人评分报告\r\nStep 5 → 教师模式：生成班级汇总\r\nStep 6 → 学生模式：生成个性化练习建议\r\n\r\n---\r\n\r\n## 二、模式自动识别\r\n- **教师模式**：输入=标准文本/音频 + 多名学生音频 + 姓名/学号\r\n- **学生模式**：输入=个人音频 + 标准文本/音频 + 自选等级\r\n\r\n---\r\n\r\n## 三、音频处理流程（统一标准）\r\n### Step 1：音频格式统一\r\n- 转换为 WAV 格式\r\n- 采样率 16000Hz、单声道\r\n- 异常音频自动标记，不打低分\r\n\r\n### Step 2：Whisper 语音转写（固定配置）\r\n```bash\r\nffmpeg -y -i input.mp4 -vn -acodec pcm_s16le -ar 16000 -ac 1 audio.wav\r\nwhisper audio.wav --model medium --language ja --output_format txt\r\n```\r\n- 仅做转写，不做发音打分依据\r\n- 转写存疑 → 标记人工复核，不扣分\r\n\r\n---\r\n\r\n## 四、评分规则（鼓励版 · N5-N1 分层）\r\n\r\n### 4.1 基础分与总分规则\r\n\r\n**基础分：10.0 分**\r\n\r\n**计分公式：**\r\n```\r\n总分 = 10.0 - 累计扣分\r\n约束：6.0 ≤ 总分 ≤ 10.0\r\n```\r\n\r\n**扣分上限：4.0 分**（超过不再扣）\r\n\r\n---\r\n\r\n### 4.2 错误类型与扣分值（仅3类）\r\n\r\n| 错误类型 | 扣分 | 说明 |\r\n|----------|------|------|\r\n| 严重发音错误 | **-0.5** | 促音、长音、清浊混淆（三者任一出现） |\r\n| 漏读/多读整句 | **-0.5** | 漏掉一整句 或 多读一整句 |\r\n| 中途中断/长时间停顿 | **-0.5** | 朗读中途放弃，或停顿超过3秒 |\r\n\r\n**重要规则：**\r\n- 同一错误类型全篇**只扣一次**，不重复累计\r\n- 上述3类错误若同时出现，累计扣分最多（最多 -1.5，但扣分上限为4.0）\r\n\r\n---\r\n\r\n### 4.3 各层级额外宽容规则\r\n\r\n| 层级 | 宽容规则 |\r\n|------|----------|\r\n| **N5** | 声调轻微偏差、拨音偶尔读不到位、轻微卡顿（≤3处）→ **不扣分** |\r\n| **N4** | 声调轻微偏差、轻微卡顿（≤2处）→ **不扣分** |\r\n| **N3** | 轻微卡顿（≤1处）→ **不扣分** |\r\n| **N2** | 无宽容项，按标准执行 |\r\n| **N1** | 无宽容项，按标准执行 |\r\n\r\n---\r\n\r\n### 4.4 评分维度（用于报告展示）\r\n\r\n| 维度 | 权重 | 说明 |\r\n|------|------|------|\r\n| 发音准确性 | 35% | 假名、清浊音、长音、促音、拨音 |\r\n| 语调与节奏 | 30% | 句尾升降调、语句自然起伏 |\r\n| 流畅度 | 35% | 连贯性、停顿、中断 |\r\n\r\n**维度得分与总分关系：**\r\n- 维度得分（发音/语调/流畅度）仅用于报告展示\r\n- 最终总分以 4.1 公式为准（10.0 - 累计扣分）\r\n- 两者可以不一致\r\n\r\n---\r\n\r\n### 4.5 等级划分\r\n\r\n| 等级 | 分数区间 |\r\n|------|----------|\r\n| 优秀 | 8.0 ~ 10.0 |\r\n| 良好 | 7.0 ~ 7.9 |\r\n| 中等 | 6.0 ~ 6.9 |\r\n\r\n---\r\n\r\n## 五、纠错规则（鼓励导向）\r\n\r\n### 5.1 篇幅定义\r\n- 短篇：150字以内\r\n- 长篇：150字以上\r\n\r\n### 5.2 纠错上限（按水平+篇幅）\r\n\r\n| 学生水平 | 短篇 | 长篇 |\r\n|----------|------|------|\r\n| N5 | 1项 | 2项 |\r\n| N4 | 2项 | 3项 |\r\n| N3 | 2项 | 3项 |\r\n| N2 | 3项 | 4项 |\r\n| N1 | 4项 | 5项 |\r\n\r\n### 5.3 不扣分项目（全层级通用）\r\n- は/わ、を/お 识别误差\r\n- 句尾语气词、轻微拖音\r\n- 同一错误只扣一次\r\n- 同音词按假名判定\r\n- 转写存疑、不确定是否为错误 → **不扣分**\r\n\r\n---\r\n\r\n## 六、两轮校验机制\r\n\r\n- 第1轮、第2轮独立批改\r\n- 不一致 → 取高分 + 宽松判定（优先不判为错误）\r\n- 不确定 → 不判错\r\n\r\n---\r\n\r\n## 八、输出报告模板（统一格式）\r\n\r\n```\r\n学生姓名：{name}\r\n等级：{level}\r\n\r\n【评分结果】\r\n总分：{score}/10\r\n发音准确性：{p}/10\r\n语调与节奏：{i}/10\r\n流畅度：{f}/10\r\n\r\n【总体评价】\r\n{positive_comment}，{constructive_feedback}。{encouragement}\r\n\r\n【发音纠错】\r\n1. 原句：{original}\r\n   你的读法：{student_reading}\r\n   标准读法：{correct_reading}（{kana}）\r\n   错误类型：{error_type}\r\n\r\n【练习建议】\r\n1. {suggestion_1}\r\n2. {suggestion_2}\r\n```\r\n\r\n**排版规则：**\r\n- 一级大项单独另起一行\r\n- 禁用 ⚠ 等 emoji\r\n- 评语 ≤ 1000 字符\r\n- 先表扬后建议\r\n\r\n---\r\n\r\n## 九、双模式功能说明\r\n\r\n### 教师模式（批量批改）\r\n- 批量导入学生音频\r\n- 自动评分 + 纠错\r\n- 生成个人报告\r\n- 生成班级成绩汇总\r\n- 生成课堂讲评建议\r\n- 支持升档推荐名单\r\n\r\n### 学生模式（自测练习）\r\n- 即时打分\r\n- 精准纠错\r\n- 个性化练习建议\r\n- 自动记录薄弱点\r\n- 支持等级自适应（N5↔N4↔N3↔N2↔N1）\r\n\r\n---\r\n\r\n## 十、核心原则\r\n\r\n1. **鼓励为主**：从 10 分起评，据实扣分，不刻意压低\r\n2. **只纠严重错误**：只纠正影响语义的明显发音错误\r\n3. **同一错误只扣一次**：不重复扣分\r\n4. **不确定时不判错**：转写存疑优先不判错\r\n5. **保护信心**：总分不低于 6 分，评语先表扬后建议\r\n\r\n---\r\n\r\n## 十一、支持场景\r\n\r\n- 课文朗读作业打分\r\n- 日语发音测试\r\n- 课堂小测批改\r\n- 学生自主练习\r\n- 单元复习测评\r\n- 日语口语作业验收\r\n```\r\n\r\n---\n\nFile v2.1.5:_meta.json\n\n{\n  \"ownerId\": \"kn7cw3j55n4hxe9ze445qp81ks86150x\",\n  \"slug\": \"japanese-reading-grader\",\n  \"version\": \"2.1.5\",\n  \"publishedAt\": 1779371220088\n}\n\nFile v2.1.5:skill-card.md\n\n## Description: <br>\nGrades Japanese reading-aloud assignments in teacher batch mode or student self-test mode, with transcription, N5-N1 scoring, pronunciation feedback, summaries, and practice recommendations. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[bianmaxingkong](https://clawhub.ai/user/bianmaxingkong) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nTeachers use this skill to grade batches of Japanese reading recordings, produce individual reports, and summarize class results. Japanese learners use it for self-testing, pronunciation corrections, weak-point analysis, and adaptive practice suggestions across JLPT N5-N1 levels. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Student recordings, transcripts, names, or IDs may contain personal data. <br>\nMitigation: Confirm the school or class is allowed to process the recordings, minimize identifiers, restrict access to generated artifacts, and delete audio, transcript, and report files when no longer needed. <br>\nRisk: Speech transcription uncertainty can lead to incorrect grading or feedback. <br>\nMitigation: Prefer local transcription where possible, flag uncertain transcriptions for human review, and avoid deducting points when the evidence is unclear. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/bianmaxingkong/japanese-reading-grader) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Text, Markdown, Shell commands, Guidance] <br>\n**Output Format:** [Markdown-style grading reports, class summaries, practice suggestions, and optional ffmpeg/Whisper command examples] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May process student audio, transcripts, names, or IDs; report comments are limited to 1000 characters by the skill template.] <br>\n\n## Skill Version(s): <br>\n2.1.5 (source: server release metadata) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v2.1.4: 2 files, 2667 bytes\n\nFiles: SKILL.md (4599b), _meta.json (142b)\n\nFile v2.1.4:SKILL.md\n\n# 日语朗读作业批改技能\r\n---\r\nname: japanese-reading-grading\r\ndescription: \"日语朗读作业批改（双模式）。支持教师批量批改+学生自测打分，自动转写、N5-N3分层评分、发音纠错、成绩汇总、自适应升降级。兼容本地/Canvas环境，鼓励式评分，保证优秀率。\"\r\n---\r\n\r\n# 日语朗读作业批改（双模式通用版）\r\n支持：**教师批改模式** / **学生自测模式**\r\n适用：N5/N4/N3 日语学习者 | 音频格式：MP3/MP4/M4A/WAV\r\n\r\n---\r\n\r\n## 一、工作总流程\r\nStep 1 → 加载标准文本 / 标准音频\r\nStep 2 → 音频预处理 + Whisper medium 转写\r\nStep 3 → 分层评分 + 鼓励式纠错\r\nStep 4 → 生成个人评分报告\r\nStep 5 → 教师模式：生成班级汇总\r\nStep 6 → 学生模式：生成个性化练习建议\r\n\r\n---\r\n\r\n## 二、模式自动识别\r\n- **教师模式**：输入=标准文本/音频 + 多名学生音频 + 姓名/学号\r\n- **学生模式**：输入=个人音频 + 标准文本/音频 + 自选等级\r\n\r\n---\r\n\r\n# 三、音频处理流程（统一标准）\r\n## Step 1：音频格式统一\r\n- 转换为 WAV 格式\r\n- 采样率 16000Hz、单声道\r\n- 异常音频自动标记，不打低分\r\n\r\n## Step 2：Whisper 语音转写（固定配置）\r\n```bash\r\nffmpeg -y -i input.mp4 -vn -acodec pcm_s16le -ar 16000 -ac 1 audio.wav\r\nwhisper audio.wav --model medium --language ja --output_format txt\r\n```\r\n- 仅做转写，不做发音打分依据\r\n- 转写存疑 → 标记人工复核，不扣分\r\n\r\n---\r\n\r\n# 四、评分规则（完全对齐 workflow · 鼓励版）\r\n\r\n## 4.1 基础分与总分规则\r\n- 基础分：7.0 分\r\n- 加分上限：+1.5 分\r\n- 扣分上限：-2.0 分\r\n- 总分范围：5.0 ~ 10.0 分\r\n- 计分公式：\r\n```\r\n总分 = 7.0 + 加分项累加 - 扣分项累加\r\n```\r\n\r\n## 4.2 评分维度与权重\r\n| 维度 | 权重 |\r\n|------|------|\r\n| 发音准确性 | 35% |\r\n| 语调与节奏 | 30% |\r\n| 流畅度 | 35% |\r\n\r\n## 4.3 水平分层扣分系数\r\n| 错误类型 | N5 | N4 | N3 |\r\n|------|----|----|----|\r\n| 促音错误 | 0.2 | 0.3 | 0.4 |\r\n| 长音错误 | 0.2 | 0.3 | 0.4 |\r\n| 清浊混淆 | 0.15 | 0.2 | 0.3 |\r\n| 拨音错误 | 0.15 | 0.2 | 0.3 |\r\n| 语调错误 | 0.1 | 0.15 | 0.2 |\r\n| 声调错误 | 0.1 | 0.15 | 0.25 |\r\n| 漏读/跳读 | 0.3 | 0.4 | 0.6 |\r\n| 多读/替换 | 0.3 | 0.4 | 0.6 |\r\n\r\n## 4.4 鼓励加分项（最高 +1.5）\r\n| 加分项 | 分值 |\r\n|------|------|\r\n| 完成全文无中断 | +0.5 |\r\n| 对话切换自然 | +0.3 |\r\n| 语速适中 | +0.2 |\r\n| 无明显发音错误 | +0.3 |\r\n| 语气自然 | +0.2 |\r\n\r\n## 4.5 等级划分\r\n- 优秀：8.0 ~ 10.0\r\n- 良好：7.0 ~ 7.9\r\n- 中等：6.0 ~ 6.9\r\n- 待加强：＜6.0\r\n\r\n## 4.6 强制优秀率（教师模式）\r\n- 班级优秀率 ≥50%\r\n- 7.5~7.9 分 → 统一上调至 8.0\r\n- 无重大错误可酌情升档\r\n- 总分不超过 10.0\r\n\r\n---\r\n\r\n# 五、纠错规则（鼓励导向）\r\n## 5.1 纠错上限（按水平+篇幅）\r\n- N5：短篇2项 / 长篇3项\r\n- N4：短篇3项 / 长篇4项\r\n- N3：短篇4项 / 长篇5项\r\n\r\n## 5.2 不扣分项目\r\n- は/わ、を/お 识别误差\r\n- 句尾语气词、轻微拖音\r\n- N5/N4 声调轻微偏差\r\n- 同一错误只扣一次\r\n- 同音词按假名判定\r\n\r\n## 5.3 两轮校验机制\r\n- 第1轮、第2轮独立批改\r\n- 不一致 → 取高分 + 宽松判定\r\n- 不确定 → 不判错\r\n\r\n---\r\n\r\n# 六、双模式功能说明\r\n\r\n## 教师模式（批量批改）\r\n- 批量导入学生音频\r\n- 自动评分 + 纠错\r\n- 生成个人报告\r\n- 生成班级成绩汇总\r\n- 生成课堂讲评建议\r\n- 支持升档推荐名单\r\n\r\n## 学生模式（自测练习）\r\n- 即时打分\r\n- 精准纠错\r\n- 个性化练习建议\r\n- 自动记录薄弱点\r\n- 支持等级自适应（N5↔N4↔N3）\r\n\r\n---\r\n\r\n# 七、输出报告模板（统一格式）\r\n```\r\n学生姓名：{name}\r\n等级：{level}\r\n\r\n【评分结果】\r\n总分：{score}/10\r\n发音准确性：{p}/10\r\n语调与节奏：{i}/10\r\n流畅度：{f}/10\r\n\r\n【总体评价】\r\n{评价}\r\n\r\n【发音纠错】\r\n1. 原句：{x}\r\n   你的读法：{y}\r\n   标准读法：{z}\r\n   错误类型：{t}\r\n\r\n【练习建议】\r\n1. {s1}\r\n2. {s2}\r\n```\r\n\r\n---\r\n\r\n# 八、核心原则\r\n1. 鼓励为主：7分起步，不从10分扣\r\n2. 只纠正影响语义的严重错误\r\n3. 同一错误不重复扣分\r\n4. 转写存疑 → 不扣分\r\n5. 总分不低于5分，保护信心\r\n6. 教师模式确保≥50%优秀率\r\n\r\n---\r\n\r\n# 九、支持场景\r\n- 课文朗读作业打分\r\n- 日语发音测试\r\n- 课堂小测批改\r\n- 学生自主练习\r\n- 单元复习测评\r\n- 日语口语作业验收\r\n```\r\n\r\n---\n\nFile v2.1.4:_meta.json\n\n{\n  \"ownerId\": \"kn7cw3j55n4hxe9ze445qp81ks86150x\",\n  \"slug\": \"japanese-reading-grader\",\n  \"version\": \"2.1.4\",\n  \"publishedAt\": 1779286229137\n}\n\nArchive v2.1.3: 2 files, 5841 bytes\n\nFiles: SKILL.md (12313b), _meta.json (142b)\n\nFile v2.1.3:SKILL.md\n\n# 技能名称：日语朗读作业批改（教师/学生双模式）\r\n## 基本信息\r\n- 技能ID：japanese-reading-grader\r\n- 版本：2.1.3\r\n- 适用场景：\r\n  1. 课文朗读作业批改\r\n  2. 句子朗读作业批改\r\n  3. 替换练习操练\r\n  4. 教师批量批改 / 学生自主自测\r\n  5. 学生历史成绩追踪与能力分层\r\n  6. 学生自适应学习\r\n- 目标用户：高校日语教师、日语学习者\r\n\r\n## 运行说明\r\n本技能使用 Whisper medium 模型进行本地语音转写。\r\n固定使用 medium 模型，不切换大小，适配笔记本电脑，避免爆显存、卡顿或崩溃。\r\n本技能支持课文朗读、句子朗读、单词朗读、替换练习四种发音作业，自动适配教师批改与学生自测双模式。\r\n\r\n## 支持练习类型（自动识别）\r\n- 课文朗读：长篇课文完整朗读\r\n- 句子朗读：句型例句朗读\r\n- 替换练习：按要求替换词汇后朗读句子\r\n\r\n## 学生水平分层（N5～N1）\r\n### 等级定义\r\n| 等级 | 能力描述 | 适用场景 |\r\n|------|----------|----------|\r\n| N5 | 掌握基础短句，完成最简单日常表达 \r\n| N4 | 能读懂简短便条、简易课文，日常口语，进行基础生活化简单交流\r\n| N3 | 读懂日常邮件、短篇叙事文章，听懂正常语速日常对话 \r\n| N2 |能够读懂评论性文章、复杂长难句式，听懂标准语速新闻内容\r\n| N1 | 无障碍研读各类长篇文本、专业类文章，熟练应对全场景正式与非正式交流\r\n\r\n### 各层级评分差异\r\n| 等级 | 发音容忍度 | 语调要求 | 流畅度要求 | 纠错粒度 |\r\n|------|-----------|----------|-----------|----------|\r\n| N5 | 宽松（清浊/长音小错不扣分） | 基本升降调即可 | 允许较多卡顿 | 只纠致命错误 |\r\n| N4 | 中等（明显错误扣分） | 句尾调基本正确 | 允许少量停顿 | 纠主要错误 |\r\n| N3 | 较严（促音/长音严格） | 句中升降调关注 | 较流畅 | 纠大部分错误 |\r\n| N2 | 严格（接近母语标准） | 自然语调 | 无明显停顿 | 纠所有错误 |\r\n| N1 | 极严（细微差别也扣分） | 情感/强调语调 | 完全自然 | 精细纠错 |\r\n\r\n### 层级扣分系数\r\n| 错误类型 | N5 | N4 | N3 | N2 | N1 |\r\n|----------|----|----|----|----|----|\r\n| 促音错误 | 0.3 | 0.5 | 0.7 | 0.9 | 1.0 |\r\n| 长音错误 | 0.3 | 0.5 | 0.7 | 1.0 | 1.0 |\r\n| 清浊混淆 | 0.2 | 0.3 | 0.5 | 0.7 | 0.9 |\r\n| 拨音错误 | 0.2 | 0.3 | 0.5 | 0.9 | 1.0 |\r\n| 语调错误 | 0.1 | 0.2 | 0.3 | 0.5 | 0.7 |\r\n| 声调错误 | 0.1 | 0.2 | 0.4 | 0.6 | 0.8 |\r\n\r\n## 纠错数量限制（按水平分层）\r\n初学者工作记忆容量有限，情感过滤较强，过多反馈会打击信心、阻碍吸收。\r\n\r\n| 学生水平 | 最多纠错项数 | 说明 |\r\n|----------|-------------|------|\r\n| N5~N4 | 2项 | 只纠正最严重的2个错误，保护学习信心 |\r\n| N3 | 3项 | 较全面纠错，学生已有一定吸收能力 |\r\n| N2 | 4项 | 接近全面纠错，能接受较多反馈 |\r\n| N1 | 不限 | 所有错误全部指出，追求精益求精 |\r\n\r\n### 纠错优先级\r\n当错误数量超过上限时，按以下优先级筛选：\r\n1. 影响语义的错误（清浊、长音、促音）\r\n2. 反复出现的高频错误\r\n3. 语调错误\r\n\r\n---\r\n\r\n# 学生自适应学习系统\r\n## 核心逻辑\r\n系统根据学生发音错误、流畅度、成绩趋势，自动判断薄弱点、动态调整难度，并推荐最适合的练习内容。\r\n\r\n## 自适应判断维度\r\n1. 发音错误类型（促音/长音/清浊/拨音）\r\n2. 错误频率与集中度\r\n3. 流畅度稳定性\r\n4. 水平进步速度\r\n\r\n## 自适应练习推荐\r\n| 主要错误类型 | 系统自动推荐练习 |\r\n|--------------|------------------|\r\n| 促音错误多 | 促音专项单词、句型朗读 |\r\n| 长音错误多 | 长音专项单词、句子朗读 |\r\n| 清浊混淆多 | 清浊对立词对比朗读纠音 |\r\n| 拨音错误多 | 拨音单词、句型练习 |\r\n| 语调错误多 | 句型例句语调训练 |\r\n| 流畅度偏低 | 慢速短句 → 逐步提升语速 |\r\n\r\n## 自适应升降级规则\r\n### 自动升档\r\n- 最近3次成绩 ≥ 7.5\r\n- 无严重发音错误\r\n- 流畅度稳定提升\r\n→ 自动建议升级\r\n\r\n### 自动降档\r\n- 最近2次成绩 < 6.0\r\n- 基础性错误频繁\r\n→ 自动建议降级巩固\r\n\r\n### 维持当前等级\r\n- 有进步但未达标\r\n→ 继续当前水平，强化薄弱点\r\n\r\n## 学生档案（可选功能）\r\n适用于教师长期追踪学生进步的场景，非必选。默认关闭。\r\n\r\n### 开启方式\r\n```json\r\n{\r\n  \"enable_student_profile\": true\r\n}\r\n```\r\n\r\n### 档案功能\r\n- 自动创建/更新学生档案\r\n- 记录历次成绩和错误类型\r\n- 自适应判断升档/降档\r\n- 生成个性化练习建议\r\n\r\n### 升档判断逻辑\r\n```python\r\ndef check_level_upgrade(profile):\r\n    history = profile[\"submission_history\"][-5:]\r\n    if len(history) >= 3:\r\n        recent_3 = history[-3:]\r\n        all_high_score = all(s[\"score\"] >= 7.5 for s in recent_3)\r\n        no_major_error = all(len(s[\"weak_points\"]) <= 2 for s in recent_3)\r\n        \r\n        if all_high_score and no_major_error:\r\n            return {\r\n                \"should_upgrade\": True,\r\n                \"from_level\": profile[\"current_level\"],\r\n                \"to_level\": next_level(profile[\"current_level\"]),\r\n                \"confidence\": \"高\",\r\n                \"suggestion\": f\"建议{profile['student_name']}尝试{next_level(profile['current_level'])}水平练习\"\r\n            }\r\n    return {\"should_upgrade\": False}\r\n```\r\n\r\n## 双模式使用规则\r\n### 教师批改模式\r\n上传：音频 + 课文/题目图片（或标准文本）+ 学生姓名 + 学生水平\r\n输出：完整评分报告 + 发音纠错 + 班级汇总 + 自适应学习建议\r\n\r\n### 学生自测模式\r\n上传：仅音频 + 自选水平\r\n输出：个人评分 + 发音纠错 + 练习建议 + 水平评估 + 自适应推荐\r\n无需图片、无需姓名\r\n\r\n## 触发条件\r\n自动识别：\r\n- 音频 + 图片（或文本）+ 姓名 → 教师批改模式\r\n- 仅音频 → 学生自测模式\r\n\r\n## 输入参数\r\n| 参数名 | 类型 | 必填 | 说明 |\r\n|--------|------|------|----------|\r\n| audio | 文件 | 是 | 单词/句子/课文/替换练习音频 |\r\n| image | 文件 | 否 | 原文图片（教师模式推荐） |\r\n| standard_text | 字符串 | 否 | 标准文本（优于图片OCR） |\r\n| student_name | 字符串 | 否 | 学生姓名（教师模式必填） |\r\n| student_level | 字符串 | 否 | N5/N4/N3/N2/N1（默认N5） |\r\n| class_id | 字符串 | 否 | 班级编号 |\r\n\r\n## 评分规则（统一10分制）\r\n| 评分维度 | 权重 | 评分标准（宽松鼓励向） |\r\n|--------|------|------------------------|\r\n| 发音准确性 | 40% | 核查假名、清浊音、长音、促音、拨音正误；同音异义汉字只要读音一致不判错。大部分假名正确即可拿到本项70%以上分数，仅出现连续5个以上假名读错等重大错误时才明显扣分。 |\r\n| 语调与节奏 | 30% | 句尾升降调基本合规即可：疑问句能听出轻微上扬就达标，不要求完美语调；避免全程平板平直朗读，有基本起伏即给基础分。标点停顿时长轻微不合理不扣分；AI无法精准判别细微语调时一律不扣分。 |\r\n| 流畅度 | 30% | 朗读整体基本连贯，允许1–2处轻微卡顿、重复，不严重影响理解即可给到及格以上分数。漏词、漏句、跳行每处扣3分，扣分不累积扣至本项0分以下。 |\r\n\r\n### 最终总分档位\r\n| 最终得分 | 评价 |\r\n|----------|------|\r\n| 8.0–10.0 | 优秀 |\r\n| 7.0–7.9 | 良好 |\r\n| 6.0–6.9 | 中等 |\r\n| 6.0以下 | 待加强 |\r\n\r\n## 替换练习特殊规则\r\n- 教师需提供句型框架 + 允许替换词列表\r\n- 系统只检查句型结构 + 替换词合法性 + 发音正确性\r\n- 不将“替换词与原文不一致”视为错误\r\n\r\n## 输出模板\r\n### 个人报告模板\r\n```\r\n学生姓名：{name}\r\n  本次表现：{level_performance}\r\n进步趋势：{trend}\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n【评分结果】\r\n一、总分：{score}/10\r\n\r\n二、各维度评分\r\n发音准确性：{pronunciation}/10\r\n语调与节奏：{intonation}/10\r\n流畅度：{fluency}/10\r\n\r\n三、总体评价\r\n{positive_comment}，{constructive_feedback}。{encouragement}\r\n\r\n四、发音纠错（不宜太长，单词或词组）\r\n1. 原句：{original}\r\n   学生读法：{student_reading}\r\n   标准读法：{correct_reading}（{kana}）\r\n   错误类型：{error_type}\r\n\r\n五、练习建议\r\n- {suggestion_1}\r\n- {suggestion_2}\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n【AI 自适应学习建议】\r\n本次薄弱点：{weak_points}\r\n推荐练习：{adaptive_exercise}\r\n下次建议难度：{next_level}\r\n推荐练习类型：{recommended_type}\r\n```\r\n\r\n### 班级汇总表模板\r\n【全班成绩汇总】\r\n| 姓名 | 当前水平 | 本次得分 | 本次表现 | 进步趋势 | 升档建议 |\r\n|------|----------|----------|----------|----------|----------|\r\n| {name} | {level} | {score} | {performance} | {trend} | {advice} |\r\n\r\n【班级分层统计】\r\n| 水平层级 | 人数 | 平均分 | 优秀率 | 良好率 | 待加强率 |\r\n|----------|------|--------|--------|--------|----------|\r\n| N5 | {n5_count} | {n5_avg} | {n5_excellent} | {n5_good} | {n5_weak} |\r\n| N4 | {n4_count} | {n4_avg} | {n4_excellent} | {n4_good} | {n4_weak} |\r\n| N3 | {n3_count} | {n3_avg} | {n3_excellent} | {n3_good} | {n3_weak} |\r\n| N2 | {n2_count} | {n2_avg} | {n2_excellent} | {n2_good} | {n2_weak} |\r\n| N1 | {n1_count} | {n1_avg} | {n1_excellent} | {n1_good} | {n1_weak} |\r\n\r\n## 工作流程\r\n步骤1：接收输入\r\n步骤2：判断使用模式\r\n步骤3：自动识别练习类型\r\n步骤4：获取或创建学生档案\r\n步骤5：获取标准文本\r\n步骤6：音频转文字\r\n步骤7：逐句比对与评分\r\n步骤8：计算总分\r\n步骤9：生成纠错列表\r\n步骤10：自适应分析\r\n步骤11：更新学生档案\r\n步骤12：生成输出文件\r\n\r\n## 评测规范\r\n评测原则:\r\n- 鼓励为主，评分适度放宽\r\n- 根据学生水平动态调整扣分力度\r\n- 只纠正影响语义的明显发音错误\r\n- 微小识别误差不予扣分\r\n- Whisper转写结果仅供参考\r\n- 纠错数量按水平分层限制\r\n\r\n反馈要求:\r\n- 说明语言：中文\r\n- 纠错粒度：单词级或短语级\r\n- 必须标注：原句、学生读法、标准读法、错误类型\r\n- 文件编码：UTF-8\r\n\r\n# 发音错误判定规则\r\n## 一、错误类型（扣分）\r\n- 促音：っ 漏读/多读/错位置\r\n- 长音：あいうえお长音漏读/缩短\r\n- 清浊：か/が、ひ/び、は/ぱ 读混\r\n- 拨音：ん 漏读/多读\r\n- 语调：句调、单词高低音错误\r\n- 漏读/多读/替换：假名与原文不一致\r\n\r\n## 二、同音词不判错规则\r\n以**假名读音**为唯一判定依据，汉字不同但读音相同不扣分。\r\n例：選択/洗濯（せんたく）、科学/化学（かがく）、試験/試練（しけん）、人口/人工（じんこう）。\r\n只有假名读错（如 また→まだ）才扣分。\r\n\r\n## 三、补充说明\r\n同一错误多次出现，按1处错误扣分，不重复计罚。\r\n\r\n## 输出文件清单\r\n| 文件名 | 格式 | 说明 |\r\n|--------|------|------|\r\n| {学生姓名}_评分报告.txt | UTF-8文本 | 个人评分报告 + 自适应建议 |\r\n| 班级{班级号}_成绩汇总表.xlsx | Excel | 全班成绩 + 分层统计 |\r\n| 班级{班级号}_分层学情分析.txt | UTF-8文本 | 各层级表现分析 |\r\n| 班级{班级号}_升档推荐名单.txt | UTF-8文本 | 建议升档学生 |\r\n| 班级{班级号}_课堂讲评建议.txt | UTF-8文本 | 分层教学建议 |\r\n\r\n ## 输出排版规则\r\n- 评分结果、总体评价、发音纠错、练习建议等所有一级反馈大项，必须单独另起一行\r\n- 发音纠错内部用 1、2 数字序号\r\n- 练习建议用 1、2 数字序号\r\n- 默认学生水平为N5~N4，纠错上限为2 项（影响语义优先）\r\n- 不显示等级标注和纠错等级说明\r\n- 禁用 ⚠ 等emoji\r\n\r\n## 配置文件示例\r\n```json\r\n{\r\n  \"enable_student_profile\": false,\r\n  \"whisper_model\": \"medium\",\r\n  \"output_encoding\": \"UTF-8\"\r\n}\r\n```\n\nFile v2.1.3:_meta.json\n\n{\n  \"ownerId\": \"kn7cw3j55n4hxe9ze445qp81ks86150x\",\n  \"slug\": \"japanese-reading-grader\",\n  \"version\": \"2.1.3\",\n  \"publishedAt\": 1779111289247\n}\n\nArchive v2.1.2: 2 files, 5642 bytes\n\nFiles: SKILL.md (12011b), _meta.json (142b)\n\nFile v2.1.2:SKILL.md\n\n# 技能名称：日语朗读作业批改（教师/学生双模式）\r\n## 基本信息\r\n- 技能ID：japanese-reading-grader\r\n- 版本：2.1.2\r\n- 适用场景：\r\n  1. 课文朗读作业批改\r\n  2. 句子朗读作业批改\r\n  3. 单词朗读作业批改\r\n  4. 替换练习操练\r\n  5. 教师批量批改 / 学生自主自测\r\n  6. 学生历史成绩追踪与能力分层\r\n  7. 学生自适应学习\r\n- 目标用户：高校日语教师、日语学习者\r\n\r\n## 运行说明\r\n本技能使用 Whisper medium 模型进行本地语音转写。\r\n固定使用 medium 模型，不切换大小，适配笔记本电脑，避免爆显存、卡顿或崩溃。\r\n本技能支持课文朗读、句子朗读、单词朗读、替换练习四种发音作业，自动适配教师批改与学生自测双模式。\r\n\r\n## 支持练习类型（自动识别）\r\n- 单词朗读：单个或多个单词朗读\r\n- 句子朗读：句型例句朗读\r\n- 课文朗读：长篇课文完整朗读\r\n- 替换练习：按要求替换词汇后朗读句子\r\n\r\n## 学生水平分层（N5～N1）\r\n### 等级定义\r\n| 等级 | 能力描述 | 适用场景 |\r\n|------|----------|----------|\r\n| N5 | 入门级，能读假名和简单单词 | 初级教材第1-10课 |\r\n| N4 | 基础级，能读短句和简单课文 | 初级教材第11-20课 |\r\n| N3 | 进阶级，能读中长句和日常对话 | 中级教材前半 |\r\n| N2 | 准高级，能读复杂句和短文 | 中级教材后半 |\r\n| N1 | 高级，能读长文和自然语速 | 高级教材/新闻 |\r\n\r\n### 各层级评分差异\r\n| 等级 | 发音容忍度 | 语调要求 | 流畅度要求 | 纠错粒度 |\r\n|------|-----------|----------|-----------|----------|\r\n| N5 | 宽松（清浊/长音小错不扣分） | 基本升降调即可 | 允许较多卡顿 | 只纠致命错误 |\r\n| N4 | 中等（明显错误扣分） | 句尾调基本正确 | 允许少量停顿 | 纠主要错误 |\r\n| N3 | 较严（促音/长音严格） | 句中升降调关注 | 较流畅 | 纠大部分错误 |\r\n| N2 | 严格（接近母语标准） | 自然语调 | 无明显停顿 | 纠所有错误 |\r\n| N1 | 极严（细微差别也扣分） | 情感/强调语调 | 完全自然 | 精细纠错 |\r\n\r\n### 层级扣分系数\r\n| 错误类型 | N5 | N4 | N3 | N2 | N1 |\r\n|----------|----|----|----|----|----|\r\n| 促音错误 | 0.3 | 0.5 | 0.7 | 0.9 | 1.0 |\r\n| 长音错误 | 0.3 | 0.5 | 0.7 | 1.0 | 1.0 |\r\n| 清浊混淆 | 0.2 | 0.3 | 0.5 | 0.7 | 0.9 |\r\n| 拨音错误 | 0.2 | 0.3 | 0.5 | 0.9 | 1.0 |\r\n| 语调错误 | 0.1 | 0.2 | 0.3 | 0.5 | 0.7 |\r\n| 声调错误 | 0.1 | 0.2 | 0.4 | 0.6 | 0.8 |\r\n\r\n## 纠错数量限制（按水平分层）\r\n初学者工作记忆容量有限，情感过滤较强，过多反馈会打击信心、阻碍吸收。\r\n\r\n| 学生水平 | 最多纠错项数 | 说明 |\r\n|----------|-------------|------|\r\n| N5~N4 | 2项 | 只纠正最严重的2个错误，保护学习信心 |\r\n| N3 | 3项 | 较全面纠错，学生已有一定吸收能力 |\r\n| N2 | 4项 | 接近全面纠错，能接受较多反馈 |\r\n| N1 | 不限 | 所有错误全部指出，追求精益求精 |\r\n\r\n### 纠错优先级\r\n当错误数量超过上限时，按以下优先级筛选：\r\n1. 影响语义的错误（清浊、长音、促音）\r\n2. 反复出现的高频错误\r\n3. 语调错误\r\n\r\n---\r\n\r\n# 学生自适应学习系统\r\n## 核心逻辑\r\n系统根据学生发音错误、流畅度、成绩趋势，自动判断薄弱点、动态调整难度，并推荐最适合的练习内容。\r\n\r\n## 自适应判断维度\r\n1. 发音错误类型（促音/长音/清浊/拨音）\r\n2. 错误频率与集中度\r\n3. 流畅度稳定性\r\n4. 水平进步速度\r\n\r\n## 自适应练习推荐\r\n| 主要错误类型 | 系统自动推荐练习 |\r\n|--------------|------------------|\r\n| 促音错误多 | 促音专项单词、句型朗读 |\r\n| 长音错误多 | 长音专项单词、句子朗读 |\r\n| 清浊混淆多 | 清浊对立词对比朗读纠音 |\r\n| 拨音错误多 | 拨音单词、句型练习 |\r\n| 语调错误多 | 句型例句语调训练 |\r\n| 流畅度偏低 | 慢速短句 → 逐步提升语速 |\r\n\r\n## 自适应升降级规则\r\n### 自动升档\r\n- 最近3次成绩 ≥ 7.5\r\n- 无严重发音错误\r\n- 流畅度稳定提升\r\n→ 自动建议升级\r\n\r\n### 自动降档\r\n- 最近2次成绩 < 6.0\r\n- 基础性错误频繁\r\n→ 自动建议降级巩固\r\n\r\n### 维持当前等级\r\n- 有进步但未达标\r\n→ 继续当前水平，强化薄弱点\r\n\r\n## 学生档案（可选功能）\r\n适用于教师长期追踪学生进步的场景，非必选。默认关闭。\r\n\r\n### 开启方式\r\n```json\r\n{\r\n  \"enable_student_profile\": true\r\n}\r\n```\r\n\r\n### 档案功能\r\n- 自动创建/更新学生档案\r\n- 记录历次成绩和错误类型\r\n- 自适应判断升档/降档\r\n- 生成个性化练习建议\r\n\r\n### 升档判断逻辑\r\n```python\r\ndef check_level_upgrade(profile):\r\n    history = profile[\"submission_history\"][-5:]\r\n    if len(history) >= 3:\r\n        recent_3 = history[-3:]\r\n        all_high_score = all(s[\"score\"] >= 7.5 for s in recent_3)\r\n        no_major_error = all(len(s[\"weak_points\"]) <= 2 for s in recent_3)\r\n        \r\n        if all_high_score and no_major_error:\r\n            return {\r\n                \"should_upgrade\": True,\r\n                \"from_level\": profile[\"current_level\"],\r\n                \"to_level\": next_level(profile[\"current_level\"]),\r\n                \"confidence\": \"高\",\r\n                \"suggestion\": f\"建议{profile['student_name']}尝试{next_level(profile['current_level'])}水平练习\"\r\n            }\r\n    return {\"should_upgrade\": False}\r\n```\r\n\r\n## 双模式使用规则\r\n### 教师批改模式\r\n上传：音频 + 课文/题目图片（或标准文本）+ 学生姓名 + 学生水平\r\n输出：完整评分报告 + 发音纠错 + 班级汇总 + 自适应学习建议\r\n\r\n### 学生自测模式\r\n上传：仅音频 + 自选水平\r\n输出：个人评分 + 发音纠错 + 练习建议 + 水平评估 + 自适应推荐\r\n无需图片、无需姓名\r\n\r\n## 触发条件\r\n自动识别：\r\n- 音频 + 图片（或文本）+ 姓名 → 教师批改模式\r\n- 仅音频 → 学生自测模式\r\n\r\n## 输入参数\r\n| 参数名 | 类型 | 必填 | 说明 |\r\n|--------|------|------|----------|\r\n| audio | 文件 | 是 | 单词/句子/课文/替换练习音频 |\r\n| image | 文件 | 否 | 原文图片（教师模式推荐） |\r\n| standard_text | 字符串 | 否 | 标准文本（优于图片OCR） |\r\n| student_name | 字符串 | 否 | 学生姓名（教师模式必填） |\r\n| student_level | 字符串 | 否 | N5/N4/N3/N2/N1（默认N5） |\r\n| class_id | 字符串 | 否 | 班级编号 |\r\n\r\n## 评分规则（统一10分制）\r\n| 评分维度 | 权重 | 评分标准（宽松鼓励向） |\r\n|--------|------|------------------------|\r\n| 发音准确性 | 40% | 核查假名、清浊音、长音、促音、拨音正误；同音异义汉字只要读音一致不判错。大部分假名正确即可拿到本项70%以上分数，仅出现连续5个以上假名读错等重大错误时才明显扣分。 |\r\n| 语调与节奏 | 30% | 句尾升降调基本合规即可：疑问句能听出轻微上扬就达标，不要求完美语调；避免全程平板平直朗读，有基本起伏即给基础分。标点停顿时长轻微不合理不扣分；AI无法精准判别细微语调时一律不扣分。 |\r\n| 流畅度 | 30% | 朗读整体基本连贯，允许1–2处轻微卡顿、重复，不严重影响理解即可给到及格以上分数。漏词、漏句、跳行每处扣3分，扣分不累积扣至本项0分以下。 |\r\n\r\n### 最终总分档位\r\n| 最终得分 | 评价 |\r\n|----------|------|\r\n| 8.0–10.0 | 优秀 |\r\n| 7.0–7.9 | 良好 |\r\n| 6.0–6.9 | 中等 |\r\n| 6.0以下 | 待加强 |\r\n\r\n## 替换练习特殊规则\r\n- 教师需提供句型框架 + 允许替换词列表\r\n- 系统只检查句型结构 + 替换词合法性 + 发音正确性\r\n- 不将“替换词与原文不一致”视为错误\r\n\r\n## 输出模板\r\n### 个人报告模板\r\n```\r\n学生姓名：{name}\r\n当前水平：{current_level}\r\n本次表现：{level_performance}\r\n进步趋势：{trend}\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n【评分结果】\r\n一、总分：{score}/10\r\n\r\n二、各维度评分\r\n发音准确性：{pronunciation}/10\r\n语调与节奏：{intonation}/10\r\n流畅度：{fluency}/10\r\n\r\n三、总体评价\r\n{positive_comment}，{constructive_feedback}。{encouragement}\r\n\r\n四、发音纠错（最多{max_errors}项）\r\n1. 原句：{original}\r\n   学生读法：{student_reading}\r\n   标准读法：{correct_reading}（{kana}）\r\n   错误类型：{error_type}\r\n\r\n五、练习建议\r\n- {suggestion_1}\r\n- {suggestion_2}\r\n- 【升档建议】{promotion_advice}\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n【AI 自适应学习建议】\r\n本次薄弱点：{weak_points}\r\n推荐练习：{adaptive_exercise}\r\n下次建议难度：{next_level}\r\n推荐练习类型：{recommended_type}\r\n```\r\n\r\n### 班级汇总表模板\r\n【全班成绩汇总】\r\n| 姓名 | 当前水平 | 本次得分 | 本次表现 | 进步趋势 | 升档建议 |\r\n|------|----------|----------|----------|----------|----------|\r\n| {name} | {level} | {score} | {performance} | {trend} | {advice} |\r\n\r\n【班级分层统计】\r\n| 水平层级 | 人数 | 平均分 | 优秀率 | 良好率 | 待加强率 |\r\n|----------|------|--------|--------|--------|----------|\r\n| N5 | {n5_count} | {n5_avg} | {n5_excellent} | {n5_good} | {n5_weak} |\r\n| N4 | {n4_count} | {n4_avg} | {n4_excellent} | {n4_good} | {n4_weak} |\r\n| N3 | {n3_count} | {n3_avg} | {n3_excellent} | {n3_good} | {n3_weak} |\r\n| N2 | {n2_count} | {n2_avg} | {n2_excellent} | {n2_good} | {n2_weak} |\r\n| N1 | {n1_count} | {n1_avg} | {n1_excellent} | {n1_good} | {n1_weak} |\r\n\r\n## 工作流程\r\n步骤1：接收输入\r\n步骤2：判断使用模式\r\n步骤3：自动识别练习类型\r\n步骤4：获取或创建学生档案\r\n步骤5：获取标准文本\r\n步骤6：音频转文字\r\n步骤7：逐句比对与评分\r\n步骤8：计算总分\r\n步骤9：生成纠错列表\r\n步骤10：自适应分析\r\n步骤11：更新学生档案\r\n步骤12：生成输出文件\r\n\r\n## 评测规范\r\n评测原则:\r\n- 鼓励为主，评分适度放宽\r\n- 根据学生水平动态调整扣分力度\r\n- 只纠正影响语义的明显发音错误\r\n- 微小识别误差不予扣分\r\n- Whisper转写结果仅供参考\r\n- 纠错数量按水平分层限制\r\n\r\n反馈要求:\r\n- 说明语言：中文\r\n- 纠错粒度：单词级或短语级\r\n- 必须标注：原句、学生读法、标准读法、错误类型\r\n- 文件编码：UTF-8\r\n\r\n# 发音错误判定规则\r\n## 一、错误类型（扣分）\r\n- 促音：っ 漏读/多读/错位置\r\n- 长音：あいうえお长音漏读/缩短\r\n- 清浊：か/が、ひ/び、は/ぱ 读混\r\n- 拨音：ん 漏读/多读\r\n- 语调：句调、单词高低音错误\r\n- 漏读/多读/替换：假名与原文不一致\r\n\r\n## 二、同音词不判错规则\r\n以**假名读音**为唯一判定依据，汉字不同但读音相同不扣分。\r\n例：選択/洗濯（せんたく）、科学/化学（かがく）、試験/試練（しけん）、人口/人工（じんこう）。\r\n只有假名读错（如 また→まだ）才扣分。\r\n\r\n## 三、补充说明\r\n同一错误多次出现，按1处错误扣分，不重复计罚。\r\n\r\n## 输出文件清单\r\n| 文件名 | 格式 | 说明 |\r\n|--------|------|------|\r\n| {学生姓名}_评分报告.txt | UTF-8文本 | 个人评分报告 + 自适应建议 |\r\n| 班级{班级号}_成绩汇总表.xlsx | Excel | 全班成绩 + 分层统计 |\r\n| 班级{班级号}_分层学情分析.txt | UTF-8文本 | 各层级表现分析 |\r\n| 班级{班级号}_升档推荐名单.txt | UTF-8文本 | 建议升档学生 |\r\n| 班级{班级号}_课堂讲评建议.txt | UTF-8文本 | 分层教学建议 |\r\n\r\n## 配置文件示例\r\n```json\r\n{\r\n  \"enable_student_profile\": false,\r\n  \"whisper_model\": \"medium\",\r\n  \"output_encoding\": \"UTF-8\"\r\n}\r\n```\n\nFile v2.1.2:_meta.json\n\n{\n  \"ownerId\": \"kn7cw3j55n4hxe9ze445qp81ks86150x\",\n  \"slug\": \"japanese-reading-grader\",\n  \"version\": \"2.1.2\",\n  \"publishedAt\": 1779011271174\n}\n\nArchive v2.1.1: 2 files, 5081 bytes\n\nFiles: SKILL.md (11062b), _meta.json (142b)\n\nFile v2.1.1:SKILL.md\n\n# 技能名称：日语朗读作业批改（教师/学生双模式）\r\n\r\n## 基本信息\r\n- 技能ID：japanese-reading-grader\r\n- 版本：2.1.0\r\n- 适用场景：\r\n  1. 课文朗读作业批改\r\n  2. 句子朗读作业批改\r\n  3. 单词朗读作业批改\r\n  4. 替换练习操练\r\n  5. 教师批量批改 / 学生自主自测\r\n  6. 学生历史成绩追踪与能力分层\r\n  7. 学生自适应学习\r\n- 目标用户：高校日语教师、日语学习者\r\n\r\n## 运行说明\r\n本技能使用 Whisper medium 模型进行本地语音转写。\r\n固定使用 medium 模型，不切换大小，适配笔记本电脑，避免爆显存、卡顿或崩溃。\r\n本技能支持课文朗读、句子朗读、单词朗读、替换练习四种发音作业，自动适配教师批改与学生自测双模式。\r\n\r\n## 支持练习类型（自动识别）\r\n- 单词朗读：单个或多个单词朗读\r\n- 句子朗读：句型例句朗读\r\n- 课文朗读：长篇课文完整朗读\r\n- 替换练习：按要求替换词汇后朗读句子\r\n\r\n## 学生水平分层（N5～N1）\r\n\r\n### 等级定义\r\n| 等级 | 能力描述 | 适用场景 |\r\n|------|----------|----------|\r\n| N5 | 入门级，能读假名和简单单词 | 初级教材第1-10课 |\r\n| N4 | 基础级，能读短句和简单课文 | 初级教材第11-20课 |\r\n| N3 | 进阶级，能读中长句和日常对话 | 中级教材前半 |\r\n| N2 | 准高级，能读复杂句和短文 | 中级教材后半 |\r\n| N1 | 高级，能读长文和自然语速 | 高级教材/新闻 |\r\n\r\n### 各层级评分差异\r\n| 等级 | 发音容忍度 | 语调要求 | 流畅度要求 | 纠错粒度 |\r\n|------|-----------|----------|-----------|----------|\r\n| N5 | 宽松（清浊/长音小错不扣分） | 基本升降调即可 | 允许较多卡顿 | 只纠致命错误 |\r\n| N4 | 中等（明显错误扣分） | 句尾调基本正确 | 允许少量停顿 | 纠主要错误 |\r\n| N3 | 较严（促音/长音严格） | 句中升降调关注 | 较流畅 | 纠大部分错误 |\r\n| N2 | 严格（接近母语标准） | 自然语调 | 无明显停顿 | 纠所有错误 |\r\n| N1 | 极严（细微差别也扣分） | 情感/强调语调 | 完全自然 | 精细纠错 |\r\n\r\n### 层级扣分系数\r\n| 错误类型 | N5 | N4 | N3 | N2 | N1 |\r\n|----------|----|----|----|----|----|\r\n| 促音错误 | 0.3 | 0.5 | 0.7 | 0.9 | 1.0 |\r\n| 长音错误 | 0.3 | 0.5 | 0.7 | 1.0 | 1.0 |\r\n| 清浊混淆 | 0.2 | 0.3 | 0.5 | 0.7 | 0.9 |\r\n| 拨音错误 | 0.2 | 0.3 | 0.5 | 0.9 | 1.0 |\r\n| 语调错误 | 0.1 | 0.2 | 0.3 | 0.5 | 0.7 |\r\n| 声调错误 | 0.1 | 0.2 | 0.4 | 0.6 | 0.8 |\r\n\r\n## 纠错数量限制（按水平分层）\r\n初学者工作记忆容量有限，情感过滤较强，过多反馈会打击信心、阻碍吸收。\r\n\r\n| 学生水平 | 最多纠错项数 | 说明 |\r\n|----------|-------------|------|\r\n| N5 | 2项 | 只纠正最严重的2个错误，保护学习信心 |\r\n| N4 | 3项 | 纠正主要错误，兼顾鼓励与指导 |\r\n| N3 | 4项 | 较全面纠错，学生已有一定吸收能力 |\r\n| N2 | 5项 | 接近全面纠错，能接受较多反馈 |\r\n| N1 | 不限 | 所有错误全部指出，追求精益求精 |\r\n\r\n### 纠错优先级\r\n当错误数量超过上限时，按以下优先级筛选：\r\n1. 影响语义的错误（清浊、长音、促音）\r\n2. 反复出现的高频错误\r\n3. 语调错误\r\n\r\n---\r\n\r\n# 学生自适应学习系统\r\n\r\n## 核心逻辑\r\n系统根据学生发音错误、流畅度、成绩趋势，自动判断薄弱点、动态调整难度，并推荐最适合的练习内容。\r\n\r\n## 自适应判断维度\r\n1. 发音错误类型（促音/长音/清浊/拨音）\r\n2. 错误频率与集中度\r\n3. 流畅度稳定性\r\n4. 水平进步速度\r\n\r\n## 自适应练习推荐\r\n| 主要错误类型 | 系统自动推荐练习 |\r\n|--------------|------------------|\r\n| 促音错误多 | 促音专项单词、句型朗读 |\r\n| 长音错误多 | 长音专项单词、句子朗读 |\r\n| 清浊混淆多 | 清浊对立词对比朗读 |\r\n| 拨音错误多 | 拨音单词、句型练习 |\r\n| 语调错误多 | 句型例句语调训练 |\r\n| 流畅度偏低 | 慢速短句 → 逐步提升语速 |\r\n\r\n## 自适应升降级规则\r\n### 自动升档\r\n- 最近3次成绩 ≥ 7.5\r\n- 无严重发音错误\r\n- 流畅度稳定提升\r\n→ 自动建议升级\r\n\r\n### 自动降档\r\n- 最近2次成绩 < 6.0\r\n- 基础性错误频繁\r\n→ 自动建议降级巩固\r\n\r\n### 维持当前等级\r\n- 有进步但未达标\r\n→ 继续当前水平，强化薄弱点\r\n\r\n---\r\n\r\n## 学生档案（可选功能）\r\n适用于教师长期追踪学生进步的场景，非必选。默认关闭。\r\n\r\n### 开启方式\r\n```json\r\n{\r\n  \"enable_student_profile\": true\r\n}\r\n```\r\n\r\n### 档案功能\r\n- 自动创建/更新学生档案\r\n- 记录历次成绩和错误类型\r\n- 自适应判断升档/降档\r\n- 生成个性化练习建议\r\n\r\n### 升档判断逻辑\r\n```python\r\ndef check_level_upgrade(profile):\r\n    history = profile[\"submission_history\"][-5:]\r\n    if len(history) >= 3:\r\n        recent_3 = history[-3:]\r\n        all_high_score = all(s[\"score\"] >= 7.5 for s in recent_3)\r\n        no_major_error = all(len(s[\"weak_points\"]) <= 2 for s in recent_3)\r\n        \r\n        if all_high_score and no_major_error:\r\n            return {\r\n                \"should_upgrade\": True,\r\n                \"from_level\": profile[\"current_level\"],\r\n                \"to_level\": next_level(profile[\"current_level\"]),\r\n                \"confidence\": \"高\",\r\n                \"suggestion\": f\"建议{profile['student_name']}尝试{next_level(profile['current_level'])}水平练习\"\r\n            }\r\n    return {\"should_upgrade\": False}\r\n```\r\n\r\n## 双模式使用规则\r\n\r\n### 教师批改模式\r\n上传：音频 + 课文/题目图片（或标准文本）+ 学生姓名 + 学生水平\r\n输出：完整评分报告 + 发音纠错 + 班级汇总 + 自适应学习建议\r\n\r\n### 学生自测模式\r\n上传：仅音频 + 自选水平\r\n输出：个人评分 + 发音纠错 + 练习建议 + 水平评估 + 自适应推荐\r\n无需图片、无需姓名\r\n\r\n## 触发条件\r\n自动识别：\r\n- 音频 + 图片（或文本）+ 姓名 → 教师批改模式\r\n- 仅音频 → 学生自测模式\r\n\r\n## 输入参数\r\n| 参数名 | 类型 | 必填 | 说明 |\r\n|--------|------|------|----------|\r\n| audio | 文件 | 是 | 单词/句子/课文/替换练习音频 |\r\n| image | 文件 | 否 | 原文图片（教师模式推荐） |\r\n| standard_text | 字符串 | 否 | 标准文本（优于图片OCR） |\r\n| student_name | 字符串 | 否 | 学生姓名（教师模式必填） |\r\n| student_level | 字符串 | 否 | N5/N4/N3/N2/N1（默认N5） |\r\n| class_id | 字符串 | 否 | 班级编号 |\r\n\r\n## 评分规则（统一10分制）\r\n\r\n### 评分维度\r\n| 维度 | 权重 | 评分标准 |\r\n|------|------|----------|\r\n| 发音准确性 | 70% | 假名、清浊音、长音、促音、拨音 |\r\n| 语调与节奏 | 10% | 句尾语调、升降调、停顿、节奏 |\r\n| 流畅度 | 20% | 无卡顿、无重复、表达自然 |\r\n\r\n### 最终总分档位\r\n| 最终得分 | 评价 |\r\n|----------|------|\r\n| 8.0–10.0 | 优秀 |\r\n| 7.0–7.9 | 良好 |\r\n| 6.0–6.9 | 中等 |\r\n| 6.0以下 | 待加强 |\r\n\r\n## 替换练习特殊规则\r\n- 教师需提供句型框架 + 允许替换词列表\r\n- 系统只检查句型结构 + 替换词合法性 + 发音正确性\r\n- 不将“替换词与原文不一致”视为错误\r\n\r\n## 输出模板\r\n\r\n### 个人报告模板\r\n```\r\n学生姓名：{name}\r\n当前水平：{current_level}\r\n本次表现：{level_performance}\r\n进步趋势：{trend}\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n【评分结果】\r\n一、总分：{score}/10\r\n\r\n二、各维度评分\r\n发音准确性：{pronunciation}/10\r\n语调与节奏：{intonation}/10\r\n流畅度：{fluency}/10\r\n\r\n三、总体评价\r\n{positive_comment}，{constructive_feedback}。{encouragement}\r\n\r\n四、发音纠错（最多{max_errors}项）\r\n1. 原句：{original}\r\n   学生读法：{student_reading}\r\n   标准读法：{correct_reading}（{kana}）\r\n   错误类型：{error_type}\r\n\r\n五、练习建议\r\n- {suggestion_1}\r\n- {suggestion_2}\r\n- 【升档建议】{promotion_advice}\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n【AI 自适应学习建议】\r\n本次薄弱点：{weak_points}\r\n推荐练习：{adaptive_exercise}\r\n下次建议难度：{next_level}\r\n推荐练习类型：{recommended_type}\r\n```\r\n\r\n### 班级汇总表模板\r\n【全班成绩汇总】\r\n| 姓名 | 当前水平 | 本次得分 | 本次表现 | 进步趋势 | 升档建议 |\r\n|------|----------|----------|----------|----------|----------|\r\n| {name} | {level} | {score} | {performance} | {trend} | {advice} |\r\n\r\n【班级分层统计】\r\n| 水平层级 | 人数 | 平均分 | 优秀率 | 良好率 | 待加强率 |\r\n|----------|------|--------|--------|--------|----------|\r\n| N5 | {n5_count} | {n5_avg} | {n5_excellent} | {n5_good} | {n5_weak} |\r\n| N4 | {n4_count} | {n4_avg} | {n4_excellent} | {n4_good} | {n4_weak} |\r\n| N3 | {n3_count} | {n3_avg} | {n3_excellent} | {n3_good} | {n3_weak} |\r\n| N2 | {n2_count} | {n2_avg} | {n2_excellent} | {n2_good} | {n2_weak} |\r\n| N1 | {n1_count} | {n1_avg} | {n1_excellent} | {n1_good} | {n1_weak} |\r\n\r\n## 工作流程\r\n```\r\n步骤1：接收输入\r\n步骤2：判断使用模式\r\n步骤3：自动识别练习类型\r\n步骤4：获取或创建学生档案\r\n步骤5：获取标准文本\r\n步骤6：音频转文字\r\n步骤7：逐句比对与评分\r\n步骤8：计算总分\r\n步骤9：生成纠错列表\r\n步骤10：自适应分析\r\n步骤11：更新学生档案\r\n步骤12：生成输出文件\r\n```\r\n\r\n## 评测规范\r\n评测原则:\r\n- 鼓励为主，评分适度放宽\r\n- 根据学生水平动态调整扣分力度\r\n- 只纠正影响语义的明显发音错误\r\n- 微小识别误差不予扣分\r\n- Whisper转写结果仅供参考\r\n- 纠错数量按水平分层限制\r\n\r\n反馈要求:\r\n- 语言：中文\r\n- 纠错粒度：单词级或短语级\r\n- 必须标注：原句、学生读法、标准读法、错误类型\r\n- 文件编码：UTF-8\r\n\r\n错误类型定义:\r\n| 错误类型 | 示例 |\r\n|----------|------|\r\n| 促音错误 | がっこう → がこう |\r\n| 长音错误 | おかあさん → おかさん |\r\n| 清浊混淆 | びょういん → ひょういん |\r\n| 拨音错误 | にほん → にほ |\r\n| 语调错误 | 句尾升调读成降调 |\r\n\r\n## 输出文件清单\r\n| 文件名 | 格式 | 说明 |\r\n|--------|------|------|\r\n| {学生姓名}_评分报告.txt | UTF-8文本 | 个人评分报告 + 自适应建议 |\r\n| 班级{班级号}_成绩汇总表.xlsx | Excel | 全班成绩 + 分层统计 |\r\n| 班级{班级号}_分层学情分析.txt | UTF-8文本 | 各层级表现分析 |\r\n| 班级{班级号}_升档推荐名单.txt | UTF-8文本 | 建议升档学生 |\r\n| 班级{班级号}_课堂讲评建议.txt | UTF-8文本 | 分层教学建议 |\r\n\r\n## 配置文件示例\r\n```json\r\n{\r\n  \"enable_student_profile\": false,\r\n  \"whisper_model\": \"medium\",\r\n  \"output_encoding\": \"UTF-8\"\r\n}\r\n```\n\nFile v2.1.1:_meta.json\n\n{\n  \"ownerId\": \"kn7cw3j55n4hxe9ze445qp81ks86150x\",\n  \"slug\": \"japanese-reading-grader\",\n  \"version\": \"2.1.1\",\n  \"publishedAt\": 1778766283266\n}","readmeExcerpt":"Skill: 日语朗读作业批改模板 Owner: bianmaxingkong Summary: 日语朗读作业批改（教师模式）——面向 A1/A2/B1 (JLPT N5/N4/N3) 日语学习者的朗读音频作业批改工具。ASR+声学粗筛自动检测漏读/语速/停顿；促音/长音/清浊仅输出候选。支持批量批改与归档，满分10分。 Tags: latest:2.2.3 Version history: v2.2.3 | 2026-08-18T11:26:20.526Z | user 相较此前版本的主要改进： - ASR 引擎升级为 faster-whisper（large-v3/medium 自适应） - 评分模型从扣分制重构为四维加权制（完整性/准确性/流畅度/发音质量） - 发音判定改为\"可疑候选定位+教师复核\"，不自动判错 - 新增置信度分级（高/中/低），分级驱动教师复核投入 - 最低分从6.0调整为完整0-10分区间 v2.2.","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# MP4视频 → 音频预处理\nffmpeg -y -i \"input.mp4\" -vn -acodec pcm_s16le -ar 16000 -ac 1 /tmp/audio.wav\n\n# 固定medium模型日语转写\nwhisper /tmp/audio.wav --model medium --language ja --output_format txt"},{"language":"bash","snippet":"python3 scripts/grade_submission.py COURSE_ID ASSIGNMENT_ID USER_ID GRADE --comment \"评语内容\"\npython3 scripts/grade_submission.py COURSE_ID ASSIGNMENT_ID USER_ID GRADE --comment-file comment.txt"},{"language":"bash","snippet":"# 生成班级汇总文件\npython3 scripts/generate_class_summary.py COURSE_ID ASSIGNMENT_ID [--class-name NAME]\n\n# 上传汇总表到Canvas\npython3 scripts/send_summary_message.py [--xlsx PATH]"},{"language":"text","snippet":"学生姓名：{name}\n\n【评分结果】\n总分：{score}/10\n发音准确性：{pronunciation_score}/10\n语调与节奏：{intonation_score}/10\n流畅度：{fluency_score}/10\n\n【总体评价】\n{positive_comment}，{constructive_feedback}。{encouragement}\n\n【发音纠错】\n1. 原句：{original}\n   学生读法：{student_reading}\n   标准读法：{correct_reading}（{kana}）\n   错误类型：{error_type}\n\n【练习建议】\n1. {suggestion_1}\n2. {suggestion_2}"},{"language":"text","snippet":"File v2.2.1:_meta.json\n\n{\n  \"ownerId\": \"kn7cw3j55n4hxe9ze445qp81ks86150x\",\n  \"slug\": \"japanese-reading-grader\",\n  \"version\": \"2.2.1\",\n  \"publishedAt\": 1782565516696\n}\n\nFile v2.2.1:skill-card.md\n\n## Description: <br>\nGrades Japanese reading-aloud assignments and self-practice across N5-N1 levels, with pronunciation feedback, scoring, weak-point analysis, and practice recommendations. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[bianmaxingkong](https://clawhub.ai/user/bianmaxingkong) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nJapanese teachers use this skill to batch grade reading-aloud homework and generate individual or class reports. Japanese learners use it for self-assessment, pronunciation correction, and adaptive practice recommendations. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill may process student names, audio, scores, and generated reports that should be treated as sensitive. <br>\nMitigation: Use minimal identifiers, keep student profiles disabled unless needed, store generated reports in protected locations, and share class summaries only with authorized recipients. <br>\n\n\n## Reference(s): <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, configuration, guidance] <br>\n**Output Format:** [Text or Markdown reports with optional configuration JSON examples] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May produce individual grading reports, class summaries, weak-point analyses, promotion recommendations, and teaching suggestions.] <br>\n\n## Skill Version(s): <br>\n2.2.1 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n"},{"language":"text","snippet":"File v2.2.0:_meta.json\n\n{\n  \"ownerId\": \"kn7cw3j55n4hxe9ze445qp81ks86150x\",\n  \"slug\": \"japanese-reading-grader\",\n  \"version\": \"2.2.0\",\n  \"publishedAt\": 1782565190506\n}\n\nFile v2.2.0:skill-card.md\n\n## Description: <br>\nJapanese Reading Grader helps teachers batch-grade Japanese reading assignments and helps students self-assess pronunciation practice across N5-N1 levels. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[bianmaxingkong](https://clawhub.ai/user/bianmaxingkong) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal educators and Japanese learners use this skill to grade reading audio, identify pronunciation errors, generate learner feedback, summarize class performance, and recommend adaptive practice. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill can handle persistent student-identifying performance records. <br>\nMitigation: Use pseudonyms or student IDs where possible, avoid unnecessary student names, store generated reports securely, and delete profiles or reports when they are no longer needed. <br>\nRisk: Generated classroom reports and adaptive recommendations may influence grading or learning decisions. <br>\nMitigation: Have a teacher review scores, pronunciation corrections, and recommendations before using them for official assessment or student placement. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/bianmaxingkong/skills/japanese-reading-grader) <br>\n- [Publisher profile](https://clawhub.ai/user/bianmaxingkong) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Text, Markdown, Files, Configuration, Guidance] <br>\n**Output Format:** [Chinese UTF-8 text reports, Markdown-style tables, JSON configuration snippets, and optional Excel summaries] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Outputs can include student names, class identifiers, scores, pronunciation error c"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"--- \r\nname: japanese-reading-grader\r\ndisplay_name: 日语朗读作业批改\r\ndescription: A1/A2/B1(N5/N4/N3)日语朗读音频作业批改，faster-whisper ASR+声学双通道四维AI评测；支持单人/批量批改、纠错反馈、成绩归档；AI预批改，教师人工终审，满分10分。\r\n\r\n## 适用场景\r\n\r\n学生提交音频文件（MP3/MP4/M4A/WAV）朗读日语文本，教师需要：下载 → 转写 → 评分 → 纠错 → 录入成绩 → 生成班级汇总。\r\n\r\n## 作业基础信息\r\n\r\n| 项目 | 内容 |\r\n| :--- | :--- |\r\n| **适用对象** | A1/A2/B1 日语学习者（操作标签参考 JLPT N5/N4/N3） |\r\n| **作业形式** | 朗读音频 |\r\n| **总分** | 10 分 |\r\n\r\n---\r\n\r\n## 工作流程概览\r\n\r\n> Step0 标准文本准备 → Step1 音频预处理 → Step1.5 音频质量检测 → Step2 ASR+声学双通道分析 → Step2.5 ASR可靠性检测（置信度分级）→ Step3 四维 AI 评分 → Step4 教师复核 → Step5 成绩录入与反馈生成\r\n\r\n---\r\n\r\n## Step 0：标准文本准备\r\n\r\n1.  **标准答案存储路径**：`./answer/{COURSE_ID}_{ASSIGNMENT_ID}_answer.txt`\r\n2.  **文本格式要求**：\r\n    - 每行 1 个完整句子，无多余空格与换行\r\n    - 重点词汇标注假名\r\n    - 不含多余标点，便于音频转写对齐\r\n3.  **版本校验**：批改前确认标准答案与作业要求一致\r\n4.  **标准答案假名预处理**：\r\n    - 默认本地 `pykakasi`：离线生成假名序列用于辅助分析，确定性强、不上传任何学生数据\r\n    - 生成对照文件：`./answer/{COURSE_ID}_{ASSIGNMENT_ID}_kana_ref.txt`，结构：`原文句子｜规范化假名序列`，用于逐假名对齐比对。**该文件是准确性判定/同音词豁免/清浊·长短音核对的必需输入。**\r\n    - 如未安装 `pykakasi`（降级模式）：**不阻断评分，但强制将该生归入「中置信」分流教师复核**，并在批改日志记录降级原因\r\n\r\n---\r\n\r\n## Step 1：音频预处理\r\n\r\n- 批量转为 wav 格式，统一采样率\r\n- 存放路径：`./audio/{student_id}/`\r\n\r\n---\r\n\r\n## Step 1.5：音频质量检测\r\n\r\n检测项：\r\n- 有效语音比例\r\n- 音量范围\r\n- 背景噪声\r\n- 是否存在多人声音\r\n\r\n**异常处理**：音频质量不足 → 不评分 → 请求重新上传。\r\n\r\n---\r\n\r\n## Step 2：ASR + 声学双通道分析\r\n\r\n### 转写工具规格（强制）\r\n\r\n- **唯一转写工具**：`faster-whisper`\r\n- **仅允许模型**：`large-v3 fp16` / `medium`；禁用 `small` / `base` / `tiny` 及全部其他规格\r\n- **硬件调度**：有充足 GPU 用 `large-v3 fp16`；无 GPU 自动降级 `medium`\r\n- **固定开启** `word_timestamps=True` 输出词级时间戳\r\n\r\n系统同时处理两个分析通道（**双通道校验的基础**）：\r\n\r\n| 通道 | 用途 |\r\n| :--- | :--- |\r\n| **A. ASR 文本识别通道** | 辅助判断朗读内容完整性、辅助定位可能存在的发音异常、生成文本对齐候选 |\r\n| **B. 声学分析通道** | 输入原始 wav 音频，分析发音异常候选、音长变化、停顿、语速、节奏；用于发音质量评价及长音/促音/拨音/流畅度分析 |\r\n\r\n---\r\n\r\n## Step 2.5：ASR 可靠性检测\r\n\r\n系统综合判断以下方面：\r\n- 文本匹配程度\r\n- 音频质量\r\n- ASR 置信度\r\n- 对齐情况\r\n\r\n输出：**高 / 中 / 低置信度**（用于 Step 4 教师复核的投入分级）。\r\n\r\n### 置信度分级判定标准\r\n\r\n| 置信度 | 判定条件 |\r\n| :--- | :--- |\r\n| **高** | 文本匹配率 ≥90% 且 ASR 平均置信度 ≥0.8 且 音频信噪比 ≥20dB |\r\n| **中** | 文本匹配率 ≥70% 且 <90%，ASR 平均置信度 ≥0.5 且 <0.8 |\r\n| **低** | 文本匹配率 <70%，或 ASR 平均置信度 <0.5，或音频质量检测不通过 |\r\n\r\n> 置信度‑AI评分衔接规则\r\n> 1. **高、中置信度**：四维AI加权分数作为正式预评分，教师仅做异常修正；\r\n> 2. **低置信度**：AI四维加权分数仅作为后台诊断参考，**不计入、不对外展示，最终成绩完全由教师人工给出**。\r\n\r\n---\r\n\r\n## Step 3：四维 AI 评分\r\n\r\n### 评分原则\r\n\r\n1.  不影响理解的偏差不扣分\r\n2.  A1/A2 （N5/N4）阶段轻微发音偏差以反馈为主\r\n3.  不确定错误不扣分\r\n\r\n> 发音质量维度重要说明\r\n> 发音质量权重占比15%参与AI加权运算，但**该维度输出仅为趋势预估值，不能直接等价于发音错误**；系统不会依靠该维度自动判定促音、长音、清浊错误；所有发音类错误必须经教师试听复核确认后方可扣分。\r\n> 系统可自动化可靠指标仅为：语速、停顿时长、完整性（漏读/多读）、文本对齐。\r\n\r\n### 评分前置过滤规则（评分前必须执行）\r\n\r\n计算任何维度分数前，先筛除以下情况，**排除出扣分范围**：\r\n\r\n1.  **ASR 误识别**——不进入评分计算\r\n    - 人名、地名、汉字词、同音词差异\r\n    - 系统标记为“ASR疑似误识别”的项\r\n2.  **转写存疑**——不进入评分计算\r\n    - 系统置信度 < 0.5 的识别结果\r\n3.  **学习者自然偏差**——反馈但不扣分\r\n    - A1/A2 阶段轻微音长偏差、拨音不到位\r\n    - 语气词添加、促音/长音时长轻微不足\r\n\r\n### 音频层评价指标\r\n\r\n1.  **发音质量**：清音/浊音区别、拗音准确性、促音闭塞时间、长音持续时间、拨音鼻音实现\r\n2.  **流畅度**：平均语速、停顿次数、非正常停顿长度、重复修正次数\r\n3.  **节奏与韵律**：音节时长比例、长短音节比例、句末语调变化（B1以上参考，不作为 A1/A2 主要扣分依据）\r\n\r\n### 能力层级说明（双轨分级）\r\n\r\n| 能力层级 | 约对应 JLPT | 朗读评价重点 |\r\n| :--- | :--- | :--- |\r\n| **A1** | N5 | 准确朗读短句，掌握基础假名发音，长音/促音容错空间大 |\r\n| **A2** | N4 | 连贯朗读"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7cw3j55n4hxe9ze445qp81ks86150x\",\n  \"slug\": \"japanese-reading-grader\",\n  \"version\": \"2.2.3\",\n  \"publishedAt\": 1787052380526\n}"},{"path":"skill-card.md","content":"## Description:\n\nA1/A2/B1(N5/N4/N3)日语朗读音频作业批改，faster-whisper ASR+声学双通道四维AI评测；支持单人/批量批改、纠错反馈、成绩归档；AI预批改，教师人工终审，满分10分。\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[bianmaxingkong](https://clawhub.ai/user/bianmaxingkong)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nTeachers use this skill to pre-grade Japanese reading audio assignments for A1/A2/B1 learners, generate concise feedback, and support batch grading records. The skill is designed as an AI-assisted workflow with teacher review before final grades are recorded.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Student audio, scores, reports, and progress files may contain sensitive education data.\n\nMitigation: Use the skill only in authorized teaching contexts, keep generated files in restricted course folders, minimize student identifiers, and follow school retention rules for deletion or archival.\n\nRisk: ASR or acoustic analysis can misidentify pronunciation or reading errors, especially for low-confidence audio.\n\nMitigation: Use the skill's confidence tiers and require teacher review for low-confidence cases and pronunciation-sensitive deductions before recording final grades.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/bianmaxingkong/skills/japanese-reading-grader)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, guidance, configuration]\n\n**Output Format:** [Markdown or plain text feedback reports with scores, diagnostic notes, correction suggestions, and optional local report/progress file paths]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May produce per-student report text, batch progress records, failed-audio records, and teacher-review prompts for low-confidence or pronunciation-sensitive findings.]\n\n## Skill Version(s):\n\n2.2.3 (source: release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"日语朗读作业批改（教师模式）——面向 A1/A2/B1 (JLPT N5/N4/N3) 日语学习者的朗读音频作业批改工具。ASR+声学粗筛自动检测漏读/语速/停顿；促音/长音/清浊仅输出候选。支持批量批改与归档，满分10分。 Skill: 日语朗读作业批改模板 Owner: bianmaxingkong Summary: 日语朗读作业批改（教师模式）——面向 A1/A2/B1 (JLPT N5/N4/N3) 日语学习者的朗读音频作业批改工具。ASR+声学粗筛自动检测漏读/语速/停顿；促音/长音/清浊仅输出候选。支持批量批改与归档，满分10分。 Tags: latest:2.2.3 Version history: v2.2.3 | 2026-08-18T11:26:20.526Z | user 相较此前版本的主要改进： - ASR 引擎升级为 faster-whisper（large-v3/medium 自适应） - 评分模型从扣分制重构为四维加权制（完整性/准确性/流畅度/发音质量） - 发音判定改为\"可疑候选定位+教师复核\"，不自动判错 - 新增置信度分级（高/中/低），分级驱动教师复核投入 - 最低分从6.0调整为完整0-10分区间 v2.2.","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":897,"uniquenessScore":59,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T07:04:35.208Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T07:04:35.208Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T10:45:10.844Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}