To Do
项目地址: https://gitcode.com/gh_mirrors/ta/taskell - 添加第一个任务
In Progress
Done
### 基础导航
Taskell界面由三部分组成：状态栏、看板区域和操作提示。核心导航键与Vim保持一致：
| 操作 | 快捷键 | 说明 |
|------|--------|------|
| 任务选择 | `j`/`k` | 上下移动选择任务 |
| 列表切换 | `h`/`l` | 在不同列间切换 |
| 任务编辑 | `e` | 编辑当前选中任务 |
| 添加任务 | `a` | 在当前列表底部添加 |
| 添加列表 | `N` | 创建新列表 |
| 完成任务 | `空格` | 将任务移至下一列 |
| 退出程序 | `q` | 保存并退出 |
### 任务管理流程
**实战示例**：创建带截止日期和子任务的开发任务
1. 按`N`创建"开发任务"列表
2. 选中列表按`a`添加任务"用户认证模块"
3. 按`@`设置截止日期：`2025-03-15`
4. 按`Enter`进入详情模式，添加子任务：
- [ ] 实现登录表单
- [ ] 添加JWT验证
- [ ] 编写单元测试
5. 按`Esc`返回，任务自动保存
## 配置系统：打造专属工作环境
Taskell采用XDG基础目录规范，配置文件位于`~/.config/taskell/`，支持深度定制以适应个人工作习惯。
### 核心配置文件
| 文件名 | 作用 | 关键配置项 |
|--------|------|------------|
| `config.ini` | 主配置 | 列宽、默认文件名、时间格式 |
| `bindings.ini` | 按键绑定 | 自定义快捷键 |
| `theme.ini` | 主题设置 | 颜色方案、指示器样式 |
| `template.md` | 新建文件模板 | 默认列表结构 |
### 实用配置示例
**优化显示效果**（`config.ini`）：
```ini
[layout]
padding = 2
column_width = 40
column_padding = 4
description_indicator = "📝"
statusbar = true
[markdown]
title = "##"
task = "-"
subtask = " - [ ]"
localTimes = true
Vim风格增强绑定（bindings.ini）：
# 导航增强
firstTask = gg
lastTask = G
nextList = L
prevList = H
# 编辑增强
insertAbove = O
insertBelow = o
deleteTask = dd
项目特定配置：
# 使用自定义配置文件启动
taskell -c ~/.config/taskell/work.ini project.md
数据集成：Trello与GitHub无缝对接
Taskell支持从Trello和GitHub Projects导入数据，实现现有工作流的平滑迁移。
Trello导入全流程
-
获取访问令牌： 访问Trello开发者页面生成令牌，保存到配置文件：
[trello] token = your_trello_token_here -
导入看板：
# 获取看板ID（在Trello地址栏查看） taskell -t TRELLO_BOARD_ID imported-trello.md -
数据映射关系：
Trello元素 Taskell对应项 处理方式 列表(List) 列表(List) 直接转换 卡片(Card) 任务(Task) 保留标题和描述 检查项 子任务 转换为Markdown列表 到期日 到期日 转换为ISO格式 标签 标签 作为任务前缀保留
GitHub Projects集成
-
配置访问令牌：
[github] token = your_github_personal_token -
导入项目：
# 导入组织项目 taskell -g orgs/your-org github-project.md # 导入仓库项目 taskell -g repos/your-user/your-repo repo-project.md
⚠️ 注意：GitHub导入目前仅支持项目列和卡片标题，描述和评论将在未来版本中支持。
数据同步工作流
高级技巧：效率倍增的隐藏功能
搜索与筛选
Taskell内置强大的搜索功能，按/进入搜索模式：
- 模糊匹配：输入部分文本自动匹配任务
- 正则支持：
/^bug\s+/匹配以"bug "开头的任务 - 筛选模式：
/due:today显示今日到期任务
批量操作
利用Vim风格命令实现批量处理：
5j：向下移动5个任务d3d：删除3个任务>G：将当前到末尾的任务右移一列
脚本集成
通过命令行参数实现外部集成：
# 从外部添加任务
echo "- 新任务" >> taskell.md
# 结合cron定期生成报告
taskell --export csv | mail -s "每周任务报告" user@example.com
版本控制集成
将任务文件纳入Git版本控制：
# 初始化仓库
git init
git add taskell.md
git commit -m "Initial task board"
# 比较任务变更
git diff taskell.md
主题定制：终端美学与个性化
Taskell支持深度主题定制，通过theme.ini文件调整界面元素样式。
预设主题方案
暗黑主题（theme.ini）：
[default]
default.bg = black
default.fg = white
[other]
title.fg = brightGreen
statusBar.bg = brightBlue
taskCurrent.fg = brightMagenta
subtaskComplete.fg = yellow
极简主题：
[default]
default.bg = default
default.fg = default
[other]
title.fg = blue
taskCurrent.fg = green
颜色系统
支持的颜色值包括：
- 基础色：
black,red,green,yellow,blue,magenta,cyan,white - 亮色变体：
brightBlack到brightWhite - 系统默认：
default
终端字体优化
推荐使用支持Powerline符号的字体：
- Fira Code
- Source Code Pro
- JetBrains Mono
版本控制：任务历史与协作
Taskell的Markdown存储格式天生支持版本控制，实现团队协作和历史追踪。
协作工作流
-
创建共享仓库：
git init --bare team-tasks.git -
团队成员克隆：
git clone team-tasks.git cd team-tasks taskell team.md -
冲突解决策略：
- 使用
git merge --abort放弃冲突合并 - 手动编辑Markdown文件解决冲突
- 采用"最后编辑者胜出"原则
- 使用
历史追踪
查看任务变更历史：
# 查看特定任务的修改记录
git log -L /## To Do/,/## In Progress/:taskell.md
未来展望：即将发布的重磅功能
根据开发路线图，Taskell将推出以下关键功能：
计划功能（2025 Q2）
- 双向同步：Trello和GitHub双向更新
- 标签系统：支持彩色标签和筛选
- 报告生成：基于任务数据生成统计图表
- 多面板布局：同时显示多个任务文件
实验性功能
- 无限层级子任务
- 自定义视图模式
- 集成CI/CD状态显示
常见问题与性能优化
性能调优
处理大型看板：
- 拆分大型文件为多个小型文件
- 禁用动画效果（
config.ini中设置animation = false） - 减少列宽和列表数量
启动速度优化：
[general]
# 禁用启动检查
checkUpdates = false创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
