imdone-atom 插件已无法同步 imdone.io 服务，仅支持本地 tasks.md 和代码注释解析；需手动配置 taskFiles、确保标签格式（如 ::TODO），并检查 editor.showInvisibles 和 tree-view 状态；推荐改用 VS Code + Todo Tree 等替代方案。
imdone-atom 插件已无法同步 imdone.io
imdone-atom 依赖远程服务 imdone.io 实现跨设备任务同步，但该服务自 2024 年底起已停止运营。当前版本（v2.5.1 及更早）在启动或点击「Sync」时会报错：Failed to fetch https://api.imdone.io/... 或直接卡在 loading 状态。插件本地解析代码注释的功能仍可工作，但所有「云同步」「看板拖拽保存到服务器」「多人协作」相关逻辑已失效。
仅限本地看板：启用 tasks.md + 注释解析
imdone-atom 的核心能力——从代码中提取 // TODO、// FIXME 等标记并渲染为看板——不依赖网络。要让它真正可用，必须手动配置本地任务源：
- 在项目根目录下新建文件
tasks.md，内容格式为标准 Markdown 列表，例如：- [ ] Refactor auth middleware <!-- ::TODO --><br>- [x] Add unit tests for utils <!-- ::DONE -->
- 确保
imdone-atom的配置项taskFiles包含该路径（默认已包含tasks.md）；若需扫描其他文件，在config.cson中修改：imdone:<br> taskFiles: ["tasks.md", "src/**/*.js"]
- 代码内注释必须带明确标签，如
// TODO: fix race condition ::TODO—— 缺少::TODO后缀将不会被识别
看板视图打不开？检查 editor.showInvisibles 和 tree-view 状态
imdone-atom 的看板界面通过 Atom 的 pane 机制嵌入，常见打不开的原因不是插件本身问题：
-
editor.showInvisibles设为true时，某些旧版 imdone-atom 会因渲染冲突导致看板空白；临时关闭该选项再重启 Atom 即可恢复 - 如果 tree-view（左侧文件树）被完全关闭，imdone-atom 的侧边栏按钮可能消失；按
Ctrl+\（Windows/Linux）或Cmd+\（macOS）重新唤出 tree-view，看板入口才会显示 - 插件未激活：打开
Settings → Packages，搜索imdone，确认状态为「Enabled」；若显示「Disabled」，点击右侧齿轮图标手动启用
替代方案比硬扛 imdone-atom 更实际
imdone-atom 的看板逻辑简单、无维护、不兼容新 Atom 版本（1.58.x 之后的 patch 均未适配），且无法导出数据。如果你真需要看板式任务管理，直接用以下方式更可靠：
- 用 VS Code +
Todo Tree插件：实时高亮注释，支持正则过滤，右键快速跳转，零配置即用 - 纯文本管理：在项目里放一个
TASKS.md，用 GitHub Issues 或 Notion 同步——避免绑定任何编辑器生态 - 若坚持 Atom，改用
project-plus+ 手动分类文件夹：把TODO相关文件统一移到/pending子目录，靠 tree-view 视觉分组
imdone-atom 的本地解析功能还能跑，但它的「看板」本质是静态快照，拖拽状态不会写回文件，也不会触发 git commit 提示——这点容易被忽略，直到你发现改完看板后 reload 又回到原样。
