Merge branch 'main' into docs

1 files changed, 132 insertions, 41 deletions

diff --git a/locales/help_docs/zh-CN.yml b/locales/help_docs/zh-CN.yml
index 2025cbe..4d3212e 100644
--- a/locales/help_docs/zh-CN.yml
+++ b/locales/help_docs/zh-CN.yml
@@ -1,3 +1,7 @@
+common:
+  confirm: |
+    是否执行上述操作？（Y/n）：
+
 jvv:
   help: |
     **JustEnoughVCS 上游库命令**
@@ -55,11 +59,10 @@ jvv:
     **服务设置相关**
     **用法**：
     jvv service listen - 在当前库中启动服务器，以接受客户端连接
-      您可以使用 --no-log 来禁用日志输出
+      您可以使用 --port 来设定监听的端口，使用 --no-log 禁用日志输出
 
   fail:
     jvcs: JustEnoughVCS 错误：%{err}
-
     no_vault_here: 此处并没有找到库文件
 
     tokio:
@@ -78,21 +81,24 @@ jvv:
         若您希望将该目录作为库，请使用 jvv init --help 查看相关帮助
 
       vault_init_failed: 初始化库失败！
-
       member_ids_failed: 获得成员 ID 失败！
-
       ref_sheet_not_found: 未找到参照表 `ref`，该参照表理应存在！
 
     create:
-      not_empty: 禁止的操作！指定的目录已经存在。
+      not_empty: 禁止的操作！指定的目录已经存在
 
     init:
-      not_empty: 禁止的操作！该目录不为空。
+      not_empty: 禁止的操作！该目录不为空
 
     member:
       register: 创建成员失败！请检查是否存在同名的成员
       list: 获取成员 ID 失败！
 
+    service:
+      listen_done: |
+        服务端被错误强制关闭！
+        错误信息：%{error}
+
   success:
     here:
       info: |
@@ -102,7 +108,6 @@ jvv:
         **提示**：若要启动服务端，请运行 jvv service listen
 
     create: 成功在 `%{name}` 创建库！
-
     init: 在此处初始化库成功！
 
     member:
@@ -118,12 +123,13 @@ jvv:
         status_key_registered: (公钥存在)
 
     service:
-      listen: 正在库 `%{path}` 监听来自客户端的连接 ...
+      listen_start: 正在库 `%{path}` 监听来自客户端的连接 ...
+      listen_done: 服务端运行结束！
 
 jv:
   help: |
     **JustEnoughVCS 本地工作区命令**
-    该程序将连接至上游库，用以同步、提交本地工作区文件的变化，以供协同创作。
+    该程序将连接至上游库，用以同步、提交本地工作区文件的变化，以供协同创作
 
     **常用别名**：
       jv u 下载最新信息，jv t 追踪文件，jv mv -a 自动移动文件，jv in/out 导入或导出文件
@@ -143,7 +149,7 @@ jv:
       jv account as <账户名称> - 切换当前账户
       jv account add <账户名称> - 为当前计算机添加账户
       jv account remove <账户名称> - 删除该账户
-      jv account mvkey <账户名称> <私钥文件> - 移动私钥到指定账户
+      jv account movekey <账户名称> <私钥文件> - 移动私钥到指定账户
 
     **信息同步**：
       jv update - 从上游工作区下载最新的信息
@@ -179,10 +185,10 @@ jv:
     jv account as <账户名称> - 切换当前账户
     jv account add <账户名称> - 为当前计算机添加账户
     jv account remove <账户名称> - 删除该账户
-    jv account mvkey <账户名称> <私钥文件> - 移动私钥到指定账户
+    jv account movekey <账户名称> <私钥文件> - 移动私钥到指定账户
 
-    账户是本地计算机上的身份标识，每个账户可以关联不同的私钥。
-    您需要先设置账户才能与上游库进行交互。
+    账户是本地计算机上的身份标识，每个账户可以关联不同的私钥
+    您需要先设置账户才能与上游库进行交互
 
 
   sheet: |
@@ -192,8 +198,8 @@ jv:
     jv sheet use <表名称> - 使用指定的表开始当前工作（不存在则自动创建）
     jv sheet exit - 退出当前工作
 
-    表是 JustEnoughVCS 中的核心概念，每个表代表一个独立的文件集合。
-    您可以在不同的表之间切换工作，或者将文件从一个表导出到另一个表。
+    表是 JustEnoughVCS 中的核心概念，每个表代表一个独立的文件集合
+    您可以在不同的表之间切换工作，或者将文件从一个表导出到另一个表
 
 
   create: |
@@ -201,18 +207,18 @@ jv:
     **用法**：jv create <工作区名称>
 
     **例如**：jv create my_workspace
-    上述操作会在当前目录创建名为 my_workspace 的目录，并在其中初始化工作区。
+    上述操作会在当前目录创建名为 my_workspace 的目录，并在其中初始化工作区
 
-    工作区是您本地的工作环境，用于与上游库进行文件同步和版本控制。
+    工作区是您本地的工作环境，用于与上游库进行文件同步和版本控制
 
 
   init: |
     **在此目录创建工作区**
     **用法**：jv init
 
-    该命令会在当前所在的目录创建工作区，工作区名称由当前所在目录名称决定。
+    该命令会在当前所在的目录创建工作区，工作区名称由当前所在目录名称决定
 
-    如果当前目录不为空，该操作将会失败。请确保在空目录中执行此命令。
+    如果当前目录不为空，该操作将会失败，请确保在空目录中执行此命令
 
 
   here: |
@@ -224,7 +230,7 @@ jv:
     - 文件当前的持有人
     - 文件最新版本的提交信息
 
-    这是了解当前工作区目录状态的快速方式。
+    这是了解当前工作区目录状态的快速方式
 
 
   track: |
@@ -232,10 +238,10 @@ jv:
     **用法**：jv track <文件路径>
 
     **例如**：jv track src/main.rs
-    第一次追踪文件时，会创建并上传 “第一版本”，然后自动持有该文件的编辑权。
-    后续追踪同一文件时，会更新文件的新版本。
+    第一次追踪文件时，会创建并上传 “第一版本”，然后自动持有该文件的编辑权
+    后续追踪同一文件时，会更新文件的新版本
 
-    追踪文件是版本控制的基础操作，确保您的更改能够同步到上游库。
+    追踪文件是版本控制的基础操作，确保您的更改能够同步到上游库
 
 
   hold: |
@@ -243,10 +249,10 @@ jv:
     **用法**：jv hold <文件路径>
 
     **例如**：jv hold src/lib.rs
-    当您需要编辑某个文件时，必须先持有该文件的编辑权。
-    持有文件后，其他协作者将无法同时编辑该文件，避免冲突。
+    当您需要编辑某个文件时，必须先持有该文件的编辑权
+    持有文件后，其他协作者将无法同时编辑该文件，避免冲突
 
-    编辑完成后，请记得追踪文件以保存更改。
+    编辑完成后，请记得追踪文件以保存更改
 
 
   throw: |
@@ -254,10 +260,10 @@ jv:
     **用法**：jv throw <文件路径>
 
     **例如**：jv throw src/config.rs
-    当您不再需要编辑某个文件时，可以丢弃该文件的编辑权。
-    丢弃后，其他协作者就可以持有并编辑该文件。
+    当您不再需要编辑某个文件时，可以丢弃该文件的编辑权
+    丢弃后，其他协作者就可以持有并编辑该文件
 
-    如果您对文件进行了更改但尚未追踪，丢弃操作会丢失这些更改。
+    如果您对文件进行了更改但尚未追踪，丢弃操作会丢失这些更改
 
 
   move: |
@@ -271,7 +277,7 @@ jv:
     jv move src/old_dir/file.rs src/new_dir/file.rs
     jv move auto
 
-    安全移动操作会保持文件的版本历史，而自动移动会检测并处理所有重命名。
+    安全移动操作会保持文件的版本历史，而自动移动会检测并处理所有重命名
 
 
   export: |
@@ -279,9 +285,9 @@ jv:
     **用法**：jv export <文件> <目标表> -m <描述> -n <文件包名称>
 
     **例如**：jv export data.csv analytics -m "导出分析数据" -n "analysis_data"
-    该操作会将指定的文件打包并发送到目标表的导入区。
+    该操作会将指定的文件打包并发送到目标表的导入区
 
-    其他协作者可以在目标表中使用 jv import 命令来导入这些文件。
+    其他协作者可以在目标表中使用 jv import 命令来导入这些文件
 
 
   import: |
@@ -294,7 +300,7 @@ jv:
     jv import Player_Import - 来自导入区定义的名称
     jv import ref@Data/Player.csv - 来自参照表的路径
 
-    导入操作会将文件从其他表或导入区复制到当前工作区。
+    导入操作会将文件从其他表或导入区复制到当前工作区
 
 
   direct: |
@@ -302,28 +308,28 @@ jv:
     **用法**：jv direct <上游库地址>
 
     **例如**：jv direct your_vault.org
-    该操作会将当前工作区连接到指定的上游库，并为工作区添加染色标识。
+    该操作会将当前工作区连接到指定的上游库，并为工作区添加染色标识
 
-    染色后，该工作区将只能与指定标识的库进行交互，确保数据一致性。
+    染色后，该工作区将只能与指定标识的库进行交互，确保数据一致性
 
 
   unstain: |
     **为工作区祛色**
     **用法**：jv unstain
 
-    **危险操作**：该操作会移除工作区的染色标识，此后该工作区将与上游库断开连接。
+    **危险操作**：该操作会移除工作区的染色标识，此后该工作区将与上游库断开连接
 
-    祛色后，工作区将不再与任何特定库关联，可以重新连接到其他库。
-    但请注意，这可能会导致数据同步问题，请谨慎使用。
+    祛色后，工作区将不再与任何特定库关联，可以重新连接到其他库
+    但请注意，这可能会导致数据同步问题，请谨慎使用
 
 
   update: |
     **从上游库下载最新的信息**
     **用法**：jv update
 
-    该操作会从上游库同步最新的文件状态、表信息和成员信息。
+    该操作会从上游库同步最新的文件状态、表信息和成员信息
 
-    建议在开始工作前先执行更新操作，确保您拥有最新的工作环境。
+    建议在开始工作前先执行更新操作，确保您拥有最新的工作环境
 
 
   docs: |
@@ -337,4 +343,89 @@ jv:
     jv docs get-started
     jv docs collaboration -e | nano
 
-    内建文档包含 JustEnoughVCS 的使用指南、协作范式和最佳实践。
+    内建文档包含 JustEnoughVCS 的使用指南、协作范式和最佳实践
+
+  confirm:
+    direct: |
+      是否需要将当前本地工作区定向到上游库 %{upstream}？
+
+  fail:
+    path_not_found: |
+      您给出的目录 `%{path}` 无法找到！
+
+    parse:
+      parser_failed: |
+        错误的命令输入！
+        请使用 `jv -h` 查看帮助
+
+      str_to_sockaddr: |
+        错误：%{err}
+        无法将 *`%{str}`* 识别为有效地址，请检查您的输入！
+
+    from_just_version_control: |
+      **错误**：`%{err}`（该错误由 JustEnoughVCS 提供）
+
+    account:
+      no_user_dir: 无法找到用户目录！
+      add: 添加账户 `%{account}` 失败，请检查账户是否已存在。
+      remove: 删除账户 `%{account}` 失败，请检查账户是否存在。
+      list: 获取账户列表失败！
+      move_key: 将该私钥移动至账户目录失败！
+      not_found: 无法找到账户 `%{account}`!
+
+    init_create_dir_not_empty: |
+      当前目录并不是空的！
+      若您确实确定在此处创建，请使用 --force 来强制执行！
+
+    create: 创建本地工作区失败！
+    init: 在此处创建本地工作区失败！
+    get_current_dir: 无法获得当前目录！
+
+    workspace_not_found: |
+      无法找到本地工作区！请在本地工作区内使用该命令
+      若您希望将该目录作为本地工作区，请使用 jv init
+
+    read_cfg: 无法读取本地工作区的配置文件！
+    write_cfg: 无法将修改写入本地工作区的配置文件！
+
+    create_socket: 无法创建 TCP 套接字！
+    connection_failed: 无法连接至目标服务器！
+
+    unstain: |
+      当前工作区并未被染色，无需祛色
+
+  warn:
+    unstain: |
+      此操作将会断开当前工作区与上游库 `%{upstream}` 的关联
+      若重新连接至标识不匹配的库，会导致严重的问题，请谨慎操作！
+
+  success:
+    account:
+      as: 成功将此工作区的账户切换至 `%{account}`
+      add: 成功添加账户 `%{account}`！
+      remove: 成功删除账户 `%{account}`！
+      list:
+        header: |
+          **当前计算机上有 %{num} 个账户：**
+
+        status_has_key: (已注册私钥)
+      move_key: 成功将该私钥移动至账户目录！
+    create: 成功创建本地工作区！
+    init: 成功在此处创建工作区！
+    unstain: |
+      成功祛色！
+      当前工作区不再属于任何上游库，请工作前定向至新的上游库
+      **提示**：使用 `jv direct <上游库地址>` 重新定向至新的上游库
+
+  result:
+    common:
+      authroize_failed: 身份认证失败：%{err}！
+
+    direct:
+      directed_and_stained: |
+        成功定向到上游库 `%{upstream}`！
+        工作区已被 **染色**，现可开始工作！
+
+      already_stained: |
+        当前工作区已被染色，无法定向其他不同标识的上游库
+        请先使用 jv unstain 祛色