Skip to content

zihjiang/open-office-copilot

Repository files navigation

Office AI助手 (Office AI Copilot)

一个智能的Office插件,为Word、Excel和PowerPoint提供AI驱动的文档处理功能,包括智能总结、翻译、格式优化和数据分析等。

✨ 功能特性

🤖 AI核心功能

  • 智能总结: 快速总结文档内容,提取关键信息
  • 多语言翻译: 支持多种语言间的智能翻译
  • 格式优化: AI驱动的文档格式美化和优化
  • 数据分析: Excel数据的智能分析和洞察生成
  • 通用AI对话: 与AI助手进行自然语言交互

📱 用户界面

  • 现代化设计: 简洁美观的用户界面
  • 深色主题: 支持浅色/深色主题切换
  • 响应式布局: 适配不同屏幕尺寸
  • 无障碍支持: 完整的键盘导航和屏幕阅读器支持

⚙️ 高级配置

  • 多AI服务商: 支持OpenAI、Azure OpenAI等多种AI服务
  • 自定义设置: 灵活的配置选项和个性化设置
  • 快捷键支持: 高效的键盘快捷键操作
  • 数据隐私: 本地配置存储,保护用户隐私

🚀 快速开始

系统要求

  • Office版本: Microsoft Office 2016或更高版本
  • 操作系统: Windows 10/11, macOS 10.14+
  • 浏览器: Chrome 80+, Edge 80+, Safari 13+
  • Node.js: 16.0或更高版本(开发环境)

安装步骤

1. 克隆项目

git clone https://github.com/your-repo/office-ai-copilot.git
cd office-ai-copilot

2. 安装依赖

npm install

3. 生成SSL证书(Office插件开发必需)

# 创建证书目录
mkdir certs
cd certs

# 生成自签名证书
openssl req -x509 -newkey rsa:2048 -keyout localhost-key.pem -out localhost.pem -days 365 -nodes -subj "/CN=localhost"

cd ..

4. 启动开发服务器

# 开发模式
npm run dev

# 或者使用Node.js服务器
npm start

5. 在Office中加载插件

方法一:通过Office开发者工具

  1. 打开Word/Excel/PowerPoint
  2. 转到 插入 > 我的加载项 > 开发人员加载项
  3. 选择 manifest.xml 文件

方法二:通过Office 365管理中心

  1. 访问 Office 365管理中心
  2. 转到 设置 > 集成应用
  3. 上传 manifest.xml 文件

🛠️ 开发指南

项目结构

office-ai-copilot/
├── assets/                 # 静态资源
│   ├── icon-16.png         # 16x16图标
│   ├── icon-32.png         # 32x32图标
│   ├── icon-64.png         # 64x64图标
│   └── icon-80.png         # 80x80图标
├── src/                    # 源代码
│   ├── commands/           # Office命令处理
│   │   ├── commands.html   # 命令页面
│   │   └── commands.js     # 命令逻辑
│   ├── components/         # UI组件
│   │   ├── settings.html   # 设置页面
│   │   └── settings.js     # 设置逻辑
│   ├── config/             # 配置管理
│   │   └── config.js       # 配置管理器
│   ├── services/           # 服务层
│   │   └── aiService.js    # AI服务接口
│   ├── styles/             # 样式文件
│   │   ├── main.css        # 主样式
│   │   └── taskpane.css    # 任务面板样式
│   ├── taskpane/           # 任务面板
│   │   ├── taskpane.html   # 主界面
│   │   └── taskpane.js     # 主逻辑
│   └── utils/              # 工具函数
│       └── officeUtils.js  # Office API工具
├── certs/                  # SSL证书(需要生成)
├── dist/                   # 构建输出
├── manifest.xml            # Office插件清单
├── package.json            # 项目配置
├── server.js               # 开发服务器
├── tsconfig.json           # TypeScript配置
└── webpack.config.js       # Webpack配置

可用脚本

# 开发模式(带热重载)
npm run dev

# 生产构建
npm run build

# 启动开发服务器
npm start

# 代码检查
npm run lint

# 代码格式化
npm run format

# 运行测试
npm test

环境变量

创建 .env 文件配置环境变量:

# 服务器配置
PORT=3000
HTTPS_PORT=3443

# AI服务配置(可选,也可在插件中配置)
OPENAI_API_KEY=your_openai_api_key
OPENAI_BASE_URL=https://api.openai.com/v1
OPENAI_MODEL=gpt-3.5-turbo

# Azure OpenAI配置(可选)
AZURE_OPENAI_API_KEY=your_azure_key
AZURE_OPENAI_ENDPOINT=your_azure_endpoint
AZURE_OPENAI_DEPLOYMENT=your_deployment_name

📖 使用说明

基本操作

1. 打开AI助手

  • 在Office应用的 主页 选项卡中找到 AI助手 按钮
  • 点击按钮打开任务面板

2. 配置AI服务

  • 首次使用需要配置AI服务提供商
  • 点击设置按钮,选择AI服务商并输入API密钥
  • 支持OpenAI、Azure OpenAI等多种服务

3. 使用AI功能

文档总结

  1. 选择要总结的文本(可选,不选择则总结整个文档)
  2. 点击 总结 按钮或使用快捷键 Ctrl+Shift+S
  3. AI将生成文档摘要

文本翻译

  1. 选择要翻译的文本
  2. 点击 翻译 按钮或使用快捷键 Ctrl+Shift+T
  3. 选择目标语言,AI将提供翻译结果

格式优化

  1. 选择要优化的文本
  2. 点击 格式优化 按钮
  3. AI将改善文本的格式和表达

数据分析(Excel专用)

  1. 选择数据区域
  2. 点击 数据分析 按钮
  3. AI将提供数据洞察和分析结果

高级功能

自定义设置

  • 主题: 切换浅色/深色主题
  • 语言: 设置界面语言
  • 快捷键: 自定义快捷键组合
  • AI参数: 调整创造性程度、回复长度等

数据隐私

  • 所有配置信息存储在本地
  • 支持数据导出和导入
  • 可清除所有缓存数据

🔧 故障排除

常见问题

Q: 插件无法加载 A:

  1. 确保使用HTTPS访问(Office插件要求)
  2. 检查SSL证书是否正确生成
  3. 验证manifest.xml文件路径和格式

Q: AI功能不工作 A:

  1. 检查API密钥是否正确配置
  2. 验证网络连接和API服务状态
  3. 查看浏览器控制台的错误信息

Q: 界面显示异常 A:

  1. 清除浏览器缓存
  2. 检查Office版本兼容性
  3. 尝试重新加载插件

调试模式

启用调试模式获取详细日志:

// 在浏览器控制台中执行
localStorage.setItem('debug', 'true');
// 重新加载插件

日志收集

查看详细日志信息:

  1. 打开浏览器开发者工具(F12)
  2. 切换到 控制台 选项卡
  3. 查看错误和警告信息
  4. 网络选项卡可查看API请求状态

🤝 贡献指南

我们欢迎社区贡献!请遵循以下步骤:

开发流程

  1. Fork项目

    git fork https://github.com/your-repo/office-ai-copilot.git
  2. 创建功能分支

    git checkout -b feature/your-feature-name
  3. 提交更改

    git commit -m "feat: add your feature description"
  4. 推送分支

    git push origin feature/your-feature-name
  5. 创建Pull Request

代码规范

  • 使用ESLint和Prettier进行代码格式化
  • 遵循JavaScript/TypeScript最佳实践
  • 为新功能添加适当的注释和文档
  • 确保所有测试通过

提交信息规范

使用约定式提交格式:

type(scope): description

[optional body]

[optional footer]

类型包括:

  • feat: 新功能
  • fix: 错误修复
  • docs: 文档更新
  • style: 代码格式调整
  • refactor: 代码重构
  • test: 测试相关
  • chore: 构建过程或辅助工具的变动

📄 许可证

本项目采用 MIT许可证

🙏 致谢

📞 支持与反馈


开始使用Office AI助手,让AI为您的办公效率加速! 🚀

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors