办公室助理
通过简单的英语聊天来管理Office 365日历。只需键入您需要的内容-- “今天我的日历上有什么？”, “安排明天下午2点与爱丽丝会面”, “找一个适合每个人的时间” --剩下的由助理处理。
Office Assistant专为行政助理和管理繁忙日历的任何人而构建，它连接到Microsoft 365，让您可以通过简单的聊天界面创建事件、查看可用性、预订房间、管理其他人的日历等。
______________________________________________________________________
你能做什么
设置完成后，只需在 office-assistant 文件夹并开始键入。以下是你可以问的问题：
查看您的日程安排
What's on my calendar today?
Show me my meetings for next week
What do I have on Thursday?查看他人的日历
What's on Alice's calendar tomorrow?
Show me bob@company.com's schedule for Monday其他人需要在Outlook中与您共享他们的日历才能正常工作。
创建会议
Schedule a meeting called "Project Review" tomorrow at 3pm
Book a 1-hour meeting with alice@company.com and bob@company.com on Friday at 10am
Set up a meeting about budget planning next Tuesday at 2pm in the Board Room对于工作/学校帐户，会议默认包含Microsoft Teams链接。如果你想要一个面对面的会议，只需这样说：
Schedule an in-person meeting in Room 4A tomorrow at 11am个人帐户不支持团队会议链接。默认情况下，会议是亲自创建的。
更改或取消会议
Move the Project Review to 4pm
Cancel tomorrow's budget meeting
Cancel the 3pm meeting and let everyone know it's been postponed定期会议
Set up a daily standup at 9am starting Monday
Schedule a weekly team sync every Tuesday and Thursday at 2pm for the next 3 months
Create a weekly budget review every Monday at 10am接受或拒绝会议
Accept the meeting invitation from Alice
Decline tomorrow's 3pm meeting with a note that I have a conflict
Tentatively accept the project review管理他人的日历
如果有人授予您在Outlook中委派访问权限，您可以管理他们的日历：
Schedule a meeting called "Board Review" on Sarah's calendar for Friday at 10am
Cancel the 2pm meeting on my manager's calendar
Accept the invitation on behalf of sarah@company.com要授予代理访问权限：在Outlook中，另一个人转到 文件 > 账户设置 > 委托访问 >添加您的电子邮件地址。
检查可用性
Is alice@company.com free tomorrow afternoon?
Check if bob@company.com and carol@company.com are available on Thursday找一个适合每个人的时间
Find a time for a 30-minute meeting with alice@company.com next week
When can bob@company.com, carol@company.com and I all meet for an hour?预订会议室
What meeting rooms are available?
Show me rooms in Building 2
Book the Boardroom for tomorrow's team meeting at 3pm快捷方式命令
您还可以键入这些快捷方式以逐步引导：
| 命令 | 它的作用 |
|---|---|
/calendar | 回答有关日历的问题 |
/schedule-meeting | 逐步引导您创建会议 |
/find-time | 查找多人之间的可用会议时段 |
/check-availability | 检查人们是空闲还是忙碌 |
/calendar-setup | 帮助登录或修复连接问题 |
个人账户
如果您使用的是个人Microsoft帐户（@outlook.com、@hotmail.com），则大多数功能都可以使用：
- 查看日历
- 创建、编辑和取消事件
- 定期会议
- 接受、拒绝或暂时接受邀请
- 为事件添加注释和位置
一些功能需要 工作/学校账户 （微软365）：
- 检查其他人的可用性
- 查找多人之间的会议时间
- 查看其他人的日历
- 委派日历访问权限（管理其他人的日历）
- 会议室发现和预订
- Microsoft Teams会议链接
______________________________________________________________________
入门
设置大约需要10分钟。有三个部分：安装软件、向Microsoft注册应用程序和登录。如果您对其中任何一个感到陌生，您的IT部门可以提供帮助，特别是Azure注册部分。
你需要什么
- 一台计算机 运行Windows、macOS或Linux
- Microsoft帐户 --工作/学校帐户（Office 365）或个人帐户（@outlook.com、@hotmail.com）
- 克劳德代码 --首先按照以下步骤安装它 Claude Code安装指南
你做 不 需要安装Python或任何其他编程工具——安装脚本会自动处理一切。
第一步：下载并安装
打开一个终端，一次运行这三个命令。复制每一行，将其粘贴到终端，然后按 进入:
git clone https://github.com/rgilks/office-assistant.gitcd office-assistant./setup.sh第一个命令下载助手。第二个打开文件夹。第三个安装了运行所需的一切。
How do I open a terminal?
- 苹果电脑：新闻 Cmd+空格，类型 终端，然后按Enter键。
- 视窗：按Windows键，键入 适用于 Linux 的 Windows 子系统，并打开它。如果未安装WSL，请参阅下面的Windows部分。
- Linux：新闻 Ctrl+Alt+T 或者在应用程序菜单中查找终端。
"git" is not recognised / command not found
Git是一个用于下载助手的工具。它没有预装在大多数计算机上，但可以快速添加：
- 苹果电脑：类型
git在终端中按Enter键，macOS将为您提供安装服务。点击 安装 然后等待它完成。 - Windows（WSL）：在WSL终端中，键入
sudo apt install git然后按Enter键。 - Windows（不带WSL）：从下载安装程序 git-scm.com，运行它，然后重新启动终端。
如果你对此感到不舒服，可以问你的IT部门——这不到一分钟。
Windows users: about WSL
Office助手在WSL（Linux的Windows子系统）中运行，它为您的Windows PC上提供了一个Linux环境。大多数现代Windows工作计算机已经安装了此软件。
检查： 打开PowerShell（按Windows键，键入 PowerShell)和类型 wsl --status.
如果未安装： 让你的IT部门运行 wsl --install 在管理员PowerShell中，这大约需要5分钟和一次重启。
WSL设置完成后，从“开始”菜单中打开它（键入 适用于 Linux 的 Windows 子系统)并在WSL终端内运行上述安装命令。
"./setup.sh: Permission denied"
类型 bash setup.sh 而是按Enter键。这做了同样的事情。
安装脚本将安装所有软件依赖项，然后引导您登录。如果您看到任何错误，请跳到 故障排除 在......下面
步骤2：在Azure中注册应用程序
此步骤告诉Microsoft允许Office助手访问您的日历。你只需要做一次。如果您的组织限制Azure访问，请让您的IT部门为您执行此步骤——他们会知道该怎么做。
- 首选 portal.azure.com 在您的网络浏览器中
- 使用您的账号登录 微软账户 （工作、学校或个人）
- 在顶部的搜索栏中，键入 应用程序注册 然后单击结果
- 点击 +新注册 按钮
- 填写表格：
- 名字: Office Assistant （或任何你喜欢的东西——这只是一个标签） - 支持的帐户类型：根据您的帐户选择： - 工作/学校账户：“仅此组织目录中的帐户” - 个人账户 （@outlook.com，@hotmail.com）：“仅限个人Microsoft帐户” - 重定向URI：留空
- 点击 注册
现在，您将看到新应用程序的概述页面：
- 复制 应用程序（客户端）ID --看起来是长代码
a1b2c3d4-e5f6-7890-abcd-ef1234567890把它存到某个地方——你马上就需要它了。
现在再配置两个设置：
- 在左侧边栏中，单击 认证
- 向下滚动至 高级设置 - 集 允许公共客户端流 到 是 - 点击 保存 在顶端
- 在左侧边栏中，单击 API权限
- 点击 +添加权限 - 点击 微软图形 - 点击 委托权限 - 搜索并勾选这些权限： - Calendars.ReadWrite - Calendars.ReadWrite.Shared （仅限工作/学校账户——个人账户跳过此项） - Place.Read.All （仅限工作/学校账户——个人账户跳过此项） - User.Read - 点击 添加权限
步骤3：登录
如果步骤1中的安装脚本已经引导您完成了登录，那么您就完成了！否则，请返回您的终端并运行：
cd office-assistant
uv run python -m office_assistant.setup它会问你：
- 你的 应用程序（客户端）ID （您在上述步骤7中复制的代码）
- 无论您是否使用 工作/学校 或 个人的 账户
然后，它将显示一条消息，如下所示：
要登录，请使用web浏览器打开https://microsoft.com/devicelogin并输入代码 ABCD1234
- 在浏览器中打开该链接
- 输入终端显示的代码
- 使用您的Microsoft帐户登录
- 点击 接受 当被要求批准权限时
就是这样！您的登录信息将保存约90天。当它过期时，只需使用任何日历命令，助手就会自动提示您重新登录——您将看到与以前相同的链接和代码。
______________________________________________________________________
使用助手
设置完成后，在中打开Claude Code office-assistant 文件夹并开始聊天。你不需要记住任何特殊的命令——只需用简单的英语描述你需要什么。
如果助手在连接时遇到问题，请键入 /calendar-setup 它将帮助你修复它。
______________________________________________________________________
故障排除
“必须设置CLIENT_ID和TENANT_ID”
助手尚未设置，或者设置尚未完成。返回您的终端并运行：
cd office-assistant
uv run python -m office_assistant.setup“无法启动设备代码流”
您的Azure应用程序可能未启用正确的设置。返回Azure门户，在以下位置找到您的应用 应用程序注册，单击 认证，并确保 允许公共客户端流 设置为 是。别忘了点击 保存.
“您没有权限查看此人的日历”
对方尚未与您共享他们的日历。让他们分享：在Outlook中，他们转到 日历，右键单击他们的日历，选择 共享和权限，并添加您的电子邮件地址。
任何日历操作上的“ErrorAccessDenied”
这通常意味着以下两件事之一：
- 缺少权限：返回到上面的步骤2，并检查以下是否列出了所有必需的权限 API权限 在Azure门户中。
- 个人账户限制：某些功能（检查可用性、查找会议时间、预订房间）仅适用于工作/学校帐户。如果是这样的话，助理会告诉你的。
“需要批准”或管理员同意屏幕
您的组织需要管理员批准访问日历数据的应用程序。您有两个选择：
- 询问您的IT管理员 在Azure门户中授予应用程序的同意
- 使用个人Microsoft帐户 （@outlook.com，@hotmail.com）改为在该帐户下注册一个新应用程序并使用它登录
登录已过期
只需使用任何日历命令，助手就会自动检测过期的登录并提示您重新登录。你会看到一个链接和一个代码，和第一次一样。
其他东西不起作用
类型 /calendar-setup 在Claude Code中，它将检查您的连接并指导您解决常见问题。
______________________________________________________________________
对于开发者
建筑
- MCP服务器 (
src/office_assistant/server.py)：FastMCP over stdio，为Claude Code提供日历工具 - 工具 (
src/office_assistant/tools/)：日历操作、可用性检查、客房预订 - 认证 (
src/office_assistant/auth.py)：SWATDevice代码流，令牌缓存在~/.office-assistant/ - 技能 (
.claude/skills/)：Slash命令定义
开发设置
git clone https://github.com/rgilks/office-assistant.git
cd office-assistant
uv sync --extra dev运行测试
uv run pytest掉毛
uv run ruff check src/ tests/
uv run ruff format --check src/ tests/