安全配置指南

快速开始

1. 启动管理面板: npm run dev
2. 访问 http://localhost:3000
3. 在"用户管理"添加你的 Telegram 用户 ID

用户认证

配对流程

当陌生人发消息时:

1. Bot 生成 HMAC-SHA256 签名的配对码（格式: Base64(userId:timestamp:signature)）
2. 用户在管理面板审批（配对码 1 小时内有效）
3. 审批后自动加入白名单

手动添加用户

1. 获取用户的 Telegram ID
2. 在管理面板 → 用户管理 → 添加用户
3. 输入 ID 并保存

工具权限

工具	默认权限	说明
WebSearch	✅ safe	网络搜索
WebFetch	✅ safe	获取网页
Read	✅ safe	读取文件
Write	⚠️ confirm	写入文件
Edit	⚠️ confirm	编辑文件
Bash	⚠️ confirm	执行命令
Bash:sudo	❌ deny	sudo 命令
Bash:rm -rf	❌ deny	危险删除

路径保护

以下路径被保护，AI 无法访问:

~/.ssh          # SSH 密钥
~/.env*         # 环境变量
~/.aws          # AWS 凭证
~/.config       # 应用配置

审计日志

所有操作都会被记录:

• 用户访问尝试
• 工具使用记录
• 权限拒绝事件
• 配对请求

查看日志: 管理面板 → 审计日志

最佳实践

1. 最小权限原则 - 只开放必要的工具
2. 定期审查 - 检查审计日志和用户列表
3. 及时更新 - 保持依赖更新
4. 备份配置 - 定期备份 config/ 和 data/