Improve error messages for configuration and file access failures

2 files changed, 48 insertions, 2 deletions

diff --git a/locales/help_docs/en.yml b/locales/help_docs/en.yml
index f83ff64..1f55143 100644
--- a/locales/help_docs/en.yml
+++ b/locales/help_docs/en.yml
@@ -649,7 +649,30 @@ jv:
       If you wish to use this directory as a local workspace, please use jv init
 
     read_cfg: Failed to read local workspace configuration file!
-    write_cfg: Failed to write changes to local workspace configuration file!
+    write_cfg: |
+      Failed to write modifications to the local workspace configuration file!
+      This is usually a disk issue. Here is the error message:
+      %{error}
+
+    cfg_not_found:
+      local_config: |
+        Unable to find or read local workspace information!
+        Please confirm you are in the workspace directory.
+
+      latest_info: |
+        Unable to find or read the latest upstream information from the perspective of account `%{account}`!
+        Please use `jv update` to update the workspace!
+
+      latest_file_data: |
+        Unable to find or read the latest file information from the perspective of account `%{account}`!
+        Please use `jv update` to update the workspace!
+
+      local_sheet: |
+        Unable to read or find the local mapping `%{account}/%{sheet}`!
+
+      cached_sheet: |
+        Unable to read or find the cached information for sheet `%{sheet}`
+        Please use `jv update` to update the workspace!
 
     create_socket: Failed to create TCP socket!
     connection_failed: Failed to connect to target server!
diff --git a/locales/help_docs/zh-CN.yml b/locales/help_docs/zh-CN.yml
index 22e2a4d..3f5f438 100644
--- a/locales/help_docs/zh-CN.yml
+++ b/locales/help_docs/zh-CN.yml
@@ -642,7 +642,30 @@ jv:
       若您希望将该目录作为本地工作区，请使用 jv init
 
     read_cfg: 无法读取本地工作区的配置文件！
-    write_cfg: 无法将修改写入本地工作区的配置文件！
+    write_cfg: |
+      无法将修改写入本地工作区的配置文件！
+      这一般是磁盘问题，以下是错误信息：
+      %{error}
+
+    cfg_not_found:
+      local_config: |
+        无法找到或读取本地工作区信息！
+        请确认您是否在工作区目录下
+
+      latest_info: |
+        无法找到或读取 账户 `%{account}` 视角下的最新上游信息！
+        请使用 `jv update` 更新工作区！
+
+      latest_file_data: |
+        无法找到或读取 账户 `%{account}` 视角下的最新文件信息！
+        请使用 `jv update` 更新工作区！
+
+      local_sheet: |
+        无法读取或找到本地映射 `%{account}/%{sheet}`！
+
+      cached_sheet: |
+        无法读取或找到表 `%{sheet}` 的缓存信息
+        请使用 `jv update` 更新工作区！
 
     create_socket: 无法创建 TCP 套接字！
     connection_failed: 无法连接至目标服务器！