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

Fix blank knowledge page caused by unsupported ?? / ?. syntax, flatten
i18n bindings for WXML, and add settings language switch with tests.

Co-authored-by: Cursor <cursoragent@cursor.com>
main
Haibing Ou 2026-09-03 18:14:55 +08:00 committed by lyingbug
parent 5b057af467
commit 7c4b5f1bfe
24 changed files with 589 additions and 107 deletions

View File

@ -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.

View File

@ -5,7 +5,8 @@ App({
wx.setStorageSync("weknora_settings", {
baseUrl: "http://localhost:8080",
apiKey: "",
selectedKnowledgeBaseId: ""
selectedKnowledgeBaseId: "",
locale: "zh"
});
}
}

View File

@ -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"
}
]
}

View File

@ -72,3 +72,9 @@ button {
button[disabled] {
background: #c5c5c5;
}
.picker-value {
display: flex;
align-items: center;
color: #1a1a1a;
}

Binary file not shown.

After

Width:  |  Height:  |  Size: 450 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 442 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 315 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 308 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 600 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 591 B

View File

@ -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 {

View File

@ -1,3 +1,3 @@
{
"navigationBarTitleText": "Chat"
"navigationBarTitleText": "问答"
}

View File

@ -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>

View File

@ -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 });
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.setData({ needsSettings });
if (needsSettings) {
return;
}
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 {

View File

@ -1,3 +1,3 @@
{
"navigationBarTitleText": "Knowledge"
"navigationBarTitleText": "知识库"
}

View File

@ -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>

View File

@ -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"]
},
refreshI18n() {
const locale = getLocale();
let languageIndex = LANGUAGE_VALUES.indexOf(locale);
if (languageIndex < 0) {
languageIndex = 0;
}
const vm = buildViewModel(locale, languageIndex);
this.setData({
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() {
const settings = getSettings();
this.setData({
baseUrl: settings.baseUrl,
apiKey: settings.apiKey
});
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" });
}
});

View File

@ -1,3 +1,3 @@
{
"navigationBarTitleText": "Settings"
"navigationBarTitleText": "设置"
}

View File

@ -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>

View File

@ -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": {}
}

View File

@ -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
};

View File

@ -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
};

View File

@ -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) {

View File

@ -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;