mirror of https://github.com/jeffusion/gitea-ai-assistant.git synced 2026-06-05 07:26:50 +00:00

Files

jeffusion c313764b61 docs(readme): reorganize docs and screenshot gallery

Align project docs with current behavior using progressive disclosure and bilingual deep-dive guides. Add per-page admin screenshots with consistent page-* naming to make UI documentation clearer.

2026-03-24 16:04:57 +08:00

1.3 KiB

Raw Blame History

快速开始

环境要求

Bun >= 1.2.5
可访问的 Gitea 实例
至少一个 LLM 提供商凭证

安装

git clone https://github.com/user/gitea-ai-assistant.git
cd gitea-ai-assistant
bun install

在仓库根目录执行 bun install 会通过 postinstall 自动安装 frontend 依赖。

如果你的环境禁用了生命周期脚本：

bun run bootstrap

最小环境变量

创建 .env 文件：

PORT=5174
ENCRYPTION_KEY= # 必填，使用 openssl rand -hex 32 生成
# DATABASE_PATH=./data/assistant.db

ENCRYPTION_KEY 为必填项，缺失时服务会拒绝启动。

启动服务

bun run dev
# 或
bun run start

首次登录

访问 http://your-server:5174
首次启动默认管理员密码为 password
登录后请立即修改管理员密码

Webhook 配置

方式 A：管理后台（推荐）

在仓库列表点击启用按钮，由系统自动配置 webhook。

方式 B：手动配置

在 Gitea 仓库设置中配置：

URL：http://your-server:5174/webhook/gitea
Content Type：application/json
Secret：与管理后台中的 Webhook Secret 保持一致
事件：Pull Request + Status

健康检查

可通过 /api/health 查看服务状态。

1.3 KiB Raw Blame History Unescape Escape