设置与主题
设置页面集中管理 Backlog.md 的配置项、Definition of Done 默认值和 Web 界面主题偏好。任务编辑器也在设置相关区域中提供丰富的编辑能力。
进入设置页面
启动 Web 界面后，点击顶部导航栏的「设置」标签，进入设置页面。页面分为多个配置区块，从上到下依次排列。
查看与修改配置项
在「配置」区块中，可查看并编辑当前生效的各项参数，包括：
- 默认负责人（
defaultAssignee）：列表型设置，创建任务/草稿未显式指定负责人时自动应用 - 标签（
labels）：项目预定义标签列表的编辑器 - 默认编辑器（
defaultEditor）：清空该字段即可取消默认编辑器（服务默认的code --wait会挂住无人值守的代理进程） - Web 服务器端口：
defaultPort与自动端口开关（端口被占用时自动改用后续可用端口） - 隐藏空状态列（
hideEmptyColumns）：开启后看板隐藏无任务的状态列，减少视觉杂乱；拖拽任务期间所有状态列保持可见以便放置 - 自动打开浏览器（
autoOpenBrowser） - 任务解析策略（
taskResolutionStrategy）：同名任务存在于多个分支时的冲突解决策略——最新（most_recent，取最近修改的版本）或最完整（most_progressed，取状态推进最远的版本，同进度再比修改时间）；新项目初始为most_recent - Advanced Settings 跨分支三开关：Task Resolution Strategy 下方依次是 Cross-Branch Tasks（
includeCrossBranch，默认关——扫描到的其他分支任务是否进入看板/任务列表/搜索）、Check Active Branches（checkActiveBranches，默认开——是否扫描其他本地分支，同时决定任务 ID 分配的候选分支集）与 Active Branch Days（activeBranchDays，默认 30 天，仅扫描开关打开时显示） - 图表引擎（
diagramEngine）：Mermaid 图用哪个引擎渲染——pele（默认，Obsidian 团队开源、零依赖、把 Mermaid 12.1.0 语法渲染为 SVG）或mermaid（11.16.1 回退）；选择持久化到config.yml的diagram_engine键，重启浏览器后依然生效，仅影响 Mermaid 图、不影响 ECharts 数据图 - Git 相关选项（详见配置管理）
点击需要修改的配置项，在输入框中输入新值，修改完成后点击「保存」按钮。配置变更会立即写回项目配置文件，部分设置（如端口）在重启 backlog browser 后生效。
列表型设置（默认负责人、标签）以列表编辑器呈现：可逐项添加或删除条目，保存时写回配置文件的 YAML 列表。这些设置与 backlog config set 修改的是同一份配置，两个入口互相可见。
默认负责人在创建任务时生效：不指定负责人则套用默认值；显式指定会完全替换默认值（不合并）；在创建表单中清空负责人 chips 则保存为空，不会回落默认值。
状态机编辑器
设置页提供状态机编辑器，可视化维护 backlog/config.yml 中对象形式的 statuses 配置——此前只能手工编辑 YAML。编辑器为左右布局：
- 左侧状态卡片列表：增删改状态（名称
name、类别category、退出动作exit、是否显示display），并维护每个状态的next迁移边（目标to、条件when、AI 自治层级ai、前提if、所需证据requires/evidence）；支持多选终态 - 右侧 Mermaid 实时预览：以初始状态为根沿
next递归展开的迁移树，回边与环降级为虚线回引、不会无限展开 - 布局切换：可在卡片布局与 Tab 布局之间切换
两个恢复按钮语义严格区分：
- Reset：仅在有未保存改动时出现，丢弃修改并从
config.yml重新加载当前内容（绝不覆盖文件） - Default：用内置的七列默认状态机整体替换当前配置（相当于恢复出厂值）
状态机只声明、不强制：编辑器可以展示 lint 警告，但不会阻止保存；保存后服务端广播 config-updated，看板列与终态判定立即刷新。AI 侧的三份 overview（CLI backlog instructions overview、MCP 资源与指令工具）会自动渲染同一份状态机，代理按声明的机器工作。状态机的语义详见任务生命周期。
终态集合由状态机派生、仅此一处可改：设置页曾有一个 "terminal status" 多选，但它并不存储列表、而是悄悄改写各状态的 category——与状态机编辑器写同一字段造成混乱。现在设置页只以只读区块展示派生的终态集合（如 Done、Dropped）并注明来源；backlog config list 也会打印 terminalStatuses: [Done, Dropped] (derived from statuses)。要增删终态，请在上方状态机编辑器中修改对应状态的 category。
编辑 Definition of Done 默认值
在「Definition of Done」区块中，可查看和编辑新建任务时自动附加的默认完成标准清单。
点击文本编辑区，输入或修改 DoD 条目，每行一条。保存后，后续通过 Web 界面或 CLI 创建的新任务将自动携带更新后的默认 DoD 列表。
自定义 Web UI 主题
在「主题」区块中，可切换界面外观：
- 跟随系统 — 自动匹配操作系统的亮色或暗色模式设置
- 亮色模式 — 强制使用浅色背景主题
- 暗色模式 — 强制使用深色背景主题
切换后，整个 Web 界面的配色方案即时生效，无需刷新页面。偏好设置会保存在浏览器本地，下次访问时自动恢复。
语言切换
在「项目设置」区块的「语言」下拉框中，可选择 Web 界面的显示语言：
- English — 英语
- 日本語 — 日语
- 简体中文 — 简体中文
- 繁體中文 — 繁体中文
选择语言后，界面文字会立即切换，无需刷新页面。语言偏好与项目配置一同保存到 backlog/config.yml（或项目根配置）的 locale 字段中，下次启动 Web 界面时自动恢复。
语言设置需要通过「保存更改」按钮写入配置文件后才会持久化。在保存前切换语言，页面会即时预览新语言，但刷新后会恢复为上次保存的设置。
使用任务编辑器
在 Web 界面中点击任意任务，即可进入任务编辑器页面。编辑器提供丰富的富表单和 Markdown 编辑能力。
富文本 Markdown 编辑器
任务描述区域使用 MDEditor 富文本编辑器。在编辑区中可直接输入 Markdown 语法，编辑器提供实时预览和常用格式快捷按钮：
- 标题层级
- 粗体、斜体、删除线
- 无序列表与有序列表
- 代码块与引用块
- 链接与表格
验收标准交互式勾选列表
在任务编辑器中找到「验收标准」区域。每条验收标准左侧带有复选框，点击即可标记为已完成或未完成。勾选状态会自动同步保存到 Markdown 文件的对应章节。
在 Web 弹窗的预览模式下连续勾选多条验收标准或 DoD 时，系统会把操作合并保存：停顿约 1 秒后才发送一次请求（携带完整的勾选数组），而不是每次点击都发请求；关闭弹窗前若有未保存的勾选会立即 flush，失败则回滚到服务器已知状态。这样过一遍长清单时不会产生请求风暴，看板与任务列表的刷新也更平稳。
若手动修改 Markdown 源文件中的验收标准格式，编辑器会在加载时自动修复和同步列表结构，确保复选框正常显示。
任务内容目录
对于内容较长的任务，编辑器右侧显示「目录」（TOC）面板。目录自动提取任务正文中的各级标题，点击任意标题即可快速滚动到对应位置。滚动页面时，目录会高亮当前所在章节。
富表单字段
编辑器顶部提供一组结构化表单字段，点击即可修改：
- 状态 — 下拉选择 Todo、In Progress、Done 等
- 优先级 — 选择 High、Medium、Low
- 标签 — 输入标签名称，支持多标签
- 里程碑 — 下拉选择已有里程碑或留空
- 负责人 — 输入负责人名称
- 依赖 — 添加依赖的其他任务 ID
- 引用 — 添加引用任务或外部链接
修改任意字段后，点击页面底部的「保存」按钮，变更将写回到 Markdown 文件。
Mermaid 图表自动渲染
若任务正文中包含 Mermaid 语法代码块，Web 界面会自动将其渲染为可视化图表，包括流程图、时序图、甘特图等。无需额外操作，保存任务后图表即时呈现。默认用 Pele 引擎渲染，可在设置页的 Diagram Engine 下拉切换为 Mermaid 11.16.1 回退（见上方「图表引擎」配置项）。
图片与附件查看
任务中引用的图片（如 ）会在编辑器中直接显示预览图。点击预览图可在新标签页中查看原图。
项目 backlog/assets/ 目录下的文件会自动通过 Web 服务器提供访问，确保所有附件和截图在 Web 界面中正常加载。