tlm

环境要求

• Go 1.22 或更高版本（使用 Go Install 方式时）
• 本地已安装并运行 Ollama 服务
• 操作系统为 macOS、Linux 或 Windows
• 终端 shell 为 PowerShell、Bash 或 Zsh 之一

安装与启动步骤

1. 1安装 tlm

   README 推荐直接用安装脚本，脚本会自动识别平台架构；若本机已有 Go 1.22+，可用如下 Go 安装命令。安装脚本的具体命令 README 未给出，请到仓库 Installation 一节查看。

   go install github.com/yusufcanb/tlm@1.2

   复制

2. 2验证安装

   README 明确说明用该命令检查安装是否成功，会打印 tlm 的帮助信息与可用子命令列表。

   tlm

   复制

3. 3配置模型与 shell

   用 config 子命令配置语言模型、风格和 shell。tlm 会自动识别 PowerShell、Bash、Zsh，也可在此手动调整。

   tlm config

   复制

4. 4生成命令建议

   用 suggest（简写 s）把自然语言需求转成命令，可用 --model 覆盖默认模型，用 --style 选择风格。

   tlm suggest "count lines of a file"

   复制

5. 5解释一条命令

   用 explain（简写 e）解释已有命令的含义，可临时指定其他模型，例如改用 llama3.2:1b。

   tlm explain "tar -xzvf archive.tar.gz"

   复制

6. 6带上下文提问

   用 ask 提问（beta），通过 --context 指定目录、--include 指定文件模式，实现免配置的 RAG 检索增强问答。

   tlm ask --context . --include *.md "what does this project do"

   复制

关键配置

如何确认成功

在终端执行 tlm，能正常打印 NAME、USAGE、COMMANDS 等帮助信息并列出子命令，即安装成功。

常见问题

注意事项

• tlm 依赖本地 Ollama 提供模型服务，README 未给出 Ollama 的安装与拉取模型命令，使用前请先自行准备本地 Ollama 环境。
• README 推荐使用安装脚本方式安装，但未给出脚本具体命令，请到仓库 Installation Script 一节获取。
• Go Install 方式要求系统已安装 Go 1.22 或更高版本。
• 卸载时建议一并删除 ~/.tlm.yml，以清除模型、风格与 shell 配置。