Agent OS for VS Code 实战指南为 AI 编码助手构建内核级策略防护与治理可视化【免费下载链接】agent-governance-toolkitAI Agent Governance Toolkit — Policy enforcement, zero-trust identity, execution sandboxing, and reliability engineering for autonomous AI agents. Covers 10/10 OWASP Agentic Top 10.项目地址: https://gitcode.com/GitHub_Trending/ag/agent-governance-toolkit本指南对应仓库文档 docs/packages/agent-os-vscode.md代码实现位于 agent-governance-typescript/agent-os-vscode/。AI 编码助手GitHub Copilot、Cursor、Claude 等生成代码时并不自带安全保证可能建议DROP TABLE users、硬编码 API Key、rm -rf /这类破坏性操作或产出带 SQL 注入漏洞的代码。Agent OS for VS Code 以内核级方式包裹 AI 助手在代码被采纳之前实时拦截并校验每一次粘贴、输入与补全。阅读本文后你将掌握 Agent OS 的实时策略引擎、CMVK 多模型审查、团队策略共享、治理可视化 HubSLO 看板 / Agent 拓扑 / 审计流、本地治理服务器的纵深安全模型以及完整的命令与配置参考并理解每项能力在仓库源码中的落点。问题的本质提示词级安全 vs 执行级安全传统做法依赖提示词约束 AI 助手本质上是一份建议书——模型可能遵守也可能忽略。Agent OS 换了一个思路在执行时间点拦截。扩展通过vscode.workspace.onDidChangeTextDocument注册文档变更监听见 extension.ts当粘贴或输入的内容超过 10 个字符即触发PolicyEngine.analyzeCode()分析命中关键/高危规则则直接阻断并给出 [Review Policy] / [Allow Once] / [Suggest Alternative] 三个处置动作。这也正是 walkthrough 中强调的与基于提示的安全不同违规在执行时被拦截见 package.json 的walkthroughs定义。⚠️ Agent OS WarningBlocked: Destructive SQL operation detectedThe AI suggested: DELETE FROM users WHERE ... This violates your safety policy.[Review Policy] [Allow Once] [Suggest Alternative]实时策略引擎本地优先的规则执行策略引擎全部在扩展进程内运行不发起任何网络调用policyEngine.ts 文件头注释明确 Runs entirely in the extension without network calls。规则按严重级别分类critical/high命中即阻断medium/low仅产生警告。内置策略默认开启/关闭状态Policy默认描述Destructive SQL✅ 开拦截 DROP、DELETE、TRUNCATEFile Deletes✅ 开拦截 rm -rf、unlink、rmtreeSecret Exposure✅ 开拦截硬编码 API Key、密码Privilege Escalation✅ 开拦截 sudo、chmod 777Unsafe Network❌ 关拦截 HTTP非 HTTPS调用源码级规则细节从 policyEngine.ts 可以看到每个策略类别下有多条具体正则规则且带语言过滤Destructive SQLDROP (TABLE|DATABASE|SCHEMA|INDEX)、DELETE ... WHERE 11、TRUNCATE TABLE覆盖 sql、javascript、typescript、python、php、ruby、java、csharp 等语言File Deletesshell 侧rm -rf/-fr、删除根目录或主目录rm ... /Node 侧fs.unlinkSync/rmdirSync、Python 侧shutil.rmtree、os.remove/unlink/rmdirSecret Exposureapi_key/apikey/api_secret赋值、password/passwd赋值、AWS Access KeyAKIA[0-9A-Z]{16}、私钥块-----BEGIN RSA/EC/OPENSSH PRIVATE KEY-----、GitHub Tokengh[pousr]_...、JWTeyJ...Privilege Escalationsudo、chmod 777、chown root、os.seteuid(0)Unsafe Network默认关闭http://localhost/127.0.0.1 除外、eval(fetch())远程代码执行。此外存在不可关闭的常开安全规则format c:、fork bomb:(){ :|: };、dd if... of/dev/sdX直接磁盘写入。Allow Once带指纹的一次性放行allowOnce(violation)并非简单记录规则名而是基于规则名 语言 代码内容计算FNV-1a 哈希指纹computeAllowOnceFingerprint。只有当后续分析再次命中同一指纹时放行才会被消费consumeAllowOnce。这意味着允许一次是精确到具体代码片段的同规则的其他变体依然会被拦截避免一次性放行演变成永久豁免。拦截后的交互流程见 handleBlockedCode写入审计日志、更新状态栏计数、弹出通知若选择 Use Alternative 则直接用规则自带的suggestion安全替代文本替换被阻断的代码段。团队策略共享.vscode/agent-os.json策略可通过工作区文件共享给整个团队实现组织内一致的安全基线。将以下内容提交到仓库{ policies: { blockDestructiveSQL: true, blockFileDeletes: true, blockSecretExposure: true }, customRules: [ { name: no_console_log, pattern: console\\.log, message: Remove console.log before committing, severity: low } ] }自定义规则的加载实现在 loadCustomRules从vscode.Uri.joinPath(workspaceFolder.uri, .vscode, agent-os.json)读取。值得注意的安全细节自定义正则首先经过safeRegExp校验凡是包含 ReDoS 危险结构如、*、{n,}、(.*){2}或无法编译的模式都会被拒绝并跳过policyEngine.ts防止恶意/低质量规则拖垮编辑器。customRules 支持pattern、flags、message、severity、suggestion、languages字段。CMVK 多模型代码审查共识式验证右键选中代码 →Agent OS: Review Code with CMVK扩展会将代码交给多个模型审查并汇总共识️ Agent OS Code Review Consensus: 66% Agreement ✅ GPT-4: No issues ✅ Claude: No issues ⚠️ Gemini: Potential SQL injection (Line 42) Recommendations: 1. Use parameterized queries to prevent SQL injection共识阈值与模型配置CMVK 客户端实现在 cmvkClient.ts请求POST /verify携带code、language、models以及共识阈值consensusThreshold默认 0.8合法区间 0.51.0。最终结果的consensus由通过模型数 / 模型总数计算Webview 展示时按阈值着色≥0.8 绿色、≥0.5 黄色、否则红色见 extension.ts。离线与降级路径未配置自定义agentOS.cmvk.apiEndpoint时客户端自动进入mock 模式shouldUseMock由内置静态分析生成模拟的多模型分歧结果便于本地开发与演示网络错误ECONNREFUSED/ENOTFOUND同样回退到 mock401 提示配置 API Key429 提示免费额度限制每日 10 次审查返回结果经过isValidCMVKResult模式校验不符合 schema 时直接中止渲染防止异常数据进入 Webviewextension.ts。reviewCode命令的完整交互启用确认、进度通知、结果面板、审计写入见 reviewCodeWithCMVK。审计日志侧栏每一次决策都有据可查点击活动栏盾牌图标打开审计视图可查看今日/本周被阻断的操作数、警告历史、CMVK 审查结果并支持导出用于合规。审计实现 auditLogger.ts 的关键行为条目类型blocked/warning/allowed/cmvk_review包含时间戳、文件、语言、截断到 200 字符的代码片段、违规名与原因内存上限1000 条超出后截断最旧记录通过context.globalState持久化retentionDays默认 7 天内旧日志在构造时自动清理cleanOldLogs提供getToday()/getThisWeek()/getStats()驱动侧栏的今日阻断 / 本周阻断 / 今日警告 / 今日 CMVK 审查统计支持 JSON 导出Export Audit Log与 CSV 导出agent-os.exportAuditCSV见 extension.ts。治理可视化 HubSLO、拓扑、审计一屏统览v1.1.0 引入统一治理仪表盘包含以下核心组件实现位于 src/webviews/sidebar/ 与 src/views/SLO Dashboard可用性、延迟 P50/P95/P99、策略合规率、信任分数含错误预算error budget与燃烧率burn rateAgent Topology基于力导向图force-directed graph呈现 agent mesh、信任环trust rings、桥接状态与委托链执行环通过 Ring 0Root到 Ring 3Sandbox四层标签展示见 extension.tsAudit Stream可过滤事件日志支持下钻详情3-Slot 侧栏8 种可用视图AuditSummary、PolicySummary、SLOSummary、TopologySummary、StatsSummary、KernelSummary、MemorySummary、GovernanceHubSummary通过面板选择器PanelPicker自由分配到 3 个槽位Scanning Mode以 4 秒节奏自动轮换槽位视觉焦点悬停/聚焦时暂停并尊重prefers-reduced-motionPriority EngineAuto 模式下按健康度紧急程度自动重排槽位critical warning healthyAttention Toggle侧栏头部 Manual/Auto 切换Manual 锁定用户配置Browser Experience通过本地服务器在外部浏览器打开同一仪表盘Open SLO Dashboard in Browser、Open Topology Graph in Browser、Open Governance Hub in Browser。治理服务器浏览器仪表盘的纵深安全模型浏览器体验由GovernanceServer支撑GovernanceServer.ts默认从端口9845起尝试绑定占用则顺延最多 10 个端口serverHelpers.ts。其防御纵深逐条对应源码安全控制实现依据Session token 认证每次会话用crypto.randomBytes(16)生成 128 位令牌generateSessionTokenWebSocket 升级时校验Sec-WebSocket-Protocol子协议头无效令牌以close code 4001拒绝GovernanceServer.ts常量时间比较令牌校验使用crypto.timingSafeEqual且遍历所有候选协议避免时序侧信道泄露匹配前缀validateWebSocketToken速率限制每客户端 IP 每分钟 100 次 HTTP 请求超限返回 429 Retry-After: 60并惰性驱逐过期记录防止 Map 无限增长checkRateLimit本地资源打包D3.js 与 Chart.js 本地化无 CDN 依赖消除外部脚本加载的供应链风险CSP 策略script-src仅允许nonce-...不开放 CDN、不启用unsafe-evalconnect-src显式限定ws://127.0.0.1:*GovernanceServer.tsHTML 转义共享escapeHtml工具应用于旧版面板 innerHTML 赋值中的动态数据Agent DID、策略名、审计数据防 XSS仅回环绑定服务器硬绑定127.0.0.1DEFAULT_HOST远程连接在结构上不可能Python 路径校验子进程 spawn 前拒绝 shell 元字符防命令注入依赖固定版本生产依赖 axios、ws 固定精确版本保证可复现构建令牌通过 WebSocket 子协议头而非 URL 查询串传输避免令牌泄漏进代理日志、浏览器历史与调试工具serverHelpers.ts。完整安全模型与威胁分析见 SECURITY.md。实时治理数据自动接入 agent-failsafe扩展首次激活时自动检测 Python 环境中的agent-failsafe缺失则提示安装pip install agent-failsafe[server]安装后本地 REST 服务器在127.0.0.1:9377自动启动SLO 看板、Agent 拓扑与审计流随即填充真实的策略合规、集群健康与审计事件——整个过程无需手动配置。数据接入逻辑见 providerFactory.ts优先使用agentOS.governance.endpoint显式覆盖否则检测/安装 agent-failsafe均不可用则返回 disconnected 空状态提供者。轮询客户端LiveSREClientliveClient.ts值得关注端点强校验必须为回环地址127.0.0.1/localhost/::1否则构造即抛错isLoopbackEndpoint轮询间隔钳制到最小值5000ms默认 10000ms响应校验类型检查、5MB 大小上限、字符串截断智能升级连续 5 次平均延迟超过阈值默认 2000ms时从单一/sre/snapshot轮询自动升级为/sre/snapshot/sre/fleet/sre/events并发拉取escalation连续 10 次低延迟后回落错误信息经过脱敏_sanitizeError绝不暴露 URL 或请求头。状态栏同步显示连接状态Live绿、Stale黄、Disconnected红。报告导出与可观测性Export Governance Report将治理快照SLO、Agent、桥、委托、近 24 小时审计事件生成为自包含 HTML 报告并保存/上传导出前先做存储凭据零信任校验见 extension.tsMetrics Exporter将看板数据按配置的agentOS.observability.endpointOpenTelemetry 兼容周期推送。命令参考命令描述Agent OS: Getting Started交互式引导教程walkthroughAgent OS: Open Policy Editor可视化策略管理工作室Agent OS: Open Workflow Designer拖拽式工作流构建器Agent OS: Show Metrics Dashboard实时监控看板Agent OS: Review Code with CMVK多模型代码审查Agent OS: Toggle Safety Mode启用/禁用保护Agent OS: Configure Policies打开策略配置Agent OS: Export Audit Log导出 JSON 审计日志Agent OS: Setup CI/CD Integration生成 CI/CD 配置GitHub Actions、GitLab CI、Jenkins、Azure PipelinesAgent OS: Install Git Hooks安装 pre-commit 钩子Agent OS: Check Compliance运行合规校验SOC 2、GDPR、HIPAA、PCI DSS 模板Agent OS: Sign In (Enterprise)企业 SSO 认证Agent OS: SLO Dashboard (Visual)富 webview SLO 看板Agent OS: Agent Topology Graph力导向 Agent 拓扑图Agent OS: Refresh SLO Data刷新 SLO 指标Agent OS: Refresh Agent Topology刷新拓扑数据Agent OS: Open Governance Hub统一治理仪表盘Agent OS: Open SLO Dashboard in Browser浏览器打开 SLO 看板Agent OS: Open Topology Graph in Browser浏览器打开拓扑图Agent OS: Open Governance Hub in Browser浏览器打开治理 HubAgent OS: Export Governance Report导出 HTML 治理报告Agent OS: Create First Agent生成受治理 Agent 脚手架Python 模板Agent OS: Run Safety Test创建演示阻断效果的测试文件Agent OS: Open Kernel Debugger打开内核调试器Agent OS: Open Memory Browser打开内存浏览器Agent OS: Open Safety Stats打开安全统计详情Agent OS: Allow This Once一次性放行指定违规全部命令在 package.json 的contributes.commands中注册部分带图标并出现在编辑器右键菜单editorHasSelection时显示 Review Code与活动栏。配置参考打开设置Ctrl,搜索 Agent OS 即可配置。以下表格综合了文档与 package.json 的contributes.configuration值域、默认值与最小约束均以声明为准设置默认描述agentOS.enabledtrue启用/禁用 Agent OS 安全检查agentOS.modebasic安全模式basic仅本地/enhancedCMVK/enterprise自定义agentOS.policies.blockDestructiveSQLtrue拦截 DROP、DELETE、TRUNCATE SQL 操作agentOS.policies.blockFileDeletestrue拦截 rm -rf 与文件删除操作agentOS.policies.blockSecretExposuretrue拦截硬编码 API Key、密码、密钥agentOS.policies.blockPrivilegeEscalationtrue拦截 sudo、chmod 777 等提权操作agentOS.policies.blockUnsafeNetworkCallsfalse拦截对未知域名的网络调用agentOS.cmvk.enabledfalse启用 CMVK 多模型验证agentOS.cmvk.models[gpt-4, claude-sonnet-4, gemini-pro]CMVK 使用的模型列表agentOS.cmvk.consensusThreshold0.8所需最小共识比例0.51.0agentOS.cmvk.apiEndpointhttps://api.agent-os.dev/cmvkCMVK API 端点agentOS.audit.retentionDays7审计日志本地保留天数agentOS.audit.logToFilefalse同时将审计事件写入文件agentOS.notifications.showBlockedtrue代码被拦截时弹通知agentOS.notifications.showWarningstrue产生警告时弹通知agentOS.diagnostics.enabledtrue启用实时诊断agentOS.diagnostics.severitywarning诊断最低级别error/warning/informationagentOS.enterprise.sso.enabledfalse启用企业 SSOagentOS.enterprise.sso.provider无SSO 提供方azure/okta/google/githubagentOS.enterprise.compliance.framework无默认合规框架soc2/gdpr/hipaa/pci-dssagentOS.export.localPath导出报告本地目录默认工作区agentOS.observability.endpoint指标推送端点OpenTelemetry 兼容agentOS.observability.pushIntervalMs60000指标推送间隔最小 10000msagentOS.governance.pythonPathpython安装了 agent-failsafe[server] 的 Python 解释器agentOS.governance.endpoint覆盖连接已有 agent-failsafe 服务器留空自动启动agentOS.governance.refreshIntervalMs10000治理数据轮询间隔最小 5000ms配置变更通过onDidChangeConfiguration监听触发policyEngine.loadPolicies()热重载规则并刷新视图extension.ts因此修改策略无需重启编辑器。隐私与安全承诺本地优先策略检查完全在扩展内执行无网络basic 模式从不将代码发送到任何地方CMVK 可选是否使用云端验证完全由你决定回环服务器浏览器看板服务器仅绑定127.0.0.1并要求会话令牌认证无遥测除非显式配置 observability 端点治理服务器不向外部发送数据开源可审计全部源码可在仓库中自行检视agent-governance-typescript/agent-os-vscode/。环境要求VS Code 1.85.0 或更高版本engines.vscode声明见 package.jsonNode.js 18开发构建需要Python 3.10Agent OS SDK / agent-failsafe 数据源需要。快速开始从 VS Code Marketplace 安装扩展命令面板运行Agent OS: Getting Started正常编码——Agent OS 自动保护你的每一次 AI 生成内容。随后可运行Agent OS: Run Safety Test生成一个演示文件直观看到 SQL 注入、硬编码密钥、rm -rf三类危险代码被诊断高亮与阻断而参数化查询等安全代码正常放行。源码中的测试套件src/test/覆盖了策略引擎、治理服务器、实时客户端、侧栏优先级引擎与扫描控制器等核心模块可作为理解各组件行为的补充参考。【免费下载链接】agent-governance-toolkitAI Agent Governance Toolkit — Policy enforcement, zero-trust identity, execution sandboxing, and reliability engineering for autonomous AI agents. Covers 10/10 OWASP Agentic Top 10.项目地址: https://gitcode.com/GitHub_Trending/ag/agent-governance-toolkit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Agent OS for VS Code 实战指南：为 AI 编码助手构建内核级策略防护与治理可视化
Agent OS for VS Code 实战指南为 AI 编码助手构建内核级策略防护与治理可视化【免费下载链接】agent-governance-toolkitAI Agent Governance Toolkit — Policy enforcement, zero-trust identity, execution sandboxing, and reliability engineering for autonomous AI agents. Covers 10/10 OWASP Agentic Top 10.项目地址: https://gitcode.com/GitHub_Trending/ag/agent-governance-toolkit本指南对应仓库文档 docs/packages/agent-os-vscode.md代码实现位于 agent-governance-typescript/agent-os-vscode/。AI 编码助手GitHub Copilot、Cursor、Claude 等生成代码时并不自带安全保证可能建议DROP TABLE users、硬编码 API Key、rm -rf /这类破坏性操作或产出带 SQL 注入漏洞的代码。Agent OS for VS Code 以内核级方式包裹 AI 助手在代码被采纳之前实时拦截并校验每一次粘贴、输入与补全。阅读本文后你将掌握 Agent OS 的实时策略引擎、CMVK 多模型审查、团队策略共享、治理可视化 HubSLO 看板 / Agent 拓扑 / 审计流、本地治理服务器的纵深安全模型以及完整的命令与配置参考并理解每项能力在仓库源码中的落点。问题的本质提示词级安全 vs 执行级安全传统做法依赖提示词约束 AI 助手本质上是一份建议书——模型可能遵守也可能忽略。Agent OS 换了一个思路在执行时间点拦截。扩展通过vscode.workspace.onDidChangeTextDocument注册文档变更监听见 extension.ts当粘贴或输入的内容超过 10 个字符即触发PolicyEngine.analyzeCode()分析命中关键/高危规则则直接阻断并给出 [Review Policy] / [Allow Once] / [Suggest Alternative] 三个处置动作。这也正是 walkthrough 中强调的与基于提示的安全不同违规在执行时被拦截见 package.json 的walkthroughs定义。⚠️ Agent OS WarningBlocked: Destructive SQL operation detectedThe AI suggested: DELETE FROM users WHERE ... This violates your safety policy.[Review Policy] [Allow Once] [Suggest Alternative]实时策略引擎本地优先的规则执行策略引擎全部在扩展进程内运行不发起任何网络调用policyEngine.ts 文件头注释明确 Runs entirely in the extension without network calls。规则按严重级别分类critical/high命中即阻断medium/low仅产生警告。内置策略默认开启/关闭状态Policy默认描述Destructive SQL✅ 开拦截 DROP、DELETE、TRUNCATEFile Deletes✅ 开拦截 rm -rf、unlink、rmtreeSecret Exposure✅ 开拦截硬编码 API Key、密码Privilege Escalation✅ 开拦截 sudo、chmod 777Unsafe Network❌ 关拦截 HTTP非 HTTPS调用源码级规则细节从 policyEngine.ts 可以看到每个策略类别下有多条具体正则规则且带语言过滤Destructive SQLDROP (TABLE|DATABASE|SCHEMA|INDEX)、DELETE ... WHERE 11、TRUNCATE TABLE覆盖 sql、javascript、typescript、python、php、ruby、java、csharp 等语言File Deletesshell 侧rm -rf/-fr、删除根目录或主目录rm ... /Node 侧fs.unlinkSync/rmdirSync、Python 侧shutil.rmtree、os.remove/unlink/rmdirSecret Exposureapi_key/apikey/api_secret赋值、password/passwd赋值、AWS Access KeyAKIA[0-9A-Z]{16}、私钥块-----BEGIN RSA/EC/OPENSSH PRIVATE KEY-----、GitHub Tokengh[pousr]_...、JWTeyJ...Privilege Escalationsudo、chmod 777、chown root、os.seteuid(0)Unsafe Network默认关闭http://localhost/127.0.0.1 除外、eval(fetch())远程代码执行。此外存在不可关闭的常开安全规则format c:、fork bomb:(){ :|: };、dd if... of/dev/sdX直接磁盘写入。Allow Once带指纹的一次性放行allowOnce(violation)并非简单记录规则名而是基于规则名 语言 代码内容计算FNV-1a 哈希指纹computeAllowOnceFingerprint。只有当后续分析再次命中同一指纹时放行才会被消费consumeAllowOnce。这意味着允许一次是精确到具体代码片段的同规则的其他变体依然会被拦截避免一次性放行演变成永久豁免。拦截后的交互流程见 handleBlockedCode写入审计日志、更新状态栏计数、弹出通知若选择 Use Alternative 则直接用规则自带的suggestion安全替代文本替换被阻断的代码段。团队策略共享.vscode/agent-os.json策略可通过工作区文件共享给整个团队实现组织内一致的安全基线。将以下内容提交到仓库{ policies: { blockDestructiveSQL: true, blockFileDeletes: true, blockSecretExposure: true }, customRules: [ { name: no_console_log, pattern: console\\.log, message: Remove console.log before committing, severity: low } ] }自定义规则的加载实现在 loadCustomRules从vscode.Uri.joinPath(workspaceFolder.uri, .vscode, agent-os.json)读取。值得注意的安全细节自定义正则首先经过safeRegExp校验凡是包含 ReDoS 危险结构如、*、{n,}、(.*){2}或无法编译的模式都会被拒绝并跳过policyEngine.ts防止恶意/低质量规则拖垮编辑器。customRules 支持pattern、flags、message、severity、suggestion、languages字段。CMVK 多模型代码审查共识式验证右键选中代码 →Agent OS: Review Code with CMVK扩展会将代码交给多个模型审查并汇总共识️ Agent OS Code Review Consensus: 66% Agreement ✅ GPT-4: No issues ✅ Claude: No issues ⚠️ Gemini: Potential SQL injection (Line 42) Recommendations: 1. Use parameterized queries to prevent SQL injection共识阈值与模型配置CMVK 客户端实现在 cmvkClient.ts请求POST /verify携带code、language、models以及共识阈值consensusThreshold默认 0.8合法区间 0.51.0。最终结果的consensus由通过模型数 / 模型总数计算Webview 展示时按阈值着色≥0.8 绿色、≥0.5 黄色、否则红色见 extension.ts。离线与降级路径未配置自定义agentOS.cmvk.apiEndpoint时客户端自动进入mock 模式shouldUseMock由内置静态分析生成模拟的多模型分歧结果便于本地开发与演示网络错误ECONNREFUSED/ENOTFOUND同样回退到 mock401 提示配置 API Key429 提示免费额度限制每日 10 次审查返回结果经过isValidCMVKResult模式校验不符合 schema 时直接中止渲染防止异常数据进入 Webviewextension.ts。reviewCode命令的完整交互启用确认、进度通知、结果面板、审计写入见 reviewCodeWithCMVK。审计日志侧栏每一次决策都有据可查点击活动栏盾牌图标打开审计视图可查看今日/本周被阻断的操作数、警告历史、CMVK 审查结果并支持导出用于合规。审计实现 auditLogger.ts 的关键行为条目类型blocked/warning/allowed/cmvk_review包含时间戳、文件、语言、截断到 200 字符的代码片段、违规名与原因内存上限1000 条超出后截断最旧记录通过context.globalState持久化retentionDays默认 7 天内旧日志在构造时自动清理cleanOldLogs提供getToday()/getThisWeek()/getStats()驱动侧栏的今日阻断 / 本周阻断 / 今日警告 / 今日 CMVK 审查统计支持 JSON 导出Export Audit Log与 CSV 导出agent-os.exportAuditCSV见 extension.ts。治理可视化 HubSLO、拓扑、审计一屏统览v1.1.0 引入统一治理仪表盘包含以下核心组件实现位于 src/webviews/sidebar/ 与 src/views/SLO Dashboard可用性、延迟 P50/P95/P99、策略合规率、信任分数含错误预算error budget与燃烧率burn rateAgent Topology基于力导向图force-directed graph呈现 agent mesh、信任环trust rings、桥接状态与委托链执行环通过 Ring 0Root到 Ring 3Sandbox四层标签展示见 extension.tsAudit Stream可过滤事件日志支持下钻详情3-Slot 侧栏8 种可用视图AuditSummary、PolicySummary、SLOSummary、TopologySummary、StatsSummary、KernelSummary、MemorySummary、GovernanceHubSummary通过面板选择器PanelPicker自由分配到 3 个槽位Scanning Mode以 4 秒节奏自动轮换槽位视觉焦点悬停/聚焦时暂停并尊重prefers-reduced-motionPriority EngineAuto 模式下按健康度紧急程度自动重排槽位critical warning healthyAttention Toggle侧栏头部 Manual/Auto 切换Manual 锁定用户配置Browser Experience通过本地服务器在外部浏览器打开同一仪表盘Open SLO Dashboard in Browser、Open Topology Graph in Browser、Open Governance Hub in Browser。治理服务器浏览器仪表盘的纵深安全模型浏览器体验由GovernanceServer支撑GovernanceServer.ts默认从端口9845起尝试绑定占用则顺延最多 10 个端口serverHelpers.ts。其防御纵深逐条对应源码安全控制实现依据Session token 认证每次会话用crypto.randomBytes(16)生成 128 位令牌generateSessionTokenWebSocket 升级时校验Sec-WebSocket-Protocol子协议头无效令牌以close code 4001拒绝GovernanceServer.ts常量时间比较令牌校验使用crypto.timingSafeEqual且遍历所有候选协议避免时序侧信道泄露匹配前缀validateWebSocketToken速率限制每客户端 IP 每分钟 100 次 HTTP 请求超限返回 429 Retry-After: 60并惰性驱逐过期记录防止 Map 无限增长checkRateLimit本地资源打包D3.js 与 Chart.js 本地化无 CDN 依赖消除外部脚本加载的供应链风险CSP 策略script-src仅允许nonce-...不开放 CDN、不启用unsafe-evalconnect-src显式限定ws://127.0.0.1:*GovernanceServer.tsHTML 转义共享escapeHtml工具应用于旧版面板 innerHTML 赋值中的动态数据Agent DID、策略名、审计数据防 XSS仅回环绑定服务器硬绑定127.0.0.1DEFAULT_HOST远程连接在结构上不可能Python 路径校验子进程 spawn 前拒绝 shell 元字符防命令注入依赖固定版本生产依赖 axios、ws 固定精确版本保证可复现构建令牌通过 WebSocket 子协议头而非 URL 查询串传输避免令牌泄漏进代理日志、浏览器历史与调试工具serverHelpers.ts。完整安全模型与威胁分析见 SECURITY.md。实时治理数据自动接入 agent-failsafe扩展首次激活时自动检测 Python 环境中的agent-failsafe缺失则提示安装pip install agent-failsafe[server]安装后本地 REST 服务器在127.0.0.1:9377自动启动SLO 看板、Agent 拓扑与审计流随即填充真实的策略合规、集群健康与审计事件——整个过程无需手动配置。数据接入逻辑见 providerFactory.ts优先使用agentOS.governance.endpoint显式覆盖否则检测/安装 agent-failsafe均不可用则返回 disconnected 空状态提供者。轮询客户端LiveSREClientliveClient.ts值得关注端点强校验必须为回环地址127.0.0.1/localhost/::1否则构造即抛错isLoopbackEndpoint轮询间隔钳制到最小值5000ms默认 10000ms响应校验类型检查、5MB 大小上限、字符串截断智能升级连续 5 次平均延迟超过阈值默认 2000ms时从单一/sre/snapshot轮询自动升级为/sre/snapshot/sre/fleet/sre/events并发拉取escalation连续 10 次低延迟后回落错误信息经过脱敏_sanitizeError绝不暴露 URL 或请求头。状态栏同步显示连接状态Live绿、Stale黄、Disconnected红。报告导出与可观测性Export Governance Report将治理快照SLO、Agent、桥、委托、近 24 小时审计事件生成为自包含 HTML 报告并保存/上传导出前先做存储凭据零信任校验见 extension.tsMetrics Exporter将看板数据按配置的agentOS.observability.endpointOpenTelemetry 兼容周期推送。命令参考命令描述Agent OS: Getting Started交互式引导教程walkthroughAgent OS: Open Policy Editor可视化策略管理工作室Agent OS: Open Workflow Designer拖拽式工作流构建器Agent OS: Show Metrics Dashboard实时监控看板Agent OS: Review Code with CMVK多模型代码审查Agent OS: Toggle Safety Mode启用/禁用保护Agent OS: Configure Policies打开策略配置Agent OS: Export Audit Log导出 JSON 审计日志Agent OS: Setup CI/CD Integration生成 CI/CD 配置GitHub Actions、GitLab CI、Jenkins、Azure PipelinesAgent OS: Install Git Hooks安装 pre-commit 钩子Agent OS: Check Compliance运行合规校验SOC 2、GDPR、HIPAA、PCI DSS 模板Agent OS: Sign In (Enterprise)企业 SSO 认证Agent OS: SLO Dashboard (Visual)富 webview SLO 看板Agent OS: Agent Topology Graph力导向 Agent 拓扑图Agent OS: Refresh SLO Data刷新 SLO 指标Agent OS: Refresh Agent Topology刷新拓扑数据Agent OS: Open Governance Hub统一治理仪表盘Agent OS: Open SLO Dashboard in Browser浏览器打开 SLO 看板Agent OS: Open Topology Graph in Browser浏览器打开拓扑图Agent OS: Open Governance Hub in Browser浏览器打开治理 HubAgent OS: Export Governance Report导出 HTML 治理报告Agent OS: Create First Agent生成受治理 Agent 脚手架Python 模板Agent OS: Run Safety Test创建演示阻断效果的测试文件Agent OS: Open Kernel Debugger打开内核调试器Agent OS: Open Memory Browser打开内存浏览器Agent OS: Open Safety Stats打开安全统计详情Agent OS: Allow This Once一次性放行指定违规全部命令在 package.json 的contributes.commands中注册部分带图标并出现在编辑器右键菜单editorHasSelection时显示 Review Code与活动栏。配置参考打开设置Ctrl,搜索 Agent OS 即可配置。以下表格综合了文档与 package.json 的contributes.configuration值域、默认值与最小约束均以声明为准设置默认描述agentOS.enabledtrue启用/禁用 Agent OS 安全检查agentOS.modebasic安全模式basic仅本地/enhancedCMVK/enterprise自定义agentOS.policies.blockDestructiveSQLtrue拦截 DROP、DELETE、TRUNCATE SQL 操作agentOS.policies.blockFileDeletestrue拦截 rm -rf 与文件删除操作agentOS.policies.blockSecretExposuretrue拦截硬编码 API Key、密码、密钥agentOS.policies.blockPrivilegeEscalationtrue拦截 sudo、chmod 777 等提权操作agentOS.policies.blockUnsafeNetworkCallsfalse拦截对未知域名的网络调用agentOS.cmvk.enabledfalse启用 CMVK 多模型验证agentOS.cmvk.models[gpt-4, claude-sonnet-4, gemini-pro]CMVK 使用的模型列表agentOS.cmvk.consensusThreshold0.8所需最小共识比例0.51.0agentOS.cmvk.apiEndpointhttps://api.agent-os.dev/cmvkCMVK API 端点agentOS.audit.retentionDays7审计日志本地保留天数agentOS.audit.logToFilefalse同时将审计事件写入文件agentOS.notifications.showBlockedtrue代码被拦截时弹通知agentOS.notifications.showWarningstrue产生警告时弹通知agentOS.diagnostics.enabledtrue启用实时诊断agentOS.diagnostics.severitywarning诊断最低级别error/warning/informationagentOS.enterprise.sso.enabledfalse启用企业 SSOagentOS.enterprise.sso.provider无SSO 提供方azure/okta/google/githubagentOS.enterprise.compliance.framework无默认合规框架soc2/gdpr/hipaa/pci-dssagentOS.export.localPath导出报告本地目录默认工作区agentOS.observability.endpoint指标推送端点OpenTelemetry 兼容agentOS.observability.pushIntervalMs60000指标推送间隔最小 10000msagentOS.governance.pythonPathpython安装了 agent-failsafe[server] 的 Python 解释器agentOS.governance.endpoint覆盖连接已有 agent-failsafe 服务器留空自动启动agentOS.governance.refreshIntervalMs10000治理数据轮询间隔最小 5000ms配置变更通过onDidChangeConfiguration监听触发policyEngine.loadPolicies()热重载规则并刷新视图extension.ts因此修改策略无需重启编辑器。隐私与安全承诺本地优先策略检查完全在扩展内执行无网络basic 模式从不将代码发送到任何地方CMVK 可选是否使用云端验证完全由你决定回环服务器浏览器看板服务器仅绑定127.0.0.1并要求会话令牌认证无遥测除非显式配置 observability 端点治理服务器不向外部发送数据开源可审计全部源码可在仓库中自行检视agent-governance-typescript/agent-os-vscode/。环境要求VS Code 1.85.0 或更高版本engines.vscode声明见 package.jsonNode.js 18开发构建需要Python 3.10Agent OS SDK / agent-failsafe 数据源需要。快速开始从 VS Code Marketplace 安装扩展命令面板运行Agent OS: Getting Started正常编码——Agent OS 自动保护你的每一次 AI 生成内容。随后可运行Agent OS: Run Safety Test生成一个演示文件直观看到 SQL 注入、硬编码密钥、rm -rf三类危险代码被诊断高亮与阻断而参数化查询等安全代码正常放行。源码中的测试套件src/test/覆盖了策略引擎、治理服务器、实时客户端、侧栏优先级引擎与扫描控制器等核心模块可作为理解各组件行为的补充参考。【免费下载链接】agent-governance-toolkitAI Agent Governance Toolkit — Policy enforcement, zero-trust identity, execution sandboxing, and reliability engineering for autonomous AI agents. Covers 10/10 OWASP Agentic Top 10.项目地址: https://gitcode.com/GitHub_Trending/ag/agent-governance-toolkit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考