# ai_session

**Repository Path**: blackwait/ai_session

## Basic Information

- **Project Name**: ai_session
- **Description**: AI A起来  AI A起来 AI A起来
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-14
- **Last Updated**: 2026-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Session Studio

一个使用 JavaFX 构建的跨平台多会话 AI 客户端，界面和交互参考 Codex / VS Code 中的 Codex 插件体验。

## 已实现能力

- 多会话侧边栏，可同时维护多个独立会话
  - 支持会话重命名
  - 支持收藏置顶
  - 支持每个会话独立保留未发送草稿
  - 支持从 Git 仓库克隆工作区并直接创建新会话
  - 支持从当前仓库派生 Git worktree 并直接创建隔离会话
- 每个会话可单独绑定工作区目录
- 主工作区已升级为 `聊天区 + 右侧工具面板`
  - 文件面板：搜索 / 预览 / 加入上下文 / 插入 `@文件`
  - 提示库面板：全局提示库 / 工作区提示库 / 搜索 / 保存 / 删除 / 插入编辑器
  - Git 面板：当前分支 / 分支列表 / 新建分支 / 切换分支 / 改动文件搜索 / 批量暂存 / 全量暂存 / 单文件撤销 / 全量撤销 / fetch / pull / push / sync / diff 预览 / 提交详情预览 / 加入上下文 / 插入 `@文件` / 打开文件
  - GitHub 面板：仓库识别 / Issue 列表 / PR 列表 / PR review 评论 / PR diff 预览 / 浏览器打开 / 检出 PR / 一键插入编辑器 / 一键创建 PR 问答、全量评审、风险扫描、测试计划、变更总结会话
  - 轨迹面板：线程轨迹 / 工具事件流 / shell_command 输出摘要 / 工作区快照 / 执行完成与失败状态 / 详情复制
  - Debug 面板：当前会话运行态 / 活跃流状态 / 终端状态 / 全局日志 tail / 快照复制 / 日志目录打开 / 日志清空
  - 技能面板：扫描本机 `SKILL.md` / 搜索 / 预览 / 一键插入 `/skill` / 打开技能目录
  - MCP 面板：读取本机 `codex mcp list/get` / 搜索 server / 预览配置详情 / 打开 `~/.codex/config.toml`
  - PR 新会话草稿已对齐审查意图：自动带入 PR 描述、diff 摘要、评论摘要，并明确将 PR 内容标记为不可信输入
  - 文件预览、主 diff 预览与 Git / GitHub 详情预览已升级为 `RichTextFX CodeArea`，支持行号和基础语法高亮
- 底部 Terminal Dock
  - 支持在当前工作区直接执行命令、查看输出、停止运行中的命令、打开工作区目录
- 会话级权限模式
  - 默认权限
  - 完全访问权限
  - 自定义 `config.toml`
- 内置模型选择与推理强度选择
- OpenAI Compatible 流式聊天
- 图片 + 文字混合输入
- 上下文占用估算、工作区上下文估算、实际 token 实时刷新
- 本地状态持久化
  - 会话历史
  - API 设置
  - 全局 `config.toml`
- 软件内全局日志
  - 顶部工具栏可直接打开“日志”
  - 支持刷新 / 复制 / 清空 / 打开日志目录
  - 自动记录会话切换耗时与流式请求异常
- 架构升级
  - 新增 `UiEventBus`
  - 新增 `SessionExecutionCoordinator`
  - 流式执行从 `MainView` 直接回调切换为事件驱动编排

## 技术栈

- Java 17
- JavaFX 21
- Maven
- OkHttp
- Jackson
- Tomlj
- RichTextFX

## 运行方式

```bash
mvn javafx:run
```

## 打包

```bash
mvn package
```

## 本地数据目录

应用运行后会在当前用户目录下生成：

```text
~/.ai-session/
```

包含：

- `app-state.json`
- `config.toml`
- `logs/ai-session.log`

## 说明

当前版本已经具备完整桌面端主框架和可用的 OpenAI Compatible 流式对话链路，适合作为后续继续扩展的第一版基础。