@evan_zhong/browser-attach 0.23.3 → 0.23.4

package/CONTRIBUTING.md

@@ -15,7 +15,9 @@ npm pack --dry-run
 
 浏览器交互改动还应按 [README](README.md#本地开发) 运行真实浏览器 fixture 测试。测试必须使用可丢弃的页面和配置，不应修改真实账号数据。
 
-修改版本时同步 `package.json`、`package-lock.json`、`src/config.mjs`、`extension/manifest.json`、MCP 配置及安装示例。扩展和 Hub 必须保持版本一致。
+修改版本时同步 `package.json`、`package-lock.json`、`src/config.mjs`、`extension/manifest.json`、`server.json`、MCP 配置及安装示例。扩展和 Hub 必须保持版本一致。
+
+`server.json` 用于发布 MCP 官方 Registry 元数据；其中 `name` 与 `package.json.mcpName` 必须完全一致，`packages[0].identifier` 与 npm 包名一致，包版本填写准确版本。先发布包含 `mcpName` 的 npm 包，再执行 `mcp-publisher login github` 和 `mcp-publisher publish`。`npm run test:package` 会检查名称、版本和发布文件的一致性。
 
 ## 提交内容
 

package/docs/ARCHITECTURE.md

@@ -1,6 +1,6 @@
 # 架构与设计边界
 
-当前实现为 **0.23.3**。本文说明 BrowserAttach 的组件、控制模型与设计取舍；工具参数见 [使用指南](USAGE.md)。
+当前实现为 **0.23.4**。本文说明 BrowserAttach 的组件、控制模型与设计取舍；工具参数见 [使用指南](USAGE.md)。
 
 ## 组件与数据流
 

package/docs/TEST-REPORT.md

@@ -1,9 +1,17 @@
 # 验证报告
 
-当前版本 **0.23.3**（2026-10-25）。浏览器验证使用本地 fixture 和临时 profile；测试链路在各项下说明。
+当前版本 **0.23.4**（2026-10-25）。浏览器验证使用本地 fixture 和临时 profile；测试链路在各项下说明。
 
 ## 当前版本
 
+- 补充 npm 包的 `mcpName` 和根目录 `server.json`，包含 Registry 名称、展示名称、描述、源码/文档链接及 npm stdio 启动信息；元数据通过官方 2025-12-11 JSON Schema 校验。
+- `npm test`：282 项通过。仅调整发布元数据、版本与打包检查，未修改页面操作实现，未重复运行真实浏览器 fixture 测试。
+- `npm run test:package`：包外安装与 stdio MCP 通过，23 个工具、62 个发布文件，无配对密钥。`server.json` 已纳入发布包；打包检查覆盖 Registry 名称、npm 包名及版本一致性。
+- 本机部署：协调升级因现有 MCP 连接占用拒绝后，通过 stop/start 重启；Hub 为 0.23.4 / ready，Chrome、Edge 扩展均为 0.23.4。稳定扩展副本的 43 个文件已核对：manifest 版本/身份一致，其余非生成文件 SHA-256 一致。现有客户端需重连并重新发现、接管。
+- 尚未执行 npm 或 MCP Registry 发布；正式注册需先发布包含 `mcpName` 的 npm 0.23.4，再以对应 GitHub 命名空间登录并发布 Registry 元数据。
+
+## 0.23.3 验证
+
 - `npm test`：282 项通过。DOM contenteditable 与 native 共用同位置普通空格 → NBSP 的单向容差；补充首尾/连续空格、混合空格、显式 NBSP 保留与丢失、空格数量及位置变化的回归。input/textarea 的精确 value 比较保持原状。
 - Chromium 156、Edge 155 headless 完整 stdio MCP `live-smoke`：各 385 次调用、35 项检查通过。页面同步将普通空格改成 NBSP 时 DOM fill 成功；CSS 折叠空格或页面丢失显式 NBSP 时仍返回 value_not_retained、未知结果，每次仅派发 1 次 input，不重放。
 - `npm run test:package`：包外安装与 stdio MCP 通过，23 个工具、61 个发布文件，无配对密钥。未增加工具、参数、依赖或权限，按比较修复递增至 0.23.3。

package/docs/USAGE.md

@@ -1,6 +1,6 @@
 # BrowserAttach 使用指南
 
-适用于 **0.23.3**：Node.js 22+、Chrome / Edge 125+、23 个 MCP 工具。安装、配对与升级见 [README](../README.md)，宿主配置见 [Agent 集成](AGENT-INTEGRATION.md)，内部机制见 [架构说明](ARCHITECTURE.md)。
+适用于 **0.23.4**：Node.js 22+、Chrome / Edge 125+、23 个 MCP 工具。安装、配对与升级见 [README](../README.md)，宿主配置见 [Agent 集成](AGENT-INTEGRATION.md)，内部机制见 [架构说明](ARCHITECTURE.md)。
 
 本文供按需查阅，不会自动通过 MCP 发送给 agent。MCP 初始化 `instructions` 提供通用规则，工具 description 与参数 schema 提供调用说明；宿主应把 instructions 纳入模型上下文。
 

package/extension/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "BrowserAttach",
-  "version": "0.23.3",
+  "version": "0.23.4",
   "description": "Connect existing Chrome and Edge tabs to a locally paired MCP client.",
   "minimum_chrome_version": "125",
   "permissions": [

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@evan_zhong/browser-attach",
-  "version": "0.23.3",
+  "version": "0.23.4",
+  "mcpName": "io.github.EvannZhongg/browser-attach",
   "description": "MCP for existing signed-in Chrome and Edge tabs through a locally paired extension",
   "type": "module",
   "license": "MIT",
@@ -25,7 +26,8 @@
     "README.md",
     "CONTRIBUTING.md",
     "docs/",
-    "mcp-config.json"
+    "mcp-config.json",
+    "server.json"
   ],
   "scripts": {
     "test": "node --test tests/*.test.mjs",

package/scripts/check-package.mjs

@@ -2,15 +2,21 @@ import { execFileSync } from 'node:child_process';
 import { readFile } from 'node:fs/promises';
 import { ROOT, VERSION } from '../src/config.mjs';
 
-for (const path of ['package.json', 'extension/manifest.json']) {
+for (const path of ['package.json', 'extension/manifest.json', 'server.json']) {
   if (JSON.parse(await readFile(new URL(`../${path}`, import.meta.url), 'utf8')).version !== VERSION) throw new Error(`Version mismatch: ${path}`);
 }
+const packageJson = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'));
+const serverJson = JSON.parse(await readFile(new URL('../server.json', import.meta.url), 'utf8'));
+if (!packageJson.mcpName || packageJson.mcpName !== serverJson.name) throw new Error('MCP Registry name mismatch');
+if (serverJson.packages[0].identifier !== packageJson.name || serverJson.packages[0].version !== VERSION)
+  throw new Error('MCP Registry package mismatch');
 
 const npm = process.platform === 'win32' ? 'npm.cmd' : 'npm';
 const result = JSON.parse(execFileSync(npm, ['pack', '--dry-run', '--ignore-scripts', '--json'], {
   cwd: ROOT, encoding: 'utf8', shell: process.platform === 'win32', stdio: ['ignore', 'pipe', 'pipe'],
 }))[0];
 const names = result.files.map(file => file.path);
+if (!names.includes('server.json')) throw new Error('Package is missing server.json');
 for (const path of names) {
   if (/config\.generated\.js|(^|\/)(\.local|\.venv|test-results|node_modules)\//.test(path)) throw new Error(`Private file included in package: ${path}`);
 }

package/server.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.EvannZhongg/browser-attach",
+  "title": "BrowserAttach",
+  "description": "Control existing signed-in Chrome and Edge tabs through a locally paired extension.",
+  "version": "0.23.4",
+  "repository": {
+    "url": "https://github.com/EvannZhongg/BrowserAttach",
+    "source": "github"
+  },
+  "websiteUrl": "https://github.com/EvannZhongg/BrowserAttach#readme",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@evan_zhong/browser-attach",
+      "version": "0.23.4",
+      "transport": {
+        "type": "stdio"
+      },
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "mcp"
+        }
+      ]
+    }
+  ]
+}

package/src/config.mjs

@@ -15,7 +15,7 @@ export const DATA_DIR = configuredHome
   : process.platform === 'win32' ? join(homedir(), '.browser-attach')
     : join(process.env.XDG_DATA_HOME || join(homedir(), '.local', 'share'), 'browser-attach');
 export const DEFAULT_CONFIG = join(DATA_DIR, 'config.json');
-export const VERSION = '0.23.3';
+export const VERSION = '0.23.4';
 
 export async function loadConfig(path = DEFAULT_CONFIG) {
   let config;