A community-driven registry for Claude, Cursor, Windsurf, Cline & more. Not affiliated with Anthropic.
Are you the author? Sign in to claim
这是一个为 AstrBot 设计的 Office 助手插件。它赋予大语言模型（LLM）直接操作文件的能力，支持读取并分析多种格式文件，以及生成 Office 文档和office互转pdf的功能
让你的聊天bot能够生成office文件
|
|
enable_features_in_group=false），启用后需要 @ 机器人才暴露工具。/pdf_status 和 /pdf状态。/doc 系列命令更顺手。astrbot_execute_shell 等执行类工具。create_document → add_blocks → finalize_document → export_document，支持封面、正文、列表、表格、图片、目录等。read_workbook 读已有表，create_workbook → write_rows → export_workbook 新建简单表，execute_excel_script 处理公式、图表、条件格式和复杂编辑。sandbox 可显示 execute_excel_script；local 表示脚本会在机器人本机运行，默认隐藏，需要打开 allow_local_excel_script；none 不能执行脚本。读表和 workbook 三步链不受影响。通过 AstrBot 插件管理器安装，Python 依赖会自动装好。
Word 导出走 JS 渲染器，机器上需要 Node.js（建议 18+），先确认 node -v 能跑。
第一次部署或拉了新代码后，在插件目录里构建一次：
cd word_renderer_js
npm install
npm run build
构建完会生成 word_renderer_js/dist/cli.js，没这个文件 Word 工具链没法导出。
/fileinfo：看插件运行状态和配置/pdf_status（或 /pdf状态）：看 PDF 转换是否可用.txt 或 .md 给机器人，让它读取并总结.xlsx 让机器人先读表；要公式、图表或条件格式时，让它用脚本生成 Excel在 AstrBot 管理面板中设置。常用的几项：
| 配置项 | 默认值 | 什么情况下改 |
|---|---|---|
enable_features_in_group | false | 要在群聊里用插件 |
require_at_in_group | true | 群聊里不想强制 @ |
allow_all_users | false | 可信环境里不想逐个维护白名单 |
enable_docx_image_review | true | 不需要模型读 Word 里的图片 |
auto_block_execution_tools | true | 建议保持开启，用来隐藏通用 shell/python 执行工具 |
allow_local_excel_script | false | computer_use_runtime=local 时开放 execute_excel_script |
allow_external_input_files | false | 要读工作区外的文件 |
max_excel_preview_rows | 2000 | Excel 很大，想减少每个 Sheet 的预览行数 |
max_excel_preview_chars | 200000 | Excel 单个 Sheet 文本太长 |
max_excel_preview_sheets | 0 | 只想预览前几个 Sheet；0 表示不限 |
enable_pdf_conversion | true | 不需要 Office/PDF 转换 |
auto_delete_files | true | 想保留生成的文件 |
word_style_settings.default_font_name | 空 | 想统一改 Word 默认字体，比如 Arial |
trigger_settings）| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
群聊需要@/引用机器人 (require_at_in_group) | bool | true | 群聊中 @ 或引用机器人时才暴露文件工具 |
群聊启用插件功能 (enable_features_in_group) | bool | false | 关了的话群聊里插件完全不生效 |
自动屏蔽 shell/python 工具 (auto_block_execution_tools) | bool | true | 插件生效时隐藏 astrbot_execute_shell、astrbot_execute_python、astrbot_execute_ipython |
允许本地 Excel 脚本工具 (allow_local_excel_script) | bool | false | computer_use_runtime=local 时允许 execute_excel_script 出现，不影响 auto_block_execution_tools 对通用执行工具的屏蔽 |
发送文件时@用户 (reply_to_user) | bool | true | 发文件时是否 @ 发起人 |
permission_settings）| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
允许所有用户使用 (allow_all_users) | bool | false | 开启后所有用户都能通过用户权限检查；群聊开关、群聊 @ 限制和执行类工具屏蔽仍按各自配置生效 |
用户白名单 (whitelist_users) | list | [] | 允许使用插件的用户 ID，留空则仅管理员可用 |
feature_settings）| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
启用 Office 文件生成 (enable_office_files) | bool | true | 是否允许 create_office_file |
启用 PDF 转换 (enable_pdf_conversion) | bool | true | 是否允许 Office ↔ PDF 转换（需系统依赖） |
file_settings）| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
最大文件大小MB (max_file_size_mb) | int | 20 | 读取和发送的大小上限 |
发送后自动删除文件 (auto_delete_files) | bool | true | 发完就删，关了就留在工作区 |
upload_session_settings）| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
文件合并等待时间秒 (message_buffer_seconds) | float | 4 | 上传文件后等一会儿，把同一波的文件合在一起 |
图片等待 /img add 时间秒 (image_llm_delay_seconds) | float | 3 | 上传图片后短暂等待 /img add；超时只继续当前 LLM 请求，图片仍在上传会话 TTL 内可注册 |
旧流程文本缓存时间秒 (recent_text_ttl_seconds) | int | 20 | 主要影响"文件和文字一起进来"的老用法，一般不用动 |
上传文件保留时间秒 (upload_session_ttl_seconds) | int | 600 | 上传完文件后在当前会话里保留多久，供 /doc 命令使用 |
read_settings）| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
允许外部绝对路径 (allow_external_input_files) | bool | false | 放开后 read_file 和转换工具可以访问工作区外路径，删除不受影响 |
Excel预览最大行数 (max_excel_preview_rows) | int | 2000 | 读取 Excel 时，每个 Sheet 最多展示多少行。0 表示不限 |
Excel预览最大字符数 (max_excel_preview_chars) | int | 200000 | 读取 Excel 时，每个 Sheet 最多展示多少字符。0 表示不限 |
Excel预览最大Sheet数 (max_excel_preview_sheets) | int | 0 | 读取 Excel 时最多展示多少个 Sheet。0 表示不限 |
启用 Word 图片理解 (enable_docx_image_review) | bool | true | 读 .docx 时把嵌入图片注入上下文，关了就按纯文本读 |
Word图片注入大小上限MB (max_inline_docx_image_mb) | int | 2 | 单张图超过这个大小就跳过 |
Word图片最多注入张数 (max_inline_docx_image_count) | int | 3 | 最多注入几张图到上下文 |
preview_settings）| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
启用预览图 (enable) | bool | true | 发 Office/PDF 时带首页预览图 |
预览图分辨率 (dpi) | int | 150 | 推荐 100~200 |
word_style_settings）| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
正文默认字体 (default_font_name) | string | 空 | 模型没显式指定字体时使用，比如 Arial |
标题默认字体 (default_heading_font_name) | string | 空 | 留空时跟随正文默认字体 |
表格默认字体 (default_table_font_name) | string | 空 | 留空时跟随正文默认字体 |
代码默认字体 (default_code_font_name) | string | 空 | 留空时继续使用内置默认值 |
| 工具名 | 干什么 |
|---|---|
read_file | 读文本、代码、Office、PDF 的内容 |
read_workbook | 读 Excel，按 Sheet 返回内容 |
create_office_file | 生成 Word / Excel / PPT（Word 建议走四步链） |
create_document | 新建 Word 草稿 |
add_blocks | 往草稿里加内容 |
finalize_document | 锁定草稿 |
export_document | 导出 .docx，自动发给用户 |
create_workbook | 新建 Excel 工作簿草稿 |
write_rows | 向工作簿写入行数据 |
export_workbook | 导出 .xlsx，自动发给用户 |
execute_excel_script | 用受控 Python 脚本生成或修改 Excel |
convert_to_pdf | Office → PDF |
convert_from_pdf | PDF → Word 或 Excel |
| 命令 | 别名 | 干什么 |
|---|---|---|
/list_files | /file_ls, /文件列表 | 看工作区里的 Office 文件 |
/delete_file <文件名> | /file_rm, /删除文件 | 删工作区里的文件 |
/fileinfo | 无 | 看运行状态和配置 |
/pdf_status | /pdf状态 | 看 PDF 转换是否可用 |
/doc help | 无 | 查看 /doc 命令帮助 |
/doc list | 无 | 看当前会话里的上传文件 |
/doc clear [文件ID] | 无 | 清空会话文件，或只删一个 |
/doc use [文件ID...] 你的要求 | 无 | 选文件继续处理 |
/img help | 无 | 查看 /img 命令帮助 |
/img add [备注] | 无 | 注册已上传图片到当前会话图片资源池 |
/img list | 无 | 查看当前会话已注册图片 |
/img active | 无 | 查看本轮文档/PPT 可直接使用的活动图片 |
| `/img use <序号或引用... | all>` | 无 |
/img note <序号或引用> <备注> | 无 | 修改图片备注 |
| `/img clear [序号或引用 | all]` | 无 |
/doc 用法/doc 用于在会话内管理已上传文件，适合先上传文件、再选择其中一份或多份继续处理。文件按"平台 + 会话 + 用户"隔离，群里其他人的文件不会混进来。具体命令格式可用 /doc help 查看。
/img 用法图片资源池用于把用户上传的图片安全地写入 Word/PPT。模型只能使用 images/... 形式的受管引用，不接受本机绝对路径。具体命令格式可用 /img help 查看。
说明：
/img add 成功后，本次注册的图片会自动成为当前活动图片。.docx .xlsx .pptx .doc .xls .ppt.pdf.txt .md .log .rst .json .yaml .yml .toml .xml .csv .html .css .sql .sh .bat .py .js .ts .jsx .tsx .c .cpp .h .java .go .rs.docx .xlsx .pptx
| 方向 | 依赖 | 说明 |
|---|---|---|
| Office → PDF | Windows: docx2pdf / pywin32（要装 Office）；或 LibreOffice | Word / Excel / PPT 都能转 |
| PDF → Word | pdf2docx | 文本型 PDF 效果好一些 |
| PDF → Excel | tabula-py（要 Java）或 pdfplumber | 抽表格为主，复杂版面会丢东西 |
[!NOTE] Python 包自动装。下面是系统层面需要自己装的东西。
| 平台 | 读旧 .doc | Office → PDF | 怎么选 |
|---|---|---|---|
| Windows | pywin32 | Word 用 docx2pdf，Excel/PPT 用 pywin32 或 LibreOffice | 有 Office 就用 docx2pdf + pywin32，没有就装 LibreOffice |
| Linux | antiword | LibreOffice | 装 LibreOffice 就行 |
| macOS | antiword | LibreOffice | brew install |
[!TIP] 不确定缺什么，跑
/pdf_status就知道了。
# 旧格式读取 + win32com 转换
pip install pywin32
# Word 转 PDF
pip install docx2pdf
也可以装 LibreOffice 当跨平台转换后端：https://www.libreoffice.org/download/
# 读 .doc
apt install antiword
# Office -> PDF
apt install libreoffice-writer libreoffice-calc libreoffice-impress
# 读 .doc
brew install antiword
# Office -> PDF
brew install --cask libreoffice
[!TIP] 装完记得重启 AstrBot。
写进 Dockerfile，镜像重建也不丢：
RUN apt-get update && apt-get install -y \
antiword \
libreoffice-writer libreoffice-calc libreoffice-impress \
&& rm -rf /var/lib/apt/lists/*
docker exec -it <容器名> bash
apt-get update
apt-get install -y antiword
apt-get install -y libreoffice-writer libreoffice-calc libreoffice-impress
容器删了重建得重装。
allow_all_users 省去逐个维护白名单。enable_features_in_group 默认 false，打开它。如果还需要去掉 @ 限制，把 require_at_in_group 也关了。
查白名单。留空只有管理员能用。
三种可能：preview_settings.enable 关了；缺 pymupdf；Office 预览目前只支持 Windows 上的 Word。
execute_excel_script？sandbox runtime 下会显示。local runtime 下默认隐藏；如果确认机器人本机可以运行 Excel 脚本，把 trigger_settings.allow_local_excel_script 改成 true，并保持 auto_block_execution_tools=true。
没有脚本运行环境时，可以用 read_workbook 读表，或者用 workbook 三步链生成简单 .xlsx。
PDF → Excel 是抽表格的，扫描件、跨页表格、复杂版面都容易出问题。换一份干净的 PDF，或者装 Java + tabula-py 试试。
跑 /pdf_status 看缺什么。Windows 上 Word 要 Office + docx2pdf，Excel/PPT 要 Office + pywin32；Linux/macOS 装 LibreOffice。
create_workbook -> write_rows -> export_workbook.xlsx/.xls 读取，支持按 Sheet 输出内容execute_excel_script遇到问题或者有想法，来群里聊：QQ 群 1072198212
AGPL-3.0
项目架构见 docs/architecture.md。
欢迎提 Issue 和 PR。涉及行为变更的话附上复现步骤和预期结果。
Pocket Flow: Codebase to Tutorial
A Comprehensive Benchmark to Evaluate LLMs as Agents (ICLR'24)
💻 A curated list of papers and resources for multi-modal Graphical User Interface (GUI) agents.
npx CLI installing 100+ agents, commands, hooks, and integrations in one command