修复 Edge 商店简体中文语言识别 (#4)

Author: aredddd

CHANGELOG.md

@@ -1,5 +1,12 @@
 # 更新日志
 
+## [3.0.1] - 2026-09-29
+
+### 修复
+
+- 补充简体中文语言声明，使 Edge 商店正确识别扩展语言并提供中文介绍页。
+- 打包流程纳入语言文件，检查缺失的语言消息引用。
+
 ## [3.0.0] - 2026-09-29
 
 ### 新增
@@ -29,3 +36,4 @@
 更早版本尚未整理为独立发行记录，历史改动见 [Git 提交记录](https://github.com/aredddd/GlassNote/commits/main/)。
 
 [3.0.0]: https://github.com/aredddd/GlassNote/releases/tag/v3.0.0
+[3.0.1]: https://github.com/aredddd/GlassNote/releases/tag/v3.0.1

PRIVACY.md

@@ -1,6 +1,6 @@
 # GlassNote 隐私说明
 
-更新日期：2026 年 9 月 29 日。适用于 GlassNote 3.0.0。
+更新日期：2026 年 9 月 29 日。适用于 GlassNote 3.0.1。
 
 GlassNote 是网页标注与笔记扩展。笔记保存在你使用的浏览器中；扩展没有账号系统、开发者服务器、广告或使用分析服务，不向开发者或第三方上传网页内容和笔记。
 

_locales/zh_CN/messages.json

@@ -0,0 +1,8 @@
+{
+  "extensionName": {
+    "message": "GlassNote"
+  },
+  "extensionDescription": {
+    "message": "轻盈的网页高亮与笔记工具。自动找回原文位置，本地保存，随时整理和导出。"
+  }
+}

docs/EDGE_STORE.md

@@ -1,6 +1,6 @@
 # Edge 商店发布材料
 
-对应版本：3.0.0。此文件是提交材料，不代表已经提交审核或已经上架。
+对应版本：3.0.1。此文件是提交材料，不代表已经提交审核或已经上架。
 
 ## 商店字段
 
@@ -57,7 +57,7 @@ GlassNote 用于在网页中标注文字、记录笔记，并在以后打开同
 
 ## 资源规格与官方入口
 
-安装包位于 dist/GlassNote-v3.0.0.zip；商店图标可用 assets/icon-128.png。截图使用扩展实际运行界面，尺寸为 1280 × 800，不放入用户的私人笔记或第三方宣传素材。
+安装包位于 dist/GlassNote-v3.0.1.zip；商店图标可用 assets/icon-128.png。截图使用扩展实际运行界面，尺寸为 1280 × 800，不放入用户的私人笔记或第三方宣传素材。
 
 - [Edge 开发者注册](https://learn.microsoft.com/en-us/microsoft-edge/extensions/publish/create-dev-account)
 - [Edge 扩展发布说明](https://learn.microsoft.com/en-us/microsoft-edge/extensions/publish/publish-extension)

manifest.json

@@ -1,9 +1,10 @@
 {
   "manifest_version": 3,
-  "name": "GlassNote",
-  "version": "3.0.0",
+  "name": "__MSG_extensionName__",
+  "version": "3.0.1",
+  "default_locale": "zh_CN",
   "minimum_chrome_version": "105",
-  "description": "轻盈的网页高亮与笔记工具。自动找回原文位置，本地保存，随时整理和导出。",
+  "description": "__MSG_extensionDescription__",
   "permissions": ["activeTab", "storage", "scripting"],
   "background": { "service_worker": "src/background/background.js" },
   "options_page": "src/library/library.html",

package-lock.json

@@ -1,15 +1,15 @@
 {
   "name": "glassnote",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "private": true,
   "description": "轻盈、可靠的本地网页笔记工具",
   "scripts": {
     "test": "node --test tests/*.test.cjs",
     "test:e2e": "node --test tests/extension.e2e.cjs",
     "test:live": "node tests/live-site.cjs",
     "check": "node scripts/check.cjs",
-    "format": "prettier --write src styles scripts tests .github docs manifest.json package.json package-lock.json \"*.md\"",
-    "format:check": "prettier --check src styles scripts tests .github docs manifest.json package.json package-lock.json \"*.md\"",
+    "format": "prettier --write src styles _locales scripts tests .github docs manifest.json package.json package-lock.json \"*.md\"",
+    "format:check": "prettier --check src styles _locales scripts tests .github docs manifest.json package.json package-lock.json \"*.md\"",
     "package": "node scripts/package.cjs",
     "package:verify": "node scripts/verify-package.cjs"
   },

package.json

@@ -12,6 +12,30 @@ function walk(directory) {
 }
 walk(path.join(root, 'src'));
 const manifest = JSON.parse(fs.readFileSync(path.join(root, 'manifest.json'), 'utf8'));
+const localeReferences = [...JSON.stringify(manifest).matchAll(/__MSG_([A-Za-z0-9_]+)__/g)].map(
+  (match) => match[1],
+);
+const localeRoot = path.join(root, '_locales');
+if ((localeReferences.length || fs.existsSync(localeRoot)) && !manifest.default_locale)
+  throw new Error('使用语言包时必须声明 default_locale');
+if (manifest.default_locale) {
+  if (!/^[A-Za-z0-9_]+$/.test(manifest.default_locale))
+    throw new Error('default_locale 必须是合法的语言目录名');
+  const messagesPath = path.join(localeRoot, manifest.default_locale, 'messages.json');
+  if (!fs.existsSync(messagesPath)) throw new Error('缺少默认语言包：' + messagesPath);
+  const messages = JSON.parse(fs.readFileSync(messagesPath, 'utf8'));
+  if (!messages || typeof messages !== 'object' || Array.isArray(messages))
+    throw new Error('语言包必须是消息名称到消息内容的对象');
+  const normalizedMessages = new Map();
+  for (const [key, value] of Object.entries(messages)) {
+    if (!value || typeof value.message !== 'string' || !value.message.trim())
+      throw new Error('语言包消息内容不能为空：' + key);
+    normalizedMessages.set(key.toLowerCase(), value.message);
+  }
+  for (const key of localeReferences)
+    if (!normalizedMessages.has(key.toLowerCase()))
+      throw new Error('默认语言包缺少 manifest 引用的消息：' + key);
+}
 const files = [
   manifest.background.service_worker,
   manifest.action.default_popup,
@@ -31,4 +55,4 @@ for (const [size, file] of Object.entries(manifest.icons)) {
   )
     throw new Error('扩展图标必须是正确尺寸的 PNG：' + file);
 }
-console.log('JavaScript 语法和扩展入口检查通过。');
+console.log('JavaScript 语法、扩展入口和语言包检查通过。');

scripts/check.cjs

@@ -13,6 +13,7 @@ const REQUIRED_FILES = [
   'SECURITY.md',
 ];
 const TREES = {
+  _locales: /\.json$/,
   src: /\.(js|html|css)$/,
   styles: /\.css$/,
   assets: /\.(png|svg|ico|webp)$/,

scripts/package-lib.cjs

@@ -98,6 +98,20 @@ after(async () => {
   fs.rmSync(profile, { recursive: true, force: true });
 });
 
+test('真实扩展：默认简体中文语言资源可解析', async () => {
+  const localized = await worker.evaluate(() => ({
+    name: chrome.runtime.getManifest().name,
+    description: chrome.runtime.getManifest().description,
+    message: chrome.i18n.getMessage('extensionDescription'),
+  }));
+  assert.equal(localized.name, 'GlassNote');
+  assert.equal(
+    localized.description,
+    '轻盈的网页高亮与笔记工具。自动找回原文位置，本地保存，随时整理和导出。',
+  );
+  assert.equal(localized.message, localized.description);
+});
+
 test('真实扩展：跨节点标注不破坏链接，隐藏保留原文，刷新和关页重开恢复', async () => {
   await openArticle();
   const beforeHTML = await page.locator('#linked').innerHTML();