From 29309d66837ebe014d4258592678813f24559df7 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 8 Aug 2026 21:53:53 +0000 Subject: [PATCH] =?UTF-8?q?docs(skills):=20console-development.md=20?= =?UTF-8?q?=E9=A1=B6=E9=83=A8=E6=B3=A8=E8=AE=B0=E7=9A=84=E6=90=AC=E5=AE=B6?= =?UTF-8?q?=E5=BD=92=E5=9B=A0=E6=94=B9=E6=88=90=2004-21=E2=86=9204-23=20?= =?UTF-8?q?=E7=9A=84=20commit=20=E9=93=BE,cccdf84d7=20=E9=99=8D=E4=B8=BA?= =?UTF-8?q?=E5=85=B6=E4=B8=AD=E4=B8=80=E6=AD=A5=20(#3737)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 顶部引用块把「shell / layouts / home pages / navigation / 整个 metadata admin 迁入 @object-ui/app-shell」整包记在 commit cccdf84d7 名下,:82 那行又复述一遍「all of it left apps/console in cccdf84d7」。按注记去 git show 会拿到一个不含目标符号的 diff —— cccdf84d7 在 apps/console 下只删了 16 个文件:四个 designer 页、五个 pages/system/ 页、五个测试与两个 view-config 工具,shell / layout / navigation / home / hooks / providers 一个都不在里面。 实测的真实形态是一条跨三天的链(c1e105793 04-21 → 28ffe4033 04-22 → cccdf84d7 04-22 → b279d80d6 04-23),cccdf84d7 只是其中一步: - providers(AdapterProvider / MetadataProvider / ExpressionProvider):app-shell 副本 在 c1e105793(04-21)加入,apps/console 副本在 28ffe4033(04-22)删除 —— 两者都是 cccdf84d7 的祖先。 - navigation / layout / home / hooks(NavigationContext、FavoritesProvider、 UnifiedSidebar、ConsoleLayout、console/home/*、七个 hooks):apps/console 副本在 b279d80d6(04-23)删除,比 cccdf84d7 晚一天,而那个 commit 的标题是「feat: Add ReportView and SearchResultsPage components」,一个字都没提这批符号 —— 想顺着注记 追溯的人绝不会往那儿找,这也是本次订正把标题原样写进注记的原因。 改法保留 cccdf84d7 这个名字作纠错锚(不删),明写「早先版本把整包记在它名下」,让照 旧坐标搜索的人落在订正上而不是空手。两处 hooks 细节顺手写准:useObjectActions 与 useRecentItems 的 app-shell 副本其实早在 c1e105793 就落地,只有 console 副本等到 b279d80d6 才删,与卡片正文把七个 hooks 一律归给 b279d80d6 略有出入,结论不变。 边界:注记里 metadata admin 与 designer 两半未逐条复核,按 #3737 卡片边界不动 —— 本次只是把「单一 commit」这个错坐标撤掉,没有替它们另指一个 commit;#3730/PR #3734 已修的三处表/节同样未碰。ROADMAP.md:857/871 与 AppContent.tsx:110 对 cccdf84d7 的引用 经核实是正确用法(PermissionManagementPage 等确实在该 commit 删除),不在改动面内。 复核命令: git merge-base --is-ancestor 28ffe4033 cccdf84d7 git merge-base --is-ancestor cccdf84d7 b279d80d6 git log --diff-filter=A --format='%h %ad %s' --date=short -- Co-authored-by: Claude --- skills/objectui/guides/console-development.md | 40 +++++++++++++++---- 1 file changed, 33 insertions(+), 7 deletions(-) diff --git a/skills/objectui/guides/console-development.md b/skills/objectui/guides/console-development.md index 4058bc9676..152424ff99 100644 --- a/skills/objectui/guides/console-development.md +++ b/skills/objectui/guides/console-development.md @@ -7,12 +7,37 @@ description: Develop features for the Object UI Console application — the refe Use this skill when working on the Console application (`apps/console/`), the reference admin interface for Object UI. The Console demonstrates schema-driven patterns at scale and serves as the blueprint for enterprise admin interfaces. -> **`apps/console` is a reference assembly, not the engine.** Commit `cccdf84d7` -> ("Slim apps/console for third-party customisation") moved the shell, the layouts, -> the home pages, the navigation and the whole metadata admin into -> `@object-ui/app-shell`, moved the designer pages into -> `@object-ui/plugin-designer`, and left `apps/console` as a thin host that mostly -> declares routes. Two consequences for anyone reading this guide: +> **`apps/console` is a reference assembly, not the engine.** The shell, the layouts, +> the home pages, the navigation and the whole metadata admin live in +> `@object-ui/app-shell`, the designer pages live in `@object-ui/plugin-designer`, and +> `apps/console` is a thin host that mostly declares routes. +> +> **Don't credit that move to one commit.** Earlier revisions of this note attributed +> all of it to `cccdf84d7` ("Slim apps/console for third-party customisation", +> 2026-04-22); following that pointer lands you in a diff that never touches the +> symbols you are looking for. The `app-shell` extraction is a chain of commits +> spanning 2026-04-21 → 04-23, and `cccdf84d7` is **one step** in it — the step that +> removed the designer pages and `pages/system/`, not the shell/navigation move: +> +> - **Providers** (`AdapterProvider`, `MetadataProvider`, `ExpressionProvider`) — +> `app-shell` copies added in `c1e105793` (04-21, "extract core providers and hooks +> to @object-ui/app-shell"), `apps/console` copies deleted in `28ffe4033` (04-22, +> "Refactor context providers to use @object-ui/app-shell"). Both **before** +> `cccdf84d7`. +> - **Navigation, layout, home pages and the hooks** (`NavigationContext`, +> `FavoritesProvider`, `UnifiedSidebar`, `ConsoleLayout`, `console/home/*`, +> `useFavorites`, `useMetadataService`, `useNavPins`, `useNavigationSync`, +> `useObjectActions`, `useRecentItems`, `useResponsiveSidebar`) — `apps/console` +> copies deleted in `b279d80d6` (04-23), which is titled "feat: Add ReportView and +> SearchResultsPage components" and names none of it. **After** `cccdf84d7`. (Most +> `app-shell` copies land in that same commit; `useObjectActions` and +> `useRecentItems` arrived earlier, in `c1e105793`.) +> +> Check the symbol you actually care about instead of trusting any single-commit +> attribution for this refactor: +> `git log --diff-filter=A --format='%h %ad %s' --date=short -- packages/app-shell/...` +> +> Two consequences for anyone reading this guide: > > - **Look in `packages/app-shell` first.** Most symbols you want to change are > there, not under `apps/console/src/`. Grep before you assume a path. @@ -79,7 +104,8 @@ apps/console/src/pages/ └── SharedRecordPage.tsx # Public share-link landing ``` -Where the rest went (all of it left `apps/console` in `cccdf84d7`): +Where the rest went (spread across the 2026-04-21 → 04-23 `app-shell` extraction chain, +**not** `cccdf84d7` alone — see the commit-attribution note at the top of this guide): | Looking for | Today's home | |---|---|