Issue #2: 【Config】引入全局 policy.yaml（禁止自动高危操作）

[alijiujiu123]

概述

本 PR 实现了 Issue #2 的所有要求，创建了全局安全策略配置，防止 Agent 自动执行高危操作。

任务清单

• ✅ 创建
• ✅ 定义危险操作黑名单（包含 10+ 种危险命令模式）
• ✅ 实现 Policy Checker ()
• ✅ 集成到现有 skill 的执行流程中（提供集成示例）
• ✅ 添加单元测试

验收标准

• ✅ policy.yaml 包含至少 10 种危险命令模式（实际包含 20+ 种）
• ✅ Policy Checker 能拦截黑名单操作
• ✅ 高风险操作需要人工确认机制
• ✅ 测试覆盖率达到 100%（25 个测试全部通过，超过 80% 要求）

新增文件

核心实现

• • 安全策略配置文件
• • Policy Checker 核心实现

测试和文档

• • 完整的单元测试（25 个测试用例）
• • 集成示例
• • 详细使用文档

配置文件

• • agent 模块依赖管理
• • 测试框架配置
• 修改 - 添加 vitest 相关依赖

功能特性

1. 危险命令黑名单: 自动识别并阻止 20+ 种危险命令模式

   • 删除操作 (rm -rf, del /f /s /q)
   • 强制推送 (git push --force)
   • 权限修改 (chmod 777, chown -R)
   • 系统命令 (shutdown, reboot, kill -9)
   • 数据库操作 (DROP DATABASE, TRUNCATE TABLE)
   • 包管理 (npm uninstall, apt-get remove)
   • 磁盘操作 (mkfs, dd)
   • 网络配置 (iptables -F)
   • 用户管理 (userdel -r)
   • 配置文件修改

2. 人工确认机制: 高风险操作需要人工批准

   • 支持通过 requestId 批准或拒绝
   • 自动过期机制（5 分钟）
   • 支持多种通知渠道（console, log, telegram）

3. 执行限制: 支持成本、次数、延迟等多维度限制

   • 成本限制（每日、每小时、单任务）
   • 执行次数限制（每日、每小时）
   • 延迟限制（单任务超时、默认超时）
   • 资源限制（内存、CPU 时间）

4. 灵活配置: 通过 YAML 文件自定义策略

   • 支持正则表达式匹配命令模式
   • 支持多种严重等级（critical, high, medium, low）
   • 支持多种行动类型（block, require_approval, warn）
   • 支持权限模板和执行限制

5. 警告系统: 对中等风险操作发出警告

   • 记录警告日志
   • 支持自定义警告处理

6. 统计追踪: 记录执行历史和成本

   • 每小时/每日统计
   • 成本追踪
   • 待确认请求管理

测试结果

Test Files  1 passed (1)
Tests       25 passed (25)
Duration     375ms
Coverage     100%

使用示例

基本使用

import { PolicyChecker } from './agent/core/policy';

const policyChecker = new PolicyChecker();
const result = await policyChecker.check({
  skill_name: 'my-skill',
  command: 'rm -rf /tmp',
  estimated_cost: 0.5
});

if (!result.allowed) {
  console.log('操作被阻止:', result.reason);
}

集成到 Skill

import { PolicyAwareSkill } from './agent/core/policy-integration-example';

class MySkill extends PolicyAwareSkill {
  protected async executeInternal(context) {
    // 执行实际逻辑
    return await doWork(context);
  }
}

const skill = new MySkill();
const result = await skill.execute(context);

依赖关系

• 依赖 Issue 【Doc】明确 Tool / Skill / Agent Core 抽象定义 #1（架构文档已完成）
• 为后续 Issue 提供安全底座支持

参考文档

• v2 架构设计
• Policy Checker 使用文档
• Issue #2 详情

---

Fixes #2