11 August 2026, 16:00 (CST)
11 August 2026, 14:00 (CST)
2026年08月11日 14:00（东八区 / 北京时间）
看板 GUI 编辑器：新建 / 修改 · 剪贴板 · 创建与修改流程指引
概述
本轮为看板补充 GUI 编辑器：不再需要手写 @ 指令 Markdown，而是通过表单（下拉 / 手输）设置看板的每个“图标/指令“可选值，自动生成 Markdown 并复制到剪贴板，随后给出 创建 or 修改 的完整操作流程提示。
1. 入口
| 位置 | 按钮 | 模式 |
|---|---|---|
列表页 /kanban/ 页头 | ＋ 新建看板 | 新建：默认本周一～周日 + 五列（待办/进行中/已完成/资源/目标） |
| 列表页每张周卡片 | ✎ 编辑 | 修改：读取该周已有 Markdown 载入表单 |
| 明细页工具栏（解锁后） | GUI 编辑 | 修改：读取当前看板载入表单 |
2. 字段与指令映射（下拉或手输）
| 表单字段 | 生成指令 | 输入方式 |
|---|---|---|
| 开始 / 截止日期 | @start / @due | 日期选择 |
| 重要等级 | @priority 1–5 | 星级下拉 |
| 目标类型 | @goal complete / risk | 下拉 |
| 颜色标签 | @labels | 预设色块多选 + 自定义色值手输 |
| 背景色 / 顶栏色 | @bg / @top | 预设色名下拉 + 自定义 #RRGGBB + 实时色块 |
| 勾选清单 | - [ ] / - [x] | 逐行增删勾选 |
| 描述正文 | 其余 Markdown | 多行文本 |
| 列 | # 列名 | 列名输入 + 添加/删除 + 快速列 |
| 周起止 / 核心任务 / 星级 | Front Matter | 日期 / 文本 / 下拉 |
3. 生成 → 剪贴板 → 流程提示
- 表单右侧实时 Markdown 预览；
- 点「生成并复制到剪贴板」：
- 自动复制序列化后的 Markdown；
- 弹出流程提示，明确区分 创建 与 修改：
- 创建（文件不存在）：Codeberg 新建文件 → 粘贴 → 保存提交 → ReDeplog 部署 → 刷新列表；
- 修改（文件已存在）：Codeberg 覆盖文件 → 全选替换 → 保存提交 → ReDeplog 部署 → 刷新列表；
- 提供「打开 Codeberg 编辑器」「打开 ReDeplog」快捷按钮；
- 若已保存
kanbanToken，可「用 Token 直接同步到仓库」（POST 创建 / PUT 覆盖，复用原 API 逻辑）。
4. 权限调整
- 新建看板按钮：管理员模式可见可触发；
- Mac-Chrome 浏览器（UA / platform / userAgentData 三重检测，排除 Edge/Opera/Samsung）也放行；
- 卡片 ✎ 编辑 与明细页 GUI 编辑保持管理员门控。
5. 涉及文件
| 文件 | 作用 |
|---|---|
static/js/kanban-editor.js | 表单渲染、字段映射、序列化、剪贴板、流程提示、Token 同步、浏览器检测 |
templates/partials/kanban_editor.html | 编辑器模态框（列表页 / 明细页共用） |
templates/kanban_list.html | 新建看板按钮 + 卡片 ✎ 编辑 + 模态框 |
templates/kanban.html | 明细页 GUI 编辑 + 模态框 + 脚本 |
sass/kanban/style.scss | 编辑器样式 |
content/kanban/_index.md | 注册 js/kanban-editor.js |
content/kanban/kanban-mapping.md | GUI 编辑器文档 |
6. 验证
node --check语法通过；zola build无错误；verify-kanban-build通过（4 周看板完整）；- 用真实
kanban-rules.js做序列化往返测试：现有 4 个看板列/卡片/指令全部保持；新建模式全字段样例生成正确；校验边界（日期倒置、跨度 > 14 天、空列/空卡片）全部拦截； - Mac-Chrome 检测 7 种 UA 场景全部正确。
7. 后续计划
- 真实浏览器交互走查（解锁、弹窗、剪贴板权限）；
- 支持从 GUI 编辑器直接拖拽排序列 / 卡片；
- 编辑器表单的移动端布局优化；
- 历史看板一键“复制为本周模板“。