机器的日志

通过 tTerm 在机器上运行的每条命令，都会成为这台机器日志中的一行：谁运行的、何时运行、结束状态、耗时，以及在哪里运行。日志由 tTerm 写入，任何人都无法更改。你可以在命令下面留下笔记。

打开日志

在侧边栏中，项目的笔记下面，第一个文件夹是日志，旁边标着由 tTerm 记录。里面是项目中每台机器的日志，机器旁边会显示今天在它上面运行了多少条命令：今天 12 条。点击一台机器，它的日志就会在标签页 web-01 日志中打开。

日志一次显示一天，打开时显示今天。前一天和后一天这两个箭头会跳到最近一个有记录的日子。今天会让日志回到今天，选择日期会打开日历。日志显示今天时，每有一条命令结束，就会出现新的一行。

日志顶部的 ⋯ 中有复制为 Markdown：复制当前显示的这一天，包括其中的各行和行下的笔记。

一行里有什么

每条命令占一行：时间、谁运行的、命令本身（太长时会被截断），以及它下面有几篇笔记。右侧是耗时、目录、git 分支和终端。失败的命令带有一个叉号和它的退出码：退出码 1。在命令之间，日志还会记下终端何时打开、何时结束，以及机器何时移到了另一个项目：这台机器由你从 Personal 移到 Client X。

点击一行即可展开：完整的命令、它的输出和下面的笔记。再点击一次就会收起。较长的输出只显示前几行：显示全部 27 行会显示其余部分，复制输出会复制整个输出。

把鼠标悬停在一行上或展开它，这一行上就会出现 ⋯：其中有复制命令和复制此行的链接。这个链接会打开该行所在那一天的日志，并且这一行已经展开。

查找和筛选

在日期下方的那一排中，在此日志中查找会搜索整个日志，最远可追溯一年：找出包含你输入的所有词的命令，以及笔记中包含所有这些词的命令。按 / 可以直接跳到这里。找到的结果按天分组：点击一行即可展开，打开这一天会跳到它所在的那一天。搜索会一直保留，直到你清除它；返回当天会回到你之前查看的那一天。

旁边是排序方式和筛选条件：

• 点击一下，最早的在前就会变成最新的在前，这个浏览器会记住你的选择。
• 所有人：只显示某一个人的行，即运行了命令或在命令下写了笔记的人。
• 失败的：只显示失败的命令。
• 有笔记的：只显示下面有笔记的命令。
• 所有终端：只显示某一个终端的命令。只有当这些行来自不止一个终端时，才会出现这个筛选。

开启筛选后，日期旁会注明当前显示多少条命令，例如 8 条命令中的 2 条；清除筛选会关闭所有筛选。筛选同样适用于在此日志中查找找到的结果。

搜索也会查找你所有机器的日志：以 l: 开头即可。

命令下的笔记

把鼠标悬停在一行上，点击添加笔记。在终端中，命令的块上也有同样的按钮，提示文字是为这条命令添加笔记。无论在哪里添加，笔记都会同时显示在日志中那一行的下面和终端中那个块的下面。Enter 保存笔记，Shift+Enter 换行，Esc 取消。

笔记会按原样留在日志中：不能编辑，也不能删除，只能回复。点击笔记下方的回复即可写下回复。每篇笔记都会显示是谁、在什么时候写的；在日志中，笔记旁边的 ⋯ 里有复制文本。

抹除密码或令牌

混入命令或笔记中的密码或令牌可以抹除。只有项目的所有者或管理员可以这样做。目前每个项目里都只有你一个人，你就是所有者。

1. 在日志中，点击那一行上或那篇笔记旁边的 ⋯，选择抹除…。

2. 在弹出的窗口中，在原因下写明这是什么：密码、令牌。

3. 点击抹除。

这些文字会从日志、终端中的命令块、搜索和输入行的历史记录中永久消失。如果抹除的是命令，它的输出也会一并消失，这条命令在项目中其他地方运行过的记录也会一起抹除。日志会在原处记下是谁、在什么时候、为什么抹除的：由你抹除 · 09:23 · 密码。数据库每晚的备份中仍会保留这些内容，直到这些备份被删除，最长不超过两周。

保留多久

日志行保留一年，行下的笔记会随这一行一起删除。命令的输出保留 30 天：之后，把鼠标悬停在你运行的命令所在的行上，会显示输出未保留。机器一旦被移除，它的日志就再也打不开了。

日志跟着机器走。机器移到另一个项目时，会把整个日志都带过去，包括移动之前的行，那个项目中的每个人都能读到它们。删除机器原来所在的项目，日志中的任何内容都不会因此被带走。