Repository navigation
v1.50.2-CN
v1.50.2-CN Release Notes
上一个版本:v1.50.1-CN
这是一个增量收尾版本:上游没有对应的
v1.50.2tag,本版本号用于收纳 v1.50.1-CN 之后完成的工作,由三类内容组成 ——
① v1.49.3..v1.50.1 差异分类中顺延下来的收尾项(B14 / B15,详见 doc-9 与 doc-10);
② 新上游范围v1.50.1 .. v1.51.0的首个拣选(上游 BACK-222.1 的模态框父子层级);
③ fork 自研特性与缺陷修复(全局搜索对话框及其暴露出的模态导航历史栈问题)。
未迁移 / 未跟进的条目见文末。
🎯 主要亮点
- 全局搜索对话框(BACK-624):Web UI 新增 macOS Spotlight 风格居中搜索对话框,
Ctrl+K/Cmd+K随时唤起,绑定/search路由,一屏检索任务、草稿、文档、决策与 Wiki 页面;单列分组、关键词与 ID 高亮、手写定高虚拟列表、后退还原滚动位置、窄屏全屏两行布局。取代了此前只能显示 5 条结果的侧边栏内联搜索。 - 任务模态框父子层级(BACK-628):任务详情模态框标题下方新增 PARENT 行与可折叠 SUBTASKS 区(完成计数 + 进度条 + 逐行钻取),无需离开模态框即可上下浏览层级。
- 模态导航历史栈修复(BACK-627):钻取后点击返回箭头改为 pop 而非 push,历史栈与模态栈严格 1:1 —— 关闭一次即回到背景页,不再需要"每钻一层多按一次关闭"。
- 上游收尾项落地:任务 JSON 输出补齐验收标准进度(BACK-625 ← 上游 BACK-622,分类项 B14);mermaid 升级到
11.16.1清除 5 个 GHSA(BACK-626 ← 上游 BACK-598,分类项 B15)。
🔍 全局搜索(BACK-624)
- 入口:
Ctrl+K(Windows/Linux)/Cmd+K(macOS),或点击侧边栏的搜索触发按钮;侧边栏原有的内联搜索框与结果下拉已移除。 - 路由即状态:绑定
/search?q=<关键词>&type=all|task|doc|wiki|decision。打开用 push、输入与切换过滤用 replace(不增长历史栈)、关闭(Esc / × / 遮罩 / 浏览器后退)统一navigate(-1);底层页面保持挂载并锁定滚动。 - 结果呈现:单列分组列表(任务 → 文档 → Wiki → 决策),表头可折叠并显示数量;行内展示类型图标、资源 ID、标题与状态/优先级胶囊;关键词与资源 ID 均按服务端返回的匹配区间高亮;结果数量不设上限。
- 虚拟滚动:手写定高窗口化列表(无新增依赖),行高按视口模式取常量(桌面 56/28、窄屏 64/32),滚动位置以"首个可见行索引"而非像素写入
location.state,后退时稳定还原;resetKey变化时回到顶部。 - 键盘优先:
↑/↓移动选中、Enter打开、Esc关闭;焦点陷阱与输入自动聚焦。 - 导航落点:任务/草稿以
/task/:id/:slug模态打开,关闭后回到对话框且查询、过滤、滚动位置保留;文档/决策/Wiki 作为整页路由 push(可后退回到对话框)——只有模态目标才携带backgroundLocation。 - 视口适配:宽度 < 640px 时对话框转全屏,结果行改为定高两行(标题 / ID + 标签),虚拟滚动与位置还原行为不变;输入字号 28px(窄屏 32px,且不低于 16px 以避免 iOS 聚焦缩放)。
- 服务端影响:唯一改动是把
/search与/search/*加入 SPA 静态路由表(否则刷新或分享链接会 404)。GET /api/search的处理逻辑未变 —— 它本就支持不设上限、类型过滤、Wiki 内容检索与高亮索引,旧的 5 条上限纯粹是客户端行为。 - 共享化:状态/优先级胶囊配色抽取为
src/web/utils/task-badge-colors.ts,TaskList 与 DraftsList 共用同一实现。 - 国际化:新增
searchDialog命名空间,四种语言(en / ja / zh-CN / zh-TW)同步。 - 验证:31 个
search-results单元测试覆盖分组、折叠、高亮区间合并、ID 高亮与索引还原;全量测试 2241+ 通过;真实浏览器逐条走查全部 8 条验收标准。
📊 任务数据与 JSON 输出(BACK-625)
- 任务摘要 JSON 新增
acceptanceCriteriaCompleted与acceptanceCriteriaCount,无验收标准的任务返回0/0。 - 字段经同一个
toTaskSummaryJson漏斗产出,因此task list、task view与search的任务结果三处同时获得该字段,无需逐面接线。 - 字段命名刻意与上游保持一致,便于跨 fork 消费方复用。
- 既有的日期字段(
dueDate、plannedStart/End、actualStart/End)、normalizePublicDate本地化与详情层清单结构均未改动。 - 验证:聚焦测试 9 通过 / 81 断言,覆盖完整(1/1)、部分(1/2)、空(0/0)三种进度;在本仓库端到端冒烟确认
task list/view/search --json一致输出。
🔐 依赖安全(BACK-626)
-
mermaid
11.15.0→11.16.1(精确固定),一次性清除 5 个已公开公告:GHSA 类型 GHSA-rhh3-jpg6-66xhradar 图 DoS GHSA-c4c3-pg64-4m4v配置原型污染 GHSA-6x64-9x62-f2gxCSS 注入(可影响兄弟元素) GHSA-3rrr-jr9j-h3q3architecture 图原型污染 GHSA-2v8p-3f2j-5mp7XY 图死循环 DoS -
真实暴露面:mermaid 不是 dev-only 依赖 —— 预构建的浏览器 bundle 被打进编译后的 CLI 二进制,并在回环 Web UI 中渲染任务与文档的 Markdown;
securityLevel: strict能挡住脚本注入,但挡不住 CSS 注入与原型污染两条。 -
版本选择:当时最新的干净 11.x 是
11.17.2,本版本选择11.16.1—— 已清除全部五个公告,且已带公开发布的深度供应链验证与约五周公开暴露。 -
锁文件:
bun.lock中可归因于本次升级的改动仅 7 行,落在 mermaid 子树(mermaid、@braintree/sanitize-url、@mermaid-js/parser、cytoscape、dayjs、katex及根 spec);其余 150 行删除是未改动树上执行bun i也能复现的孤立条目清理。 -
bun.nix:六个条目的 name/url/hash 手工更新(生成器需要 Docker 或 Nix,本环境不可用),每个哈希与 lockfile 记录的 sha512 integrity 逐字节一致。注意本 fork 没有 Nix CI 校验(无 nix job、无 bun2nix 守护),字节级交叉核对是当前唯一保证。 -
验证:
bunx tsc --noEmit、bun run check .、src/test/mermaid.test.ts(3 通过)、bun run build产物含 11.16.1 标记并正常报版本。
🖥️ Web 界面
- 父子任务层级区块(BACK-628):任务详情模态框标题下方按需渲染层级区块,两种形态:
- PARENT 行:向上箭头图标 + PARENT 标签 + 父任务 ID、标题与右侧状态徽章;点击该行在模态框内打开父任务。
- SUBTASKS 区:图标 + SUBTASKS 标签 + 完成计数(如
1/6)+ 进度条 + 折叠箭头;整行(不止箭头)可点击展开/折叠;子任务行显示完成指示圆点(已完成/未完成)、ID、标题、状态徽章与钻取箭头,点击即在模态框内打开。 - 无父任务且无子任务时不渲染该区块,模态框的布局、尺寸与展开行为与之前完全一致。
- 解析全部在客户端基于任务语料完成:父任务查找与子任务筛选均使用前缀无关的规范化 ID,子任务按 ID 排序;模态框新增可选的
availableTasks入参。
- 返回箭头与关闭语义统一(BACK-627):钻取返回箭头由"push 父任务 URL"改为
navigate(-1),与浏览器后退、×/ 遮罩关闭保持同一语义 —— 每次都精确消费一个历史条目。修复前钻取后返回会留下未消费的子任务历史条目,导致后续关闭又落回子模态框。 - 搜索对话框与既有模态共存(BACK-624):任务模态框关闭时在有背景页的情况下 pop 而非 replace,避免每次从搜索打开任务都为
/search累积一条历史;文档/决策/Wiki 结果按整页路由打开,不挂背景。
🐛 缺陷修复
- 钻取后返回留下过期历史条目(BACK-627):
handleBack的 push 语义使历史栈与模态栈失去 1:1 对齐;改为 pop 后,"返回箭头 → 关闭"两步即可从子任务回到背景页。 - 浏览器 bundle 被拖入 Core 导致白屏(BACK-628 执行中发现):层级区块最初从
src/utils/task-path.ts导入 ID 比较函数,该模块间接依赖 Core,被打包进浏览器 bundle 后 Web UI 直接白屏;改用纯模块src/utils/task-id.ts的canonicalTaskId。类型检查与renderToString测试都不会暴露此类问题,只有真实浏览器加载才会 —— 已在 wiki 中固化为"浏览器代码只导入纯模块"的约定。
⚙️ 版本与发布
- 本版本不含 CLI 命令面改动,无需迁移步骤;升级后首次启动
backlog browser时/search路由即生效。