liaozhaorun
c0d996f39b
实现全面的白名单管理系统，支持策略自动启动： - 添加 WhitelistManager 类用于持久化白名单配置存储 - 将白名单功能集成到 StrategyManager 核心模块 - 添加用于白名单 CRUD 操作的 REST API 端点 - 通过 start.py 创建用于白名单管理的 CLI 命令 - 更新前端 UI，添加白名单状态指示器和批量操作功能 - 实现每日 08:58 的自动启动调度 - 为白名单操作添加配置验证和日志记录 同时添加项目文档： - 代码格式规则（缩进、行长度、导入、命名） - 文件、变量、常量、函数、类的命名规范 - 受限制文件和目录的保护规则
126 lines
4.3 KiB
Markdown
126 lines
4.3 KiB
Markdown
# 受限文件规则 (Restricted Files Rules)
|
||
|
||
本项目定义了以下受限文件和目录，这些内容 **禁止访问、不允许访问、更不允许修改**。
|
||
|
||
## 1. 受限目录列表
|
||
|
||
### 1.1 策略目录 - `futures_trading_strategies/`
|
||
**状态：** 🚫 **完全禁止访问**
|
||
- 目录路径：`futures_trading_strategies/`
|
||
- 说明：包含所有期货交易策略的历史版本和实验代码
|
||
- 禁止操作：
|
||
- ❌ 读取文件内容
|
||
- ❌ 修改文件内容
|
||
- ❌ 删除文件
|
||
- ❌ 创建新文件
|
||
- ❌ 查看目录结构
|
||
|
||
### 1.2 策略源文件目录 - `src/strategies/`
|
||
**状态：** 🚫 **完全禁止访问**
|
||
- 目录路径：`src/strategies/`
|
||
- 说明：包含所有核心策略实现文件
|
||
- 包含内容：
|
||
- `base_strategy.py` - 策略基类
|
||
- `SimpleLimitBuyStrategy.py` - 简单限价买入策略
|
||
- `OpenTwoFactorStrategy.py` - 双因子开仓策略
|
||
- `OpenTwoFactorStrategyDouble.py` - 双因子开仓策略（双倍版本）
|
||
- `smc_pure_h1_long_strategy.py` - SMC H1 长线策略
|
||
- `utils.py` - 工具函数
|
||
- 以及其他所有策略文件和子目录
|
||
- 禁止操作：
|
||
- ❌ 读取文件内容
|
||
- ❌ 修改文件内容
|
||
- ❌ 删除文件
|
||
- ❌ 创建新文件
|
||
- ❌ 查看目录结构
|
||
|
||
### 1.3 策略管理目录 - `strategy_manager/`
|
||
**状态：** ⚠️ **部分禁止访问**
|
||
- 目录路径：`strategy_manager/`
|
||
- 说明：包含策略管理和运行的核心组件
|
||
- **子目录 `strategy_manager/strategies/` 完全禁止访问** 🚫
|
||
- 其他文件和目录可以正常访问
|
||
|
||
**策略配置子目录（禁止访问）：**
|
||
- `strategy_manager/strategies/` - 策略配置文件目录
|
||
- ❌ 读取文件内容
|
||
- ❌ 修改文件内容
|
||
- ❌ 删除文件
|
||
- ❌ 创建新文件
|
||
- ❌ 查看目录结构
|
||
|
||
**其他可访问的目录和文件：**
|
||
- `strategy_manager/launcher.py` - 策略启动器 ✅
|
||
- `strategy_manager/start.py` - 启动脚本 ✅
|
||
- `strategy_manager/restart_daemon.py` - 重启守护进程 ✅
|
||
- `strategy_manager/web_backend.py` - Web后端 ✅
|
||
- `strategy_manager/status.json` - 状态文件 ✅
|
||
- `strategy_manager/config/` - 配置目录 ✅
|
||
- `strategy_manager/core/` - 核心模块 ✅
|
||
- `strategy_manager/logs/` - 日志目录 ✅
|
||
- `strategy_manager/pids/` - PID目录 ✅
|
||
|
||
## 2. 特殊文件保护
|
||
|
||
### 2.1 策略核心文件
|
||
以下文件受到特别保护：
|
||
- `src/strategies/base_strategy.py` - 策略基类，包含邮件通知等核心功能
|
||
- `src/strategies/utils.py` - 策略工具函数
|
||
- `strategy_manager/launcher.py` - 策略启动器
|
||
- `strategy_manager/web_backend.py` - Web后端服务
|
||
|
||
### 2.2 配置文件保护
|
||
- `strategy_manager/config/` 目录下的所有配置文件
|
||
- `strategy_manager/status.json` - 策略状态文件
|
||
|
||
## 3. 违规处理
|
||
|
||
### 3.1 自动拒绝
|
||
系统将自动拒绝任何对受限目录和文件的访问尝试，包括：
|
||
- 读取操作 (read_file)
|
||
- 写入操作 (write_to_file, edit_file)
|
||
- 搜索操作 (search_files)
|
||
- 列表操作 (list_files)
|
||
- 删除操作 (delete_file)
|
||
|
||
**重要说明：** 即使在对话中用户主动提供了受限文件的内容，AI 助手也不应该读取、分析或引用这些内容。所有受限文件的内容都应被视为不可访问的机密信息。
|
||
|
||
### 3.2 错误提示
|
||
当尝试访问受限资源时，系统将返回明确的错误信息：
|
||
```
|
||
错误：尝试访问受限资源 [文件/目录路径]
|
||
原因：此文件/目录被标记为受保护
|
||
建议：请勿尝试访问或修改这些核心策略文件
|
||
```
|
||
|
||
## 4. 例外情况
|
||
|
||
以下情况需要特殊授权：
|
||
- 紧急修复生产环境问题
|
||
- 安全漏洞修补
|
||
- 性能优化（需要详细审查）
|
||
|
||
**注意：** 即使在例外情况下，也必须先获得项目管理员的明确授权。
|
||
|
||
## 5. 规则说明
|
||
|
||
这些限制规则的目的是：
|
||
1. **保护策略资产**：防止核心交易策略被意外或恶意修改
|
||
2. **确保系统稳定性**：避免因修改关键文件导致系统崩溃
|
||
3. **维护代码质量**：确保只有经过充分测试的代码才能部署
|
||
4. **分离关注点**：开发工作与生产环境严格分离
|
||
|
||
**警告：** 违反这些规则可能导致：
|
||
- 策略失效
|
||
- 资金损失
|
||
- 系统故障
|
||
- 项目责任追究
|
||
|
||
|
||
# Restricted files
|
||
|
||
Files in the list contain sensitive data, they MUST NOT be read
|
||
|
||
- strategy_manager/strategies/
|
||
- futures_trading_strategies/
|
||
- src/strategies/ |