项目—2ya—1

2026/10/20

项目—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 管道

框架核心代码片段

  1. 主程端 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);
});  
  1. 业务端 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)
  1. 展示端 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>
    )
}

参考