CodeCast

AI 驱动的智能编程助手 —— 只需提出想法，执行交给 AI。

CodeCast 是一款本地优先的跨平台桌面应用，内置情景记忆系统、项目管理、Git 集成和技能扩展。它不只是一个聊天窗口——它理解你的项目上下文，记住你的偏好，帮你从想法到产物一步到位。自带 DeepSeek API Key 即可使用，数据完全本地存储，隐私安全。

🧠 情景记忆	基于 SQLite FTS5 的全文检索记忆系统。AI 能记住历史对话、自动提取摘要和标签，在新对话中召回相关上下文——跨会话的连续性体验。
📁 项目感知	多项目工作区管理，文件浏览/读写/预览，沙箱安全校验。AI 理解你的项目结构，在正确的上下文中工作。
🔧 技能系统	内置代码生成、代码审查、文档生成等技能。支持自定义技能创建和 JSON 导入，按需扩展 AI 能力边界。
🔌 MCP 协议	支持 WebSocket 和 stdio 两种 MCP 服务器接入，内置 Chrome DevTools 集成。连接任意 MCP 服务器扩展工具链。
⚡ Git 集成	实时 Git 状态检测，AI 修改文件后自动 commit，智能生成 commit message。开发工作流无缝衔接。
⏰ 自动化调度	内置定时任务系统，支持 hourly/daily/自定义 cron 表达式。代码审查、日报生成、定期备份——无人值守运行。
🖥️ 终端执行	沙箱化 Shell 命令执行，危险命令拦截，超时控制。AI 不只能写代码，还能帮你运行和调试。
🔒 本地优先	代码和数据完全本地存储，API Key AES-256-GCM 加密，路径沙箱防穿越，文件大小限制。你的代码只属于你。
🤖 多模型支持	支持 DeepSeek/OpenAI/Anthropic/Gemini/Ollama 五大模型提供商，14+ 模型可选。一键切换，按场景自动推荐最优模型。本地 Ollama 模型完全离线运行。
🧠 Agent v2.0	AI 驱动的动态任务规划器，自动将复杂任务拆解为子任务步骤。17 个内置开发工具，Checkpoint 人机协作机制确保安全。
🔧 Tool Registry	统一工具注册中心，涵盖文件操作、终端命令、Git 管理、测试执行、网络搜索、人机交互 6 大类 17 个工具。
⚡ 三级代码补全	L1 本地缓存 (<50ms) + L3 项目符号索引 (<10ms) + L2 AI 云端补全。FIM 中间填充模式，智能去抖与取消机制。
✅ Checkpoint 机制	高危操作（写文件/删除/推送）自动暂停等待用户确认。Diff 变更预览，风险等级评估，批量批准/拒绝。
📊 记忆可视化	情景记忆系统可视化面板，统计记忆数量/活跃度/热门标签。召回高亮显示来源，支持导出和清理。
🔀 Git 增强	AI Commit Message 生成（Conventional Commits 规范）、PR Template、Interactive Rebase UI、冲突解决辅助。

---

快速开始

下载安装

前往 codecast.cloud 或 GitHub Releases 下载：

平台	文件	说明
Windows	CodeCast.exe	Windows 10+ x64
macOS (Apple Silicon)	CodeCast-macOS-arm64.dmg	M1/M2/M3/M4 芯片
macOS (Intel)	CodeCast-macOS-amd64.dmg	Intel 芯片
Linux	即将推出	—

配置

1. 启动 CodeCast
2. 进入 设置 → 模型管理
3. 配置你的 AI 提供商：
   • DeepSeek (推荐): 高性价比，填入 API Key 即可
   • OpenAI: 支持 GPT-4o / o3 / GPT-4o-mini
   • Anthropic: Claude Opus 4 / Sonnet 4 / Haiku 3.5
   • Google: Gemini 2.5 Pro / Flash (百万上下文)
   • Ollama: 本地模型，无需 API Key（需安装 Ollama）
4. 选择默认模型和工作模式
5. 开始对话！

---

核心功能

AI 对话

CodeCast 提供多会话管理，支持创建、切换、归档对话。你可以选择不同的 AI 人格风格（友好/专业/简洁/详细），设置自定义指令注入 System Prompt，开启深度思考模式进行复杂推理，以及使用长上下文模式（1M token 窗口）处理大型代码库。

情景记忆系统

这是 CodeCast 最独特的能力。基于 SQLite FTS5 全文检索引擎，AI 会自动为每次对话生成摘要和标签，在新对话开始时检索相关历史记忆注入上下文。你不需要反复解释项目背景——AI 记得你之前说过什么、做过什么。记忆支持 30 天自动清理，后台异步处理不影响对话流畅度。

项目管理

支持多项目工作区切换，内置文件浏览器可以查看、读取、编辑项目文件。所有文件操作都经过沙箱安全校验，防止目录穿越攻击。文件预览面板支持代码高亮，2MB 大小限制保证渲染性能。也支持”无项目模式”进行纯对话。

技能与扩展

内置技能覆盖常见开发场景：代码生成、代码审查、文档生成。你也可以创建自定义技能，定义专属的 Prompt 模板，通过 JSON 导入分享给团队。技能的 Prompt 具有最高优先级，精确控制 AI 行为。

MCP 协议集成

通过 Model Context Protocol 连接外部工具服务器，支持 WebSocket 和 stdio 两种传输方式。内置 Chrome DevTools MCP 服务器，可以直接在对话中操控浏览器。支持服务器连接测试、启用/禁用管理。

Git 工作流

自动检测项目 Git 状态（当前分支、是否有未提交更改、ahead/behind 状态）。AI 修改文件后可以自动执行 git add + commit，智能生成 commit message，提交前通过对话框确认。

自动化任务

创建定时任务，支持多种调度表达式（every 30m / hourly / daily / daily 09:00）。后台调度器每分钟检查一次，任务完成后通知前端。适合定期代码审查、日报生成、自动备份等场景。

终端与命令执行

在项目目录内执行 Shell 命令，自动适配平台（Windows PowerShell / macOS zsh / Linux bash）。内置危险命令拦截（rm -rf /、format 等），超时控制防止命令挂起，支持自定义环境变量注入。

---

🆕 v1.0 新增功能

多模型管理系统 (New!)

CodeCast 现在支持 5 大 AI 提供商，14+ 个模型可选：

提供商	模型数	特点	推荐场景
DeepSeek	2	高性价比，中文优化	日常对话、快速编程
OpenAI	3	GPT-4o 全能，o3 强推理	复杂推理、创意写作
Anthropic	3	最强推理能力，长上下文	深度分析、代码审查
Google	2	百万 token 上下文窗口	大型代码库、数据分析
Ollama	3	完全本地，零成本	隐私敏感、离线环境

切换方式：聊天界面左下角模型选择器 → 选择 Provider 和模型 → 即时生效

Agent 自主执行系统 (New!)

Agent v2.0 带来了真正的 AI 自主编程能力：

1. 智能规划：输入任务描述 → AI 自动拆分为可执行的子任务步骤
2. 工具调用：自动选择合适的工具（读文件、写代码、跑测试、Git 提交）
3. 安全确认：高危操作自动暂停，展示 Diff 预览，等你批准
4. 错误自修复：遇到编译错误 → 分析原因 → 生成修复方案 → 验证结果

适用场景：

• “帮我重构这个组件”
• “修复登录页面的验证 Bug”
• “为这个模块编写单元测试”
• “优化这段代码的性能”

代码补全引擎升级 (New!)

三级缓存架构带来极致体验：

用户按键 → [L1 本地缓存 <50ms] → [L3 项目符号 <10ms] → [L2 AI 补全 <500ms]

• FIM 模式：光标不在行尾时，AI 预测中间内容
• 智能排序：基于上下文相关度评分，首选项命中率 >40%
• 项目感知：自动索引函数名、变量名、导入路径
• 快捷键：Tab 触发补全 / Ctrl+Space 强制刷新 / ↑↓ 选择

Git 工作流增强 (New!)

四大新功能让 Git 操作更智能：

• 🤖 AI Commit：分析 diff → 生成符合规范的 commit message → 一键应用
• 📋 PR 助手：自动填充标题/描述/Issue 关联
• 🔄 Interactive Rebase：可视化操作最近提交（squash/reword/drop）
• ⚠️ 冲突解决：检测冲突 → 三种策略选择 → AI 辅助合并

---

🎬 Cast 工作台

Cast 工作台是 CodeCast v1.0 推出的全新生产力套件，将 AI 能力从编程场景扩展到日常办公。它包含 6 大功能面板和 30+ 个专用工具，覆盖写作、翻译、日程、知识管理、邮件、数据分析等场景。

写作助手

专业级 AI 写作工具，支持 9 种文档类型（周报、方案、文案、总结、邮件、PPT 大纲、简历、博客、自定义），6 种写作模式（生成/续写/润色/扩写/缩写/改写），6 种风格（正式/ casual /学术/营销/技术/创意）。

核心特性：

• 角色化写作：根据文档类型自动切换专业角色（项目经理、文案撰稿人、职业规划师等）
• Markdown 实时预览：所见即所得，支持导出为 Markdown 文件
• 智能扩写/缩写：一键调整内容长度，保持核心信息完整
• 写作建议：AI 实时提供结构优化和内容改进建议

使用示例：

选择「周报」类型 → 输入本周工作内容 → AI 生成结构化周报
→ 不满意点击「润色」→ 选择「更正式」风格 → 获得专业版本

翻译工作台

支持 15+ 语言互译，5 种翻译风格（直译/意译/口语化/正式/学术），双语对照视图，术语表管理。

核心特性：

• 上下文感知翻译：理解专业领域术语，保持翻译一致性
• 术语表锁定：自定义术语映射，确保关键术语翻译准确
• 翻译历史：自动保存翻译记录，支持快速复用
• 批量处理：支持大段文本分段翻译，避免截断

使用示例：

粘贴技术文档 → 选择「中文→英文」→ 选择「学术」风格
→ 添加术语表："微服务"→"Microservices" → 获得专业译文

日程管理

智能待办与日程系统，支持 4 级优先级、日历视图、AI 智能排期、重复任务、统计面板。

核心特性：

• AI 智能排期：输入任务列表，AI 根据优先级和截止时间自动规划最优执行顺序
• 重复任务：支持 daily/weekly/monthly/custom 多种重复规则
• 统计面板：完成率趋势、优先级分布、延期分析
• 提醒通知：任务到期前自动提醒，支持自定义提前时间

使用示例：

创建任务："周五前完成 API 文档" → AI 建议拆分为 3 个子任务
→ 设置重复：每周五生成周报提醒 → 日历视图查看整体安排

知识库笔记

Markdown 编辑器 + 分类标签体系 + 全文搜索 + 双向链接，打造个人知识管理系统。

核心特性：

• 双向链接：[[笔记标题]] 快速关联相关知识，自动构建知识图谱
• 分类标签：支持多级分类 + 多标签，灵活组织笔记
• 全文搜索：基于 SQLite FTS5，毫秒级搜索所有笔记内容
• 导入导出：支持 Markdown 文件批量导入/导出，兼容 Obsidian

使用示例：

新建笔记「React Hooks 最佳实践」→ 添加标签 #frontend #react
→ 在另一篇笔记中输入 [[React Hooks 最佳实践]] → 自动建立链接
→ 全局搜索 "useEffect" → 快速定位相关笔记

邮件起草器

10+ 邮件模板，AI 润色，联系人管理，签名管理，一键复制。

核心特性：

• 模板库：商务沟通、项目汇报、请假申请、会议邀请等 10+ 场景模板
• 变量替换：{{name}}、{{date}} 等变量自动填充
• 语气调整：正式/友好/紧急/歉意 四种语气一键切换
• 联系人管理：保存常用联系人，快速填充收件人信息

使用示例：

选择「项目进度汇报」模板 → 填充变量：项目名、进度百分比、风险点
→ 选择「正式」语气 → AI 润色 → 一键复制到邮件客户端

更多工具

Cast 工作台还包含 12+ 轻量工具：

工具	功能
📊 数据分析	自然语言描述分析需求，AI 生成数据洞察和可视化建议
📝 会议纪要	录音/文字转结构化会议纪要，自动提取待办事项
💡 头脑风暴	输入主题，AI 生成多维度创意方案
🍅 番茄钟	专注计时器，统计每日专注时长
🔍 OCR 识别	图片文字提取，支持多语言
📈 图表生成	文本描述生成 Mermaid/PlantUML 图表
🔄 格式转换	JSON/YAML/XML/CSV 互转，代码格式化
🔐 密码生成	安全密码生成器，支持自定义规则
⏱️ 时间转换	时区转换、时间戳格式化、倒计时
🌐 网页速览	输入 URL，AI 总结网页核心内容
📋 模板库	常用文档模板快速生成
🧮 计算工具	复杂公式计算、单位换算、正则测试

---

🏗️ Cast 系统架构

Cast 工作台采用模块化架构设计，包含 30+ 个核心模块：

核心引擎

模块	功能
Soul Engine	AI 人格引擎，定义助手性格、专长、语气、回复风格
Agent Planner	智能任务规划器，将自然语言目标分解为可执行步骤
Agent Executor	任务执行引擎，调用工具链完成规划任务
Learning Loop	操作学习系统，分析用户行为模式，自动优化工作流
Memory Bridge	Cast 与主系统记忆互通，跨模块上下文共享

服务层

模块	功能
API Server	本地 HTTP API 服务（默认端口 18790），支持外部系统集成
API Client	标准化 API 调用封装，统一错误处理和重试机制
Channel Engine	多渠道消息推送（Webhook/邮件/飞书/钉钉/Slack）
Browser Engine	内置浏览器控制，网页截图、表单填写、内容抓取
Sandbox	脚本沙箱执行环境，支持 JavaScript/Python/Shell/SQL
Scheduler Engine	定时任务调度器，支持 cron 表达式和多种触发方式

数据与隐私

模块	功能
Privacy Manager	出站流量审计，数据分类分级，隐私合规报告
Backup Manager	自动备份与恢复，SHA-256 校验，版本管理
Storage Health	存储健康监控，容量预警，自动清理
Offline Detector	网络状态检测，离线模式自动切换
Data Migration	数据迁移工具，版本升级无缝过渡

协作与扩展

模块	功能
Collab Engine	实时协作编辑，多人同步，变更冲突解决
Marketplace	插件市场，支持插件发现、安装、评分、更新
Plugin Loader	插件加载器，权限隔离，热插拔支持
Worker Pool	Web Worker 线程池，CPU 密集型任务并行处理
Resource Manager	系统资源监控，内存/CPU 使用优化

业务引擎

模块	功能
Writing Engine	写作核心引擎，角色化 Prompt 构建
Translation Engine	翻译核心引擎，多语言风格适配
Email Engine	邮件模板渲染，变量替换，语气润色
Daily Completion	每日完成度追踪，习惯养成统计

---

技术架构

CodeCast
├── 后端 (Go 1.25)
│   ├── Wails v2 桌面框架
│   ├── SQLite (纯 Go 实现)
│   ├── LLM Provider 抽象层
│   │   ├── DeepSeek Provider
│   │   ├── OpenAI 兼容 Provider
│   │   ├── Anthropic Claude Provider
│   │   └── Ollama 本地模型 Provider
│   ├── MCP 协议客户端
│   └── Git 操作 / Shell 执行
├── 前端 (React 18 + TypeScript)
│   ├── Vite 5 构建 + Rollup 分包
│   ├── Zustand 状态管理
│   ├── Agent v2.0 引擎 (TaskPlanner + ToolRegistry)
│   ├── 三级代码补全 (Orchestrator + Cache + SymbolIndex)
│   ├── Checkpoint 协作系统
│   ├── 情景记忆可视化面板
│   └── 🎬 Cast 工作台 (30+ 模块)
│       ├── Soul Engine / Agent Planner / Learning Loop
│       ├── API Server / Channel Engine / Browser Engine
│       ├── Sandbox / Scheduler / Collab Engine
│       ├── Privacy Manager / Backup Manager / Marketplace
│       └── Writing / Translation / Email / Daily Completion
└── 跨平台桌面应用
    ├── Windows (Wails WebView2)
    ├── macOS (Wails WKWebView)
    └── Linux (即将推出)

---

界面特性

CodeCast 提供精心设计的桌面体验：自定义无边框窗口、深色/浅色主题切换、可调节字体大小、侧边栏会话列表、斜杠命令系统（/command 快速触发）、文件附件上传、通知中心、置顶模式，以及一键在外部编辑器中打开文件（自动检测 VS Code、Cursor、WebStorm 等）。

---

安全设计

CodeCast 在安全性上做了多层防护：API Key 使用 AES-256-GCM 加密存储在本地；文件操作经过路径沙箱校验，防止目录穿越；读写有大小限制（读 4MB / 写 10MB）；Shell 命令执行拦截危险操作；敏感数据在 UI 中掩码显示。你的代码永远不会离开你的电脑——只有你主动发送给 AI 的内容才会通过 API 传输。

Cast 工作台额外安全特性：

• Privacy Manager：所有出站请求分类审计（LLM API / Webhook / 浏览器 / 邮件），数据量统计，隐私报告生成
• Sandbox 执行：脚本运行在隔离环境，可配置权限级别（沙箱/受限/完全访问），超时和内存限制
• Backup 加密：本地备份数据 SHA-256 校验，防止篡改

---

开发

环境要求

• Go 1.24+
• Node.js 20+
• Wails CLI (go install github.com/wailsapp/wails/v2/cmd/wails@latest)

本地开发

git clone https://github.com/1405451216/CodeCast.git
cd CodeCast/CodeCast-desktop
wails dev

构建

# Windows
wails build -platform windows/amd64

# macOS
wails build -platform darwin/arm64
wails build -platform darwin/amd64

---

路线图

• Windows 支持
• macOS 支持 (Apple Silicon + Intel)
• 🎬 Cast 工作台 v1.0
• 多模型提供商（OpenAI、Claude、本地模型）
• Agent 自主执行系统
• 代码补全引擎
• 插件市场框架
• Linux 支持
• 实时代码协作
• 移动端伴侣应用
• 云端同步（可选）

---

贡献

欢迎贡献！请 Fork 本仓库，创建功能分支，提交 Pull Request。

git clone https://github.com/1405451216/CodeCast.git
cd CodeCast/CodeCast-desktop/frontend
npm install
cd ..
wails dev

---

许可证

MIT — 详见 LICENSE。

---

版本历史

v1.0.0-beta (2026-05-27)

🌟 新功能

• 多模型支持: 5 大提供商 (DeepSeek/OpenAI/Anthropic/Gemini/Ollama)，14+ 模型
• Agent v2.0: AI 动态任务规划 + 17 个内置工具 + Checkpoint 安全机制
• 三级代码补全: L1/L2/L3 缓存架构 + FIM 中间填充模式
• Git 工作流增强: AI Commit / PR Template / Interactive Rebase / 冲突解决
• 情景记忆可视化: 记忆统计面板 + 召回高亮 + 标签云
• 性能优化: 虚拟滚动 + Bundle 分包 + React.memo + 图片懒加载
• 🎬 Cast 工作台: 6 大功能面板 + 30+ 个 Cast 专用工具 + 写作/翻译/日程/知识库/邮件/工具箱

🎬 Cast 模式详情

面板	功能
✍️ 写作助手	9 种文档类型 · 6 种写作模式 · 6 种风格 · AI 润色/扩写/缩写 · Markdown 实时预览
🌐 翻译工作台	15+ 语言互译 · 5 种翻译风格 · 双语对照视图 · 术语表管理 · 翻译历史
📋 日程管理	待办 CRUD · 4 级优先级 · 日历视图 · AI 智能排期 · 重复任务 · 统计面板
📚 知识库笔记	Markdown 编辑 · 分类标签体系 · 全文搜索 · 双向链接 · 导入导出
📧 邮件起草器	10+ 模板 · AI 润色 · 联系人管理 · 签名管理 · 一键复制
🔧 更多工具	数据分析 · 会议纪要 · 头脑风暴 · 番茄钟 · OCR 等 12+ 轻量工具

🏗️ Cast 系统架构 (30+ 模块)

层级	模块
核心引擎	Soul Engine · Agent Planner · Agent Executor · Learning Loop · Memory Bridge
服务层	API Server · API Client · Channel Engine · Browser Engine · Sandbox · Scheduler
数据隐私	Privacy Manager · Backup Manager · Storage Health · Offline Detector · Data Migration
协作扩展	Collab Engine · Marketplace · Plugin Loader · Worker Pool · Resource Manager
业务引擎	Writing Engine · Translation Engine · Email Engine · Daily Completion

🔧 改进

• 修复 77 个代码质量问题（Critical/Major/Minor）
• Mock 数据替换为真实 API 集成
• 安全性增强（注入防护、资源泄漏修复、Privacy Manager 审计）
• TypeScript 编译 0 错误通过

📊 测试

• 新增 164 个单元测试用例（+33 Cast 模式测试）
• 覆盖 Store/Tools/Checkpoint/TaskPlanner/Schedule/Knowledge/Completion 核心模块

---

CodeCast — 智能无限，协作无间
官网 · 下载 · 反馈