# lirist **Repository Path**: dxdbc/lirist ## Basic Information - **Project Name**: lirist - **Description**: LiRiSt 程序员养成 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-07-09 - **Last Updated**: 2026-10-21 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # lirist — AI 数字程序员 > 不是聊天机器人,而是一支由 **Agent + Skill 组成的"软件工程师团队"**,可以独立自主地完成从需求到上线的全套软件工程过程。 **当前版本**: v5.8.0 --- ## 它能做什么 把一句话需求,变成真正可运行、经过审计、可持续演进的代码: ``` 一句话需求 → 需求分析 → 系统设计 → 代码实现 → 质量审计 → 知识沉淀 → 归档上线 ``` | 能力 | 说明 | |------|------| | **需求分析** | 六阶段交互式管道(梳理→细节→交互→设计→架构→版本计划),**45 项门禁**逐级锁定,模糊需求被精炼为可执行方案,中途断线可跨 Session 恢复 | | **代码开发** | 全流程自动化编排:设计 → 开发 → 测试 → 评审 → 归档,每一步都有 Gate 把关,遇阻自动暂停等人介入 | | **质量审计** | 7 个领域评审 Agent 并行把关(功能差异 / 工件 / 架构 / 安全 / 代码质量 / 隐性约定 / 测试),发现问题自动进入修复循环,修完再审 | | **BUG 修复** | 直接说 "issue: xxx" 即可:分析 → 修复 → 评审 → 建 PR 全自动 | | **知识进化** | 每个项目都有自进化知识库(技术 + 领域双维度),每次开发完自动复盘沉淀,越用越懂你的代码 | | **过程透明** | Session 过程审计、会话异常分析、问题溯源——干了什么、花了多少 Token、质量如何,全都能查 | | **可视化工作台** | 架构图、流程图、时序图推到可视化画布,AI 画你改,改完读回——设计与协作所见即所得 | ## 模块 | 模块 | 干什么 | |------|--------| | [analyzer/](analyzer/) | **需求分析与系统设计** — 6 阶段管道 + 45 项门禁 + 图表可视化,把模糊想法变成锁定方案 | | [coder/](coder/) | **代码开发编排** — 设计→开发→审计→修复→归档全流程编排,支持新功能开发与 BUG 修复两种模式 | | [knowledge/](knowledge/) | **知识库管理** — 全量扫描、迭代复盘、健康巡检,项目知识持续沉淀与保鲜 | | [builder/](builder/) | **项目初始化与过程审计** — 新项目一键接入(lirist-init)、自升级(lirist-upgrade)、Session 审计分析族 | | [workbench/](workbench/) | **多 Agent 调度管理服务** — 单 `opencode serve` 多 directory 路由、主管调度、任务引擎、事件网关与 Web UI,支持 systemd 多实例隔离部署 | | [plugins/design-board](plugins/design-board/) | **可视化设计工作台** — 图形化交互、图表展示、AI 与人的可视化协作 | ## 核心亮点 - **全流程自动化**:从需求到归档,AI 自动推进全流程,无需你盯每一步 - **45 项门禁防偷懒**:每阶段强制自检 + 评审,杜绝"差不多就行" - **质量闭环**:审计发现问题 → 自动修复 → 复审通过 → 才允许归档 - **知识自进化**:每次开发都是知识增量,项目越做,AI 越懂 - **跨 Session 恢复**:中断了随时继续,上下文不丢 - **过程可审计**:Token 消耗、会话质量、问题根源,全程可追溯 ## 安装 在 OpenCode 中告诉 Agent: ``` 请按照仓库根目录 install.md 安装 lirist ``` Agent 将自动完成:确认环境 → `./install.sh`(清理旧版 + 注入 LIRIST_HOME + 逐模块安装 + 创建脚本 venv)→ 提示重启会话。详见 [install.md](install.md)。 > 说明:install.sh 会将 workbench 服务部署到 `~/.cache/opencode/lirist/workbench/`(含 env 与 start.sh,启动即用);systemd 多实例隔离部署见 [workbench/deploy/README.md](workbench/deploy/README.md)。 ### 前置要求 | 依赖 | 版本 | |------|------| | OpenCode | 任意可用版本 | | git | ≥ 2.30 | | Python | ≥ 3.10 | | Node.js | ≥ 18 | ## 环境初始化(首次使用前) 以下两项按**你的实际环境**配置,lirist 不限定具体平台: ### Git 环境 lirist 的 Agent 通过 **`gh` / `ge` / `glab` CLI** 自动化执行 SCM 操作(拉取 Issue、创建分支、提交 PR、回复评论)。请按你的代码托管平台完成认证: **GitHub** ```bash # 1. 安装 CLI brew install gh # macOS / Linux(Homebrew) # 或 Debian/Ubuntu 添加官方 apt 源后安装(直接 apt install 装的是旧版): sudo mkdir -p -m 755 /etc/apt/keyrings && wget -nv -O- https://cli.github.com/packages/githubcli-archive-keyring.gpg \ | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg > /dev/null echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" \ | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null sudo apt update && sudo apt install gh # 2. 生成 Token(网页端) # Settings → Developer settings → Personal access tokens → Generate new token # 勾选 scope:repo(完整仓库权限)、workflow # 3. 配置认证(二选一) gh auth login # 交互式登录(推荐,支持浏览器/Token 两种方式) echo "" | gh auth login --with-token # 非交互式(脚本/CI 用) ``` **Gitee** ```bash # 1. 安装 CLI(官方一键安装脚本,默认装到 ~/.local/bin,无需 root) curl -sL https://gitee.com/imjoey/ge/raw/main/scripts/install.sh | bash # 2. 生成 Token(网页端) # https://gitee.com/profile/personal_access_tokens 生成私人令牌 # 勾选 scope:projects、pull_requests、issues(必要)、user_info # 3. 配置认证(二选一) export GITEE_TOKEN= # 环境变量(推荐,优先级最高) ge auth login --token # 写入本地配置 # 4. 验证 ge auth status ``` **GitLab(gitlab.com 或私有部署)** ```bash # 1. 安装 CLI(官方支持 Homebrew / Snap / 二进制;Linux 无官方 apt 包) brew install glab # macOS / Linux(Homebrew 为官方支持方式) sudo snap install glab # Linux(Snap,之后 sudo snap connect glab:ssh-keys) # 或下载官方二进制(最新版本号见 https://gitlab.com/gitlab-org/cli/-/releases) # 注意路径是 /-/releases/v<版本>/downloads/<文件>,且要区分架构: # x86_64 用 amd64,ARM 用 arm64 curl -LO https://gitlab.com/gitlab-org/cli/-/releases/v1.113.0/downloads/glab_1.113.0_linux_amd64.tar.gz # x86_64 curl -LO https://gitlab.com/gitlab-org/cli/-/releases/v1.113.0/downloads/glab_1.113.0_linux_arm64.tar.gz # ARM tar -xzf glab_1.113.0_linux_amd64.tar.gz && sudo install -m 0755 bin/glab /usr/local/bin/glab # 注:tar 包解压后为 bin/glab 单一二进制,装到 PATH 即可;以上版本号可自行替换为最新版 # 2. 生成 Token(网页端) # 用户设置 → 访问令牌 → 新建令牌 # 勾选 scope:api(完整 API 权限)、write_repository # 私有部署:在「用户设置 → 个人访问令牌」生成,如 git.xxx.cn 这类自建实例同理 # 3. 配置认证(私有部署必须带 --hostname) glab auth login --hostname gitlab.com # 公有云(交互式) glab auth login --hostname git.xxx.cn # 私有部署(交互式,指定你的实例域名) # 非交互式(脚本/CI,官方推荐) glab auth login --hostname git.xxx.cn --stdin < myaccesstoken.txt # 从文件读 token glab auth login --hostname git.xxx.cn --token # 直接传 token(共享环境不推荐) # 或环境变量方式(私有部署必须指向实例 URL) export GITLAB_HOST=https://git.xxx.cn # 私有部署实例完整 URL export GITLAB_TOKEN= # API token(用户设置 → 访问令牌生成) # 4. 验证 glab auth status ``` **通用确认** | 项目 | 说明 | |------|------| | 仓库地址 | `git remote get-url origin` 返回的平台必须与 CLI 一致(github.com / gitee.com / 私有部署域名) | | CLI 可用性 | `which gh` / `which ge` / `which glab` 非空 | | 认证有效性 | `gh auth status` / `ge auth status` / `glab auth status` 显示已登录 | | git 用户信息 | `user.name` / `user.email` 已配置(commit 需要) | | Agent 权限 | Agent 只创建分支与 PR,合并、打 Tag 由你人工掌控 | ### 测试环境 - lirist 自身脚本的测试依赖(pytest / PyYAML)由 install.sh 自动装入 `$LIRIST_HOME/.venv`,无需手动安装。 - 你的项目测试栈(pytest / vitest / 其他)不预装:项目接入时按实际技术栈自动识别引入。 ### 执行步骤 1. 重启 OpenCode 会话使新组件生效 2. 在项目根目录对 Agent 说「初始化 lirist 项目」,由 Lirist-master 完成项目接入(course/ 骨架、知识库) 3. 接入完成后说「我有个新需求」开始需求分析,或说「issue: xxx」直接修 BUG ## 目录结构 ``` lirist/ ├── analyzer/ # 需求分析与系统设计(6 阶段管道 + 45 门禁) ├── builder/ # 项目初始化、规则管理与过程审计 ├── coder/ # 代码开发编排(设计→开发→审计→归档) ├── knowledge/ # 知识库管理(扫描/复盘/巡检) ├── plugins/design-board/ # 可视化设计工作台插件 ├── workbench/ # 多 Agent 调度管理服务(workbench-remote) ├── scripts/ # lirist 脚本(门禁 / 状态 / SCM / 审计) ├── install.md # 安装指南(面向 OpenCode Agent) ├── install.sh # 统一安装脚本 ├── agent-spec/ # 开发规范 + 项目知识层(knowledge/ + rules/ + standards/) ├── AGENTS.md # 开发上下文 └── README.md ``` --- # **lirist — 把软件工程交给 AI,你只负责决策。**