Galcode 是一款基于 OpenCode 引擎深度定制的网页版全栈 AI 编程助理。它将 OpenCode 强大的本地文件操作、工具调用能力与现代化、灵动的 Web 交互界面完美结合,旨在为开发者提供一个更具温度且高效的 AI 协作环境。
- 二次元沉浸式 UI:基于 React 打造的现代化界面,内置 Haruhi (团长) 与 Yuki (长门) 双 Agent 模式,支持 Tab 键快速切换。
- 全能模型支持:支持 OpenAI, DeepSeek, Google Gemini, Anthropic 以及通过本地 Ollama 接入的各种模型。
- 原生 GitHub Copilot 接入:内置 OAuth 设备授权流。无需手动寻找 Token,网页端点击即可唤起 GitHub 官方认证,一键激活。
- Notion-style 技能系统:
- 支持本地 Markdown 技能模板。
- 实时指令补全:在输入框打出
/即可触发模糊搜索菜单,快速加载深度插件(如视频解析、代码审计、量化分析等)。
- 智能权限闭环:针对 OpenCode 的工具调用进行了静默授权优化,Agent 在执行文件读写、终端指令时无需反复确认,实现全自动工作流。
- 完善的会话管理:支持历史 Session 的持久化存储与回溯,无缝衔接之前的开发任务。
项目采用全栈解耦架构,通过“桥梁”模式连接底层引擎:
- Frontend (React): 运行于
5173端口,负责交互逻辑、指令补全与消息渲染。 - Bridge API (Hono/Bun): 运行于
3001端口,负责处理 GitHub 鉴权、本地 Skill 文件读取及指令拦截。 - OpenCode Engine: 运行于
4096端口,负责管理 Agent 状态、执行工具调用(Tool Use)及与大模型厂商通信。
确保你的电脑已安装以下工具:
# 克隆仓库
git clone [https://github.com/sjyinzju/Galcode.git](https://github.com/sjyinzju/Galcode.git)
cd Galcode
# 一键安装所有依赖(包括前端、后端与工程化工具)
npm run install:all- 一键启动 在项目根目录下运行以下命令,系统将自动同时拉起引擎、桥梁和前端界面:
npm run dev
启动完成后,浏览器会自动打开或手动访问:http://localhost:5173。
🛠️ 自定义技能 (Skills) Galcode 的核心威力来自于其可扩展的技能系统:
在项目根目录的 skills/ 文件夹下创建一个新文件夹(如 my-tool)。
在该文件夹下编写 SKILL.md,定义 Agent 的行为准则与任务目标。
重启服务后,在网页端输入 /my-tool 即可加载该技能。
🛡️ 隐私与安全 密钥安全:所有的 API Key 和 GitHub 授权 Token 均保存在你本地电脑的 ~/.config/opencode/ 目录下,绝不会随代码上传至 GitHub 或任何第三方服务器。
离线存储:聊天记录保存在本地 SQLite 数据库中,你拥有数据的绝对控制权。
📝 开发手册 如果你想对本项目进行二次开发:
修改前端:进入 frontend/src/App.tsx。
修改后端逻辑:进入 backend/packages/opencode/src/web-api.ts。
调试命令:使用 npm run dev 可以在同一个终端窗口查看三端的实时日志输出。
🌟 开发者寄语 本项目由 Shi Junyu (ZJU) 开发。我们的原则是:“解放思想,实事求是,守正创新”。
希望 Galcode 能帮你提升效率,带来新的观点与价值。欢迎提交 PR 或 Issue!
PS: 如果你觉得好用,请给一个 Star ⭐️ 吧!
Powered by OpenCode Engine & Bun Runtime.