Skip to content

Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.

feat(miniprogram): add zh/en i18n, tab icons, and base library compatibility

Haibing Ou7c4b5f1bfef7
diff --git a/miniprogram/README.md b/miniprogram/README.md
index 823a65f29..ca05e4967 100644
--- a/miniprogram/README.md
+++ b/miniprogram/README.md
@@ -3,6 +3,7 @@
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;
+- switch UI language between Chinese and English;
- list available knowledge bases;
- import a URL into a selected knowledge base;
- ask a selected knowledge base through WeKnora knowledge chat.
@@ -13,10 +14,17 @@ This directory contains a WeChat Mini Program plugin for WeKnora. It gives mobil
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.
+ - API Key from the WeKnora tenant settings page;
+ - Language (`中文` / `English`, default `中文`).
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.
+## Language
+
+- Locale strings live in `utils/i18n.js`.
+- The selected language is stored in local settings as `locale` (`zh` | `en`).
+- Changing language in Settings updates page copy, navigation titles, and tab bar labels immediately.
+
## 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.
diff --git a/miniprogram/app.js b/miniprogram/app.js
index 9543f8e51..309c7ae10 100644
--- a/miniprogram/app.js
+++ b/miniprogram/app.js
@@ -5,7 +5,8 @@ App({
wx.setStorageSync("weknora_settings", {
baseUrl: "http://localhost:8080",
apiKey: "",
- selectedKnowledgeBaseId: ""
+ selectedKnowledgeBaseId: "",
+ locale: "zh"
});
}
}
diff --git a/miniprogram/app.json b/miniprogram/app.json
index ac8c34a77..d9b9a772e 100644
--- a/miniprogram/app.json
+++ b/miniprogram/app.json
@@ -18,15 +18,21 @@
"list": [
{
"pagePath": "pages/index/index",
- "text": "Knowledge"
+ "text": "知识库",
+ "iconPath": "assets/tab/knowledge.png",
+ "selectedIconPath": "assets/tab/knowledge-active.png"
},
{
"pagePath": "pages/chat/chat",
- "text": "Chat"
+ "text": "问答",
+ "iconPath": "assets/tab/chat.png",
+ "selectedIconPath": "assets/tab/chat-active.png"
},
{
"pagePath": "pages/settings/settings",
- "text": "Settings"
+ "text": "设置",
+ "iconPath": "assets/tab/settings.png",
+ "selectedIconPath": "assets/tab/settings-active.png"
}
]
}
diff --git a/miniprogram/app.wxss b/miniprogram/app.wxss
index 9fbd9c444..c0ef05ba8 100644
--- a/miniprogram/app.wxss
+++ b/miniprogram/app.wxss
@@ -72,3 +72,9 @@ button {
button[disabled] {
background: #c5c5c5;
}
+
+.picker-value {
+ display: flex;
+ align-items: center;
+ color: #1a1a1a;
+}
diff --git a/miniprogram/assets/tab/chat-active.png b/miniprogram/assets/tab/chat-active.png
new file mode 100644
index 000000000..d26c2e470
Binary files /dev/null and b/miniprogram/assets/tab/chat-active.png differ
diff --git a/miniprogram/assets/tab/chat.png b/miniprogram/assets/tab/chat.png
new file mode 100644
index 000000000..9844ebfc7
Binary files /dev/null and b/miniprogram/assets/tab/chat.png differ
diff --git a/miniprogram/assets/tab/knowledge-active.png b/miniprogram/assets/tab/knowledge-active.png
new file mode 100644
index 000000000..c8faa0040
Binary files /dev/null and b/miniprogram/assets/tab/knowledge-active.png differ
diff --git a/miniprogram/assets/tab/knowledge.png b/miniprogram/assets/tab/knowledge.png
new file mode 100644
index 000000000..04d64f3c8
Binary files /dev/null and b/miniprogram/assets/tab/knowledge.png differ
diff --git a/miniprogram/assets/tab/settings-active.png b/miniprogram/assets/tab/settings-active.png
new file mode 100644
index 000000000..340ee37f0
Binary files /dev/null and b/miniprogram/assets/tab/settings-active.png differ
diff --git a/miniprogram/assets/tab/settings.png b/miniprogram/assets/tab/settings.png
new file mode 100644
index 000000000..611240987
Binary files /dev/null and b/miniprogram/assets/tab/settings.png differ
diff --git a/miniprogram/pages/chat/chat.js b/miniprogram/pages/chat/chat.js
index 095d6a1e4..5e60831f1 100644
--- a/miniprogram/pages/chat/chat.js
+++ b/miniprogram/pages/chat/chat.js
@@ -1,16 +1,54 @@
const { getSettings } = require("../../utils/config");
const { createSession, knowledgeChat } = require("../../utils/request");
const { collectAnswerFromSSE } = require("../../utils/sse");
+const { applyNavTitle, applyTabBar, getMessages, t } = require("../../utils/i18n");
+
+function buildViewModel() {
+ const messages = getMessages();
+ return {
+ chatTitle: messages.chatTitle,
+ chatSubtitle: messages.chatSubtitle,
+ questionLabel: messages.question,
+ questionPlaceholder: messages.questionPlaceholder,
+ askText: messages.askWeKnora,
+ answerLabel: messages.answer
+ };
+}
Page({
data: {
+ chatTitle: "知识问答",
+ chatSubtitle: "向当前选中的 WeKnora 知识库提问。",
+ questionLabel: "问题",
+ questionPlaceholder: "输入你的问题…",
+ askText: "向 WeKnora 提问",
+ answerLabel: "回答",
answer: "",
+ displayAnswer: "",
loading: false,
query: "",
rawResponse: "",
sessionId: ""
},
+ applyI18n() {
+ this.setData(buildViewModel());
+ },
+
+ onLoad() {
+ this.applyI18n();
+ },
+
+ onShow() {
+ try {
+ applyTabBar();
+ applyNavTitle("navChat");
+ this.applyI18n();
+ } catch (error) {
+ // keep fallback Chinese copy
+ }
+ },
+
onQueryInput(event) {
this.setData({ query: event.detail.value });
},
@@ -22,30 +60,36 @@ Page({
const settings = getSettings();
const response = await createSession(settings.selectedKnowledgeBaseId);
- const sessionId = response.data?.id;
+ const sessionId = response && response.data ? response.data.id : "";
if (!sessionId) {
- throw new Error("The session API did not return a session id.");
+ throw new Error(t("sessionIdMissing"));
}
- this.setData({ sessionId });
+ this.setData({ sessionId: sessionId });
return sessionId;
},
async ask() {
- this.setData({ answer: "", rawResponse: "", loading: true });
+ this.setData({ answer: "", rawResponse: "", displayAnswer: "", loading: true });
try {
const sessionId = await this.ensureSession();
const settings = getSettings();
- const response = await knowledgeChat(sessionId, this.data.query.trim(), settings.selectedKnowledgeBaseId);
+ const response = await knowledgeChat(
+ sessionId,
+ this.data.query.trim(),
+ settings.selectedKnowledgeBaseId
+ );
const rawResponse = typeof response === "string" ? response : JSON.stringify(response);
const answer = collectAnswerFromSSE(rawResponse);
+ const displayAnswer = answer || rawResponse;
this.setData({
- answer,
- rawResponse: answer ? "" : rawResponse
+ answer: answer,
+ rawResponse: answer ? "" : rawResponse,
+ displayAnswer: displayAnswer
});
} catch (error) {
wx.showModal({
- title: "Chat failed",
- content: error.message,
+ title: t("chatFailed"),
+ content: (error && error.message) || "",
showCancel: false
});
} finally {
diff --git a/miniprogram/pages/chat/chat.json b/miniprogram/pages/chat/chat.json
index baf81b0e8..21a8583f4 100644
--- a/miniprogram/pages/chat/chat.json
+++ b/miniprogram/pages/chat/chat.json
@@ -1,3 +1,3 @@
{
- "navigationBarTitleText": "Chat"
+ "navigationBarTitleText": "问答"
}
diff --git a/miniprogram/pages/chat/chat.wxml b/miniprogram/pages/chat/chat.wxml
index f0f0b7dce..71958700a 100644
--- a/miniprogram/pages/chat/chat.wxml
+++ b/miniprogram/pages/chat/chat.wxml
@@ -1,18 +1,18 @@
<view class="page">
<view class="card">
- <view class="title">Knowledge Chat</view>
- <view class="muted">Ask the selected WeKnora knowledge base.</view>
+ <view class="title">{{chatTitle}}</view>
+ <view class="muted">{{chatSubtitle}}</view>
<view class="field">
- <text class="label">Question</text>
- <textarea value="{{query}}" placeholder="Ask something..." bindinput="onQueryInput" />
+ <text class="label">{{questionLabel}}</text>
+ <textarea value="{{query}}" placeholder="{{questionPlaceholder}}" bindinput="onQueryInput" />
</view>
- <button bindtap="ask" loading="{{loading}}" disabled="{{!query}}">Ask WeKnora</button>
+ <button bindtap="ask" loading="{{loading}}" disabled="{{!query}}">{{askText}}</button>
</view>
- <view class="card answer-card" wx:if="{{answer || rawResponse}}">
- <view class="label">Answer</view>
- <view class="answer">{{answer || rawResponse}}</view>
+ <view class="card answer-card" wx:if="{{displayAnswer}}">
+ <view class="label">{{answerLabel}}</view>
+ <view class="answer">{{displayAnswer}}</view>
</view>
</view>
diff --git a/miniprogram/pages/index/index.js b/miniprogram/pages/index/index.js
index 7013c9bd5..c4a7dfd19 100644
--- a/miniprogram/pages/index/index.js
+++ b/miniprogram/pages/index/index.js
@@ -1,21 +1,54 @@
-const { saveSettings, getSettings } = require("../../utils/config");
+const { getSettings, saveSettings } = require("../../utils/config");
const { createKnowledgeFromURL, listKnowledgeBases } = require("../../utils/request");
+const { applyNavTitle, applyTabBar, getMessages, t } = require("../../utils/i18n");
function normalizeKnowledgeBases(response) {
- if (Array.isArray(response?.data)) {
+ if (!response) {
+ return [];
+ }
+ if (Array.isArray(response.data)) {
return response.data;
}
- if (Array.isArray(response?.data?.list)) {
+ if (response.data && Array.isArray(response.data.list)) {
return response.data.list;
}
- if (Array.isArray(response?.knowledge_bases)) {
+ if (Array.isArray(response.knowledge_bases)) {
return response.knowledge_bases;
}
return [];
}
+function buildViewModel() {
+ const messages = getMessages();
+ return {
+ texts: messages,
+ knowledgeTitle: messages.knowledgeTitle,
+ knowledgeSubtitle: messages.knowledgeSubtitle,
+ needsSettingsText: messages.needsSettings,
+ openSettingsText: messages.openSettings,
+ knowledgeBaseLabel: messages.knowledgeBase,
+ tapToSelectText: messages.tapToSelect,
+ refreshText: messages.refreshKnowledgeBases,
+ urlLabel: messages.urlLabel,
+ urlPlaceholder: messages.urlPlaceholder,
+ importUrlText: messages.importUrl
+ };
+}
+
Page({
data: {
+ texts: {},
+ knowledgeTitle: "WeKnora 知识库",
+ knowledgeSubtitle: "在微信中选择知识库,导入网页或提问。",
+ needsSettingsText: "请先配置 WeKnora API 地址和 API Key,再加载知识库。",
+ openSettingsText: "打开设置",
+ knowledgeBaseLabel: "知识库",
+ tapToSelectText: "点击选择",
+ refreshText: "刷新知识库列表",
+ urlLabel: "网页链接",
+ urlPlaceholder: "https://github.com/Tencent/WeKnora",
+ importUrlText: "导入链接",
+ displayKnowledgeBaseName: "点击选择",
importing: false,
knowledgeBases: [],
knowledgeBaseNames: [],
@@ -28,17 +61,54 @@ Page({
url: ""
},
+ applyI18n() {
+ const vm = buildViewModel();
+ const displayKnowledgeBaseName =
+ this.data.selectedKnowledgeBaseName || vm.tapToSelectText;
+ this.setData({
+ texts: vm.texts,
+ knowledgeTitle: vm.knowledgeTitle,
+ knowledgeSubtitle: vm.knowledgeSubtitle,
+ needsSettingsText: vm.needsSettingsText,
+ openSettingsText: vm.openSettingsText,
+ knowledgeBaseLabel: vm.knowledgeBaseLabel,
+ tapToSelectText: vm.tapToSelectText,
+ refreshText: vm.refreshText,
+ urlLabel: vm.urlLabel,
+ urlPlaceholder: vm.urlPlaceholder,
+ importUrlText: vm.importUrlText,
+ displayKnowledgeBaseName: displayKnowledgeBaseName
+ });
+ },
+
+ onLoad() {
+ this.applyI18n();
+ },
+
onShow() {
- const settings = getSettings();
- const needsSettings = !settings.baseUrl || !settings.apiKey;
- if (settings.selectedKnowledgeBaseId) {
- this.setData({ selectedKnowledgeBaseId: settings.selectedKnowledgeBaseId });
- }
- this.setData({ needsSettings });
- if (needsSettings) {
- return;
+ try {
+ applyTabBar();
+ applyNavTitle("navKnowledge");
+ this.applyI18n();
+
+ const settings = getSettings();
+ const needsSettings = !settings.baseUrl || !settings.apiKey;
+ const patch = { needsSettings };
+ if (settings.selectedKnowledgeBaseId) {
+ patch.selectedKnowledgeBaseId = settings.selectedKnowledgeBaseId;
+ }
+ this.setData(patch);
+
+ if (needsSettings) {
+ return;
+ }
+ this.loadKnowledgeBases();
+ } catch (error) {
+ this.setData({
+ needsSettings: true,
+ statusMessage: (error && error.message) || "page init failed"
+ });
}
- this.loadKnowledgeBases();
},
onUrlInput(event) {
@@ -62,7 +132,8 @@ Page({
this.setData({
selectedIndex,
selectedKnowledgeBaseId: selected.id,
- selectedKnowledgeBaseName: selected.name
+ selectedKnowledgeBaseName: selected.name,
+ displayKnowledgeBaseName: selected.name || this.data.tapToSelectText
});
},
@@ -82,29 +153,33 @@ Page({
const response = await listKnowledgeBases();
const knowledgeBases = normalizeKnowledgeBases(response);
const knowledgeBaseNames = knowledgeBases.map((item) => item.name || item.id);
- const settings = getSettings();
- const selectedIndex = Math.max(
- 0,
- knowledgeBases.findIndex((item) => item.id === settings.selectedKnowledgeBaseId)
+ const current = getSettings();
+ let selectedIndex = knowledgeBases.findIndex(
+ (item) => item.id === current.selectedKnowledgeBaseId
);
+ if (selectedIndex < 0) {
+ selectedIndex = 0;
+ }
const selected = knowledgeBases[selectedIndex];
+ const selectedName = (selected && selected.name) || "";
this.setData({
knowledgeBases,
knowledgeBaseNames,
selectedIndex,
- selectedKnowledgeBaseId: selected?.id || "",
- selectedKnowledgeBaseName: selected?.name || "",
+ selectedKnowledgeBaseId: (selected && selected.id) || "",
+ selectedKnowledgeBaseName: selectedName,
+ displayKnowledgeBaseName: selectedName || this.data.tapToSelectText,
statusMessage: knowledgeBases.length
- ? `Loaded ${knowledgeBases.length} knowledge bases.`
- : "No knowledge bases found."
+ ? t("loadedKnowledgeBases", { count: knowledgeBases.length })
+ : t("noKnowledgeBases")
});
- if (selected?.id) {
+ if (selected && selected.id) {
saveSettings({ selectedKnowledgeBaseId: selected.id });
}
} catch (error) {
wx.showModal({
- title: "Load failed",
- content: error.message,
+ title: t("loadFailed"),
+ content: (error && error.message) || "",
showCancel: false
});
} finally {
@@ -117,11 +192,11 @@ Page({
try {
await createKnowledgeFromURL(this.data.selectedKnowledgeBaseId, this.data.url.trim(), false);
this.setData({ url: "" });
- wx.showToast({ title: "Imported", icon: "success" });
+ wx.showToast({ title: t("imported"), icon: "success" });
} catch (error) {
wx.showModal({
- title: "Import failed",
- content: error.message,
+ title: t("importFailed"),
+ content: (error && error.message) || "",
showCancel: false
});
} finally {
diff --git a/miniprogram/pages/index/index.json b/miniprogram/pages/index/index.json
index 864a09073..7557a438e 100644
--- a/miniprogram/pages/index/index.json
+++ b/miniprogram/pages/index/index.json
@@ -1,3 +1,3 @@
{
- "navigationBarTitleText": "Knowledge"
+ "navigationBarTitleText": "知识库"
}
diff --git a/miniprogram/pages/index/index.wxml b/miniprogram/pages/index/index.wxml
index 8fe264760..1bf53ff9b 100644
--- a/miniprogram/pages/index/index.wxml
+++ b/miniprogram/pages/index/index.wxml
@@ -1,19 +1,19 @@
<view class="page">
<view class="card hero">
- <view class="title">WeKnora Knowledge</view>
- <view class="muted">Import a web page into a selected knowledge base from WeChat.</view>
+ <view class="title">{{knowledgeTitle}}</view>
+ <view class="muted">{{knowledgeSubtitle}}</view>
</view>
<view class="card section">
<view wx:if="{{needsSettings}}" class="notice">
- Configure the WeKnora API base URL and API key before loading knowledge bases.
- <button bindtap="openSettings" class="secondary">Open Settings</button>
+ <view>{{needsSettingsText}}</view>
+ <button bindtap="openSettings" class="secondary">{{openSettingsText}}</button>
</view>
<view class="field">
- <text class="label">Knowledge Base</text>
+ <text class="label">{{knowledgeBaseLabel}}</text>
<picker range="{{knowledgeBaseNames}}" value="{{selectedIndex}}" bindchange="onKnowledgeBaseChange">
- <view class="picker-value">{{selectedKnowledgeBaseName || "Tap to select"}}</view>
+ <view class="picker-value">{{displayKnowledgeBaseName}}</view>
</picker>
<view wx:if="{{statusMessage}}" class="status-message">{{statusMessage}}</view>
<view wx:if="{{knowledgeBaseNames.length}}" class="knowledge-list">
@@ -29,15 +29,15 @@
</view>
</view>
- <button bindtap="loadKnowledgeBases" loading="{{loading}}">Refresh knowledge bases</button>
+ <button bindtap="loadKnowledgeBases" loading="{{loading}}">{{refreshText}}</button>
</view>
<view class="card section">
<view class="field">
- <text class="label">URL</text>
- <input value="{{url}}" placeholder="https://github.com/Tencent/WeKnora" bindinput="onUrlInput" />
+ <text class="label">{{urlLabel}}</text>
+ <input value="{{url}}" placeholder="{{urlPlaceholder}}" bindinput="onUrlInput" />
</view>
- <button bindtap="importURL" loading="{{importing}}" disabled="{{!selectedKnowledgeBaseId || !url}}">Import URL</button>
+ <button bindtap="importURL" loading="{{importing}}" disabled="{{!selectedKnowledgeBaseId || !url}}">{{importUrlText}}</button>
</view>
</view>
diff --git a/miniprogram/pages/settings/settings.js b/miniprogram/pages/settings/settings.js
index 85543bd72..a999db7a7 100644
--- a/miniprogram/pages/settings/settings.js
+++ b/miniprogram/pages/settings/settings.js
@@ -1,17 +1,81 @@
const { getSettings, saveSettings } = require("../../utils/config");
+const { applyNavTitle, applyTabBar, getLocale, getMessages, setLocale, t } = require("../../utils/i18n");
+
+const LANGUAGE_VALUES = ["zh", "en"];
+
+function buildViewModel(locale, languageIndex) {
+ const messages = getMessages(locale);
+ const languageLabels = [messages.languageZh, messages.languageEn];
+ return {
+ settingsTitle: messages.settingsTitle,
+ settingsSubtitle: messages.settingsSubtitle,
+ apiBaseUrlLabel: messages.apiBaseUrl,
+ apiBaseUrlPlaceholder: messages.apiBaseUrlPlaceholder,
+ apiKeyLabel: messages.apiKey,
+ apiKeyPlaceholder: messages.apiKeyPlaceholder,
+ languageLabel: messages.language,
+ saveSettingsText: messages.saveSettings,
+ languageLabels,
+ displayLanguageLabel: languageLabels[languageIndex] || languageLabels[0]
+ };
+}
Page({
data: {
+ settingsTitle: "连接 WeKnora",
+ settingsSubtitle: "填写 WeKnora API 地址与租户 API Key。",
+ apiBaseUrlLabel: "API 地址",
+ apiBaseUrlPlaceholder: "https://your-weknora.example.com",
+ apiKeyLabel: "API Key",
+ apiKeyPlaceholder: "sk-...",
+ languageLabel: "界面语言",
+ saveSettingsText: "保存设置",
+ displayLanguageLabel: "中文",
baseUrl: "",
- apiKey: ""
+ apiKey: "",
+ languageIndex: 0,
+ languageLabels: ["中文", "English"]
},
- onShow() {
- const settings = getSettings();
+ refreshI18n() {
+ const locale = getLocale();
+ let languageIndex = LANGUAGE_VALUES.indexOf(locale);
+ if (languageIndex < 0) {
+ languageIndex = 0;
+ }
+ const vm = buildViewModel(locale, languageIndex);
this.setData({
- baseUrl: settings.baseUrl,
- apiKey: settings.apiKey
+ settingsTitle: vm.settingsTitle,
+ settingsSubtitle: vm.settingsSubtitle,
+ apiBaseUrlLabel: vm.apiBaseUrlLabel,
+ apiBaseUrlPlaceholder: vm.apiBaseUrlPlaceholder,
+ apiKeyLabel: vm.apiKeyLabel,
+ apiKeyPlaceholder: vm.apiKeyPlaceholder,
+ languageLabel: vm.languageLabel,
+ saveSettingsText: vm.saveSettingsText,
+ languageLabels: vm.languageLabels,
+ displayLanguageLabel: vm.displayLanguageLabel,
+ languageIndex: languageIndex
});
+ applyTabBar(locale);
+ applyNavTitle("navSettings", locale);
+ },
+
+ onLoad() {
+ this.refreshI18n();
+ },
+
+ onShow() {
+ try {
+ const settings = getSettings();
+ this.setData({
+ baseUrl: settings.baseUrl,
+ apiKey: settings.apiKey
+ });
+ this.refreshI18n();
+ } catch (error) {
+ // keep fallback Chinese copy
+ }
},
onBaseUrlInput(event) {
@@ -22,11 +86,21 @@ Page({
this.setData({ apiKey: event.detail.value });
},
+ onLanguageChange(event) {
+ const languageIndex = Number(event.detail.value);
+ const locale = LANGUAGE_VALUES[languageIndex] || "zh";
+ setLocale(locale);
+ this.setData({ languageIndex });
+ this.refreshI18n();
+ },
+
save() {
saveSettings({
baseUrl: this.data.baseUrl,
- apiKey: this.data.apiKey
+ apiKey: this.data.apiKey,
+ locale: LANGUAGE_VALUES[this.data.languageIndex] || getLocale()
});
- wx.showToast({ title: "Saved", icon: "success" });
+ this.refreshI18n();
+ wx.showToast({ title: t("saved"), icon: "success" });
}
});
diff --git a/miniprogram/pages/settings/settings.json b/miniprogram/pages/settings/settings.json
index 22c6fe6d4..9df2bdf86 100644
--- a/miniprogram/pages/settings/settings.json
+++ b/miniprogram/pages/settings/settings.json
@@ -1,3 +1,3 @@
{
- "navigationBarTitleText": "Settings"
+ "navigationBarTitleText": "设置"
}
diff --git a/miniprogram/pages/settings/settings.wxml b/miniprogram/pages/settings/settings.wxml
index 3e3784de7..72cba3313 100644
--- a/miniprogram/pages/settings/settings.wxml
+++ b/miniprogram/pages/settings/settings.wxml
@@ -1,18 +1,25 @@
<view class="page">
<view class="card">
- <view class="title">Connect WeKnora</view>
- <view class="muted">Use your WeKnora API endpoint and tenant API key.</view>
+ <view class="title">{{settingsTitle}}</view>
+ <view class="muted">{{settingsSubtitle}}</view>
<view class="field">
- <text class="label">API Base URL</text>
- <input value="{{baseUrl}}" placeholder="https://your-weknora.example.com" bindinput="onBaseUrlInput" />
+ <text class="label">{{apiBaseUrlLabel}}</text>
+ <input value="{{baseUrl}}" placeholder="{{apiBaseUrlPlaceholder}}" bindinput="onBaseUrlInput" />
</view>
<view class="field">
- <text class="label">API Key</text>
- <input value="{{apiKey}}" password placeholder="sk-..." bindinput="onApiKeyInput" />
+ <text class="label">{{apiKeyLabel}}</text>
+ <input value="{{apiKey}}" password placeholder="{{apiKeyPlaceholder}}" bindinput="onApiKeyInput" />
</view>
- <button bindtap="save">Save settings</button>
+ <view class="field">
+ <text class="label">{{languageLabel}}</text>
+ <picker range="{{languageLabels}}" value="{{languageIndex}}" bindchange="onLanguageChange">
+ <view class="picker-value">{{displayLanguageLabel}}</view>
+ </picker>
+ </view>
+
+ <button bindtap="save">{{saveSettingsText}}</button>
</view>
</view>
diff --git a/miniprogram/project.config.json b/miniprogram/project.config.json
index ae20a2954..3591f5904 100644
--- a/miniprogram/project.config.json
+++ b/miniprogram/project.config.json
@@ -1,14 +1,39 @@
{
- "description": "WeKnora Mini Program plugin",
- "setting": {
- "urlCheck": true,
- "es6": true,
- "enhance": true,
- "postcss": true,
- "minified": true
- },
- "compileType": "miniprogram",
- "libVersion": "latest",
- "projectname": "WeKnora Mini Program",
- "condition": {}
-}
+ "description": "WeKnora Mini Program plugin",
+ "setting": {
+ "urlCheck": true,
+ "es6": true,
+ "enhance": true,
+ "postcss": true,
+ "minified": true,
+ "compileWorklet": false,
+ "uglifyFileName": false,
+ "uploadWithSourceMap": true,
+ "packNpmManually": false,
+ "packNpmRelationList": [],
+ "minifyWXSS": true,
+ "minifyWXML": true,
+ "localPlugins": false,
+ "disableUseStrict": false,
+ "useCompilerPlugins": false,
+ "condition": false,
+ "swc": false,
+ "disableSWC": true,
+ "babelSetting": {
+ "ignore": [],
+ "disablePlugins": [],
+ "outputPath": ""
+ }
+ },
+ "compileType": "miniprogram",
+ "libVersion": "latest",
+ "projectname": "WeKnora Mini Program",
+ "condition": {},
+ "appid": "wxbaf7dc10724effab",
+ "simulatorPluginLibVersion": {},
+ "packOptions": {
+ "ignore": [],
+ "include": []
+ },
+ "editorSetting": {}
+}
\ No newline at end of file
diff --git a/miniprogram/utils/config.js b/miniprogram/utils/config.js
index 7bd5c03fd..d67ac3bb7 100644
--- a/miniprogram/utils/config.js
+++ b/miniprogram/utils/config.js
@@ -8,21 +8,38 @@ function normalizeBaseUrl(baseUrl) {
return baseUrl.trim().replace(/\/+$/, "");
}
+function normalizeLocale(locale) {
+ return locale === "en" ? "en" : "zh";
+}
+
function getSettings() {
const stored = wx.getStorageSync(STORAGE_KEY) || {};
return {
baseUrl: normalizeBaseUrl(stored.baseUrl || ""),
apiKey: stored.apiKey || "",
- selectedKnowledgeBaseId: stored.selectedKnowledgeBaseId || ""
+ selectedKnowledgeBaseId: stored.selectedKnowledgeBaseId || "",
+ locale: normalizeLocale(stored.locale || "zh")
};
}
function saveSettings(settings) {
const current = getSettings();
+ const nextBaseUrl =
+ settings.baseUrl !== undefined && settings.baseUrl !== null
+ ? settings.baseUrl
+ : current.baseUrl;
+ const nextLocale =
+ settings.locale !== undefined && settings.locale !== null
+ ? settings.locale
+ : current.locale;
const next = {
- ...current,
- ...settings,
- baseUrl: normalizeBaseUrl(settings.baseUrl ?? current.baseUrl)
+ baseUrl: normalizeBaseUrl(nextBaseUrl),
+ apiKey: settings.apiKey !== undefined ? settings.apiKey : current.apiKey,
+ selectedKnowledgeBaseId:
+ settings.selectedKnowledgeBaseId !== undefined
+ ? settings.selectedKnowledgeBaseId
+ : current.selectedKnowledgeBaseId,
+ locale: normalizeLocale(nextLocale)
};
wx.setStorageSync(STORAGE_KEY, next);
return next;
@@ -32,5 +49,6 @@ module.exports = {
STORAGE_KEY,
getSettings,
normalizeBaseUrl,
+ normalizeLocale,
saveSettings
};
diff --git a/miniprogram/utils/i18n.js b/miniprogram/utils/i18n.js
new file mode 100644
index 000000000..a5639b0f1
--- /dev/null
+++ b/miniprogram/utils/i18n.js
@@ -0,0 +1,169 @@
+const { getSettings, saveSettings } = require("./config");
+
+const MESSAGES = {
+ zh: {
+ tabKnowledge: "知识库",
+ tabChat: "问答",
+ tabSettings: "设置",
+ navKnowledge: "知识库",
+ navChat: "问答",
+ navSettings: "设置",
+ knowledgeTitle: "WeKnora 知识库",
+ knowledgeSubtitle: "在微信中选择知识库,导入网页或提问。",
+ needsSettings: "请先配置 WeKnora API 地址和 API Key,再加载知识库。",
+ openSettings: "打开设置",
+ knowledgeBase: "知识库",
+ tapToSelect: "点击选择",
+ refreshKnowledgeBases: "刷新知识库列表",
+ urlLabel: "网页链接",
+ urlPlaceholder: "https://github.com/Tencent/WeKnora",
+ importUrl: "导入链接",
+ loadedKnowledgeBases: "已加载 {count} 个知识库。",
+ noKnowledgeBases: "未找到知识库。",
+ loadFailed: "加载失败",
+ imported: "导入成功",
+ importFailed: "导入失败",
+ chatTitle: "知识问答",
+ chatSubtitle: "向当前选中的 WeKnora 知识库提问。",
+ question: "问题",
+ questionPlaceholder: "输入你的问题…",
+ askWeKnora: "向 WeKnora 提问",
+ answer: "回答",
+ chatFailed: "问答失败",
+ sessionIdMissing: "会话接口未返回 session id。",
+ settingsTitle: "连接 WeKnora",
+ settingsSubtitle: "填写 WeKnora API 地址与租户 API Key。",
+ apiBaseUrl: "API 地址",
+ apiBaseUrlPlaceholder: "https://your-weknora.example.com",
+ apiKey: "API Key",
+ apiKeyPlaceholder: "sk-...",
+ language: "界面语言",
+ languageZh: "中文",
+ languageEn: "English",
+ saveSettings: "保存设置",
+ saved: "已保存",
+ missingBaseUrl: "请先配置 WeKnora API 地址。",
+ missingApiKey: "请先配置 WeKnora API Key。"
+ },
+ en: {
+ tabKnowledge: "Knowledge",
+ tabChat: "Chat",
+ tabSettings: "Settings",
+ navKnowledge: "Knowledge",
+ navChat: "Chat",
+ navSettings: "Settings",
+ knowledgeTitle: "WeKnora Knowledge",
+ knowledgeSubtitle: "Import a web page into a selected knowledge base from WeChat.",
+ needsSettings: "Configure the WeKnora API base URL and API key before loading knowledge bases.",
+ openSettings: "Open Settings",
+ knowledgeBase: "Knowledge Base",
+ tapToSelect: "Tap to select",
+ refreshKnowledgeBases: "Refresh knowledge bases",
+ urlLabel: "URL",
+ urlPlaceholder: "https://github.com/Tencent/WeKnora",
+ importUrl: "Import URL",
+ loadedKnowledgeBases: "Loaded {count} knowledge bases.",
+ noKnowledgeBases: "No knowledge bases found.",
+ loadFailed: "Load failed",
+ imported: "Imported",
+ importFailed: "Import failed",
+ chatTitle: "Knowledge Chat",
+ chatSubtitle: "Ask the selected WeKnora knowledge base.",
+ question: "Question",
+ questionPlaceholder: "Ask something...",
+ askWeKnora: "Ask WeKnora",
+ answer: "Answer",
+ chatFailed: "Chat failed",
+ sessionIdMissing: "The session API did not return a session id.",
+ settingsTitle: "Connect WeKnora",
+ settingsSubtitle: "Use your WeKnora API endpoint and tenant API key.",
+ apiBaseUrl: "API Base URL",
+ apiBaseUrlPlaceholder: "https://your-weknora.example.com",
+ apiKey: "API Key",
+ apiKeyPlaceholder: "sk-...",
+ language: "Language",
+ languageZh: "中文",
+ languageEn: "English",
+ saveSettings: "Save settings",
+ saved: "Saved",
+ missingBaseUrl: "Please configure the WeKnora API base URL first.",
+ missingApiKey: "Please configure the WeKnora API key first."
+ }
+};
+
+function normalizeLocale(locale) {
+ return locale === "en" ? "en" : "zh";
+}
+
+function getLocale() {
+ return normalizeLocale(getSettings().locale);
+}
+
+function setLocale(locale) {
+ const next = normalizeLocale(locale);
+ saveSettings({ locale: next });
+ return next;
+}
+
+function t(key, vars = {}, locale = getLocale()) {
+ const table = MESSAGES[normalizeLocale(locale)] || MESSAGES.zh;
+ let text = table[key] || MESSAGES.en[key] || key;
+ Object.keys(vars).forEach((name) => {
+ text = text.replace(new RegExp(`\\{${name}\\}`, "g"), String(vars[name]));
+ });
+ return text;
+}
+
+function getMessages(locale = getLocale()) {
+ return MESSAGES[normalizeLocale(locale)] || MESSAGES.zh;
+}
+
+function applyTabBar(locale = getLocale()) {
+ const lang = normalizeLocale(locale);
+ const items = [
+ {
+ index: 0,
+ text: t("tabKnowledge", {}, lang),
+ iconPath: "assets/tab/knowledge.png",
+ selectedIconPath: "assets/tab/knowledge-active.png"
+ },
+ {
+ index: 1,
+ text: t("tabChat", {}, lang),
+ iconPath: "assets/tab/chat.png",
+ selectedIconPath: "assets/tab/chat-active.png"
+ },
+ {
+ index: 2,
+ text: t("tabSettings", {}, lang),
+ iconPath: "assets/tab/settings.png",
+ selectedIconPath: "assets/tab/settings-active.png"
+ }
+ ];
+ items.forEach((item) => {
+ try {
+ wx.setTabBarItem(item);
+ } catch (error) {
+ // ignore when called outside tab page context
+ }
+ });
+}
+
+function applyNavTitle(key, locale = getLocale()) {
+ try {
+ wx.setNavigationBarTitle({ title: t(key, {}, locale) });
+ } catch (error) {
+ // ignore in non-page contexts
+ }
+}
+
+module.exports = {
+ MESSAGES,
+ applyNavTitle,
+ applyTabBar,
+ getLocale,
+ getMessages,
+ normalizeLocale,
+ setLocale,
+ t
+};
diff --git a/miniprogram/utils/request.js b/miniprogram/utils/request.js
index b53ef96f3..67e6d69ae 100644
--- a/miniprogram/utils/request.js
+++ b/miniprogram/utils/request.js
@@ -1,12 +1,13 @@
const { getSettings } = require("./config");
+const { t } = require("./i18n");
function request(path, options = {}) {
const settings = getSettings();
if (!settings.baseUrl) {
- return Promise.reject(new Error("Please configure the WeKnora API base URL first."));
+ return Promise.reject(new Error(t("missingBaseUrl")));
}
if (!settings.apiKey) {
- return Promise.reject(new Error("Please configure the WeKnora API key first."));
+ return Promise.reject(new Error(t("missingApiKey")));
}
return new Promise((resolve, reject) => {
@@ -24,7 +25,9 @@ function request(path, options = {}) {
resolve(response.data);
return;
}
- const message = response.data?.error?.message || response.data?.message || `HTTP ${response.statusCode}`;
+ const data = response.data || {};
+ const errorObj = data.error || {};
+ const message = errorObj.message || data.message || `HTTP ${response.statusCode}`;
reject(new Error(message));
},
fail(error) {
diff --git a/tests/miniprogram/miniprogram.test.js b/tests/miniprogram/miniprogram.test.js
index 4c61657f8..7d38d82ee 100644
--- a/tests/miniprogram/miniprogram.test.js
+++ b/tests/miniprogram/miniprogram.test.js
@@ -3,6 +3,23 @@ const test = require("node:test");
const { createKnowledgeFromURL, knowledgeChat, listKnowledgeBases } = require("../../miniprogram/utils/request");
const { collectAnswerFromSSE, parseSSE } = require("../../miniprogram/utils/sse");
const { normalizeBaseUrl } = require("../../miniprogram/utils/config");
+const { getLocale, normalizeLocale, t } = require("../../miniprogram/utils/i18n");
+
+function mockWx(overrides = {}) {
+ return {
+ getStorageSync() {
+ return {};
+ },
+ setStorageSync() {},
+ setTabBarItem() {},
+ setNavigationBarTitle() {},
+ showToast() {},
+ showModal() {},
+ switchTab() {},
+ request() {},
+ ...overrides
+ };
+}
test("parseSSE extracts event payloads", () => {
const events = parseSSE('event: message\ndata: {"content":"hi"}\n\n');
@@ -26,6 +43,30 @@ test("normalizeBaseUrl trims trailing slashes", () => {
assert.equal(normalizeBaseUrl(" https://example.com/// "), "https://example.com");
});
+test("i18n defaults to Chinese and supports English", () => {
+ assert.equal(normalizeLocale("zh"), "zh");
+ assert.equal(normalizeLocale("en"), "en");
+ assert.equal(normalizeLocale("fr"), "zh");
+ assert.equal(t("tabKnowledge", {}, "zh"), "知识库");
+ assert.equal(t("tabKnowledge", {}, "en"), "Knowledge");
+ assert.equal(t("loadedKnowledgeBases", { count: 2 }, "zh"), "已加载 2 个知识库。");
+ assert.equal(t("loadedKnowledgeBases", { count: 2 }, "en"), "Loaded 2 knowledge bases.");
+});
+
+test("getLocale reads stored language preference", () => {
+ const originalWx = global.wx;
+ try {
+ global.wx = mockWx({
+ getStorageSync() {
+ return { locale: "en" };
+ }
+ });
+ assert.equal(getLocale(), "en");
+ } finally {
+ global.wx = originalWx;
+ }
+});
+
test("API helpers send WeKnora auth headers", async () => {
let capturedRequest;
global.wx = {
@@ -123,16 +164,17 @@ test("knowledge page skips API loading until settings are configured", async ()
global.Page = (definition) => {
pageDefinitions.push(definition);
};
- global.wx = {
+ global.wx = mockWx({
getStorageSync() {
return {};
},
request() {
calls.push("request");
- },
- switchTab() {}
- };
+ }
+ });
+ delete require.cache[require.resolve("../../miniprogram/utils/i18n.js")];
+ delete require.cache[require.resolve("../../miniprogram/utils/config.js")];
delete require.cache[require.resolve("../../miniprogram/pages/index/index.js")];
require("../../miniprogram/pages/index/index.js");
const page = {
@@ -145,6 +187,7 @@ test("knowledge page skips API loading until settings are configured", async ()
await pageDefinitions[0].onShow.call(page);
assert.equal(page.data.needsSettings, true);
+ assert.equal(page.data.knowledgeTitle, "WeKnora 知识库");
assert.deepEqual(calls, []);
} finally {
global.Page = originalPage;
@@ -162,11 +205,12 @@ test("knowledge page maps API results to picker labels", async () => {
global.Page = (definition) => {
pageDefinitions.push(definition);
};
- global.wx = {
+ global.wx = mockWx({
getStorageSync() {
return {
apiKey: "sk-test",
- baseUrl: "https://weknora.example.com"
+ baseUrl: "https://weknora.example.com",
+ locale: "en"
};
},
request(options) {
@@ -182,10 +226,11 @@ test("knowledge page maps API results to picker labels", async () => {
},
setStorageSync(key, value) {
savedSettings = { key, value };
- },
- switchTab() {}
- };
+ }
+ });
+ delete require.cache[require.resolve("../../miniprogram/utils/i18n.js")];
+ delete require.cache[require.resolve("../../miniprogram/utils/config.js")];
delete require.cache[require.resolve("../../miniprogram/pages/index/index.js")];
require("../../miniprogram/pages/index/index.js");
const page = {
@@ -200,6 +245,7 @@ test("knowledge page maps API results to picker labels", async () => {
assert.deepEqual(page.data.knowledgeBaseNames, ["Compliance KB", "Docs KB"]);
assert.equal(page.data.selectedKnowledgeBaseId, "kb-1");
assert.equal(page.data.selectedKnowledgeBaseName, "Compliance KB");
+ assert.equal(page.data.statusMessage, "Loaded 2 knowledge bases.");
assert.equal(savedSettings.value.selectedKnowledgeBaseId, "kb-1");
} finally {
global.Page = originalPage;