feat(settings): add a Projects page with a default project by jackwener · Pull Request #2446 · apache/maka

jackwener · 2026-08-07T13:52:05Z

改了什么

设置 · 偏好新增「项目」页：项目列表管理 + 默认项目。task #160。

为什么

项目管理原本散在各处——添加在 composer、重命名在侧栏行菜单，而「新对话从哪个项目打开」根本不是一个设置：它是「上次用过的那个」，由 project-root-controller 隐式决定，UI 上完全看不见也改不了。

三层规则（按优先级）

composer 里显式选了项目 → 该次对话用它（每次对话都能临时覆盖）
否则用设置里的默认项目
否则维持原来的 last-used 行为（没设默认的用户行为零变化）

「默认覆盖 last-used」而不是「仅在没有 last-used 时兜底」：几乎总是有 last-used，兜底式默认等于永远不生效，那就又是一个说话不算话的旋钮。

两个设计决定

存 projectId 不存路径。 catalog 持有 identity，项目 relink 到新位置后 id 不变；存路径会让这个偏好在目录移动后静默指向别处。

不可用项目不能设为默认（按钮禁用，且禁用态自述原因）。 与 #158「任何连接都能设默认」不同：连接失败是单次使用时才暴露、用户可以先设后修；而默认项目指向一个打不开的目录 = 每个新对话都坏，且修复手段（恢复目录）不在 app 内。预防优于降级。

默认项目失效（归档/目录没了）时，回退到 last-used 而不是让建会话失败，并且在设置页把降级说出来——静默降级和假控件是同一类谎。

范围说明

重命名 和 在访达中打开 这一版没进行尾 … 菜单：前者需要仓库里尚不存在的 inline-edit 原语，后者需要新 IPC（app:openPath 只认「当前项目」）。两个能力目前都还在侧栏行菜单里，没有任何能力丢失，作为后续小任务补。

怎么验证的

新增 4 个 main 侧解析测试：默认覆盖 last-used、显式选择覆盖默认、未设默认行为不变、默认失效时回退不炸。故障注入：把默认读取拆掉 → 恰好 1 个测试失败 → 装回全绿。
新增 e2esettings-projects.spec.ts + settings-projects fixture（三个 catalog 条目：可用 / 可用长路径 / 目录真的不存在）：列表渲染、不可用行显示「目录不可用」、禁用按钮的 aria-describedby 确实说明原因、设为默认后 Badge 互换且落盘、同时只有一个默认。
新增 3 个 core 归一化测试：未设即无偏好、已设存活、空白 id 丢弃。
typecheck / lint / format / build / knip（两个 workspace）全绿；desktop 1751、core 812 全过。
全量测试的既有失败 3 例（maka run process contract ×2、node:sqlite ×1）已确认为存量；runtime-host 那例是 Timing-sensitive tests fail under parallel workspace runner (concurrency=3) #2132 的负载下时序 flake，单跑 725/0 通过。

视觉

预览截图已过审（列表态 / 设为默认态）。截图过程中修掉三处：页头与节头「项目」标题重复、fixture 用编造路径导致整列渲染成不可用态、以及一个匹配不到 Astryx Item 的选择器。

Project management was spread across whichever surface happened to need it — adding lived in the composer, renaming in the sidebar row menu — and "which project does a new conversation open in" was not a setting at all. It was whichever project you used last, decided implicitly by `project-root-controller` and invisible from the UI. Settings · 偏好 · 项目 makes the catalog a first-class surface and gives the default a home. Three layers, in order: an explicit pick in the composer wins for that conversation; otherwise the configured default; otherwise the previous last-used behaviour, unchanged for anyone who sets nothing. The default is stored as a project id rather than a path, because the catalog owns identity — a relinked project keeps its id, so a stored path would silently point somewhere else after a move. A default that no longer resolves (archived, or the folder is gone) falls back to last-used rather than failing session creation, and the page says so instead of degrading silently. Unavailable projects cannot be made the default at all: unlike a model connection, where a failure shows up per use and the user can fix it after choosing, a default pointing at a missing folder breaks every new conversation and the repair is outside the app. The disabled control states that reason itself. Rename and reveal-in-folder are not in the row menu yet — one needs an inline-edit primitive this tree does not have, the other an IPC that can open a path other than the current project's. Both still work from the sidebar row menu, so no capability is lost.

jackwener · 2026-08-07T14:20:46Z

Review by maka-审美专家 — 通过：项目设置页全案落地——预览阶段过审的结构（页头/描述行三层规则/行式方言/不可用态）+ 解析逻辑插在 resolveDesktopSessionSelection 的天然三层接缝（composer 单次覆盖免额外判断）；「默认胜 last-used」测试带存在理由注释；降级可见且不把账算到新建对话头上；禁用态自述补齐并以 aria-describedby 实证（title 空断言的空过教训留档）；单一默认的移动语义有 e2e 钉住。重命名/访达打开按批准降级为后续任务。CI 12 项全绿零失败。合入。

jackwener · 2026-08-07T13:52:05Z

改了什么

设置 · 偏好新增「项目」页：项目列表管理 + 默认项目。task #160。

为什么

项目管理原本散在各处——添加在 composer、重命名在侧栏行菜单，而「新对话从哪个项目打开」根本不是一个设置：它是「上次用过的那个」，由 project-root-controller 隐式决定，UI 上完全看不见也改不了。

三层规则（按优先级）

composer 里显式选了项目 → 该次对话用它（每次对话都能临时覆盖）
否则用设置里的默认项目
否则维持原来的 last-used 行为（没设默认的用户行为零变化）

「默认覆盖 last-used」而不是「仅在没有 last-used 时兜底」：几乎总是有 last-used，兜底式默认等于永远不生效，那就又是一个说话不算话的旋钮。

两个设计决定

存 projectId 不存路径。 catalog 持有 identity，项目 relink 到新位置后 id 不变；存路径会让这个偏好在目录移动后静默指向别处。

不可用项目不能设为默认（按钮禁用，且禁用态自述原因）。 与 #158「任何连接都能设默认」不同：连接失败是单次使用时才暴露、用户可以先设后修；而默认项目指向一个打不开的目录 = 每个新对话都坏，且修复手段（恢复目录）不在 app 内。预防优于降级。

默认项目失效（归档/目录没了）时，回退到 last-used 而不是让建会话失败，并且在设置页把降级说出来——静默降级和假控件是同一类谎。

范围说明

重命名 和 在访达中打开 这一版没进行尾 … 菜单：前者需要仓库里尚不存在的 inline-edit 原语，后者需要新 IPC（app:openPath 只认「当前项目」）。两个能力目前都还在侧栏行菜单里，没有任何能力丢失，作为后续小任务补。

怎么验证的

新增 4 个 main 侧解析测试：默认覆盖 last-used、显式选择覆盖默认、未设默认行为不变、默认失效时回退不炸。故障注入：把默认读取拆掉 → 恰好 1 个测试失败 → 装回全绿。
新增 e2esettings-projects.spec.ts + settings-projects fixture（三个 catalog 条目：可用 / 可用长路径 / 目录真的不存在）：列表渲染、不可用行显示「目录不可用」、禁用按钮的 aria-describedby 确实说明原因、设为默认后 Badge 互换且落盘、同时只有一个默认。
新增 3 个 core 归一化测试：未设即无偏好、已设存活、空白 id 丢弃。
typecheck / lint / format / build / knip（两个 workspace）全绿；desktop 1751、core 812 全过。
全量测试的既有失败 3 例（maka run process contract ×2、node:sqlite ×1）已确认为存量；runtime-host 那例是 Timing-sensitive tests fail under parallel workspace runner (concurrency=3) #2132 的负载下时序 flake，单跑 725/0 通过。

视觉

预览截图已过审（列表态 / 设为默认态）。截图过程中修掉三处：页头与节头「项目」标题重复、fixture 用编造路径导致整列渲染成不可用态、以及一个匹配不到 Astryx Item 的选择器。

Project management was spread across whichever surface happened to need it — adding lived in the composer, renaming in the sidebar row menu — and "which project does a new conversation open in" was not a setting at all. It was whichever project you used last, decided implicitly by `project-root-controller` and invisible from the UI. Settings · 偏好 · 项目 makes the catalog a first-class surface and gives the default a home. Three layers, in order: an explicit pick in the composer wins for that conversation; otherwise the configured default; otherwise the previous last-used behaviour, unchanged for anyone who sets nothing. The default is stored as a project id rather than a path, because the catalog owns identity — a relinked project keeps its id, so a stored path would silently point somewhere else after a move. A default that no longer resolves (archived, or the folder is gone) falls back to last-used rather than failing session creation, and the page says so instead of degrading silently. Unavailable projects cannot be made the default at all: unlike a model connection, where a failure shows up per use and the user can fix it after choosing, a default pointing at a missing folder breaks every new conversation and the repair is outside the app. The disabled control states that reason itself. Rename and reveal-in-folder are not in the row menu yet — one needs an inline-edit primitive this tree does not have, the other an IPC that can open a path other than the current project's. Both still work from the sidebar row menu, so no capability is lost.

jackwener · 2026-08-07T14:20:46Z

Review by maka-审美专家 — 通过：项目设置页全案落地——预览阶段过审的结构（页头/描述行三层规则/行式方言/不可用态）+ 解析逻辑插在 resolveDesktopSessionSelection 的天然三层接缝（composer 单次覆盖免额外判断）；「默认胜 last-used」测试带存在理由注释；降级可见且不把账算到新建对话头上；禁用态自述补齐并以 aria-describedby 实证（title 空断言的空过教训留档）；单一默认的移动语义有 e2e 钉住。重命名/访达打开按批准降级为后续任务。CI 12 项全绿零失败。合入。

jackwener · 2026-08-07T13:52:05Z

改了什么

设置 · 偏好新增「项目」页：项目列表管理 + 默认项目。task #160。

为什么

项目管理原本散在各处——添加在 composer、重命名在侧栏行菜单，而「新对话从哪个项目打开」根本不是一个设置：它是「上次用过的那个」，由 project-root-controller 隐式决定，UI 上完全看不见也改不了。

三层规则（按优先级）

composer 里显式选了项目 → 该次对话用它（每次对话都能临时覆盖）
否则用设置里的默认项目
否则维持原来的 last-used 行为（没设默认的用户行为零变化）

「默认覆盖 last-used」而不是「仅在没有 last-used 时兜底」：几乎总是有 last-used，兜底式默认等于永远不生效，那就又是一个说话不算话的旋钮。

两个设计决定

存 projectId 不存路径。 catalog 持有 identity，项目 relink 到新位置后 id 不变；存路径会让这个偏好在目录移动后静默指向别处。

不可用项目不能设为默认（按钮禁用，且禁用态自述原因）。 与 #158「任何连接都能设默认」不同：连接失败是单次使用时才暴露、用户可以先设后修；而默认项目指向一个打不开的目录 = 每个新对话都坏，且修复手段（恢复目录）不在 app 内。预防优于降级。

默认项目失效（归档/目录没了）时，回退到 last-used 而不是让建会话失败，并且在设置页把降级说出来——静默降级和假控件是同一类谎。

范围说明

重命名 和 在访达中打开 这一版没进行尾 … 菜单：前者需要仓库里尚不存在的 inline-edit 原语，后者需要新 IPC（app:openPath 只认「当前项目」）。两个能力目前都还在侧栏行菜单里，没有任何能力丢失，作为后续小任务补。

怎么验证的

新增 4 个 main 侧解析测试：默认覆盖 last-used、显式选择覆盖默认、未设默认行为不变、默认失效时回退不炸。故障注入：把默认读取拆掉 → 恰好 1 个测试失败 → 装回全绿。
新增 e2esettings-projects.spec.ts + settings-projects fixture（三个 catalog 条目：可用 / 可用长路径 / 目录真的不存在）：列表渲染、不可用行显示「目录不可用」、禁用按钮的 aria-describedby 确实说明原因、设为默认后 Badge 互换且落盘、同时只有一个默认。
新增 3 个 core 归一化测试：未设即无偏好、已设存活、空白 id 丢弃。
typecheck / lint / format / build / knip（两个 workspace）全绿；desktop 1751、core 812 全过。
全量测试的既有失败 3 例（maka run process contract ×2、node:sqlite ×1）已确认为存量；runtime-host 那例是 Timing-sensitive tests fail under parallel workspace runner (concurrency=3) #2132 的负载下时序 flake，单跑 725/0 通过。

视觉

预览截图已过审（列表态 / 设为默认态）。截图过程中修掉三处：页头与节头「项目」标题重复、fixture 用编造路径导致整列渲染成不可用态、以及一个匹配不到 Astryx Item 的选择器。

Project management was spread across whichever surface happened to need it — adding lived in the composer, renaming in the sidebar row menu — and "which project does a new conversation open in" was not a setting at all. It was whichever project you used last, decided implicitly by `project-root-controller` and invisible from the UI. Settings · 偏好 · 项目 makes the catalog a first-class surface and gives the default a home. Three layers, in order: an explicit pick in the composer wins for that conversation; otherwise the configured default; otherwise the previous last-used behaviour, unchanged for anyone who sets nothing. The default is stored as a project id rather than a path, because the catalog owns identity — a relinked project keeps its id, so a stored path would silently point somewhere else after a move. A default that no longer resolves (archived, or the folder is gone) falls back to last-used rather than failing session creation, and the page says so instead of degrading silently. Unavailable projects cannot be made the default at all: unlike a model connection, where a failure shows up per use and the user can fix it after choosing, a default pointing at a missing folder breaks every new conversation and the repair is outside the app. The disabled control states that reason itself. Rename and reveal-in-folder are not in the row menu yet — one needs an inline-edit primitive this tree does not have, the other an IPC that can open a path other than the current project's. Both still work from the sidebar row menu, so no capability is lost.

jackwener · 2026-08-07T14:20:46Z

Review by maka-审美专家 — 通过：项目设置页全案落地——预览阶段过审的结构（页头/描述行三层规则/行式方言/不可用态）+ 解析逻辑插在 resolveDesktopSessionSelection 的天然三层接缝（composer 单次覆盖免额外判断）；「默认胜 last-used」测试带存在理由注释；降级可见且不把账算到新建对话头上；禁用态自述补齐并以 aria-describedby 实证（title 空断言的空过教训留档）；单一默认的移动语义有 e2e 钉住。重命名/访达打开按批准降级为后续任务。CI 12 项全绿零失败。合入。

jackwener · 2026-08-07T13:52:05Z

改了什么

设置 · 偏好新增「项目」页：项目列表管理 + 默认项目。task #160。

为什么

项目管理原本散在各处——添加在 composer、重命名在侧栏行菜单，而「新对话从哪个项目打开」根本不是一个设置：它是「上次用过的那个」，由 project-root-controller 隐式决定，UI 上完全看不见也改不了。

三层规则（按优先级）

composer 里显式选了项目 → 该次对话用它（每次对话都能临时覆盖）
否则用设置里的默认项目
否则维持原来的 last-used 行为（没设默认的用户行为零变化）

「默认覆盖 last-used」而不是「仅在没有 last-used 时兜底」：几乎总是有 last-used，兜底式默认等于永远不生效，那就又是一个说话不算话的旋钮。

两个设计决定

存 projectId 不存路径。 catalog 持有 identity，项目 relink 到新位置后 id 不变；存路径会让这个偏好在目录移动后静默指向别处。

不可用项目不能设为默认（按钮禁用，且禁用态自述原因）。 与 #158「任何连接都能设默认」不同：连接失败是单次使用时才暴露、用户可以先设后修；而默认项目指向一个打不开的目录 = 每个新对话都坏，且修复手段（恢复目录）不在 app 内。预防优于降级。

默认项目失效（归档/目录没了）时，回退到 last-used 而不是让建会话失败，并且在设置页把降级说出来——静默降级和假控件是同一类谎。

范围说明

重命名 和 在访达中打开 这一版没进行尾 … 菜单：前者需要仓库里尚不存在的 inline-edit 原语，后者需要新 IPC（app:openPath 只认「当前项目」）。两个能力目前都还在侧栏行菜单里，没有任何能力丢失，作为后续小任务补。

怎么验证的

新增 4 个 main 侧解析测试：默认覆盖 last-used、显式选择覆盖默认、未设默认行为不变、默认失效时回退不炸。故障注入：把默认读取拆掉 → 恰好 1 个测试失败 → 装回全绿。
新增 e2esettings-projects.spec.ts + settings-projects fixture（三个 catalog 条目：可用 / 可用长路径 / 目录真的不存在）：列表渲染、不可用行显示「目录不可用」、禁用按钮的 aria-describedby 确实说明原因、设为默认后 Badge 互换且落盘、同时只有一个默认。
新增 3 个 core 归一化测试：未设即无偏好、已设存活、空白 id 丢弃。
typecheck / lint / format / build / knip（两个 workspace）全绿；desktop 1751、core 812 全过。
全量测试的既有失败 3 例（maka run process contract ×2、node:sqlite ×1）已确认为存量；runtime-host 那例是 Timing-sensitive tests fail under parallel workspace runner (concurrency=3) #2132 的负载下时序 flake，单跑 725/0 通过。

视觉

预览截图已过审（列表态 / 设为默认态）。截图过程中修掉三处：页头与节头「项目」标题重复、fixture 用编造路径导致整列渲染成不可用态、以及一个匹配不到 Astryx Item 的选择器。

Project management was spread across whichever surface happened to need it — adding lived in the composer, renaming in the sidebar row menu — and "which project does a new conversation open in" was not a setting at all. It was whichever project you used last, decided implicitly by `project-root-controller` and invisible from the UI. Settings · 偏好 · 项目 makes the catalog a first-class surface and gives the default a home. Three layers, in order: an explicit pick in the composer wins for that conversation; otherwise the configured default; otherwise the previous last-used behaviour, unchanged for anyone who sets nothing. The default is stored as a project id rather than a path, because the catalog owns identity — a relinked project keeps its id, so a stored path would silently point somewhere else after a move. A default that no longer resolves (archived, or the folder is gone) falls back to last-used rather than failing session creation, and the page says so instead of degrading silently. Unavailable projects cannot be made the default at all: unlike a model connection, where a failure shows up per use and the user can fix it after choosing, a default pointing at a missing folder breaks every new conversation and the repair is outside the app. The disabled control states that reason itself. Rename and reveal-in-folder are not in the row menu yet — one needs an inline-edit primitive this tree does not have, the other an IPC that can open a path other than the current project's. Both still work from the sidebar row menu, so no capability is lost.

jackwener · 2026-08-07T14:20:46Z

Review by maka-审美专家 — 通过：项目设置页全案落地——预览阶段过审的结构（页头/描述行三层规则/行式方言/不可用态）+ 解析逻辑插在 resolveDesktopSessionSelection 的天然三层接缝（composer 单次覆盖免额外判断）；「默认胜 last-used」测试带存在理由注释；降级可见且不把账算到新建对话头上；禁用态自述补齐并以 aria-describedby 实证（title 空断言的空过教训留档）；单一默认的移动语义有 e2e 钉住。重命名/访达打开按批准降级为后续任务。CI 12 项全绿零失败。合入。

jackwener · 2026-08-07T13:52:05Z

改了什么

设置 · 偏好新增「项目」页：项目列表管理 + 默认项目。task #160。

为什么

项目管理原本散在各处——添加在 composer、重命名在侧栏行菜单，而「新对话从哪个项目打开」根本不是一个设置：它是「上次用过的那个」，由 project-root-controller 隐式决定，UI 上完全看不见也改不了。

三层规则（按优先级）

composer 里显式选了项目 → 该次对话用它（每次对话都能临时覆盖）
否则用设置里的默认项目
否则维持原来的 last-used 行为（没设默认的用户行为零变化）

「默认覆盖 last-used」而不是「仅在没有 last-used 时兜底」：几乎总是有 last-used，兜底式默认等于永远不生效，那就又是一个说话不算话的旋钮。

两个设计决定

存 projectId 不存路径。 catalog 持有 identity，项目 relink 到新位置后 id 不变；存路径会让这个偏好在目录移动后静默指向别处。

不可用项目不能设为默认（按钮禁用，且禁用态自述原因）。 与 #158「任何连接都能设默认」不同：连接失败是单次使用时才暴露、用户可以先设后修；而默认项目指向一个打不开的目录 = 每个新对话都坏，且修复手段（恢复目录）不在 app 内。预防优于降级。

默认项目失效（归档/目录没了）时，回退到 last-used 而不是让建会话失败，并且在设置页把降级说出来——静默降级和假控件是同一类谎。

范围说明

重命名 和 在访达中打开 这一版没进行尾 … 菜单：前者需要仓库里尚不存在的 inline-edit 原语，后者需要新 IPC（app:openPath 只认「当前项目」）。两个能力目前都还在侧栏行菜单里，没有任何能力丢失，作为后续小任务补。

怎么验证的

新增 4 个 main 侧解析测试：默认覆盖 last-used、显式选择覆盖默认、未设默认行为不变、默认失效时回退不炸。故障注入：把默认读取拆掉 → 恰好 1 个测试失败 → 装回全绿。
新增 e2esettings-projects.spec.ts + settings-projects fixture（三个 catalog 条目：可用 / 可用长路径 / 目录真的不存在）：列表渲染、不可用行显示「目录不可用」、禁用按钮的 aria-describedby 确实说明原因、设为默认后 Badge 互换且落盘、同时只有一个默认。
新增 3 个 core 归一化测试：未设即无偏好、已设存活、空白 id 丢弃。
typecheck / lint / format / build / knip（两个 workspace）全绿；desktop 1751、core 812 全过。
全量测试的既有失败 3 例（maka run process contract ×2、node:sqlite ×1）已确认为存量；runtime-host 那例是 Timing-sensitive tests fail under parallel workspace runner (concurrency=3) #2132 的负载下时序 flake，单跑 725/0 通过。

视觉

预览截图已过审（列表态 / 设为默认态）。截图过程中修掉三处：页头与节头「项目」标题重复、fixture 用编造路径导致整列渲染成不可用态、以及一个匹配不到 Astryx Item 的选择器。

Project management was spread across whichever surface happened to need it — adding lived in the composer, renaming in the sidebar row menu — and "which project does a new conversation open in" was not a setting at all. It was whichever project you used last, decided implicitly by `project-root-controller` and invisible from the UI. Settings · 偏好 · 项目 makes the catalog a first-class surface and gives the default a home. Three layers, in order: an explicit pick in the composer wins for that conversation; otherwise the configured default; otherwise the previous last-used behaviour, unchanged for anyone who sets nothing. The default is stored as a project id rather than a path, because the catalog owns identity — a relinked project keeps its id, so a stored path would silently point somewhere else after a move. A default that no longer resolves (archived, or the folder is gone) falls back to last-used rather than failing session creation, and the page says so instead of degrading silently. Unavailable projects cannot be made the default at all: unlike a model connection, where a failure shows up per use and the user can fix it after choosing, a default pointing at a missing folder breaks every new conversation and the repair is outside the app. The disabled control states that reason itself. Rename and reveal-in-folder are not in the row menu yet — one needs an inline-edit primitive this tree does not have, the other an IPC that can open a path other than the current project's. Both still work from the sidebar row menu, so no capability is lost.

jackwener · 2026-08-07T14:20:46Z

Review by maka-审美专家 — 通过：项目设置页全案落地——预览阶段过审的结构（页头/描述行三层规则/行式方言/不可用态）+ 解析逻辑插在 resolveDesktopSessionSelection 的天然三层接缝（composer 单次覆盖免额外判断）；「默认胜 last-used」测试带存在理由注释；降级可见且不把账算到新建对话头上；禁用态自述补齐并以 aria-describedby 实证（title 空断言的空过教训留档）；单一默认的移动语义有 e2e 钉住。重命名/访达打开按批准降级为后续任务。CI 12 项全绿零失败。合入。

jackwener · 2026-08-07T13:52:05Z

改了什么

设置 · 偏好新增「项目」页：项目列表管理 + 默认项目。task #160。

为什么

项目管理原本散在各处——添加在 composer、重命名在侧栏行菜单，而「新对话从哪个项目打开」根本不是一个设置：它是「上次用过的那个」，由 project-root-controller 隐式决定，UI 上完全看不见也改不了。

三层规则（按优先级）

composer 里显式选了项目 → 该次对话用它（每次对话都能临时覆盖）
否则用设置里的默认项目
否则维持原来的 last-used 行为（没设默认的用户行为零变化）

「默认覆盖 last-used」而不是「仅在没有 last-used 时兜底」：几乎总是有 last-used，兜底式默认等于永远不生效，那就又是一个说话不算话的旋钮。

两个设计决定

存 projectId 不存路径。 catalog 持有 identity，项目 relink 到新位置后 id 不变；存路径会让这个偏好在目录移动后静默指向别处。

不可用项目不能设为默认（按钮禁用，且禁用态自述原因）。 与 #158「任何连接都能设默认」不同：连接失败是单次使用时才暴露、用户可以先设后修；而默认项目指向一个打不开的目录 = 每个新对话都坏，且修复手段（恢复目录）不在 app 内。预防优于降级。

默认项目失效（归档/目录没了）时，回退到 last-used 而不是让建会话失败，并且在设置页把降级说出来——静默降级和假控件是同一类谎。

范围说明

重命名 和 在访达中打开 这一版没进行尾 … 菜单：前者需要仓库里尚不存在的 inline-edit 原语，后者需要新 IPC（app:openPath 只认「当前项目」）。两个能力目前都还在侧栏行菜单里，没有任何能力丢失，作为后续小任务补。

怎么验证的

新增 4 个 main 侧解析测试：默认覆盖 last-used、显式选择覆盖默认、未设默认行为不变、默认失效时回退不炸。故障注入：把默认读取拆掉 → 恰好 1 个测试失败 → 装回全绿。
新增 e2esettings-projects.spec.ts + settings-projects fixture（三个 catalog 条目：可用 / 可用长路径 / 目录真的不存在）：列表渲染、不可用行显示「目录不可用」、禁用按钮的 aria-describedby 确实说明原因、设为默认后 Badge 互换且落盘、同时只有一个默认。
新增 3 个 core 归一化测试：未设即无偏好、已设存活、空白 id 丢弃。
typecheck / lint / format / build / knip（两个 workspace）全绿；desktop 1751、core 812 全过。
全量测试的既有失败 3 例（maka run process contract ×2、node:sqlite ×1）已确认为存量；runtime-host 那例是 Timing-sensitive tests fail under parallel workspace runner (concurrency=3) #2132 的负载下时序 flake，单跑 725/0 通过。

视觉

预览截图已过审（列表态 / 设为默认态）。截图过程中修掉三处：页头与节头「项目」标题重复、fixture 用编造路径导致整列渲染成不可用态、以及一个匹配不到 Astryx Item 的选择器。

Project management was spread across whichever surface happened to need it — adding lived in the composer, renaming in the sidebar row menu — and "which project does a new conversation open in" was not a setting at all. It was whichever project you used last, decided implicitly by `project-root-controller` and invisible from the UI. Settings · 偏好 · 项目 makes the catalog a first-class surface and gives the default a home. Three layers, in order: an explicit pick in the composer wins for that conversation; otherwise the configured default; otherwise the previous last-used behaviour, unchanged for anyone who sets nothing. The default is stored as a project id rather than a path, because the catalog owns identity — a relinked project keeps its id, so a stored path would silently point somewhere else after a move. A default that no longer resolves (archived, or the folder is gone) falls back to last-used rather than failing session creation, and the page says so instead of degrading silently. Unavailable projects cannot be made the default at all: unlike a model connection, where a failure shows up per use and the user can fix it after choosing, a default pointing at a missing folder breaks every new conversation and the repair is outside the app. The disabled control states that reason itself. Rename and reveal-in-folder are not in the row menu yet — one needs an inline-edit primitive this tree does not have, the other an IPC that can open a path other than the current project's. Both still work from the sidebar row menu, so no capability is lost.

jackwener · 2026-08-07T14:20:46Z

Review by maka-审美专家 — 通过：项目设置页全案落地——预览阶段过审的结构（页头/描述行三层规则/行式方言/不可用态）+ 解析逻辑插在 resolveDesktopSessionSelection 的天然三层接缝（composer 单次覆盖免额外判断）；「默认胜 last-used」测试带存在理由注释；降级可见且不把账算到新建对话头上；禁用态自述补齐并以 aria-describedby 实证（title 空断言的空过教训留档）；单一默认的移动语义有 e2e 钉住。重命名/访达打开按批准降级为后续任务。CI 12 项全绿零失败。合入。

jackwener · 2026-08-07T13:52:05Z

改了什么

设置 · 偏好新增「项目」页：项目列表管理 + 默认项目。task #160。

为什么

项目管理原本散在各处——添加在 composer、重命名在侧栏行菜单，而「新对话从哪个项目打开」根本不是一个设置：它是「上次用过的那个」，由 project-root-controller 隐式决定，UI 上完全看不见也改不了。

三层规则（按优先级）

composer 里显式选了项目 → 该次对话用它（每次对话都能临时覆盖）
否则用设置里的默认项目
否则维持原来的 last-used 行为（没设默认的用户行为零变化）

「默认覆盖 last-used」而不是「仅在没有 last-used 时兜底」：几乎总是有 last-used，兜底式默认等于永远不生效，那就又是一个说话不算话的旋钮。

两个设计决定

存 projectId 不存路径。 catalog 持有 identity，项目 relink 到新位置后 id 不变；存路径会让这个偏好在目录移动后静默指向别处。

不可用项目不能设为默认（按钮禁用，且禁用态自述原因）。 与 #158「任何连接都能设默认」不同：连接失败是单次使用时才暴露、用户可以先设后修；而默认项目指向一个打不开的目录 = 每个新对话都坏，且修复手段（恢复目录）不在 app 内。预防优于降级。

默认项目失效（归档/目录没了）时，回退到 last-used 而不是让建会话失败，并且在设置页把降级说出来——静默降级和假控件是同一类谎。

范围说明

重命名 和 在访达中打开 这一版没进行尾 … 菜单：前者需要仓库里尚不存在的 inline-edit 原语，后者需要新 IPC（app:openPath 只认「当前项目」）。两个能力目前都还在侧栏行菜单里，没有任何能力丢失，作为后续小任务补。

怎么验证的

新增 4 个 main 侧解析测试：默认覆盖 last-used、显式选择覆盖默认、未设默认行为不变、默认失效时回退不炸。故障注入：把默认读取拆掉 → 恰好 1 个测试失败 → 装回全绿。
新增 e2esettings-projects.spec.ts + settings-projects fixture（三个 catalog 条目：可用 / 可用长路径 / 目录真的不存在）：列表渲染、不可用行显示「目录不可用」、禁用按钮的 aria-describedby 确实说明原因、设为默认后 Badge 互换且落盘、同时只有一个默认。
新增 3 个 core 归一化测试：未设即无偏好、已设存活、空白 id 丢弃。
typecheck / lint / format / build / knip（两个 workspace）全绿；desktop 1751、core 812 全过。
全量测试的既有失败 3 例（maka run process contract ×2、node:sqlite ×1）已确认为存量；runtime-host 那例是 Timing-sensitive tests fail under parallel workspace runner (concurrency=3) #2132 的负载下时序 flake，单跑 725/0 通过。

视觉

预览截图已过审（列表态 / 设为默认态）。截图过程中修掉三处：页头与节头「项目」标题重复、fixture 用编造路径导致整列渲染成不可用态、以及一个匹配不到 Astryx Item 的选择器。

Project management was spread across whichever surface happened to need it — adding lived in the composer, renaming in the sidebar row menu — and "which project does a new conversation open in" was not a setting at all. It was whichever project you used last, decided implicitly by `project-root-controller` and invisible from the UI. Settings · 偏好 · 项目 makes the catalog a first-class surface and gives the default a home. Three layers, in order: an explicit pick in the composer wins for that conversation; otherwise the configured default; otherwise the previous last-used behaviour, unchanged for anyone who sets nothing. The default is stored as a project id rather than a path, because the catalog owns identity — a relinked project keeps its id, so a stored path would silently point somewhere else after a move. A default that no longer resolves (archived, or the folder is gone) falls back to last-used rather than failing session creation, and the page says so instead of degrading silently. Unavailable projects cannot be made the default at all: unlike a model connection, where a failure shows up per use and the user can fix it after choosing, a default pointing at a missing folder breaks every new conversation and the repair is outside the app. The disabled control states that reason itself. Rename and reveal-in-folder are not in the row menu yet — one needs an inline-edit primitive this tree does not have, the other an IPC that can open a path other than the current project's. Both still work from the sidebar row menu, so no capability is lost.

jackwener · 2026-08-07T14:20:46Z

Review by maka-审美专家 — 通过：项目设置页全案落地——预览阶段过审的结构（页头/描述行三层规则/行式方言/不可用态）+ 解析逻辑插在 resolveDesktopSessionSelection 的天然三层接缝（composer 单次覆盖免额外判断）；「默认胜 last-used」测试带存在理由注释；降级可见且不把账算到新建对话头上；禁用态自述补齐并以 aria-describedby 实证（title 空断言的空过教训留档）；单一默认的移动语义有 e2e 钉住。重命名/访达打开按批准降级为后续任务。CI 12 项全绿零失败。合入。

jackwener · 2026-08-07T13:52:05Z

改了什么

设置 · 偏好新增「项目」页：项目列表管理 + 默认项目。task #160。

为什么

项目管理原本散在各处——添加在 composer、重命名在侧栏行菜单，而「新对话从哪个项目打开」根本不是一个设置：它是「上次用过的那个」，由 project-root-controller 隐式决定，UI 上完全看不见也改不了。

三层规则（按优先级）

composer 里显式选了项目 → 该次对话用它（每次对话都能临时覆盖）
否则用设置里的默认项目
否则维持原来的 last-used 行为（没设默认的用户行为零变化）

「默认覆盖 last-used」而不是「仅在没有 last-used 时兜底」：几乎总是有 last-used，兜底式默认等于永远不生效，那就又是一个说话不算话的旋钮。

两个设计决定

存 projectId 不存路径。 catalog 持有 identity，项目 relink 到新位置后 id 不变；存路径会让这个偏好在目录移动后静默指向别处。

不可用项目不能设为默认（按钮禁用，且禁用态自述原因）。 与 #158「任何连接都能设默认」不同：连接失败是单次使用时才暴露、用户可以先设后修；而默认项目指向一个打不开的目录 = 每个新对话都坏，且修复手段（恢复目录）不在 app 内。预防优于降级。

默认项目失效（归档/目录没了）时，回退到 last-used 而不是让建会话失败，并且在设置页把降级说出来——静默降级和假控件是同一类谎。

范围说明

重命名 和 在访达中打开 这一版没进行尾 … 菜单：前者需要仓库里尚不存在的 inline-edit 原语，后者需要新 IPC（app:openPath 只认「当前项目」）。两个能力目前都还在侧栏行菜单里，没有任何能力丢失，作为后续小任务补。

怎么验证的

新增 4 个 main 侧解析测试：默认覆盖 last-used、显式选择覆盖默认、未设默认行为不变、默认失效时回退不炸。故障注入：把默认读取拆掉 → 恰好 1 个测试失败 → 装回全绿。
新增 e2esettings-projects.spec.ts + settings-projects fixture（三个 catalog 条目：可用 / 可用长路径 / 目录真的不存在）：列表渲染、不可用行显示「目录不可用」、禁用按钮的 aria-describedby 确实说明原因、设为默认后 Badge 互换且落盘、同时只有一个默认。
新增 3 个 core 归一化测试：未设即无偏好、已设存活、空白 id 丢弃。
typecheck / lint / format / build / knip（两个 workspace）全绿；desktop 1751、core 812 全过。
全量测试的既有失败 3 例（maka run process contract ×2、node:sqlite ×1）已确认为存量；runtime-host 那例是 Timing-sensitive tests fail under parallel workspace runner (concurrency=3) #2132 的负载下时序 flake，单跑 725/0 通过。

视觉

预览截图已过审（列表态 / 设为默认态）。截图过程中修掉三处：页头与节头「项目」标题重复、fixture 用编造路径导致整列渲染成不可用态、以及一个匹配不到 Astryx Item 的选择器。

Project management was spread across whichever surface happened to need it — adding lived in the composer, renaming in the sidebar row menu — and "which project does a new conversation open in" was not a setting at all. It was whichever project you used last, decided implicitly by `project-root-controller` and invisible from the UI. Settings · 偏好 · 项目 makes the catalog a first-class surface and gives the default a home. Three layers, in order: an explicit pick in the composer wins for that conversation; otherwise the configured default; otherwise the previous last-used behaviour, unchanged for anyone who sets nothing. The default is stored as a project id rather than a path, because the catalog owns identity — a relinked project keeps its id, so a stored path would silently point somewhere else after a move. A default that no longer resolves (archived, or the folder is gone) falls back to last-used rather than failing session creation, and the page says so instead of degrading silently. Unavailable projects cannot be made the default at all: unlike a model connection, where a failure shows up per use and the user can fix it after choosing, a default pointing at a missing folder breaks every new conversation and the repair is outside the app. The disabled control states that reason itself. Rename and reveal-in-folder are not in the row menu yet — one needs an inline-edit primitive this tree does not have, the other an IPC that can open a path other than the current project's. Both still work from the sidebar row menu, so no capability is lost.

jackwener · 2026-08-07T14:20:46Z

Review by maka-审美专家 — 通过：项目设置页全案落地——预览阶段过审的结构（页头/描述行三层规则/行式方言/不可用态）+ 解析逻辑插在 resolveDesktopSessionSelection 的天然三层接缝（composer 单次覆盖免额外判断）；「默认胜 last-used」测试带存在理由注释；降级可见且不把账算到新建对话头上；禁用态自述补齐并以 aria-describedby 实证（title 空断言的空过教训留档）；单一默认的移动语义有 e2e 钉住。重命名/访达打开按批准降级为后续任务。CI 12 项全绿零失败。合入。

jackwener merged commit ea36be4 into mainAug 7, 2026
12 checks passed