快速开始

在 Windows 上解压、启动并完成第一次互动和聊天。

适用于 Windows 10 / 11 64 位。先完成第 1~3 步,就能离线使用桌宠;想自由聊天,再做第 4~5 步。

1. 解压整个文件夹

  1. 找到 文治桌宠-0.3.0-preview.6-Windows-x64-完整便携版.zip。
  2. 右键压缩包,点击 全部解压缩。
  3. 选择方便以后找到的位置,例如 D:\桌宠,点击 提取。
  4. 等待完成,打开解压后的文件夹。外面可能还有一层同名文件夹。
文治桌宠-0.3.0-preview.6-Windows-x64-完整便携版
├─ BunjiPet-win32-x64
│  ├─ BunjiPet.exe   ← 稍后双击
│  └─ 其他运行文件
├─ 使用文档
└─ README.md

注意:不要在压缩包预览窗口里运行,也不要只复制 EXE。整个 BunjiPet-win32-x64 文件夹都要保留。此包直接运行,没有单独的安装向导;不需要安装 Node.js。

2. 打开桌宠

进入 BunjiPet-win32-x64,双击 BunjiPet.exe,稍等片刻。

启动后的陪伴手记:顶部是功能入口,页面中间显示文治

看到文治和陪伴手记,就启动成功。 顶部菜单被遮住时,点击两侧箭头查看更多入口。

Windows 如果提示发布者未知,先核对下载来源和 ZIP 校验值;不确定来源时先不要运行。查看本指南对应的校验值。

3. 试一次本地互动

  1. 在 陪伴手记 找到 日常互动,点击展开。
  2. 点击 摸摸头、一起吃点或其他按钮。
  3. 也可以在桌面拖动文治,右键他打开菜单。

日常互动展开后,可点击摸摸头、一起吃点或拥抱

文治有本地回应或状态发生变化,就说明基础功能可用。这一步不需要模型和 QQ。

4. 配置自由聊天(可选)

你需要从模型服务商的 API 平台取得 接口基础地址、模型 ID、API 密钥。它们分别对应服务地址、具体模型和调用凭据;密钥不是 QQ 密码。调用模型可能产生费用。

  1. 点击顶部 偏好设置,再点左侧 对话 API。
  2. 展开 文字聊天,填写三个字段。模型 ID 按服务商提供的名称原样填写。
  3. 台词最高输出 token 先保持当前值。
  4. 点击 测试接口;成功后向下滚动,点击 保存聊天设置。

文字聊天设置:在接口基础地址、模型名称、API 密钥三个框中填写

滚动到文字聊天区域底部,点击保存聊天设置

测试与保存是两步。测试报错时,按模型与接口检查,不要反复尝试。

5. 发送第一句话

  1. 按 Ctrl + Alt + C 打开轻聊天;也可在 对话记录 中点击 去桌面聊聊。
  2. 在上方对话框输入 今天过得怎么样?,按 Enter。
  3. 等待回复;下方动作框可以先留空。

轻聊天上方输入对话,下方输入动作;可以只填写对话

6. 下次怎么打开和退出

需要做什么操作
再次启动双击解压目录中 BunjiPet-win32-x64/BunjiPet.exe
找回陪伴手记双击右下角托盘里的桌宠图标;看不到时先点向上箭头
显示或隐藏桌宠按 Ctrl + Alt + H
完全退出右键托盘图标,选择 退出

关闭手记窗口不等于退出桌宠。接下来需要 QQ 聊天时,阅读 NapCat 与 QQ 配置;其他功能见阅读导航。

本页目录