当前位置：首页 > news >正文

Lathe CLI命令大全：掌握lathe serve、skills install等必备指令

news 2026/6/16 6:04:47

Lathe CLI命令大全：掌握lathe serve、skills install等必备指令

【免费下载链接】latheGenerate hands-on, multi-part technical tutorials on demand, with LLM skills tuned to make content approachable. Then you work through them yourself, by hand ✋项目地址: https://gitcode.com/gh_mirrors/lat/lathe

想要快速生成动手实践的技术教程吗？Lathe是一个革命性的工具，它能让你通过简单的命令行操作生成和管理多部分技术教程。无论你是编程新手还是经验丰富的开发者，掌握Lathe的CLI命令都能极大地提升你的学习效率。本文将为你详细介绍Lathe的所有核心命令，从基础安装到高级功能，让你全面掌握这个强大的学习工具。

📦 安装与基础配置

首先，你需要安装Lathe。根据你的操作系统选择以下任一方式：

Homebrew(macOS推荐)：

brew install devenjarvis/tap/lathe

安装脚本：

curl -sSf https://raw.githubusercontent.com/devenjarvis/lathe/main/install.sh | sh

Go安装：

go install github.com/devenjarvis/lathe@latest

安装完成后，验证安装是否成功：

lathe --version

🚀 核心命令详解

1.`lathe serve`- 启动教程Web服务器

这是最常用的命令，用于启动本地Web服务器并打开浏览器：

lathe serve

默认端口是4242，你可以使用--port参数指定其他端口：

lathe serve --port 8080

这个命令会自动打开浏览器，显示你所有已存储的教程。界面支持亮色和暗色主题，你可以根据自己的喜好切换。

2.`lathe skills`- 技能管理命令组

Lathe与多种AI编程助手集成，通过技能系统提供无缝体验：

列出所有可用技能：

lathe skills list

这个命令会显示Lathe内置的所有技能，包括：

/lathe- 生成新教程
/lathe-extend- 扩展现有教程
/lathe-verify- 验证教程
/lathe-ask- 询问教程相关问题
/lathe-tag- 管理教程标签
/lathe-voice- 创建自定义写作风格

安装技能到AI助手：

# 安装到Claude Code（当前项目） lathe skills install # 安装到用户目录（所有项目） lathe skills install --user # 安装到特定AI助手 lathe skills install --agent cursor # Cursor lathe skills install --agent codex # Codex lathe skills install --agent gemini # Gemini CLI lathe skills install --agent opencode # opencode lathe skills install --agent cline # Cline lathe skills install --agent windsurf # Windsurf # 安装到所有支持的AI助手 lathe skills install --agent all

3.`lathe store`- 存储教程

当你使用AI助手生成教程后，需要将其存储到本地：

lathe store <slug>

其中<slug>是教程的唯一标识符。这个命令会将生成的教程保存到~/.lathe/tutorials/<slug>/目录中。

4.`lathe extend`- 扩展现有教程

为现有教程添加新的部分：

lathe extend <slug>

你还可以提供扩展指导：

lathe extend <slug> --guidance "添加关于错误处理的部分"

这个命令会输出一个/lathe-extend命令，你可以将其粘贴到AI助手中执行。

5.`lathe verify`- 验证教程

验证教程是否能够正确运行：

lathe verify <slug>

验证过程会在临时目录中运行所有代码步骤，确保教程的每个部分都能正常工作。如果缺少必要的工具链，验证会被标记为"跳过"而不是"失败"。

6.`lathe tag`- 管理教程标签

为教程添加、设置或删除标签，方便后续搜索和分类：

# 设置标签（替换所有现有标签） lathe tag <slug> --set rust,web,backend # 添加标签 lathe tag <slug> --add database # 删除标签 lathe tag <slug> --remove web # 同时添加和删除标签 lathe tag <slug> --add performance --remove backend

标签在Web界面中显示为筛选条件，帮助你快速找到特定主题的教程。

7.`lathe voice`- 写作风格管理

Lathe支持不同的写作风格（称为"voice"），让你可以自定义教程的语气和风格：

列出所有可用风格：

lathe voice list

查看特定风格的详细信息：

lathe voice show plainspoken lathe voice show companion

设置默认写作风格：

lathe voice set-default companion

添加自定义写作风格：

# 从文件添加 lathe voice add my-style --file voice-spec.md # 从标准输入添加 cat my-voice.md | lathe voice add custom-voice --file -

删除自定义风格：

lathe voice rm custom-voice

🎯 实用技巧与最佳实践

工作流程示例

生成新教程：

# 在AI助手中输入 /lathe 用Rust构建一个简单的HTTP服务器

存储教程：
```
lathe store rust-http-server
```
查看教程：
```
lathe serve
```

扩展教程：

lathe extend rust-http-server # 复制输出的命令到AI助手

验证教程：
```
lathe verify rust-http-server
```

教程组织结构

所有教程都存储在~/.lathe/tutorials/目录下，每个教程有自己的文件夹：

~/.lathe/tutorials/ rust-http-server/ metadata.json part-01.md part-02.md python-data-analysis/ metadata.json index.md

metadata.json包含教程的元数据，如标题、标签、创建时间、状态等。

搜索与筛选

在Web界面中，你可以：

搜索：按标题、主题、标签、仓库和工具版本搜索
排序：按最新、最旧或标题排序
筛选：按状态、类型（单部分vs系列）、标签和版本筛选

🔧 高级功能

本地/自托管模型支持

Lathe本身不直接调用任何AI模型，所有模型工作都在你的AI助手会话中运行。这意味着你可以轻松使用本地LLM：

配置你的AI助手连接到本地OpenAI兼容端点（如Ollama的http://localhost:11434/v1）
像平常一样使用/lathe技能
Lathe会自动处理教程的存储和管理

来源跟踪

每个教程都会记录生成过程中参考的所有来源URL。这提供了完整的溯源信息，让你可以验证教程内容的可靠性。

在教程阅读页面，你可以看到"Researched against N sources"部分，点击展开可以查看所有参考链接。

练习部分

每个教程最后都包含"留给你练习"的部分，鼓励你应用所学知识进行实践。这些练习通常包括：

扩展功能
优化性能
添加错误处理
实现额外特性

🚨 故障排除

常见问题

技能安装失败：
- 确保你有项目目录的写入权限
- 检查AI助手的技能目录配置
- 尝试使用--user标志安装到用户目录
Web服务器无法启动：
- 检查端口4242是否被占用
- 使用--port指定其他端口
- 确保有网络访问权限
教程验证失败：
- 确认所需工具链已安装
- 检查临时目录权限
- 查看~/.lathe/tutorials/<slug>/verify-result.json了解详细错误