mn-docs-mcp 1.0.0 → 1.1.0

package/src/content/docs/{guides/cookbook → cookbook}/addon-settings.md

@@ -40,7 +40,7 @@ NSUserDefaults.standardUserDefaults().setObjectForKey(newKey, "my_addon_api_key"
 Application.sharedInstance().showHUD("已保存", self.window, 2);
 ```
 
-若需用该 Key 发起网络请求，可参考 [调用远程 API](/guides/cookbook/network-api-call/) 和 [网络请求](/guides/network-requests/)。保存后可选择调用简单 API 验证 Key 是否有效。
+若需用该 Key 发起网络请求，可参考 [调用远程 API](/cookbook/network-api-call/) 和 [网络请求](/guides/network-requests/)。保存后可选择调用简单 API 验证 Key 是否有效。
 
 **完整流程简述**：
 
@@ -50,4 +50,4 @@ Application.sharedInstance().showHUD("已保存", self.window, 2);
 4. 插件主逻辑（如是否显示面板）在需要时从 NSUserDefaults 读取。
 5. （可选）保存 API Key 后调用简单接口验证是否有效。
 
-**相关**：[存储与文件](/guides/storage-and-files/)、[NSUserDefaults](/reference/foundation/ns-user-defaults/)、[原生 UI](/guides/native-ui/)、[调用远程 API](/guides/cookbook/network-api-call/)
+**相关**：[存储与文件](/guides/storage-and-files/)、[NSUserDefaults](/reference/foundation/ns-user-defaults/)、[原生 UI](/guides/native-ui/)、[调用远程 API](/cookbook/network-api-call/)

package/src/content/docs/{guides/cookbook → cookbook}/embed-webview-panel.md

@@ -5,7 +5,7 @@ description: 从工具栏打开浮窗，浮窗内为 UIWebView，加载本地或
 
 **场景**：用户点击插件工具栏按钮后，在主界面上显示一个浮窗面板，面板内为 [UIWebView](/reference/uikit/uiwebview/)，加载本地或内联 HTML；面板内可通过自定义 URL 触发插件逻辑（如 showHUD），插件也可通过 `evaluateJavaScript` 更新页面内容。
 
-**要点**：浮窗为自定义 ViewController 的 view，在入口中 `JSB.require` 该 ViewController **一次**，在 `sceneWillConnect` 中创建实例；在 ViewController 的 **viewWillAppear** 中设置 `webView.delegate = self`，在 **viewWillDisappear** 中 `webView.stopLoading()` 并 `webView.delegate = null`。加载 HTML 用 `loadHTMLStringBaseURL(html, null)`，加载失败时在 `webViewDidFailLoadWithError` 中用 `error.localizedDescription` 拼 HTML 后用 `loadHTMLStringBaseURL` 显示错误页。双向通信写法见 [WebView 内 JS 与插件 JS 双向通信](/guides/cookbook/webview-bidirectional-js/)。
+**要点**：浮窗为自定义 ViewController 的 view，在入口中 `JSB.require` 该 ViewController **一次**，在 `sceneWillConnect` 中创建实例；在 ViewController 的 **viewWillAppear** 中设置 `webView.delegate = self`，在 **viewWillDisappear** 中 `webView.stopLoading()` 并 `webView.delegate = null`。加载 HTML 用 `loadHTMLStringBaseURL(html, null)`，加载失败时在 `webViewDidFailLoadWithError` 中用 `error.localizedDescription` 拼 HTML 后用 `loadHTMLStringBaseURL` 显示错误页。双向通信写法见 [WebView 内 JS 与插件 JS 双向通信](/cookbook/webview-bidirectional-js/)。
 
 下文给出与 Samples/UIKit/WebView 同构的完整代码：main.js 中挂面板与切换显示，MyWebViewController.js 中创建 WebView、生命周期与 delegate。
 
@@ -154,5 +154,5 @@ var MyWebViewController = JSB.defineClass('MyWebViewController : UIViewControlle
 ## 相关
 
 - [工具栏与命令](/guides/toolbar-and-commands/)、[原生 UI：使用 WebView](/guides/native-ui/#使用-webview)
-- [WebView 内 JS 与插件 JS 双向通信](/guides/cookbook/webview-bidirectional-js/)、[UIWebView](/reference/uikit/uiwebview/)
+- [WebView 内 JS 与插件 JS 双向通信](/cookbook/webview-bidirectional-js/)、[UIWebView](/reference/uikit/uiwebview/)
 - [网络请求](/guides/network-requests/) —— 获取远程数据后注入 HTML 或通过 evaluateJavaScript 注入

package/src/content/docs/cookbook/meta.json

@@ -0,0 +1,13 @@
+{
+  "title": "Cookbook配方",
+  "pages": [
+    "batch-rename-notes",
+    "network-api-call",
+    "export-notebook",
+    "focus-note-in-mindmap",
+    "append-selection-as-comment",
+    "addon-settings",
+    "embed-webview-panel",
+    "webview-bidirectional-js"
+  ]
+}

package/src/content/docs/{guides/cookbook → cookbook}/network-api-call.md

@@ -106,7 +106,7 @@ async function fetchWithAPIKey() {
 }
 ```
 
-API Key 的保存与读取见 [插件设置页](/guides/cookbook/addon-settings/)。保存后可选择调用简单 API 验证 Key 是否有效。
+API Key 的保存与读取见 [插件设置页](/cookbook/addon-settings/)。保存后可选择调用简单 API 验证 Key 是否有效。
 
 ---
 
@@ -131,5 +131,5 @@ async function fetchPlainText() {
 ## 相关
 
 - [网络请求](/guides/network-requests/) —— Base64 与 MNNetwork 完整代码、data 转 JSON/文本说明
-- [插件设置页](/guides/cookbook/addon-settings/) —— 存储 API Key
+- [插件设置页](/cookbook/addon-settings/) —— 存储 API Key
 - [笔记与数据库](/guides/notes-and-database/) —— 修改笔记与 Undo

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

@@ -109,4 +109,4 @@ self.webView.evaluateJavaScript("document.getElementById('text').innerText = '
 ## 相关
 
 - [UIWebView](/reference/uikit/uiwebview/)、[原生 UI：使用 WebView](/guides/native-ui/#使用-webview)
-- [Cookbook：在插件中嵌入 WebView 面板](/guides/cookbook/embed-webview-panel/)
+- [Cookbook：在插件中嵌入 WebView 面板](/cookbook/embed-webview-panel/)

package/src/content/docs/guides/meta.json

@@ -0,0 +1,14 @@
+{
+  "title": "教程",
+  "pages": [
+    "getting-started",
+    "lifecycle-and-window",
+    "notes-and-database",
+    "mindmap-and-selection",
+    "toolbar-and-commands",
+    "shortcut-keys",
+    "native-ui",
+    "storage-and-files",
+    "network-requests"
+  ]
+}

package/src/content/docs/guides/mindmap-and-selection.md

@@ -73,4 +73,4 @@ if (focusNote && text && text.length > 0) {
 ## 相关
 
 - [StudyController](/reference/marginnote/study-controller/)、[NotebookController](/reference/marginnote/notebook-controller/)、[DocumentController](/reference/marginnote/document-controller/)
-- [Cookbook：将选区追加为评论](/guides/cookbook/append-selection-as-comment/)、[在脑图中高亮指定笔记](/guides/cookbook/focus-note-in-mindmap/)
+- [Cookbook：将选区追加为评论](/cookbook/append-selection-as-comment/)、[在脑图中高亮指定笔记](/cookbook/focus-note-in-mindmap/)

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

@@ -122,7 +122,7 @@ self.webView.evaluateJavaScript("document.title", function (result) {
 });
 ```
 
-WebView 内 JS 与插件 JS 的双向通信（自定义 URL Scheme 拦截 + evaluateJavaScript）见 [Cookbook：WebView 内 JS 与插件 JS 双向通信](/guides/cookbook/webview-bidirectional-js/)。
+WebView 内 JS 与插件 JS 的双向通信（自定义 URL Scheme 拦截 + evaluateJavaScript）见 [Cookbook：WebView 内 JS 与插件 JS 双向通信](/cookbook/webview-bidirectional-js/)。
 
 ## 布局与圆角
 
@@ -133,4 +133,4 @@ WebView 内 JS 与插件 JS 的双向通信（自定义 URL Scheme 拦截 + eval
 
 - [UIView](/reference/uikit/uiview/)、[UIButton](/reference/uikit/uibutton/)、[UIAlertView](/reference/uikit/uialertview/)、[UIWebView](/reference/uikit/uiwebview/)、[UIColor](/reference/uikit/uicolor/)
 - [工具栏与命令](/guides/toolbar-and-commands/) — 将面板与工具栏按钮联动
-- [Cookbook：WebView 内 JS 与插件 JS 双向通信](/guides/cookbook/webview-bidirectional-js/)
+- [Cookbook：WebView 内 JS 与插件 JS 双向通信](/cookbook/webview-bidirectional-js/)

package/src/content/docs/guides/network-requests.md

@@ -303,6 +303,6 @@ NSURLConnection.sendAsynchronousRequestQueueCompletionHandler(
 
 ## 相关
 
-- [Cookbook：调用远程 API](/guides/cookbook/network-api-call/) —— 将 API 结果展示或写入笔记
+- [Cookbook：调用远程 API](/cookbook/network-api-call/) —— 将 API 结果展示或写入笔记
 - [JavaScript 原生环境](/reference/js-runtime/) —— 为何没有 fetch
 - [NSURLConnection](/reference/foundation/ns-url-connection/)、[NSMutableURLRequest](/reference/foundation/ns-mutable-url-request/)

package/src/content/docs/guides/notes-and-database.md

@@ -96,4 +96,4 @@ if (note) {
 ## 相关
 
 - [Database](/reference/global/database/)、[MbBookNote](/reference/marginnote/mb-book-note/)、[UndoManager](/reference/utility/undo-manager/)
-- [Cookbook：批量修改笔记标题](/guides/cookbook/batch-rename-notes/)
+- [Cookbook：批量修改笔记标题](/cookbook/batch-rename-notes/)

package/src/content/docs/guides/storage-and-files.md

@@ -87,5 +87,5 @@ NSUserDefaults.standardUserDefaults().setBoolForKey(newValue, "my_addon_show_pan
 ## 相关
 
 - [NSUserDefaults](/reference/foundation/ns-user-defaults/)、[NSFileManager](/reference/foundation/ns-file-manager/)、[NSData](/reference/foundation/ns-data/)
-- [Cookbook：插件设置页](/guides/cookbook/addon-settings/)
+- [Cookbook：插件设置页](/cookbook/addon-settings/)
 - [网络请求](/guides/network-requests/) —— 网络响应 NSData 的 JSON 解析同理

package/src/content/docs/index.mdx

@@ -1,44 +1,19 @@
 ---
 title: MarginNote 插件开发文档
-description: MarginNote 插件开发的完整 API 参考与渐进式教程（含 Cookbook 配方）。
-template: splash
-hero:
-  tagline: 为 MarginNote 编写插件的官方/社区参考文档
-  image:
-    file: ../../assets/houston.webp
-  actions:
-    - text: 快速开始
-      link: /guides/getting-started/
-      icon: right-arrow
-    - text: API 参考
-      link: /reference/global/jsb/
-      icon: document
-      variant: minimal
+description: MarginNote 插件开发的完整 API 参考与渐进式教程。
 ---
 
-import { Card, CardGrid } from '@astrojs/starlight/components';
+import { Card, Cards } from 'fumadocs-ui/components/card';
 
-## 从这里开始
+# MarginNote 插件开发文档
 
-<CardGrid stagger>
-	<Card title="快速开始" icon="rocket">
-		从零运行你的第一个插件（Hello World），了解 mnaddon.json 与入口函数。
-		[进入快速开始](/guides/getting-started/)
-	</Card>
-	<Card title="教程" icon="pencil">
-		按学习路径掌握生命周期、笔记与数据库、脑图与选区、工具栏与原生 UI。
-		[浏览教程](/guides/lifecycle-and-window/)
-	</Card>
-	<Card title="Cookbook 配方" icon="add-document">
-		按任务查找完整可运行代码：批量改标题、导出笔记本、高亮笔记、设置页等。
-		[查看配方](/guides/cookbook/batch-rename-notes/)
-	</Card>
-	<Card title="API 参考" icon="open-book">
-		全局对象、MarginNote 核心、Foundation、UIKit、Utility 的完整 API 说明。
-		[进入 API](/reference/global/jsb/)
-	</Card>
-	<Card title="贡献指南" icon="heart">
-		参与文档改进：贡献流程、API 参考与教程的格式规范、Markdown 约定等。
-		[查看贡献指南](/guides/contributing/)
-	</Card>
-</CardGrid>
+为 MarginNote 编写插件的 API 参考、渐进式教程与 Cookbook 配方。
+
+<Cards>
+	<Card title="快速开始" href="/guides/getting-started/" description="从零运行你的第一个插件，了解开发流程。" />
+	<Card title="教程" href="/guides/lifecycle-and-window/" description="按学习路径掌握生命周期、笔记与数据库等核心概念。" />
+	<Card title="Cookbook" href="/cookbook/batch-rename-notes/" description="按任务查找完整可运行代码。" />
+	<Card title="API 参考" href="/reference/global/jsb/" description="全局对象与核心 API 的完整说明。" />
+	<Card title="LibMN" href="/libmn/" description="LibMN 运行时与插件开发核心模块。" />
+	<Card title="贡献指南" href="/contributing/" description="参与文档改进，了解格式规范。" />
+</Cards>