业务和功能介绍
1. 立项背景与目标
背景：传统运维工具（Zabbix、Nagios等）架构重、门槛高，难以覆盖边缘节点；故障排查依赖人工经验，效率低；变更操作缺乏AI辅助和细粒度审批审计。ops-agent将系统巡检、AI问诊、安全审批和可视化看板整合为统一单机程序，填补市场空白。
目标：交付v0.1.0版本，提供TUI/Daemon/Dashboard三种运行模式；以LLM实现自然语言驱动的智能运维；建立本地审查+LLM评估+人工审批三层安全机制；发行包一键部署，开箱即用。
2. 软件功能与核心模块
智能对话引擎：集成LLM，支持自然语言交互，内置ReAct和Plan-and-Execute双策略自动适配任务复杂度，自主调用系统工具，实现“对话即运维”。
安全管控中心：本地规则硬拦截+LLM辅助风险评估+人工风险队列审批三层防线，五级风险分级（只读到关键变更），全程审计可追溯。
自动化巡检与调度：后台守护进程支持Cron定时采集CPU/内存/磁盘/网络等指标，扩展至K8s/容器/Prometheus巡检，阈值告警推送钉钉/企微，告警归并为Incident故障事件。
用户交互层：TUI终端界面（ratatui，六Tab页，键盘导航）+ Web Dashboard（React，可视化看板）。
3. 核心业务流程
故障诊断修复流程：SSH登录→TUI对话页输入自然语言（如“nginx起不来”）→Agent经LLM意图分析，调用check_service/journalctl等诊断工具（安全审查保障只读）→流式呈现诊断结果→修复操作识别为高风险→进入风险队列待人工审批（a键批准/x键拒绝）→执行并反馈结果。
无人值守巡检与干预流程：Daemon systemd开机自启→按Cron定时执行巡检（指标每分钟，深度每30分钟）→数据写入SQLite→超阈值生成告警并推送钉钉/企微→运维人员通过Dashboard/TUI介入查看→查阅Incident时间线和处置计划→高风险操作仍经人工审批后执行。
4. 项目范围与约束
包含：v0.1.0全部功能开发（24个功能点）、测试、文档、发行包及安装脚本。
不包含：第三方监控系统迁移工具、SaaS云服务、移动端APP、高可用集群部署。
技术约束：Rust 2024 + tokio；前端React+TypeScript+Bun；SQLite。
环境约束：兼容麒麟/Linux（x86_64/aarch64），依赖systemd和Python 3.8+，可选kubectl/Docker。
背景：传统运维工具（Zabbix、Nagios等）架构重、门槛高，难以覆盖边缘节点；故障排查依赖人工经验，效率低；变更操作缺乏AI辅助和细粒度审批审计。ops-agent将系统巡检、AI问诊、安全审批和可视化看板整合为统一单机程序，填补市场空白。
目标：交付v0.1.0版本，提供TUI/Daemon/Dashboard三种运行模式；以LLM实现自然语言驱动的智能运维；建立本地审查+LLM评估+人工审批三层安全机制；发行包一键部署，开箱即用。
2. 软件功能与核心模块
智能对话引擎：集成LLM，支持自然语言交互，内置ReAct和Plan-and-Execute双策略自动适配任务复杂度，自主调用系统工具，实现“对话即运维”。
安全管控中心：本地规则硬拦截+LLM辅助风险评估+人工风险队列审批三层防线，五级风险分级（只读到关键变更），全程审计可追溯。
自动化巡检与调度：后台守护进程支持Cron定时采集CPU/内存/磁盘/网络等指标，扩展至K8s/容器/Prometheus巡检，阈值告警推送钉钉/企微，告警归并为Incident故障事件。
用户交互层：TUI终端界面（ratatui，六Tab页，键盘导航）+ Web Dashboard（React，可视化看板）。
3. 核心业务流程
故障诊断修复流程：SSH登录→TUI对话页输入自然语言（如“nginx起不来”）→Agent经LLM意图分析，调用check_service/journalctl等诊断工具（安全审查保障只读）→流式呈现诊断结果→修复操作识别为高风险→进入风险队列待人工审批（a键批准/x键拒绝）→执行并反馈结果。
无人值守巡检与干预流程：Daemon systemd开机自启→按Cron定时执行巡检（指标每分钟，深度每30分钟）→数据写入SQLite→超阈值生成告警并推送钉钉/企微→运维人员通过Dashboard/TUI介入查看→查阅Incident时间线和处置计划→高风险操作仍经人工审批后执行。
4. 项目范围与约束
包含：v0.1.0全部功能开发（24个功能点）、测试、文档、发行包及安装脚本。
不包含：第三方监控系统迁移工具、SaaS云服务、移动端APP、高可用集群部署。
技术约束：Rust 2024 + tokio；前端React+TypeScript+Bun；SQLite。
环境约束：兼容麒麟/Linux（x86_64/aarch64），依赖systemd和Python 3.8+，可选kubectl/Docker。
项目实现
1. 整体架构与设计思路
ops-agent采用单进程多模式架构，一个二进制文件通过命令行参数切换TUI/Daemon/Dashboard三种运行模式。架构分为五层：数据持久层（SQLite）、基础设施层（配置管理/MCP工具注册/LLM客户端）、安全管控层（本地审查+LLM评估+风险审批）、业务逻辑层（Agent对话引擎+Daemon调度引擎）、表现层（TUI+Web）。
三个核心理念：AI原生——LLM作为运维交互核心入口；安全优先——高风险操作必经“评估-审批-执行”完整链路；轻量敏捷——单机部署、嵌入式数据库、静态编译。
技术栈：Rust + tokio（核心），ratatui（TUI），axum + React（Dashboard），SQLite（数据库），MCP协议（工具接入）。
2. “我”负责的模块与成果
安全管控模块：设计五级风险分级体系、工具调用强制校验、多Reviewer决策汇总（8种汇总模式）、参数自动脱敏。
Daemon调度模块：构建定时任务调度框架，实现MCP工具巡检、系统指标采集、Managed Target自动展开巡检、single-flight防重入、systemd watchdog。
配置管理模块：实现TOML配置加载链路（三级覆盖）、路径展开、注释保留写入、explain子命令。
量化成果：累计8000行Rust代码（safety/daemon/config三个模块15个源文件），5篇技术文档超2万字。安全模块支撑8项功能、8类风险100%拦截；Daemon模块支撑5项功能、26个MCP工具调度，CPU占用<2%；支持最多5个安全模型并行评估。
3. 遇到的难点与解决方案
Python子进程残留：MCP工具超时后子进程堆积。解决：设置独立进程组，超时时终止整个进程组。
TOML注释丢失：配置热加载后注释消失。解决：toml_edit增量修改AST节点，仅写回变更段。
LLM调用循环：多步推理时反复调用同一工具。解决：max_tool_rounds上限（默认5轮），策略综合决策，轮次从4轮降至2轮。
SQLite锁冲突：并发读写频繁报错。解决：启用WAL模式，独立连接+busy_timeout，批量插入，查询用read_only。
Release panic定位难：无法定位错误位置。解决：保留调试符号，anyhow::Result加上下文，关键路径增加日志。
ops-agent采用单进程多模式架构，一个二进制文件通过命令行参数切换TUI/Daemon/Dashboard三种运行模式。架构分为五层：数据持久层（SQLite）、基础设施层（配置管理/MCP工具注册/LLM客户端）、安全管控层（本地审查+LLM评估+风险审批）、业务逻辑层（Agent对话引擎+Daemon调度引擎）、表现层（TUI+Web）。
三个核心理念：AI原生——LLM作为运维交互核心入口；安全优先——高风险操作必经“评估-审批-执行”完整链路；轻量敏捷——单机部署、嵌入式数据库、静态编译。
技术栈：Rust + tokio（核心），ratatui（TUI），axum + React（Dashboard），SQLite（数据库），MCP协议（工具接入）。
2. “我”负责的模块与成果
安全管控模块：设计五级风险分级体系、工具调用强制校验、多Reviewer决策汇总（8种汇总模式）、参数自动脱敏。
Daemon调度模块：构建定时任务调度框架，实现MCP工具巡检、系统指标采集、Managed Target自动展开巡检、single-flight防重入、systemd watchdog。
配置管理模块：实现TOML配置加载链路（三级覆盖）、路径展开、注释保留写入、explain子命令。
量化成果：累计8000行Rust代码（safety/daemon/config三个模块15个源文件），5篇技术文档超2万字。安全模块支撑8项功能、8类风险100%拦截；Daemon模块支撑5项功能、26个MCP工具调度，CPU占用<2%；支持最多5个安全模型并行评估。
3. 遇到的难点与解决方案
Python子进程残留：MCP工具超时后子进程堆积。解决：设置独立进程组，超时时终止整个进程组。
TOML注释丢失：配置热加载后注释消失。解决：toml_edit增量修改AST节点，仅写回变更段。
LLM调用循环：多步推理时反复调用同一工具。解决：max_tool_rounds上限（默认5轮），策略综合决策，轮次从4轮降至2轮。
SQLite锁冲突：并发读写频繁报错。解决：启用WAL模式，独立连接+busy_timeout，批量插入，查询用read_only。
Release panic定位难：无法定位错误位置。解决：保留调试符号，anyhow::Result加上下文，关键路径增加日志。
示例图片视频
相似推荐
quick_server
1、背景和目标：对企业所有服务请求进行轻量级安全和速度优化，减轻服务器的并发压力。
2、quick_server系统，不依赖外部引用，即插即用，主要用来进行极速快捷安全的http请求。大大减轻服务器的并发压力。轻松实现高并发场景下极速快捷安全的http请求。
json解析转换器
1、背景和目标：一、超级快速、安全对json的解析与对象转换；二、支持分布式超高并发
2、json解析转换器，支持分布式高并发，支持百万级别访问。用于快速进行json的解析与对象转换。原有的开源工具，要么安全性不够，要么性能不够强悍，要么不支持定制，很难满足企业日益严苛的业务需求。开发的这个json解析转换器，可以同时满足以上三种需求。
消息中心
1、背景和目标：解决高并发，对外提供统一的消息处理业务
2、功能模块介绍：六大功能模块：http通讯模块、缓存模块、消息队列模块、消息重试中心模块、消息调度模块、公共模块；对外百万级别并发项目，TPS可达1000/s。作为中间件，对外提供统一的消息处理业务。所有系统，包括电子签章平台、一照通行平台、一网通办平台，消息的请求和处理都经过消息中心。轻松实现异步、解耦、削峰。
3、功能描述：支持企业所有的内部系统接入，包括电子签章平台、一照通行平台、一网通办平台。轻松实现异步、解耦、削峰。
CRM客户管理后台
立项背景：针对中小型企业客户信息分散、销售跟进过程不透明、合同管理混乱等痛点，旨在打造一个轻量级的客户全生命周期管理后台，提升销售团队协作与转化效率。
核心功能：涵盖管理员登录鉴权、客户主表管理、联系人维护、跟进记录追踪、合同管理等六大模块。支持客户信息分页查询、关键字搜索、新增编辑与逻辑删除；客户详情页以名片形式集中展示联系人、跟进记录及关联合同。
业务流程：从潜在客户录入，到日常跟进记录，再到最终合同签订与操作日志审计，覆盖完整的销售业务闭环。
个人记账与资产管理平台
本项目是一套从零搭建的全栈个人财务管理平台，目标是替代功能单一的记账工具，把日常记账、资金账户、借贷往来、预算控制、资产盘点收敛到一个数据自主的系统中。系统由 12 个业务模块、23 个控制器、170 个 REST 接口、36 张数据表构成：记账核心支持三级分类树、商家联想、多平台支付与 CSV 批量导入导出，每笔账单自动联动账户余额并留存流水日志；借贷模块实现未结清 / 已结清 / 已放弃三态模型，支持分期还款与坏账核销；预算模块提供月度 + 年度双层体系与阶梯式执行规则；资产模块通过快照与趋势图呈现净资产变化；报表模块支持从月度 / 年度报表下钻到分类明细。系统还包含完整 RBAC 权限体系、软删除回收站、8 套主题实时切换与中英双语国际化。核心业务流程为：记一笔 → 余额幂等联动 → 报表与预算同步更新；借据从创建、关联账单凭证、分期还款到三态判定的完整生命周期；以及登录后由后端菜单树动态生成侧边菜单、路由与区块双重门控的权限链路。
帮助文档
Copyright @ 2021-2024 程聚宝 | 浙ICP备2021014372号
人工客服