話分組自定義 Hex 顏色：從核心校驗(yàn)到 WebShell 的端到端實(shí)現(xiàn)指南)
Qwen Code 會(huì)話分組自定義 Hex 顏色從核心校驗(yàn)到 WebShell 的端到端實(shí)現(xiàn)指南【免費(fèi)下載鏈接】qwen-codeAn open-source AI coding agent that lives in your terminal.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code本文圍繞 qwen-code 倉庫中命名會(huì)話組自定義 Hex 顏色issue #6744這一功能展開完整梳理其從核心服務(wù)校驗(yàn)、REST/ACP 傳輸、TypeScript SDK 類型到 WebShell 側(cè)邊欄編輯器的全鏈路實(shí)現(xiàn)與驗(yàn)證方案。讀完本文你將掌握六位#RRGGBB顏色值的接受規(guī)則與歸一化策略、預(yù)設(shè)色與自定義色的邊界劃分、以及如何用一套 e2e 測試計(jì)劃對(duì)核心契約 守護(hù)進(jìn)程傳輸 前端 UI三層做回歸驗(yàn)證。背景為什么需要自定義分組顏色qwen-code 中命名會(huì)話組named session groups此前與快速會(huì)話顏色標(biāo)簽quick session color tags共享同一個(gè)六值顏色枚舉red、orange、yellow、green、blue、purple。這套枚舉帶來的限制是明確的守護(hù)進(jìn)程daemon對(duì)任何枚舉之外的取值一律以invalid_group_color拒絕TypeScript SDK 暴露的是同樣的封閉聯(lián)合類型closed unionWebShell 的分組編輯器只提供一個(gè)預(yù)設(shè)色下拉框。結(jié)果就是用戶無法讓命名分組與既有項(xiàng)目配色對(duì)齊也無法在分組目錄變大時(shí)靠顏色做視覺區(qū)分。該問題由 docs/design/session-group-custom-hex-colors.md 記錄設(shè)計(jì)決策并在 .qwen/e2e-tests/session-group-custom-hex-colors.md 中給出完整驗(yàn)證方案。設(shè)計(jì)上遵循一個(gè)核心原則將預(yù)設(shè)會(huì)話標(biāo)簽色與命名分組展示色拆成兩條互不干擾的路徑——命名分組接受預(yù)設(shè)色或六位 Hex快速標(biāo)簽保持預(yù)設(shè)色不變。各層改動(dòng)一覽層變更內(nèi)容Core把預(yù)設(shè)會(huì)話標(biāo)簽色與命名分組展示色拆分。命名分組接受預(yù)設(shè)色或六位#RRGGBB快速標(biāo)簽僅限預(yù)設(shè)色。有效 Hex 在持久化前統(tǒng)一歸一化為小寫。REST / ACP快速標(biāo)簽校驗(yàn)保持預(yù)設(shè)色唯一命名分組顏色透傳給 Core 校驗(yàn)。TypeScript SDK導(dǎo)出預(yù)設(shè)色與 Hex 色兩種類型。分組輸入/輸出使用二者的聯(lián)合類型會(huì)話組織session organization繼續(xù)使用預(yù)設(shè)色。WebShell保留預(yù)設(shè)選項(xiàng)新增 Custom 選項(xiàng)原生取色器 Hex 文本框。自定義分組圓點(diǎn)以內(nèi)聯(lián)background-color渲染。對(duì)應(yīng)源碼文件清單見設(shè)計(jì)文檔 docs/design/session-group-custom-hex-colors.md核心實(shí)現(xiàn)集中在 packages/core/src/services/session-organization-service.ts。核心契約Core 層的顏色校驗(yàn)與歸一化類型邊界預(yù)設(shè)色 vs Hex 色packages/core/src/services/session-organization-service.ts 中定義了清晰的類型體系export const GROUP_COLOR_OPTIONS [ red, orange, yellow, green, blue, purple, ] as const; export type SessionGroupPresetColor (typeof GROUP_COLOR_OPTIONS)[number]; /** Shape hint only; runtime validation below enforces exactly six Hex digits. */ export type SessionGroupHexColor #${string}; export type SessionGroupColor SessionGroupPresetColor | SessionGroupHexColor;注意SessionGroupHexColor在類型層面只是#${string}的形狀提示真正的必須恰好六位十六進(jìn)制約束由運(yùn)行時(shí)校驗(yàn)強(qiáng)制見normalizeGroupColor。與此同時(shí)會(huì)話組織SessionOrganization的color字段仍限定為SessionGroupPresetColor | nullassertSessionColor也嚴(yán)格拒絕非預(yù)設(shè)值——這就是會(huì)話快速標(biāo)簽仍拒絕 Hex的實(shí)現(xiàn)根基。歸一化規(guī)則trim 小寫normalizeGroupColor是這一功能的核心函數(shù)function normalizeGroupColor(color: unknown): SessionGroupColor { const normalized typeof color string ? color.trim() : color; if (typeof normalized string isPresetGroupColor(normalized)) { return normalized; } if (typeof normalized string /^#[0-9a-f]{6}$/i.test(normalized)) { return normalized.toLowerCase() as SessionGroupHexColor; } throw new SessionOrganizationError( color must be a supported preset or a #RRGGBB hex value, invalid_group_color, color, ); }關(guān)鍵行為接受偶然的周邊空白先trim()因此 #12ABEF 也能通過小寫規(guī)范化#12ABEF會(huì)被持久化為#12abef保證所有已存值形態(tài)可預(yù)測嚴(yán)格六位正則^#[0-9a-f]{6}$i標(biāo)志拒絕三、四、八位形式如#abc、#abcd、#aabbccdd也拒絕命名 CSS 顏色與 alpha 通道失敗即拋錯(cuò)invalid_group_color結(jié)構(gòu)化錯(cuò)誤附帶field: color字段便于 REST 層直接映射 HTTP 400。createGroup與updateGroup都會(huì)在寫庫前調(diào)用normalizeGroupColor隨后通過withStoreLock串行化寫操作并調(diào)用atomicWriteJSON做原子寫入。分組名稱同樣有獨(dú)立校驗(yàn)1–64 字符、禁止控制字符、大小寫不敏感去重顏色只是其中的一個(gè)字段。持久化與容錯(cuò)分組數(shù)據(jù)存儲(chǔ)在側(cè)邊車文件session-organization.v1.json中STORE_FILE常量schema 版本保持為 1——因?yàn)榇鎯?chǔ)字段仍是字符串舊預(yù)設(shè)值天然有效無需遷移。讀取側(cè)normalizeSessionGroup對(duì)不支持的顏色值做降級(jí)處理回退到FALLBACK_GROUP_COLOR blue并只告警一次確保未來出現(xiàn)未知顏色類時(shí)舊客戶端也能安全失敗。測試印證packages/core/src/services/session-organization-service.test.ts 中有一條與本文主題直接對(duì)應(yīng)的用例it(accepts and normalizes custom hex colors for named groups, async () { const group await service.createGroup({ name: Custom, color: #12ABef as never, }); expect(group.color).toBe(#12abef); const updated await service.updateGroup(group.id, { color: #FEDCBA as never, }); expect(updated.color).toBe(#fedcba); const catalog await service.listGroups(); expect(catalog.groups[0]?.color).toBe(#fedcba); expect(catalog.colorOptions).toEqual(GROUP_COLOR_OPTIONS); const restarted new SessionOrganizationService(cwd); expect((await restarted.listGroups()).groups[0]?.color).toBe(#fedcba); });這條用例同時(shí)驗(yàn)證了帶空白輸入被接受、小寫歸一化、列表讀取返回規(guī)范值、重啟后restarted實(shí)例持久化值不丟失、且colorOptions預(yù)設(shè)目錄保持原樣。同文件還覆蓋了#abc被拒、pink等非預(yù)設(shè)/非 Hex 值返回invalid_group_color、未知存儲(chǔ)色回退為blue并告警等容錯(cuò)路徑。傳輸層REST 與 ACP 的 Hex 透傳REST 層位于 packages/cli/src/serve/routes/session.ts命名分組路由在 POST/workspace/:id/session-groups與 PATCH/workspace/:id/session-groups/:groupId中把請求體color字段原樣傳入 Coreconst group await runWithWorkspaceRuntimeStorage(runtime, () service.createGroup({ name: body[name] as string, color: body[color] as SessionGroupColor, }), ); res.status(201).json({ group });也就是說REST 層對(duì)命名分組顏色不做二次校驗(yàn)全部交由 Core 的normalizeGroupColor決定成敗——非法值自然映射為invalid_group_color錯(cuò)誤HTTP 400合法 Hex 則回傳小寫規(guī)范化后的值。快速標(biāo)簽路徑session organization 的color字段則保持預(yù)設(shè)色唯一校驗(yàn)例如 packages/cli/src/serve/routes/session.ts 中對(duì)rawColor的檢查仍限定為SessionGroupPresetColor | null。ACPAgent Client ProtocolHTTP 側(cè)由packages/cli/src/serve/acp-http/dispatch.ts走同樣的校驗(yàn)與轉(zhuǎn)發(fā)邏輯橋接層類型定義在 packages/acp-bridge/src/bridgeTypes.ts。SDK 類型導(dǎo)出預(yù)設(shè)色與 Hex 的聯(lián)合類型TypeScript SDK 的類型定義位于 packages/sdk-typescript/src/daemon/types.tsexport type DaemonSessionGroupPresetColor /* 六值預(yù)設(shè)色 */; export type DaemonSessionGroupHexColor #${string}; export type DaemonSessionGroupColor | DaemonSessionGroupPresetColor | DaemonSessionGroupHexColor;分組創(chuàng)建/更新輸入color?: DaemonSessionGroupColor與分組返回類型color: DaemonSessionGroupColor使用聯(lián)合類型因此#12abef可以完整地經(jīng) SDK 往返會(huì)話組織相關(guān)接口color?: DaemonSessionGroupPresetColor | null仍限定預(yù)設(shè)色與 Core 的SessionOrganization邊界保持一致分組目錄響應(yīng)中的colorOptions繼續(xù)返回預(yù)設(shè)色數(shù)組。SDK 的導(dǎo)出面packages/sdk-typescript/src/daemon/index.ts與packages/sdk-typescript/src/index.ts需要把新類型暴露給使用方。WebShellCustom 選項(xiàng)與取色器實(shí)現(xiàn)渲染邏輯Hex 判定與內(nèi)聯(lián)背景色packages/web-shell/client/components/sidebar/WebShellSidebar.tsx 中分組圓點(diǎn)的渲染按是否為 Hex分流function getGroupColorClass(color: DaemonSessionGroupColor) { if (color.startsWith(#)) return styles.groupColorCustom; // ... 預(yù)設(shè)色走既有 class } function getGroupColorStyle(color: DaemonSessionGroupColor) { return color.startsWith(#) ? { backgroundColor: color } : undefined; }預(yù)設(shè)色繼續(xù)使用預(yù)定義 CSS 類packages/web-shell/client/components/sidebar/WebShellSidebar.module.css自定義 Hex 分組則通過內(nèi)聯(lián)background-color渲染圓點(diǎn)——這樣不認(rèn)識(shí) Hex 類的舊客戶端也能安全失敗設(shè)計(jì)文檔明確要求Existing clients that do not recognize a Hex class should fail safely。編輯器取色器與 Hex 文本框雙向同步編輯器在 Create/Rename 分組對(duì)話框中新增了 Custom 選項(xiàng)下拉框保留全部預(yù)設(shè)選項(xiàng)并追加自定義Custom選項(xiàng)選中 Custom 后展開一行g(shù)roupCustomColorRow左側(cè)是原生input typecolor取色器右側(cè)是 Hex 文本輸入框組件用lastValidCustomGroupColor狀態(tài)保存最后一次合法自定義顏色原生取色器變化onChange直接更新該狀態(tài)Hex 文本框輸入先經(jīng)normalizeHexColorInput校驗(yàn)合法才同步回狀態(tài)無效文本不會(huì)破壞取色器即使 Hex 框內(nèi)容非法取色器仍停留在上一個(gè)合法自定義色上非法 Hex 禁用保存提交前用normalizeGroupColorInput重新校驗(yàn)非法時(shí) Save 按鈕不可用并暴露可訪問的錯(cuò)誤提示帶FieldLabel與htmlFor關(guān)聯(lián)的輸入框既有自定義值回顯編輯已有分組時(shí)若group.color以#開頭則自動(dòng)進(jìn)入 Custom 模式并回填 Hex 框保存成功后分組圓點(diǎn)即使用持久化的 Hex 顏色。相關(guān)狀態(tài)初始化可見 packages/web-shell/client/components/sidebar/WebShellSidebar.tsx 中的setLastValidCustomGroupColor(DEFAULT_CUSTOM_GROUP_COLOR)等邏輯i18n 文案如sidebar.groupColor.hex在 packages/web-shell/client/i18n.tsx 中維護(hù)。下面的截圖展示了新建分組對(duì)話框分組名稱為Design system顏色下拉選中自定義...下方出現(xiàn)顏色預(yù)覽方塊與 Hex 文本框當(dāng)前值#12abefE2E 驗(yàn)證三層回歸的完整測試計(jì)劃功能落地后.qwen/e2e-tests/session-group-custom-hex-colors.md 給出了從基線到構(gòu)建驗(yàn)證的完整回歸路徑。基線 dry-run在本地構(gòu)建之前用全局安裝的 CLI 驗(yàn)證舊行為qwen --version對(duì)既有 session-groups 端點(diǎn)寫入#12ABEF的預(yù)期基線是 HTTP 400 且codeinvalid_group_colorWebShell 編輯器只暴露六個(gè)預(yù)設(shè)選項(xiàng)。Group ACore 契約cd packages/core npx vitest run src/services/session-organization-service.test.ts預(yù)期結(jié)果create/update 接受#12ABEF含偶然的周邊空白并返回#12abeflist/restart 保持規(guī)范值畸形 Hex 返回invalid_group_color會(huì)話快速標(biāo)簽仍拒絕 Hex預(yù)設(shè)目錄保持不變。Group B守護(hù)進(jìn)程傳輸與 SDKcd packages/cli npx vitest run src/serve/server.test.ts src/serve/acp-http/transport.test.ts cd ../sdk-typescript npx vitest run test/unit/DaemonClient.test.ts預(yù)期REST 與 ACP 的命名分組變更往返 Hex 值會(huì)話組織仍僅限預(yù)設(shè)色SDK 分組類型與響應(yīng)暴露自定義值。Group CWebShell UIcd packages/web-shell npx vitest run client/components/sidebar/WebShellSidebar.test.tsx預(yù)期Create/Rename 分組提供 Custom 選項(xiàng)原生取色器與 Hex 文本框保持同步非法文本時(shí)取色器停留在最后一個(gè)合法自定義色非法 Hex 禁用 Save 并暴露可訪問錯(cuò)誤既有自定義值以 Custom 模式重新打開自定義分組圓點(diǎn)使用持久化 Hex 色預(yù)設(shè)選擇行為不變。構(gòu)建驗(yàn)證與手動(dòng)檢查npm run format npm run build npm run typecheck npm run bundle手動(dòng) WebShell 檢查使用隔離運(yùn)行目錄export QWEN_RUNTIME_DIR$(mktemp -d /tmp/qwen-hex-groups.XXXXXX) node dist/cli.js serve --web在 WebShell 中創(chuàng)建名為Hex demo、顏色為#12ABEF的分組刷新頁面后重命名切換到預(yù)設(shè)色再切回 Custom確認(rèn)圓點(diǎn)顏色與小寫 Hex 均持久化同時(shí)確認(rèn)快速會(huì)話標(biāo)簽仍只提供六個(gè)預(yù)設(shè)。結(jié)果摘錄文檔記錄的驗(yàn)證結(jié)果macOS 環(huán)境Core 契約 24 項(xiàng)通過REST 命名分組 Hex 路徑 1 項(xiàng)通過ACP HTTP 命名分組 Hex 路徑 1 項(xiàng)通過TypeScript SDK 229 項(xiàng)通過WebShell 側(cè)邊欄 61 項(xiàng)通過僅存在既有的 Reactact()警告完整server.test.ts674 項(xiàng)通過唯一無關(guān)失敗位于 extension-update 狀態(tài)處理期望 202 實(shí)際 200。根構(gòu)建在同步上游 main 并應(yīng)用 #6748 的ScheduledTasksDialog導(dǎo)入修復(fù)后通過。Windows 與 Linux 行為交由 CI 覆蓋。邊界與設(shè)計(jì)取舍最后再總結(jié)幾條關(guān)鍵決策方便后續(xù)維護(hù)者理解為什么這樣做只接受六位#RRGGBB三、四、八位形式一律拒絕保證每個(gè)持久化值只有一種可預(yù)測形態(tài)Core 是權(quán)威客戶端可以提前歸一化以獲得即時(shí)反饋但最終以 Core 的 trim 小寫歸一化結(jié)果為準(zhǔn)不擴(kuò)展現(xiàn)有快速標(biāo)簽六值預(yù)設(shè)目錄作為緊湊的排序/過濾維度保持向后兼容sidecar schema 保持 v1字段仍是字符串舊預(yù)設(shè)值繼續(xù)有效無需遷移舊客戶端安全失敗WebShell 用內(nèi)聯(lián)background-color渲染 Hex 圓點(diǎn)不認(rèn)識(shí)的客戶端直接跳過該樣式即可快速標(biāo)簽與命名分組互斥在 UI 語義上二者是單選命名分組賦值會(huì)清除顏色標(biāo)簽反之亦然這一行為在 packages/web-shell/client/components/sidebar/WebShellSidebar.tsx 的注釋與updateSessionOrganization調(diào)用中均有體現(xiàn)。至此從 Core 校驗(yàn)、REST/ACP 透傳、SDK 類型到 WebShell 交互的完整閉環(huán)已經(jīng)打通。若你想親手驗(yàn)證直接按上文 Group A/B/C 的命令在對(duì)應(yīng)包目錄下運(yùn)行測試即可復(fù)現(xiàn)全部結(jié)果。【免費(fèi)下載鏈接】qwen-codeAn open-source AI coding agent that lives in your terminal.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 Qwen Code 會(huì)話分組自定義 Hex 顏色：從核心校驗(yàn)到 WebShell 的端到端實(shí)現(xiàn)指南
Qwen Code 會(huì)話分組自定義 Hex 顏色從核心校驗(yàn)到 WebShell 的端到端實(shí)現(xiàn)指南【免費(fèi)下載鏈接】qwen-codeAn open-source AI coding agent that lives in your terminal.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code本文圍繞 qwen-code 倉庫中命名會(huì)話組自定義 Hex 顏色issue #6744這一功能展開完整梳理其從核心服務(wù)校驗(yàn)、REST/ACP 傳輸、TypeScript SDK 類型到 WebShell 側(cè)邊欄編輯器的全鏈路實(shí)現(xiàn)與驗(yàn)證方案。讀完本文你將掌握六位#RRGGBB顏色值的接受規(guī)則與歸一化策略、預(yù)設(shè)色與自定義色的邊界劃分、以及如何用一套 e2e 測試計(jì)劃對(duì)核心契約 守護(hù)進(jìn)程傳輸 前端 UI三層做回歸驗(yàn)證。背景為什么需要自定義分組顏色qwen-code 中命名會(huì)話組named session groups此前與快速會(huì)話顏色標(biāo)簽quick session color tags共享同一個(gè)六值顏色枚舉red、orange、yellow、green、blue、purple。這套枚舉帶來的限制是明確的守護(hù)進(jìn)程daemon對(duì)任何枚舉之外的取值一律以invalid_group_color拒絕TypeScript SDK 暴露的是同樣的封閉聯(lián)合類型closed unionWebShell 的分組編輯器只提供一個(gè)預(yù)設(shè)色下拉框。結(jié)果就是用戶無法讓命名分組與既有項(xiàng)目配色對(duì)齊也無法在分組目錄變大時(shí)靠顏色做視覺區(qū)分。該問題由 docs/design/session-group-custom-hex-colors.md 記錄設(shè)計(jì)決策并在 .qwen/e2e-tests/session-group-custom-hex-colors.md 中給出完整驗(yàn)證方案。設(shè)計(jì)上遵循一個(gè)核心原則將預(yù)設(shè)會(huì)話標(biāo)簽色與命名分組展示色拆成兩條互不干擾的路徑——命名分組接受預(yù)設(shè)色或六位 Hex快速標(biāo)簽保持預(yù)設(shè)色不變。各層改動(dòng)一覽層變更內(nèi)容Core把預(yù)設(shè)會(huì)話標(biāo)簽色與命名分組展示色拆分。命名分組接受預(yù)設(shè)色或六位#RRGGBB快速標(biāo)簽僅限預(yù)設(shè)色。有效 Hex 在持久化前統(tǒng)一歸一化為小寫。REST / ACP快速標(biāo)簽校驗(yàn)保持預(yù)設(shè)色唯一命名分組顏色透傳給 Core 校驗(yàn)。TypeScript SDK導(dǎo)出預(yù)設(shè)色與 Hex 色兩種類型。分組輸入/輸出使用二者的聯(lián)合類型會(huì)話組織session organization繼續(xù)使用預(yù)設(shè)色。WebShell保留預(yù)設(shè)選項(xiàng)新增 Custom 選項(xiàng)原生取色器 Hex 文本框。自定義分組圓點(diǎn)以內(nèi)聯(lián)background-color渲染。對(duì)應(yīng)源碼文件清單見設(shè)計(jì)文檔 docs/design/session-group-custom-hex-colors.md核心實(shí)現(xiàn)集中在 packages/core/src/services/session-organization-service.ts。核心契約Core 層的顏色校驗(yàn)與歸一化類型邊界預(yù)設(shè)色 vs Hex 色packages/core/src/services/session-organization-service.ts 中定義了清晰的類型體系export const GROUP_COLOR_OPTIONS [ red, orange, yellow, green, blue, purple, ] as const; export type SessionGroupPresetColor (typeof GROUP_COLOR_OPTIONS)[number]; /** Shape hint only; runtime validation below enforces exactly six Hex digits. */ export type SessionGroupHexColor #${string}; export type SessionGroupColor SessionGroupPresetColor | SessionGroupHexColor;注意SessionGroupHexColor在類型層面只是#${string}的形狀提示真正的必須恰好六位十六進(jìn)制約束由運(yùn)行時(shí)校驗(yàn)強(qiáng)制見normalizeGroupColor。與此同時(shí)會(huì)話組織SessionOrganization的color字段仍限定為SessionGroupPresetColor | nullassertSessionColor也嚴(yán)格拒絕非預(yù)設(shè)值——這就是會(huì)話快速標(biāo)簽仍拒絕 Hex的實(shí)現(xiàn)根基。歸一化規(guī)則trim 小寫normalizeGroupColor是這一功能的核心函數(shù)function normalizeGroupColor(color: unknown): SessionGroupColor { const normalized typeof color string ? color.trim() : color; if (typeof normalized string isPresetGroupColor(normalized)) { return normalized; } if (typeof normalized string /^#[0-9a-f]{6}$/i.test(normalized)) { return normalized.toLowerCase() as SessionGroupHexColor; } throw new SessionOrganizationError( color must be a supported preset or a #RRGGBB hex value, invalid_group_color, color, ); }關(guān)鍵行為接受偶然的周邊空白先trim()因此 #12ABEF 也能通過小寫規(guī)范化#12ABEF會(huì)被持久化為#12abef保證所有已存值形態(tài)可預(yù)測嚴(yán)格六位正則^#[0-9a-f]{6}$i標(biāo)志拒絕三、四、八位形式如#abc、#abcd、#aabbccdd也拒絕命名 CSS 顏色與 alpha 通道失敗即拋錯(cuò)invalid_group_color結(jié)構(gòu)化錯(cuò)誤附帶field: color字段便于 REST 層直接映射 HTTP 400。createGroup與updateGroup都會(huì)在寫庫前調(diào)用normalizeGroupColor隨后通過withStoreLock串行化寫操作并調(diào)用atomicWriteJSON做原子寫入。分組名稱同樣有獨(dú)立校驗(yàn)1–64 字符、禁止控制字符、大小寫不敏感去重顏色只是其中的一個(gè)字段。持久化與容錯(cuò)分組數(shù)據(jù)存儲(chǔ)在側(cè)邊車文件session-organization.v1.json中STORE_FILE常量schema 版本保持為 1——因?yàn)榇鎯?chǔ)字段仍是字符串舊預(yù)設(shè)值天然有效無需遷移。讀取側(cè)normalizeSessionGroup對(duì)不支持的顏色值做降級(jí)處理回退到FALLBACK_GROUP_COLOR blue并只告警一次確保未來出現(xiàn)未知顏色類時(shí)舊客戶端也能安全失敗。測試印證packages/core/src/services/session-organization-service.test.ts 中有一條與本文主題直接對(duì)應(yīng)的用例it(accepts and normalizes custom hex colors for named groups, async () { const group await service.createGroup({ name: Custom, color: #12ABef as never, }); expect(group.color).toBe(#12abef); const updated await service.updateGroup(group.id, { color: #FEDCBA as never, }); expect(updated.color).toBe(#fedcba); const catalog await service.listGroups(); expect(catalog.groups[0]?.color).toBe(#fedcba); expect(catalog.colorOptions).toEqual(GROUP_COLOR_OPTIONS); const restarted new SessionOrganizationService(cwd); expect((await restarted.listGroups()).groups[0]?.color).toBe(#fedcba); });這條用例同時(shí)驗(yàn)證了帶空白輸入被接受、小寫歸一化、列表讀取返回規(guī)范值、重啟后restarted實(shí)例持久化值不丟失、且colorOptions預(yù)設(shè)目錄保持原樣。同文件還覆蓋了#abc被拒、pink等非預(yù)設(shè)/非 Hex 值返回invalid_group_color、未知存儲(chǔ)色回退為blue并告警等容錯(cuò)路徑。傳輸層REST 與 ACP 的 Hex 透傳REST 層位于 packages/cli/src/serve/routes/session.ts命名分組路由在 POST/workspace/:id/session-groups與 PATCH/workspace/:id/session-groups/:groupId中把請求體color字段原樣傳入 Coreconst group await runWithWorkspaceRuntimeStorage(runtime, () service.createGroup({ name: body[name] as string, color: body[color] as SessionGroupColor, }), ); res.status(201).json({ group });也就是說REST 層對(duì)命名分組顏色不做二次校驗(yàn)全部交由 Core 的normalizeGroupColor決定成敗——非法值自然映射為invalid_group_color錯(cuò)誤HTTP 400合法 Hex 則回傳小寫規(guī)范化后的值。快速標(biāo)簽路徑session organization 的color字段則保持預(yù)設(shè)色唯一校驗(yàn)例如 packages/cli/src/serve/routes/session.ts 中對(duì)rawColor的檢查仍限定為SessionGroupPresetColor | null。ACPAgent Client ProtocolHTTP 側(cè)由packages/cli/src/serve/acp-http/dispatch.ts走同樣的校驗(yàn)與轉(zhuǎn)發(fā)邏輯橋接層類型定義在 packages/acp-bridge/src/bridgeTypes.ts。SDK 類型導(dǎo)出預(yù)設(shè)色與 Hex 的聯(lián)合類型TypeScript SDK 的類型定義位于 packages/sdk-typescript/src/daemon/types.tsexport type DaemonSessionGroupPresetColor /* 六值預(yù)設(shè)色 */; export type DaemonSessionGroupHexColor #${string}; export type DaemonSessionGroupColor | DaemonSessionGroupPresetColor | DaemonSessionGroupHexColor;分組創(chuàng)建/更新輸入color?: DaemonSessionGroupColor與分組返回類型color: DaemonSessionGroupColor使用聯(lián)合類型因此#12abef可以完整地經(jīng) SDK 往返會(huì)話組織相關(guān)接口color?: DaemonSessionGroupPresetColor | null仍限定預(yù)設(shè)色與 Core 的SessionOrganization邊界保持一致分組目錄響應(yīng)中的colorOptions繼續(xù)返回預(yù)設(shè)色數(shù)組。SDK 的導(dǎo)出面packages/sdk-typescript/src/daemon/index.ts與packages/sdk-typescript/src/index.ts需要把新類型暴露給使用方。WebShellCustom 選項(xiàng)與取色器實(shí)現(xiàn)渲染邏輯Hex 判定與內(nèi)聯(lián)背景色packages/web-shell/client/components/sidebar/WebShellSidebar.tsx 中分組圓點(diǎn)的渲染按是否為 Hex分流function getGroupColorClass(color: DaemonSessionGroupColor) { if (color.startsWith(#)) return styles.groupColorCustom; // ... 預(yù)設(shè)色走既有 class } function getGroupColorStyle(color: DaemonSessionGroupColor) { return color.startsWith(#) ? { backgroundColor: color } : undefined; }預(yù)設(shè)色繼續(xù)使用預(yù)定義 CSS 類packages/web-shell/client/components/sidebar/WebShellSidebar.module.css自定義 Hex 分組則通過內(nèi)聯(lián)background-color渲染圓點(diǎn)——這樣不認(rèn)識(shí) Hex 類的舊客戶端也能安全失敗設(shè)計(jì)文檔明確要求Existing clients that do not recognize a Hex class should fail safely。編輯器取色器與 Hex 文本框雙向同步編輯器在 Create/Rename 分組對(duì)話框中新增了 Custom 選項(xiàng)下拉框保留全部預(yù)設(shè)選項(xiàng)并追加自定義Custom選項(xiàng)選中 Custom 后展開一行g(shù)roupCustomColorRow左側(cè)是原生input typecolor取色器右側(cè)是 Hex 文本輸入框組件用lastValidCustomGroupColor狀態(tài)保存最后一次合法自定義顏色原生取色器變化onChange直接更新該狀態(tài)Hex 文本框輸入先經(jīng)normalizeHexColorInput校驗(yàn)合法才同步回狀態(tài)無效文本不會(huì)破壞取色器即使 Hex 框內(nèi)容非法取色器仍停留在上一個(gè)合法自定義色上非法 Hex 禁用保存提交前用normalizeGroupColorInput重新校驗(yàn)非法時(shí) Save 按鈕不可用并暴露可訪問的錯(cuò)誤提示帶FieldLabel與htmlFor關(guān)聯(lián)的輸入框既有自定義值回顯編輯已有分組時(shí)若group.color以#開頭則自動(dòng)進(jìn)入 Custom 模式并回填 Hex 框保存成功后分組圓點(diǎn)即使用持久化的 Hex 顏色。相關(guān)狀態(tài)初始化可見 packages/web-shell/client/components/sidebar/WebShellSidebar.tsx 中的setLastValidCustomGroupColor(DEFAULT_CUSTOM_GROUP_COLOR)等邏輯i18n 文案如sidebar.groupColor.hex在 packages/web-shell/client/i18n.tsx 中維護(hù)。下面的截圖展示了新建分組對(duì)話框分組名稱為Design system顏色下拉選中自定義...下方出現(xiàn)顏色預(yù)覽方塊與 Hex 文本框當(dāng)前值#12abefE2E 驗(yàn)證三層回歸的完整測試計(jì)劃功能落地后.qwen/e2e-tests/session-group-custom-hex-colors.md 給出了從基線到構(gòu)建驗(yàn)證的完整回歸路徑。基線 dry-run在本地構(gòu)建之前用全局安裝的 CLI 驗(yàn)證舊行為qwen --version對(duì)既有 session-groups 端點(diǎn)寫入#12ABEF的預(yù)期基線是 HTTP 400 且codeinvalid_group_colorWebShell 編輯器只暴露六個(gè)預(yù)設(shè)選項(xiàng)。Group ACore 契約cd packages/core npx vitest run src/services/session-organization-service.test.ts預(yù)期結(jié)果create/update 接受#12ABEF含偶然的周邊空白并返回#12abeflist/restart 保持規(guī)范值畸形 Hex 返回invalid_group_color會(huì)話快速標(biāo)簽仍拒絕 Hex預(yù)設(shè)目錄保持不變。Group B守護(hù)進(jìn)程傳輸與 SDKcd packages/cli npx vitest run src/serve/server.test.ts src/serve/acp-http/transport.test.ts cd ../sdk-typescript npx vitest run test/unit/DaemonClient.test.ts預(yù)期REST 與 ACP 的命名分組變更往返 Hex 值會(huì)話組織仍僅限預(yù)設(shè)色SDK 分組類型與響應(yīng)暴露自定義值。Group CWebShell UIcd packages/web-shell npx vitest run client/components/sidebar/WebShellSidebar.test.tsx預(yù)期Create/Rename 分組提供 Custom 選項(xiàng)原生取色器與 Hex 文本框保持同步非法文本時(shí)取色器停留在最后一個(gè)合法自定義色非法 Hex 禁用 Save 并暴露可訪問錯(cuò)誤既有自定義值以 Custom 模式重新打開自定義分組圓點(diǎn)使用持久化 Hex 色預(yù)設(shè)選擇行為不變。構(gòu)建驗(yàn)證與手動(dòng)檢查npm run format npm run build npm run typecheck npm run bundle手動(dòng) WebShell 檢查使用隔離運(yùn)行目錄export QWEN_RUNTIME_DIR$(mktemp -d /tmp/qwen-hex-groups.XXXXXX) node dist/cli.js serve --web在 WebShell 中創(chuàng)建名為Hex demo、顏色為#12ABEF的分組刷新頁面后重命名切換到預(yù)設(shè)色再切回 Custom確認(rèn)圓點(diǎn)顏色與小寫 Hex 均持久化同時(shí)確認(rèn)快速會(huì)話標(biāo)簽仍只提供六個(gè)預(yù)設(shè)。結(jié)果摘錄文檔記錄的驗(yàn)證結(jié)果macOS 環(huán)境Core 契約 24 項(xiàng)通過REST 命名分組 Hex 路徑 1 項(xiàng)通過ACP HTTP 命名分組 Hex 路徑 1 項(xiàng)通過TypeScript SDK 229 項(xiàng)通過WebShell 側(cè)邊欄 61 項(xiàng)通過僅存在既有的 Reactact()警告完整server.test.ts674 項(xiàng)通過唯一無關(guān)失敗位于 extension-update 狀態(tài)處理期望 202 實(shí)際 200。根構(gòu)建在同步上游 main 并應(yīng)用 #6748 的ScheduledTasksDialog導(dǎo)入修復(fù)后通過。Windows 與 Linux 行為交由 CI 覆蓋。邊界與設(shè)計(jì)取舍最后再總結(jié)幾條關(guān)鍵決策方便后續(xù)維護(hù)者理解為什么這樣做只接受六位#RRGGBB三、四、八位形式一律拒絕保證每個(gè)持久化值只有一種可預(yù)測形態(tài)Core 是權(quán)威客戶端可以提前歸一化以獲得即時(shí)反饋但最終以 Core 的 trim 小寫歸一化結(jié)果為準(zhǔn)不擴(kuò)展現(xiàn)有快速標(biāo)簽六值預(yù)設(shè)目錄作為緊湊的排序/過濾維度保持向后兼容sidecar schema 保持 v1字段仍是字符串舊預(yù)設(shè)值繼續(xù)有效無需遷移舊客戶端安全失敗WebShell 用內(nèi)聯(lián)background-color渲染 Hex 圓點(diǎn)不認(rèn)識(shí)的客戶端直接跳過該樣式即可快速標(biāo)簽與命名分組互斥在 UI 語義上二者是單選命名分組賦值會(huì)清除顏色標(biāo)簽反之亦然這一行為在 packages/web-shell/client/components/sidebar/WebShellSidebar.tsx 的注釋與updateSessionOrganization調(diào)用中均有體現(xiàn)。至此從 Core 校驗(yàn)、REST/ACP 透傳、SDK 類型到 WebShell 交互的完整閉環(huán)已經(jīng)打通。若你想親手驗(yàn)證直接按上文 Group A/B/C 的命令在對(duì)應(yīng)包目錄下運(yùn)行測試即可復(fù)現(xiàn)全部結(jié)果。【免費(fèi)下載鏈接】qwen-codeAn open-source AI coding agent that lives in your terminal.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考