# Chatlog 使用介绍与安装指南（聊天记录工具，帮助大家轻松使用自己的聊天数据）

[`sjzar/chatlog`](https://github.com/sjzar/chatlog) 

- 从本地数据库文件获取聊天数据
- 支持 Windows / macOS 系统
- 支持微信 3.x / 4.0 版本
- 提供 Terminal UI 界面 & 命令行工具
- 提供 HTTP API 服务，支持查询聊天记录、联系人、群聊、最近会话等信息
- 支持 MCP SSE 协议，可与支持 MCP 的 AI 助手无缝集成
- 支持多媒体消息，支持解密图片、语音
- 支持自动解密数据，简化使用流程
- 支持多账号管理，可在不同账号间切换

---

## 🌟 项目特点

- ✅ **终端图形界面**：基于 `tview` 与 `tcell`，实时显示聊天记录。
- 🔊 **语音消息支持**：支持 Silk、MP3 编解码播放（使用 `go-silk` 和 `go-lame`）。
- 📁 **多数据源读取**：支持读取本地文件、数据库、API 等。
- 🛠️ **丰富的配置项**：基于 `viper` 提供灵活的配置方式。
- 📡 **可扩展接口**：集成 `Gin` Web 框架，支持 RESTful API。

---

## 🧩 依赖组件（部分）

| 组件 | 功能 |
|------|------|
| `tview` / `tcell` | 终端界面框架 |
| `go-silk` / `go-lame` | 音频编解码 |
| `gopsutil` | 系统资源监控 |
| `viper` | 配置文件管理 |
| `go-sqlite3` | 聊天记录存储 |
| `gin` | HTTP 接口服务 |

---

## 🚀 安装方法

### 方法一：使用 `go install`（推荐）

如果你的系统已安装 Go 环境（Go 1.18+）：

```bash
go install github.com/sjzar/chatlog@latest
```
#### 安装完成后，chatlog 可执行文件会出现在 $GOPATH/bin 目录下，通常是 ~/go/bin/chatlog。
请确保该路径已加入到环境变量 $PATH 中：

```bash
echo 'export PATH="$HOME/go/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
```
### 方法二：下载预编译版本
访问项目的 [Releases](https://github.com/sjzar/chatlog/releases) 页面下载适合系统的预编译版本。

## 👨‍💻 使用方法

推荐使用 Cherry Studio（因为我电脑里只有这个）

官网：https://cherry-ai.com/

使用方式：MCP SSE

在 设置 - MCP 服务器 下点击 添加服务器，输入名称为 chatlog，选择类型为 服务器发送事件(sse)，填写 URL 为 http://127.0.0.1:5030/sse 点击 保存。（注意：点击保存前不要先点击左侧的开启按钮）
![截屏2025-05-09 19.58.46.png](/static/img/ed06ead7104a5e82cc2cbb373266ceda.%C3%A6%C2%88%C2%AA%C3%A5%C2%B1%C2%8F2025-05-09%2019.58.46.webp)

选择支持 MCP 调用的模型，打开 chatlog 工具选项
![截屏2025-05-09 19.59.22.png](/static/img/0f7b550431aa3fbffa7d599a003696ad.%C3%A6%C2%88%C2%AA%C3%A5%C2%B1%C2%8F2025-05-09%2019.59.22.webp)

测试功能是否正常

![截屏2025-05-09 20.00.21.png](/static/img/fef3fe26e2f1c902320d1b7329e9899c.%C3%A6%C2%88%C2%AA%C3%A5%C2%B1%C2%8F2025-05-09%2020.00.21.webp)
在模型能调用mcp服务后即为正常


在作者的 GitHub仓库中有更为详细的文档

https://github.com/sjzar/chatlog/tree/main/docs

chatlog

> sudo xattr -r -d com.apple.quarantine 是一个在 macOS 终端中使用的命令，用于递归移除文件和目录的 隔离属性（quarantine）

命令解释：

- sudo：以管理员权限运行
- xattr：macOS 用于管理文件扩展属性的命令。 
- -r：递归处理，即对目标目录及其所有子目录和文件生效。
- -d com.apple.quarantine：删除指定的扩展属性（这里是 com.apple.quarantine）。

作用：
macOS 会对从网络下载的文件（如浏览器、邮件、微信等来源）自动添加 com.apple.quarantine 标记。当你首次打开这类文件时，系统会触发 Gatekeeper 安全检查，可能会弹出警告，比如：

“无法打开，因为来自身份不明的开发者”

“文件已损坏”

“您确定要打开吗？”

运行此命令后，系统不再检查该文件的来源，可直接运行（适用于已确认安全的文件或应用）。

使用方法：
打开 终端（应用程序 → 实用工具 → Terminal）。

输入命令

```bash
sudo xattr -r -d com.apple.quarantine /Applications/SomeApp.app
```
将 /Applications/SomeApp.app 替换为你的文件或目录路径（如拖拽文件到终端可自动填充路径）。


按回车，输入管理员密码（输入时不会显示字符），再次回车确认。

常见用途：
解决“应用已损坏”错误：某些破解版或第三方应用被 macOS 拦截时使用。

跳过烦人的Gatekeeper提示：直接运行下载的脚本或工具。

批量处理目录：例如解除整个 ~/Downloads 目录的隔离：

bash
sudo xattr -r -d com.apple.quarantine ~/Downloads
注意事项：
仅对信任的文件执行此操作！移除隔离属性后，系统不再检查文件安全性。


最后还有一个命令，但是我相信每个使用mac的开发者都会把他打开的
```bash
sudo spctl --master-disable
```

mac 安装 第三方应用问题

别离是氤氲一生的长河 
大部分人都只是我生命的玻璃窗上缓缓划过的雨水 
但也有那么一小部分人 
如果把他们比喻成我生命的玻璃窗上缓缓划过的雨水 
我情愿一辈子生活在雨季

一言


```bash
# 更新软件源
sudo apt update
# 安装 zsh git curl
sudo apt install zsh git curl -y
#设置终端为zsh(不需要sudo)
chsh -s /bin/zsh
```
安装 oh-my-zsh

官网：http://ohmyz.sh/。 
```bash
sh -c "$(curl -fsSL https://install.ohmyz.sh/)"
```

2.2.1 powerlevel10k

根据 [What’s the best theme for Oh My Zsh?](https://www.slant.co/topics/7553/~theme-for-oh-my-zsh) 中的排名，以及自定义化、美观程度，建议使用 powerlevel10k 主题。
```bash
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k
```
在 ~/.zshrc 设置 ZSH_THEME="powerlevel10k/powerlevel10k"。接下来，终端会自动引导你配置 powerlevel10k。




:::tip{title="提示"}
很奇怪，同样的插件同样的主题和框架，win上就会很卡，mac上就很正常，是因为mac是Darwin/XNU的原因吗
:::


zsh 安装与配置，使用 oh-my-zsh 美化终端

## shell连接到pve

 
![image.png](/static/img/b794af6348a585c3f8b804e0496a522d.image.webp)
```bash
ls -l /dev/disk/by-id/
```
使用命令列出/dev/disk/by-id/ 目录下的磁盘设备及其符号链接，并显示详细信息

### `ls -l /dev/disk/by-id/` 输出解析

这段输出是 `ls -l /dev/disk/by-id/` 命令的结果，显示了系统中所有磁盘设备的唯一标识符及其对应的实际设备路径。以下是对输出的详细解析：

---

#### 1. 物理磁盘设备

#### SATA 磁盘
- **`ata-WDC_WD30EFRX-68EUZN0_WD-WC3K20137CO6 -> ../../sda`**
 - 这是一块西部数据（WD）的 SATA 硬盘，型号为 `WD30EFRX-68EUZN0`，序列号为 `WD-WC3K20137CO6`。
 - 它对应的设备是 `/dev/sda`。
- **`ata-WDC_WD30EFRX-68EUZN0_WD-WC3K20137CO6-part1 -> ../../sda1`**
 - 这是该硬盘的第一个分区，对应的设备是 `/dev/sda1`。

#### NVMe 磁盘
- **`nvme-eui.00000000000000008ce38e030067cc30 -> ../../nvme0n1`**
 - 这是一块 NVMe 固态硬盘，其 EUI（扩展唯一标识符）为 `00000000000000008ce38e030067cc30`。
 - 它对应的设备是 `/dev/nvme0n1`。
---

#### 2. LVM 逻辑卷

#### LVM 逻辑卷
- **`dm-name-pve-root -> ../../dm-1`**
 - 这是 LVM 逻辑卷，名称为 `pve-root`，对应的设备是 `/dev/dm-1`。
 - 通常用于 Proxmox VE 的根文件系统。


#### LVM UUID
- **`dm-uuid-LVM-*`**
 - 这些是 LVM 逻辑卷的唯一标识符（UUID），指向对应的设备（如 `/dev/dm-*`）。
 - 例如：
 - `dm-uuid-LVM-XVuuRByC5bzwVfi0uXGj3l8l05YD36wqghMtCUCH8Ve8ZjtFmv5TmgIbFgOANy7c -> ../../dm-0`
 - 这是 LVM 逻辑卷的 UUID，对应的设备是 `/dev/dm-0`。

---

### 解析
- 这个回显显示了系统中所有磁盘设备的唯一标识符及其对应的实际设备路径。


```bash
qm set '虚拟机ID' -sata2 /dev/disk/by-id/'硬盘信息'
```

所以我该使用的命令是
```bash
qm set 101 -sata2 /dev/disk/by-id/ata-WDC_WD30EFRX-68EUZN0_WD-WC
3K20137CO6
```

最后附上自己写的一个小脚本

https://github.com/CasearF/device-passthrough-tool

pve虚拟机硬盘直通

script

msvalidate.01

link

如果你有机会到好望角，请在海边的石头上刻下我的故事👨‍💻