内容
# 记录工具
> **记录它。智能代理看到它。**
免费、开源的屏幕录制命令行工具 + MCP 服务器，适用于 AI 智能代理。零成本。100% 本地。无需云服务。无需 API 密钥。
## 功能
- **屏幕录制** — 通过 ffmpeg 捕获全屏、窗口或区域
- **截图** — 即时 PNG 捕获，输出 JSON 元数据
- **MCP 服务器** — 通过模型上下文协议（stdio）暴露 5 种工具
- **帧提取** — 用于视觉模型分析的场景检测关键帧
- **事件日志** — JSONL 事件日志与视频时钟同步（点击、按键、注释）
- **跨平台** — macOS、Windows、Linux
- **零成本** — 无需 API、无需云服务、无需托管、无需订阅
## 快速开始
```bash
# 对于 Claude Code
claude mcp add 记录工具 -- npx -y @zum-x/recit
# 对于 Cursor / VS Code — 添加到 mcp.json：
{
"mcpServers": {
"记录工具": {
"command": "npx",
"args": ["-y", "记录工具"]
}
}
}
# 前提条件（两者皆免费）
brew install ffmpeg # macOS
sudo apt install ffmpeg # Ubuntu/Debian
winget install ffmpeg # Windows
```
## 命令行用法
```bash
# 开始录制
记录工具 start [--output 路径] [--fps 15] [--json]
# 停止录制
记录工具 stop <id> [--json]
# 捕获截图
记录工具 snap [--output 路径] [--json]
# 从视频中提取帧
记录工具 frames <视频> [--max 20] [--output 目录]
# 检查录制状态
记录工具 status [id]
# 启动 MCP 服务器
记录工具 mcp
```
## MCP 工具
| 工具 | 描述 |
|------|-------------|
| `记录工具_start` | 开始屏幕录制 |
| `记录工具_stop` | 停止录制，获取文件路径 |
| `记录工具_snap` | 捕获截图 |
| `记录工具_frames` | 从视频中提取关键帧 |
| `记录工具_status` | 获取录制状态或活动计数 |
## 架构
```
AI 智能代理（Claude/Codex/Cursor）
│
│ stdio（标准输入/标准输出）
▼
记录工具 MCP 服务器（Node.js，本地）
│
│ 子进程
▼
ffmpeg（免费，本地）
│
▼
.mp4 / .png 保存到用户磁盘
```
**$0 花费。无上传。全部本地。**
## 开发
```bash
git clone https://github.com/codedbytahir/recit.git
cd 记录工具
npm install
npm test # 运行 43 个测试
npm run build # 编译 TypeScript
```
## 技术栈
| 层 | 工具 | 成本 |
|-------|------|------|
| 录制 | ffmpeg | $0 |
| 智能代理集成 | MCP SDK（stdio） | $0 |
| 分发 | npm | $0 |
| 代码托管 | GitHub | $0 |
| 运行时 | Node.js | $0 |
| 测试 | Vitest | $0 |
## 许可证
Apache 2.0
