Repository navigation
v1.50.1-CN
v1.50.1-CN Release Notes
上一个版本:v1.49.3-CN
本版本根据上游 MrLesk/Backlog.md
v1.49.3 .. v1.50.1(含v1.50.0与热修复v1.50.1)的变更差异(详见 doc-9 与 doc-10)有选择地迁移了适合本项目的部分,并按当前 fork 的定制做了适配。未迁移的上游改动见文末。
🎯 主要亮点
- CLI 性能回归修复(对应上游 v1.50.1 热修复):常用任务命令走本地工作副本快路径,不再为单次读取加载跨分支语料或抓取远端;跨分支加载本身改为增量快照 + 共享缓存,warm 读取从约 394 次 Git 操作降到 ≤3 次(BACK-600 / BACK-601 / BACK-602)。
- 并发编辑不再静默丢数据:第二个写入者会收到明确错误(Web 409 / MCP
OPERATION_FAILED),而不是悄悄覆盖(BACK-571)。 - defaultAssignee 全面生效:任务创建时自动指派默认值,支持显式取消指派(三态语义:未提供=用默认值、显式空列表=不指派),Web 创建表单预填可移除 chip(BACK-579 / BACK-581 / BACK-584 / BACK-585)。
- TUI 体验一致性簇:任务创建器修复、vim 键边界导航、filter 弹窗 vi 导航、隐藏空看板列(
Shift+H)、窗口标题含项目名、过滤提示统一(BACK-587 ~ BACK-591 / BACK-594)。 - 依赖就绪指引:CLI
--ready、TUI 详情行、Web 徽标、MCPready参数统一提示任务是否可以开工(BACK-615)。 - 里程碑升级:Web 里程碑详情页与编辑模态框、created/updated 日期字段、documentation 字段、归档/删除语义澄清(BACK-580 / BACK-618 / BACK-619 / BACK-622)。
⚡ 性能与架构(上游 v1.50.1 热修复)
- 本地快路径(BACK-600):
task view、task edit、task list等常用命令直接读取本地文件系统,不初始化 ContentStore、不触碰 Git;输出与旧路径完全一致。 - 增量跨分支加载(BACK-601 / BACK-602):为长驻表面(Web UI、看板、MCP)移植上游 BACK-624——不可变 tip 快照 + 共享 commit/blob 缓存 + 有界 fetch(10s 硬超时 + 60s ref 租约 + 请求合并),由带正确性门控的基准脚本守护。
- 有界远端操作:fetch 合并、限时、离线优雅降级,不再挂起(BACK-602)。
- 注意:fork 保留了跨分支可见性设计,CLI 本地未命中时仍会回退到跨分支解析(与上游「本地优先且不回退」的行为差异是有意的)。
📝 任务创建与编辑
- 列表字段 set 语义(BACK-577 / BACK-578):
task edit的--ref/--doc/--dep统一为 set 语义,新增--add-*/--remove-*增量标志与--clear-*原子清空;空值报错并提示--clear-*(此处与上游「显式空值=清除」刻意分叉,保持 fork 语义一致,见 doc-10 CLI-4)。 - 并发编辑保护(BACK-571):per-task 文件锁(fail-fast,无等待/合并/重试),锁内重读,杜绝静默丢写。
- defaultAssignee(BACK-579):从文档化的死配置变为
string[]全表面生效,默认值应用在 core 创建漏斗层,一处生效、CLI/wizard/TUI/Web/MCP 全覆盖;配置 watcher 对畸形值有保护。 - 显式取消指派(BACK-584 / BACK-585):CLI/Web/MCP 三态载荷(absent / 显式
[]/ 列表);task create多重-a赋值与 edit 对齐。 - 可清空的 defaultEditor(BACK-586):
config set defaultEditor ""与init --default-editor ""两条清空路径。
🖥️ TUI
- 任务创建器修复(BACK-587):picker 初始高亮、itemRenderer 重复标签、help 弹窗裁剪三个缺陷修复。
- vim 键边界导航(BACK-588):
j/k在列表边界停留,方向键保持移交搜索,无需新配置键。 - filter 弹窗 vi 导航(BACK-589):移植 PR MrLesk#809,单选 filter 弹窗与创建器 picker 支持
j/k。 - 隐藏空看板列(BACK-590):
hide_empty_columns配置驱动 TUI,乐观翻转 + 失败回滚,退出时 await 挂起写入。 - 窗口标题含项目名(BACK-591):
formatTuiTitle共享助手,退出时恢复终端标题(含 tmux DCS 透传)。 - 过滤提示统一(BACK-594):看板与任务列表 footer 提示对齐,抽到
footer-content.ts常量。 - 焦点恢复(BACK-616):
applyFilters重建列表后不再丢失键盘焦点。
🖥️ Web 界面
- 隐藏列拖拽修复(BACK-573):
hideEmptyColumns开启时隐藏列在中途拖拽显示为放置目标(延迟一个 macrotask,避免 Chromium 原生拖拽被同步布局中止)。 - 任务列表适配(BACK-613):内容宽度列 + 弹性 Title,无横向滚动,过滤栏单行,主题化滚动条。
- 实体 ID 自动链接(BACK-614):Markdown 中的任务/文档/决策 ID 渲染为深链,输入端带前缀自动补全。
- 里程碑详情页(BACK-580):详情视图 + 编辑模态框,交互全面镜像任务详情页。
- 评论闭环(BACK-617 / BACK-623):preview 模式直接添加评论(反转此前的 edit-only 门控);
--remove-comment/--clear-comments全表面删除,Web 逐条删除 + 清空按钮。 - 对话框与空态(BACK-620 / BACK-622):References/Documentation 空态提示修复;里程碑归档/删除改用样式化模态框并澄清语义(仅 remove 修改任务文件)。
📄 文档、决策与身份
- decision 命令组(BACK-574):
backlog decision list/view/update+ 任务列表式双 pane 交互浏览器;generateNextDecisionId去重并移除 core→CLI 动态 import(BACK-576)。 - doc list 交互浏览器(BACK-575):复用同一双 pane 交互模型。
- doc create --plain(BACK-592)、doc view 消歧(BACK-598:裸 ID / 相对路径 / 标题 slug 三种引用形式)。
- 文档/决策身份 fail-closed(BACK-596):歧义立即报错(CLI 退出码 1 / 服务器 409 / MCP
AMBIGUOUS_ID/ Web 共享通知),错误附可直接运行的候选提示。
🤖 Agent 与 CLI 工作流
- wiki install 指引(BACK-570):CLI banner、agent nudge 与双 README 补充
backlog wiki install安装指引。 - agent 指南约定(BACK-572 / BACK-582):日期字段本地时区输入、多行字面
\n、禁用 bash ANSI-C 引号;agent 首轮必须先加载项目实况(backlog config list --plain)再作答;清理 MCP 指南中的死路径指导。
⚙️ 配置与数据一致性
- config 畸形值保护(上游 MrLesk#877 / MrLesk#882 适配):watcher 对坏值回退到最后一个好值,不再静默应用默认值或污染其他键的解析。
- gray-matter 缓存投毒修复(BACK-599):
frontmatter.ts作为唯一解析入口,空 options 禁用缓存,新调用点必须走该包装器。 - ContentStore 文档 watcher(BACK-595):身份寻址、重试退避、重命名/零填充 ID 对账、文件夹删除全套修复。
- identity-index 真实 bug 修复(BACK-612):从 stale
activeTasks重建改为从cachedTasks重建。 - launcher scoped 包名解析(BACK-621):从主包自身
package.jsonname 推导 scope,修复 BACK-550 引入的回归。 - BACKLOG_CWD 与运行时 Core(BACK-593):
createRuntimeCore()成为唯一 Core 构造路径,子目录/BACKLOG_CWD 场景读写一致。
🏗️ 里程碑增强
- created_date / updated_date 字段(BACK-618):随
{...spread}透传 + 实质变更投影自动刷新,零函数签名改动。 - documentation 字段(BACK-619):
--doc/--add-doc/--clear-docs,CLI/MCP/Web 经 MilestoneHandlers 一次实现三 surface。
🔧 测试与工程
- 测试稳定化簇(BACK-597 / BACK-603 / BACK-604 / BACK-606 ~ BACK-612):显式 per-test 超时、JSDOM 全局钉桩、主题自适应/i18n 断言同步,全量测试基线恢复到可信任状态。
- Windows 符号链接 checkout 成为 CI 环境契约(
core.symlinks=true,BACK-605)。
未迁移的上游改动(本次评估后跳过)
| 上游功能 | 原因 |
|---|---|
| 多行 flag 文档(MrLesk#864) | fork 已在 CLI/skill 实现 processCliEscapes,语义等价 |
| Rosetta stderr 泄漏(MrLesk#857) | macOS 专属探测,fork 无 rosetta 代码 |
| 浏览器初始化错误清 loading(MrLesk#842) | fork 已有 browser-loading-state.ts(BACK-566 定制) |
| 删死 TUI 视图文件(MrLesk#844) | fork 视图结构已自行裁剪 |
| ubuntu CI epoll 抖动修复 | fork 无 test-preload.ts / run-ci-tests.ts 两个前提,机制上不受困 |
TaskListFilter.ready 字段 |
Core 从不处理该字段(静默无操作),属死代码 |
| 上游 3 个服务端测试 | 依赖 fork 没有的上游路由/API,丢弃并记录理由 |
| CLI 本地未命中的 fail-closed 提示(LOCAL_TASK_LOOKUP_HINT) | fork 有意保留跨分支可见性回退,与本地优先快路径并存 |