项目—2ya—1
想做一款开源的桌面宠物,项目名称取名"2ya",或者也可以叫做“二鸭”。 写这个系列是为了记录从想法、设计、开发和最终完成的全部过程,这是第一篇文章,讲讲我的想法和技术选择吧。
为什么想做这个项目
现在 codex、claude code 等很火热,但是我觉得它主要是代码开发需求的人在用,受众面不光。 而 gpt、豆包等类主要是对话型的产品,虽然受众广,但是不够有亲近人、缺少陪伴感。 所以我想做一款能勾亲近人的、智能的产品,那么做一个可爱的、可以互动的桌面 AI 宠物就是一个很好的选择。
2ya 的含义
和我的名字有关
产品的核心
Not only a pet, but also a friend. 翻译:不只是宠物,更是挚友。
初版本功能: 宠物生成、动作互动、ai 对话、24小时运行
技术选择
想做的是桌面宠物,那就要考虑选择什么样的 gui 技术了。如果用windows、mac等各个系统原生 API 开发,那么性能肯定非常高。但同时开发效率也低(编程语言不同、框架不同),每个系统得配一套代码运行才行。 就肯定就不选择这种方式了,我最终选择了跨平台的框架,也就是一套代码跑遍所有系统:react + electron + python。
为什么选择这套框架呢? 跨平台框架有很多,比如 Flutter、QT、Electron、Tauri 等流行的跨平台框架,各个框架有各自的特性。 我选择 Electron,它就是内置一个了一个浏览器(Chromium),再加上 web 开发 React 框架,瞬间就是把开发一个 GUI 程序变成了一个前端应用开发一样。 由于 web 开发的庞大生态,那么开发相较起来就会非常便利了。
但是 Electron 也有缺点包占用大、内存占用高等一些缺点,但是目前是初期,只考虑如何能够快速的落地实现基本功能。 然后选择业务逻辑使用 Python,是因为 Python 很好上手,开发 AI 相关非常成熟,有很多包可以用。
我的整个技术架构就是,主程是 Electron,界面采用流行的 React 框架,逻辑处理采用 Python。
示意图如下:
sequenceDiagram
participant R as React界面端
participant E as Electron主程端
participant P as Python核心逻辑端
R->>E: IPC
E->>R: IPC
E->>P: Pipe 管道
P->>E: Pipe 管道
框架核心代码片段
- 主程端 Eletron(部分代码)
// 拉起 python 子程序&监听 outChannel 管道的rfd
function startBackend() {
const projectPath = app.getAppPath();
const script = path.join(projectPath, 'src', 'backend', 'service.py');
const process = spawn('uv', ['run', '--project', projectPath, 'python', '-u', script]);
backend = process;
// 行解析器(自动处理分片) + 事件监听(line 事件)
readline.createInterface({input: process.stdout}).on('line', (line) => {
const message = JSON.parse(line) as { id: string; status: BackendStatus, error?: string };
const resolve = pending.get(message.id);
if (resolve) {
pending.delete(message.id);
resolve(message.status);
}
});
// 事件监听(子进程退出事件)
process.once('exit', () => {
backend = undefined;
});
}
// 向 python 子程序发送消息
function requestBackend(command: string, playload: Record<string, unknown> = {}): Promise<BackendStatus> {
if (!backend) {
return Promise.reject(new Error("Backend not started"));
}
const id = String(++requestId);
backend.stdin?.write(`${JSON.stringify({id, command, ...playload})}\n`);
return new Promise((resolve) => pending.set(id, resolve));
}
...
app.whenReady().then(async () => {
// 启动后端进程
startBackend();
// 处理渲染进程请求当前宠物状态、交互和配置的 IPC 事件
ipcMain.handle('pet:get-status', () => currentStatus);
// 创建应用窗口并初始化状态
createWindow();
const initial = await requestBackend('status');
broadcast(initial);
scheduleHeartbeat(initial);
});
- 业务端 Python(部分代码)
// pipe 串行通信
for line in sys.stdin:
try:
req = json.loads(line)
resp_data = handleMessage(req)
resp_data["id"] = req.get("id", "-1")
print(json.dumps(resp_data), flush=True)
except Exception as e:
try:
req_id = req.get("id", "-1")
except Exception:
req_id = "-1"
print(json.dumps({"id": req_id, "status": "error", "error": str(e)}), flush=True)
- 展示端 React(Pet.tsx部分代码)
export default function Pet(): ReactElement {
useEffect(() => {
if (!status || status.action !== ActionEnum.WALK || status.fps <= 0) {
setFrameIndex(0)
return
}
const timer = setInterval(() => {
setFrameIndex((i) => (i + 1) % WALK_FRAME_COUNT)
}, 1000 / status.fps)
return () => clearInterval(timer)
}, [status?.action, status?.fps])
return (
<div className="pet-window">
{showBubble && (
<div className="pet-bubble">
<input
ref={inputRef}
value={bubbleValue}
placeholder="输入 #config 打开设置…"
onChange={(e) => setBubbleValue(e.target.value)}
onKeyDown={handleBubbleKeyDown}
/>
</div>
)}
<img
className="pet-sprite"
src={walkFrames[frameIndex]}
alt={status?.name ?? 'pet'}
draggable={false}
onClick={handleClick}
onContextMenu={handleContextMenu}
/>
</div>
)
}