AI 桌宠自制工坊使用教程从上传角色到打包运行全程零代码快速开始十分钟做一个桌宠启动 Web 工作室在web目录执行node scripts/serve.mjs浏览器打开http://localhost:4173角色Web 工作室「角色」面板 → 上传一张 PNG透明背景最佳→ 预览里立刻动起来行为在「行为」面板加一条规则如点击 → 播放开心动画 说一句话人格填名字、角色设定、说话风格声音可选勾选 TTS 朗读回复选一个音色模型先用「演示模式」跑通链路无需 Key要用真 AI切到 DeepSeek / OpenAI 等并填 API Key导出右上角「导出项目 JSON」→ 得到.companion.json8.运行双击AI Companion-0.1.0.exe→ 聊天窗「导入项目」选择刚才的 JSON。完成后宠物会出现在屏幕底部能走动、被点击、被拖拽、和你聊天。## Web 工作室各模块说明顶部可切换三种形态 桌宠纯桌宠无 AI/ AI 伴侣聊天记忆主动关心/ AI 代理工具自动化Beta。左侧是创建步骤右侧是配置面板角色 / 人格 / 模型 / 声音 / 记忆 / 参数 / 行为 / 打包角色上传 PNG / JPG / WebP / GIF「角色大小」滑杆调节高度未上传用内置演示小猫行为每条规则 触发条件 动作列表如点击 → 播放 happy 动画 说好开心人格名字 / 角色设定 / 关系 / 说话风格 性格滑杆亲密度、幽默、活力、严肃、好奇记忆对话记忆上下文轮数 1–50、事实提取、关系记忆参数角色大小、自动去背景、角色数量、鼠标感应、自动散步开关、散步速度 / 间隔、台词与开场白。## 桌面运行端使用| 操作 | 效果 || — | — || 单击宠物 | 开心动画 台词 配音 || 拖动宠物 | 移到任意位置松手停在那 || 鼠标悬停 | 宠物歪头看你 || 待机 | 自动散步可在参数关闭、随机闲聊 |- 宠物窗口是全屏透明覆盖层只有宠物本身可交互其余区域鼠标穿透不挡操作聊天窗默认折叠成小圆球小火箭可拖动松手吸附屏幕左 / 右边缘-托盘菜单回到屏幕底部 / 退出导入新配置聊天窗 → 导入 → 选.companion.json宠物即时更新无需重新打包- 用户数据在%APPDATA%\companion-runtime\。语音设置语音输入你说它听点击说话 / 按住说话 / 快捷键默认AltSpaceWeb 端走浏览器云端识别桌面端走本地 Whisper离线语音输出它念给你听勾选「TTS 朗读回复」选音色调语速 / 音调自定义配音片段选时机打招呼 / 点击 / 拖动 / 说话→ 上传音频MP3/WAV/OGG/M4A/WEBM≤8MB内嵌进项目包离线播放。## 知识库 / 任务 / 提醒知识库上传 TXT / Markdown 文本资料或直接粘贴文本聊天时宠物始终参考这些资料回答资料没有的再用常识可暂停 / 删除单条任务提取点「提取计划」从资料中识别带日期的事项如「明天交报告」「周一开会」勾选确认后加入计划列表可标记完成 / 删除每日提醒结合日程在程序启动后约 8 秒、每 30 分钟、以及电脑唤醒时检查并提醒当天事项一次最多 5 条遵守勿扰 / 冷却 / 每日上限。模型配置演示模式无需 Key返回固定演示回复用于跑通「发送 → 流式气泡 → 朗读」链路真实模型BYOK提供者 DeepSeek / OpenAI / 兼容端点 / Ollama / LM Studio填 Base URL、模型名、API KeyKey 本机加密保存导出项目时可一键清理替换为[已清理]- 可调参数温度、最大输出 tokens、备用模型列表。打包与发布导出项目 JSON右上角「导出项目 JSON」→.companion.json勾选「导出清理敏感信息」会清空 API Key / 令牌分享安全两种运行方式 - 导入运行双击 exe → 导入.companion.json无需重新打包适合调试 - 打进 exe在companion-runtime目录执行node scripts/publish.mjs 路径/xxx.companion.json生成携带该项目的AI Companion-0.1.0.exe。## 常见问题 FAQ精选宠物不动 / 不散步在「参数」面板确认「自动散步」已勾选点击宠物没反应确认点在了宠物本体上宠物以外区域是穿透的一直固定回复说明当前是「演示模式mock」到「模型」面板切真实提供者并填 API Key语音识别听不到 / 网络错误Web 端依赖浏览器云端服务网络波动会时好时坏桌面端请确认本地 Whisper 模型已就绪为什么宠物不记得我说过的话「事实提取」「关系记忆」默认关闭需在「记忆」面板打开「对话记忆」只保留当前会话换台电脑还能用吗能。.companion.json自带资源和配置但 API Key 会被清理需在新机器上重新填入。 适用版本V1.0 Beta · Windows 10/11。当前 Beta 已知限制视觉感知、情景记忆、声音克隆为规划中多显示器仅漫游主屏长时间运行稳定性仍在验证中。本文根据《AI 桌宠自制工坊》使用说明书整理截图来自 Web 工作室实际界面。 AI 桌宠自制工坊使用教程：从上传角色到打包运行，全程零代码
AI 桌宠自制工坊使用教程从上传角色到打包运行全程零代码快速开始十分钟做一个桌宠启动 Web 工作室在web目录执行node scripts/serve.mjs浏览器打开http://localhost:4173角色Web 工作室「角色」面板 → 上传一张 PNG透明背景最佳→ 预览里立刻动起来行为在「行为」面板加一条规则如点击 → 播放开心动画 说一句话人格填名字、角色设定、说话风格声音可选勾选 TTS 朗读回复选一个音色模型先用「演示模式」跑通链路无需 Key要用真 AI切到 DeepSeek / OpenAI 等并填 API Key导出右上角「导出项目 JSON」→ 得到.companion.json8.运行双击AI Companion-0.1.0.exe→ 聊天窗「导入项目」选择刚才的 JSON。完成后宠物会出现在屏幕底部能走动、被点击、被拖拽、和你聊天。## Web 工作室各模块说明顶部可切换三种形态 桌宠纯桌宠无 AI/ AI 伴侣聊天记忆主动关心/ AI 代理工具自动化Beta。左侧是创建步骤右侧是配置面板角色 / 人格 / 模型 / 声音 / 记忆 / 参数 / 行为 / 打包角色上传 PNG / JPG / WebP / GIF「角色大小」滑杆调节高度未上传用内置演示小猫行为每条规则 触发条件 动作列表如点击 → 播放 happy 动画 说好开心人格名字 / 角色设定 / 关系 / 说话风格 性格滑杆亲密度、幽默、活力、严肃、好奇记忆对话记忆上下文轮数 1–50、事实提取、关系记忆参数角色大小、自动去背景、角色数量、鼠标感应、自动散步开关、散步速度 / 间隔、台词与开场白。## 桌面运行端使用| 操作 | 效果 || — | — || 单击宠物 | 开心动画 台词 配音 || 拖动宠物 | 移到任意位置松手停在那 || 鼠标悬停 | 宠物歪头看你 || 待机 | 自动散步可在参数关闭、随机闲聊 |- 宠物窗口是全屏透明覆盖层只有宠物本身可交互其余区域鼠标穿透不挡操作聊天窗默认折叠成小圆球小火箭可拖动松手吸附屏幕左 / 右边缘-托盘菜单回到屏幕底部 / 退出导入新配置聊天窗 → 导入 → 选.companion.json宠物即时更新无需重新打包- 用户数据在%APPDATA%\companion-runtime\。语音设置语音输入你说它听点击说话 / 按住说话 / 快捷键默认AltSpaceWeb 端走浏览器云端识别桌面端走本地 Whisper离线语音输出它念给你听勾选「TTS 朗读回复」选音色调语速 / 音调自定义配音片段选时机打招呼 / 点击 / 拖动 / 说话→ 上传音频MP3/WAV/OGG/M4A/WEBM≤8MB内嵌进项目包离线播放。## 知识库 / 任务 / 提醒知识库上传 TXT / Markdown 文本资料或直接粘贴文本聊天时宠物始终参考这些资料回答资料没有的再用常识可暂停 / 删除单条任务提取点「提取计划」从资料中识别带日期的事项如「明天交报告」「周一开会」勾选确认后加入计划列表可标记完成 / 删除每日提醒结合日程在程序启动后约 8 秒、每 30 分钟、以及电脑唤醒时检查并提醒当天事项一次最多 5 条遵守勿扰 / 冷却 / 每日上限。模型配置演示模式无需 Key返回固定演示回复用于跑通「发送 → 流式气泡 → 朗读」链路真实模型BYOK提供者 DeepSeek / OpenAI / 兼容端点 / Ollama / LM Studio填 Base URL、模型名、API KeyKey 本机加密保存导出项目时可一键清理替换为[已清理]- 可调参数温度、最大输出 tokens、备用模型列表。打包与发布导出项目 JSON右上角「导出项目 JSON」→.companion.json勾选「导出清理敏感信息」会清空 API Key / 令牌分享安全两种运行方式 - 导入运行双击 exe → 导入.companion.json无需重新打包适合调试 - 打进 exe在companion-runtime目录执行node scripts/publish.mjs 路径/xxx.companion.json生成携带该项目的AI Companion-0.1.0.exe。## 常见问题 FAQ精选宠物不动 / 不散步在「参数」面板确认「自动散步」已勾选点击宠物没反应确认点在了宠物本体上宠物以外区域是穿透的一直固定回复说明当前是「演示模式mock」到「模型」面板切真实提供者并填 API Key语音识别听不到 / 网络错误Web 端依赖浏览器云端服务网络波动会时好时坏桌面端请确认本地 Whisper 模型已就绪为什么宠物不记得我说过的话「事实提取」「关系记忆」默认关闭需在「记忆」面板打开「对话记忆」只保留当前会话换台电脑还能用吗能。.companion.json自带资源和配置但 API Key 会被清理需在新机器上重新填入。 适用版本V1.0 Beta · Windows 10/11。当前 Beta 已知限制视觉感知、情景记忆、声音克隆为规划中多显示器仅漫游主屏长时间运行稳定性仍在验证中。本文根据《AI 桌宠自制工坊》使用说明书整理截图来自 Web 工作室实际界面。