猎聘 AI VS Code 插件

简介

猎聘 AI VS Code 插件为企业项目提供统一的规则、Skills管理体验，以及 AI 代码统计能力。它通过绑定 Git 仓库与企业平台，帮助研发团队在 IDE 内即可完成模版同步、版本追踪与健康检查，同时自动采集和分析代码中的 AI 生成内容，降低上下游沟通成本并提升交付一致性。

预览

功能亮点

• 项目绑定可视化：在 The One - 项目绑定管理 视图中实时查看当前工作区的绑定状态、最近同步时间以及远端更新。
• 自动/手动规则同步：检测到平台侧有更新时自动拉取最新规则；也可通过命令或 Webview 按钮手动触发同步，确保本地与远端保持一致。
• 工作区联动：监听工作区增删事件，自动为新打开的仓库执行首同步或刷新操作，避免遗漏。
• 快捷命令入口：提供 聚焦到 The One 侧边栏 命令，快速访问项目绑定管理视图。
• AI 代码统计：自动采集和分析代码中的 AI 生成内容，统计 Git 代码行数、AI 代码行数及占比，帮助团队了解 AI 辅助编程的使用情况。
• 智能自动采集：窗口获取焦点时自动触发采集（每日仅一次），采集范围覆盖最近7天的提交记录（不包含今日提交）。
• 历史记录查看：在 AI 代码统计 标签页中查看最近7天的采集记录，包括项目名称、时间范围、代码统计及详情链接。
• 调试与配置：支持自定义采集上报域名、SDK 版本号，以及调试参数配置，方便开发调试和测试环境使用。

安装要求

• Visual Studio Code 1.99.0 及以上版本
• Node.js 18 LTS 或更高版本（AI 代码统计功能需要）

市场安装

1. 在 VS Code 插件市场搜索 lpai 或 The One。
2. 点击 Install 安装插件。
3. 安装完成后，VS Code 会自动提示重新加载窗口，或手动重新加载。
4. 打开活动栏中的 The One - 项目绑定管理 图标查看项目绑定信息。

首次配置

1. 确保 Git 仓库远端可用：插件会通过 git remote origin 来识别项目身份，请确认已经配置远程地址。
2. 配置访问令牌：首次打开面板会先出现令牌填写页，可点击「获取访问令牌」按钮跳转到企业平台（https://vacs.tongdao.cn/visa/persionaccesstoken/list）生成 Token，并粘贴保存。
3. 首同步：面板会自动检测是否需要初始化规则；若未触发，可点击「立即同步」按钮手动触发同步。

使用技巧

1. 查看项目绑定：打开 VS Code 工作区 → 点击活动栏图标 → 面板将展示绑定状态、更新时间及可操作按钮。
2. 检出新分支：插件会继续沿用同一绑定信息，如需切换项目，可更改 Git 远端或在面板中解除并重新绑定。
3. 处理冲突：同步过程中若检测到本地修改与远端差异，SyncVersionManager 会提示并避免覆盖，可在面板中查看提示后手动合并。
4. 查看 AI 代码统计：切换到 AI 代码统计 标签页，可查看个人信息、今日采集信息、采集记录及历史记录。采集结果会自动上报到服务端。
5. 手动触发采集：在 AI 代码统计 标签页中，可通过调试设置面板执行调试采集，支持自定义采集天数、调试文件等参数。
6. 查看个人详情：点击 个人详情 按钮可跳转到个人统计页面，查看更详细的 AI 代码使用情况。

数据与隐私

• 插件会调用企业内网/开放接口，传输内容包含仓库 Git URL、项目绑定 ID、规则/Skills文件内容。
• AI 代码统计功能会采集 Git 提交记录、代码内容及 AI 代码匹配信息，并上报到企业平台进行统计分析。
• 所有数据仅在企业网络中流转，不会发送至猎聘以外的第三方服务。
• 如需了解详细的数据处理政策，请联系企业 IT 部门或查看内部文档。

故障排查

常见问题快速解决

• 面板显示空白：确认工作区存在、网络可访问企业接口；查看 输出 > The One 或 开发者工具 中的报错。
• 采集提示一直不消失：查看日志文件排查卡顿原因，详见 故障排查指南
• 面板一直加载：检查网络连接和日志文件，确认采集是否超时

查看日志

插件提供了完整的日志系统帮助排查问题:

1. 通过命令面板: 按 Ctrl+Shift+P → 输入 "TheOne: 打开日志文件夹"
2. 通过面板: AI 代码统计 → 设置面板 → 日志路径 → 点击"打开文件夹"
3. 手动访问: %APPDATA%\Code\User\globalStorage\liepin.the-one-vscode-plugin\

日志文件说明:

• collect.log: 正常采集日志（首先查看此文件）
• .debug/debug.log: 调试模式日志
• query_history.json: 历史记录查询结果

详细排查步骤

如果遇到采集卡顿、超时等问题，请参考 完整故障排查指南，其中包含:

• 详细的日志分析方法
• 常见卡顿原因及解决方案
• 性能优化建议
• 超时保护机制说明
• 同步失败：确保本地 git 命令可用，且远端地址与企业后台绑定一致；必要时删除 .the-one 缓存目录后重新同步。
• 自动同步无响应：检查 SyncVersionManager 缓存中的 lastSyncAt 是否更新；可通过命令面板手动刷新并记录日志。
• AI 代码统计无法使用：确认已安装 Node.js 18 LTS 或更高版本；在 AI 代码统计 标签页中会显示 Node.js 环境检测提示，未安装时可点击按钮前往下载。
• 采集失败或无数据：检查 Git 仓库是否正常，确认有提交记录；查看调试设置面板中的日志路径，检查采集日志了解详细错误信息。
• 自动采集未触发：确认窗口已获取焦点；检查今日是否已采集（每日仅自动采集一次）；可在调试设置中清空自动采集时间标记，下次获取焦点时会重新触发。

支持与反馈

• 企业内部飞书群：The One 平台接入支持
• 邮件：kuangzhongwen@liepin.com
• 提交 Issue：http://gitcode.tongdao.cn/dev28/ai/vscode-plugin/the-one-vscode-plugin/issues

开发构建

多平台二进制文件构建

本项目使用 better-sqlite3 原生模块，需要针对不同平台分别构建二进制文件。二进制文件已提交到 git，后续打包无需重新构建。

首次构建（仅需一次）

在不同平台上分别执行以下命令，生成对应平台的二进制文件：

macOS (Intel 或 Apple Silicon):

npm run prepare-binary

Windows:

npm run prepare-binary

构建完成后，二进制文件会保存到 native-binaries/ 目录：

• native-binaries/darwin-arm64/better_sqlite3.node (macOS Apple Silicon)
• native-binaries/darwin-x64/better_sqlite3.node (macOS Intel)
• native-binaries/win32-x64/better_sqlite3.node (Windows x64)
• native-binaries/win32-arm64/better_sqlite3.node (Windows ARM64)

提交到 Git

构建完成后，将 native-binaries/ 目录提交到 git：

git add native-binaries/
git commit -m "chore: 添加多平台二进制文件"

后续打包

二进制文件提交后，后续发版本只需要执行：

npm run vsce:package

注意：

• postinstall 脚本会自动检测，如果二进制文件已存在则跳过重建
• 无需在每个平台上重新构建，直接使用已提交的二进制文件即可
• 打包时会自动包含所有平台的二进制文件

开发命令

License

项目已采用 MIT License，详细条款见根目录 LICENSE 文件。