Skip to content

CoderZzxy/WordCopilotChat

BranchesTags

Repository files navigation

WordCopilotChat - Word 智能助手（VSTO 插件）

一个面向 Word 的本地智能助手：支持智能聊天、智能体（Agent）直接操作文档、所见即所得的预览与一键应用、标题上下文选择、Markdown/公式/流程图/代码块渲染与插入、模型与提示词可视化管理、加密导入导出等。完全本地运行（通过 WebView2 承载前端 UI），默认不留存隐私数据；项目将以 MIT 协议开放，免费、无商业限制。

📢 重要说明

  • 本仓库是「WordCopilot」项目的部分功能开源版本
  • 作者工作繁忙，精力有限，维护和更新可能不定期
  • 请勿提交 PR（作者不熟悉 GitHub 操作），建议通过 Issue 或微信反馈
  • 可自由用于商业项目，无需告知作者，无需付费
  • 开源初衷：帮助开发者完成工作、为社会创造就业机会
  • 如遇问题：提交 Issue 或微信联系（见文末"联系与反馈"）

使用教程（在线阅读）

功能特性

  • Chat 与 Agent 双模式

    • Chat：常规问答、内容生成，支持 Markdown、代码高亮、KaTeX/MathJax 公式、Mermaid 流程图
    • Agent：直接调用工具操作文档（插入内容、修改样式、获取文档统计/标题/选中文本/表格/图片/公式等）
    • 内联“现代化预览卡片”：先预览、后应用，一键接受/拒绝；支持批量接受/拒绝

  • 文档上下文选择

    • 输入框中“空格 + #”即可选择文档/标题作为上下文；也可多选

  • 大文档友好

    • 优先“文档统计”获取概况；标题列表支持分页；工具调用过程有进度卡片与日志

  • 可视化管理

    • 模型列表（含模板、工具开关、参数）、提示词编辑（支持导入导出）、文档管理（上传、查看、导出/导入）

  • 安全与导入导出

    • 导入导出使用 AES-256-CBC + HMAC-SHA256 加密，PBKDF2 派生密钥（见 utils/EncryptionUtils.cs）

  • 模型适配

    • 已适配国产模型：DeepSeek、Kimi、ChatGLM、MiniMax 的最新旗舰模型；支持自定义 BaseUrl / ApiKey / 参数 /多模态

  • 一键加载当前 Word 文档（全文上下文）

    • 顶部栏“文档”按钮可将当前打开的 Word 文档全文加载为上下文（内存态，不写入磁盘）
    • 支持“加载/取消加载/卸载”三态切换：加载中再次点击=取消；已加载再次点击=卸载并清空已加载内容
    • 加载完成会提示字符数与时间；加载后可直接提问“整篇文档”的相关问题
    • 为避免卡顿与超长上下文，全文加载默认最多读取 50000 字符

  • Token 管理与自动上下文压缩

    • 支持为模型配置“上下文长度（k tokens）”，用于判断是否需要压缩（未配置或为 0 则不启用自动压缩）
    • 当对话历史接近上下文窗口阈值时，自动调用 AI 将旧对话压缩为结构化摘要，并保留关键决策、文档引用与工具操作记录
    • 聊天界面会显示 Token 使用情况（usage/估算值）；压缩过程会提示“正在自动压缩”，完成后自动恢复

⚙️ 模型配置注意事项

已适配的国产模型

  • DeepSeek、Kimi、ChatGLM、MiniMax 的最新旗舰模型（2025-11-15）
  • 支持自定义 API 地址、ApiKey、请求参数
  • 也可使用其他兼容 OpenAI API 格式的自定义模型接口
  • 已适配ChatGLM系列的vl模型：ChatGLM-4.6V、Kimi系列的vl模型：moonshot-v1-8k-vision-preview等（2025-12-11）
  • 已适配deepseek-reasoner、MiniMax-M2.1、kimi-k2-thinking等思考模型（2026-02-11）

⚠️ API 地址配置重要说明

本项目采用 HTTP 直接调用方式，需要填写完整的请求地址（Request URL），不同于使用 OpenAI SDK。

关键区别：

  • 🔸 OpenAI SDK（如 Python/Node.js） - base_url 参数只需填写到版本号，SDK 会自动拼接 /chat/completions
  • 🔸 本项目（HTTP 直接请求） - 需要填写完整的 API 请求地址，包含 /chat/completions 端点

📌 配置示例对比（以 Qwen 为例）

调用方式 填写内容 说明
OpenAI SDK 的 base_url https://dashscope.aliyuncs.com/compatible-mode/v1 SDK自动拼接端点
本项目 的 API 地址 https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions 填写完整URL

⚡ 简单记法：如果您从模型提供商文档获取的是 SDK 的 base_url，在本项目中需要手动添加 /chat/completions 后缀。

🎯 常见模型完整 API 地址

模型提供商 完整 API 请求地址
DeepSeek https://api.deepseek.com/chat/completions
Kimi (Moonshot) https://api.moonshot.cn/v1/chat/completions
ChatGLM (智谱) https://open.bigmodel.cn/api/paas/v4/chat/completions
通义千问 (Qwen) https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
MiniMax https://api.minimaxi.com/v1/chat/completions

💡 配置提示：直接复制上表中对应模型的完整地址，粘贴到"模型列表"的 API 地址字段即可。

运行截图（示意）

  • 功能区按钮：打开侧边栏、模型列表、提示词设置、文档管理、日志开关
  • WebView2 聊天界面：消息气泡、工具预览卡片、悬浮批量操作

注：请以实际运行为准，界面持续优化中。

演示

以下为部分演示

1. 欢迎语插入

1.欢迎语插入

2. 导入模型

2.导入模型

3. 欢迎语和提示词

3.欢迎语和提示词

4. 文档上传和解析

4.文档上传和解析

5. 文档引用

5.文档引用

6. 文档引用

6.文档引用

7. Agent插入

7.Agent插入

8. Agent查询

8.Agent查询

快速开始

环境要求

可选（仅限开发者环境）：

  • Visual Studio 2019/2022（安装“Office/SharePoint 开发”工作负载）用于编译与调试此 VSTO 插件。

获取代码与依赖

  1. Clone 仓库
  2. 双击打开 WordCopilotChat.csproj（或使用 VS 打开所在解决方案/文件夹）
  3. 还原依赖（NuGet）：FreeSql、Microsoft.Web.WebView2、Newtonsoft.Json

调试运行

  1. 在 VS 中设置启动项目为 WordCopilotChat
  2. F5 启动（首次会启动 Word 并加载该 Add-in）
  3. 在 Word 功能区找到 “WordCopilotChat” 相关按钮
    • “打开助手” → 显示右侧 WebView2 聊天面板
    • “模型列表”“提示词设置”“文档管理”“日志开关”等

首次配置

  1. 打开“模型列表”，新增一个模型（设置 BaseUrl、ApiKey、参数 JSON、是否启用工具）
  2. 在聊天面板右上角选择该模型与聊天模式（Chat / Agent）
  3. 可在“提示词设置”中自定义 Chat / Agent / Welcome 提示词（支持导出/导入）

使用指南

Chat 模式（问答/生成）

  • 直接在输入框中提问或给出指令，支持 Markdown/公式/代码/流程图
  • 复制/插入到 Word：消息区域提供“复制”和“插入到 Word”
  • 欢迎页示例可直接插入（包含表格/代码/公式/流程图）

Agent 模式（工具驱动）

  • 根据输入意图自动收窄工具白名单（避免误操作）
  • 典型流程
    1. 获取文档概况：优先使用 “get_document_statistics”
    2. 需要标题时再使用 “get_document_headings”（大量标题请分页）
    3. 插入/修改前：先 “check_insert_position” 检查目标标题与上下文
    4. “formatted_insert_content” / “modify_text_style” 首先产生预览卡片 → 接受后执行
  • 工具调用过程会以卡片展示“执行中/完成”状态；可批量接受/拒绝所有待处理预览

上下文选择

  • 输入框打字时，输入“空格 + #” 即可唤起“标题快捷选择器”
  • 支持层级化显示、分页加载、键盘导航、回车插入为 @标题

文档管理

  • “文档管理”窗口支持：
    • 上传并解析（.doc/.docx/.md），可在上传前剔除指定子树标题
    • 最大文档数限制
    • 文档导出为加密包 .wcdoc，也可从包导入

日志与隐私

  • 功能区提供“日志开关”，默认关闭（节省磁盘且更隐私）
  • 开启后会写入用户目录 ~/.WordCopilotChat/logs/（请求/错误）
  • OpenAI 请求日志中会对 API Key 做脱敏处理

目录结构（简要）

WordCopilotChat/
  forms/             # WinForms 各类设置/管理窗口 & 侧边栏 UserControl
  services/          # 模型、提示词、文档、应用设置服务（FreeSql + SQLite）
  utils/             # WebView2/OpenAI/Word 工具、文档解析、加密等
  wwwroot/           # 前端（WebView2）资源：index.html、css、js（chat.js 主逻辑）
  Ribbon1.*          # Word 功能区
  ThisAddIn.*        # VSTO 入口，初始化数据库表等

常见问题

安装与环境

Q: Word 未被正确加载？
A: 请确认已安装与 VS 匹配的 VSTO 组件，并以管理员身份启动 VS 再调试

Q: WebView2 白屏？
A: 请安装/更新 WebView2 Runtime；或检查 Microsoft.Web.WebView2 依赖是否成功还原

功能使用

Q: 工具调用无响应？
A: 确认当前模型"启用工具"开关、Agent 模式、以及前端白名单未被收窄

Q: 大文档卡顿？
A: 先使用"文档统计"，需要标题再分页获取；避免一次性获取整个文档的所有细节

贡献与反馈

Q: 我发现了 Bug 或想贡献代码，如何处理？
A: 请勿提交 PR。作者对 GitHub 操作不熟，建议通过以下方式：

  • 提交 Issue 详细描述问题或功能需求
  • 添加作者微信（备注"WordCopilot"）
  • 作者会在空闲时间处理您的反馈

Q: 可以基于此项目开发商业版吗？
A: 完全可以，无需告知作者，无需付费。 本项目采用 MIT 许可证，允许任何形式的商业使用。作者开源的初衷就是帮助更多人，不会收费也不会限制商业化。

Q: 项目会持续更新吗？
A: 作者会尽最大努力持续迭代，除非出现更优秀的替代开源方案。由于作者工作较忙，更新节奏可能不定期，请谅解。

贡献方式（重要说明）

⚠️ 请勿提交 Pull Request

由于作者对 GitHub 操作不够熟悉，且工作较忙（经常加班），暂时无法及时审核和合并他人代码。

✅ 推荐的反馈方式

如果您发现 Bug 或有功能建议，请通过以下方式联系：

  1. 提交 Issue（推荐）- 详细描述问题或需求
  2. 添加作者微信（见文末） - 备注"WordCopilot"并说明来意

作者会在空闲时间处理 Issue 中的 Bug 修复和功能新增。

🚀 商业化使用说明

您可以自由基于本项目开发商业版本，无需告知作者，也无需付费。

  • ✅ 允许基于此代码开发商业产品
  • ✅ 允许修改、二次开发、闭源
  • ✅ 无需向作者支付任何费用
  • ✅ 无需告知作者商业化用途

💡 开源初衷

作者开源此插件的目的是：

  • 为社会增加一些就业岗位
  • 帮助在岗开发人员更好地完成工作任务
  • 为有需要的个人和企业提供免费的技术方案

因此本项目永久免费，不会商业化收费。 作者会尽最大努力持续迭代更新，除非出现更优秀的替代开源方案。

许可协议

本项目采用 MIT License 开源。MIT 是宽松、商业友好的许可证，允许：

  • ✅ 复制、修改、再发布
  • ✅ 商业使用（无需告知作者）
  • ✅ 私有使用和闭源修改
  • ⚠️ 唯一要求：在分发时保留版权与许可声明

简而言之：您可以用它做任何事，包括开发商业产品，完全免费。

特别致谢

张强 —— 我的伯乐与指路人。在我犹疑与摸索的阶段，他在关键节点给予了无价的信任、指引与鼓励，让这个项目能够生根发芽、一路走到今天。将这部分能力以开源的方式分享出去，也是在致敬这份托举与成全。

开源组件与许可

本项目依赖以下第三方组件（按字母序），感谢开源社区的贡献。具体许可以各项目官方仓库为准：

致谢

感谢所有热心的使用者、贡献者与朋友们的支持与建议；社区的反馈让项目不断变得更好。

联系与反馈

📮 问题反馈方式

本项目为「WordCopilot」的部分功能开源版，作者精力有限（经常加班），维护不承诺即时响应。

如遇 Bug 或有功能需求，请优先选择：

  1. 提交 Issue（推荐）

    • 附上详细的复现步骤、截图、日志文件
    • 说明您的环境（Windows版本、Word版本、.NET版本）

  2. 添加作者微信

    • 备注"WordCopilot + 问题简述"
    • 仅用于严重问题或紧急咨询

⚠️ 请勿提交 PR：作者对 GitHub 操作不熟，暂时无法及时处理代码合并。建议通过 Issue 或微信说明需求，作者会在空闲时完成开发。

💖 如果觉得有用

  • ⭐ 给个 Star 支持一下
  • 📢 推荐给有需要的朋友
  • 💬 在 Issue 中分享您的使用体验

作者微信

添加时请备注“WordCopilot”，仅严重问题或合作沟通
作者微信

📌 最后说明

这个项目凝聚了作者的心血，开源出来是希望能帮助到更多人。虽然作者工作繁忙，但会尽力维护和改进。

致使用者：

  • 如果这个工具对您有帮助，欢迎点个 Star ⭐
  • 如果您发现了问题，请通过 Issue 或微信告诉我
  • 如果您想基于此开发商业产品，完全没问题，祝您成功 🎉

致开发者：

  • 这个项目采用 MIT 协议，您可以自由使用、修改、商业化
  • 不需要告知我，不需要付费，不需要分享收益
  • 如果您愿意，可以在您的产品中注明原项目出处（不强制）

让技术造福更多人，这就是开源的意义。💪

About

这是一个基于VSTO开发的Microsoft Office Word的AI对话插件，也兼容WPS Office

github.com/CoderZzxy/WordCopilotChat

Resources

Readme

License

MIT license
Activity

Stars

19 stars

Watchers

0 watching

Forks

4 forks
Report repository

Releases 4

0.0.4 Latest
Feb 11, 2026
+ 3 releases

Packages

 
 
 

Contributors 1

Languages