Datasheet cn reader
Convert English semiconductor datasheet PDFs into page-aligned, self-contained Chinese HTML readers with source-page images, real HTML tables, preservation manifests, and fail-closed QA. Use when translating chip manuals, IC datasheets, electrical-characteristics tables, pin descriptions, test circuits, or package dimensions while preserving models, pins, symbols, formulas, values, units, conditions, and MIN/TYP/MAX relationships.From its SKILL.md
npx -y skills add yitengchun833-gif/datasheet-cn-readerAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 25 days oldThe repository was created 25 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.2 KB, 597 tokens by cl100k_base, as published. Nobody here has run it
Datasheet CN Reader
Create a separate output; never overwrite the source PDF.
Required workflow
- Run
datasheet-cn-reader extract SOURCE.pdf --output work/extraction.json. - Run
datasheet-cn-reader manifest work/extraction.json --output work/qa_manifest.json. - Read translation-rules.md.
- Create page translations:
- For Agent translation, run
datasheet-cn-reader translate work/extraction.json --output work/translation.json --provider draft, replace every待人工确认block, and preserve all protected tokens. - For a controlled regression baseline, use
--provider baseline-html --baseline accepted.htm. - For an external translator, use
--provider command --command ...; keep credentials outside prompts and files.
- For Agent translation, run
- Run
datasheet-cn-reader build work/extraction.json work/translation.json --output output/reader.html. - Read qa-contract.md, then run:
datasheet-cn-reader validate work/qa_manifest.json work/translation.json output/reader.html --report output/qa-report.json. - Run
datasheet-cn-reader review output/reader.html --output-dir output/render-review. - Deliver only when validation exits
0and the QA report hasstatus: passed.
Translation contract
- Treat the uploaded PDF as the only parameter authority.
- Translate English natural language only.
- Do not change product models, pin names, parameter symbols, formulas, values, units, test conditions, table order, or MIN/TYP/MAX column relationships.
- Do not silently update values from a website or another revision.
- If external material differs, report the difference without replacing the uploaded value.
- Mark uncertain extraction or translation as
待人工确认; never guess. - Preserve every source page as one corresponding HTML page block.
- Use real HTML tables for structured data; do not substitute table screenshots.
- Keep original page images embedded as data URLs for offline traceability.
Failure rules
- Treat a nonzero validator exit as a hard stop.
- Do not rename a failing build as a verified build.
- Fix the exact page/table/token issue recorded in the QA report.
- Do not suppress a missing token or row without recording a narrowly scoped, evidence-based exemption.
- If OCR is required, record OCR use and confidence per page.
Interfaces
- CLI:
datasheet-cn-reader --help - Source-tree wrappers:
scripts/*.py - MCP stdio server:
python -m datasheet_cn_reader.mcp_server - Generic Agent prompt:
adapters/universal-prompt.md - Product adapters:
adapters/{codex,claude-code,cursor,gemini-cli,hermes}/
Read technical-terms.md when standard Chinese terminology is uncertain.
What ships with it: 49 files
2734.8 KB alongside SKILL.md, 23 of them executable
adapters/
- claude-code/INSTALL.md319 B
- codex/INSTALL.md297 B
- cursor/INSTALL.md311 B
- gemini-cli/INSTALL.md324 B
- hermes/INSTALL.md281 B
- mcp-server/server.json122 B
- universal-prompt.md837 B
agents/
- openai.yaml256 B
assets/
- reader-template.html3.9 KB
docs/
- images/rs2057-reader.png1276.5 KB
- images/rs2299-reader.png1370.2 KB
evals/
- expected-results.json763 B
- README.md647 B
references/
- qa-contract.md2.1 KB
- technical-terms.md912 B
- translation-rules.md1.6 KB
reports/
- test-report.md2.4 KB
scripts/
- build_html.pyruns187 B
- build_manifest.pyruns190 B
- extract_pdf.pyruns189 B
- install_skill.pyruns2.1 KB
- package_release.pyruns2.1 KB
- render_review.pyruns188 B
- translate_pages.pyruns191 B
- validate_translation.pyruns190 B
src/
- datasheet_cn_reader/cli.pyruns4.4 KB
- datasheet_cn_reader/extractor.pyruns2.7 KB
- datasheet_cn_reader/html_builder.pyruns3.1 KB
- datasheet_cn_reader/__init__.pyruns50 B
- datasheet_cn_reader/manifest.pyruns4.8 KB
- datasheet_cn_reader/mcp_server.pyruns3.8 KB
- datasheet_cn_reader/review.pyruns2.5 KB
- datasheet_cn_reader/templates/reader-template.html3.9 KB
- CHANGELOG.md712 B
- .gitignore141 B
- KNOWN_LIMITATIONS.md1.5 KB
- LICENSE1.1 KB
- MANIFEST.in355 B
- pyproject.toml1.3 KB
- README.md7.6 KB
9 more files not listed here. See all 49 in the repository.