> ## Content Index
> Fetch the complete content index at: https://www.macjc.cn/llms.txt
> Use this file to discover other available public pages before exploring further.

# 开源工具实用教程：Lux 下载、Terax 工作台、diagram-design 图表上手实录
- URL: https://www.macjc.cn/kaiyuan-gongju-shizhan-jiaocheng/
- Published: 2025-09-30T01:31:10.000Z
- Updated: 2026-09-22T17:04:15.000Z
- Description: 开源工具卡住多数人的不是操作，是心智模型。这篇按命令行、图形工作台、AI 模板三种形态分别演示完整上手。
- Author: Jamdou
- Tags: 实用教程, 开源项目, 效率工具

开源工具的文档通常只讲"能做什么"，很少讲"第一天该怎么用"。结果是很多人装完就放着，或者卡在第一步的环境配置上。

这篇拿三个不同类型的开源项目做完整上手演示：一个命令行下载工具、一个图形化工作台、一套 AI 图表模板。三个覆盖了开源工具最常见的三种形态。

## 先说结论：

- **Lux 是命令行工具**，装好即用，核心是记住三四个参数，不需要理解原理。
- **Terax AI 是图形化工作台**，重点在配置 AI 模型和熟悉单窗口布局，第一次花二十分钟配一次，之后不用再管。
- **diagram-design 不是软件而是一套提示词模板**，用法是复制粘贴给 AI，这个心智模型不转过来会觉得"这项目什么都没有"。
- **三个工具能串成一条链路**：下载素材 → 在工作台里处理 → 输出图表。

## 一、Lux：跨平台视频下载，三步跑通

Lux 的定位很克制：一个命令行下载工具，支持大量视频站点，跨平台，体积只有几 MB。适合做素材收集、网课归档、自媒体积剪。

### 第一步：安装

三个平台的安装方式：

| 平台      | 安装方式                  | 备注             |
| ------- | --------------------- | -------------- |
| Windows | 下载 exe 放入 PATH，或用包管理器 | 需确保命令行能找到可执行文件 |
| macOS   | brew install lux      | Homebrew 一键装   |
| Linux   | 下载二进制或源码编译            | 需 Go 环境（源码方式）  |

### 第二步：基础用法

最常用的就是直接跟链接：`lux "视频地址"`。加 `-o` 指定输出目录，加 `-i` 读取批量链接列表文件。

想先看有哪些清晰度可选，用 `-i` 之外可以加 `--info` 类参数查看可选格式，再决定下哪个。

### 第三步：批量处理

把要下的链接逐行写进一个 txt，然后 `lux -i list.txt`。这是做系列素材收集时最省事的方式。

注意两点：**遵守目标站点的使用条款**，只下载自己有权限的内容；**注意磁盘空间**，批量任务容易撑爆目录。

## 二、Terax AI：7MB 工作台的第一次配置

Terax AI 用 Tauri2 + Rust 写成，把终端、编辑器、Git 可视化、网页预览、AI 助手整合进一个窗口，安装包只有 7MB，协议 Apache-2.0，无遥测上报。

### 安装

- Windows / macOS / Linux：在 Releases 页面下载对应安装包。Windows 首次运行需选"更多信息 – 仍运行"。
- Arch Linux：`yay -S terax-bin`
- NixOS / Nix：`nix profile install github:crynta/terax-ai`
- 源码构建：`git clone` 后 `pnpm install` 再 `pnpm tauri dev`，需要 Rust 环境和 Node 20+。

### 第一次要做的三件事

- **配置 AI 模型**：云端可选 OpenAI、Claude、Gemini、Groq、DeepSeek 及任意 OpenAI 兼容接口；本地可选 Ollama、LM Studio、MLX，断网也能用。密钥存系统钥匙串，不明文落盘。
- **建 TERAX.md**：在项目根目录写这个文件记录技术栈和规范，AI 会读它作为项目记忆，回答准确率会明显提升。
- **保存工作区布局**：把常用标签页和分屏存下来，重启自动恢复。

### 值得先试的两个功能

一个是**AI 差分修改面板**：AI 改完代码逐块显示变更，可以一块块接受或拒绝，比整文件覆盖安全得多。另一个是**Plan 模式**：复杂任务自动拆解成多步，每步执行前要人工确认，避免误删文件。

## 三、diagram-design：把模板喂给 AI，而不是自己画

很多人第一次打开这个仓库会困惑：没有界面、没有可执行文件，只有一堆模板文本。因为它本质上是**给大模型用的提示词素材包**，不是绘图软件。

### 正确用法

- **第一步**：`git clone https://github.com/cathrynlavery/diagram-design.git` 或直接下载。
- **第二步**：在 29 套模板里挑一套贴合场景的（系统架构图、时序图、模块流程图、分层结构图、数据流图等）。
- **第三步**：把模板文本粘给 Claude Code 或 Cursor，加一句需求，比如"使用 diagram-design 模板，绘制 RAG 知识库系统架构图"。
- **第四步**：模型直接输出完整 SVG，保存成 `.svg` 文件即可使用。

相比 Mermaid 的优势很直接：输出原生 SVG 矢量图，不会布局错乱，配色干净，各类文档平台都兼容。MIT 协议，商用无负担。

局限也要知道：它不能可视化拖拽编辑，复杂超大架构图仍需少量手动微调。

## 四、三个工具的组合链路

单独用每个工具只是一点效率提升，串起来才有质变。一个典型链路：

- **Lux 下载素材**，输出到本地素材目录。
- **Terax AI 打开该目录**，用内置终端跑批量处理脚本，用编辑器改配置，用 Webview 预览结果。
- **diagram-design 生成流程图**，把整个处理流程画成图放进项目文档。

这条链路的价值在于：三个环节都在同一套工具里完成，不需要在下载器、IDE、绘图软件之间反复切换。

## 五、常见故障排查

| 现象            | 可能原因        | 处理办法                      |
| ------------- | ----------- | ------------------------- |
| 命令行提示找不到命令    | 未加入 PATH    | 检查环境变量，或改用完整路径调用          |
| 下载失败或速度极慢     | 站点限制或网络问题   | 确认链接有效，检查是否有地区限制          |
| Terax 首次启动被拦截 | 系统安全策略      | Windows 选"更多信息 – 仍运行"     |
| AI 功能无响应      | 未配置密钥或模型不可用 | 检查设置页，本地模型需先启动 Ollama 等服务 |
| 生成的图表样式不对     | 模板未完整粘贴     | 确保整段模板文本都被传给模型            |

## 六、常见问题

### 命令行工具一定要会写代码吗？

不需要。像 Lux 这类工具，常用的就三四个命令，照着文档敲即可。真正的门槛是"愿意打开终端"，而不是编程能力。

### Terax AI 能完全替代 VS Code 吗？

取决于插件依赖。如果你重度依赖 VS Code 的特定扩展，短期内不建议完全切换。但如果主要工作是终端命令加代码编辑，Terax 的单窗口体验反而更连贯，7MB 体积对低配机器也友好得多。

### diagram-design 输出的是图片还是代码？

是 SVG 矢量代码。可以直接保存成 .svg 文件，插入文档、PPT、网页都不会失真，也可以用代码编辑器微调颜色和文案。

### 这些工具的数据安全吗？

Terax AI 明确无遥测上报，密钥存系统钥匙串，且支持本地模型离线运行，对数据敏感场景比较友好。Lux 只是下载工具，不涉及数据上传。diagram-design 的输出由你使用的 AI 服务决定，用本地模型则不出本机。

### 怎么知道工具更新了？

命令行工具通常有 update 子命令或需要重新下载。图形工具建议开启 Release 通知（GitHub 的 Watch 设为只接收 Release）。公众号「酱豆随笔」也会跟踪这类项目的版本更新与替代方案。

## 七、小结

开源工具的上手门槛，大多卡在"心智模型不对"而不是"操作复杂"。Lux 是命令行的，Terax 是图形工作台的，diagram-design 是给 AI 用的模板——认清各自形态，剩下的只是几步固定操作。

公众号「**酱豆随笔**」的实用教程基本按这个思路写：先讲清工具是什么形态，再给可照做的步骤。配套的开源工具归档与延伸资料放在 [jamdou.com](https://jamdou.com/?ref=macjc.cn)，免费查阅。

## 延伸阅读

- [免费资源分享完全指南：GitHub 开源项目、素材站与效率工具的一站式获取路径](https://www.macjc.cn/mianfei-ziyuan-fenxiang-wanzheng-zhinan/)
- [GitHub 开源项目怎么找：8 个筛选维度与 5 类高价值仓库识别法](https://www.macjc.cn/github-kaiyuan-xiangmu-zenme-zhao/)
- [12 个办公提效开源项目实测：从安装到真正用起来](https://www.macjc.cn/bangong-tixiao-kaiyuan-xiangmu-tuijian/)
- [10 款免费效率工具实测：远控、下载、终端、图表一次配齐](https://www.macjc.cn/mianfei-xiaolvl-gongju-shice/)
- [办公提效教程：用免费开源工具重构你的日常工作流](https://www.macjc.cn/bangong-tixiao-jiaocheng/)
- [设计干货教程：AI 绘图提示词与图表美化从入门到出图](https://www.macjc.cn/sheji-ganhuo-jiaocheng/)