npm - mn-docs-mcp - Versions diffs - 0.6.0 → 0.6.2 - Mend

mn-docs-mcp 0.6.0 → 0.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (20) hide show

package/mcp/server-http.mjs CHANGED Viewed

@@ -98,7 +98,6 @@ async function ensureReady() {
 function renderJsonPayload(payload) {
 	return {
-		structuredContent: payload,
 		content: [
 			{
 				type: 'text',

package/mcp/server.mjs CHANGED Viewed

@@ -101,7 +101,6 @@ async function ensureReady() {
 function renderJsonPayload(payload) {
 	return {
-		structuredContent: payload,
 		content: [
 			{
 				type: 'text',

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "mn-docs-mcp",
   "type": "module",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "repository": {
     "type": "git",
     "url": "https://github.com/Temsys-Shen/marginnote-addon-docs.git"

package/src/content/docs/reference/foundation/ns-error.md CHANGED Viewed

@@ -3,7 +3,7 @@ title: NSError
 description: 错误对象，包含 domain/code/userInfo 与本地化描述信息。
 ---
-`NSError` 用于表示错误信息。网络请求（如 `NSURLConnection`）或文件 API 可能通过 `NSError **` 返回错误对象（JS 侧通常作为回调参数或返回值的一部分出现）。
+`NSError` 用于表示错误信息。网络请求（如 `NSURLConnection`）或文件API可能通过`NSError **`返回错误对象，JS侧通常作为回调参数或返回值的一部分出现。
 ## 类成员 (Class members)

package/src/content/docs/reference/foundation/ns-number-formatter.md CHANGED Viewed

@@ -139,7 +139,7 @@ getObjectValueForStringRangeError(obj: any, string: string, rangep: any, error:
 ### 进阶
-本类型还导出了大量与舍入、科学计数、货币、百分比、解析容错、符号显示相关的 getter/setter（例如 roundingMode、currencyCode、percentSymbol、lenient、usesSignificantDigits 等）。可通过站内搜索成员名定位。
+本类型还导出了大量与舍入、科学计数、货币、百分比、解析容错、符号显示相关的可读写成员，例如`roundingMode`、`currencyCode`、`percentSymbol`、`lenient`、`usesSignificantDigits`等。可通过站内搜索成员名定位。
 ## 相关

package/src/content/docs/reference/foundation/ns-proxy.md CHANGED Viewed

@@ -3,7 +3,7 @@ title: NSProxy
 description: 代理基类（消息转发基础设施）。
 ---
-`NSProxy` 是 Objective‑C 世界里的代理基类。在插件环境中，你一般不会直接创建它，但可能会在调试/反射/桥接场景里遇到它的基础方法。
+`NSProxy`是系统代理基类，提供消息转发相关能力。在插件环境中，你一般不会直接创建它，但可能会在调试/反射/桥接场景里遇到它的基础方法。
 ## 类成员 (Class members)

package/src/content/docs/reference/foundation/ns-timer.md CHANGED Viewed

@@ -3,7 +3,7 @@ title: NSTimer
 description: 定时器，延迟执行或周期执行回调。
 ---
-用于延迟执行或重复执行一段代码。JS 侧通过 `scheduledTimerWithTimeInterval(ti, repeats, block)` 创建，block 接收 timer 参数。
+用于延迟执行或重复执行一段代码。JS侧通过`scheduledTimerWithTimeInterval(ti, repeats, block)`创建，block接收timer参数。
 ## 类成员 (Class members)

package/src/content/docs/reference/global/application.md CHANGED Viewed

@@ -25,7 +25,7 @@ static sharedInstance(): Application
 | 属性 | 类型 | 说明 |
 | :--- | :--- | :--- |
-| `focusWindow` | `UIWindow` | 当前活动窗口（文档中有时写作 `window`，getter 为 window）。 |
+| `focusWindow` | `UIWindow` | 当前活动窗口，文档中有时写作`window`。 |
 | `currentTheme` | `string` | 当前主题，包括 `Default` / `Sepia`/ `Gray` / `Dark` / `Green`。 |
 | `dbPath` | `string` | 主数据库文件路径。 |
 | `documentPath` | `string` | 文稿目录路径。 |

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

@@ -62,7 +62,7 @@ log(format: string, ...args: any[]): void
 | Name        | Type       | Description                                             |
 | :---------- | :--------- | :------------------------------------------------------ |
-| `format`  | `string` | 格式化字符串，支持 `%@`、`%d` 等 Objective-C 格式。 |
+| `format`  | `string` | 格式化字符串，支持`%@`、`%d`等占位符。 |
 | `...args` | `any[]`  | 对应格式化字符串的参数。                                |
 ### `require`

package/src/content/docs/reference/global/note.md CHANGED Viewed

@@ -43,16 +43,16 @@ var notebook = db.getNotebookById("NOTEBOOK_ID");
 var doc = db.getDocumentById("DOC_MD5");
 if (notebook && doc) {
-  var topicid = notebook.topicId || notebook.topicid; // 兼容不同 getter 命名
+  var topicId = notebook.topicId;
   UndoManager.sharedInstance().undoGrouping(
     "创建笔记",
-    topicid,
+    topicId,
     function () {
       var note = Note.createWithTitleNotebookDocument("新笔记", notebook, doc);
       // note 为 MbBookNote
     }
   );
-  Application.sharedInstance().refreshAfterDBChanged(topicid);
+  Application.sharedInstance().refreshAfterDBChanged(topicId);
 }
 ```

package/src/content/docs/reference/js-runtime.md CHANGED Viewed

@@ -75,7 +75,7 @@ MarginNote插件运行在JavaScriptCore中，而不是浏览器环境。这意
 ## 环境差异与建议
-- 插件环境没有原生fetch。需要网络请求时，请使用已导出的Objective‑C网络类。
+- 插件环境没有原生fetch。需要网络请求时，请使用文档提供的网络请求API。
 - 插件环境没有setTimeout/setInterval。建议使用NSTimer完成延时与轮询。
 ## 相关

package/src/content/docs/reference/marginnote/document-controller.md CHANGED Viewed

@@ -11,12 +11,12 @@ description: 单个文档的控制器，提供当前文档与选区。
 | 属性 | 类型 | 说明 |
 |------|------|------|
-| `document` | `MbBook` \| undefined | 当前文档对象（getter 为 currBook）。 |
-| `docMd5` | `string` | 当前文档 MD5（getter 为 currentBookMd5）。 |
-| `notebookId` | `string` | 当前笔记本 ID（getter 为 currTopicId）。 |
+| `document` | `MbBook` \| undefined | 当前文档对象。 |
+| `docMd5` | `string` | 当前文档MD5。 |
+| `notebookId` | `string` | 当前笔记本ID。 |
 | `focusNote` | `MbBookNote` \| undefined | 当前焦点笔记。 |
 | `visibleFocusNote` | `MbBookNote` \| undefined | 当前可见的焦点笔记。 |
-| `lastFocusNote` | `MbBookNote` \| undefined | 上一次的焦点笔记（getter 为 lastFocusNote）。 |
+| `lastFocusNote` | `MbBookNote` \| undefined | 上一次的焦点笔记。 |
 | `selectionText` | `string` \| undefined | 用户在 PDF 中当前选中的文本。 |
 | `currPageNo` | `number` | 当前页码（运行时定义，通常从 1 开始）。 |
 | `currPageIndex` | `number` | 当前页索引（运行时定义，通常从 0 开始）。 |

package/src/content/docs/reference/marginnote/mb-book-note.md CHANGED Viewed

@@ -35,12 +35,12 @@ description: 笔记核心对象，代表脑图中的一条笔记及其摘录、
 | `groupNoteId` | `string` | 分组笔记 ID。 |
 | `comments` | `NSArray` | 评论数组，元素为 [NoteComment](/reference/marginnote/note-comment/) 结构。 |
 | `parentNote` | `MbBookNote` \| undefined | 父笔记。 |
-| `childMindMap` | `MbBookNote` \| undefined | 子脑图（getter 为 parentDraft）。 |
+| `childMindMap` | `MbBookNote` \| undefined | 子脑图。 |
 | `linkedNotes` | `NSArray` | 链接的笔记。 |
 | `childNotes` | `NSArray` | 子笔记数组。 |
 | `summaryLinks` | `NSArray` | 摘要链接。 |
 | `zLevel` / `hidden` / `toc` / `annotation` / `textFirst` / `groupMode` / `flashcard` / `flagged` | `NSNumber` | 各类标志。 |
-| `summary` | `boolean` | 是否有摘要链接（getter hasSummaryLinks）。 |
+| `summary` | `boolean` | 是否有摘要链接。 |
 | `textHighlight` / `options` | `NSDictionary` | 文本高亮与选项。 |
 ### 实例方法
@@ -162,7 +162,7 @@ allNoteText(): string
 ### `createWithTitleNotebookDocument`
-创建新笔记（类方法）。在 JS 侧通常通过全局注入的 `Note` 对象调用同名方法。
+创建新笔记类方法。在JS侧通常通过全局注入的`Note`对象调用同名方法。
 ```javascript
 static createWithTitleNotebookDocument(title: string, notebook: MbTopic, document: MbBook): MbBookNote

package/src/content/docs/reference/marginnote/mb-book.md CHANGED Viewed

@@ -11,11 +11,11 @@ description: 文档对象，代表一个 PDF/EPUB 文档。
 | 属性 | 类型 | 说明 |
 |------|------|------|
-| `docMd5` | `string` | 文档唯一 MD5（getter 为 md5real）。 |
-| `docTitle` | `string` | 文档标题（getter 为 bookTitle）。 |
+| `docMd5` | `string` | 文档唯一MD5。 |
+| `docTitle` | `string` | 文档标题。 |
 | `pathFile` | `string` | 文档在 MarginNote 存储中的相对路径。 |
 | `fullPathFileName` | `string` | 文档的完整路径（若环境可用）。 |
-| `currentTopicId` | `string` | 当前所属笔记本 ID（getter 为 currenttopicid）。 |
+| `currentTopicId` | `string` | 当前所属笔记本ID。 |
 | `lastVisit` | `NSDate` | 最后访问时间。 |
 | `pageCount` | `number` | 总页数。 |

package/src/content/docs/reference/marginnote/mb-topic.md CHANGED Viewed

@@ -12,16 +12,16 @@ description: 笔记本（主题）对象，包含根笔记列表与关联文档
 | 属性 | 类型 | R/W | 说明 |
 |------|------|-----|------|
 | `topicId` | `string` | R | 笔记本唯一 ID。 |
-| `title` | `string` | R/W | 笔记本标题（setter 为 setTopicTitle）。 |
+| `title` | `string` | R/W | 笔记本标题。 |
 | `lastVisit` | `NSDate` | R | 最后访问时间。 |
-| `mainDocMd5` | `string` | R | 主文档 MD5（getter 为 localbookmd5）。 |
+| `mainDocMd5` | `string` | R | 主文档MD5。 |
 | `historyDate` | `NSDate` | R | 历史日期。 |
 | `syncMode` | `NSNumber` | R | 同步模式。 |
-| `categoryList` | `string` | R | 分类列表（getter 为 taglist）。 |
+| `categoryList` | `string` | R | 分类列表。 |
 | `hashtags` | `string` | R | 标签。 |
-| `docList` | `string` | R | 文档列表（getter 为 booklist）。 |
+| `docList` | `string` | R | 文档列表。 |
 | `options` | `NSDictionary` | R | 选项。 |
-| `documents` | `NSArray` | R | 关联文档数组（getter 为 books）。 |
+| `documents` | `NSArray` | R | 关联文档数组。 |
 | `notes` | `NSArray` | R | 笔记本中所有**根节点**笔记。 |
 | `hideLinksInMindMapNode` | `boolean` | R/W | 是否在脑图节点中隐藏链接。 |
 | `flags` | `NSNumber` | R | 标志位。 |

package/src/content/docs/reference/marginnote/mindmap-node.md CHANGED Viewed

@@ -12,8 +12,8 @@ description: 脑图中的单个节点，关联一条 MbBookNote 与父子节点
 | 属性 | 类型 | 说明 |
 |------|------|------|
 | `note` | `MbBookNote` | 该节点关联的笔记对象。 |
-| `parentNode` | `MindMapNode` \| undefined | 父节点（getter 为 parentNote，类型为 MindMapNote）。 |
-| `childNodes` | `NSArray` | 子节点数组（getter 为 childNotes）。 |
+| `parentNode` | `MindMapNode` \| undefined | 父节点。 |
+| `childNodes` | `NSArray` | 子节点数组。 |
 | `summaryLinks` | `NSArray` | 摘要链接。 |
 | `frame` | `CGRect` | 节点在脑图视图中的位置与大小。 |

package/src/content/docs/reference/marginnote/notebook-controller.md CHANGED Viewed

@@ -11,9 +11,9 @@ description: 脑图与大纲的控制器，提供当前笔记本与焦点笔记
 | 属性 | 类型 | 说明 |
 | :--- | :--- | :--- |
-| `mindmapView` | `MindMapView` | 脑图视图（getter 为 noteMindMap）。 |
+| `mindmapView` | `MindMapView` | 脑图视图。 |
 | `outlineView` | `OutlineView` | 大纲视图。 |
-| `notebookId` | `string` | 当前笔记本 ID（getter 为 currTopic）。 |
+| `notebookId` | `string` | 当前笔记本ID。 |
 | `focusNote` | `MbBookNote` \| undefined | 当前在脑图中聚焦的笔记。 |
 | `visibleFocusNote` | `MbBookNote` \| undefined | 当前可见的焦点笔记。 |
 | `view` | `UIView` | 控制器视图（继承自 UIViewController）。 |

package/src/content/docs/reference/marginnote/reader-controller.md CHANGED Viewed

@@ -11,8 +11,8 @@ description: 文档阅读区域控制器，管理当前显示的文档控制器
 | 属性 | 类型 | 说明 |
 |------|------|------|
-| `currentDocumentController` | `DocumentController` | 当前正在显示的文档控制器（getter 为 fBookViewController）。 |
-| `documentControllers` | `NSMutableArray` | 所有文档控制器（getter 为 bookViewControllers）。 |
+| `currentDocumentController` | `DocumentController` | 当前正在显示的文档控制器。 |
+| `documentControllers` | `NSMutableArray` | 所有文档控制器。 |
 说明：该对象具备 `UIViewController` 的基础能力（例如 `view`），并额外提供“当前文档控制器/全部文档控制器”等阅读区状态。

package/src/content/docs/reference/marginnote/study-controller.md CHANGED Viewed

@@ -12,13 +12,13 @@ description: 学习场景主视图控制器，访问脑图与文档的入口。
 | 属性 | 类型 | 说明 |
 | :--- | :--- | :--- |
 | `view` | `UIView` | 控制器主视图，可在此添加插件 UI。 |
-| `notebookController` | `NotebookController` | 脑图/大纲控制器（getter 为 `fSearchViewController`，JS 侧为 notebookController）。 |
-| `readerController` | `ReaderController` | 文档阅读区域控制器（getter 为 `detailController`）。 |
+| `notebookController` | `NotebookController` | 脑图/大纲控制器。 |
+| `readerController` | `ReaderController` | 文档阅读区域控制器。 |
 | `studyMode` | `number` | 当前学习模式：0/1 文档模式，2 学习模式，3 复习模式。 |
 | `narrowMode` | `boolean` | 是否窄屏模式（窄屏下书本分屏模式 1 不可用）。 |
-| `docMapSplitMode` | `number` | 书本/脑图分屏模式：0 全脑图，1 半脑图半文档，2 全文档（getter/setter 为 bookSplitMode）。 |
+| `docMapSplitMode` | `number` | 书本/脑图分屏模式：0 全脑图，1 半脑图半文档，2 全文档。 |
 | `rightMapMode` | `boolean` | 脑图是否在右侧。 |
-| `extensionPanelController` | `UIViewController` | 扩展面板控制器（getter 为 extensionController）。 |
+| `extensionPanelController` | `UIViewController` | 扩展面板控制器。 |
 ### 方法

package/src/content/docs/reference/uikit/uiwebview.md CHANGED Viewed

@@ -14,7 +14,7 @@ UIWebView 用于在插件中嵌入网页或本地 HTML 页面，继承自 [UIVie
 | `delegate` | `id` | 实现 UIWebViewDelegate 的对象，通常为承载 WebView 的 ViewController（self）。 |
 | `scrollView` | `UIScrollView` | 只读，内嵌滚动视图。 |
 | `request` | `NSURLRequest` | 只读，当前请求。 |
-| `loading` | `boolean` | 只读，是否正在加载（getter 为 isLoading）。 |
+| `loading` | `boolean` | 只读，是否正在加载。 |
 | `canGoBack` | `boolean` | 只读，是否可后退。 |
 | `canGoForward` | `boolean` | 只读，是否可前进。 |
 | `scalesPageToFit` | `boolean` | 是否按比例缩放以适应视图。 |
@@ -52,7 +52,7 @@ loadHTMLStringBaseURL(string: string, baseURL: NSURL | null): void
 | `string` | `string` | HTML 内容字符串。 |
 | `baseURL` | `NSURL \| null` | 基础 URL（用于解析相对路径）。 |
-**Note:** 该方法对应 Objective‑C 的 `loadHTMLString:baseURL:`，JS 侧为参数标签拼接后的方法名。
+**说明:** 该方法名由参数标签拼接得到。
 ### `loadDataMIMETypeTextEncodingNameBaseURL`