[en]
help = """
[[b_blue]]**Usage**[[/]]: **rola** [-v | --version] [-h | --help] [-L | --lang *<LANG>*]
__          **OUTPUT CONTROL:**
__            [--silence | --quiet] [--no-error] [--no-result]
__            [--no-color] [--json | --json-pretty]
__          **LOGS:**
__            [-V | --verbose] [--log-time]
__            [--log-level _disable_ | [[gray]]_trace_[[/]] | [[b_cyan]]_debug_[[/]] | [[b_yellow]]_warn_[[/]] | [[b_red]]_error_[[/]]]
__          **CONTEXT:**
__            [--bucket-dir *<DIR>*] [--draft-dir *<DIR>*] [--dir *<CWD>*]
__          **BEHAVIOUR CONTROL:**
__            [[b_yellow]]**[-y | --yes]**[[/]] [[b_red]]**[-O | --overwrite]**[[/]] [--no-pager]
"""

[zh_CN]
help = """
[[b_blue]]**用法**[[/]]：**rola** [-v | --version] [-h | --help] [-L | --lang *<LANG>*]
__         **输出控制：**
__           [--silence | --quiet] [--no-error] [--no-result]
__           [--no-color] [--json | --json-pretty]
__         **日志：**
__           [-V | --verbose] [--log-time]
__           [--log-level _disable_ | [[gray]]_trace_[[/]] | [[b_cyan]]_debug_[[/]] | [[b_yellow]]_warn_[[/]] | [[b_red]]_error_[[/]]]
__         **上下文：**
__           [--bucket-dir *<DIR>*] [--draft-dir *<DIR>*] [--dir *<CWD>*]
__         **行为控制：**
__           [[b_yellow]]**[-y | --yes]**[[/]] [[b_red]]**[-O | --overwrite]**[[/]] [--no-pager]
"""


# 全局：
# --draft-dir 草稿路径
# --bucket-dir 桶路径
# --dir 路径
# -V --version
# -v --verbose
# -h --help
# -L --lang --language
# --json --json-pretty
# --no-color --no-pager
# --no-error --only-error
# --quiet / --silence
# -y / --yes
# --overwrite

# # 创建草稿，临时视图
# rola create --draft
# rola init --draft

# # 创建桶，存储库，远程真相
# rola create --bucket
# rola init --bucket

# # 仅 draft 中命令
# # 桶
# rola bucket origin --bind-to-url url
# rola bucket origin --delete / -D
# rola bucket origin --rename-to other
# rola bucket # 列出
# rola bucket origin # 显示元数据

# # 检查连接
# rola test-connection --url url
# rola test-connection --bucket origin

# # 信息同步
# rola update
# rola update --all

# # 视图
# rola view # 列出所有视图
# rola view THIS # 当前视图
# rola view origin/main # 主视图
# rola view --new other # 新建视图
# rola view --clone other # 克隆视图
# rola view --checkout-clone other # 新建视图并直接切换
# rola view --checkout-new other # 新建视图并直接切换
# rola view --checkout other # 切换
# rola view origin --rename-to other # 命名
# rola view --forget origin # 忘记视图
# rola view origin/main --track-to main # 跟踪
# rola view main --track-to origin/main # 跟踪
# rola view main --break-track # 断开跟踪
# rola view --show-track # 展示跟踪状态
# rola view main --show-track # 展示跟踪状态
# rola view main --up-track # 同步视图 上传 (只提醒使用--overwrite-up-track)
# rola view main --overwrite-up-track # 同步视图 上传
# rola view main --down-track # 同步视图 下载

# # 状态
# rola status --view main # 检查视图状态 （等效 rola view main）
# rola status # 检查草稿状态（如果在draft）
# rola status # 检查桶状态（如果在bucket）
# rola status --file ./file # 检查文件状态
# rola status --file . # 检查多个文件状态
# rola status --bucket origin # 检查远程桶状态 (等效 rola bucket origin)
# rola status --bucket-url url # 检查url状态 (等效 rola test-connection --url url)
# rola status --align task # 检查对齐状态 (等效 rola align task)
# rola status --align-task # 检查所有对齐状态 (等效 rola align)

# # 实际版控
# rola set-forward ./my.file --follow latest # 将文件总是追踪最新版本
# rola set-forward ./my.file --follow ver:16 # 锁定到16版本
# rola set-forward ./my.file --follow origin/main # 跟随某个view的版本

# rola track . # 跟踪文件
# 为每个文件判断：
# 在 forward 为 latest 时
# 1. 本地版本同步，且已修改：尝试上传（可能冲突）
# 2. 本地版本不同步，且未修改：下载
# 3. 本地版本不同步，且已修改：阻止！（使用 --overwrite 覆盖）
# 4. 在 3 的情况下，使用 --overwrite 覆盖本地（或显式使用 --down --overwrite）
# 5. 在 3 的情况下，使用 --up --overwrite 覆盖远程（强制提交）
# 在 forward 为 ver 时
# 1. 本地版本同步 ver，且已修改：阻止！（使用 --overwrite 覆盖）
# 2. 本地版本不同步 ver，且未修改：下载
# 3. 本地版本同步 ver，未修改，什么都不做
# 在 forward 为 view 时
# 1. 如果view中没有该文件，阻止！（使用 --allow-non-forward）
# 2. 如果view中没有该文件，且使用 --allow-non-forward：不做任何事
# 3. 如果view存在该文件，将view中该文件的版本视作ver，同（在 forward 为 ver 时）的行为

# 显式模式：
# --up --down 显式指定上传或下载，若状态不一，必须使用 --overwrite

# # 对齐
# rola align # 查看所有本地 view 和实际结构不一致的情况（移动、新增、丢失）
# rola align 移动项 --connect 丢失项
# rola align 丢失项 --connect 移动项 # 匹配为移动
# rola align 移动项 --confirm # 确认移动
# rola align 新增项 --confirm # 确认新增
# rola align 丢失项 --confirm # 确认丢失 (为删除)
# rola align --confirm-all # 全部确认（谨慎！）
# rola align 移动项 --break # 断开为丢失和新增
# rola align 项 # 查看项

# # view 之间操作 (--overwrite 覆写)
# rola send 文件 --to-view view # 将该文件发送到view（同当前view的位置）
# rola send 文件 --to-view view --path # 将文件发送到view（指定位置）
# rola send view:文件 --to-view ... # 使用指定view的文件
# rola send view:文件 --to-view THIS # 从其他view拉取文件到此处
# rola send bucket/view:文件 --to-view THIS # 从远程view拉取文件到此处

# # 直接 view-tree 操作（危险的修复行为）
# rola op-view-tree rm path # 删除某条路径记录
# rola op-view-tree add path --id 文件id # 新增某条路径记录
# rola op-view-tree set path --forward xx --id xx # 修改某条路径记录
# rola op-view-tree mv path ... path2 # 移动某条路径记录
# rola op-view-tree cp path ... path2 # 移动某条路径记录
# rola stack view1 view2 view3 ... --clone-into view4 (将view1 view2 view3的视图堆叠成一个视图，放置到view4)
# rola stack ... --into view4 (同上，但是会删除旧视图)
# rola op-idmap ls # 列出所有 id map
# rola op-idmap ls id # 列出关于该 id 的映射
# rola op-idmap ls --remote id # 反向查找：通过远程 id 查找本地 id
# rola op-idmap write 12 --to-remote 25 # 将 12 号 id 映射到 远程 id 25
# rola op-idmap clean 12 # 将 12 号 id 映射移除
# rola op-idmap clean --remote 12 # 将映射到远程12号id的本地id移除

# # 查询操作
# rola query bind-buckets
# rola query views
# rola query idmaps
# rola query objects

# # 视图查看
# rola ls # 等效别名 (rls)：展示当前目录的元数据（富有rola元数据的ls命令）
# rola tree # 等效别名 (rtree): 展示当前目录的树

# # GUI
# rola desktop --install # 安装 RorolalaVCS - Dashboard
# rola desktop # 启动 RorolalaVCS - Dashboard

# # 更新
# rola source show # 展示远程更新源
# rola source update-info # 更新远程信息
# rola source update # 更新rola
# rola source change 源 # 切换更新源
# rola source show-info # 查询更新信息

# # 交互式
# rola op-view-tree --shell-mode # 进入 REPL 直接使用 cd ls rm add set mv 操作 tree