# ff-code

**Repository Path**: stanlxl/ff-code

## Basic Information

- **Project Name**: ff-code
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-07
- **Last Updated**: 2026-04-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ff-code

Codex Collab Desktop（Vue3 + Tauri + Rust + Node）工程。

## 架构说明

- 前端：Vue3（页面、会话管理、设置、技能管理）。
- 桌面壳：Tauri + Rust（窗口、命令、事件总线、状态管理）。
- 模型交互：Node 脚本层负责 OpenAI SDK 与中转站协议适配。
  - `scripts/codex_sdk_bridge.mjs`：实际会话请求（SDK / 协议回退）。
  - `scripts/codex_gateway_diagnose.mjs`：网关诊断（多协议+多鉴权组合探测）。

## 当前状态

- 已打通会话链路（Rust -> Node -> OpenAI SDK/网关 -> Rust 事件 -> Vue）。
- 已支持中转站适配回退策略（`responses` / `chat/completions`，多鉴权头）。
- 已支持设置页网关诊断，便于快速定位 401/协议不兼容问题。
- 会话页默认执行器为 `CLI`（稳定优先）；SDK 适配链路保留用于后续切换验证。

## 文档

- 项目规划与里程碑：`ROADMAP.md`
- 产品需求：`PRD.md`

## 前端组件规范

为保证可维护性，前端统一采用组件化开发：

1. 通用组件统一以 `Com` 开头  
   例如：`ComModal.vue`、`ComTable.vue`
2. 业务组件使用业务前缀命名  
   例如：`AgentTemplateCard.vue`、`SessionThreadPanel.vue`
3. 推荐目录约定
   - 通用：`src-tauri/src/components/common/Com*.vue`
   - 业务：`src-tauri/src/components/business/<domain>/<BusinessPrefix>*.vue`
4. 页面 `views/*.vue` 只做页面编排，复杂区块优先下沉为组件

## 本地启动

```bash
npm run tauri dev
```