Cute-Partner

Cute-Partner · 可爱的助手

[🇨🇳 中文](README.md) | [🇺🇸 English](README_EN.md)

Cute-Partner 是一个陪你交流、一起干活的桌面伙伴。

她把模型与工具能力放在身后：你可以直接与她交谈，向她交付任务，在需要决定时回答她的问题，也可以只让她陪在桌面上。

项目当前以 DeepSeek Harness 为后台运行框架，默认搭载的角色是大肥鱼——哦鲸鲸：

图 1 – 与鼠标互动的哦鲸鲸

> 在使用项目前，建议按顺序阅读：① [项目概览](#sec1) → ② [项目部署](#sec3) → ③ [运行与使用](#sec4)。

> 如果需要进一步开发，请阅读 [开发与扩展](#sec5)。

---

目录

• [1. 项目概览](#sec1)
• [1.1. 项目定位](#sec11)
• [1.2. 系统组成](#sec12)
• [1.3. 使用场景](#sec13)
• [2. 功能实现](#sec2)
• [2.1. 桌面角色](#sec21)
• [2.2. 设定与记忆](#sec22)
• [2.3. 处理事务](#sec23)
• [2.4. 结构化对接](#sec24)
• [2.5. 资料管理](#sec25)
• [2.6. 伙食费与用量](#sec26)
• [2.7. 语音功能](#sec27)
• [3. 项目部署](#sec3)
• [3.1. 项目结构](#sec31)
• [3.2. 前置工作](#sec32)
• [3.3. 基础安装](#sec33)
• [3.4. 语音组件安装](#sec34)
• [4. 运行与使用](#sec4)
• [4.1. 首次交流](#sec41)
• [4.2. 角色界面](#sec42)
• [4.3. 小本本指南](#sec43)
• [4.4. 阅读与回答](#sec44)
• [4.5. 导出、载入与重置](#sec45)
• [5. 开发与扩展](#sec5)
• [5.1. 宿主与界面接口](#sec51)
• [5.2. 模型、工具与问题接口](#sec52)
• [5.3. 设定、记忆与资料接口](#sec53)
• [5.4. 角色显示与动作接口](#sec54)
• [5.5. 语音识别与合成接口](#sec55)
• [5.6. 配置与 Harness 集成接口](#sec56)
• [6. 项目信息](#sec6)
• [6.1. 系统版本](#sec61)
• [6.2. 测试环境](#sec62)
• [6.3. 后续规划](#sec63)
• [6.4. 使用与授权说明](#sec64)

---

1. 项目概览 [⌃](#top)

图形化的智能体工具让人与模型协作变得更直观。Cute-Partner 希望在这种交互方式上加入角色的形象、声音与持续记忆，让交流和工作协作融入桌面陪伴。

你可以与她聊日常、告诉她自己的偏好，也可以向她交付工作、回答问题并查看结果。希望她逐渐成为一个熟悉你的、仿佛有“灵魂”的桌面伙伴，是这个项目的出发点。

---

1.1. 项目定位 [⌃](#top)

Cute-Partner 同时面向日常陪伴与工作协作。角色端承接用户能看见、能操作的交流体验；模型端负责理解需求、生成回复，并通过工具参与任务处理。

Cute-Partner · 可爱的助手
      │
      ├── 角色端：与你交流，呈现进展与结果
      │     ├── 桌面陪伴：Live2D 形象、自然动态、视线与动作反馈
      │     ├── 信息交流：文字输入、白云消息、完整阅读与可选声音
      │     ├── 共同决定：展示问题、选项、修改差异和权限审批
      │     └── 资料查看：设定、记忆、事务、修订与用量入口
      │
      └── 模型端：理解需求，组织回复与任务
            ├── 日常交流：结合设定与本轮相关记忆生成回复
            ├── 信息整理：提出设定修改、整理偏好与事务记录
            ├── 工作协作：规划步骤、提出问题，并调用已接入工具
            └── 结果反馈：将回复、问题与工具进展交回角色界面

两端由桌面应用连接：资料保存、权限校验、工具执行协调和停止控制由程序负责。模型提出的修改与任务结果，会按相应规则经过确认、保存或核验，再反馈到界面。

---

1.2. 系统组成 [⌃](#top)

项目由角色交互层、桌面应用层、后台运行层组成。它们分别负责交流入口、本机服务协调，以及模型会话与工具运行。

┌──────────────────────────────────────────────────────────┐
│                       角色交互层                          
│                                                                           
│      文字或语音输入 → 阅读回复 → 回答问题 / 审批 / 停止         
└──────────────────────────┬───────────────────────────────┘
                           │ 受控 preload IPC
                           ▼
┌──────────────────────────────────────────────────────────┐
│                      桌面应用层
│                Cute-Partner（Electron）
│                                                          
│  会话管理 ── 问题与工具状态 ── 操作权限                   
│      ├── 设定 / SQLite 记忆 / 事务                  
│      ├── 本地识别 / 自然语音（可选项）                 
│      └── 角色事件 → Live2D 参数驱动         
└──────────────────────────┬───────────────────────────────┘
                           │ 独立后台会话
                           ▼
┌──────────────────────────────────────────────────────────┐
│                      后台运行层
│              DeepSeek Harness 与模型服务                   
│