一个常驻桌面的任务小挂件：平时缩在屏幕角落当一条小小的「胶囊」，只显示当前最重要的一件事；点开变身为任务面板；再点一下还能展开全功能看板（拖拽卡片改状态、筛选、搜索、详情编辑全都行）。
它最特别的地方是：你和你的 AI 助手共用同一块任务板。
📖 场景：你对 AI 说「帮我整理一下这个项目的待办」，AI 把任务一条条建好——几秒后它们就出现在你屏幕角落的挂件上。你拖着卡片推进度，AI 也能看到最新状态接着干活。双方不会互相覆盖对方的操作。
不需要装数据库软件，不需要开浏览器，不需要启动任何服务——所有数据存在你电脑上的一个文件里（SQLite），装好就能用。
| 形态 | 大小 | 什么时候用 |
|---|---|---|
| 🟢 胶囊（默认） | 280×56 的小条 | 常驻屏幕角落，扫一眼当前任务；多个任务自动轮播 |
| 📋 面板 | 360×520 | 点胶囊展开：任务列表、新建任务、一键流转状态、看详情写评论；详情信息结构与全版看板同口径（meta 行图标+标签摘要、描述→标签→评论分区），标题/描述/优先级/截止日点击就地编辑、标签勾选与新建（v0.4.0） |
| 🗂 全版看板 | 独立大窗口 | 面板顶部点「⛶」图标打开：七列看板拖拽、筛选搜索、标签、附件、归档、撤销、设置（⚙ 含检查更新） |
💡 关闭挂件 ≠ 退出：点 × 只是收进系统托盘（常驻后台），托盘左键随时唤回；托盘右键 →「退出」才是真正退出。新版本发布时 ⚙ 齿轮上会出现小圆点提醒。
🎁 普通用户免构建：直接到 Releases 下载
taskdeck-widget_x64-setup.exe，双击安装（自带桌面快捷方式与开机自启选项），装完即用——下面 4 步是给需要 AI 命令行或想改代码的人的完整路径。
装三样东西，都是下一步下一步的常规安装：
| 要装什么 | 用来干嘛 | 下载地址 |
|---|---|---|
| Node.js 22.5 以上 | 仅在未构建挂件 exe、AI 命令行走 Node 回退脚本时需要 | nodejs.org（选 LTS 版本即可） |
| Python 3 | 运行本项目的启动脚本 | python.org（安装时勾选 Add to PATH） |
| Rust 工具链 | 只在第一次构建挂件时需要 | rustup.rs（装完重开一次终端） |
💡 v0.4.0 起 AI 命令行优先走挂件 exe 的 CLI 双模式（
taskdeck-widget.exe taskctl ...），构建过 exe 就不需要 Node。如果暂时只想用 AI 命令行（不想要桌面挂件），装 Node.js 走回退路径也够。
git clone https://github.com/Teddysht/TaskDeck.git
cd TaskDeck（也可以直接下载 ZIP 解压，效果一样。）
python skill/taskboard.py taskctl issue create --project local --title "我的第一个任务"看到一段 JSON 输出、里面有任务编号（LOCAL-1 这样的格式）就成功了。v0.5.0 起写命令的 --thread-id 自动注入（环境变量 > config.json > 首次生成并持久化），也可以显式传。
📦 数据层自研，克隆即可用：
taskctl的数据层是仓库内自研实现（cli/database.mjs，基于 Node 24 内置的 node:sqlite），与桌面挂件共用同一个 SQLite 文件——不需要安装数据库软件，也不依赖任何外部代码快照或后台服务。
# 第一次需要构建（约几分钟，之后不用再跑，除非你改了代码）
cd widget
npm install
npm run build
cd src-tauri
cargo build --release
cd ../..
# 启动挂件——屏幕右上角出现小胶囊
python skill/taskboard.py widget点一下胶囊 → 展开面板 → 能看到刚才建的任务。点面板顶部的「⛶」图标 → 打开全版看板。
完成！ 🎉 想关掉挂件：python skill/taskboard.py widget stop。
- 看进度：瞄一眼角落胶囊即可；点它展开完整列表。
- 加任务：面板里点「新建任务」；或让 AI 加（见下节）。
- 推进度：面板里点任务旁的状态按钮；或全版看板里把卡片拖到对应列。
- 等验收 / 被阻塞：AI 把任务推到待评审或标记阻塞时，Windows 右下角会弹系统通知——点通知直接跳到该任务详情，不用自己找。
- 改错了：全版看板里按
Ctrl+Z撤销。 - 搜任务：全版看板里按
/直接跳到搜索框。 - 换深浅色：面板右上角有主题切换按钮。
- 数据在哪：
TaskDeck/.data/taskboard.sqlite——一个文件就是全部数据，备份它就是备份所有任务（装版独立运行时在%APPDATA%\Vibe-TaskDeck，见下方「从仓库版迁移到安装版」）。
本项目的核心玩法。把 skill/ 目录交给你的 AI 助手（Claude Code / Codex 等）作为技能（skill）安装，之后直接用自然语言吩咐：
「帮我把登录 Bug 建成紧急任务，然后认领它开始修」
AI 会通过 taskctl 命令建任务、认领、推进、评审——每一步都实时反映在你的桌面挂件上。人和 AI 同时操作也安全：任务带版本号，谁改旧了谁的提交会被拦下来重试，不会互相覆盖。v0.5.0 起协议护栏内建到 CLI：backlog 未经授权不得开工、不接管其他会话认领的任务；AI 冷启动一条 sync 恢复上下文（游标自动持久化），认领一条 issue claim 原子完成。
完整的 AI 工作流协议（认领 → 推进 → 评审 → 完成）见 skill/SKILL.md。
一键安装（v0.5.2，推荐）：全版看板 → 设置 → AI 接入，自动检测本机的 Claude Code / Codex，点「安装」即可。安装时会自动生成 config.json 指向当前挂件 exe 与数据库——AI 装完即用，与挂件操作同一块看板，无需任何手工配置。覆盖安装即更新（skill 协议随挂件版本走）。手工安装：把 skill/ 目录复制到 ~/.claude/skills/Vibe-TaskDeck/ 或 ~/.codex/skills/Vibe-TaskDeck/，再参照 config.example.json 配置 exe 路径与数据目录。
📖 skill 管理命令速查（点开）
| 命令 | 说明 |
|---|---|
status |
看挂件进程、数据目录状态 |
widget / widget stop |
启动 / 停止桌面挂件 |
taskctl <子命令> |
AI 任务命令（本地直连数据库） |
stop |
停止本 skill 托管的挂件进程 |
clean --keep-data |
停止挂件、清状态，保留数据 |
clean --purge |
删除运行目录（不动任务数据，不可逆） |
clean --purge-data |
连任务数据一起删（会先停挂件，不可逆） |
安装包（taskdeck-widget_x.y.z_x64-setup.exe）安装的挂件独立运行（不经 skill/taskboard.py 启动），数据默认在 %APPDATA%\Vibe-TaskDeck；而仓库开发模式的数据在 TaskDeck/.data——两个位置，装版首次打开会是一个空库，旧数据没有丢，只是位置不同。两种迁移方式任选：
方式一：整库拷贝（推荐，简单直接）
# 1. 退出挂件（托盘右键 → 退出）
# 2. 整库 + 附件目录一起拷过去
Copy-Item "D:\your\path\TaskDeck\.data\taskboard.sqlite*" "$env:APPDATA\Vibe-TaskDeck\" -Force
Copy-Item "D:\your\path\TaskDeck\.data\attachments" "$env:APPDATA\Vibe-TaskDeck\" -Recurse -Force
# 3. 重新打开挂件
⚠️ 不要做「选择性迁移」（只挑部分任务 INSERT）——会丢评论、活动流，且附件存在磁盘attachments/目录里，漏拷即断链。新库是空的，整库拷贝零风险。
方式二：config.json 指回旧位置（v0.5.1+，不动数据）
新建 %APPDATA%\Vibe-TaskDeck\config.json，写一行：
{ "dataDir": "D:/your/path/TaskDeck/.data" }挂件与 taskctl（exe 双模式）都会读这个 dataDir，数据原地不动。优先级：环境变量 VIBE_TASKDECK_DATA_DIR > config.json dataDir > 默认位置。
v0.5.1 起，安装版首次运行在默认位置建空库时会弹系统通知提示数据目录位置与本迁移方法。
Q：挂件点开是黑的 / 全版看板打不开？
先 python skill/taskboard.py status 看挂件是否在运行；确认构建时 npm run build 和 cargo build --release 两步都跑过且没报错（顺序不能颠倒）。
Q：AI 建的任务，挂件上多久能看到？ 挂件约 5 秒轮询一次外部写入，最多等 5 秒就会刷新出来。
Q：系统通知（待评审 / 阻塞弹窗）不弹？ 按顺序检查：① Windows 设置 → 系统 → 通知，「获取来自应用和其他发送者的通知」总开关需打开；② 专注助手 / 勿扰模式是否拦截。挂件启动时会自动注册自己的通知身份（AUMID），正常免安装直跑也无需手动处理。
Q：能多人/多台电脑共享一块板吗？
当前版本是纯本机使用（单机全功能）。数据就是 .data 目录下那一个文件，想搬走/备份直接复制它。
Q：支持 Mac / Linux 吗？ 目前只支持 Windows（挂件依赖 Windows 的 WebView2 与窗口特性）。
Q：我的任务数据会被上传吗？
不会。任务数据纯本地存储（.data 目录下单个 SQLite 文件）。唯一的网络请求是启动时访问 GitHub 查询一次新版本（仅读取 Release 标题，不含任何本地数据；失败静默跳过）。
- 架构、构建、命令层、测试体系等实现细节：📘 技术文档
- 产品定位与边界：PRODUCT.md
- AI 工作流协议：skill/SKILL.md
- 跑测试：
cd widget; npm run build; cd tests; node run-all.mjs
基于 dashi-taskboard（Apache-2.0）封装与增强，本仓库同样以 Apache-2.0 发布。