# astrbot_plugin_office_assistant > 这是一个为 AstrBot 设计的 Office 助手插件。它赋予大语言模型（LLM）直接操作文件的能力，支持读取并分析多种格式文件，以及生成 Office 文档和office互转pdf的功能 - **URL**: https://www.freshcrate.ai/projects/astrbot_plugin_office_assistant - **Author**: Clhikari - **Category**: AI Agents - **Latest version**: `v1.9.1` (2026-05-31) - **License**: AGPL-3.0 - **Source**: https://github.com/Clhikari/astrbot_plugin_office_assistant - **Language**: Python - **GitHub**: 24 stars, 2 forks - **Registry**: github - **Tags**: `astrbot`, `astrbot-plugin`, `excel`, `flies`, `llm-agent`, `office365`, `pdf`, `ppt`, `python` ## Description 这是一个为 AstrBot 设计的 Office 助手插件。它赋予大语言模型（LLM）直接操作文件的能力，支持读取并分析多种格式文件，以及生成 Office 文档和office互转pdf的功能 ## Recent releases | Version | Date | Urgency | Changes | | --- | --- | --- | --- | | `v1.9.1` | 2026-05-31 | High | ### 新增 - 新增会话级图片资源池，用户上传图片后可注册为 `images/...` 受管引用，供 Word/PPT 文档工作流安全使用。 - 新增 `/doc help`，可查看会话文件命令说明。 - 新增 `/img help`，可查看图片资源池命令说明。 - 新增 `/img add [备注]`，支持把当前消息图片或待注册缓存中的图片写入资源池。 - 新增 `/img list`，可查看当前会话已注册图片。 - 新增 `/img active`，可查看本轮文档/PPT 工作流允许直接使用的活动图片。 - 新增 `/img use <序号或引用...\|all>`，可手动选择一张或多张活动图片。 - 新增 `/img note <序号或引用> <备注>`，可修改图片备注。 - 新增 `/img clear [序号或引用\|all]`，可清理当前会话图片资源。 - 新增当前活动图片集机制：`/img add` 成功后自动把本次注册图片设为活动图片，文档/PPT 工作流默认只使用活动图片。 - Word 结构化文档新增 `image` block 渲染，支持把资源池图片嵌入 `.do | | `v1.8.0` | 2026-05-18 | High | ### 新增 - `write_rows` 新增 `number_formats` 选项，支持按列设置 Excel 数字格式（货币、百分比、日期等）。 - 条件格式场景检测与 domain hint 注入，引导模型使用 `CellIsRule`/`FormulaRule` 而非静态 PatternFill。 ### 修复 - 修复 exporter 对超出数据范围的列创建空单元格导致文件膨胀的问题。 - 修复 `number_formats` 验证器对非字符串值给出模糊错误提示的问题。 - 修复 `number_formats` 在 `start_row > 1` 时错误格式化表头行的问题。 - 修复 Excel 公式质量检查将 Sheet 名引用中的单引号误判为文本字面量的问题。 - 放宽 `execute_excel_script` 路由硬约束，允许编辑已有工作簿的纯值场景。 - 修复 Sheet 名引用正则未匹配引号与感叹号之间可选空格的问题。 ### 优化 - 重构 Excel 脚本提示词：精简 helper 列表，突出 `save_output_workbook` | | `v1.7.1-preview` | 2026-05-13 | High | ### 新增 - 新增 `permission_settings.allow_all_users` 配置，可在受信环境中跳过管理员校验，让所有用户直接使用插件功能。 ### 优化 - `write_rows` schema 兼容性优化：通过运行时 helper 强制保证 cell 类型一致性，适配严格 schema 校验的模型 provider。 - `add_blocks` 在上游调度器把参数降级为空 kwargs 时，现在会打一条 warning 日志并返回明确的拆分指引，便于运维关联上游 JSON 解析问题。 ### 修复 - 修复 `add_blocks` 收到空参数时静默失败的问题，现在直接返回可操作的拆分指引，模型可据此修正调用策略。 - 修复 `allow_all_users` 权限设置在 review 反馈后的若干边界问题。 | | `v1.7.0-preview` | 2026-05-01 | High | ### 新增 - 新增 Excel 脚本执行链路，支持在 AstrBot runtime / sandbox 环境中运行受控脚本来生成或修改工作簿。 - 新增 Excel 脚本模板和路由能力，可按请求类型在读取现有文件、workbook 会话和脚本执行之间选择更合适的流程。 - 新增 Excel 脚本结果质量检查，生成文件存在明显结构问题或质量提示时，会把 `requires_review` 和 `quality_warnings` 返回给模型。 - 新增 `allow_local_excel_script` 配置。`computer_use_runtime=local` 时可单独开放 `execute_excel_script`，不需要关闭 `auto_block_execution_tools`，通用 shell/python 执行工具仍会被隐藏。 - 新增 `add_blocks` 公共 schema 测试辅助函数，方便稳定断言 provider 兼容字段。 - 新增 `technical_resume` 模板的 `auto_page_break` 支持，可让模板页自行附带分页 | | `v1.6.3-beta` | 2026-04-19 | High | ### 新增 - 新增会话式 Excel 工作簿流程，支持 `create_workbook -> write_rows -> export_workbook` 分步创建报表，适合多 sheet、分批写入后再导出 `.xlsx`。 - 新增 `workbook_id` 续写能力，上一轮创建的工作簿可以在后续对话里继续补写和导出。 - 新增面向 Excel 报表场景的工作簿会话管理，支持在对话里连续维护同一份报表，而不是每次重新生成整份文件。 ### 优化 - Excel 相关提示会更严格地区分“新建报表”“继续写入”“读取现有文件”“转换为其他格式”这几类请求，减少误用工具。 - workbook 导出现在支持在工作区内使用相对子目录组织输出，例如 `reports/q1/final-report.xlsx`。 | | `v1.6.2` | 2026-04-16 | High | ### 新增 - 段落富文本支持行内超链接，可直接插入可点击的外部链接和 mailto 链接。 - 段落与表格单元格支持更完整的富文本样式控制，包括字体、字号缩放、颜色、下划线、删除线、粗体、斜体等。 - 新增段落边框与表格单元格边框控制，能更方便地做分隔线、重点标注和局部描边。 ### 改进 - 旧格式的标题、颜色字段和表格单元格写法会自动兼容到新结构，已有调用方式更容易直接使用。 - 长表格分页和表头重复显示的稳定性进一步提升，跨页版面更自然。 ### 修复 - 修复 create_document 生成的长 document_id 容易在对话里被写错、漏写或改写，导致续写、定稿、导出中断的问题；现在改为更短的顺- 序编号，例如 doc-1、doc-2。([#52](https://github.com/Clhikari/astrbot_plugin_office_assistant/issues/52)) - 修复富文本表格单元格在字号、默认样式和首列加粗继承上的显示问题，表格正文样式更稳定。 - 修复段落和表格边框在不同配置下处理不一致的 | | `v1.6.2` | 2026-04-16 | High | ### 新增 - 段落富文本支持行内超链接，可直接插入可点击的外部链接和 mailto 链接。 - 段落与表格单元格支持更完整的富文本样式控制，包括字体、字号缩放、颜色、下划线、删除线、粗体、斜体等。 - 新增段落边框与表格单元格边框控制，能更方便地做分隔线、重点标注和局部描边。 ### 改进 - 旧格式的标题、颜色字段和表格单元格写法会自动兼容到新结构，已有调用方式更容易直接使用。 - 长表格分页和表头重复显示的稳定性进一步提升，跨页版面更自然。 ### 修复 - 修复 create_document 生成的长 document_id 容易在对话里被写错、漏写或改写，导致续写、定稿、导出中断的问题；现在改为更短的顺- 序编号，例如 doc-1、doc-2。([#52](https://github.com/Clhikari/astrbot_plugin_office_assistant/issues/52)) - 修复富文本表格单元格在字号、默认样式和首列加粗继承上的显示问题，表格正文样式更稳定。 - 修复段落和表格边框在不同配置下处理不一致的 | | `v1.6.2` | 2026-04-16 | High | ### 新增 - 段落富文本支持行内超链接，可直接插入可点击的外部链接和 mailto 链接。 - 段落与表格单元格支持更完整的富文本样式控制，包括字体、字号缩放、颜色、下划线、删除线、粗体、斜体等。 - 新增段落边框与表格单元格边框控制，能更方便地做分隔线、重点标注和局部描边。 ### 改进 - 旧格式的标题、颜色字段和表格单元格写法会自动兼容到新结构，已有调用方式更容易直接使用。 - 长表格分页和表头重复显示的稳定性进一步提升，跨页版面更自然。 ### 修复 - 修复 create_document 生成的长 document_id 容易在对话里被写错、漏写或改写，导致续写、定稿、导出中断的问题；现在改为更短的顺- 序编号，例如 doc-1、doc-2。([#52](https://github.com/Clhikari/astrbot_plugin_office_assistant/issues/52)) - 修复富文本表格单元格在字号、默认样式和首列加粗继承上的显示问题，表格正文样式更稳定。 - 修复段落和表格边框在不同配置下处理不一致的 | | `v1.6.2` | 2026-04-16 | Medium | ### 新增 - 段落富文本支持行内超链接，可直接插入可点击的外部链接和 mailto 链接。 - 段落与表格单元格支持更完整的富文本样式控制，包括字体、字号缩放、颜色、下划线、删除线、粗体、斜体等。 - 新增段落边框与表格单元格边框控制，能更方便地做分隔线、重点标注和局部描边。 ### 改进 - 旧格式的标题、颜色字段和表格单元格写法会自动兼容到新结构，已有调用方式更容易直接使用。 - 长表格分页和表头重复显示的稳定性进一步提升，跨页版面更自然。 ### 修复 - 修复 create_document 生成的长 document_id 容易在对话里被写错、漏写或改写，导致续写、定稿、导出中断的问题；现在改为更短的顺- 序编号，例如 doc-1、doc-2。([#52](https://github.com/Clhikari/astrbot_plugin_office_assistant/issues/52)) - 修复富文本表格单元格在字号、默认样式和首列加粗继承上的显示问题，表格正文样式更稳定。 - 修复段落和表格边框在不同配置下处理不一致的 | | `v1.6.2` | 2026-04-16 | Medium | ### 新增 - 段落富文本支持行内超链接，可直接插入可点击的外部链接和 mailto 链接。 - 段落与表格单元格支持更完整的富文本样式控制，包括字体、字号缩放、颜色、下划线、删除线、粗体、斜体等。 - 新增段落边框与表格单元格边框控制，能更方便地做分隔线、重点标注和局部描边。 ### 改进 - 旧格式的标题、颜色字段和表格单元格写法会自动兼容到新结构，已有调用方式更容易直接使用。 - 长表格分页和表头重复显示的稳定性进一步提升，跨页版面更自然。 ### 修复 - 修复 create_document 生成的长 document_id 容易在对话里被写错、漏写或改写，导致续写、定稿、导出中断的问题；现在改为更短的顺- 序编号，例如 doc-1、doc-2。([#52](https://github.com/Clhikari/astrbot_plugin_office_assistant/issues/52)) - 修复富文本表格单元格在字号、默认样式和首列加粗继承上的显示问题，表格正文样式更稳定。 - 修复段落和表格边框在不同配置下处理不一致的 | ## Dependency audit - **Score**: 86/100 - **Total deps**: 11 - **Resolved**: 10 - **Unresolved**: 1 - **License conflicts**: 0 - **Warnings**: 6 - **Scanned**: 2026-05-25 ## Citation - HTML: https://www.freshcrate.ai/projects/astrbot_plugin_office_assistant - Markdown: https://www.freshcrate.ai/projects/astrbot_plugin_office_assistant.md - Dependencies JSON: https://www.freshcrate.ai/api/projects/astrbot_plugin_office_assistant/deps _Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._