YDS Copilot - YonBIP AI 助手扩展

YDS Copilot 是 YonBIP 企业级 AI 助手扩展，专为用友 YonBIP 平台定制，提供智能开发辅助和企业级 AI 能力。

项目概述

yds-copilot 是用友网络为 YonBIP 生态系统深度定制的智能开发助手，集成了用友专有的 AI 服务和工具链，为企业开发者提供完整的 AI 辅助开发体验。

版本信息

当前版本: 0.0.33
VSCode 要求: ^1.84.0
Node.js 要求: 18+

项目背景

YDS Copilot 是用友网络开发的 AI 助手，主要服务于 YonBIP 生态系统的开发者，提供：

企业级 AI 开发辅助: 基于 YonBIP 开发规范的智能代码生成和优化
YonBIP 专属工具链集成: 深度对接用友云服务和 API
用友云服务深度对接: 支持 YonGPT 等用友专有 AI 服务
企业级安全与合规保障: 符合企业安全标准和数据管控要求

核心功能特性

1. 智能代码辅助

智能代码生成: 基于 YonBIP 开发规范生成高质量代码
上下文感知: 理解 YonBIP 项目结构和业务场景
代码解释与优化: 自动分析代码逻辑并提供优化建议
错误修复: 智能诊断和修复代码问题

2. AI 模型支持

YonGPT 集成: 用友专有 AI 服务，支持多种模型：
- qwen-turbo、qwen-max、qwen-plus-latest
- deepseek-v3、deepseek-v3-1-250821、deepseek-r1
- doubao-seed-1-6-thinking-250615、doubao-seed-1-6-nothinking
多模型提供商: 支持 DeepSeek、Qwen 等主流 AI 模型
模型切换: 支持 Plan/Act 双模式使用不同模型

3. 企业级工具集成

RAG 系统: 本地检索增强生成，支持企业私有知识库
代码补全: 智能代码建议和自动补全
MCP 集成: Model Context Protocol 支持外部工具集成
Git 集成: 智能提交消息生成和代码版本管理

4. 开发工作流

Plan/Act 双模式: 分离规划与执行，提高开发效率
任务管理: 完整的任务生命周期管理
实时协作: 支持团队协作和知识共享
检查点系统: Git-based 检查点，支持状态恢复

技术架构

项目结构

yds-copilot/
├── src/                    # 核心扩展代码
│   ├── core/              # 核心业务逻辑
│   │   ├── controller/    # 控制器（状态管理）
│   │   ├── task/          # 任务执行系统
│   │   ├── api/           # API 提供者系统
│   │   └── webview/       # Webview 管理
│   ├── hosts/             # 宿主环境适配
│   ├── services/          # 服务层（认证、日志等）
│   ├── shared/            # 共享类型和工具
│   └── utils/             # 工具函数
├── webview-ui/            # React 前端界面
│   ├── src/
│   │   ├── components/    # React 组件
│   │   ├── context/       # 状态上下文
│   │   └── services/      # 前端服务
├── proto/                 # Protobuf 定义
├── cli/                   # 命令行工具
├── docs/                  # 开发文档
└── tests/                 # 测试代码

关键技术栈

开发语言: TypeScript
构建工具: esbuild + Vite
前端框架: React + Tailwind CSS
通信协议: Protobuf/gRPC
包管理: npm
代码质量: Biome（格式化+linting）

核心组件

Extension Entry (src/extension.ts): VSCode 扩展主入口
Controller (src/core/controller/): 状态管理和业务协调
Task System (src/core/task/): AI 请求执行和工具操作
Webview Provider (src/core/webview/): Webview 生命周期管理
API Providers (src/core/api/providers/): 多模型 AI 服务集成

安装与使用

安装要求

VSCode: 1.85+ 版本
Node.js: 18+ 版本
操作系统: Windows/macOS/Linux
网络: 访问用友云服务的网络环境

安装步骤

从用友市场下载安装包:
- 获取最新版本的 .vsix 安装包

VSCode 安装:

code --install-extension yds-copilot-{version}.vsix

重启 VSCode:
- 安装完成后重启 VSCode
登录 YonBIP 账号:
- 在扩展中登录您的 YonBIP 开发者账号
配置 AI 模型:
- 在设置中选择合适的 AI 模型提供商
- 配置相应的 API 密钥（如需要）

快速开始

打开 VSCode，点击侧边栏的 YDS Copilot 图标
点击 "+" 按钮开始新任务
输入您的开发需求或问题
选择 Plan 模式进行规划，或直接使用 Act 模式执行
查看生成的代码和建议，按需采纳

开发指南

环境搭建

# 1. 克隆项目
git clone <repository-url>
cd yds-copilot

# 2. 安装所有依赖
npm run install:all

# 3. 启动开发模式
npm run dev

# 4. 按 F5 启动调试
# 将打开新的 VSCode 窗口，加载开发版扩展

常用命令

# 安装依赖
npm run install:all

# 开发模式（监听文件变化）
npm run dev

# 生产构建
npm run package

# 运行测试
npm test

# 代码格式化
npm run format:fix

# 代码检查
npm run lint

# 类型检查
npm run check-types

# 生成 Protobuf 代码
npm run protos

项目构建

# 完整构建流程
npm run install:all    # 安装依赖
npm run protos         # 生成 Protobuf 代码
npm run build:webview  # 构建前端
npm run compile        # 编译扩展
npm run package        # 打包为 .vsix 文件

测试

# 运行单元测试
npm run test:unit

# 运行集成测试
npm run test:integration

# 运行 E2E 测试
npm run test:e2e

# 运行所有测试
npm test

配置说明

RAG 系统配置

本地文档目录: 配置私有知识库文档路径
向量数据库: 自动创建和管理本地向量索引
检索设置: 调整检索相关性和返回结果数量

扩展设置

自动批准: 配置工具执行的自动批准规则
上下文管理: 调整对话上下文长度和保留策略
主题设置: 选择浅色/深色主题

贡献指南

代码贡献流程

创建 Issue: 在内部工单系统创建相关 Issue
分支开发: 从 main 分支创建功能分支
开发测试: 实现功能并添加测试
代码审查: 提交 Pull Request 进行代码审查
合并发布: 通过审查后合并到 main 分支

代码规范

使用 TypeScript 严格模式
遵循项目现有的代码风格
添加必要的注释和文档
编写单元测试和集成测试

提交规范

使用语义化提交消息
关联相关 Issue
保持提交的原子性

支持与反馈

问题反馈

内部工单系统: 提交至用友内部工单系统
功能建议: 通过内部渠道提出功能建议
Bug 报告: 详细描述问题现象和复现步骤

技术支持

文档: 参考项目文档和代码注释
示例: 查看测试代码和示例项目
社区: 内部技术社区讨论

许可证与版权

许可证

专有组件: 用友网络专有许可证

版权声明

使用限制

仅限用友 YonBIP 生态内部使用
禁止未经授权的分发和修改
遵守企业安全合规要求

YDS Copilot - 让 AI 成为您的开发伙伴，提升 YonBIP 开发效率与质量

YonBIP YDS Copilot

yds-ide