i18n(zh-cn): update outdated page (#3245)

GuoJikun · web-flow · commit d0f24dd75e07 · 2025-04-13T20:28:07.000-06:00
diff --git a/src/content/docs/zh-cn/plugin/stronghold.mdx b/src/content/docs/zh-cn/plugin/stronghold.mdx
@@ -9,6 +9,7 @@ import Compatibility from '@components/plugins/Compatibility.astro';
 
 import { Steps, Tabs, TabItem } from '@astrojs/starlight/components';
 import CommandTabs from '@components/CommandTabs.astro';
+import PluginPermissions from '@components/PluginPermissions.astro';
 
 <PluginLinks plugin={frontmatter.plugin} />
 
@@ -33,6 +34,7 @@ import CommandTabs from '@components/CommandTabs.astro';
     		yarn="yarn run tauri add stronghold"
     		pnpm="pnpm tauri add stronghold"
     		bun="bun tauri add stronghold"
+            deno="deno task tauri add stronghold"
     		cargo="cargo tauri add stronghold"
     	/>
     </TabItem>
@@ -66,6 +68,7 @@ import CommandTabs from '@components/CommandTabs.astro';
     			npm="npm install @tauri-apps/plugin-stronghold"
     			yarn="yarn add @tauri-apps/plugin-stronghold"
     			pnpm="pnpm add @tauri-apps/plugin-stronghold"
+    			deno="deno add npm:@tauri-apps/plugin-stronghold"
     			bun="bun add @tauri-apps/plugin-stronghold"
     		/>
 
@@ -76,8 +79,39 @@ import CommandTabs from '@components/CommandTabs.astro';
 
 ## 用法
 
+该插件必须使用密码哈希函数进行初始化，该函数接收密码字符串，并必须返回由其派生的 32 字节哈希值。
+
+### 使用 argon2 密码散列函数初始化
+
+Stronghold 插件提供了一个默认的哈希函数，使用的是 [argon2] 算法。
+
+```rust title="src-tauri/src/lib.rs"
+use tauri::Manager;
+
+pub fn run() {
+		tauri::Builder::default()
+				.setup(|app| {
+						let salt_path = app
+								.path()
+								.app_local_data_dir()
+								.expect("could not resolve app local data path")
+								.join("salt.txt");
+						app.handle().plugin(tauri_plugin_stronghold::Builder::with_argon2(&salt_path).build())?;
+						Ok(())
+				})
+				.run(tauri::generate_context!())
+				.expect("error while running tauri application");
+}
+```
+
 ### 使用自定义密码散列函数初始化
 
+或者，您也可以通过使用 `tauri_plugin_stronghold::Builder::new` 构造函数来提供您自己的哈希算法。
+
+:::note
+密码哈希值必须恰好包含 32 个字节。这是 Stronghold 的要求。
+:::
+
 ```rust title="src-tauri/src/lib.rs"
 pub fn run() {
 		tauri::Builder::default()
@@ -108,34 +142,17 @@ pub fn run() {
 }
 ```
 
-### 使用 argon2 密码散列函数初始化
-
-```rust title="src-tauri/src/lib.rs"
-use tauri::Manager;
-
-pub fn run() {
-		tauri::Builder::default()
-				.setup(|app| {
-						let salt_path = app
-								.path()
-								.app_local_data_dir()
-								.expect("could not resolve app local data path")
-								.join("salt.txt");
-						app.handle().plugin(tauri_plugin_stronghold::Builder::with_argon2(&salt_path).build())?;
-						Ok(())
-				})
-				.run(tauri::generate_context!())
-				.expect("error while running tauri application");
-}
-```
-
 ### 在 JavaScript 使用
 
 Stronghold 插件可以在 JavaScript 中使用。
 
 ```javascript
 import { Client, Stronghold } from '@tauri-apps/plugin-stronghold';
+// 当设置 `"withGlobalTauri": true` 时，你可以用
+// const { Client, Stronghold } = window.__TAURI__.stronghold;
 import { appDataDir } from '@tauri-apps/api/path';
+// 当设置 `"withGlobalTauri": true` 时，你可以用
+// const { appDataDir } = window.__TAURI__.path;
 
 const initStronghold = async () => {
 	const vaultPath = `${await appDataDir()}/vault.hold`;
@@ -189,50 +206,17 @@ await store.remove(key);
 
 ## 权限
 
-默认情况下，所有插件命令都被阻止，无法访问。你必须在你的 `capabilities` 配置中定义一个权限列表。
+默认情况下，所有具有潜在危险的插件命令和范围都会被阻止且无法访问。您必须修改 `capabilities` 文件夹中的配置来启用它们。
 
-更多信息请参见[访问控制列表](/zh-cn/reference/acl/)。
+参见[能力概览](/zh-cn/security/capabilities/)以获取更多信息，以及插件的[分步导览](/zh-cn/learn/security/using-plugin-permissions/)来调整插件权限。
 
 ```json title="src-tauri/capabilities/default.json" ins={8-14}
 {
-	"$schema": "../gen/schemas/desktop-schema.json",
-	"identifier": "main-capability",
-	"description": "Capability for the main window",
-	"windows": ["main"],
+	...,
 	"permissions": [
-		"path:default",
-		"stronghold:allow-initialize",
-		"stronghold:allow-create-client",
-		"stronghold:allow-load-client",
-		"stronghold:allow-save",
-		"stronghold:allow-save-store-record"
-		"stronghold:allow-get-store-record",
-		"stronghold:allow-remove-store-record",
+		"stronghold:default",
 	]
 }
 ```
 
-| 权限                                   | 描述                                                          |
-| -------------------------------------- | ------------------------------------------------------------- |
-| `stronghold:allow-create-client`       | 在没有预先配置的作用域的情况下启用 create_client 命令。       |
-| `stronghold:deny-create-client`        | 拒绝没有任何预配置范围的 create_client 命令。                 |
-| `stronghold:allow-destroy`             | 在没有预先配置的作用域的情况下启用 destroy 命令。             |
-| `stronghold:deny-destroy`              | 拒绝没有任何预配置范围的 destroy 命令。                       |
-| `stronghold:allow-execute-procedure`   | 在没有预先配置的作用域的情况下启用 execute_procedure 命令。   |
-| `stronghold:deny-execute-procedure`    | 拒绝没有任何预配置范围的 execute_procedure 命令。             |
-| `stronghold:allow-get-store-record`    | 在没有预先配置的作用域的情况下启用 get_store_record 命令。    |
-| `stronghold:deny-get-store-record`     | 拒绝没有任何预配置范围的 get_store_record 命令。              |
-| `stronghold:allow-initialize`          | 在没有预先配置的作用域的情况下启用 initialize 命令。          |
-| `stronghold:deny-initialize`           | 拒绝没有任何预配置范围的 initialize 命令。                    |
-| `stronghold:allow-load-client`         | 在没有预先配置的作用域的情况下启用 load_client 命令。         |
-| `stronghold:deny-load-client`          | 拒绝没有任何预配置范围的 load_client 命令。                   |
-| `stronghold:allow-remove-secret`       | 在没有预先配置的作用域的情况下启用 remove_secret 命令。       |
-| `stronghold:deny-remove-secret`        | 拒绝没有任何预配置范围的 remove_secret 命令。                 |
-| `stronghold:allow-remove-store-record` | 在没有预先配置的作用域的情况下启用 remove_store_record 命令。 |
-| `stronghold:deny-remove-store-record`  | 拒绝没有任何预配置范围的 remove_store_record 命令。           |
-| `stronghold:allow-save`                | 在没有预先配置的作用域的情况下启用 save 命令。                |
-| `stronghold:deny-save`                 | 拒绝没有任何预配置范围的 save 命令。                          |
-| `stronghold:allow-save-secret`         | 在没有预先配置的作用域的情况下启用 save_secret 命令。         |
-| `stronghold:deny-save-secret`          | 拒绝没有任何预配置范围的 save_secret 命令。                   |
-| `stronghold:allow-save-store-record`   | 在没有预先配置的作用域的情况下启用 save_store_record 命令。   |
-| `stronghold:deny-save-store-record`    | 拒绝没有任何预配置范围的 save_store_record 命令。             |
+<PluginPermissions plugin={frontmatter.plugin} />
diff --git a/src/content/docs/zh-cn/plugin/upload.mdx b/src/content/docs/zh-cn/plugin/upload.mdx
@@ -29,6 +29,7 @@ import CommandTabs from '@components/CommandTabs.astro';
     	npm="npm run tauri add upload"
     	yarn="yarn run tauri add upload"
     	pnpm="pnpm tauri add upload"
+    	deno="deno task tauri add upload"
     	bun="bun tauri add upload"
     	cargo="cargo tauri add upload"
     />
@@ -59,6 +60,7 @@ import CommandTabs from '@components/CommandTabs.astro';
     			npm="npm install @tauri-apps/plugin-upload"
     			yarn="yarn add @tauri-apps/plugin-upload"
     			pnpm="pnpm add @tauri-apps/plugin-upload"
+                deno="deno add npm:@tauri-apps/plugin-upload"
     			bun="bun add @tauri-apps/plugin-upload"
     		/>
 
diff --git a/src/content/docs/zh-cn/plugin/websocket.mdx b/src/content/docs/zh-cn/plugin/websocket.mdx
@@ -9,6 +9,7 @@ import Compatibility from '@components/plugins/Compatibility.astro';
 
 import { Steps, Tabs, TabItem } from '@astrojs/starlight/components';
 import CommandTabs from '@components/CommandTabs.astro';
+import PluginPermissions from '@components/PluginPermissions.astro';
 
 <PluginLinks plugin={frontmatter.plugin} />
 
@@ -33,6 +34,7 @@ import CommandTabs from '@components/CommandTabs.astro';
     			yarn="yarn run tauri add websocket"
     			pnpm="pnpm tauri add websocket"
     			bun="bun tauri add websocket"
+                deno="deno task tauri add websocket"
     			cargo="cargo tauri add websocket"
     		/>
     </TabItem>
@@ -66,6 +68,7 @@ import CommandTabs from '@components/CommandTabs.astro';
     			npm = "npm install @tauri-apps/plugin-websocket"
     			yarn = "yarn add @tauri-apps/plugin-websocket"
     			pnpm = "pnpm add @tauri-apps/plugin-websocket"
+                deno = "deno add npm:@tauri-apps/plugin-websocket"
     			bun="bun add @tauri-apps/plugin-websocket"
     		/>
 
@@ -94,9 +97,9 @@ await ws.disconnect();
 
 ## 权限
 
-默认情况下，所有插件命令都被阻止，无法访问。你必须在你的 `capabilities` 配置中定义一个权限列表。
+默认情况下，所有具有潜在危险的插件命令和范围都会被阻止且无法访问。您必须修改 `capabilities` 文件夹中的配置来启用它们。
 
-更多信息请参见[访问控制列表](/zh-cn/reference/acl/)。
+参见[能力概览](/zh-cn/security/capabilities/)以获取更多信息，以及插件的[分步导览](/zh-cn/learn/security/using-plugin-permissions/)来调整插件权限。
 
 ```json title="src-tauri/capabilities/default.json" ins={6}
 {
@@ -108,10 +111,4 @@ await ws.disconnect();
 }
 ```
 
-| 权限                      | 描述                                              |
-| ------------------------- | ------------------------------------------------- |
-| `websocket:default`       | 允许连接和发送数据到 WebSocket 服务器             |
-| `websocket:allow-connect` | 在没有预先配置的作用域的情况下启用 connect 命令。 |
-| `websocket:deny-connect`  | 拒绝没有任何预配置范围的 connect 命令。           |
-| `websocket:allow-send`    | 在没有预先配置的作用域的情况下启用 send 命令。    |
-| `websocket:deny-send`     | 拒绝没有任何预配置范围的 send 命令。              |
+<PluginPermissions plugin={frontmatter.plugin} />
diff --git a/src/content/docs/zh-cn/plugin/window-state.mdx b/src/content/docs/zh-cn/plugin/window-state.mdx
@@ -9,6 +9,7 @@ import Compatibility from '@components/plugins/Compatibility.astro';
 
 import { Tabs, TabItem } from '@astrojs/starlight/components';
 import CommandTabs from '@components/CommandTabs.astro';
+import PluginPermissions from '@components/PluginPermissions.astro';
 
 <PluginLinks plugin={frontmatter.plugin} />
 
@@ -33,6 +34,7 @@ import CommandTabs from '@components/CommandTabs.astro';
   npm="npm run tauri add window-state"
   yarn="yarn run tauri add window-state"
   pnpm="pnpm tauri add window-state"
+  deno="deno task tauri add window-state"
   bun="bun tauri add window-state"
   cargo="cargo tauri add window-state"
 />
@@ -66,14 +68,15 @@ fn main() {
       npm="npm install @tauri-apps/plugin-window-state"
       yarn="yarn add @tauri-apps/plugin-window-state"
       pnpm="pnpm add @tauri-apps/plugin-window-state"
+      deno="deno add npm:@tauri-apps/plugin-window-state"
       bun="bun add @tauri-apps/plugin-window-state"
   />
   </TabItem>
 </Tabs>
 
 ## 用法
 
-添加后，当应用程序被关闭时，将记住所有窗口的状态，并在下一次启动时恢复到之前的状态。
+添加窗口状态插件后，应用程序关闭时所有窗口的状态都会被记住，并且在下次启动时会恢复到之前的状态。
 
 你也可以在 JavaScript 和 Rust 中访问窗口状态插件。
 
@@ -120,24 +123,17 @@ window.restore_state(StateFlags::all()); // 将从磁盘恢复窗口的状态
 
 ## 权限
 
-默认情况下，所有插件命令都被阻止，无法访问。
-你必须在你的 `capabilities` 配置中定义一个权限列表。
+默认情况下，所有具有潜在危险的插件命令和范围都会被阻止且无法访问。您必须修改 `capabilities` 文件夹中的配置来启用它们。
 
-更多信息请参见[访问控制列表](/zh-cn/reference/acl/)。
+参见[能力概览](/zh-cn/security/capabilities/)以获取更多信息，以及插件的[分步导览](/zh-cn/learn/security/using-plugin-permissions/)来调整插件权限。
 
 ```json title="src-tauri/capabilities/default.json" ins={4-5}
 {
   "permissions": [
     ...,
-    "window-state:allow-restore-window-state",
-    "window-state:allow-save-window-state",
+    "window-state:default",
   ]
 }
 ```
 
-| 权限                                      | 描述                                                         |
-| ----------------------------------------- | ------------------------------------------------------------ |
-| `window-state:allow-restore-window-state` | 启用 restore_window_state 命令，不需要任何预先配置的作用域。 |
-| `window-state:deny-restore-window-state`  | 拒绝没有任何预配置范围的 restore_window_state 命令。         |
-| `window-state:allow-save-window-state`    | 启用 save_window_state 命令，不需要预先配置作用域。          |
-| `window-state:deny-save-window-state`     | 拒绝没有任何预先配置的作用域的 save_window_state 命令。      |
+<PluginPermissions plugin={frontmatter.plugin} />
diff --git a/src/content/docs/zh-cn/start/frontend/vite.mdx b/src/content/docs/zh-cn/start/frontend/vite.mdx
@@ -12,7 +12,7 @@ Vite 是为提供更快速，更简洁的现代 Web 项目开发体验而诞生
 
 ## 检查清单
 
-- 在 `tauri.conf.json` 中使用 `dist/` 作为 `frontendDist`。
+- 在 `tauri.conf.json` 中使用 `../dist/` 作为 `frontendDist`。
 - 在真实 iOS 设备上调试时，使用 `process.env.TAURI_DEV_HOST` 环境变量作为开发服务器的 IP 地址。
 
 ## 示例配置
@@ -26,8 +26,10 @@ Vite 是为提供更快速，更简洁的现代 Web 项目开发体验而诞生
     ```json
     {
       "scripts": {
-        "dev": "vite dev",
-        "build": "vite build"
+        "dev": "vite",
+        "build": "tsc && vite build",
+        "preview": "vite preview",
+        "tauri": "tauri"
       }
     }
     ```
@@ -84,6 +86,22 @@ Vite 是为提供更快速，更简洁的现代 Web 项目开发体验而诞生
 
     </TabItem>
 
+    <TabItem label="deno">
+
+    ```json
+    // tauri.conf.json
+    {
+      "build": {
+        "beforeDevCommand": "deno task dev",
+        "beforeBuildCommand": "deno task build",
+        "devUrl": "http://localhost:5173",
+        "frontendDist": "../dist"
+      }
+    }
+    ```
+
+    </TabItem>
+
     </Tabs>
 
 1.  ##### 更新 Vite 配置：
@@ -95,11 +113,22 @@ Vite 是为提供更快速，更简洁的现代 Web 项目开发体验而诞生
       // 防止 Vite 清除 Rust 显示的错误
       clearScreen: false,
       server: {
+        port: 1420,
         // Tauri 工作于固定端口，如果端口不可用则报错
         strictPort: true,
         // 如果设置了 host，Tauri 则会使用
         host: host || false,
-        port: 5173,
+        hmr: host
+          ? {
+              protocol: 'ws',
+              host,
+              port: 1421,
+            }
+          : undefined,
+        watch: {
+          // 告诉 Vite 忽略监听 `src-tauri` 目录
+          ignored: ['**/src-tauri/**'],
+        },
       },
       // 添加有关当前构建目标的额外前缀，使这些 CLI 设置的 Tauri 环境变量可以在客户端代码中访问
       envPrefix: ['VITE_', 'TAURI_ENV_*'],
diff --git a/src/content/docs/zh-cn/start/prerequisites.mdx b/src/content/docs/zh-cn/start/prerequisites.mdx
@@ -203,7 +203,7 @@ WebView 2 已安装在 Windows 10（从版本 1803 开始）和更高版本的 W
 
 Tauri 使用 Microsoft Edge WebView2 在 Windows 上呈现内容。
 
-通过访问 [下载 WebView2 运行时](https://developer.microsoft.com/zh-cn/microsoft-edge/webview2/#download) 安装 WebView2。下载并安装“常青独立安装程序（Evergreen Bootstrapper）”。
+通过访问[下载 WebView2 运行时](https://developer.microsoft.com/zh-cn/microsoft-edge/webview2/#download)安装 WebView2。下载并安装“常青独立安装程序（Evergreen Bootstrapper）”。
 
 下一步：[下载并安装 Rust](#rust)
 
