cannbot-sentry:基于 npm 生态的 LLM 编码 Agent 观测审计评测项目

CANN 生态中面向 Agent 工作流的“哨兵”:观测 · 审计 · 评测三位一体的质量基础设施

分支1Tags0
文件最后提交记录最后更新时间
12 天前
5 天前
22 小时前
5 天前
5 天前
5 天前
5 天前
26 天前
28 天前
5 天前
13 天前
13 天前
26 天前
9 天前
9 天前
26 天前

CANNBot-Sentry

License

English

CANNBot 是 CANN 社区的 Infra 智能体层,用 Agent 完成 AscendC/PyPTO/TileLang/Triton 等各类语言的算子开发、模型迁移与推理优化,并延伸至图模式、Runtime 等更多 CANN 开发场景。

本仓(cannbot-sentry)是其观测仓,面向 LLM 编码 Agent(opencode / Claude Code)提供观测 · 审计 · 评测能力;仓群还包括 cannbot、cannbot-skills、cannbot-knowledge、cannbot-dsl、cann-bench 等仓库,结构如下。

CANNBot 仓群结构

Agent 在场上跑,Sentry 在场边:记录现场 · 复盘事实 · 评鉴质量。

仓库状态:packages/insight 与 packages/cpx 已迁入落地(并已发布 npm);packages/sift(审计 / 评测)规划中、待迁入,详见目录结构。

核心能力

能力 回答的问题 亮点
观测 Observe(packages/insight) 运行中发生了什么? 全量画像:Token · 成本 · 上下文;Turn / Tool / Skill 可回放时间线;按时间戳重建文件现场(取证)
捕获 Capture(packages/cpx) 线上到底传了什么? 网关旁路捕获全量上下文请求/响应;API Key 永不落盘(唯一落盘咽喉统一打码)
审计 Audit(packages/sift) 有没有按声明做? 双重校验:流程合规 + 结果一致;执行 vs 声明(Skill · Agent · Workflow)对账,证据回链
评测 Evaluate(packages/sift) 做得好不好? 静态:分析 + 安全审查(规则驱动);动态:A/B —— 有无 Skill · 版本对比;判决报告 + CI 门禁

原则:零侵入 —— 不改 Agent 工作流、不改 opencode / Claude Code,能力叠加其上;本地优先 —— 只读取本地会话记录,数据不出域。

源码下载

git clone https://gitcode.com/cann/cannbot-sentry.git
cd cannbot-sentry

安装

npm(免克隆源码)——已发布到公共 npm registry,一条命令安装:

npm install -g cannbot-insight   # insight 观测平台(cannbot-insight / cbi)
npm install -g cannbot-proxy     # cpx 捕获代理(cpx)
# Context 品牌同款(会话数据完全互通):
npm install -g context-insight   # insight 观测平台(context-insight / ctxi)
npm install -g context-cpx       # cpx 捕获代理(cpx)

Tab 补全在安装时自动装配(bash/zsh),新开终端 cpx <TAB> 即可用。

源码安装——统一安装入口支持单包 / 组合 / 全量三种方式:

./install.sh insight   # 安装单个包
./install.sh insight cpx  # 组合安装
./install.sh all       # 全量安装

insight 与 cpx 现已可安装;sift 待迁入暂为占位。各包前置要求见其 README。

目录结构

Monorepo,packages/ 下一个目录 = 一个独立安装包。包间零 import、零构建依赖,仅通过运行时契约(数据格式、CLI 接口)耦合。

cannbot-sentry/
├── README.md / README-zh.md   # 双语总览 · 导航与安装
├── LICENSE                    # CANN OSL 2.0 · 全仓唯一
├── CONTRIBUTING.md            # 贡献指南(Issue / PR 规范)
├── SECURITY.md                # 安全声明
├── OAT.xml / .gitignore       # 合规扫描 · 忽略规则
├── install.sh                 # 统一安装:单包 / 组合 / all
├── scripts/                   # 治理脚本(许可证门禁等)
├── docs/                      # 跨包文档(架构 · 安装)
└── packages/
    ├── insight/               # 会话洞察 · 观测
    ├── cpx/                   # 网关 · 流量捕获
    └── sift/                  # 审计 · 评测

拓展 Sentry = 在 packages/ 下新增一个包,即插即用。

贡献指南

欢迎提交 Issue 与 PR。贡献流程、Issue/PR 规范与质量门槛见贡献指南。

问题反馈

许可证

基于 CANN Open Software License v2.0 发布,见 LICENSE。

相关链接

项目介绍

CANN 生态中面向 Agent 工作流的“哨兵”:观测 · 审计 · 评测三位一体的质量基础设施

定制我的领域