预告

老苏在 7 月份收到了付费合集功能灰度测试的通知，一直想研究下怎么玩的，所以国庆期间准备了三篇👇

简单的豆瓣API接口（安装篇）
简单的豆瓣API接口（TaleBook篇）
简单的豆瓣API接口（Jellyfin篇）

预计在周四、周六、周日晚，分三次发布，一、三、五的正常发文不受影响

按照公众号的规则，每篇文章最小售价为 1 个微信豆，所以合集的售价为 3 个微信豆

老苏发现微信豆这玩意儿还有汇率差，iOS 1元=7微信豆，安卓 1元=10微信豆 😂，是因为苹果收了税吗？

为公平起见，这三篇文档不会在微信公众号之外的地方再进行发布。

本文完成于 5 月底，对应的版本为 0.2.3

什么是 Traggo ？

Traggo 是基于标签的时间跟踪工具。在 Traggo 中，没有任务，只有标记的时间跨度。

可以用来跟踪、分析你每天的时间都用在哪些地方，方便你更好的管理时间，提高自己的效率。

除了我们演示的 Docker 版之外，还有桌面客户端版本

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 traggo ，选择第一个 traggo/server，版本选择 latest。

卷

在 docker 文件夹中，创建一个新文件夹 traggo，并在其中建一个子文件夹 data

文件夹	装载路径	说明
`docker/traggo/data`	`/opt/traggo/data`	存放设置

端口

本地端口不冲突就行，不确定的话可以用命令查一下

# 查看端口占用
netstat -tunlp | grep 端口号

本地端口	容器端口
`3030`	`3030`

环境

可变	值
`TRAGGO_DEFAULT_USER_NAME`	缺省的账号
`TRAGGO_DEFAULT_USER_PASS`	对应的密码

命令行安装

如果你熟悉命令行，可能用 docker cli 更快捷

# 新建文件夹 traggo 和 子目录
mkdir -p /volume2/docker/traggo/data

# 进入 traggo 目录
cd /volume2/docker/traggo

# 运行容器
docker run -d 
   --restart unless-stopped 
   --name traggo 
   -p 3030:3030 
   -v $(pwd)/data:/opt/traggo/data 
   -e TRAGGO_DEFAULT_USER_NAME=admin 
   -e TRAGGO_DEFAULT_USER_PASS=mynewpassword 
   traggo/server:latest

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

version: "3.7"

services:
  traggo:
    image: traggo/server:latest
    container_name: traggo
    ports:
      - 3030:3030
    environment:
      TRAGGO_DEFAULT_USER_NAME: "admin"
      TRAGGO_DEFAULT_USER_PASS: "mynewpassword"
    volumes:
      - ./data:/opt/traggo/data

然后执行下面的命令

# 新建文件夹 traggo 和 子目录
mkdir -p /volume2/docker/traggo/data

# 进入 traggo 目录
cd /volume2/docker/traggo

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中输入 http://群晖IP:3030 就能看到登录界面

用前面设置的账号、密码登录成功后的主界面

系统设置

很可惜，不支持中文，默认是 English，老苏选了 English24h，意思是采用 24 小时计时方式

新建标签

第一步先创建 tags，用不同的颜色做区分

老苏把现在每天主要的事情分为了 抗疫、折腾、工作 和 休息 四个类别

时间列表

进入 List 菜单，通过 start 新建

新建了一些，其中 Active Timers 是还在进行（正计时）或者还没开始的（倒计时），下面是已经完成了的

Calendar 是另一种查看的视图，本身又支持 DAY 和 WEEK

汇总统计

Manage –> Create Dashboard

从左侧菜单进入刚创建的 Dashboard –> Edit Dashboard –> +，设定时间范围，直接用了默认的

点 Add Entry，可以选择各种图表，例如：BarChart（条形图）

可以拖拽改变位置和大小

退出编辑状态后，已完成的事件会出现在表中

小技巧

Add Entry 时，最下面的 Tags 可能会点不出来，先随便输入一个字母。比如：a，

然后再用退格键删除，tags 就会显示了

也许是因为使用了中文 tags 带来的问题，当然这只是老苏的猜测，并没有去验证。

参考文档

traggo/server: self-hosted tag-based time tracking
地址：https://github.com/traggo/server

traggo
地址：https://traggo.net/

Installation – traggo
地址：https://traggo.net/install/

@所有人：写文不易，如果你都看到了这里，请点个赞和在看，分享给更多的朋友；为确保你能收到每一篇文章，请主页右上角设置星标。