CTJ Code Mark Statistics
自动统计 AI 生成代码量，支持团队级数据汇总与代码签名审计
CTJ Code Mark Statistics 是一个 VS Code / Qoder 扩展，通过 MCP Server Definition Provider 注册内置审计服务，并启动独立的文件监听子进程，自动区分并统计 AI 生成代码与手写代码的行数变化，将数据上报到统一的审计数据平台。
功能特性
- MCP Server 注册：安装即生效，自动向编辑器注册 MCP 审计代理服务（基于
vscode.lm.registerMcpServerDefinitionProvider）。
- 文件变更监听：独立子进程实时监控配置的项目目录，精确计算每次代码变更的增删行数。
- AI 信号识别：通过 HTTP 信号端口识别 AI 编辑工具触发的文件操作，自动区分 AI 代码与手动代码。
- SSO 认证集成：内置登录向导，认证通过后才启动监控，确保统计数据与开发者身份绑定。
- VCS 提交检测：兼容 Git 与 SVN，在代码提交时自动触发签名统计。
- 远程数据上报：将暂存的变更数据与提交统计推送到远程数据平台，支持团队聚合展示。
- 自动崩溃恢复：watcher 子进程异常退出（如 OOM）时自动重启，保障监控连续性。
安装
- 在编辑器的扩展面板搜索 CTJ Code Mark Statistics 并安装。
- 或通过命令面板运行
Extensions: Install from VSIX，选择 .vsix 文件安装。
快速开始
- 安装后，扩展会自动弹出提示，点击 立即登录配置。
- 在登录对话框中输入用户名和密码完成 SSO 认证。
- 配置要监控的项目目录（支持多个目录）。
- 重启编辑器，监控自动启动。
命令
| 命令 |
说明 |
CTJ Code Mark: Init Setup |
初始化向导：登录认证 + 配置监控目录 |
CTJ Code Mark: Add Watch Directory |
添加 / 移除监控目录（即时生效，无需重启） |
CTJ Code Mark: Generate AI Signal Rule |
生成 AI 审计信号规则文件（.qoder/rules/ai-audit-signal.md） |
CTJ Code Mark: Show Status |
查看认证、watcher 进程、暂存数据等运行状态 |
配置项
在编辑器设置中搜索 mcpAudit 即可配置：
| 配置项 |
类型 |
默认值 |
说明 |
mcpAudit.userId |
string |
"" |
用户身份标识（登录后自动绑定 SSO 用户名） |
mcpAudit.teamId |
string |
default |
团队名称 |
mcpAudit.watchDirs |
array |
[] |
要监控的项目目录列表 |
mcpAudit.remoteUrl |
string |
http://39.106.168.153:3000/api/ingest |
远程数据平台推送地址 |
mcpAudit.remoteToken |
string |
"" |
远程推送认证令牌 |
mcpAudit.logPath |
string |
"" |
审计日志文件路径（留空使用默认临时目录） |
mcpAudit.signalPort |
number |
3001 |
AI 信号 HTTP 端口 |
架构说明
┌─────────────────────────────────────────────┐
│ Editor (VS Code / Qoder) │
│ ┌───────────────────────────────────────┐ │
│ │ extension.ts (扩展主进程) │ │
│ │ ├─ SSO 认证检查 │ │
│ │ ├─ registerMcpServerDefinitionProvider│ │
│ │ └─ spawn(watcher-bundle.js) │ │
│ └───────────────┬───────────────────────┘ │
│ │ │
│ ┌───────────────▼───────────────────────┐ │
│ │ watcher-bundle.js (独立子进程) │ │
│ │ ├─ chokidar 文件监听 │ │
│ │ ├─ diff 行数计算 │ │
│ │ ├─ AI 信号识别 (HTTP :3001) │ │
│ │ ├─ VCS 提交检测 (Git/SVN) │ │
│ │ └─ 数据暂存 + 远程上报 │ │
│ └───────────────────────────────────────┘ │
└─────────────────────────────────────────────┘
技术栈
- TypeScript + esbuild 打包
- Model Context Protocol (MCP) SDK
- chokidar 文件监听
- 兼容 VS Code 1.99+ / Qoder
License
本项目基于 MIT 协议开源，LICENSE 文件随扩展一同分发。
| |
