mn-docs-mcp 0.3.1 → 0.4.0

package/README.md

@@ -26,7 +26,8 @@ pnpm preview  # 预览构建结果
 
 本项目内置一个本地MCPServer，支持stdio与HTTPStream两种方式，返回纯文本片段，适合AI直接调用。
 
-embedding模型使用本地BGE-small-zh-v1.5(ONNX)，首次启动会自动下载到 `.mcp/models`。模型文件约95.8MB，向量维度为512。
+embedding模型使用本地BGE-small-zh-v1.5(ONNX)，首次启动会自动下载到transformers.js默认缓存目录。模型文件约95.8MB，向量维度为512。
+模型下载使用固定remoteHost镜像https://hf-mirror.com，不再依赖.env配置。
 
 ### 快速开始(npx)
 

package/mcp/lib.mjs

@@ -5,7 +5,6 @@ import { fileURLToPath } from 'node:url';
 import matter from 'gray-matter';
 import { env, pipeline } from '@huggingface/transformers';
 import { Agent, ProxyAgent, setGlobalDispatcher } from 'undici';
-import dotenv from 'dotenv';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -104,10 +103,6 @@ function logDownloadProgress(info) {
 	}
 }
 
-function loadEnv() {
-	dotenv.config({ path: path.join(ROOT_DIR, '.env') });
-}
-
 function setupProxy() {
 	if (proxyInitialized) return;
 	proxyInitialized = true;
@@ -123,25 +118,22 @@ function setupProxy() {
 
 async function getExtractor() {
 	if (extractorPromise) return extractorPromise;
-	loadEnv();
 	setupProxy();
 	
 	// 抑制 Hugging Face Transformers 的警告输出
-	env.cacheDir = path.join(MCP_DIR, 'models');
 	env.allowRemoteModels = true;
 	env.disableProgressBars = true; // 禁用库自带的进度条
 	env.disableSymlinksWarning = true; // 禁用符号链接警告
+	env.remoteHost = 'https://hf-mirror.com';
 	
 	// 设置日志级别为 error，避免 info/warning 级别日志干扰
 	if (!process.env.LOG_LEVEL) {
 		process.env.LOG_LEVEL = 'error';
 	}
 	
-	if (process.env.HF_ENDPOINT) {
-		env.HF_ENDPOINT = process.env.HF_ENDPOINT;
-	}
-
-	const modelDir = path.join(env.cacheDir, 'Xenova', 'bge-small-zh-v1.5');
+	const modelDir = env.cacheDir
+		? path.join(env.cacheDir, 'Xenova', 'bge-small-zh-v1.5')
+		: null;
 	const create = async () =>
 		pipeline('feature-extraction', MODEL_ID, {
 			progress_callback: logDownloadProgress,
@@ -166,7 +158,9 @@ async function getExtractor() {
 				// 清除上次的进度状态，为重试做准备
 				lastDownloadProgress = -1;
 				logInfo(`模型下载失败，准备重试(${attempt}/${MAX_EXTRACTOR_RETRIES})...`);
-				await fs.rm(modelDir, { recursive: true, force: true });
+				if (modelDir) {
+					await fs.rm(modelDir, { recursive: true, force: true });
+				}
 			}
 		}
 		throw new Error('模型加载失败');

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mn-docs-mcp",
   "type": "module",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/Temsys-Shen/marginnote-addon-docs.git"
@@ -14,7 +14,6 @@
     "@huggingface/transformers": "^3.7.3",
     "@pagefind/default-ui": "^1.4.0",
     "astro": "^5.6.1",
-    "dotenv": "^16.4.5",
     "fastmcp": "^3.34.0",
     "gray-matter": "^4.0.3",
     "sharp": "^0.34.2",

package/src/content/docs/guides/cookbook/webview-bidirectional-js.md

@@ -23,7 +23,7 @@ self.webView.evaluateJavaScript(script, null);
 
 // 或执行并取回结果
 self.webView.evaluateJavaScript("document.title", function (result) {
-  JSB.log("页面标题: %@", result);
+  console.log("页面标题: %@", result);
 });
 ```
 

package/src/content/docs/guides/lifecycle-and-window.md

@@ -42,7 +42,7 @@ description: 理解 scene/notebook/document 生命周期及何时可安全使用
 
 ```javascript
 notebookWillOpen: function (topicid) {
-  JSB.log("MNLOG Open Notebook: %@", topicid);
+  console.log("MNLOG Open Notebook: %@", topicid);
 
   NSTimer.scheduledTimerWithTimeInterval(0.2, false, function () {
     var showPanel = NSUserDefaults.standardUserDefaults().objectForKey("my_addon_show_panel");

package/src/content/docs/guides/native-ui.md

@@ -56,9 +56,9 @@ UIAlertView.showWithTitleMessageStyleCancelButtonTitleOtherButtonTitlesTapBlock(
   ["确定"],
   function (alert, buttonIndex) {
     if (buttonIndex === 0) {
-      JSB.log("用户点击了确定");
+      console.log("用户点击了确定");
     } else {
-      JSB.log("用户取消");
+      console.log("用户取消");
     }
   }
 );
@@ -118,7 +118,7 @@ webViewShouldStartLoadWithRequestNavigationType: function (webView, request, typ
 
 ```javascript
 self.webView.evaluateJavaScript("document.title", function (result) {
-  JSB.log("页面标题: %@", result);
+  console.log("页面标题: %@", result);
 });
 ```
 

package/src/content/docs/reference/global/jsb.md

@@ -2,7 +2,6 @@
 title: JSB
 description: JavaScript 桥接核心，连接插件 JS 与运行时对象的入口对象。
 ---
-
 JSB（JavaScript Bridge）是插件运行时的桥接核心对象：类定义、插件入口、日志与包内脚本加载都通过它完成。
 
 ## 实例成员 (Instance members)
@@ -23,11 +22,11 @@ defineClass(declaration: string, instanceMembers: object, classMembers?: object)
 
 **Parameters:**
 
-| Name | Type | Description |
-| :--- | :--- | :--- |
-| `declaration` | `string` | 类声明，例如 `'MyAddon : JSExtension'`。 |
-| `instanceMembers` | `object` | 实例方法与属性的集合。在此对象中定义的方法/属性在**实例**上调用（如 `sceneWillConnect`、`notebookWillOpen`、`queryAddonCommandStatus` 等）。 |
-| `classMembers` | `object?` | 类方法与属性的集合。在此对象中定义的方法在**类**上调用（如 `addonDidConnect`）。 |
+| Name                | Type        | Description                                                                                                                                              |
+| :------------------ | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `declaration`     | `string`  | 类声明，例如 `'MyAddon : JSExtension'`。                                                                                                               |
+| `instanceMembers` | `object`  | 实例方法与属性的集合。在此对象中定义的方法/属性在**实例**上调用（如 `sceneWillConnect`、`notebookWillOpen`、`queryAddonCommandStatus` 等）。 |
+| `classMembers`    | `object?` | 类方法与属性的集合。在此对象中定义的方法在**类**上调用（如 `addonDidConnect`）。                                                                 |
 
 **Return Value:**
 
@@ -43,8 +42,8 @@ newAddon(mainPath: string): any
 
 **Parameters:**
 
-| Name | Type | Description |
-| :--- | :--- | :--- |
+| Name         | Type       | Description        |
+| :----------- | :--------- | :----------------- |
 | `mainPath` | `string` | 插件包根目录路径。 |
 
 **Return Value:**
@@ -53,7 +52,7 @@ newAddon(mainPath: string): any
 
 ### `log`
 
-向 MarginNote 控制台输出日志，类似 `console.log`。
+向系统控制台输出日志，类似 `console.log`。在MN4已不可用。MN3中使用参考[log,error](https://ohmymn.marginnote.cn/api/marginnote/#log-error)
 
 ```javascript
 log(format: string, ...args: any[]): void
@@ -61,10 +60,10 @@ log(format: string, ...args: any[]): void
 
 **Parameters:**
 
-| Name | Type | Description |
-| :--- | :--- | :--- |
-| `format` | `string` | 格式化字符串，支持 `%@`、`%d` 等 Objective-C 格式。 |
-| `...args` | `any[]` | 对应格式化字符串的参数。 |
+| Name        | Type       | Description                                             |
+| :---------- | :--------- | :------------------------------------------------------ |
+| `format`  | `string` | 格式化字符串，支持 `%@`、`%d` 等 Objective-C 格式。 |
+| `...args` | `any[]`  | 对应格式化字符串的参数。                                |
 
 ### `require`
 
@@ -76,8 +75,8 @@ require(name: string): void
 
 **Parameters:**
 
-| Name | Type | Description |
-| :--- | :--- | :--- |
+| Name     | Type       | Description                   |
+| :------- | :--------- | :---------------------------- |
 | `name` | `string` | 插件包内 JS 文件路径/文件名。 |
 
 **Note:**

package/.env.example

@@ -1,4 +0,0 @@
-# HuggingFace mirror for model download
-HF_ENDPOINT=https://hf-mirror.com
-# Optional
-# MCP_HTTP_PORT=8788