倪程伟 b9bf332ca4 docs(webchat): visitor-facing integration guide (epic #355 PR 8) ... docs/zh/webchat.md — single source of truth for downstream integrators. Covers everything needed to embed MateClaw webchat into a third-party site without reading source: - Base URL, auth model (API Key + visitorToken), R<T> response wrap - Endpoint table (14 visitor-facing + 2 admin) - Auth flow diagram (how visitorToken gets minted on /stream, reused on management endpoints) - Error code table (400/401/404/409 with semantics) - SSE event protocol (meta / content_delta / thinking_delta / done / error) - File upload + download flow (visitor-attached vs agent-generated; /api/v1/files/generated/<uuid> is permitAll + 7d TTL) - visitorToken revocation admin endpoint - Three end-to-end curl examples (first message / list sessions / upload-then-send) - Limits (5 empty-session quota, upload caps, 7d expirations, single-instance constraint today) @Operation / @Parameter / @ApiResponse / @ExampleObject polish on WebChatController is intentionally deferred — it's noisy mechanical work that deserves its own focused PR rather than getting rushed in here. The doc is the canonical reference now; the swagger annotations can quote it. Part of epic #355.		2026-06-18 06:33:17 +08:00
..
src	docs(webchat): visitor-facing integration guide (epic #355 PR 8)	2026-06-18 06:33:17 +08:00
Dockerfile	fix(docker): honor SPRING_PROFILES_ACTIVE instead of pinning the mysql profile	2026-06-14 16:47:16 +08:00
pom.xml	fix(db): make KingbaseES driver opt-in and restore default SSRF guard	2026-06-14 10:34:35 +08:00
settings.xml	build(maven): declare US + CN repositories in pom.xml, drop opaque mirror	2026-04-25 09:56:17 +08:00