安装指南

Windows 安装

  1. 前往 下载页面GitHub 发行页面 下载最新的安装程序 (jodo-1.2.0-x86_64.msi)
  2. 双击安装文件并按照安装向导进行操作
  3. 安装完成后,打开命令提示符或 PowerShell,输入 jodo --version 验证安装是否成功

从 GitHub 直接安装

# 克隆仓库
git clone https://github.com/JoyinJoester/JODO.git
cd JODO

# 编译安装
cargo build --release
sudo cp ./target/release/jodo /usr/local/bin/
sudo chmod +x /usr/local/bin/jodo

使用 Cargo 从 GitHub 直接安装

cargo install --git https://github.com/JoyinJoester/JODO.git

基本用法

添加新任务

jodo 完成项目报告

添加带有截止日期的任务

jodo 完成项目报告 -t 2023-12-31

列出所有任务

jodo -l
# 或者简单地输入
jodo

任务管理

编辑任务内容

jodo -e 1 更新后的任务内容

修改任务截止日期

jodo -e 1 -t 2023-12-25
# 快捷方式
jodo -t 1 2023-12-25

标记任务为已完成

jodo -c 1
# 一次完成多个任务
jodo -c 1 2 3

取消任务完成标记

jodo -u 1c

注意:已完成的任务 ID 会添加 'c' 后缀,例如:'1c'

标记任务为重要

jodo --star 1

取消任务重要标记

jodo --unstar 1

删除任务

jodo -d 1
# 一次删除多个任务
jodo -d 1 2 3

查看任务详情

jodo --show 1

批量操作

批量编辑任务截止日期

# 设置 ID 5 至 8 的任务截止日期为当月 22 日
jodo -e 5to8 -t 22
# 等效写法
jodo -e 5-8 -t 22

批量标记任务为完成

# 将任务 1 至 5 标记为完成
jodo -c 1-5
# 等效写法
jodo -c 1to5

批量取消完成标记

# 将已完成任务 1c 至 5c 标记为未完成
jodo -u 1c-5c
# 等效写法
jodo -u 1cto5c

批量删除任务

# 删除任务 1 至 3
jodo -d 1-3
# 等效写法
jodo -d 1to3

高级功能

批量添加模式

# 进入批量添加模式
jodo -m

# 示例会话:
jodo$> 完成第一项任务
jodo$> 完成第二项任务
jodo$> 学习 Rust 编程
jodo$> exit  # 退出批量模式

子命令形式

jodo list                # 列出所有任务
jodo done 1              # 标记任务 1 为完成
jodo undo 1c             # 标记任务 1c 为未完成
jodo remove 1            # 删除任务 1
jodo edit 1 "任务内容"    # 编辑任务 1 的内容
jodo edit 1 -t 2023-12-31 # 编辑任务 1 的截止日期
jodo star 1              # 标记任务 1 为重要
jodo unstar 1            # 取消任务 1 的重要标记
jodo show 1              # 显示任务 1 的详细信息

多语言支持

切换语言

# 切换到英文
jodo -L en

# 切换到中文
jodo -L zh-cn

# 切换到日语
jodo -L ja

常见问题

Cargo.lock 版本兼容性问题

如果您在不同设备上编译时遇到与 Cargo.lock 文件相关的错误,这可能是因为格式版本不兼容。

本项目中,Cargo.lock 使用了版本 4 格式,但某些旧版本的 Rust 或 Cargo 可能只支持版本 3。

解决方法:

  1. 修改 Cargo.lock 文件:

    # 将 Cargo.lock 文件中的 "version = 4" 改为 "version = 3"
    sed -i 's/version = 4/version = 3/' Cargo.lock
  2. 或者更新您的 Rust 工具链:

    rustup update
  3. 或者完全重新生成 Cargo.lock:

    rm Cargo.lock
    cargo build

注意:Cargo.lock 版本 4 是在 Rust 1.62.0 中引入的,如果您使用的是较旧的 Rust 版本,将会遇到兼容性问题。