mcpField
K
KitchenSink4Word

KitchenSink4Word

本地服务
kitchensink4.ai生产力134 天前更新

关于 KitchenSink4Word

KitchenSink4Word 是适用于 Windows 的 MCP 服务,可通过本地 MCP 客户端读取和编辑 .docx 文件。它支持修订、引文、模板,以及在 Microsoft Word 中实时编辑。

主要功能

  1. 01读取和编辑 Word 文档
  2. 02创建和审阅修订
  3. 03管理引文和参考书目
  4. 04填写模板并执行邮件合并
  5. 05在 Word 中实时编辑
  6. 06备份并验证更改

适用场景

  1. 01在 Word 打开的状态下修改报告
  2. 02审阅并处理修订
  3. 03为文档准备引文和参考书目
  4. 04使用模板或邮件合并整理文档

MCP 相关

向本地 MCP 客户端提供 Word 文档读取和编辑工具。安装 Microsoft Word 后,也可实时修改已打开的文档。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"nometalalchemist-kitchensink4word": {
"command": "uvx",
"args": [
"kitchensink4word"
]
}
}
}
启动命令uvx kitchensink4word

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
pypikitchensink4word2.1.3

工具

29

收录的工具列表 · 更新于 2 周前

参数类型必填说明
titleany否
file_pathstring是

详细介绍

README 配图 KitchenSink4Word

Tests PyPI License: AGPL-3.0

使用 AI 助手编辑 Word 文档:修订跟踪、引用、模板,以及对已打开文档进行实时编辑。

你的 AI 在 Word 中可执行 231 项操作;每次更改前都会创建备份。如果你的请求可能对应多个位置,它会先提问,而不是猜测。

KitchenSink4Word 是一款 MCP 服务,可让 Claude Code、Codex CLI、Copilot CLI、Claude Desktop 和其他本地 MCP 客户端读取和编辑 .docx 文件。它也能在 Microsoft Word 中打开文档时进行编辑,让你实时查看更改。这是免费的社区版,采用 AGPL-3.0 许可。

产品页面 · llms.txt · 更新日志

平台: Windows。即使未安装 Word,也可以编辑文件。实时编辑以及由 Word 驱动的功能(PDF 导入和导出、文档比较、校对、字段刷新)需要 Microsoft Word。

安装

此软件包需要 Python 3.12 或更高版本。请在 PowerShell 或终端中运行以下命令,不要在 AI 聊天中运行。

Claude Code 或 Codex CLI。 安装 uv,运行对应应用的命令,然后启动新会话:

claude mcp add word -s user -- uvx kitchensink4word
codex mcp add word -- uvx kitchensink4word

Claude Desktop。 安装 uv 并重启 Claude Desktop。从最新版本下载 .mcpb 文件,然后打开 Settings > Extensions > Advanced settings > Install extension,并选择该文件。首次启动时会下载 Python 软件包,因此需要网络连接。

其他任何本地 MCP 客户端。 将 uvx 用作命令,将 kitchensink4word 用作参数;也可以安装软件包,并将 kitchensink4word 作为服务命令运行:

pip install kitchensink4word

单独安装软件包并不会将其连接到 AI 应用;请在客户端设置中将其添加为本地 MCP 服务。

功能

  • 在 Word 中打开报告期间进行修订,每项编辑都会在应用后立即显示。
  • 读取、接受和拒绝修订跟踪,按修订跟踪方式写入编辑,并处理审阅者评论。
  • 填写模板、将章节文件合并为一个文档,以及执行邮件合并。
  • 创建和设置表格、列表、标题、分节和页面布局的格式。
  • 插入引文、参考书目、脚注、尾注、题注和交叉引用,包括 Zotero 文库引文。
  • 在交付文件前检查格式、无障碍性和文档结构。
  • 比较文档的两个版本、对选定文本进行删改,并通过 Word 导入或导出 PDF。

此服务总共提供 10 个工具中的 115 项操作;如果按操作可执行的每种操作分别计数(例如,每种注释或表格更改),则共计 231 项。启动时,整个工具列表约占用 AI 工作记忆中的 9.2k 个 token。数据来自 scripts/measure_surface.py 和 scripts/count_operations.py。

亮点

  • 跨合并单元格操作表格列。 当表格包含横向或纵向合并的单元格时,插入或删除列也能正常工作。
  • 一次调用批量编辑。 二十处单元格编辑只需调用一次 set_cells,而不是往返调用二十次。
  • 真正的修订跟踪。 编辑工具接受 track 和 author 参数,并生成可供接收者接受或拒绝的 Word 修订。如果未指定作者,变更和评论会使用你的 Office 用户名签署,也就是你自己的 Word 使用的名称;结果中的 author_source 会说明名称的来源。若要在一次调用中以助手的身份署名,请传入 author="assistant",署名将显示为“AI Assistant via KS4Word”。
  • 原生 Word 比较。 com_multi_document 搭配 action="compare" 可生成两个版本之间的修订对比。
  • 杜绝文件损坏。 保存采用原子操作并经过验证;每次更改前都会备份旧版本;调用未触及的内容(公式、文本框、内容控件)会逐字节保留。若文件已在 Word 中打开,系统会明确提示并拒绝操作,而不是卡住。
  • 跨拆分文本运行查找和替换。 即使 Word 将文本拆分成多个文本运行,也能正确匹配,并保留每个字符的格式。用户正则表达式的执行设有超时限制。
  • 精准定位编辑内容。 如果匹配文本出现多次,系统会拒绝操作并列出所有候选项,因此绝不会悄无声息地编辑错误段落;拒绝时还会提示下一步应调用什么工具。

十个工具与上下文开销

服务会在第一条消息中列出十个工具,无需启用任何工具。除 word_help 外,每个工具都需要 op(要执行的操作)和 args(操作参数,包括 .docx 的 file_path)。word_help 会返回任意操作的参数和一个完整示例;操作未定义的参数会被拒绝,而不是忽略。Token 数量统计客户端收到的完整 tools/list 条目,数据来自 scripts/measure_surface.py。

工具操作数约计 token 数涵盖内容
word_read241,400读取文本、带锚点的文档视图、提纲和表格;查找文本;列出元素;读取样式、批注、修订、页眉和页脚、属性及保护状态;验证和诊断;字数统计和结构化差异;引用检查;get_workflows、get_server_info 和 Word 状态
word_edit91,103插入、更改和删除段落;查找并替换跨多个分离文本片段的内容;使用 apply_edits 批量编辑;插入分隔符和锚点;执行经验证的内容隐去
word_format6620样式、字符和段落格式、标题级别和出版格式
word_structure151,025页眉和页脚、分节、页码、列表和编号、表格(创建、编辑、重构、排序、导入)、章节页眉和移动分节
word_media12906图片、图表、公式、文本框、超链接、域、内容控件和表单字段
word_review7787线程式批注;接受和拒绝修订;在关闭的文件中开启或关闭修订;根据较早版本标记在关闭修订时所做的编辑;匿名化以供同行评审并还原;准备提交
word_references131,032脚注和尾注、题注、目录和图表目录、索引条目、书签、交叉引用、Word 原生引用和参考书目、Zotero 搜索和引用、引用样式转换
word_document151,030新建和复制文档、备份、属性和嵌入字体、插入和拆分文档、模板和邮件合并、前置内容、保护、水印、无障碍修复、表格导出
word_app141,070操作本地 Word:保存已在 Word 中打开的文档、实时编辑、切换修订、刷新域、导入和导出 PDF、比较和合并、校对、可读性检查、打开后清理验证。需要 Windows 和 Word。还可按需更新服务(update_now),以及开启或关闭更新通知(update_notices)
word_help0213任意操作的参数和完整示例,以及 location 对象说明
共十个1159,186启动时一次性加载;之后无需启用任何工具

要获取操作方案,请让 AI 调用 get_workflows。它会列出 13 项任务,并为每个步骤提供适用的工具和操作。对于 Claude Code 等首次使用时才加载工具架构的客户端,直到调用工具前,开销几乎为零。服务自身的指令会在以上数字基础上增加约 500 个 token。

希望使用范围更窄的服务的管理员可以设置 KS4W_READ_ONLY=1,此时只会列出读取操作;也可以在 KS4W_FORBID 中列出要移除的工具或操作(见 Configuration)。移除的内容不再计入开销。

**减少权限提示:**在 Claude Desktop 中,针对该服务的工具权限,将只读工具设为“始终允许”。这些工具无法更改任何内容。编辑工具则保持“询问”。

安全模型

  • 每次更改已关闭的文件前,都会将当前版本复制到文档旁边隐藏的 .ks4w-backups/ 文件夹中。每份文档保留两个副本:prev.docx(最近一次更改前的状态)和 anchor.docx(会话开始时的状态;闲置一小时后刷新)。无论你进行多少次编辑,存储空间都维持在每份文档约两个副本。manage_backups 可列出、还原和清除这些副本,而且还原操作本身也可以撤销。
  • 在 Word 中打开的文档,其编辑内容不属于此备份系统的范围。打开的文档由 Word 自带的自动恢复和撤销功能保护。
  • 保存操作是原子的,并会经过验证。如果操作失败,原始文件会保持原样。
  • 对同一文件的更改会按顺序执行,无论是在同一服务内还是跨服务进程,因此并行调用不会相互覆盖。
  • 删除包含脚注引用的内容时,会移除失去引用的脚注;validate 会双向检查完整性。删除段落时,如果所选范围会截断字段(例如目录)或意外移除分节符,操作就会被拒绝。
  • 请勿将 .ks4w-backups/ 纳入云同步(OneDrive、Dropbox、Google Drive)。备份文件会随每次编辑而更改,同步客户端可能会持有锁,从而拖慢保存。
  • 遵守保护设置。 不会绕过文档的编辑限制或文件的 Windows 只读属性进行编辑:写入操作会以 PROTECTED 为由拒绝,文件保持原样。在受保护的文档上,set_document_protection 和 manage_backups 仍可使用,因此你可以解除限制或还原备份。
  • 破坏性操作前创建快照。 redact_text、resolve_revisions、prepare_for_submission、anonymize_for_review 和 set_document_protection 会保留文件操作前状态的标记快照,manage_backups 可按标签还原快照。
  • 拒绝猜测。 对含糊不清的目标会予以拒绝,并列出所有候选项;对未知样式、键或单元格地址会明确指出并拒绝;若调用会删除页眉中的图片或表格,也会予以拒绝,除非你明确同意。每次拒绝都会返回结构化信息({ok: false, error: {code, message, hint}}),并指出下一步应调用的工具。
  • Word 由你掌控。 加密文件会在服务器启动隐藏的 Word 之前被拒绝,因此密码对话框不会出现在你的桌面上。服务器仅在能证明某个 Word 进程是由自身启动时才会结束该进程,绝不会仅凭程序名称判断;如果调用超出时限,会返回 TIMEOUT,而文件编辑操作不会保存任何内容。
  • 无法保证脱敏和匿名化完全有效。 redact_text 会从所有可安全处理的位置移除你指定的文本,然后重新读取已保存的文件并报告任何残留内容。anonymize_for_review 会遮蔽自引文和作者元数据,并标记其余内容供你检查。两者都无法识别图片或扫描件中的文字,也无法识别你未提供的姓名,例如姓名首字母或昵称。分享或提交前,请自行检查所有敏感内容。对于法律或受监管场景下的脱敏,请使用专用工具处理最终 PDF。

隐私

该服务在你的计算机上运行。KitchenSink4AI 不会接收你的文件或使用数据。你的 AI 应用可能会根据自身的设置和条款,将提示词、文件内容和工具结果发送给其服务提供商。下文所述的更新检查每周最多联系 PyPI 一次,且仅发送软件包名称和已安装版本。选择“立即更新”会从 PyPI 下载新版本;对于 Claude Desktop,则会从 GitHub 下载新软件包。服务器的启动横幅已关闭,因此它所运行的框架不会自行检查版本。隐私政策 涵盖产品、购买和支持事项。

配置

启动设置是 MCP 服务配置中的环境变量。MCP 服务启动时会读取一次,此后不会再改变;任何工具调用、参数或提示词都无法更改这些设置。如果 MCP 服务无法解析某项设置,就会在启动时停止,并输出一行易于理解的消息,末尾为“The server did not start.”

变量作用
KS4W_READ_ONLY1 只列出读取操作,因此无法更改任何文件
KS4W_FORBID以逗号分隔的工具或操作名称列表;这些名称会从工具列表和 word_help 中移除;调用其中任何一项都会返回 NOT_AVAILABLE。未知名称会导致启动停止。此处的 word_app 会关闭所有连接到正在运行的 Word 的途径,包括其他操作的实时途径
KS4W_ALLOWED_ROOTS路径沙箱:在 Windows 上用 ; 分隔文件夹(其他系统用 :)
KS4W_AUTHOR调用未指定作者时,用于签署修订和评论的身份:user(默认值)使用你自己的 Office 用户名,也就是 Word 使用的名称(绝不会使用电子邮件地址:Windows 登录名会代替它);assistant 使用“AI Assistant via KS4Word”署名;无论设置为何,调用都可以通过 author="assistant" 请求使用该名称。调用中指定的任何其他 author 都优先,电子邮件地址除外,因为电子邮件地址绝不会写入文档:此时会改用默认署名,并在答复中说明。如果文档已在 Word 中打开,Word 会使用自己的用户名签署编辑
KS4W_CALL_TIMEOUT_S单次调用的实际运行时间上限,单位为秒(默认值为 300,范围为 1 至 3600)
KS4W_MAX_CALL_TIMEOUT_S对自行声明较长运行时间上限的操作所设的上限,例如由 Word 驱动的操作(默认值为 900,范围为 1 至 3600)
KS4W_MAX_OUTPUT_CHARS单条回复的字符数上限(默认值为 80,000,最小值为 2,000)。超出上限的回复会被截断,并说明截断的内容以及如何继续
KS4W_UPDATE_CHECKoff 会彻底关闭更新检查(旧版设置 KS4W_NO_UPDATE_CHECK=1 也有效)
KS4W_UPDATE_NOTICESoff 会关闭更新通知;如果之前关闭了通知,on 会重新开启

旧版本的设置会自动处理。旧版默认设置(KS4W_MODE=lite、full 或 everything,KS4W_PACK_POLICY=auto、KS4W_ALL_TOOLS、KS4W_LOCK_TOOLS 关闭)会被忽略,并在 stderr 中显示一行通知;状态报告也会列出这些设置。会锁定工具的设置(KS4W_PACK_POLICY=locked、KS4W_LOCK_TOOLS 开启,或 KS4W_MODE 中包含工具组列表)会导致启动停止,并显示说明应改用什么的消息:KS4W_READ_ONLY 或 KS4W_FORBID。

更新检查和更新通知。 每周最多一次,在你使用某个工具后,MCP 服务会在后台向 PyPI 查询 kitchensink4word 的最新版本。请求只包含软件包名称和已安装版本,不包含任何文档、文件名或标识符。如果有较新版本,且 MCP 服务通过 uvx 或 Claude Desktop 扩展运行,你的 AI 应用会显示一条简短通知,其中包含“立即更新”和“暂不更新”选项(如果应用支持)。否则,你的 AI 会提及一次新版本,并提供更新选项。只有当你在通知中选择“立即更新”,或要求 AI 更新时,才会下载或安装新版本。如需关闭通知,请要求 AI 关闭 KitchenSink4Word 更新通知;KS4W_UPDATE_NOTICES=off 会在所有位置关闭通知,而 KS4W_UPDATE_CHECK=off 会彻底关闭更新检查(旧版设置 KS4W_NO_UPDATE_CHECK=1 也有效)。此设置保存在 MCP 服务自己的状态文件夹中,因此更新后仍会保留。 沙箱隔离(可选)。 将 KS4W_ALLOWED_ROOTS 设置为以 ; 分隔的文件夹列表(Windows 之外使用 :),例如 %USERPROFILE%\Documents;D:\Work。之后,服务器读取或写入的每个路径都必须解析到其中一个文件夹内。检查会基于规范路径执行,因此 ..\ 路径遍历、符号链接和联接点、8.3 短文件名、扩展长度前缀、大小写伎俩,以及相似文件夹名称(例如,获准的 Documents 旁边有 Documents2)都会被拦截。除非获准的根路径本身是包含该路径的 UNC 路径,否则会拒绝网络(UNC)路径。被拦截的调用会返回类型化错误,指出路径和获准的根路径,且不会打开任何文件。只要服务器会处理你无法完全信任的请求,我们就建议启用此功能。

在 Word 中实时编辑

哪些操作适用于在 Word 中打开的文档。双模式操作会自动路由(live='auto');其他操作在文件关闭之前都会拒绝执行,并返回 DOCUMENT_LOCKED。同一服务器进程中的 Word COM 调用会串行执行。实时调用以及无需密码的保存或关闭操作也会使用机器本地的跨进程锁;并发调用方会在触及 Word 之前收到 APP_BUSY,且不会排队。实时编辑在执行 com_save_document 之前不会保存;get_workflows(task='live-editing') 会说明该模型。

双模式操作(文件 + 实时)实时模式说明
apply_edits使用一个 COM 撤销组;插入操作中的 Markdown 列表/管道符表格会预先拒绝,并提示关闭文件;替换操作会在实时范围内验证匹配文本;所有其他按索引寻址的操作都会针对上次保存的状态运行快照过时检查
delete_paragraphs跨越分节符/字段的范围会被拒绝;range={} 位置端点会运行快照过时检查
find_text纯文本查询,最多 500 个匹配项;格式模式和 include_textboxes 仅支持文件模式
format_text格式模式会路由到实时模式;大小写模式仅支持文件模式(live='force' 时会拒绝);range={} 位置会运行快照过时检查
get_comments结构相同
get_document_info键名相同;新增 words/track_revisions,不包含部件列表
get_outline扁平列表结构相同
get_text正文结构相同;include_textboxes/textbox 模式仅支持文件模式
insert_paragraphsheading_level 会按数字常量映射到内置 Heading 样式(基于大纲的文档会设置直接大纲级别);inherit_format/copy_format_from 仅支持文件模式;文本选择器位置会运行快照过时检查
search_and_replace纯文本项会路由到实时模式(会处理 255 字符的查找文本);预览和 find_formatting 模式仅支持文件模式(live='force' 且使用 find_formatting 时会拒绝)
set_cells纯文本单元格;实时模式会拒绝垂直合并
set_paragraph_format实时模式会拒绝 shading/borders/tab_stops 键(XML 级别);原始索引遵循 v1 索引信任约定
set_paragraph_text会遵循 expect 防护;会拒绝带修订的段落;文本选择器位置会运行快照过时检查
word_count使用 Word 自带的统计引擎;排除模式仅支持文件模式

仅限实时操作(需要文档处于打开状态):live_insert_at_cursor、live_repair、live_scroll_to、live_set_track_changes。
COM 层级(驱动 Word 应用,可在文档打开或关闭时使用):com_export_pdf、com_import_pdf、com_multi_document、com_proofing_errors、com_readability_statistics、com_refresh_fields、com_save_document、com_validate_opens_clean、com_word_status。
打开文档读取器:get_document_view(读取最后保存的状态,并会明确说明)。

所有其他读取或更改文档文件的操作都仅支持文件模式:文档打开时会拒绝执行(请关闭文档,或使用 com_save_document 并设置 close=true)。

已知限制

  • 实时正则表达式替换会跳过同一篇文档中位于复杂域之后的匹配项,因为 Word 的字符偏移量会在此处偏移。系统会报告跳过的数量,纯文本查找仍可正常使用。
  • 实时 set_cells 会拒绝包含纵向合并单元格的表格。基于文件的工具可以处理此类表格;请先关闭文档。
  • 实时修订的作者归属遵循 Word 的规则:如果 Word 已登录 Office 账户,修订会归属于该账户。结果会报告 Word 实际使用的作者。
  • 目录和题注列表中的页码需要更新域。Word 会在下次打开文件时更新,或者调用 com_refresh_fields。
  • 绑定到文档自定义 XML 的内容控件会显示文件中保存的文本;Word 会在打开文件时根据存储的数据填充该控件,因此两者可能不同。
  • 少数操作在处理极端文档时会显著变慢。在 100,000 个字符或更多的段落后添加段落时,retrack_changes 需要一分钟以上,并且耗时会随长度快速增长;对包含一千个节的文档调用 set_header_footer 则需要几分钟。调用达到时间限制后会报错并停止,文件不会更改。
  • 对于磁盘上的文档,内置样式可通过 Word 在所有语言版本中保留的英文名称(如 heading 2 或 Caption)或文档自身的样式 ID 查找。其他语言的名称(如 Überschrift 2)会被拒绝,并列出该文档具有的样式 ID。对于在 Word 中打开的文档,样式名称会按原样传给 Word,因此,安装了其他语言版本 Word 的用户可能需要使用该样式对应的名称。

启发式工具。 convert_citation_style、anonymize_for_review、validate(checks=["defined_terms"]) 和 validate(checks=["cross_references"]) 中的文本引用扫描均采用启发式方法。每项都会返回一份无法确信如何处理的内容列表,因此请检查该列表,而不要盲目信任结果。

从 2.x 升级

3.0 版将 2.2.x 中的 112 个扁平工具重新归并为上述十个工具。除 enable_tools 和 disable_tools 已移除外,每项操作都保留原名;但现在需要将其作为工具的操作调用:使用 word_edit 并设置 op="insert_paragraphs",而不是调用名为 insert_paragraphs 的工具。安装命令、包名称以及 word-mcp 和 kitchensink4word 命令均未更改。

如果你调用的是现在属于
get_text, get_document_view, find_text, list_elements, get_headers_footers, get_document_info, com_word_status, validate, diagnose_document, get_workflows, get_styles, get_outline, get_table, get_comments, get_tracked_changes, get_server_info, structured_diff, get_paragraph_format, word_count, get_revision_report, comment_report, get_protection, detect_citation_system, parse_referencesword_read
insert_paragraphs, search_and_replace, delete_paragraphs, insert_break, apply_edits, delete_element, stamp_anchors, set_paragraph_text, redact_textword_edit
define_style, apply_style, format_text, set_paragraph_format, change_heading_level, apply_manuscript_formatword_format
set_header_footer, set_section_properties, insert_list, create_table, set_table_properties, set_cells, delete_table, modify_table_structure, format_cells, sort_table, import_table, set_list_numbering, set_page_numbers, setup_chapter_headers, move_sectionword_structure
insert_image, insert_field, set_image, export_images, insert_chart, set_chart_data, insert_equation, set_textbox_text, insert_hyperlink, insert_content_control, set_content_control, set_form_fieldsword_media
manage_comment, resolve_revisions, anonymize_for_review, deanonymize_document, prepare_for_submissionword_review
manage_note, insert_caption, insert_reference_list, insert_bookmark, convert_notes, insert_cross_reference, mark_index_entry, insert_citation, insert_zotero_citation, search_zotero_library, manage_source, set_bibliography_style, convert_citation_styleword_references
insert_document, copy_document, create_document, manage_backups, set_document_properties, split_document, copy_table, apply_template, fill_template, mail_merge, assemble_front_matter, set_document_protection, set_watermark, fix_accessibility, export_tableword_document
com_save_document, live_insert_at_cursor, live_set_track_changes, com_refresh_fields, com_validate_opens_clean, com_multi_document, com_import_pdf, com_export_pdf, live_scroll_to, live_repair, com_proofing_errors, com_readability_statisticsword_app
enable_tools, disable_tools已移除。所有操作从一开始就可用

部分参数的拼写已更改,旧拼写仍然有效:after_anchor 现在为 after_text,anchor_text 现在为 at_text;set_document_protection 接受 read_only 和 tracked_changes;列表和页码格式采用 snake_case(lower_roman)。stamp_anchors 已从 get_document_view 移至 word_edit 中的独立操作。部分行为也有变化:format_text 和按文本定位的插入工具在你指定 occurrence 之前,会拒绝处理匹配不明确的情况;除非指定作者,否则修订和批注会使用你的 Office 用户名签名;受保护的文档会拒绝写入。docs/surface_map.md 列出了每个 2.2.1 工具及其替代项,而 get_workflows 中的 migrate-from-v2 配方会向你的 AI 提供相同的映射,其中也包含已更改的参数。更新日志 列出了其他所有更改。

从 1.x 升级

所有 1.x 工具名称都在 2.0 中发生了变化,189 个工具合并为 110 个,涵盖了此前的所有功能。请先阅读迁移指南;其中列出了每个旧名称对应的 2.x 名称,而 docs/surface_map.md 会进一步列出该名称在 3.0 中对应的工具和操作。在会话中调用 get_workflows("migrate-from-v1") 可获取第一份映射表。

测试

测试套件包含 4,525 项测试。其中 96 项会驱动真实的 Word 窗口,另有 135 项会启动各自的私有隐藏 Word;这些测试只能在安装了 Word 的 Windows 上运行。需要示例文档的测试会通过 tests/make_corpus.py 生成结构等效的合成文件,因此其余测试可在任何机器上运行,也会在每个拉取请求中运行。tests/word_validator.py 会在不可见的 Word 中打开每个输出文件,若出现任何修复提示,则测试失败。

要在没有 Word 的情况下运行测试套件:

pytest tests -m "not live and not hidden_word"

报告问题

请提交问题,并提供工具名称、你进行的调用、实际情况和预期结果。请让你的 AI 运行 get_server_info 并粘贴输出;此输出可安全分享。请勿附上包含任何私人信息的文档。安全问题请改为参阅 SECURITY.md。

商业版

商业版将这些工具与 Windows 安装程序、经过签名的更新渠道以及商业条款下的支持相结合。检查更新时会告知你是否有适用的版本可用,不会自动安装任何内容。请参阅定价。社区版仍依据 AGPL 免费提供,包括符合其条款的商业用途。

贡献

欢迎提交错误报告、修复、测试和文档。请参阅 CONTRIBUTING.md;首次贡献者需同意贡献者许可协议。

审核 AI 辅助完成的工作

AI 助手会犯错,软件也一样。在依赖、分享或提交任何由 AI 编辑的文档之前,请让人工审核,并在审核完成前保留备份。KitchenSink4Word 依据 AGPL-3.0 提供,不附带任何保证;在法律允许的范围内,其作者和 KitchenSink4AI 不对使用该软件产生的结果承担责任;具体以许可证第 15 和第 16 条为准。

许可证

KitchenSink4Word 采用双重许可。

  • AGPL-3.0。 任何人(包括企业)均可免费使用,但必须遵守 AGPL。其条款要求你在分发软件或通过网络提供软件时,分享包含你所做修改的源代码。
  • 商业许可证。 适用于希望将 KitchenSink4Word 集成到自身产品或服务中、且无需承担 AGPL 源代码共享义务的组织。请联系 [email protected]。

版权所有 (c) 2026 Alvut Consulting, LLC。KitchenSink4AI 是 Alvut Consulting, LLC 的产品线。KitchenSink4AI 工具在 AI 编码助手的帮助下构建,每个版本发布前都会通过完整的测试套件。

与 Microsoft Corporation 无关联,未获其认可或赞助。Microsoft 和 Word 是 Microsoft 集团公司的商标。GitHub 和 Copilot 是 Microsoft 集团公司的商标。Claude 是 Anthropic 的商标。Codex 和 OpenAI 是 OpenAI 的商标。所有其他商标均为其各自所有者的财产。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。