accept hustcer's review

Author: jexjws

.clinerules/zh-CN-trans.md

@@ -170,101 +170,4 @@ export const sidebarZhCN: SidebarConfig = {
       ],
     },
   ],
-  '/lang-guide/': [
-    {
-      text: '语言参考指南',
-      link: '/lang-guide/README.md',
-      collapsible: false,
-      children: [
-        '/lang-guide/README.md',
-        {
-          text: 'Nu 语言类型',
-          link: '/lang-guide/chapters/types/00_types_overview.md',
-          collapsible: true,
-          children: [
-            {
-              text: '基本类型',
-              link: '/lang-guide/chapters/types/basic_types/00_basic_types.md',
-              collapsible: true,
-              children: [
-                '/lang-guide/chapters/types/basic_types/any.md',
-                '/lang-guide/chapters/types/basic_types/bool.md',
-                '/lang-guide/chapters/types/basic_types/int.md',
-                '/lang-guide/chapters/types/basic_types/float.md',
-                '/lang-guide/chapters/types/basic_types/filesize.md',
-                '/lang-guide/chapters/types/basic_types/duration.md',
-                '/lang-guide/chapters/types/basic_types/datetime.md',
-                '/lang-guide/chapters/types/basic_types/range.md',
-                '/lang-guide/chapters/types/basic_types/string.md',
-                '/lang-guide/chapters/types/basic_types/record.md',
-                '/lang-guide/chapters/types/basic_types/list.md',
-                '/lang-guide/chapters/types/basic_types/table.md',
-                '/lang-guide/chapters/types/basic_types/closure.md',
-                '/lang-guide/chapters/types/basic_types/nothing.md',
-                '/lang-guide/chapters/types/basic_types/binary.md',
-                '/lang-guide/chapters/types/basic_types/glob.md',
-                '/lang-guide/chapters/types/basic_types/cellpath.md',
-              ],
-            },
-            {
-              text: '其他数据类型',
-              collapsible: true,
-              children: [
-                {
-                  text: '不能用于声明变量的类型',
-                  link: '/lang-guide/chapters/types/other_types/00_not_assignable.md',
-                  children: ['/lang-guide/chapters/types/other_types/path.md'],
-                },
-                {
-                  text: '不可声明的类型',
-                  link: '/lang-guide/chapters/types/other_types/01_not_declarable.md',
-                  children: [
-                    '/lang-guide/chapters/types/other_types/error.md',
-                    '/lang-guide/chapters/types/other_types/custom_value.md',
-                    '/lang-guide/chapters/types/other_types/block.md',
-                  ],
-                },
-              ],
-            },
-            '/lang-guide/chapters/types/type_signatures.md',
-            '/lang-guide/chapters/types/related_commands.md',
-          ],
-        },
-        '/lang-guide/chapters/operators.md',
-        {
-          text: '流程控制',
-          link: '/lang-guide/chapters/flow_control/00_flow_control_overview.md',
-          collapsible: true,
-          children: [
-            '/lang-guide/chapters/flow_control/if-else.md',
-            '/lang-guide/chapters/flow_control/loop.md',
-            '/lang-guide/chapters/flow_control/while.md',
-            '/lang-guide/chapters/flow_control/match.md',
-            '/lang-guide/chapters/flow_control/try-catch.md',
-            '/lang-guide/chapters/flow_control/break.md',
-            '/lang-guide/chapters/flow_control/return.md',
-            '/lang-guide/chapters/flow_control/continue.md',
-          ],
-        },
-        {
-          text: '过滤器',
-          link: '/lang-guide/chapters/filters/00_filters_overview.md',
-          collapsible: true,
-          children: [
-            '/lang-guide/chapters/filters/each-par-each.md',
-            '/lang-guide/chapters/filters/selecting_data.md',
-            '/lang-guide/chapters/filters/where-filter.md',
-            '/lang-guide/chapters/filters/select-get.md',
-          ],
-        },
-        '/lang-guide/chapters/custom_commands.md',
-        '/lang-guide/chapters/declarations.md',
-        '/lang-guide/chapters/variable_scope.md',
-        '/lang-guide/chapters/strings_and_text.md',
-        '/lang-guide/chapters/helpers_and_debugging.md',
-        '/lang-guide/chapters/pipelines.md',
-        '/lang-guide/chapters/mime_types.md',
-      ],
-    },
-  ],
 };

.vuepress/configs/sidebar/zh-CN.ts

@@ -493,7 +493,7 @@ $env.LS_COLORS = (vivid generate molokai)
 $env.LS_COLORS = (vivid generate ayu)
 ```
 
-你可以将此命令放入你的 [Nushell 配置](/book/configuration.md)中，使其成为默认颜色。
+你可以将此命令放入你的 [Nushell 配置](/zh-CN/book/configuration.md)中，使其成为默认颜色。
 
 ## 主题
 
@@ -583,7 +583,7 @@ $env.config.use_ls_colors: true
 
 ### 在浅色背景终端上工作
 
-Nushell 的[标准库](/book/standard_library.md)包含一个带有默认浅色和深色主题的 `config` 模块。
+Nushell 的[标准库](/zh-CN/book/standard_library.md)包含一个带有默认浅色和深色主题的 `config` 模块。
 如果你在浅色背景的终端上工作，你可以很容易地应用浅色主题。
 
 ```nu

zh-CN/book/coloring_and_theming.md

@@ -3,16 +3,16 @@
 Nushell 提供了几个命令来帮助确定不同代码组的执行方式。在编程语言中，这种功能通常被称为*控制流*。
 
 ::: tip
-需要注意的一点是，本页讨论的所有命令都使用[代码块](/book/types_of_data.html#blocks)。这意味着你可以在其中改变[环境变量](/book/environment.html)和其他[可变变量](/book/variables.html#mutable-variables)。
+需要注意的一点是，本页讨论的所有命令都使用[代码块](/zh-CN/book/types_of_data.html#blocks)。这意味着你可以在其中改变[环境变量](/zh-CN/book/environment.html)和其他[可变变量](/zh-CN/book/variables.html#mutable-variables)。
 :::
 
 ## 已涵盖内容
 
 下面我们介绍一些与控制流相关的命令，但在开始之前，值得注意的是，在其他章节中已经介绍了一些与控制流相关或可以在相同情况下使用的功能和概念。这些包括：
 
-- [管道](/book/pipelines.html)页面上的管道。
-- [数据类型](/book/types_of_data.html)页面上的闭包。
-- [使用列表](/book/working_with_lists.html)页面上的迭代命令。例如：
+- [管道](/zh-CN/book/pipelines.html)页面上的管道。
+- [数据类型](/zh-CN/book/types_of_data.html)页面上的闭包。
+- [使用列表](/zh-CN/book/working_with_lists.html)页面上的迭代命令。例如：
   - [`each`](/commands/docs/each.html)
   - [`where`](/commands/docs/where.html)
   - [`reduce`](/commands/docs/reduce.html)
@@ -33,7 +33,7 @@ Nushell 提供了几个命令来帮助确定不同代码组的执行方式。在
 
 ### `if`
 
-[`if`](/commands/docs/if.html) 根据一个或多个条件的结果来评估分支[代码块](/book/types_of_data.html#blocks)，类似于其他编程语言中的 "if" 功能。例如：
+[`if`](/commands/docs/if.html) 根据一个或多个条件的结果来评估分支[代码块](/zh-CN/book/types_of_data.html#blocks)，类似于其他编程语言中的 "if" 功能。例如：
 
 ```nu
 if $x > 0 { 'positive' }
@@ -76,7 +76,7 @@ match 3 {
 # => three
 ```
 
-分支可以返回单个值，或者如第二个分支所示，可以返回[代码块](/book/types_of_data.html#blocks)的结果。
+分支可以返回单个值，或者如第二个分支所示，可以返回[代码块](/zh-CN/book/types_of_data.html#blocks)的结果。
 
 #### 捕获所有分支
 
@@ -127,7 +127,7 @@ match $foo {
 
 ---
 
-你可以在[模式匹配手册页面](https://www.nushell.sh/cookbook/pattern_matching.html)中找到有关 [`match`](/commands/docs/match.html) 的更多详细信息。
+你可以在[模式匹配手册页面](https://www.nushell.sh/zh-CN/cookbook/pattern_matching.html)中找到有关 [`match`](/commands/docs/match.html) 的更多详细信息。
 
 ## 循环
 
@@ -156,13 +156,13 @@ $result
 # => ╰───┴───╯
 ```
 
-虽然如果你熟悉其他语言中的循环，可能会倾向于使用循环，但在 Nushell 中，当你能用任何一种方式解决问题时，使用应用闭包的命令被认为是更符合 [Nushell 风格](/book/thinking_in_nu.html)（惯用）的。原因在于使用循环有一个相当大的缺点。
+虽然如果你熟悉其他语言中的循环，可能会倾向于使用循环，但在 Nushell 中，当你能用任何一种方式解决问题时，使用应用闭包的命令被认为是更符合 [Nushell 风格](/zh-CN/book/thinking_in_nu.html)（惯用）的。原因在于使用循环有一个相当大的缺点。
 
 #### 循环的缺点
 
 循环最大的缺点是它们是语句，而 [`each`](/commands/docs/each.html) 是表达式。像 [`each`](/commands/docs/each.html) 这样的表达式总会产生某个输出值，而语句则不会。
 
-这意味着它们不能很好地与不可变变量一起工作，而使用不可变变量被认为是更符合 [Nushell 风格](/book/thinking_in_nu.html#variables-are-immutable)的。在上一节的示例中，如果没有预先声明的可变变量，就不可能使用 [`for`](/commands/docs/each.html) 来获取递增数字的列表，或任何值。
+这意味着它们不能很好地与不可变变量一起工作，而使用不可变变量被认为是更符合 [Nushell 风格](/zh-CN/book/thinking_in_nu.html#variables-are-immutable)的。在上一节的示例中，如果没有预先声明的可变变量，就不可能使用 [`for`](/commands/docs/each.html) 来获取递增数字的列表，或任何值。
 
 语句在需要某些输出的 Nushell 管道中也无法工作。事实上，如果你尝试这样做，Nushell 会报错：
 
@@ -198,7 +198,7 @@ mut foo = []
 # =>    ╰────
 ```
 
-如果你在闭包中修改环境变量，你可以，但它只会在闭包的作用域内修改它，在其他地方保持不变。然而，循环使用[代码块](/book/types_of_data.html#blocks)，这意味着它们可以在更大的作用域内修改常规的可变变量或环境变量。
+如果你在闭包中修改环境变量，你可以，但它只会在闭包的作用域内修改它，在其他地方保持不变。然而，循环使用[代码块](/zh-CN/book/types_of_data.html#blocks)，这意味着它们可以在更大的作用域内修改常规的可变变量或环境变量。
 
 ```nu
 mut result = []
@@ -299,7 +299,7 @@ print 'printed'; error make { msg: 'Some error info' }; print 'unprinted'
 
 传递给它的记录为捕获它的代码或最终的错误消息提供了一些信息。
 
-你可以在[创建自己的错误页面](/book/creating_errors.html)上找到有关 [`error make`](/commands/docs/error_make.html) 和错误概念的更多信息。
+你可以在[创建自己的错误页面](/zh-CN/book/creating_errors.html)上找到有关 [`error make`](/commands/docs/error_make.html) 和错误概念的更多信息。
 
 ### `try`
 

zh-CN/book/control_flow.md

@@ -668,7 +668,7 @@ vip-greet Rahul Priya Arjun Anjali Vikram
 # => And a special welcome to our VIP today, Rahul!
 ```
 
-要将列表传递给剩余参数，你可以使用[展开运算符](/book/operators#spread-operator) (`...`)。使用上面的 `vip-greet` 命令定义：
+要将列表传递给剩余参数，你可以使用[展开运算符](/zh-CN/book/operators#spread-operator) (`...`)。使用上面的 `vip-greet` 命令定义：
 
 ```nu
 let vip = "Tanisha"

zh-CN/book/custom_commands.md

@@ -29,7 +29,7 @@ my-command
 第三行是补全的演示。输入自定义命令的名称 `my-command`，然后是一个空格，再按 <kbd>Tab</kbd> 键。这将显示一个包含可能补全的菜单。自定义补全的工作方式与系统中的其他补全相同，允许你输入 `e` 然后按 <kbd>Tab</kbd> 键自动补全 "eel"。
 
 ::: tip
-当补全菜单显示时，提示符默认会包含 `|` 字符。要更改提示标记，请在 `$env.config.menus` 列表的 `completion_menu` 记录中修改 `marker` 的值。另请参阅[补全菜单配置](/book/line_editor.md#completion-menu)。
+当补全菜单显示时，提示符默认会包含 `|` 字符。要更改提示标记，请在 `$env.config.menus` 列表的 `completion_menu` 记录中修改 `marker` 的值。另请参阅[补全菜单配置](/zh-CN/book/line_editor.md#completion-menu)。
 :::
 
 ::: tip
@@ -228,4 +228,4 @@ let carapace_completer = {|spans|
 }
 ```
 
-[更多外部补全器的示例可以在 cookbook 中找到](../cookbook/external_completers.md)。
+[更多外部补全器的示例可以在 实战指南 中找到](../cookbook/external_completers.md)。

zh-CN/book/custom_completions.md

@@ -362,8 +362,8 @@ use $"($my_startup_modules)/my-utils.nu"
 
 ## 结论
 
-Nushell运行在通常由*"动态"*、*"解释型"*语言(如Python、Bash、Zsh、Fish等)主导的脚本语言领域。Nushell也是*"解释型"*的，因为代码会立即运行(无需单独的手动编译)。
+Nushell运行在通常由 _"动态"_、*"解释型"*语言(如Python、Bash、Zsh、Fish等)主导的脚本语言领域。Nushell也是 *"解释型"*的，因为代码会立即运行(无需单独的手动编译)。
 
-然而，它并不*"动态"*，因为它没有`求值函数`构造。在这方面，它与Rust或Zig等*"静态"*编译型语言有更多共同点。
+然而，它并不 _"动态"_，因为它没有`求值函数`构造。在这方面，它与Rust或Zig等 *"静态"*编译型语言有更多共同点。
 
 缺少`求值函数`常常让许多新用户感到惊讶，这也是为什么将Nushell视为编译型静态语言会有所帮助。

zh-CN/book/how_nushell_code_gets_run.md

@@ -100,7 +100,7 @@ try {
 
 ### `$env.NU_LOG_LEVEL`
 
-[标准库](/book/standard_library.md)在 `std/log` 中提供日志记录功能。`NU_LOG_LEVEL` 环境变量用于定义自定义命令、模块和脚本使用的日志级别。
+[标准库](/zh-CN/book/standard_library.md)在 `std/log` 中提供日志记录功能。`NU_LOG_LEVEL` 环境变量用于定义自定义命令、模块和脚本使用的日志级别。
 
 ```nu
 nu -c '1 | print; use std/log; log debug 1111; 9 | print'

zh-CN/book/special_variables.md

@@ -60,13 +60,13 @@ do -i { cat unknown.txt } | complete
 
 相比之下，[`print`](/commands/docs/print.md) 命令将给定值作为纯文本打印到 stdout。它也可以用于写入标准错误输出。与 [`echo`](/commands/docs/echo.md) 不同，此命令不返回任何值（`print | describe` 将返回 "nothing"）。由于此命令没有输出，因此将其与其他命令管道连接没有意义。
 
-[标准库](/book/standard_library.md) 提供了在不同日志级别写入消息的命令。例如：
+[标准库](/zh-CN/book/standard_library.md) 提供了在不同日志级别写入消息的命令。例如：
 
 @[code](@snippets/book/std_log.nu)
 
 ![日志消息示例](../../assets/images/0_79_std_log.png)
 
-可以使用 [`NU_LOG_LEVEL`](/book/special_variables.md#env-nu-log-level) 环境变量设置输出日志级别：
+可以使用 [`NU_LOG_LEVEL`](/zh-CN/book/special_variables.md#env-nu-log-level) 环境变量设置输出日志级别：
 
 ```nu
 NU_LOG_LEVEL=DEBUG nu std_log.nu

zh-CN/book/stdout_stderr_exit_codes.md

@@ -3,7 +3,8 @@
 ## 断言命令
 
 Nushell 在标准库中提供了一组"断言"命令。
-可以使用内置的相等/顺序测试，如 `==` 或 `<=` 或更复杂的命令，并在预期条件失败时手动抛出错误，但使用标准库提供的内容可以说更容易！
+
+我们确实可以使用内置的相等/顺序命令实现测试目的，如 `==` 或 `<=` 或更复杂的命令，并在预期条件失败时手动抛出错误，但使用标准库提供的内容可以说更容易！
 
 在下文中，将假设 `std assert` 模块已在当前作用域中导入
 
@@ -31,15 +32,15 @@ Error:
 
 ```nu
 let a = 0
-assert ($a == 19) $"锁定代码错误，收到：($a)"
+assert ($a == 19) $"The lockout code is wrong, received: ($a)"
 ```
 
 ```
 Error:
-  × 锁定代码错误，收到：13
+  × The lockout code is wrong, received: 13
    ╭─[entry #25:1:1]
  1 │ let a = 0
- 2 │ assert ($a == 19) $"锁定代码错误，收到：($a)"
+ 2 │ assert ($a == 19) $"The lockout code is wrong, received: ($a)"
    ·         ────┬───
    ·             ╰── It is not true.
    ╰────
@@ -89,7 +90,7 @@ Error:   × Assertion failed.
 ```nu
 def "assert even" [number: int] {
     assert ($number mod 2 == 0) --error-label {
-        text: $"($number) 不是偶数",
+        text: $"($number) is not an even number",
         span: (metadata $number).span,
     }
 }
@@ -108,7 +109,7 @@ Error:
    ╭─[entry #37:1:1]
  1 │ assert even $a
    ·             ─┬
-   ·              ╰── 13 不是偶数
+   ·              ╰── 13 is not an even number
    ╰────
 ```
 
@@ -185,20 +186,20 @@ use std/assert
 source fib.nu
 
 def main [] {
-    print "运行测试中..."
+    print "Running tests..."
 
     let test_commands = (
         scope commands
             | where ($it.type == "custom")
                 and ($it.name | str starts-with "test ")
                 and not ($it.description | str starts-with "ignore")
             | get name
-            | each { |test| [$"print '运行测试：($test)'", $test] } | flatten
+            | each { |test| [$"print 'Running test: ($test)'", $test] } | flatten
             | str join "; "
     )
 
     nu --commands $"source ($env.CURRENT_FILE); ($test_commands)"
-    print "测试成功完成"
+    print "Tests completed successfully"
 }
 
 def "test fib" [] {
@@ -219,7 +220,7 @@ def "test fib" [] {
 
 # ignore
 def "test show-ignored-test" [] {
-    print "此测试将不会被执行"
+    print "This test will not be executed"
 }
 ```