Add cli error handle.

1 files changed, 78 insertions, 33 deletions

diff --git a/locales/help_docs/zh-CN.yml b/locales/help_docs/zh-CN.yml
index 2025cbe..ea66095 100644
--- a/locales/help_docs/zh-CN.yml
+++ b/locales/help_docs/zh-CN.yml
@@ -84,10 +84,10 @@ jvv:
       ref_sheet_not_found: 未找到参照表 `ref`，该参照表理应存在！
 
     create:
-      not_empty: 禁止的操作！指定的目录已经存在。
+      not_empty: 禁止的操作！指定的目录已经存在
 
     init:
-      not_empty: 禁止的操作！该目录不为空。
+      not_empty: 禁止的操作！该目录不为空
 
     member:
       register: 创建成员失败！请检查是否存在同名的成员
@@ -123,7 +123,7 @@ jvv:
 jv:
   help: |
     **JustEnoughVCS 本地工作区命令**
-    该程序将连接至上游库，用以同步、提交本地工作区文件的变化，以供协同创作。
+    该程序将连接至上游库，用以同步、提交本地工作区文件的变化，以供协同创作
 
     **常用别名**：
       jv u 下载最新信息，jv t 追踪文件，jv mv -a 自动移动文件，jv in/out 导入或导出文件
@@ -181,8 +181,8 @@ jv:
     jv account remove <账户名称> - 删除该账户
     jv account mvkey <账户名称> <私钥文件> - 移动私钥到指定账户
 
-    账户是本地计算机上的身份标识，每个账户可以关联不同的私钥。
-    您需要先设置账户才能与上游库进行交互。
+    账户是本地计算机上的身份标识，每个账户可以关联不同的私钥
+    您需要先设置账户才能与上游库进行交互
 
 
   sheet: |
@@ -192,8 +192,8 @@ jv:
     jv sheet use <表名称> - 使用指定的表开始当前工作（不存在则自动创建）
     jv sheet exit - 退出当前工作
 
-    表是 JustEnoughVCS 中的核心概念，每个表代表一个独立的文件集合。
-    您可以在不同的表之间切换工作，或者将文件从一个表导出到另一个表。
+    表是 JustEnoughVCS 中的核心概念，每个表代表一个独立的文件集合
+    您可以在不同的表之间切换工作，或者将文件从一个表导出到另一个表
 
 
   create: |
@@ -201,18 +201,18 @@ jv:
     **用法**：jv create <工作区名称>
 
     **例如**：jv create my_workspace
-    上述操作会在当前目录创建名为 my_workspace 的目录，并在其中初始化工作区。
+    上述操作会在当前目录创建名为 my_workspace 的目录，并在其中初始化工作区
 
-    工作区是您本地的工作环境，用于与上游库进行文件同步和版本控制。
+    工作区是您本地的工作环境，用于与上游库进行文件同步和版本控制
 
 
   init: |
     **在此目录创建工作区**
     **用法**：jv init
 
-    该命令会在当前所在的目录创建工作区，工作区名称由当前所在目录名称决定。
+    该命令会在当前所在的目录创建工作区，工作区名称由当前所在目录名称决定
 
-    如果当前目录不为空，该操作将会失败。请确保在空目录中执行此命令。
+    如果当前目录不为空，该操作将会失败，请确保在空目录中执行此命令
 
 
   here: |
@@ -224,7 +224,7 @@ jv:
     - 文件当前的持有人
     - 文件最新版本的提交信息
 
-    这是了解当前工作区目录状态的快速方式。
+    这是了解当前工作区目录状态的快速方式
 
 
   track: |
@@ -232,10 +232,10 @@ jv:
     **用法**：jv track <文件路径>
 
     **例如**：jv track src/main.rs
-    第一次追踪文件时，会创建并上传 “第一版本”，然后自动持有该文件的编辑权。
-    后续追踪同一文件时，会更新文件的新版本。
+    第一次追踪文件时，会创建并上传 “第一版本”，然后自动持有该文件的编辑权
+    后续追踪同一文件时，会更新文件的新版本
 
-    追踪文件是版本控制的基础操作，确保您的更改能够同步到上游库。
+    追踪文件是版本控制的基础操作，确保您的更改能够同步到上游库
 
 
   hold: |
@@ -243,10 +243,10 @@ jv:
     **用法**：jv hold <文件路径>
 
     **例如**：jv hold src/lib.rs
-    当您需要编辑某个文件时，必须先持有该文件的编辑权。
-    持有文件后，其他协作者将无法同时编辑该文件，避免冲突。
+    当您需要编辑某个文件时，必须先持有该文件的编辑权
+    持有文件后，其他协作者将无法同时编辑该文件，避免冲突
 
-    编辑完成后，请记得追踪文件以保存更改。
+    编辑完成后，请记得追踪文件以保存更改
 
 
   throw: |
@@ -254,10 +254,10 @@ jv:
     **用法**：jv throw <文件路径>
 
     **例如**：jv throw src/config.rs
-    当您不再需要编辑某个文件时，可以丢弃该文件的编辑权。
-    丢弃后，其他协作者就可以持有并编辑该文件。
+    当您不再需要编辑某个文件时，可以丢弃该文件的编辑权
+    丢弃后，其他协作者就可以持有并编辑该文件
 
-    如果您对文件进行了更改但尚未追踪，丢弃操作会丢失这些更改。
+    如果您对文件进行了更改但尚未追踪，丢弃操作会丢失这些更改
 
 
   move: |
@@ -271,7 +271,7 @@ jv:
     jv move src/old_dir/file.rs src/new_dir/file.rs
     jv move auto
 
-    安全移动操作会保持文件的版本历史，而自动移动会检测并处理所有重命名。
+    安全移动操作会保持文件的版本历史，而自动移动会检测并处理所有重命名
 
 
   export: |
@@ -279,9 +279,9 @@ jv:
     **用法**：jv export <文件> <目标表> -m <描述> -n <文件包名称>
 
     **例如**：jv export data.csv analytics -m "导出分析数据" -n "analysis_data"
-    该操作会将指定的文件打包并发送到目标表的导入区。
+    该操作会将指定的文件打包并发送到目标表的导入区
 
-    其他协作者可以在目标表中使用 jv import 命令来导入这些文件。
+    其他协作者可以在目标表中使用 jv import 命令来导入这些文件
 
 
   import: |
@@ -294,7 +294,7 @@ jv:
     jv import Player_Import - 来自导入区定义的名称
     jv import ref@Data/Player.csv - 来自参照表的路径
 
-    导入操作会将文件从其他表或导入区复制到当前工作区。
+    导入操作会将文件从其他表或导入区复制到当前工作区
 
 
   direct: |
@@ -302,28 +302,28 @@ jv:
     **用法**：jv direct <上游库地址>
 
     **例如**：jv direct your_vault.org
-    该操作会将当前工作区连接到指定的上游库，并为工作区添加染色标识。
+    该操作会将当前工作区连接到指定的上游库，并为工作区添加染色标识
 
-    染色后，该工作区将只能与指定标识的库进行交互，确保数据一致性。
+    染色后，该工作区将只能与指定标识的库进行交互，确保数据一致性
 
 
   unstain: |
     **为工作区祛色**
     **用法**：jv unstain
 
-    **危险操作**：该操作会移除工作区的染色标识，此后该工作区将与上游库断开连接。
+    **危险操作**：该操作会移除工作区的染色标识，此后该工作区将与上游库断开连接
 
-    祛色后，工作区将不再与任何特定库关联，可以重新连接到其他库。
-    但请注意，这可能会导致数据同步问题，请谨慎使用。
+    祛色后，工作区将不再与任何特定库关联，可以重新连接到其他库
+    但请注意，这可能会导致数据同步问题，请谨慎使用
 
 
   update: |
     **从上游库下载最新的信息**
     **用法**：jv update
 
-    该操作会从上游库同步最新的文件状态、表信息和成员信息。
+    该操作会从上游库同步最新的文件状态、表信息和成员信息
 
-    建议在开始工作前先执行更新操作，确保您拥有最新的工作环境。
+    建议在开始工作前先执行更新操作，确保您拥有最新的工作环境
 
 
   docs: |
@@ -337,4 +337,49 @@ jv:
     jv docs get-started
     jv docs collaboration -e | nano
 
-    内建文档包含 JustEnoughVCS 的使用指南、协作范式和最佳实践。
+    内建文档包含 JustEnoughVCS 的使用指南、协作范式和最佳实践
+
+  fail:
+    parse:
+      str_to_sockaddr: |
+        无法将 *`%{str}`* 识别为IP地址
+        这是您的输入语法问题！请检查 **输入的内容**
+
+    action_operation_fail:
+      main: |
+        此错误来自 JustEnoughVCS 核心组件
+        **错误信息**：%{err}
+
+      type_connection: |
+        根据返回的错误上下文，这是一个**网络连接**问题
+        **请检查**：
+        1. 您的网络连接是否通畅
+        2. 您是否有权限连接至该地址
+
+      type_auth: |
+        根据返回的错误上下文，这是一个**权限**问题
+        这说明您没有足够的权限去做此项操作。
+
+      type_fsio: |
+        根据返回的错误上下文，这是一个**文件读写**相关的问题
+        **请检查**：
+        1. 您的磁盘是否有足够的空间，并且能正常流畅地运转
+        2. 您的本地工作区文件是否被其他进程占用
+
+      type_serialize: |
+        根据返回的错误上下文，这是一个**序列化或反序列化**相关的问题
+        **请检查**
+        1. 您传入的参数格式是否符合序列化或反序列化的要求
+        2. 该版本的 JustEnoughVCS 客户端/服务端 是否支持该类型的序列化
+
+      type_other: |
+        很遗憾，根据返回的上下文信息，这并不是一个符合预期的错误。
+        请前往 JustEnoughVCS 所在的 Git 版本库提交 Issue
+
+        JustEnoughVCS 需要您的反馈，这会让该项目变得更加 "JustEnough"
+
+      info_contact_admin: |
+        如有必要，请联系上游库的 **管理员**。
+        若您作为 **管理员**，在确认该问题影响服务器运作，请
+        1. 检查您的 JustEnoughVCS 服务端是否最新
+        2. 前往 JustEnoughVCS 所在的 Git 版本库提交 Issue