From c3dda6d750921d3deaa1f1aa6be225fa76ce9f89 Mon Sep 17 00:00:00 2001 From: jason Date: Mon, 18 May 2026 14:50:19 -0500 Subject: [PATCH] docs: update README to v1.0 with correct CW-014 reference --- README.md | 120 +++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 119 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 850cb7a..7b80b75 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,121 @@ # liontron-board-technical-library -CoWork skill for capturing Liontron mainboard technical data from en.liontron.cn — downloads specs, images, PDFs, and generates standardized markdown reference files. \ No newline at end of file +CoWork skill for capturing Liontron mainboard technical data from en.liontron.cn — downloads specs, images, PDFs, and generates standardized markdown reference files. + +**Version:** 1.0 +**Author:** MPM / Bryan Gilliom +**Repo:** http://10.2.0.15:3000/qrknit/liontron-board-technical-library +**CoWork Project:** CW-014 — Liontron Board Technical Library Capture + +--- + +## Overview + +This skill instructs CoWork to visit Liontron board product pages on en.liontron.cn, extract all technical information, download board images and PDFs, and produce standardized Markdown reference files for the MPM technical library. It uses Claude in Chrome to navigate and extract content, since the Liontron site renders its specification tables as images rather than HTML text. The skill was developed with the D-3588 RK3588 board as a reference and covers boards from all Liontron product series used by MPM (H, K, D, M, Fi, etc.). Output files follow a consistent naming convention and structure for direct use as KB source material. + +--- + +## Skills + +| Skill | What It Does | +|---|---| +| `liontron-board-technical-library` | Navigates to a specified Liontron board page, captures overview text and key features, identifies and downloads up to 5 technical images (main photo, overview, front I/O diagram, rear I/O, dimensions), downloads spec and mechanical PDFs, reads the spec table from screenshots, captures I/O port labels, and produces a standardized `.md` reference file. Trigger phrases: "process board [BOARDNAME] from the Liontron catalog", "capture Liontron board data", "download Liontron specs for [BOARD]", "get the technical reference for [BOARD]". | + +--- + +## Board Catalog + +The skill contains a built-in URL catalog covering all Liontron board series: + +| Series | Boards | +|---|---| +| Edge Intelligence | D-3588 (RK3588), D-3568 (RK3568) | +| K Series AIoT | K-A311D, K4 (RK3399), K3 (RK3288), K-3566, K-3568, K2, K0 | +| H Series HMI | H-3399, H-3568, H-3566, H-T972, H-A133L, H-A133, H-A133R, H3, H0 | +| Commercial Display | M3 (RK3288), M2, M1 | +| Smart New Retail | P3X, PX-3568, P2 | +| Access Control | F4, F3X, F3, F1i, F1, Fi-1109 | +| Industrial Computer | ITX-Z3588, ITX-Y3399, VNS-3568, VPC-3588, UPC-3568, C4, C3, C0 | + +> **Note:** RK3576/3576S boards (D-3576, H-3576S — MPM codes CM/CN) are not yet in the catalog and should be added when Liontron publishes their product pages. + +--- + +## Output Files Per Board + +| File Type | Naming Pattern | Example | +|---|---|---| +| Specs PDF | `[BOARD]-[CHIP]-Specifications.pdf` | `D-3568-RK3568-Specifications.pdf` | +| Mech PDF | `[BOARD]-[CHIP]-Mechanical-Drawings.pdf` | `D-3568-RK3568-Mechanical-Drawings.pdf` | +| Board Photo | `[BOARD]-Board-Main-Photo.jpg` | `D-3568-Board-Main-Photo.jpg` | +| Overview Photo | `[BOARD]-Board-Overview.jpg` | `D-3568-Board-Overview.jpg` | +| Front IO Diagram | `[BOARD]-Front-IO-Labeled-Diagram.jpg` | `D-3568-Front-IO-Labeled-Diagram.jpg` | +| Rear IO Photo | `[BOARD]-Rear-IO-MicroSIM.jpg` | `D-3568-Rear-IO-MicroSIM.jpg` | +| Dimensions Diagram | `[BOARD]-Board-Dimensions.jpg` | `D-3568-Board-Dimensions.jpg` | +| Markdown Reference | `[BOARD]-[CHIP]-Liontron-Technical-Reference.md` | `D-3568-RK3568-Liontron-Technical-Reference.md` | + +--- + +## Setup Instructions + +1. Install the skill by uploading `liontron-board-technical-library-v1.0.skill` via CoWork plugin settings +2. Ensure **Claude in Chrome** is connected and an active browser session is open +3. Verify CoWork can reach `en.liontron.cn` (no network restrictions) +4. To begin: *"Process board [BOARDNAME] from the Liontron catalog"* + +### Setup Checklist +- [ ] Skill file installed in CoWork +- [ ] Claude in Chrome connected +- [ ] en.liontron.cn accessible from the browser session +- [ ] Working folder available for downloaded files + +--- + +## Connection Details + +| Field | Value | +|---|---| +| Target site | http://en.liontron.cn | +| Browser tool | Claude in Chrome (`navigate`, `javascript_tool`, `get_page_text`) | +| Auth required | None (public site) | +| MCP server | None (skill-only, no server component) | + +--- + +## Workflow Notes + +- Process one board at a time unless user explicitly requests batch mode +- The spec table on each page is rendered as a large image — the skill scrolls to it and reads it from a screenshot; do not attempt DOM extraction for specs +- All downloads use fetch+blob (not direct href) — direct downloads result in incomplete `.crdownload` files on this domain +- Markdown files cannot be downloaded via blob URI on this domain; content is written to a new tab for copy-paste by the user +- Images at offsetTop 0 with width exactly 1000px are thumbnail duplicates — skip them +- Space image downloads at least 2000ms apart to avoid incomplete files +- After each board, confirm with user before proceeding to the next + +--- + +## Completed Boards Log + +| Board | Date | Status | +|---|---|---| +| D-3588 RK3588 | 2026-03-19 | Complete — reference board | + +--- + +## Requirements + +- CoWork with Claude in Chrome connected +- Active browser session open to any page (skill will navigate from there) +- Network access to en.liontron.cn + +--- + +## Troubleshooting + +| Symptom | Fix | +|---|---| +| Downloads result in `.crdownload` files | Use fetch+blob method, not direct anchor href | +| Spec table extraction returns no data | Table is image-based — scroll to offsetTop ~11000-13000 and read from screenshot | +| MD file download fails | Write to new tab via `document.open/write`, instruct user to copy-paste | +| Wrong images downloaded | Use offsetTop + naturalWidth/naturalHeight to identify correct technical images; skip 1000px-wide thumbnails | +| Page content missing after navigation | Wait 2 seconds after navigation before running JavaScript extraction |