CoffeeCatKanBan

Obsidian 原生 Markdown 任务看板插件，一个任务对应一篇笔记，支持看板、数据表和月历。

当前版本

0.4.0 开发候选版本，仅桌面端。声明最低 Obsidian 1.10.0，最低版本及完整宿主验收尚未通过。

• 三视图可变高度虚拟列表：单列表超过 80 项启用，保留聚焦/拖动行、Tab 连续导航、滚动位置及末尾定位，逐项渲染错误隔离。
• 分批读取及解析扫描，通过 MessageChannel 让出主线程；严格写入校验、完整身份检查、外部事件失效和停用保护保留。
• 全局设置接入原生搜索，保留旧版 display 兼容；显式保存、失败草稿、关闭及重开保护仍有效。
• 本地候选包脚本生成运行文件、完整依赖许可、安装回退说明和 SHA-256 清单，不自动上传发布。

已实现功能

• 多看板创建和切换，自定义列、默认列和完成列。
• 新卡片默认归入主看板同目录下的 "看板文件名-卡片" 子文件夹, 新建窗口显示实际保存位置
• 任务创建，标题、日期、优先级、标签和负责人编辑，原生编辑器负责正文。
• 拖拽/菜单/键盘移动、完成恢复、归档恢复、复制和单独确认删除。
• 三视图共享数据，搜索筛选、双向排序、月历日期新建、页签状态保存。
• 批量完成/归档与逐项反馈，字段撤销，先预览再确认的列顺序修复。
• 普通笔记原地转任务，正文预览、笔记关联、附件引用打开及失效链接提示。
• 增量读取、解析缓存和无变化显示快照；手动重新读取可强制重建。

卡片文件归档

默认结构为 项目/项目看板.md 与 项目/项目看板-卡片/卡片标题.md, 首张卡片创建时自动建立子文件夹, 同名卡片按序号避让

新建看板的 "新任务文件夹" 相对于看板所在目录, 留空按看板文件名分类, 也可指定子文件夹名称或多级路径

已有看板的任务目录若与主看板同级或位于其他目录, 后续新建改用主看板旁的专用子文件夹; 已配置在主看板目录下的子文件夹继续使用。已有卡片保持原路径和归属, 复制仍保留源文件夹以保持正文相对链接含义

安装和回退

本地生成候选包使用 npm run release。将包内 main.js、manifest.json、styles.css 放入库内 .obsidian/plugins/coffeecat-kanban/，再在 Obsidian 中启用插件。

升级前备份旧版三个文件。回退时停用插件、恢复备份并重新启用，不恢复整个笔记库。卸载插件不自动删除任务或看板 Markdown。

长列表操作

超过 80 项的列、数据表或月历任务列表按可视区域渲染，通过列表滚动条访问其余任务。Tab 可连续访问尚未挂载的任务，明确勾选的任务不会因滚出窗口取消选择。搜索和计数覆盖完整筛选结果。

手动排序时使用卡片握柄拖动。“添加任务”按钮下方代表完整列末尾，菜单上下移动按完整列计算，包含筛选隐藏项。

开发验证

要求 Node.js >=22.12.0，依赖版本已锁定。

• npm run check：模块边界、严格类型、lint、受控测试和构建。
• npm run test:browser：先将 CCKB_BROWSER 设为本机 Edge/Chromium 可执行文件绝对路径，不下载浏览器。
• npm run bench:disk：在工程临时目录生成并清理 100/1000/5000 条合成 Markdown，记录索引性能。
• npm run release：检查并生成 .cache/releases 下的独立候选目录。
• node scripts/verify.mjs：校验工程及上级知识库的元数据、链接和临时文件。

浏览器回归使用生产渲染模块、真实 Chromium DOM 与最小宿主控件替身，不等同于 Obsidian 验收。磁盘基准不清空系统文件缓存。

当前限制

• 最新候选包未部署到真实测试库，宿主设置搜索、真实拖拽、回收恢复、多页签/未保存编辑冲突、停用重启、默认主题及最低版本仍待验收。
• 单个超大 YAML 解析和共享队列慢读仍可能延迟操作，分批调度不是后台线程或跨文件事务。
• 撤销仅覆盖受支持字段操作；正文、新建、复制、删除、列管理、笔记转换不属于字段撤销，重启不保留撤销历史。
• 移动端、提醒、重复任务、周/日视图、附件导入管理、跨页签拖放不在首版范围。

开发文档

• 开发指令
• 当前进度
• 需求与规划
• 开发与验证
• 数据与文件安全

本目录是插件工程，上级开发知识库是独立 Obsidian 库。

许可

MIT，见 LICENSE。打包包含 yaml 的 ISC 许可和 fractional-indexing 的 CC0-1.0 声明。