doubao-studio: Instructions file for Codex

AGENTS.md

项目概览

豆包工作室 Doubao Studio Desktop - 面向 AI 内容创作者的多账号管理与自动化生产工作台。Electron 桌面应用，左侧多账号管理+任务调度控制台，右侧会话隔离的内嵌豆包浏览器。

技术栈

• 运行时: Electron 33 + Node.js 24
• 前端: React 18 + TypeScript 5 + Ant Design 5 + Tailwind CSS 3
• 状态管理: Zustand 5
• 构建: Vite 6 (渲染进程) + tsc (主进程) + electron-builder (打包)
• 包管理: pnpm

项目结构

├── main/                    # 主进程 (Electron Main Process)
│   ├── main.ts              # 应用入口：窗口创建、IPC 注册
│   ├── preload.ts           # 预加载脚本：contextBridge 暴露 API
│   ├── core/                # TaskService、Repository、事件流等任务域核心
│   ├── cli/                 # 只读查询与受控 CSV 导入 CLI
│   ├── mcp/                 # MCP stdio 服务端与客户端
│   ├── ipc/
│   │   ├── accounts.ts      # 账号管理 IPC (CRUD + Session 隔离)
│   │   └── tasks.ts         # 任务调度 IPC (队列管理 + 状态流转)
│   └── utils/               # 持久化、启动、额度与媒体辅助逻辑
├── packages/contracts/      # 主进程/渲染进程共享的纯类型契约
├── schemas/capability/v1/   # 对外 Capability API JSON Schema
├── src/                     # 渲染进程 (React)
│   ├── index.tsx            # React 入口 + Ant Design ConfigProvider
│   ├── App.tsx              # 主布局：三栏式 + 拖拽调整宽度
│   ├── components/
│   │   ├── Toolbar.tsx      # 顶部工具栏
│   │   ├── Sidebar.tsx      # 左侧面板容器（上下分区）
│   │   ├── AccountList.tsx  # 账号列表
│   │   ├── TaskConsole.tsx  # 任务控制台
│   │   └── BrowserPanel.tsx # 内嵌浏览器（webview）
│   ├── store/
│   │   ├── useAccountStore.ts # 账号状态管理
│   │   └── useTaskStore.ts    # 任务状态管理
│   ├── types/
│   │   ├── index.ts         # 全局类型定义
│   │   └── electron.d.ts    # Electron API 类型声明
│   └── styles/
│       └── global.css       # Tailwind + 自定义组件样式
├── tests/unit/              # Node/Vitest 行为与边界测试
├── docs/                    # 架构设计、handoff 与 README 图文资产
├── examples/                # CSV 模板与适配规则示例
├── package.json
├── tsconfig.json            # 基础 TS 配置
├── tsconfig.main.json       # 主进程 TS 配置 (CommonJS)
├── tsconfig.renderer.json   # 渲染进程 TS 配置 (ESNext + JSX)
├── vite.config.ts           # Vite 配置
├── tailwind.config.js       # Tailwind 配置（品牌色系）
├── .coze                    # 沙箱构建/运行配置
└── DESIGN.md                # 设计规范