WeKnora deployment source with the reviewed wiki identity, summary and recovery fixes

2026-09-22 16:19:06 +08:00
commit f7fc992f57
3929 changed files with 1006607 additions and 0 deletions
@@ -0,0 +1,31 @@
+# WeKnora Mini Program
+
+This directory contains a WeChat Mini Program plugin for WeKnora. It gives mobile users a lightweight entry point to:
+
+- configure a WeKnora API endpoint and tenant API key;
+- list available knowledge bases;
+- import a URL into a selected knowledge base;
+- ask a selected knowledge base through WeKnora knowledge chat.
+
+## Getting started
+
+1. Open `miniprogram/` in WeChat DevTools.
+2. Copy `project.private.config.json.example` to `project.private.config.json` and set your real Mini Program AppID. The shared `project.config.json` intentionally does not include an AppID to avoid forcing maintainers into a placeholder project.
+3. Open the **Settings** tab and fill in:
+   - API Base URL, for example `https://weknora.example.com`;
+   - API Key from the WeKnora tenant settings page.
+4. Open the **Knowledge** tab, refresh knowledge bases, and select the target knowledge base.
+5. Import a URL or switch to **Chat** to ask questions.
+
+## Local development notes
+
+- WeChat DevTools may block `localhost` requests when URL validation is enabled. For local testing, either disable domain validation in DevTools or expose WeKnora through a HTTPS development domain.
+- In production Mini Programs, add the WeKnora API domain to the Mini Program request domain allowlist.
+- The chat endpoint returns Server-Sent Events. The Mini Program client parses completed SSE text responses and displays accumulated `answer` chunks.
+
+## Test
+
+```bash
+cd miniprogram
+npm test
+```