Worklog 是一个刚开源不久的本地优先项目管理工具，桌面壳用 Tauri v2，界面是 SvelteKit，数据全部存在本地一个 SQLite 文件里。
说白了就是一块离线看板，Backlog、Todo、In Progress、Done 四列，不依赖任何云服务，也不用注册账号。装完打开就能用，我在自己的两三个小项目上试了一周，确实清爽。
01 它到底是什么，思路野在哪里
它的数据就是一个文件：工作区目录下面的 .worklog/worklog.db。整个团队的项目状态都装在这个文件里，没有云端数据库，也没有账号体系。想换电脑，把这个目录拷走就行。
项目是 MIT 协议，两百多 Star、二十几个 Fork，四百多次提交、四十多个 tag，还在活跃更新。架构分三层：界面层是 SvelteKit 加 TypeScript，中间的 hooks 层处理异步逻辑，底下的 repository 层负责操作 SQLite。运行时用的是 Bun 而不是 Node.js，装依赖和构建都快一截。
02 功能盘点：十个里有几个是真日常用的
看板就是最朴素的那种。没有泳道，没有子任务嵌套，一张卡一个标题，拖到对应列就完事。点开一条 Ticket 是详情面板，描述区能写 Markdown，写完切预览看渲染效果，下面还能挂评论。右键菜单里有移动、删除、编辑，选中一条按 M 直接推到下一列。
表格视图是我用得第二多的。有时候要一口气扫几十条 Ticket，谁在干什么、哪些快到期、哪些卡太久没动，看板来回翻太慢。切到表格就一行行排开，列头能点排序，筛选栏敲个名字就只看某个人的任务。周五写周报的时候切过来从上往下撸，十分钟搞定。
甘特图能省掉 Excel。Ticket 设好开始和截止时间，切过去时间轴上就排好了，哪几个任务撞期一眼能看出来。以前排期我一直用 Excel 画色条，改一个时间全部重画，现在直接改日期，图自己跟着变。它比不上专业工具那种带依赖线的甘特图，但日常排期够用。
命令面板是 Cmd+K，跟 VS Code 一个手感。新建 Ticket、切换看板、打开设置、手动触发一次同步，都能敲出来，不用在菜单里翻。快捷键也齐，新建 Ticket 是 Cmd+N，新建看板是 Cmd+B，手动同步是 Cmd+S，缩放加减和复位对应加号减号与 0。这些都能按自己的习惯改。
另外两个视图值得单独提。日历视图按截止日期把 Ticket 散到格子里，周一早上切过去看一眼，这周的节奏心里就有数，它和甘特图的分工是短长期各管一段。撤销重做则是给数据库加了一张 events 表，创建、修改、删除、移动、归档、恢复全部记录，工具栏多了 Undo 和 Redo。这张表还能当审计日志用，谁什么时候改了哪条 Ticket 的什么字段，翻表就能查。
03 同步交给 Git：这一招的账要算清楚
它的同步思路很直白——既然数据就是一个文件，那就交给 Git。在设置里绑一个仓库地址和分支名，它就在后台定时把这个文件 commit 再 push，间隔可以调，策略是先拉再推。三五个人共用同一个仓库的话，谁的看板改了都能同步过去。
但这笔账得算清楚。它换掉的是搭服务器和订阅的费用，代价是同步不是实时的，而且要处理冲突。把同步交给 Git，换来的是不用自己维护一套后端，代价是每一次同步都可能变成一次冲突处理。团队里几个人同时挪同一张卡，冲突就得人工收拾。人少、改动分散的时候没问题；人一多、手一快，这就会变成主要摩擦。
04 几个不起眼但每天都用到的小事
看图的时候切亮色，写代码的时候切回暗色。默认是暗色，亮色模式的对比度调得还行。全局缩放能从 50% 调到 200%，27 寸屏上缩到 80%，换到 13 寸笔记本开到 120%，很省事。
看板做完了不用删，归档就行，侧边栏不显示但数据还在，随时能恢复。它还集成了 Inlang 这个国际化框架，目前以英文界面为主，框架搭好了，愿意贡献翻译的话门槛不高。设置面板把同步配置、外观、快捷键、事件日志集中在一处，不散。
05 安装、配置与打开同步
装法不难，官网和 GitHub 的 Releases 页面都有各平台的包。Linux 上 Debian 和 Ubuntu 用户可以直接配 APT 仓库，导入密钥之后就能用系统的更新流程升级：
sudo mkdir -p /usr/share/keyrings
curl -fsSL https://regisx001.github.io/worklog-apt/pubkey.asc \
| sudo gpg --dearmor -o /usr/share/keyrings/worklog-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/worklog-archive-keyring.gpg] https://regisx001.github.io/worklog-apt any main" \
| sudo tee /etc/apt/sources.list.d/worklog.list
sudo apt update && sudo apt install worklog
Arch 用户走 AUR 一条命令搞定：
yay -S worklog-bin
AppImage 有个坑要提前知道。在 Arch 这类滚动更新的发行版上，它可能一启动就报 EGL_BAD_PARAMETER 然后崩掉，原因是包里带的 Wayland 库和新版合成器打架，可以强制用系统的库绕过去：
LD_PRELOAD=/usr/lib/libwayland-client.so ./worklog_1.5.2_amd64.AppImage
官方其实更推荐 DEB、RPM 或者 AUR 这几个包，系统集成更好。体积上也要说一句：exe 是 8 MB，dmg 12 到 13 MB，deb 和 rpm 都是 11.7 MB，但 AppImage 有 88.7 MB，因为它把运行时一起打了进去。
06 建第一块看板，把同步接上
装完打开第一步是选一个本地目录当 Workspace，随便建个空文件夹指过去就行，它会在里面建数据目录。进去之后左侧边栏有 New board，起个名字就出一块空看板，往 Backlog 里扔几条 Ticket 试试手感。Ticket 的标题写好，点开详情可以补描述、设优先级、加标签、定截止日期。
团队要协作的话，进 Settings 找到 Git Sync 那一栏，填上仓库地址和分支名，间隔默认 5 分钟，按需要改。这里有个前提：先把 Git 仓库 init 好并且远程能通，不然同步会直接报错。日常操作基本靠键盘，Cmd+N 建 Ticket，Cmd+B 建看板，Cmd+K 搜任何操作，Esc 关详情面板。
07 它和 Jira 不是一类东西
它没有 Sprint，没有燃尽图，没有自动化规则，也连不了 Slack 和飞书。它就是一块本地的看板，轻、快、数据透明。
所以它适合的是一个人管几个项目，或者带三五个人的小团队。你要是需要跨部门排期、要报表、要跟 IM 打通，它不是干这个的，别拿它去顶 Jira。
开源地址是 https://github.com/regisx001/Worklog 。
如果你也在找轻量本地优先的项目管理工具，欢迎来云栈社区聊聊你的方案。
发表于 3 小时前
|
查看: 5|
回复: 0
