核心用法
todolist-md-clawdbot 是一套面向 Markdown 优先的待办管理系统的操作规范与自动化脚本集合。其核心设计哲学是：Markdown 是唯一可信数据源，AI 仅作为读写代理，不持有任务状态。
显著优点
1. 存储无关的通用架构：支持 Google Drive（fileId）、本地文件系统（path）、S3（bucket+key）三种后端，通过统一的身份键抽象实现跨平台兼容。
2. 行级稳定写入（line-stable write-back）：通过 <!-- bot: ... --> 标记约束编辑范围，避免破坏 todolist-md 的行位置派生 ID 机制，确保任务身份持久性。
3. 最小化 Token 成本：采用"准备-应用"两阶段工作流（prepare/apply），仅对变更文件调用 LLM，且只提取开放任务（- [ ]）而非完整文档，大幅降低 API 开销。
4. 内置并发安全：通过 Drive API 的 headRevisionId 修订门机制，防止覆盖用户正在 Chrome 应用中编辑的内容。
5. 人机协作的审查边界：建议任务隔离在 ## Tasks (bot-suggested) 分区，完成任务需显式用户确认，避免 AI 擅自变更状态。
潜在局限性与风险
| 维度 | 说明 |
|------|------|
| **配置门槛** | 首次运行需配置 OAuth、存储后端参数，对非技术用户存在上手成本 |
| **生态依赖** | 紧密绑定 todolist-md 的 Markdown 方言（GFM checkbox、`due:` 日期标签、描述块引用），迁移至其他工具需格式转换 |
| **冲突处理** | 行级稳定写入虽保护任务 ID，但长描述块内的内容冲突仍需人工仲裁 |
| **Token 经济假设** | "仅处理变更文件"的优化依赖准确的 `modifiedTime/size/etag` 检测，时区或存储同步异常可能导致漏处理 |
适合人群
- 个人效率极客：已使用或愿意采用 Markdown 作为任务主数据格式的用户
- 小团队协作：通过 Google Drive 共享任务文件夹，需要轻量级 AI 辅助但不愿引入复杂 SaaS 的群体
- 成本敏感场景：希望精细化控制 LLM 调用频率，避免全量文档扫描的开发者/自由职业者
常规风险
- 数据丢失：脚本直接覆盖原 fileId 内容，虽有修订门保护，但配置错误
--folderId可能导致误写其他文件 - 隐私暴露：Drive OAuth 权限需
drive.file或drive范围，脚本获取的 refresh token 需妥善保管 - AI 幻觉：
<!-- bot: suggested -->区块的建议质量依赖底层模型，复杂依赖关系（跨文件任务关联）可能被错误推断
技术亮点
参考脚本 todolist_drive_folder_agent.mjs 实现了完整的变更检测→下载→LLM 请求生成→建议应用→状态回写的闭环，可作为自主代理（autonomous agent）的参考实现。