ADR-0001 后端采用 Node.js + TypeScript

状态：Accepted · 日期：2026-10-22

背景

需要同时集成 Claude Agent SDK 与 Codex app-server，并为 Vue 前端提供共享类型。本机已有 Node 22、Go、Python。

决策

后端使用 Node.js 22 + TypeScript（Fastify）。

理由

Claude Agent SDK 的 TS 版本是一等公民；Codex app-server 可以直接生成 TS 协议类型
事件类型、API DTO 在前后端（Vue + TS）之间零成本共享
单人维护，统一用一种语言

代价

Python 生态的数据处理能力不在服务进程内；这部分由 Agent 在工作区里执行 Python 完成，服务本身不需要。