# Taco马尔济斯桌面宠物聊天软件

**Repository Path**: Mint-Space/taco

## Basic Information

- **Project Name**: Taco马尔济斯桌面宠物聊天软件
- **Description**: 一只会摇尾巴的马尔济斯小狗桌面宠物，也是一个本地中文聊天伙伴。基于自研的
Mint Transformer 模型（纯 CPU 推理，无需 CUDA），吉卜力风格插画，杂志风界面。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-13
- **Last Updated**: 2026-09-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Taco

一只会摇尾巴的马尔济斯小狗桌面宠物，也是一个本地中文聊天伙伴。基于自研的
Mint Transformer 模型，纯 CPU 推理、无需 CUDA；吉卜力风格插画，杂志风界面。

## 特性

- **桌宠交互**：点击小狗会弹跳并冒出爱心/星星/打呼噜粒子，六种心情实时切换。
- **本地聊天**：多轮对话记忆（预算式上下文 + 重复惩罚采样），人格（小狗 / 黏人 / 顽皮）与心情融入回复。
- **流式生成**：逐字输出，支持停止生成、重新生成、复制消息、按 ↑/↓ 恢复历史输入。
- **外观**：三张宫崎骏风格插画随心情切换，奶油 + 粉 + 墨色杂志风。
- **设置**：温度、人格、模型切换、打赏二维码。
- **隐私**：离线运行，数据只存本地（`taco_state.json`）。
- **单二进制**：模型 gzip 内嵌，GUI 双击无黑窗，`taco -cli` 终端聊天。

## 构建

需要 Rust 工具链（MSVC）。

```powershell
cargo build --release
```

构建并做代码签名（可选）：

```powershell
powershell -ExecutionPolicy Bypass -File signing\make-cert.ps1   # 一次性生成自签名证书
powershell -ExecutionPolicy Bypass -File build.ps1               # 构建 + 签名 + 校验
```

产物为 `target\release\taco.exe`（单一二进制，模型已内嵌）。

## 使用

```powershell
taco                     # 图形界面（内置模型）
taco -cli                # 终端聊天（打开独立终端窗口）
taco -model=x.json       # 加载指定 Mint checkpoint
taco -h                  # 帮助
```

双击 `taco.exe` 启动图形界面：点击小狗互动，右侧聊天；侧栏切换心情/人格/温度，
设置面板切换模型、打赏。

## 代码签名

`build.ps1` 用本地自签名证书对 exe 做 SHA256 签名（自签名不会让 Windows 显示「可信发布者」）。
如需正式签名，把 `build.ps1` 里的 `$pfx` / `$pw` 换成 CA 代码签名证书即可。

## 模型

模型由 Mint 项目训练，`models/taco.json.gz` 为压缩后的 checkpoint。
当前内置模型约 450 万参数、词表 4206 字、上下文 192。

## 项目结构

```
src/
  main.rs      入口：参数分流（GUI / CLI / 帮助）
  lib.rs       共享库
  cli.rs       终端聊天
  gui.rs       图形界面（eframe/egui）
  engine.rs    聊天引擎（多轮记忆、流式生成）
  persona.rs   人格与心情定义
  state.rs     持久化
  mint/        纯 CPU 推理子集（从 Mint 复用）
models/        内嵌模型（taco.json.gz）
assets/        插画、图标、打赏二维码
signing/       代码签名脚本
```

## 开源协议

[MIT](./LICENSE) © 2026 北极熊

## 关于

开发者 北极熊 · 模型引擎 Mint · 插画风格 宫崎骏