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

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

  word:
    version: 版本

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}

  tip:
    not_workspace: |
      当前不在工作区目录，您可使用 `jv create <名称>` 或 `jv init` 创建工作区

    no_account: |
      您的计算机没有任何账户注册，可使用 `jv account add <账户名称>` 以创建账户

    no_account_set: |
      当前工作区的账户为 `unknown`，这意味着您并未设置账户
      使用   `jv as <账户名称>` 来为工作区指定账户
      或使用 `jv login <账户名称> <上游地址>` 来关联至上游库

    account_not_exist: |
      当前工作区设置的账户 `%{account}` 并未注册至您的计算机

    outdated: |
      工作区内信息已经 %{hour} 小时 %{minutes} 分钟没有更新了
      请使用 `jv u` 拿到最新信息

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

    **常用别名**：
      jv u 下载最新信息，jv t 追踪文件，jv a 对齐文件结构到表，jv in/out 导入或导出文件

    **上游库**：
      login  <账户> <地址>    - 设置账户、定向并获得上游信息    [远程]
      direct <地址>           - 定向到工作区到上游库            [远程]
      unstain                 - 祛色工作区，清除关联
      update                  - 同步最新的信息                  [远程]

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

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

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

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

    **上下文查询**：
      here                    - 显示当前路径的相关信息
      status                  - 显示当前表的状态信息

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

    **文件操作**：
      move  <文件> <到>       - 安全地重命名文件
      track <文件>            - 跟踪文件内容到最新版本          [远程]
      hold  <文件>            - 拿取文件，同步版本并获得编辑权  [远程]
      throw <文件>            - 丢弃文件，同步版本并放弃编辑权  [远程]

    **内建文档**：
      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 <表名称> - 将表抛弃，以供其他人使用

    **对齐**：
    jv sheet align --list - 查看所有需要对齐的项目
    jv sheet align [local/remote] - 全部基于本地位置或远程位置
    jv sheet align <对齐任务> [local/remote] - 选择基于本地位置或远程位置
    jv sheet align - 手动指定对齐方式

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


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

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

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


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

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

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


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

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

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


  status: |
    **显示当前表的状态信息**
    **用法**：jv status

    显示当前表的文件修改状态：
    - 新增、删除的文件
    - 移动的文件
    - 修改的文件

    这是了解当前表文件状态的快速方式


  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 old_name.txt new_name.txt
    jv move src/old_dir/file.rs src/new_dir/file.rs

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


  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 <文档名称> -d - 直接打印内容

    **例如**：
    jv docs get_started
    jv docs collaboration -d

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

  confirm:
    login: |
      您正在以 %{account} 身份登陆上游库 %{upstream}，请确认

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

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

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

        restore_ref: |
          您不能直接拿到参照表，它是团队的公共结构 :)

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

    track:
      prepare: |
        您正在准备跟踪 %{file_counts} 个文件的变更，这些文件将遵循如下规则：
        1. 新文件，将被上传并加入您的表中管理
        2. 已持有文件，除非本地不存在或版本不匹配，否则永远执行上传操作
        3. 未持有文件，除非冻结版本，否则永远执行下载和更新最新版本

        **当前**：
        **下行**：%{old_files} 个待更新，%{download_files} 个待下载
        **上行**：%{new_files} 个待跟踪，%{modified_files} 个待提交

      need_upload: |
        因为您指定的追踪操作涉及上传，所以需要详细说明您的更改
        准备好提交了么？使用 `jv track <待上传文件> --work` 开始填写提交信息
        不想使用命令行编辑器？使用 `jv track <待上传文件> --msg <本次修改信息>` 直接提交

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

    format_path: |
      格式化目录 %{path} 失败：%{error}.

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

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

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

    from_core: |
      **错误**：`%{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 <上游地址>` 定向到上游库

    docs:
      not_found: 文档 `%{docs_name}` 未找到！
      no_doc_dir: |
        无法找到暂存目录！
        **提示**：您也可以使用 `jv docs %{docs_name} -d` 直接打印
      open_editor: |
        无法打开文本编辑器预览：`%{err}`！
        **提示**：您也可以使用 `jv docs %{docs_name} -d` 直接打印

    track:
      no_selection: |
        您未在此次操作中选中任何文件！

        **提示**：如果您输入了内容依旧如此，
        可能因为您传入的目录在工作区目录以外，工作区之外的路径会被忽略

      parse_fail: |
        解析传入的参数 `%{param}` 失败！
        **提示**：请确保您输入的参数格式正确

    status:
      no_sheet_in_use: |
        您并没有使用任何一张表！无法在此状态分析工作区状态
        **提示**：您可以使用 `jv use <表名>` 选择并使用一张表

      analyze: |
        分析本地工作区的状态失败！

    use:
      sheet_not_exists: |
        表 `%{name}` 不存在！
        **提示**：请使用 `jv update` 更新工作区状态

      directory_not_empty: |
        在没有使用表的时候，工作区不应该存在任何文件！
        **提示**：请保证工作区是干净的，再使用 `jv use <表名>` 选择并使用一张表

  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 <表名>` 创建一张新表

    docs:
      list:
        header: |
          您可以查阅以下文档：

        item: |
          %{num}. %{docs_name}

        footer: |
          **提示**：使用 `jv docs <文档名称>` 查看文档，使用 -d 直接输出

    here:
      items:
        name: 文件名
        version: 版本状态
        hold: 持有状态
        size: 大小
        editing: 编辑状态

      path_info: |
        信息更新自 %{minutes} 分钟前
        所在：%{upstream}/%{account}/%{sheet_name}/%{path}

      ghost_directory_item_info: |
        ? %{directory_name}/

      ghost_file_item_info: |
        ? %{file_name}

      directory_item_info: |
        %{directory_name}/

      file_item_info: |
        %{file_name}

      append_info:
        holder:
          yourself: |
            持有

          others: |
            `%{holder}` 持有

        size: |
          %{size}

        version:
          unmatch: |
            %{version} 至 %{remote_version}

          match: |
            %{version}

        editing:
          cant_edit: |
            不可编辑

          can_edit: |
            可编辑

          edited: |
            已修改

      count_info: |
        %{dir_count} 目录、%{file_count} 文件，共计 %{size}

    status:
      header: |
        您正在查看表 %{sheet_name} 的状态，在追踪文件变更之前，请确认：

      content: |
        结构变更：
        %{moved_items}%{lost_items}%{created_items}
        内容修改：
        %{modified_items}

      created_item: |
        +   创建：      %{path}

      lost_item: |
        -   丢失：      %{path}

      moved_item: |
        >   移动：      %{from} 至 %{to}

      modified_item: |
        *   修改：      %{path}

      invalid_modified_item: |
        *   修改：      %{path}（%{reason}）

      invalid_modified_reasons:
        not_holder: 不持有但被修改
        base_version_mismatch: 基于的编辑版本不匹配

      no_structure_changes: |
        无文件结构变更

      no_file_modifications: |
        本地无内容修改


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

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

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

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

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

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

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

      fail:
        sync_cached_sheet_fail:
          path_already_exist: |
            在同步上游信息至本地时发生了错误：本地已存在 %{path}，但是某个移动项需要移动到此处。
            请尝试移动该项至其他路径，再重新输入 `jv update`

    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}` 的持有人，无法放弃该表！

    track:
      done: |
        追踪 %{count} 个文件至最新！
        其中，创建 %{created}，更新 %{updated}，同步 %{synced}

      structure_changes_not_solved: |
        本地有结构变更未解决！
        这说明您的本地工作区存在未确认的移动或删除操作
        **提示**：使用 `jv status` 查看结构变更

      create_failed:
        sheet_not_found: |
          在上游库中不存在表 `%{name}`！
          这意味着该表在上游库中已被删除，或该表不属于您

        create_file_on_exist_path: |
          追踪并创建文件失败！
          您要追踪的文件路径 `%{path}` 在远程表中已存在，请更换至其他路径追踪