Comp Assist

本地计算机助理

一个全面的本地计算机助手，用于标准化计算机环境检查、设置、更新和问题解决。从Windows支持开始，计划扩展到Linux用于各种用例（艺术设计、研究、金融等）。

特性

• 环境检查：分析系统配置、安装的软件、资源
• 设置自动化：标准化和自动化软件安装和配置
• 更新管理：检查并应用系统和软件更新
• 问题解决：检测问题并提供自动修复
• 代理间通信：用于AI代理集成的REST API和MCP（JSON-RPC 2.0）端点

快速开始

先决条件

• Python 3.8或更高版本
• Docker桌面（可选，用于容器化部署）

安装

# Install dependencies
pip install -r requirements.txt

# Install API dependencies (for agent communication)
pip install -r requirements-api.txt

用法

# Set PYTHONPATH (adjust path to your project location)
$env:PYTHONPATH="
"
# Example: $env:PYTHONPATH="C:\projects\local-computer-assistant"

# Run commands
py src/main.py check          # Check environment
py src/main.py setup          # Setup system
py src/main.py diagnose       # Diagnose issues
py src/main.py fix            # Fix issues

# Start API server (for agent communication)
py src/api/server.py

Docker部署

# Build image
docker build -t local-computer-assistant .

# Run container
docker run -it --rm --privileged local-computer-assistant check

# Or use docker-compose
docker-compose up

API终点

服务器运行后(py src/api/server.py):

• Swagger用户界面: http://localhost:8000/docs
• 开发信息: http://localhost:8000/api/v1/dev-信息
• MCP端点: http://localhost:8000/mcp

示例：获取开发信息

REST API：

curl http://localhost:8000/api/v1/dev-info

MCP（JSON-RPC 2.0）：

curl -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "mcp.get_dev_info",
    "params": {},
    "id": 1
  }'

项目结构

local-computer-assistant/
├── src/                    # Source code
│   ├── api/               # API server (REST + MCP)
│   ├── checker/           # Environment checking
│   ├── core/              # Core utilities
│   ├── setup/             # Setup automation
│   ├── update/            # Update management
│   ├── troubleshooting/   # Problem detection & fixes
│   └── main.py            # CLI entry point
├── config/                # Configuration files
├── docs/                  # Documentation (organized by topic)
│   ├── getting-started/  # Installation & quick start
│   ├── api/               # API documentation
│   ├── architecture/      # Architecture & design
│   └── guides/            # User guides
├── scripts/               # Platform-specific scripts
├── data/                  # Data storage (git-ignored)
├── logs/                  # Log files (git-ignored)
├── requirements.txt       # Python dependencies
├── requirements-api.txt   # API dependencies
├── Dockerfile             # Docker container definition
└── docker-compose.yml     # Docker Compose config

文档

📖 CompAssist新手？ 从以下内容开始：

• 项目\_ SUMMARY.md -项目综合概述
• INDEX.md -完整的项目索引和导航指南
• docs/开始/安装.md -安装指南

看 docs/ 按主题组织的详细文档目录：

入门指南

• docs/getting-started/installation.md -安装指南
• docs/getting-started/quickstart.md -快速入门指南
• docs/getting-started/docker-setup.md -Docker设置

API文档

• docs/api/overview.md -API概述和设置
• docs/api/rest-api.md -REST API端点
• docs/api/mcp-protocol.md -MCP（JSON-RPC 2.0）协议
• docs/api/dev-info-endpoint.md -开发信息端点

建筑

• docs/architecture/design.md -系统架构
• docs/architecture/agent-communication.md -Agent通信设计
• docs/architecture/docker-feasibility.md -Docker部署分析

指南

• docs/guides/docker-installation.md -Docker安装
• docs/guides/lightshot-installation.md -Lightshot安装

看 docs/README.md 获取完整的文档索引。

平台支持

• ✅ 视窗：全力支持
• 🔄 Linux：基本支持（扩展）
• 🔄 macOS：计划中

许可证

麻省理工学院