77 lines
2.0 KiB
Markdown
77 lines
2.0 KiB
Markdown
# AGENTS.md
|
|
|
|
## Overview
|
|
|
|
This document describes the autonomous agents, subagents, and their roles within the scientific-surfing project.
|
|
|
|
---
|
|
|
|
## Agent List
|
|
|
|
### 1. SubscriptionManager Agent
|
|
- **Purpose:** Handles all subscription-related operations, including adding, refreshing, deleting, renaming, and activating subscriptions.
|
|
- **Key Methods:**
|
|
- `add_subscription`
|
|
- `refresh_subscription`
|
|
- `delete_subscription`
|
|
- `rename_subscription`
|
|
- `set_subscription_url`
|
|
- `activate_subscription`
|
|
- `list_subscriptions`
|
|
- **Notes:** Supports backup option on refresh.
|
|
|
|
### 2. StorageManager Agent
|
|
- **Purpose:** Manages persistent storage for configuration and subscription data.
|
|
- **Key Methods:**
|
|
- `load_subscriptions`
|
|
- `save_subscriptions`
|
|
- `load_config`
|
|
- `get_storage_info`
|
|
|
|
### 3. CoreConfigManager Agent
|
|
- **Purpose:** Handles core configuration management, including import/export, editing, resetting, and applying configuration.
|
|
- **Key Methods:**
|
|
- `import_config`
|
|
- `export_config`
|
|
- `edit_config`
|
|
- `reset_config`
|
|
- `show_config`
|
|
- `apply`
|
|
|
|
### 4. CoreManager Agent
|
|
- **Purpose:** Manages core components and system service operations (install, uninstall, start, stop, restart, reload, status, update).
|
|
- **Key Methods:**
|
|
- `install_service`
|
|
- `uninstall_service`
|
|
- `start_service`
|
|
- `stop_service`
|
|
- `restart_service`
|
|
- `reload_service`
|
|
- `get_service_status`
|
|
- `update`
|
|
|
|
### 5. HookManager Agent
|
|
- **Purpose:** Manages hook scripts for automation and customization.
|
|
- **Key Methods:**
|
|
- `init`
|
|
- `list_hooks`
|
|
- `edit`
|
|
- `rm`
|
|
|
|
---
|
|
|
|
## Agent Interactions
|
|
- The CLI acts as the orchestrator, parsing user commands and delegating tasks to the appropriate agent.
|
|
- Agents interact via method calls and shared data models.
|
|
|
|
---
|
|
|
|
## Extending Agents
|
|
- To add a new agent, implement a new manager class and update the CLI to route commands.
|
|
- Document new agents and their responsibilities in this file.
|
|
|
|
---
|
|
|
|
## Last updated
|
|
May 26, 2026
|