study-imglisted

# Study Image Reading **Output language: ALL learner-facing content MUST be Simplified Chinese.** ## Try native vision first Use the available image-reading capability directly when possible. - If you can see the image, produce the required mode output below. - If image reading fails or the model has no vision, use the external vision API script. One failed native attempt per session is enough evidence; do not retry every image. ## External vision API ```bash python3 ~/.claude/skills/study-img/scripts/recognize.py <image> --mode <mode> ``` First-use configuration: ask for provider type, base URL/API key, and vision model. Store config in `~/.config/study-img/config.json`, `chmod 600`, and never repeat the full API key in conversation. ## Modes | Scenario | Mode | Required output | |---|---|---| | Scanned textbook page / photographed paper / handout | `--mode ocr` | Structured Markdown transcription; formulas as LaTeX; figures as `[图：...]` placeholders with enough detail to locate them. | | Textbook/courseware figure, coordinate plot, table image, flowchart, chart | `--mode figure` | Teaching-grade description complete enough to redraw or convert into a lecture figure/table. Include axes, labels, variables, trends, data rows, and the conclusion. | | Learner handwritten answers | `--mode answer` | Verbatim transcription; preserve errors; LaTeX formulas; use `【?】` for illegible characters. | | Unsure | no mode | Comprehensive recognition. | ## Workflow hookups - Scan