claw/insightflow
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Phase 7 Task 3: 数据安全与合规

Browse Source 
- 创建 security_manager.py 安全模块
  - SecurityManager: 安全管理主类
  - 审计日志系统 - 记录所有数据操作
  - 端到端加密 - AES-256-GCM 加密项目数据
  - 数据脱敏 - 支持手机号、邮箱、身份证等敏感信息脱敏
  - 数据访问策略 - 基于用户、角色、IP、时间的访问控制
  - 访问审批流程 - 敏感数据访问需要审批

- 更新 schema.sql 添加安全相关数据库表
  - audit_logs: 审计日志表
  - encryption_configs: 加密配置表
  - masking_rules: 脱敏规则表
  - data_access_policies: 数据访问策略表
  - access_requests: 访问请求表

- 更新 main.py 添加安全相关 API 端点
  - GET /api/v1/audit-logs - 查询审计日志
  - GET /api/v1/audit-logs/stats - 审计统计
  - POST /api/v1/projects/{id}/encryption/enable - 启用加密
  - POST /api/v1/projects/{id}/encryption/disable - 禁用加密
  - POST /api/v1/projects/{id}/encryption/verify - 验证密码
  - GET /api/v1/projects/{id}/encryption - 获取加密配置
  - POST /api/v1/projects/{id}/masking-rules - 创建脱敏规则
  - GET /api/v1/projects/{id}/masking-rules - 获取脱敏规则
  - PUT /api/v1/masking-rules/{id} - 更新脱敏规则
  - DELETE /api/v1/masking-rules/{id} - 删除脱敏规则
  - POST /api/v1/projects/{id}/masking/apply - 应用脱敏
  - POST /api/v1/projects/{id}/access-policies - 创建访问策略
  - GET /api/v1/projects/{id}/access-policies - 获取访问策略
  - POST /api/v1/access-policies/{id}/check - 检查访问权限
  - POST /api/v1/access-requests - 创建访问请求
  - POST /api/v1/access-requests/{id}/approve - 批准访问
  - POST /api/v1/access-requests/{id}/reject - 拒绝访问

- 更新 requirements.txt 添加 cryptography 依赖

- 更新 STATUS.md 和 README.md 记录完成状态
This commit is contained in:
OpenClaw Bot
2026-02-23 18:11:11 +08:00
parent 847e183b85
commit 95a558acc9
19 changed files with 4407 additions and 1646 deletions
Download Patch File Download Diff File Expand all files Collapse all files

266
docs/PHASE7_TASK7_SUMMARY.md
View File

@@ -1,207 +1,143 @@
# InsightFlow Phase 7 Task 7 开发总结
# Phase 7 任务 7 开发完成总结
## 开发内容
## 已完成的工作
### 1. 插件管理模块 (plugin_manager.py)
### 1. 创建 plugin_manager.py 模块
创建了完整的插件与集成系统，包含以下核心组件：
实现了完整的插件与集成系统，包含以下核心类：
#### PluginManager - 插件管理主类
- 插件 CRUD 操作
- API Key 生成和管理
- 插件活动日志记录
- 支持多种插件类型：Chrome 扩展、机器人、Webhook、WebDAV
#### PluginManager
- 插件的 CRUD 操作
- 插件配置的加密存储
- 插件使用统计
#### ChromeExtensionHandler - Chrome 插件处理器
- 验证 Chrome 插件请求
- 提取网页内容（使用 BeautifulSoup）
- 创建网页剪藏
#### ChromeExtensionHandler
- Chrome 扩展令牌管理（创建、验证、撤销）
- 网页内容导入（自动提取正文、保存为文档）
- 权限控制（read/write/delete）
#### BotHandler - 机器人处理器
- 支持飞书、钉钉、Slack 消息解析
- 发送消息到各平台
- 会话管理
#### BotHandler
- 飞书/钉钉机器人会话管理
- 消息接收和发送
- 音频文件处理（支持群内直接分析）
- Webhook 签名验证
#### WebhookIntegration - Webhook 集成处理器
- Zapier/Make 集成
- 签名验证
- 数据处理和转发
#### WebhookIntegration
- Zapier/Make Webhook 端点管理
- 事件触发机制
- 多种认证方式（API Key、Bearer、OAuth）
- 支持 5000+ 应用连接
#### WebDAVSync - WebDAV 同步处理器
#### WebDAVSyncManager
- WebDAV 同步配置管理
- 连接测试
- 文件列表获取
- 文件上传/下载
- 项目数据导出和同步
- 支持坚果云等 WebDAV 网盘
### 2. Chrome 扩展代码
### 2. 更新 schema.sql
创建了完整的 Chrome 扩展，包含：
添加了以下数据库表：
- `plugins`: 插件配置表
- `plugin_configs`: 插件详细配置表
- `bot_sessions`: 机器人会话表
- `webhook_endpoints`: Webhook 端点表
- `webdav_syncs`: WebDAV 同步配置表
- `chrome_extension_tokens`: Chrome 扩展令牌表
#### manifest.json
- Manifest V3 配置
- 权限声明
- 图标配置
### 3. 更新 main.py
#### background.js
- 右键菜单创建
- 页面剪藏逻辑
- 消息处理
#### content.js
- 选中文本检测
- 浮动按钮显示
- 弹窗交互
#### content.css
- 浮动按钮样式
- 弹窗样式
- 项目列表样式
#### popup.html/js
- 扩展弹出窗口
- 项目选择
- 快速保存
#### options.html/js
- 设置页面
- API Key 配置
- 连接测试
### 3. 数据库更新 (schema.sql)
新增以下表：
- **plugins**: 插件配置表
- **bot_sessions**: 机器人会话表
- **webhook_endpoints**: Webhook 端点表
- **webdav_syncs**: WebDAV 同步配置表
- **plugin_activity_logs**: 插件活动日志表
### 4. API 端点 (main.py)
新增以下 API：
添加了完整的插件相关 API 端点：
#### 插件管理
- `POST /api/v1/plugins` - 创建插件
- `GET /api/v1/plugins` - 列出插件
- `GET /api/v1/plugins/{id}` - 获取插件详情
- `PATCH /api/v1/plugins/{id}` - 更新插件
- `DELETE /api/v1/plugins/{id}` - 删除插件
- `POST /api/v1/plugins/{id}/regenerate-key` - 重新生成 API Key
#### Chrome 扩展
- `POST /api/v1/plugins/chrome/clip` - 保存网页内容
- `POST /api/v1/plugins/chrome/tokens` - 创建令牌
- `GET /api/v1/plugins/chrome/tokens` - 列出自令牌
- `DELETE /api/v1/plugins/chrome/tokens/{id}` - 撤销令牌
- `POST /api/v1/plugins/chrome/import` - 导入网页内容
#### 机器人
- `POST /api/v1/bots/webhook/{platform}` - 接收机器人消息
- `GET /api/v1/bots/sessions` - 列出机器人会话
- `POST /api/v1/plugins/bot/feishu/sessions` - 创建飞书会话
- `POST /api/v1/plugins/bot/dingtalk/sessions` - 创建钉钉会话
- `GET /api/v1/plugins/bot/{type}/sessions` - 列出会话
- `POST /api/v1/plugins/bot/{type}/webhook` - 接收消息
- `POST /api/v1/plugins/bot/{type}/sessions/{id}/send` - 发送消息
#### Webhook 集成
- `POST /api/v1/webhook-endpoints` - 创建 Webhook 端点
- `GET /api/v1/webhook-endpoints` - 列出 Webhook 端点
- `POST /webhook/{type}/{token}` - 接收外部 Webhook
#### 集成
- `POST /api/v1/plugins/integrations/zapier` - 创建 Zapier 端点
- `POST /api/v1/plugins/integrations/make` - 创建 Make 端点
- `GET /api/v1/plugins/integrations/{type}` - 列出端点
- `POST /api/v1/plugins/integrations/{id}/test` - 测试端点
- `POST /api/v1/plugins/integrations/{id}/trigger` - 手动触发
#### WebDAV
- `POST /api/v1/webdav-syncs` - 创建 WebDAV 同步配置
- `GET /api/v1/webdav-syncs` - 列出 WebDAV 同步配置
- `POST /api/v1/webdav-syncs/{id}/test` - 测试连接
- `POST /api/v1/webdav-syncs/{id}/sync` - 触发同步
- `POST /api/v1/plugins/webdav` - 创建同步配置
- `GET /api/v1/plugins/webdav` - 列出配置
- `POST /api/v1/plugins/webdav/{id}/test` - 测试连接
- `POST /api/v1/plugins/webdav/{id}/sync` - 执行同步
- `DELETE /api/v1/plugins/webdav/{id}` - 删除配置
#### 日志
- `GET /api/v1/plugins/{id}/logs` - 获取插件活动日志
### 4. 更新 requirements.txt
### 5. 依赖更新 (requirements.txt)
添加了必要的依赖：
- `webdav4==0.9.8` - WebDAV 客户端
- `urllib3==2.2.0` - URL 处理
新增依赖：
- `beautifulsoup4==4.12.3` - HTML 解析
- `webdavclient3==3.14.6` - WebDAV 客户端
### 5. 创建 Chrome 扩展基础代码
## 使用说明
完整的 Chrome 扩展实现：
- `manifest.json` - 扩展配置（Manifest V3）
- `background.js` - 后台脚本（右键菜单、消息处理、自动同步）
- `content.js` - 内容脚本（页面内容提取、浮动按钮）
- `content.css` - 内容样式
- `popup.html/js` - 弹出窗口（保存页面、查看剪辑历史）
- `options.html/js` - 设置页面（服务器配置、令牌设置）
- `README.md` - 扩展使用说明
### Chrome 扩展安装
## 功能特性
1. 打开 Chrome 扩展管理页面 (chrome://extensions/)
2. 开启"开发者模式"
3. 点击"加载已解压的扩展程序"
4. 选择 `chrome-extension` 文件夹
### Chrome 插件
- ✅ 一键保存整个网页（智能提取正文）
- ✅ 保存选中的文本内容
- ✅ 保存链接
- ✅ 浮动按钮快速访问
- ✅ 右键菜单支持
- ✅ 自动同步到服务器
- ✅ 离线缓存，稍后同步
### Chrome 扩展配置
### 飞书/钉钉机器人
- ✅ 群内直接分析音频文件
- ✅ 命令交互（/help, /status, /analyze）
- ✅ 消息自动回复
- ✅ Webhook 签名验证
1. 点击扩展图标打开设置
2. 输入 InsightFlow 服务器地址
3. 从 InsightFlow 控制台获取 API Key
4. 测试连接
5. 选择默认项目（可选）
### Zapier/Make 集成
- ✅ 创建 Webhook 端点
- ✅ 事件触发机制
- ✅ 支持 5000+ 应用连接
- ✅ 多种认证方式
### 使用 Chrome 扩展
### WebDAV 同步
- ✅ 与坚果云等网盘联动
- ✅ 项目数据自动同步
- ✅ 连接测试
- ✅ 增量同步支持
- **保存当前页面**: 点击扩展图标 → 点击"保存当前页面"
- **保存选中文本**: 选中页面文本 → 点击浮动按钮 → 选择保存方式
- **右键保存**: 右键点击页面 → "保存到 InsightFlow"
## API 文档
### 创建机器人插件
所有 API 都已在 Swagger/OpenAPI 文档中注册，访问：
- Swagger UI: `/docs`
- ReDoc: `/redoc`
```bash
curl -X POST http://localhost:18000/api/v1/plugins \
-H "X-API-Key: your_api_key" \
-H "Content-Type: application/json" \
-d '{
"name": "飞书机器人",
"plugin_type": "feishu_bot",
"project_id": "your_project_id"
}'
```
## 下一步工作
### 创建 Webhook 端点
```bash
curl -X POST http://localhost:18000/api/v1/webhook-endpoints \
-H "X-API-Key: your_api_key" \
-H "Content-Type: application/json" \
-d '{
"plugin_id": "your_plugin_id",
"name": "Zapier Integration",
"endpoint_type": "zapier",
"target_project_id": "your_project_id"
}'
```
### 配置 WebDAV 同步
```bash
curl -X POST http://localhost:18000/api/v1/webdav-syncs \
-H "X-API-Key: your_api_key" \
-H "Content-Type: application/json" \
-d '{
"plugin_id": "your_plugin_id",
"name": "坚果云同步",
"server_url": "https://dav.jianguoyun.com/dav/",
"username": "your_username",
"password": "your_password",
"remote_path": "/InsightFlow",
"sync_direction": "bidirectional"
}'
```
## 开发进度
Phase 7 开发进度更新：
| 任务 | 状态 | 完成时间 |
|------|------|----------|
| 1. 智能工作流自动化 | ✅ 已完成 | 2026-02-23 |
| 2. 多模态支持 | ✅ 已完成 | 2026-02-23 |
| 7. 插件与集成 | ✅ 已完成 | 2026-02-23 |
| 3. 数据安全与合规 | 📋 待开发 | - |
| 4. 协作与共享 | 📋 待开发 | - |
| 5. 智能报告生成 | 📋 待开发 | - |
| 6. 高级搜索与发现 | 📋 待开发 | - |
| 8. 性能优化与扩展 | 📋 待开发 | - |
## 下一步
按照建议的开发顺序，接下来应该开发：
**Phase 7 任务 3: 数据安全与合规**
Phase 7 任务 3: 数据安全与合规
- 端到端加密
- 数据脱敏
- 审计日志
- GDPR/数据合规支持
- GDPR 合规支持