HelixHarness – 滴滴开源编码代理管控层

HelixHarness是滴滴对外开源的编码代理治理与协同组件，面向各类代码智能体搭建权限管控、策略校验与执行审计的中间层，不接管智能体本身的调度、模型路由与沙箱运行逻辑，专注把权限边界、执行凭证、决策日志抽离成独立模块。组件采用轻量化内核设计，依托适配器机制对接不同IDE、代码智能体宿主，把异构系统里的权限规则统一翻译为标准化校验逻辑，降低多工具混用带来的管控混乱。本地项目存储证据记录，授权信息和项目上下文做分离处理，项目拷贝迁移时不会携带可直接生效的权限凭证，规避代码仓库流转带来的权限泄露风险。

HelixHarness特点

HelixHarness以策略内核为核心，所有权限判定都基于预设规则和执行证据。

适配器机制隔离宿主底层差异，新增编码工具仅需要开发对应适配层。

权限采用范围化授予模式，可限定操作资源、执行时长与动作类型。

决策过程留存结构化回执，每一次拦截或放行都留存可回溯记录。

支持离线模式运行，本地项目目录可独立保存规则与任务记录。

跨平台 CI 流水线适配Ubuntu、Windows主流环境，Node版本兼容20、22 稳定分支。

HelixHarness优势

独立于智能体运行链路，原有代码代理流程不需要大规模改造。

权限规则和业务代码分开维护，调整管控策略不用修改智能体主程序。

项目克隆迁移时，授权状态不会跟着项目文件同步扩散。

规则组合能力灵活，内置基础安全约束，也可叠加自定义项目策略。

轻量内核占用资源低，不会给代码生成、文件修改这类高频操作增加明显延迟。

开源分发模式，团队可基于源码修改适配内部代码仓库规范。

HelixHarness功能

加载项目与全局两级策略文件，合并生成生效的权限规则集。

解析编码代理发起的文件读写、命令调用、代码修改请求，匹配规则给出判定结果。

生成结构化执行回执，记录请求主体、资源范围、判定理由与时间戳。

管理会话级写入权限，对并发修改资源做写入租约管控。

提供主机生命周期管理指令，完成适配器安装、状态查看、版本修复与卸载。

导出任务执行记录，用于审计、问题复盘与规则迭代。

HelixHarness应用场景

企业内部 AI 编码代理接入管控，约束代码智能体修改线上配置、敏感文件。

研发团队 IDE 智能插件权限管控，限制高危 shell 命令执行。

CI 流水线内代码自动修改任务的权限校验，拦截无授权变更。

开源项目协作场景，给外部贡献代理设置有限操作范围。

研发安全审计平台，收集编码代理操作日志用于风险排查。

HelixHarness如何使用

拉取Github仓库源码，本地准备Node20或Node22运行环境。

执行初始化命令完成全局环境配置，使用 link 指令绑定目标代码工作目录。

编写项目策略文件，定义允许和禁止的操作类型、资源路径。

安装对应宿主适配器，对接 IDE 或者代码智能体客户端。

启动编码代理，所有文件、命令请求会自动经过 HelixHarness 校验。

查看会话日志，核对拦截记录，调整策略文件后重新加载生效。