thex

🇨🇳 专为Remember The Milk打造的自动化脚本，您的专属敏捷教练。它通过高精度排期引擎推演任务耗时，生成负载热力图。遇到排期溢出时，会自动提供智能削减或加班建议，并输出多维诊断报告，助您告别超载。

🇬🇧 An advanced Remember The Milk script acting as your Agile coach. It simulates schedules, generates workload heatmaps, and offers smart task-pruning or overtime advice when overloaded, helping you conquer burnout with deep reports.

---

🎯 RTM Agile Coach (RTM 敏捷教练)

🇨🇳 简体中文 (Simplified Chinese) | 🇬🇧 English

An advanced Remember The Milk (RTM) automation script powered by MilkScript, acting as your personal Agile Coach. It simulates schedules, generates workload heatmaps, and offers smart task-pruning or overtime advice when overloaded, helping you conquer burnout with deep reports.

✨ Features

• ⏱️ Precision Scheduling Engine: Simulates task execution with millisecond precision, strictly adhering to your configured working hours, weekends, and holidays.
• 🌡️ Workload Heatmaps: Visually displays your daily capacity and load, making it easy to spot bottlenecks and idle times at a glance.
• 🧠 Adaptive Efficiency Tracking: Automatically calculates your real-world "Work Ratio" by analyzing 7/30/180 days of historical data, complete with circuit breakers for vacations or data anomalies.
• ✂️ Smart Triage & Pruning: When your schedule overflows, it uses a weighted scoring model (Objective Priority + Task Priority + Urgency) to recommend exactly which tasks to drop, delay, or move to an empty slot.
• 🔋 Fatigue-Aware Overtime Advice: Calculates realistic overtime needs using an "Efficiency Factor" (e.g., 0.8), warning you of hidden cognitive costs and late-night hard stops.
• 📊 Multi-layered Reporting: Generates beautiful, structured notes in RTM (HUD, Action Plan, Deep Diagnosis, and Details) and logs historical metrics for long-term review.

🚀 Installation & Setup

1. Prerequisites: You must have a Remember The Milk Pro account to use MilkScript.
2. Add Script:
   • Go to your RTM Web App -> Settings -> MilkScript.
   • Create a new script, copy and paste the entire source code into the editor.
3. Configure Parameters: Set up the UI parameters (rtm.args) to match the script's input requirements (e.g., a.💥 快捷：生成【今日】报告？, e.📆 (可选) 指定基准截止日期).

⚙️ Configuration

Before running, customize the CONFIG object at the top of the script to fit your lifestyle:

const CONFIG = {
    // Define your typical workday
    WORKDAY_CONFIG: {
        startHour: 9,      // 9:00 AM
        endHour: 18,       // 6:00 PM
        workingDays: [1, 2, 3, 4, 5], // Mon to Fri
        holidays: [],      // Add 'YYYY-MM-DD' for specific holidays
    },
    ...
};

const OVERTIME_CONFIG = {
    EFFICIENCY_FACTOR: 0.8, // 1 hour of overtime ≈ 0.8 hours of output
    LATE_THRESHOLD: 21      // Stop suggesting overtime after 9:00 PM
};

Note: The script heavily relies on specific tag structures (e.g., 1.1-🔭 for objectives, 0_ and 99_ prefixes for goal linking). Please ensure your RTM tagging system aligns with the CONFIG.TAGS definitions.

📖 How to Use

Run the script from the RTM web interface or mobile app. The script respects priority inputs:

1. Shortcuts: Instantly generate reports for "Today", "Tomorrow", "This Week", or "This Month" via checkbox toggles.
2. Manual Dates: Select a specific Due Date baseline.
3. Smart Lists: The script automatically creates or updates Smart Lists (e.g., ✨-本周-🎯🔍) pinned to your favorites for easy navigation.

Read the generated Task Notes starting with 📊-System-Log or your period names to get actionable advice!

📄 License

This project is open-source and available under the MIT License.

---

🇨🇳 简体中文

专为 Remember The Milk (RTM) 打造的自动化 MilkScript 脚本，您的专属敏捷教练。它通过高精度排期引擎推演任务耗时，生成负载热力图。遇到排期溢出时，会自动提供智能削减或加班建议，并输出多维诊断报告，助您告别超载。

✨ 核心亮点

• ⏱️ 高精度排期引擎：毫秒级模拟任务执行流程，严格扣除下班时间、周末及节假日，还原最真实的可用工作容量。
• 🌡️ 可视化负载热力图：在 RTM 笔记中直接渲染每日容量与负载图表（支持 Emoji 状态分级），瓶颈与空闲时段一目了然。
• 🧠 自适应效率追踪：告别“盲目预估”。脚本会自动分析过去 7/30/180 天的历史完成数据，计算真实的“工时膨胀率”，并具备针对“休假黑洞”和“新手期稀释”的智能熔断机制。
• ✂️ 智能削减与补位：当需求溢出时，基于加权归一化模型（目标优先级 + 任务优先级 + 时间紧迫度），精准建议您“推迟、移除或平移”哪些具体任务。
• 🔋 疲劳感知加班建议：基于设定的“疲劳折损率”（默认 0.8），为您计算真实的加班代价，并在深夜（如 21:00 后）触发强制休息熔断。
• 📊 深度多层级报表：自动生成渐进式披露报告——从抬头显示（HUD）、行动指南、深度诊断到原始明细，并在后台自动记录历史容量指标（CSV格式）供复盘使用。

🚀 安装与设置

1. 环境要求：您需要拥有 Remember The Milk Pro (高级账户) 才能运行 MilkScript。
2. 添加脚本：
   • 登录 RTM 网页版 -> 设置 (Settings) -> MilkScript。
   • 新建一个脚本，将全部源码粘贴进编辑器。
3. 配置 UI 参数：根据代码中的 rtm.args 键值，在脚本设置中完整配置相应的用户输入项（例如：a.💥 快捷：生成【今日】报告？ 等开关和下拉框）。

⚙️ 个性化配置

在开始运行之前，强烈建议您修改代码顶部的 CONFIG 对象，以匹配您真实的作息节律：

const CONFIG = {
    // 定义您的标准工作日
    WORKDAY_CONFIG: {
        startHour: 9,      // 上班时间：早 9:00
        endHour: 18,       // 下班时间：晚 18:00
        workingDays: [1, 2, 3, 4, 5], // 周一至周五工作
        holidays: [],      // 特定节假日可在此添加 'YYYY-MM-DD'
    },
    ...
};

const OVERTIME_CONFIG = {
    EFFICIENCY_FACTOR: 0.8, // 疲劳折损：加班1小时仅相当于正常 0.8 小时的产出
    LATE_THRESHOLD: 21      // 深夜熔断：超过 21:00 建议放弃加班
};

注意：本脚本深度依赖特定的标签语法体系（如使用 1.1-🔭 标记目标类型，使用 0_ 和 99_ 前缀链接子任务）。使用前请确保您的标签管理系统与 CONFIG.TAGS 的定义兼容。

📖 使用指南

在 RTM 网页或移动端运行脚本时，您可以：

1. 快捷一键生成：勾选参数面板上的快捷开关（如“今日”、“本周”、“本月”），直接一键生成对应周期的分析报告。
2. 自定义基准日：手动指定一个目标截止日期或使用相对偏移量（高级玩法）。
3. 查看智能视图：脚本运行后，会自动生成或更新诸如 ✨-本周-🎯🔍 的智能列表（Smart List），方便您在侧边栏快速查阅。
4. 阅读报告：前往回收站（♻️）或 Inbox 查看自动生成的图文任务笔记，根据“行动指南 (Action Plan)”做出你的排期决策！

📄 开源协议

本项目完全开源，遵循 MIT License 协议。欢迎提交 PR 和 Issue！

---

🧪 示例文案/Sample Copy

🚀 ** 行动指南(Action Plan) ** 
------------------------------------------------------------
⚠️【高压预警】需加班 (预测拥挤度 25%)

🤔👉 **系统研判**: 任务堆积在休息/下班时段，导致局部加班 (全局其实有盈余)。
--------------------------------------------------
💡 **诊断与建议**: 宏观总容量充裕 (仍有约 12.9h 盈余)。当前警报纯粹是因为**死线太紧**或**任务被锁定在休息日**。
👉 **建议行动：无需删除任务。只需推迟死线，或将休息日任务平移至工作日，警报即可解除。**
------------------------------------------------------------
📊 ** 核心指标速览 **: 
• 排期拥挤度: 24.9% 
• 预测总耗时: 8.6 h(🔒0.5h) | 可用 34.5 h
  * (注: 预测耗时 = 任务加权工时 + 日程📅)*

🧠 ** 深度诊断(Deep Diagnosis) ** 
------------------------------------------------------------
📅 **实时战略排期推演 (Schedule)**
   • 预计完工: 2026-06-06 10:06:15 星期六
   *（注：排期表展示的预计完工是“最坏情况”（Worst Case）：如果你白天完全没时间做这个任务，晚上要搞到几点。）*
   🟢 [06-02(二) 10:29 - 10:39] 检查****回复-0.33🍅 (10m)
   🟢 [06-02(二) 10:39 - 11:39] 查询****材料？-1.00🍅 (30m)
   🟢 [06-02(二) 11:39 - 13:40] 2.2.5-如何****-2.00🍅 (60m)
   🟢 [06-02(二) 13:40 - 15:40] 3-2-1-在****更新****-2.00🍅 (60m)
   🟢 [06-03(三) 09:00 - 09:05] 3.****验证-0.17🍅 (5m)
   🟢 [06-03(三) 09:05 - 09:35] 弄清楚****是什么-1.00🍅 (30m)
   🟢 [06-03(三) 09:35 - 09:40] 3.****验证-0.17🍅 (5m)
   🟢 [06-03(三) 09:40 - 11:40] 准备****材料-2.00🍅 (60m)
   🟢 [06-04(四) 09:00 - 09:05] 3.****验证-0.17🍅 (5m)
   🟢 [06-05(五) 09:00 - 09:05] 3.****验证-0.17🍅 (5m)
   ➖➖➖➖➖➖ 🧨 标准容量耗尽 (转入加班推演) ➖➖➖➖➖➖
   🧨 [06-06(六) 10:00 - 10:06] 3.****验证-0.17🍅 (5m) (加班)
      ↳ 📉 **阻塞瓶颈**: 高顺位任务占据加班通道，后续2任务被迫顺延。
   🧨 [06-06(六) 10:06 - 10:06] 4.发放**** (0m) (加班)
   🧨 [06-06(六) 10:06 - 10:06] 4.发放**** (0m) (加班)
   • 目标死线: 2026-06-06 23:59:59 星期六

------------------------------------------------------------
🌡️ **每日实时战略负载热力 (Load Heatmap)**
   🟨 06-02(二):   69% [  5.2/  7.5h]  🟢空闲2.3h
   🟩 06-03(三):   35% [  3.2/  9.0h] 🔒含日程📅(0.5h)  🟢空闲5.8h
   🟩 06-04(四):    1% [  0.1/  9.0h]  🟢空闲8.9h
   🟩 06-05(五):    1% [  0.1/  9.0h]  🟢空闲8.9h
   🧨 06-06(六):   N/A [  0.1/  0.0h] 🧨加班0.1h

------------------------------------------------------------
🕵️ **日程📅审计 (Blocking Audit)**
   *(没有未设置明确的开始时间/预估的日程📅)*

------------------------------------------------------------
📊 **实时战略容量分析 (Capacity)**
   • 实际📍需求: 8.1h (原始 4.6h +77%)
     ↳ 算式: ∑ (预估 × 效率) / 60
     ↳ 详情:
       • 1.5-📌-****: 1.50h × 2.00🌐 = 3.00h
       • 1.5-📌-1.将****准备好-7: 1.00h × 2.01🎯 = 2.01h
       • 1.10-🎉-3.更新****: 1.00h × 2.00🌐 = 2.00h
       • 1.4-⛳-1.****步骤-4: 1.08h × 1.00🎯 = 1.08h
   • 日程📅占用: 🔒0.5h
   • 可用🟢容量: 34.5h (截止 2026-06-06)

------------------------------------------------------------
📉 ** 历史习惯分析 **: 
🕰️📈🌡️: **纯产能与吞吐量评估 (Velocity Check)** (截止于 2026-06-06 23:59:59)
待办纯预估：275m | 基于历史均速的吞吐饱和度：26.6%
待办纯预估：275m < 预计可消化纯预估: 1033.65m (算式: 剩余3.83天 × 日均269.63m)
👉 **产能结论**: 🟢 本周期 可适当增加 约 758.65 分钟的纯预估量。