Personal-Assistant

Personal-Assistant — 功能强大的个人AI助手CLI工具。

🌟 核心功能

AI平台支持

• 10+ AI平台 — OpenAI, Anthropic, Google, DeepSeek, SiliconFlow, 阿里云百炼, 智谱AI, 百度文心, Ollama, LM Studio
• 智能模型搜索 — 自动从平台API搜索匹配模型
• 自动降级 — 一个模型失败时自动尝试下一个
• 流式响应 — 实时AI输出显示
• 熔断器 — 内置熔断器自动隔离问题平台

对话功能

• 对话管理 — 完整的对话历史管理
• 本地存储 — 数据持久化到本地磁盘
• 多轮对话 — 支持上下文感知的对话

🤖 双Agent协作系统

• 智能任务分解 — LLM驱动的规划Agent自动分解复杂任务
• 智能执行决策 — 执行Agent智能选择工具调用策略
• 任务复杂度评估 — 自动判定任务难度，选择单/双Agent模式
• 协作管理器 — 协调Agent间通信和状态管理
• 优雅降级 — LLM失败时自动回退到规则模式
• 多Agent调度器 — 并行任务执行、负载均衡、智能路由

🧠 知识与记忆系统

• 知识图谱 — 智能知识提取、推理、关联分析
• 长期记忆 — 智能重要性评分、遗忘机制、关联网络
• RAG检索 — 多种检索策略、质量评估、结果重排序
• 记忆摘要 — 自动生成对话摘要和关键点

🎭 人格与情绪系统

• 预设人格 — 友好导师、技术专家、创意天才、务实工作者
• 情绪响应 — 基于对话调整情绪状态
• 用户偏好学习 — 学习用户交互风格和偏好
• 人格兼容性分析 — 分析不同人格配合效果

🔒 信任与安全系统

• 信任等级 — 自动评估信任度，动态调整执行策略
• 风险检测 — 自动检测破坏性操作和敏感信息
• 审计日志 — 完整记录所有操作历史
• 安全确认 — 敏感操作需要用户确认

🛠️ 开发工具生态

• 内置工具 — Shell, 文件操作, HTTP, JSON, 文本处理等
• 高级工具 — 批量操作、Git智能、代码质量分析
• 安全工具 — 安全审计、文档生成、测试生成
• 性能监控 — 系统指标、操作统计、性能分析

💻 IDE集成与代码智能

• 完整LSP服务器 — Language Server Protocol实现，支持代码补全、定义跳转、引用查找
• 智能代码补全 — 上下文感知的关键字、符号、代码片段补全
• 重构引擎 — 提取方法、重命名、简化条件、模板字符串转换等
• 多语言支持 — TypeScript, JavaScript, Python等

🌐 多渠道消息系统

• Telegram Bot — 长轮询消息接收、照片/文档发送、Inline键盘
• Discord WebSocket — Gateway连接、消息路由、频道管理
• 统一消息路由 — 智能消息路由、广播、定时消息
• 跨平台通知 — 多渠道统一通知管理

🎯 Skill系统

• 可学习技能 — 从任务执行中自动学习和创建新技能
• 智能匹配 — 基于触发词和相似度自动匹配技能
• 自动执行 — 条件触发和手动调用
• 持续学习 — 从执行结果中学习和优化

⏰ 定时任务与自动化

• Cron调度 — 强大的定时任务调度（秒级精度）
• 重试机制 — 失败自动重试、指数退避
• 任务历史 — 完整的任务执行记录和统计
• Webhooks — 认证、验证、限流、错误处理

👥 团队协作管理

• 用户与团队 — RBAC权限管理、项目隔离
• 协作会话 — 实时协作、消息共享、权限控制
• 会话历史 — 完整协作记录和回放

👁️ 视觉处理

• 图像分析 — 物体检测、人脸识别、颜色分析
• OCR文字提取 — 从图片中提取文字
• 图表生成 — Mermaid格式图表自动生成

📊 监控与分析

• 性能监控面板 — 实时CPU、内存、事件循环监控
• 告警系统 — 自动告警、阈值设置、历史记录
• 使用统计 — 命令、技能、任务使用统计
• 趋势分析 — 性能趋势、用户行为分析
• 报告生成 — JSON、文本、Markdown格式报告

☁️ 云同步与备份

• 多云存储 — S3、GCS、Azure Blob、本地文件
• 自动备份 — 定时备份、增量同步
• 数据恢复 — 快速恢复、版本管理
• 冲突处理 — 自动合并、冲突解决

🌐 浏览器自动化

• Playwright控制 — 导航、点击、表单填写、截图
• 页面分析 — 元素提取、链接收集、表单识别
• 文件操作 — 文件上传/下载、Cookie管理
• 自动化脚本 — 自定义JavaScript执行

📦 安装

从GitHub安装

# 克隆仓库
git clone https://github.com/badhope/Personal-Assistant.git
cd Personal-Assistant

# 安装依赖
npm install

# 全局链接(可选)
npm link

要求: Node.js >= 18.0.0 < 23.0.0

🚀 快速开始

基础配置

# 1. 配置API密钥
personal-assistant config provider set-key aliyun sk-xxxxx
personal-assistant config set-default aliyun

# 2. 开始对话
personal-assistant chat ask "Hello, introduce yourself"

# 3. 交互式多轮对话
personal-assistant chat start

双Agent模式使用

# 强制启用双Agent协作模式
personal-assistant agent run "重构项目架构" --dual-agent

# 简写方式
personal-assistant agent run "分析代码库" --da

# 自动模式(根据任务复杂度智能选择)
personal-assistant agent run "修复简单bug"

高级工具示例

# 安全审计扫描
securityAudit({ path: './src', severity: 'medium' })

# 代码质量分析
codeQuality({ path: './src', language: 'typescript' })

# 智能Git提交
gitSmartCommit({ autoAdd: 'true' })

# 性能监控
systemMetrics()

# 浏览器自动化
browser.navigate('https://example.com')
browser.click('button.submit')

定时任务示例

// 创建定时任务
scheduler.addTask({
  name: 'daily-report',
  cron: '0 8 * * *',  // 每天早上8点
  action: async () => {
    const report = monitor.generateReport();
    await router.send({ content: report });
  }
});

使用统计追踪

// 追踪用户行为
tracker.trackCommand('build', true, 5000);
tracker.trackSkill('code-analyzer', true, 30000);
tracker.trackFeature('autocomplete');

// 生成使用报告
const report = tracker.generateReport();
console.log(report.summary);

⚙️ 命令参考

对话命令

personal-assistant chat start                    # 交互式多轮对话
personal-assistant chat ask <question>             # 单轮快速问答
personal-assistant chat models -p aliyun          # 列出平台模型

Agent命令

personal-assistant agent run <task>              # 运行Agent任务
personal-assistant agent run <task> --dual-agent # 双Agent模式
personal-assistant agent run <task> --da        # 简写双Agent模式

配置命令

personal-assistant config init                   # 交互式配置向导
personal-assistant config list                   # 查看所有配置
personal-assistant config provider set-key <platform> <API Key>
personal-assistant config set-default <platform>
personal-assistant config test <platform>        # 测试平台连接

工具命令

personal-assistant tools list                    # 列出所有工具

开发命令

npm run build                      # 构建项目
npm run dev                       # 监听模式开发
npm run test                      # 运行所有测试
npm run lint                      # 运行ESLint
npm run format                    # 运行Prettier
npm run test:coverage             # 测试覆盖率报告

🏗️ 项目架构

Personal-Assistant/
├── src/                         # 源代码
│   ├── cli.ts                  # CLI入口
│   ├── commands/               # CLI命令
│   ├── providers/             # AI平台适配器
│   ├── agent/                 # Agent系统(DDD架构)
│   │   ├── domain/           # 领域层(业务逻辑)
│   │   │   ├── models/       # 领域模型
│   │   │   ├── services/     # 领域服务
│   │   │   └── repositories/ # 仓库接口
│   │   ├── application/       # 应用层(用例)
│   │   │   ├── services/     # 应用服务
│   │   │   └── dtos/        # 数据传输对象
│   │   ├── infrastructure/   # 基础设施层
│   │   │   ├── repositories/ # 仓库实现
│   │   │   ├── common/      # 公共组件(双Agent、协议等)
│   │   │   └── state-machines/ # 状态机
│   │   └── interfaces/       # 接口层(控制器)
│   ├── memory/                # 记忆系统
│   ├── tools/                 # 工具系统
│   ├── ide/                   # IDE集成(LSP、补全、重构)
│   ├── channels/              # 多渠道消息(Telegram、Discord)
│   ├── skills/                # Skill学习和执行引擎
│   ├── multi-agent/           # 多Agent调度器
│   ├── browser/               # 浏览器自动化(Playwright)
│   ├── scheduler/             # 定时任务调度
│   ├── webhook/               # Webhook处理器
│   ├── collaboration/         # 团队协作管理
│   ├── vision/                 # 视觉处理
│   ├── monitoring/            # 监控和分析
│   ├── cloud/                 # 云同步和备份
│   ├── config/                # 配置管理
│   └── utils/                 # 工具函数
├── dist/                        # 编译输出
├── docs/                        # 文档
├── sdk/                         # SDK
└── vscode/                     # VSCode扩展

📚 详细文档

完整架构和功能文档请查看 docs/ 目录:

• ARCHITECTURE.md — 详细架构概述
• FINAL_ARCHITECTURE_SUMMARY.md — 完整迁移总结
• CODE_STRUCTURE_ANALYSIS.md — 代码结构分析
• DUAL_AGENT_SYSTEM.md — 双Agent系统文档
• PERFORMANCE_MONITORING.md — 性能监控设置
• PHASE_3_DETAILED_PLAN.md — 第三阶段计划
• PHASE_4_DETAILED_PLAN.md — 第四阶段计划
• EXTENSION_ENHANCEMENT_PLAN.md — 扩展完善计划

🧪 测试

npm run test              # 运行所有测试
npm run test:unit         # 只运行单元测试
npm run test:integration  # 运行集成测试
npm run test:watch        # 监听模式开发
npm run test:coverage     # 测试覆盖率报告
npm run test:ui           # Vitest UI交互式测试

CI/CD与质量保证

项目使用GitHub Actions实现自动化CI/CD流程:

• 构建测试: 支持Node.js 18.x和20.x版本
• 代码质量: ESLint + Prettier自动检查
• 测试覆盖: Vitest + Codecov覆盖率追踪
• 自动发布: main分支推送自动发布到npm
• 文档部署: 自动生成并部署API文档到GitHub Pages

查看完整工作流: .github/workflows/ci-cd.yml

🔧 工具生态

基础工具

工具名	功能描述
readFile	读取文件内容
writeFile	写入文件内容
shell	执行Shell命令
http	HTTP请求
json	JSON处理

高级工具

工具名	功能描述
batchRead	批量读取多个文件
batchWrite	批量写入多个文件
copyMove	复制/移动文件或目录
gitSmartCommit	AI驱动的智能Git提交
gitBranch	Git分支管理
gitHistory	Git历史分析
codeQuality	代码质量分析和坏味道检测
systemMetrics	系统性能指标
operationMetrics	操作性能统计
performanceProfile	性能分析报告
securityAudit	安全审计扫描
generateDocumentation	自动文档生成
generateTests	测试代码生成

浏览器自动化工具

工具名	功能描述
browser.navigate	页面导航
browser.click	元素点击
browser.fill	表单填充
browser.screenshot	页面截图
browser.analyze	页面分析
browser.extractLinks	链接提取

IDE工具

工具名	功能描述
lsp.completion	代码补全
lsp.definition	定义跳转
lsp.references	引用查找
lsp.hover	悬停信息
refactor.extract	提取方法
refactor.rename	重命名

🔒 支持的AI平台

平台	类型	API格式
OpenAI	云服务	OpenAI
Anthropic	云服务	Anthropic
Google Gemini	云服务	Google
DeepSeek	云服务	OpenAI兼容
SiliconFlow	云服务	OpenAI兼容
阿里云百炼	云服务	OpenAI兼容
智谱AI	云服务	OpenAI兼容
百度文心	云服务	自定义
Ollama	本地	Ollama
LM Studio	本地	OpenAI兼容

💻 开发

代码质量

• Prettier — 自动代码格式化
• ESLint — TypeScript代码检查
• Husky — Git Hooks预提交检查
• Lint-Staged — 对暂存文件运行检查

架构理念

• 领域驱动设计(DDD)
• 整洁架构
• 依赖倒置
• 测试优先

从源码构建

# 克隆
git clone https://github.com/badhope/Personal-Assistant.git
cd Personal-Assistant

# 安装
npm install

# 构建
npm run build

# 测试
npm run test

# 开发
npm run dev

性能监控集成

import { PerformanceMonitor } from './monitoring/performance';

// 创建监控实例
const monitor = new PerformanceMonitor({
  refreshInterval: 5000,
  alertThresholds: {
    cpuUsage: 80,
    memoryUsage: 85
  }
});

// 启动监控
monitor.start();

// 获取仪表盘数据
const dashboard = monitor.getDashboardData();
console.log(dashboard.summary);

// 生成报告
const report = monitor.generateReport('markdown');
console.log(report);

使用统计集成

import { UsageTracker, EventType } from './monitoring/usage';

// 创建追踪器
const tracker = new UsageTracker('session-1', 'user-1');

// 追踪事件
tracker.trackCommand('build', true, 5000);
tracker.trackSkill('code-analyzer', true, 30000);
tracker.trackFeature('autocomplete');

// 生成报告
const report = tracker.generateReport();
console.log(report.summary);

📜 许可证

MIT License

🤝 贡献

欢迎贡献！详细信息请查看 CONTRIBUTING.md。

---

Personal-Assistant — 您的智能个人AI助手