ddlpin — 你的本地任务中枢 + 桌面便签

DDL(deadline)+ pin(钉在桌面):在任意 AI 里顺口记任务,桌面便签常驻倒计时,到点把你拽回来。

在任何 AI(Claude Code / Codex / mirasim 会话)里顺口说一句就记下,桌面便签常驻显示 + 到点升级式提醒。 daemon 与 MCP 零第三方依赖(Node ≥22.5 内置 sqlite),数据全在本地 ~/.taskboard/。

平台:目前一键安装脚本面向 macOS(launchd 自启)。Electron 便签本身跨平台,Windows/Linux 的自启装法在路线图上(欢迎 PR)。

设计文档见 DESIGN.md。

组成

组件	作用	运行方式
src/daemon/	真相源:SQLite + HTTP API + 提醒调度 + ntfy 推送	launchd 常驻(com.taskboard.daemon)
src/mcp/	MCP server(零依赖 stdio),把 AI 的工具调用转发给 daemon	由 CC/Codex/mirasim 各自 spawn
sticky/	Electron 桌面便签:置顶、倒计时、配色、勾选/贪睡/添加	launchd 常驻(com.taskboard.sticky)

安装(一次)

cd sticky && npm install && cd ..          # 装 electron
bash scripts/install-daemon.sh             # 装并启动 daemon + 便签(launchd,开机自启)

Electron 二进制若因公司 npm 策略没自动下载:unzip -oq ~/Library/Caches/electron/electron-*.zip -d sticky/node_modules/electron/dist && printf 'Electron.app/Contents/MacOS/Electron' > sticky/node_modules/electron/path.txt

接入三个 AI 入口

Claude Code(user 级,在仓库根目录执行):

claude mcp add taskboard --scope user -- node "$(pwd)/src/mcp/server.js"

注意:新加的 MCP 要重启 Claude Code 才在会话里生效。

Codex:在 ~/.codex/config.toml 加(把路径换成本仓库的绝对路径):

[mcp_servers.taskboard]
command = "node"
args = ["/absolute/path/to/taskboard/src/mcp/server.js"]

mirasim:把上面这个 MCP 注册为 mirasim 的全局 MCP 扩展即可(mirasim 的会话本身就是 CC/Codex,自动就带上工具)。

怎么用

在任意 AI 对话里自然说:

• “把『周五下午5点前交季度报告』记到看板,高优先级”
• “看板上今天有什么要做的?”
• “把交报告那个改到下周一”
• “那个任务完成了”

AI 会调用 add_task / list_tasks / update_task / complete_task / snooze_task / drop_task,并把解析出的绝对截止时间复述给你确认。

便签上也能直接:输入框敲一行回车加任务、悬停勾 ✓ 完成、💤 贪睡 1 小时、▁ 切换迷你胸章形态。

配手机推送(安卓 · ntfy)

1. 手机装 ntfy App(Play Store / F-Droid)。
2. 编辑 ~/.taskboard/config.json 的 ntfy.topic 为一个只有你知道的随机串(如 taskboard-a7f3k9)。
3. App 里订阅同名 topic。
4. 重启 daemon:launchctl kickstart -k gui/$(id -u)/com.taskboard.daemon

之后到点/逾期提醒会推到手机。(通知里的“完成/改期”动作按钮需要 daemon 可被手机访问,属后续项。)

便签不见了怎么办

便签常驻在菜单栏(📌 图标),几种召回方式:

• 全局快捷键 ⌘⇧D —— 最快,任何时候召回并置顶。
• 点菜单栏 📌 图标 —— 单击切换显示/隐藏;右键菜单有「归位到主屏右上角」。
• 点便签右上角 ✕ 是隐藏(不是退出),随时能召回;真正退出在 📌 右键菜单里。

设计上的可靠性:

• 便签崩溃会被 launchd 自动拉起;只有你从 📌 菜单主动「退出」才真正停。
• 多屏/换显示器导致窗口跑到屏幕外时,召回会自动把它夹回当前屏幕。
• 看板为空时窗口会缩成一张小卡片(「清空啦 🎉」),属正常。

数据 & 运维

• 数据:~/.taskboard/tasks.db(真相源)+ board.md(人类可读镜像,可 git)
• 日志:~/.taskboard/daemon.log / sticky.log
• 配置:~/.taskboard/config.json(端口、默认截止时刻、催促间隔、晨报时间、ntfy)
• 重启:launchctl kickstart -k gui/$(id -u)/com.taskboard.{daemon,sticky}
• 卸载:launchctl unload ~/Library/LaunchAgents/com.taskboard.{daemon,sticky}.plist