WeKnora/docs
lyingbug 44a1df6046
docs(readme): website-matched design for all four READMEs (#3679)
* docs(readme): match the product website's look and drop slogan copy

Add hero and capability-card artwork (English and Chinese, light and dark)
drawn in the website's palette, type and line icons, plus small gold table
icons; docs/images/readme/src/generate.py rebuilds them. The copy in the
artwork is the homepage's own.

Replace per-bullet emoji and slogan-style lead-ins with plain labels, drop
emoji from headings and captions, add the homepage's three ways to get
started and the v0.8.2 product shots, restyle the badges in the brand
colors, and give the client table real logos or consistent line icons.

* docs(readme): bring JA/KO in line and add feature spotlights

Rebuild README_JA.md and README_KO.md on the same structure as the English
and Chinese READMEs, keeping their existing translations. Add what they
were missing: CLI and Mini Program entries, the contribution validation
steps, knowledge graph, access control and security rows, Zhipu
embeddings and Tencent Cloud COS. README_KO keeps its usage scenarios.

Generate Japanese and Korean hero and capability artwork with
language-specific CJK fonts, so Japanese kanji do not fall back to
Chinese glyph forms and Hangul wraps at spaces.

Replace the flat screenshot grid with four spotlights (local browser,
skills and sandbox, automatic wiki, observability), each pairing two
real screenshots in window frames; the remaining shots move to a
two-column "more screenshots" grid. docs/images/readme/src/spotlights.py
rebuilds the spotlight images.

* docs(readme): keep the browser task preview visible in its spotlight

The browser-connection window sat in the bottom-right corner, right over
the in-chat task preview that the main screenshot is meant to show. Let
each spotlight pick the corner for its side window and put the browser
one bottom-left, over the session list instead.

* docs(readme): make spotlight images clickable and sharp when opened

GitHub links a bare <img> to the full image but leaves <picture> inert,
so the spotlights could not be opened. Wrap each one in a link to its
image, and write the spotlights at 3200x1800 so the screenshots are
readable at full size and crisp on high-density displays.

* docs(readme): add Q&A and toolbox spotlights, drop the leftover screenshots

Add two spotlights: quick Q&A beside smart reasoning, and the toolbox's
MCP service tools beside its skill catalog. They cover the Q&A and skill
catalog shots from the screenshot grid, so the grid and its remaining
chunk editing, folder tree and wiki revision shots go.

* docs(readme): redraw the architecture diagram and widen the hero highlights

Replace docs/images/architecture.png with a generated diagram in the
same visual language as the rest of the README (per language, light and
dark), drawn from website-docs/02-architecture: clients and channels
feed the Go app, where RAG Q&A, agent reasoning and auto wiki share one
knowledge pipeline over workspaces, the model catalog, the task queue
and tracing; the app calls docreader, sandboxes, model providers, web
search, external MCP services and data sources, and stores data in
PostgreSQL (ParadeDB), Redis and the optional vector, object, Neo4j and
Langfuse stores. The old PNG was only referenced by the READMEs.

The hero listed only the three core modes; show eight highlights
instead (adding the local browser, skills and sandbox, MCP Server,
long-term memory, and data sources and IM) so the first screen reflects
the product's range. The capability cards below still explain the three
core modes.
2026-09-24 20:16:55 +08:00
..
assets fix(ui): 优化知识库文档交互与对话布局 (#3420) 2026-09-19 11:58:49 +08:00
images docs(readme): website-matched design for all four READMEs (#3679) 2026-09-24 20:16:55 +08:00
poc/docker-sandbox docs: 迁移有效文档至 website-docs 并清理旧文档 (#3580) 2026-09-22 23:25:40 +08:00
LITE.md refactor(terminology): rename user-facing tenant labels to workspace 2026-07-14 16:14:43 +08:00
README.md docs: 迁移有效文档至 website-docs 并清理旧文档 (#3580) 2026-09-22 23:25:40 +08:00
docs.go feat(agent): size agent history by the window and calibrate token estimates (#3413) 2026-09-18 22:51:31 +08:00
swagger.json feat(agent): size agent history by the window and calibrate token estimates (#3413) 2026-09-18 22:51:31 +08:00
swagger.yaml feat(agent): size agent history by the window and calibrate token estimates (#3413) 2026-09-18 22:51:31 +08:00
swagger_contract_test.go feat(faq): filter entries by enabled status (#3157) 2026-09-10 14:42:59 +08:00

README.md

文档已迁至 website-docs

产品、部署、API 和开发文档统一维护在 website-docs。已迁移、重复和过时的旧手写文档已删除;历史内容可从 Git 历史查看。

本目录仅保留以下工程资源及本入口说明:

  • docs.go、swagger.json、swagger.yaml 与契约测试:参与后端编译和测试,生成物仍由 make docs 更新。
  • LITE.md:Lite 发布包复制为离线 README。
  • images/、assets/:README、Helm 等仍使用的图片资源。
  • poc/docker-sandbox/:独立 Go 实验模块,保留源码和运行说明,不作为当前产品指南。

这些资源尚有编译、发布或历史实验用途,不能直接整目录删除。新的产品说明不要再放入此处。