前言¶
在 DeepSeek Harness（DSH）里做智能体或日常开发时，任务往往分散在聊天、笔记和外部待办应用之间。若你已经在用 Microsoft To Do 管清单，单独开浏览器或客户端会打断当前工作区节奏。社区插件 Dsh-Microsoft-ToDo（维护者 WekyJay）把微软待办嵌进 DSH 的 Web 界面：左侧导航清单与统计，右侧直接增删改任务，详情从右侧抽屉展开，不必离开 Harness。
下文按「定位 → 功能 → 安装 → 首次登录 → 本机数据与限制」说明，事实均来自仓库 README 与 package.json（当前插件版本 0.6.2）。
这是什么¶
Dsh-Microsoft-ToDo 是 DSH 的客户端类 bundle 插件：在 Web UI 增加「微软待办」面板，通过上游 MCP 服务 microsoft-todo-mcp 调用 Microsoft Graph To Do API。清单浏览、任务增删改、完成与重开等与微软云端同步；侧栏「分组」和「我的一天」因 Graph To Do API 无对应资源，由本机 JSON 保存，不跨设备同步。
- 仓库：WekyJay/Dsh-Microsoft-ToDo
- 社区目录：SkillHub 插件页
- 许可证：MIT
- 要求 DSH：
>=0.2.0（package.json的engines.dsh）
核心功能¶
面板为左右分栏：左侧为品牌、今日 / 逾期 / 重要计数与清单导航（含本地分组）；右侧为任务列表，支持新增、完成、重开、标星、删除。任务详情与分组设置从右侧抽屉打开。
| 能力 | 说明 |
|---|---|
| 清单与任务 | 浏览清单；创建、更新、完成、重开、删除任务 |
| 统计 | 今日、逾期、重要（标星）计数 |
| 分组 | 侧栏按组收纳清单，写入本机 groups.json |
| 我的一天 | 每天挑选一批任务，次日自动清空，写入本机 myday.json |
| 任务详情 | 备注、截止日期、提醒、重复、下一步、附件 |
| 登录 | 设备码流程；令牌由上游 MCP 缓存在本机 |
| 界面 | 中英双语；面板左下角显示插件版本与 DSH 兼容状态 |
依赖方面，插件宿主半边常驻拉起 microsoft-todo-mcp（npx -y microsoft-todo-mcp），走 MCP stdio；默认使用微软公共客户端 id，委托权限 Tasks.ReadWrite，无需自建 Entra 应用。
安装与启用¶
插件是标准 DSH bundle（package.json 中的 dsh.bundle + dsh.client）。官方文档给出两种装法，请按环境选用，勿凭仓库名自行拼接未在文档中出现的 CLI 命令。
从本地目录安装（开发）¶
适合克隆或下载仓库后直接调试。已安装过同名 bundle 时，需先移除再装，DSH 不会对宿主模块热重载。
plugin_manager: action=install_bundle, target=<本仓库绝对路径>
若需先卸载：
plugin_manager: action=remove_bundle, target=dsh-microsoft-todo
从插件市场安装¶
- 在 DSH 设置 → 插件市场 添加本仓库市场索引：
https://wekyjay.github.io/Dsh-Microsoft-ToDo/market/index.json
- 在 Discover 中搜索「微软待办」并完成安装。
SkillHub 等社区目录页用于发现插件，与 DeepSeek / 幻方无官方从属关系；安装行为仍以 DSH 内市场索引与 bundle 机制为准。
版本兼容¶
| 项目 | 值 |
|---|---|
| 插件版本 | 0.6.2 |
| 支持的 DSH | >=0.2.0 |
| README 实测 | DSH 0.2.2-rc.1 · macOS（Apple Silicon）· Node 25 |
不满足 engines.dsh 时，安装或启用会被拒绝。面板左下角：绿色「DSH 兼容」、红色「DSH 版本过低」（可 dsh update 后刷新）、灰色「DSH 版本未知」（部分打包环境）。确需强装可使用文档中的 dsh plugin --profile ... allow-version ... --accept-risk，存在崩溃或丢数据风险。
典型用法：首次登录与日常操作¶
设备码登录¶
面板首次打开显示登录页：
- 点击「开始登录」，复制设备代码。
- 在浏览器打开
https://microsoft.com/devicelogin，输入代码并同意授权。
之后访问令牌过期时由刷新令牌自动续期，一般无需重复登录。令牌缓存路径：
~/.config/microsoft-todo-mcp/token-cache.json（权限 0600，由上游 MCP 写入）。
日常任务流¶
经过登录后，在左侧选择清单或「我的一天」视图，在右侧列表中操作任务；需要编辑备注、截止日期、提醒等时，从右侧抽屉打开任务详情。侧栏分组设置同样从右侧抽屉进入，变更只影响本机 groups.json。
卸载 bundle 命令：
plugin_manager: action=remove_bundle, target=dsh-microsoft-todo
卸载后 groups.json、myday.json 仍留在插件目录；令牌目录需手动删除 ~/.config/microsoft-todo-mcp/。
适用场景与注意¶
适合谁： 已在 Microsoft To Do 上维护清单、且主力在 DSH Web 界面工作的开发者或智能体用户；希望在同一窗口内查看今日 / 逾期 / 重要任务并快速改状态。
运行与安全： 插件以当前 DSH 进程权限运行，并拉起 microsoft-todo-mcp 子进程访问 Graph。安装前建议阅读仓库源码与 MIT 许可证，确认可接受设备码登录与令牌本地缓存方式。
已知限制（README 明确列出）：
- 分组与「我的一天」仅为本机实现，不会同步到其他设备或官方 To Do 客户端。
- 每个清单最多读取 200 条任务（
list_tasks的maxResults上限内）。 - 任务排序跟随 Graph 返回顺序，To Do 客户端中的自定义排序不在 API 中。
结尾¶
Dsh-Microsoft-ToDo 把 Microsoft To Do 的清单与任务操作收进 DSH 客户端面板，云端任务与设备码登录走官方 Graph 路径；分组与「我的一天」则补足 API 缺口，数据落在本机。若要进一步了解或提 Issue，可访问 GitHub 仓库 与 SkillHub 目录页。
