path: root/locales/help_docs/zh-CN.yml

common:
  confirm: |
    是否执行上述操作？（Y/n）：

jvv:
  version:
    header: |
      JVCS 上游管理工具 - %{version}

    compile_info: |
      编译信息：
        时间：%{build_time}
        目标：%{build_target}
        平台：%{build_platform} - %{build_toolchain}

  help: |
    **JustEnoughVCS 上游库命令**
    该程序直接创建、管理、运行 JustEnoughVCS 的上游库
    **注意**：它能直接操作库的数据，请谨慎使用！*（能力越大，责任越大）*

    **创建库**：
      create <名称>         - 在给定的目录名称中创建库
      init                  - 在当前目录中创建库

    **查询**：
      here                  - 查询当前库的信息

    **成员管理**：
      member [list|register|remove]
        list                - 列出成员
        register <成员名称> - 注册成员
        remove   <成员名称> - 移除成员

    **服务**：
      service listen        - 运行服务端

    另外，您可以使用 jvv <命令名称> --help 来查询更详细的帮助！

  here: |
    **显示此处库的信息**
    **例如**：cd ./您需要查询的库/ && jvv here

  create: |
    **在给定的目录名称中创建库**
    **用法**：jvv create **<库名称>**

    **例如**：jvv create MyVault
    上述操作会在当前目录创建目录 MyVault，然后在该目录内初始化库

  init: |
    **在当前目录创建库**
    **用法**：jvv init

    该命令会在当前所在的目录创建库，库名称由当前所在目录名称决定

  member: |
    **成员管理**
    **用法**：jvv member <register/remove> <成员名称>

    根据给定的 成员名称，注册（若不存在）或移除（若存在）指定成员

    推荐使用 "snake_case" 命名格式，因为在配置文件中将以该格式存储
    **例如**：jvv member register vault_member

    **查询**：jvv member list
    该命令的效果和在库的成员目录中执行 jvv here 命令等效

    **注意**：该命令不会影响到库中私钥目录，请手动添加或删除私钥！

  service: |
    **服务设置相关**
    **用法**：
    jvv service listen - 在当前库中启动服务器，以接受客户端连接
      您可以使用 --port 来设定监听的端口，使用 --no-log 禁用日志输出

  fail:
    jvcs: JustEnoughVCS 错误：%{err}
    no_vault_here: 此处并没有找到库文件

    tokio:
      fs:
        create_dir: 无法创建目录 %{dir}
        create_dir_all: 无法创建目录 %{dir}

    std:
      current_dir: 无法获得当前目录
      current_dir_name: 无法获得当前目录的名称
      set_current_dir: 无法设置到目录 %{dir}

    here:
      cfg_not_found: |
        无法找到库的配置！
        若您希望将该目录作为库，请使用 jvv init --help 查看相关帮助

      vault_init_failed: 初始化库失败！
      member_ids_failed: 获得成员 ID 失败！
      ref_sheet_not_found: 未找到参照表 `ref`，该参照表理应存在！

    create:
      not_empty: 禁止的操作！指定的目录已经存在

    init:
      not_empty: 禁止的操作！该目录不为空

    member:
      register: 创建成员失败！请检查是否存在同名的成员
      list: 获取成员 ID 失败！

    service:
      listen_done: |
        服务端被错误强制关闭！
        错误信息：%{error}

  success:
    here:
      info: |
        找到库 *`%{name}`*！（%{num_mem} 成员，%{num_pk} 位已注册公钥）
        其中，管理着 %{num_sheets} 张表，%{num_vf} 个虚拟文件，总共 %{total_size}

        **提示**：若要启动服务端，请运行 jvv service listen

    create: 成功在 `%{name}` 创建库！
    init: 在此处初始化库成功！

    member:
      register: 创建成员 `%{member}` 成功！
      remove: 好的， `%{member}` 已不再存在于库中（或本就不在？）！
      list:
        header: |
          **当前库中有 %{num} 名成员：**

        footer: |
          **其中，有 %{num} 名成员注册了公钥**

        status_key_registered: (公钥存在)

    service:
      listen_start: 正在库 `%{path}` 监听来自客户端的连接 ...
      listen_done: 服务端运行结束！

jv:
  version:
    header: |
      JustEnoughVCS - %{version}

    compile_info: |
      编译信息：
        时间：%{build_time}
        目标：%{build_target}
        平台：%{build_platform} - %{build_toolchain}

  help: |
    **JustEnoughVCS 本地工作区命令**
    该程序将连接至上游库，用以同步、提交本地工作区文件的变化，以供协同创作

    **常用别名**：
      jv u 下载最新信息，jv t 追踪文件，jv mv -a 自动移动文件，jv in/out 导入或导出文件

    **工作区**：
      create <名称>           - 创建工作区
      init                    - 当前目录创建工作区

    **上游库**：
      direct <上游地址>       - 定向到工作区到上游库
      unstain                 - 祛色工作区，清除关联

    **账户**：
      account [list|as|add|remove|movekey]
        list                  - 列出所有账户
        as      <账户名称>    - 设置该工作区使用的账户

        add     <账户名称>    - 为当前计算机添加账户
        remove  <账户名称>    - 从计算机删除账户

        movekey <账户> <私钥> - 移动私钥文件到指定账户

    **信息同步**：
      update                  - 下载最新的信息

    **表操作**：
      sheet [list|use|exit|make|drop]
        list                  - 列出所有表
        use                   - 使用表，并开始工作
        exit                  - 退出表，清除当前修改
        make                  - 创建新表以供自己使用
        drop                  - 抛弃表以供他人使用

    **文件传递**
      import <文件包名称>     - 从导入区导入文件
      import <参照表中目录>   - 从参照表导入文件
      export <文件> <表名称>  - 导出文件到其他表

    **文件操作**
      move <文件> <到>        - 安全地重命名文件
      move auto               - 自动处理本地文件的移动或重命名
      track <文件>            - 追踪、上传文件到上游库

    **内建文档**
      docs list               - 列出所有可用的文档
      docs <文档名称>         - 查看指定文档的内容

    您可以使用 jv <命令名称> --help 来查询更详细的帮助！

    **提示**：若您需要了解 JustEnoughVCS 的协作范式，请使用 jv docs get-started

  account: |
    **管理本地账户**
    **用法**：
    jv account list - 列出该计算机所有的账户，以及是否注册私钥
    jv account as <账户名称> - 切换当前账户
    jv account add <账户名称> - 为当前计算机添加账户
    jv account remove <账户名称> - 删除该账户
    jv account movekey <账户名称> <私钥文件> - 移动私钥到指定账户

    账户是本地计算机上的身份标识，每个账户可以关联不同的私钥
    您需要先设置账户才能与上游库进行交互


  sheet: |
    **管理表**
    **用法**：
    jv sheet list - 列出上游工作区的所有表

    jv sheet use <表名称> - 使用指定的表开始当前工作（不存在则自动创建）
    jv sheet exit - 退出当前工作

    jv sheet make <表名称> - 为自己创建一张新的表
    jv sheet drop <表名称> - 将表抛弃，以供其他人使用

    表是 JustEnoughVCS 中的核心概念，每个表代表一块独立的文件集合
    您可以在不同的表之间切换工作，或者将文件从一张表导出到另一张表


  create: |
    **创建指定名称的工作区**
    **用法**：jv create <工作区名称>

    **例如**：jv create my_workspace
    上述操作会在当前目录创建名为 my_workspace 的目录，并在其中初始化工作区

    工作区是您本地的工作环境，用于与上游库进行文件同步和版本控制


  init: |
    **在此目录创建工作区**
    **用法**：jv init

    该命令会在当前所在的目录创建工作区，工作区名称由当前所在目录名称决定

    如果当前目录不为空，该操作将会失败，请确保在空目录中执行此命令


  here: |
    **查询此处目录信息**
    **用法**：jv here

    显示当前目录文件的详细信息，包括：
    - 文件名称、大小、版本号
    - 文件当前的持有人
    - 文件最新版本的提交信息

    这是了解当前工作区目录状态的快速方式


  track: |
    **追踪本地的文件**
    **用法**：jv track <文件路径>

    **例如**：jv track src/main.rs
    第一次追踪文件时，会创建并上传 “第一版本”，然后自动持有该文件的编辑权
    后续追踪同一文件时，会更新文件的新版本

    追踪文件是版本控制的基础操作，确保您的更改能够同步到上游库


  hold: |
    **拿取文件：从上游库获得该文件的编辑权**
    **用法**：jv hold <文件路径>

    **例如**：jv hold src/lib.rs
    当您需要编辑某个文件时，必须先持有该文件的编辑权
    持有文件后，其他协作者将无法同时编辑该文件，避免冲突

    编辑完成后，请记得追踪文件以保存更改


  throw: |
    **丢弃文件：从上游库放弃该文件的编辑权**
    **用法**：jv throw <文件路径>

    **例如**：jv throw src/config.rs
    当您不再需要编辑某个文件时，可以丢弃该文件的编辑权
    丢弃后，其他协作者就可以持有并编辑该文件

    如果您对文件进行了更改但尚未追踪，丢弃操作会丢失这些更改


  move: |
    **移动本地文件**
    **用法**：
    jv move <源文件> <目标位置> - 安全地重命名或移动文件
    jv move auto - 自动处理本地文件的移动或重命名

    **例如**：
    jv move old_name.txt new_name.txt
    jv move src/old_dir/file.rs src/new_dir/file.rs
    jv move auto

    安全移动操作会保持文件的版本历史，而自动移动会检测并处理所有重命名


  export: |
    **将文件导出至其他表的待导入区**
    **用法**：jv export <文件> <目标表> -m <描述> -n <文件包名称>

    **例如**：jv export data.csv analytics -m "导出分析数据" -n "analysis_data"
    该操作会将指定的文件打包并发送到目标表的导入区

    其他协作者可以在目标表中使用 jv import 命令来导入这些文件


  import: |
    **导入文件到当前表**
    **用法**：
    jv import <文件包名称> - 从导入区导入文件
    jv import <参照表中目录> - 从参照表导入文件

    **例如**：
    jv import Player_Import - 来自导入区定义的名称
    jv import ref@Data/Player.csv - 来自参照表的路径

    导入操作会将文件从其他表或导入区复制到当前工作区


  direct: |
    **定向到指定上游库，并染色该工作区**
    **用法**：jv direct <上游库地址>

    **例如**：jv direct your_vault.org
    该操作会将当前工作区连接到指定的上游库，并为工作区添加染色标识

    染色后，该工作区将只能与指定标识的库进行交互，确保数据一致性


  unstain: |
    **为工作区祛色**
    **用法**：jv unstain

    **危险操作**：该操作会移除工作区的染色标识，此后该工作区将与上游库断开连接

    祛色后，工作区将不再与任何特定库关联，可以重新连接到其他库
    但请注意，这可能会导致数据同步问题，请谨慎使用


  update: |
    **从上游库下载最新的信息**
    **用法**：jv update

    该操作会从上游库同步最新的文件状态、表信息和成员信息

    建议在开始工作前先执行更新操作，确保您拥有最新的工作环境


  docs: |
    **查询内建文档**
    **用法**：
    jv docs list - 列出所有可用的文档
    jv docs <文档名称> - 查看指定文档的内容
    jv docs <文档名称> -e - 返回特定文档的临时路径以供编辑器打开

    **例如**：
    jv docs get-started
    jv docs collaboration -e | nano

    内建文档包含 JustEnoughVCS 的使用指南、协作范式和最佳实践

  confirm:
    direct: |
      是否需要将当前本地工作区定向到上游库 %{upstream}？

    sheet:
      make:
        restore: |
          似乎 `%{sheet_name}` 是一张无人认领的表，是否拿到它的所有权？
          如果您不想拿到该表，请使用别的名称建立表

      drop: |
        是否要放弃表 `%{sheet_name}` 的所有权，此后，您将无法在表中工作！

  fail:
    path_not_found: |
      您给出的目录 `%{path}` 无法找到！

    parse:
      parser_failed: |
        错误的命令输入！
        请使用 `jv -h` 查看帮助

      str_to_sockaddr: |
        错误：%{err}
        无法将 *`%{str}`* 识别为有效地址，请检查您的输入！

    from_just_version_control: |
      **错误**：`%{err}`（该错误来自核心调用）

    account:
      no_user_dir: 无法找到用户目录！
      add: 添加账户 `%{account}` 失败，请检查账户是否已存在。
      remove: 删除账户 `%{account}` 失败，请检查账户是否存在。
      list: 获取账户列表失败！
      move_key: 将该私钥移动至账户目录失败！
      not_found: 无法找到账户 `%{account}`!
      as: 设置当前账户失败，请确保当前表已退出

    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: |
      当前工作区并未被染色，无需祛色

    not_stained: |
      当前工作区并未被染色，无法执行下一步操作！
      **提示**：请先使用 `jv direct <上游地址>` 定向到上游库

  warn:
    unstain: |
      此操作将会断开当前工作区与上游库 `%{upstream}` 的关联
      若重新连接至标识不匹配的库，会导致严重的问题，请谨慎操作！

  success:
    account:
      as: 成功将此工作区的账户切换至 `%{account}`
      add: 成功添加账户 `%{account}`！
      remove: 成功删除账户 `%{account}`！
      list:
        header: |
          **当前计算机上有 %{num} 个账户：**

        status_has_key: (已注册私钥)
      move_key: 成功将该私钥移动至账户目录！
    create: 成功创建本地工作区！
    init: 成功在此处创建工作区！
    unstain: |
      成功祛色！
      当前工作区不再属于任何上游库，请工作前定向至新的上游库
      **提示**：使用 `jv direct <上游库地址>` 重新定向至新的上游库

    sheet:
      list:
        your_sheet: |
          **您的表**：
        your_sheet_item: |
          %{number}. %{name}
        your_sheet_item_use: |
          %{number}. %{name}（当前）
        other_sheet: |
          **其他表**：
        other_sheet_item: |
          %{number}. %{name}（属于 `%{holder}`）
        other_sheet_item_no_holder: |
          %{number}. %{name}（无人认领）
        tip_has_sheet: |
          您不在任何一张表，可使用 `jv use <表名>` 使用一张表
        tip_no_sheet: |
          **没有可以编辑的表！**
          您没有任何一张表，可使用 `jv make <表名>` 创建一张新表

  result:
    common:
      authroize_failed: 身份认证失败：%{err}！
      unknown: |
        未知结果！

    direct:
      redirected: |
        成功重定向到上游库 `%{upstream}`！

      redirect_failed: |
        重定向失败：%{err}！

      directed_and_stained: |
        成功定向到上游库 `%{upstream}`！
        工作区已被 **染色**，现可开始工作！

      already_stained: |
        当前工作区已被染色，无法定向其他不同标识的上游库
        请先使用 jv unstain 祛色

      same_upstream: |
        当前上游和给出的一致，无需重定向

    update:
      success: |
        已同步至最新信息！

    sheet:
      make:
        success: |
          成功创建表 `%{name}`！
          上游信息已变更，请使用 `jv update` 同步至最新信息

        success_restore: |
          成功恢复表 `%{name}` 的所有权！
          上游信息已变更，请使用 `jv update` 同步至最新信息

        sheet_already_exists: |
          表 `%{name}` 已存在！

        sheet_creation_failed: |
          表创建失败：`%{err}`

      drop:
        success: |
          成功放弃表 `%{name}` 的所有权！
          上游信息已变更，请使用 `jv update` 同步至最新信息
          **提示**：您可以使用 `jv make %{name}` 赎回该表

        sheet_in_use: |
          表 `%{name}` 正在被使用中，无法放弃！
          **提示**：请先 `jv exit` 退出当前表，再尝试该操作！

        sheet_not_exists: |
          表 `%{name}` 不存在！

        sheet_drop_failed: |
          放弃表失败：%{err}

        no_holder: |
          表 `%{name}` 没有持有人！

        not_owner: |
          您不是表 `%{name}` 的持有人，无法放弃该表！