Skip to content

Staging - #445

Merged
suguanYang merged 14 commits into
stagingfrom
main
Sep 28, 2026
Merged

suguanYang merged 14 commits into
stagingfrom
main

Conversation

@suguanYang

Copy link
Copy Markdown
Contributor

No description provided.

suguanYang and others added 14 commits September 23, 2026 16:36
GitHub dark mode painted every figure on a white canvas: the banner, the parsing and retrieval diagrams, and the benchmark grid. Each figure now ships a light and a dark file selected by a <picture> element with prefers-color-scheme, so the switch needs no CSS.

- Banner: the light and dark hero exports replace knowhere-banner.png.
- Parsing and retrieval: refreshed from the new 01/02 designs. Those designs ship light only, so the two diagrams stay single-variant for now.
- Benchmark: re-rendered from the design SVG at 1600x1120 with a 2x device scale. The dark variant comes from the same SVG with color literals remapped and geometry untouched, holding each element relative contrast (bars 1.56:1 to 1.89:1, grid 1.30:1 to 1.56:1, text at or above 4.5:1).
- Sources: both benchmark SVGs live in docs/assets/source/ with the palette mapping and the render recipe.
- Dropped the four figures the README no longer references.

Text in the benchmark SVG is exported as glyph paths, so future metric changes belong in the generating script, not in the SVG.
The banner sat at the left edge while the headline, badges, links, and every figure are centered, because it was the only image in the file without a centering wrapper. Wrap it in the same <p align="center"> the other figures use.
The new hero banner already renders "Prepare unstructured data for AI agents", so the h1 directly below it repeated the same sentence inside the first screen. Drop the h1 and keep the wording in the banner alt text, where screen readers and search still pick it up.
docs: give the README figures a dark counterpart
GitHub markdown sets max-width: 100% on images but never height: auto, so an explicit height attribute keeps the box at that height while the width shrinks to the README column. The banner was the only image in the file carrying one, so it rendered 768x500 in the column instead of 768x384: the artwork and its headline came out 30% taller than designed.

Reproduced the rule locally at a 768px column: width+height renders 768x500 (ratio 1.536 against the natural 2.000), width alone renders 768x384 (ratio 2.000). A template match against the artwork on the live page agreed with the stretched case (0.48 horizontal scale, 0.58 vertical).

Dropping the attribute makes the banner behave like every other figure in the file, which set width only.
Both variants come from the new 3200x1600 exports (2x of the previous 1600x800) with the same composition: lockup top left, headline bottom left, illustration right. The wrappers keep width-only sizing so the aspect comes from the file.
The Vision + Text and Step 2 sections were the last light-only images in the README. Both now ship a dark export next to the light one and switch through <picture>, so every figure in the file follows the reader color scheme.

The two dark exports are mapped by content, not by export order: the parsing figure carries the two tracks and the unified schema, the retrieval figure carries the agent list and grounded evidence.
docs: refresh the README banner artwork and add the dark diagrams
…page text handling

- Consolidated VLM model references to use `deepseek-flash` across documentation and configuration files.
- Enhanced the `PageTextBands` structure to support ordered line records, improving text extraction and processing.
- Removed deprecated fields and streamlined the handling of page text in various components, ensuring consistency in data representation.
- Updated tests to reflect changes in the `PageTextBands` structure and VLM model usage.
The previous dump flattened every extracted TOC into one tree, which hid later regions in multi-TOC documents.

Co-authored-by: Cursor <cursoragent@cursor.com>
…-text

refactor: unify VLM on deepseek-flash and tighten page-text handling
…zation-under-10s

perf(publication): reduce materialization persistence latency

@github-advanced-security github-advanced-security AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CodeQL found more than 20 potential problems in the proposed changes. Check the Files changed tab for more details.

@suguanYang
suguanYang merged commit 093111c into staging Sep 28, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants