企业官网建设流程全解析

AI 桌宠自制工坊使用教程：从上传角色到打包运行，全程零代码

快速开始：十分钟做一个桌宠

1. 启动 Web 工作室：在web目录执行node scripts/serve.mjs，浏览器打开http://localhost:4173；
2. 角色：Web 工作室「角色」面板 → 上传一张 PNG（透明背景最佳）→ 预览里立刻动起来；
3. 行为：在「行为」面板加一条规则（如：点击 → 播放开心动画 + 说一句话）；
4. 人格：填名字、角色设定、说话风格
5. 声音（可选）：勾选 TTS 朗读回复，选一个音色；
6. 模型：先用「演示模式」跑通链路（无需 Key）；要用真 AI，切到 DeepSeek / OpenAI 等并填 API Key；
7. 导出：右上角「导出项目 JSON」→ 得到.companion.json；8.运行：双击AI Companion-0.1.0.exe→ 聊天窗「导入项目」选择刚才的 JSON。完成后，宠物会出现在屏幕底部，能走动、被点击、被拖拽、和你聊天。## Web 工作室各模块说明顶部可切换三种形态：
8. 🐾 桌宠（纯桌宠无 AI）/💬 AI 伴侣（聊天+记忆+主动关心）/🛠 AI 代理（工具自动化，Beta）。
9. 左侧是创建步骤，右侧是配置面板（角色 / 人格 / 模型 / 声音 / 记忆 / 参数 / 行为 / 打包）：
10. • 角色：上传 PNG / JPG / WebP / GIF；「角色大小」滑杆调节高度；未上传用内置演示小猫；
11. • 行为：每条规则 = 触发条件 + 动作列表（如点击 → 播放 happy 动画 + 说"好开心！"）；
12. • 人格：名字 / 角色设定 / 关系 / 说话风格 + 性格滑杆（亲密度、幽默、活力、严肃、好奇）；
13. • 记忆：对话记忆（上下文轮数 1–50）、事实提取、关系记忆；
14. • 参数：角色大小、自动去背景、角色数量、鼠标感应、自动散步开关、散步速度 / 间隔、台词与开场白。## 桌面运行端使用| 操作 | 效果 || — | — || 单击宠物 | 开心动画 + 台词（+ 配音） || 拖动宠物 | 移到任意位置，松手停在那 || 鼠标悬停 | 宠物歪头看你 || 待机 | 自动散步（可在参数关闭）、随机闲聊 |- 宠物窗口是全屏透明覆盖层：只有宠物本身可交互，其余区域鼠标穿透，不挡操作；
15. • 聊天窗：默认折叠成小圆球（小火箭），可拖动，松手吸附屏幕左 / 右边缘；-托盘菜单：回到屏幕底部 / 退出；
16. • 导入新配置：聊天窗 → 导入 → 选.companion.json，宠物即时更新（无需重新打包）；- 用户数据在%APPDATA%\companion-runtime\。

17. 语音设置

18. • 语音输入（你说它听）：点击说话 / 按住说话 / 快捷键（默认Alt+Space）；Web 端走浏览器云端识别，桌面端走本地 Whisper（离线）；
19. • 语音输出（它念给你听）：勾选「TTS 朗读回复」，选音色，调语速 / 音调；
20. • 自定义配音片段：选时机（打招呼 / 点击 / 拖动 / 说话）→ 上传音频（MP3/WAV/OGG/M4A/WEBM，≤8MB），内嵌进项目包离线播放。## 知识库 / 任务 / 提醒
21. • 知识库：上传 TXT / Markdown 文本资料或直接粘贴文本，聊天时宠物始终参考这些资料回答（资料没有的再用常识）；可暂停 / 删除单条；
22. • 任务提取：点「提取计划」，从资料中识别带日期的事项（如「明天交报告」「周一开会」），勾选确认后加入计划列表，可标记完成 / 删除；
23. • 每日提醒：结合日程，在程序启动后约 8 秒、每 30 分钟、以及电脑唤醒时检查并提醒当天事项（一次最多 5 条，遵守勿扰 / 冷却 / 每日上限）。

24. 模型配置

25. • 演示模式：无需 Key，返回固定演示回复，用于跑通「发送 → 流式气泡 → 朗读」链路；
26. • 真实模型（BYOK）：提供者 DeepSeek / OpenAI / 兼容端点 / Ollama / LM Studio，填 Base URL、模型名、API Key；Key 本机加密保存，导出项目时可一键清理（替换为[已清理]）；- 可调参数：温度、最大输出 tokens、备用模型列表。

27. 打包与发布

28. 导出项目 JSON：右上角「导出项目 JSON」→.companion.json；勾选「导出清理敏感信息」会清空 API Key / 令牌（分享安全）；
29. 两种运行方式： - 导入运行：双击 exe → 导入.companion.json（无需重新打包，适合调试）； - 打进 exe：在companion-runtime目录执行node scripts/publish.mjs <路径/xxx.companion.json>，生成携带该项目的AI Companion-0.1.0.exe。## 常见问题 FAQ（精选）
30. • 宠物不动 / 不散步？在「参数」面板确认「自动散步」已勾选；
31. • 点击宠物没反应？确认点在了宠物本体上（宠物以外区域是穿透的）；
32. • 一直固定回复？说明当前是「演示模式（mock）」，到「模型」面板切真实提供者并填 API Key；
33. • 语音识别听不到 / 网络错误？Web 端依赖浏览器云端服务，网络波动会时好时坏；桌面端请确认本地 Whisper 模型已就绪；
34. • 为什么宠物不记得我说过的话？「事实提取」「关系记忆」默认关闭，需在「记忆」面板打开；「对话记忆」只保留当前会话；
35. • 换台电脑还能用吗？能。.companion.json自带资源和配置，但 API Key 会被清理，需在新机器上重新填入。> 适用版本：V1.0 Beta · Windows 10/11。当前 Beta 已知限制：视觉感知、情景记忆、声音克隆为规划中；多显示器仅漫游主屏；长时间运行稳定性仍在验证中。（本文根据《AI 桌宠自制工坊》使用说明书整理，截图来自 Web 工作室实际界面。）