更新于 2026-07-15
⚠️ 警告 在 Ubuntu 上请使用官方 Docker 安装方式，不要使用 snap 版本，详见 issue #5 创建项目文件夹 mkdir gisia cd gisia 初始化配置 docker pull gisia/init:latest docker run --rm -v ./:/output…
1. 注册一个 Runner 1. 配置你的流水线 1. 以管理员身份登录 1. 访问 /admin/runners 1. 点击 New instance runner 按钮 1. 点击 Create Runner 按钮 1. 拉取 Runner 的 Docker 镜像：docker pull…
本指南介绍如何使用标签（Label）和看板（Board）来组织和管理项目中的议题（Issue）。 议题是需要跟踪和完成的任务、缺陷或功能需求。你可以通过以下方式组织议题： - 标签 - 按类型或状态对议题进行分类和筛选 - 看板 - 用代表不同阶段的列来可视化议题工作流 - 指派人 - 将议题指派给团队成员 - 状态…
Gisia 提供机器可读的技能（Skill）文件，让 AI 机器人能够通过 API 理解并操作你的项目。本指南将带你把机器人连接到项目，并让它替你执行真实的 DevOps 任务。 每个项目都在可预测的 URL 上提供一组 Markdown 技能文件： - /-/skill.md — 项目概览、认证方式以及可用技能 -…
默认情况下，Gisia 提供内置的技能文件，告诉 AI 机器人如何与你的项目交互。你可以把 Markdown 文件提交到仓库的特殊目录中，来替换其中任意一个。 当技能 URL 被请求时，Gisia 会先在你的仓库中查找匹配的文件： 如果该文件存在，则返回它而不是内置默认版本。如果不存在，则使用默认版本。…
默认情况下，Gisia 的所有邮件功能都是禁用的。要发送邮件，你需要在 gitlab.yml 中启用邮件并配置 SMTP。 打开项目文件夹中的 config/web/gitlab.yml，在 gitlab: 部分内添加 smtp 配置块： 保存文件后重启 Gisia web 容器： 在容器内打开 Rails…
Gisia 在约定的 URL 上提供机器可读的技能文件。你的 AI 机器人不需要阅读静态 API 文档，而是直接从你的运行实例抓取技能文件 — 因此它拿到的 URL、ID 和作用域始终准确且最新。 技能文件有意不在这里以静态示例的形式重复。原因有二： - 实例相关的值 — 基础 URL、项目 ID…
Gisia 支持的所有 CI YAML 关键字参考。
升级前请先在发布页面查看最新版本。 1. 在你的 docker-compose.yml 中把 Gisia 版本改为 image: gisia/gisia:VERSION 2. 升级第三方二进制组件（例如 Gitaly）： 3. 将你的 Docker Runner 升级到发布说明中指定的版本
备份前必须先停止 Gisia，以保证数据一致性。 1. 停止服务： 2. 归档 Gisia 文件夹： 3. 重新启动服务：
启用后，此 Gisia 实例会定期检查是否有新版本。 1. 进入 Admin → Settings → Metrics 2. 展开 Version Check 部分 3. 勾选或取消勾选 Enable version check 4. 点击 Save changes 版本检查默认启用。你可以随时选择关闭。