From def7458429cad22ef6bb3b4b041046956af31a0e Mon Sep 17 00:00:00 2001 From: wuhang2003 Date: Sat, 20 Jun 2026 07:48:36 +0000 Subject: [PATCH 1/2] =?UTF-8?q?docs:=20=E5=90=8C=E6=AD=A5=20mx-admin=20?= =?UTF-8?q?=E8=AE=BE=E7=BD=AE=E9=A1=B9=E5=90=8D=E5=AD=97=E5=8F=98=E6=9B=B4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- content/docs/themes/shiro/deploy.mdx | 2 +- content/docs/themes/shiro/extra.mdx | 6 +++--- content/docs/themes/shiro/pro.mdx | 2 +- content/docs/themes/yohaku/config.mdx | 2 +- src/components/features.tsx | 2 +- 5 files changed, 7 insertions(+), 7 deletions(-) diff --git a/content/docs/themes/shiro/deploy.mdx b/content/docs/themes/shiro/deploy.mdx index 8ead7f3..fe69fff 100644 --- a/content/docs/themes/shiro/deploy.mdx +++ b/content/docs/themes/shiro/deploy.mdx @@ -46,7 +46,7 @@ export function FAQBox({ title, children }) { ### 设置主题配置 -进入 Mix Space 后台，进入「配置与云函数」页面，点击右上角的新增按钮，在编辑页面中，填入以下设置： +进入 Mix Space 后台，进入「集成 - 代码片段」页面（原 配置与云函数），点击右上角的新增按钮，在编辑页面中，填入以下设置： - 名称：`shiro` - 引用：`theme` diff --git a/content/docs/themes/shiro/extra.mdx b/content/docs/themes/shiro/extra.mdx index ef79c2c..c176be2 100644 --- a/content/docs/themes/shiro/extra.mdx +++ b/content/docs/themes/shiro/extra.mdx @@ -32,7 +32,7 @@ import { Step, Steps } from 'fumadocs-ui/components/steps' ### 配置云函数 -进入后台，点击左侧菜单栏的「其他 -> 配置与云函数」，然后点击新建按钮，在选项卡中填入以下信息： +进入后台，点击左侧菜单栏的「集成 - 代码片段」（原 配置与云函数），然后点击新建按钮，在选项卡中填入以下信息： - 名称：`update` - 引用：`ps` @@ -60,7 +60,7 @@ import { Step, Steps } from 'fumadocs-ui/components/steps' ### 配置主题配置 -继续在「配置与云函数」页面，找到「theme -> shiro」配置，点击编辑，进入编辑页面，在代码中找到 `module`，加入 activity 配置，如下：（高亮部分） +继续「集成 - 代码片段」页面（原 配置与云函数），找到「theme -> shiro」配置，点击编辑，进入编辑页面，在代码中找到 `module`，加入 activity 配置，如下：（高亮部分） ```json {14,15,16,17} { @@ -172,7 +172,7 @@ LOG_ENABLE=true ### 配置云函数 -进入后台，点击左侧菜单栏的「其他 -> 配置与云函数」，然后点击新建按钮，在选项卡中填入以下信息： +进入后台，点击左侧菜单栏的「集成 - 代码片段」（原 配置与云函数）中，然后点击新建按钮，在选项卡中填入以下信息： - 名称：`status` - 引用：`shiro` diff --git a/content/docs/themes/shiro/pro.mdx b/content/docs/themes/shiro/pro.mdx index a9a64da..4411c90 100644 --- a/content/docs/themes/shiro/pro.mdx +++ b/content/docs/themes/shiro/pro.mdx @@ -132,7 +132,7 @@ Shiro 主题内置基于 WebGL 的高性能粒子物理背景系统，支持多 ![](/assets/images/themes/shiro/sign.gif) -在「配置与云函数」页面，找到「theme -> shiro」配置，进入编辑页面，在代码中找到 `module`，加入 `signature` 配置，如下（高亮部分）： +在「集成 - 代码片段」页面（原 配置与云函数）中，找到「theme -> shiro」配置，进入编辑页面，在代码中找到 `module`，加入 `signature` 配置，如下（高亮部分）： 其中 svg 后填生成的 svg 代码，可通过 [此网站](https://danmarshall.github.io/google-font-to-svg-path/) 进行生成。 diff --git a/content/docs/themes/yohaku/config.mdx b/content/docs/themes/yohaku/config.mdx index b12e799..f8986ef 100644 --- a/content/docs/themes/yohaku/config.mdx +++ b/content/docs/themes/yohaku/config.mdx @@ -5,7 +5,7 @@ description: 余白 / Yohaku 的配置文件信息 # 配置项 -Yohaku 的配置沿用 Shiro 的配置体系，在 Mix Space 后台「配置与云函数」页面中，创建一条 `theme` 引用、名称为 `shiro` 的配置项（数据类型 JSON 或 YAML）。配置参考详见 [Shiro 的部署页面](https://mx-space.js.org/docs/themes/shiro/deploy#设置主题配置)。 +Yohaku 的配置沿用 Shiro 的配置体系，在 Mix Space 后台「集成 - 代码片段」页面（原 配置与云函数）中，创建一条 `theme` 引用、名称为 `shiro` 的配置项（数据类型 JSON 或 YAML）。配置参考详见 [配置示例](#配置示例)。 Yohaku 复用了 `shiro` 这个配置键名，如果你从 Shiro 迁移到 Yohaku，无需更改配置名称。 diff --git a/src/components/features.tsx b/src/components/features.tsx index 15d07f3..8b12912 100644 --- a/src/components/features.tsx +++ b/src/components/features.tsx @@ -34,7 +34,7 @@ const features = [ }, { icon: Settings, - title: '配置与云函数', + title: '代码片段', description: '无限扩展，无限可能。通过云函数配置实现状态上报等第三方 API 集成功能，通过 JSON/YAML 编辑器快速编辑前端设置。', }, From e2bbb492b2320f8de4cd808841ab9281f7977f21 Mon Sep 17 00:00:00 2001 From: wuhang2003 Date: Sat, 20 Jun 2026 07:58:35 +0000 Subject: [PATCH 2/2] =?UTF-8?q?docs:=20=E5=90=8C=E6=AD=A5=E5=89=8D?= =?UTF-8?q?=E7=AB=AF=E6=97=A0=E6=B3=95=E8=AE=BF=E9=97=AE=E9=97=AE=E9=A2=98?= =?UTF-8?q?=E5=B9=B6=E6=8F=90=E4=BE=9B=E4=B8=B4=E6=97=B6=E8=A7=A3=E5=86=B3?= =?UTF-8?q?=E6=96=B9=E6=A1=88?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- content/docs/reference/common-issues.mdx | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/content/docs/reference/common-issues.mdx b/content/docs/reference/common-issues.mdx index 1f08d60..e7c3d19 100644 --- a/content/docs/reference/common-issues.mdx +++ b/content/docs/reference/common-issues.mdx @@ -35,6 +35,13 @@ description: 按症状分类的常见问题速查 - **原因**：HTTPS/SSL 证书配置有问题，或使用了自签名证书但客户端不信任。 - **解决**：检查证书是否过期，确认 Nginx/Caddy 的 SSL 配置正确，必要时重新申请证书。 +## 无法访问前端 + +### 升级 v13 后 error.api_fetchError Not found + +- **原因**：代码逻辑要求至少需要有一篇手记（详见 [此 issues 讨论](https://github.com/innei-dev/yohaku/issues/151#issuecomment-4642861551)） +- **解决**：发布一篇手记保证 `api/v3/aggregate` 能正常工作。 + ## 功能异常 ### 搜索不工作