11 August 2026, 16:00 (CST)
2026年08月11日 16:00(东八区 / 北京时间)
看板详情页:Trello 1:1 重构 · 规则引擎升级 · GUI 编辑器布局重设计
概述
本轮先以产品经理视角调研 Trello(官方 Support 文档 + 开源仿 Trello 项目 Planka / Kan / kanbany),对照自建看板做差距分析;随后:
- 看板详情页 UI 全盘对齐 Trello(头部/背景/列/卡片正面/筛选/菜单抽屉/快捷添加);
- 规则映射引擎新增
@done、@cover、列级@sort/@sort-order,Front Matter 新增board_bg/favorite; - GUI 编辑器由“单列长表单”重构为 Trello 式「画布 + 检查器」 双栏布局;
- 映射文档与 nanolog 同步更新。
按需求排除复杂功能:附件、成员/角色指定、评论、Power-Ups/Butler 自动化、贴纸。
1. Trello 调研结论(功能矩阵)
| Trello 元素 | 核心功能 | 本轮采用 | 说明 |
|---|---|---|---|
| 看板 Board | 标题 + 收藏星标 | ✅ | extra.favorite,星标状态写入 Markdown |
| 看板背景 | 纯色 / 图片 / 渐变 | ✅ | extra.board_bg + 12 种预置渐变 + 自定义 |
| 看板菜单 | 关于 / 背景 / 搜索 / 更多 | ✅ | 右侧抽屉 |
| 筛选 Filter | 关键词 / 标签 / 截止 / 成员 / 保存视图 | ✅(去成员/保存视图) | 快捷键 F |
| 列表 List | 头部(名+计数+⋯菜单)/ 添加列表 / 拖拽排序 | ✅ | 排序(截止/优先级/标题/清单)、重命名、删除、拖拽列头 |
| 卡片正面 | 标签 / 标题 / 徽标行 / 封面 | ✅ | 标签药丸、封面 @bg+@cover、徽标行 |
| 截止徽标 | 灰/黄/红/粉/绿 状态色 | ✅ | dueState() 5 态 |
| 清单进度 | 卡面进度条 + x/y | ✅ | checklistStats() |
| 标记完成 | 卡面圆圈打勾 | ✅ | @done 指令 |
| 快捷添加 | 列底“+ 添加卡片” / 右侧“+ 添加列表” | ✅ | 解锁模式,保存走 Edit Post |
| 归档 / 评论 / 成员 / 附件 / Power-Up / Butler | — | ❌ | 需求排除 |
2. 详情页 UI 重构(Trello 1:1 对齐)
2.1 看板头部
返回链接 → 标题 + 收藏星标 → 元信息行(开始/截止/剩余天数/进度/星级)→ 工具栏。
工具栏(管理员可见):锁定 / 筛选(F)/ 菜单 / GUI 编辑 / Edit Post / ReDeplog / 映射说明。
2.2 背景
extra.board_bg 驱动 .kanban-page 背景;深色背景自动切换浅色文字(has-board-bg)。菜单抽屉内提供 12 色渐变 + 默认 + 自定义输入。
2.3 列
头部 = 列名(解锁后双击内联重命名)+ 计数 + ⋯ 菜单;菜单含:添加卡片 / 排序(手动/截止/优先级/标题/清单,升/降序)/ 删除列。解锁后列头可拖拽调整顺序。
2.4 卡片正面
标签药丸(带文字、浅色自动深字)· 封面条(@bg,@cover full 加高)· 完成圆圈(有 @due 时显示,切换 @done)· 徽标行(描述 / 开始 / 截止 / 清单进度 / 优先级)。
截止徽标色义(Trello):灰=未到 · 黄=今天/即将到期 · 红=逾期 · 粉=逾期超 1 天 · 绿=已完成。
2.5 筛选与菜单抽屉
- 筛选弹层:关键词 + 标签多选 + 截止状态 + 最低优先级 + 隐藏已完成;列计数实时显示
可见/总数;清除一键复位。 - 菜单抽屉:关于此看板(进度条)· 背景色板 · 搜索卡片(回车进入筛选)· 更多(GUI 编辑 / 保存 / ReDeplog / 映射说明)。
2.6 快捷添加
解锁后每列底部「+ 添加卡片」、看板右侧「+ 添加列表」,内联输入回车提交;所有本地修改(拖拽/勾选/排序/添加/背景/收藏/完成标记)统一提示“有未保存的本地修改”,保存走 Edit Post。
3. 规则映射引擎升级(kanban-rules.js)
| 新增 | 语法 | 说明 |
|---|---|---|
| 完成状态 | @done / @complete | 卡片 done 布尔,截止徽标变绿、标题划线 |
| 封面尺寸 | @cover half / full | 默认 half;配合 @bg 使用 |
| 列排序 | @sort manual/due/priority/title/checklist | 列对象 sort 字段 |
| 排序方向 | @sort-order asc/desc | 列对象 sortOrder 字段 |
| 看板背景 | extra.board_bg | 预置色名 / 色值 / gradient |
| 收藏 | extra.favorite | 布尔,写入 front matter |
新增辅助函数:checklistStats()、dueState()(5 态截止徽标)、sortCards()、resolveBoardBg()、BOARD_BG_PRESETS。解析器新增列级指令分支;序列化按新模型往返无损(4 个现有看板测试通过)。
兼容性说明:
@bg语义由“整卡背景色”调整为 Trello 封面(卡片正面顶部色块,正文白底),映射文档已同步。
4. GUI 编辑器布局重设计(Trello 画布 + 检查器)
| 区域 | 内容 |
|---|---|
| 顶部 | 模式徽标(新建/修改)· 标题 · 目标文件提示 · 关闭 |
| 左:画布 | 实时渲染看板(背景/列/卡片封面/标签/徽标);点击列或卡片选中;「添加列表」「添加卡片」直达 |
| 右:检查器 | 按选中对象切换:看板信息(含背景色板/收藏)· 列表设置(列名/排序/方向/增删移)· 卡片设置(全部 @ 指令,下拉/手输/色板/清单/描述) |
| 底部 | 可折叠 Markdown 预览 + 结果流程区(复制/创建/修改指引/Token 同步) |
原“单列长表单”改为“选中即编辑”,字段与指令一一对应,覆盖新增的 @cover、@done、@sort、board_bg、favorite。
5. 涉及文件
| 文件 | 作用 |
|---|---|
static/js/kanban-rules.js | 新指令解析/序列化、截止状态、清单统计、排序、背景预置 |
static/js/kanban-board.js | 详情页 Trello 渲染、筛选、菜单抽屉、快捷添加、列拖拽、脏状态 |
templates/kanban.html | 新头部/筛选栏/菜单抽屉结构 |
static/js/kanban-editor.js | 画布+检查器编辑器、字段映射、复制、创建/修改流程、Token 同步 |
templates/partials/kanban_editor.html | 编辑器模态框新结构 |
sass/kanban/style.scss | 详情页 + 编辑器新样式 |
content/kanban/kanban-mapping.md | 新指令/字段/布局文档 |
6. 验证
node --check三个 JS 全部通过;- 规则引擎往返测试:现有 4 个看板列/卡片无损;新指令(
@done/@cover/@sort/board_bg/favorite)生成→解析→再生成全部保留; zola build无错误,verify-kanban-build通过(4 周看板完整);- 明细页 HTML 已包含筛选栏/菜单抽屉/收藏星标/编辑器画布等新节点。
7. 后续计划
- 真机浏览器走查:剪贴板权限、拖拽、弹层定位、深色主题;
- 卡片/列表“归档 + 恢复”(Trello Archive);
- 筛选条件保存为视图(URL hash);
- 编辑器移动端布局细化。