@oj-module/cli 0.2.20 → 0.2.25

package/templates/README.md

@@ -7,7 +7,7 @@
 ```bash
 pnpm install
 pnpm dev        # 开发：前端 devServer + oj 后端（api/src 保存即热更）
-pnpm build      # 构建：oj build + 前端全站合并到 web/dist
+pnpm build      # 构建：oj build + 前端全站合并到 dist/web
 pnpm preview    # 预览：oj migrate + server（release 产物）
 ```
 
@@ -35,9 +35,9 @@ pnpm exec ojm api                     # 重新生成 web/src/*/__client（dev
 ```
 bin/           oj 二进制（init 解压，不入库）
 api/src/       后端模块源码（目录镜像路由：api/src/<模块>/<路径>/api.ts）
-api/dist/      oj build 产物
+dist/api/      oj build 产物
 web/src/   前端模块源码
-web/dist/  构建产物（完整站点）
+dist/web/  构建产物（完整站点）
 ```
 
 ## 注意

package/templates/cdn/README.md

@@ -1,8 +1,8 @@
 # cdn/ —— 本地模拟市场源
 
-本目录是**本地模拟 CDN**：`ojm market publish` 把分发包落在这里，站点通过 `api/config.yaml` 里的挂载
-（`- prefix: /cdn` → `web: ../cdn`）把它直出成分发源，市场页按系统设置 `framework.market_cdn_url`
-指向的地址读取。
+本目录是**本地模拟 CDN**：`ojm market publish` 把分发包落在这里，站点通过工程根 `config.yaml` 里的挂载
+（`- prefix: /cdn` → `web: ./cdn`）把它直出成分发源。市场按系统设置 `framework.market_cdn_url` 读取，
+**seed 缺省值即相对路径 `/cdn`（本站点自供），新工程免 `ojm market setup`**；指向外部真 CDN 时才改设置。
 
 > **目录缺失会让站点起不来**：`oj serve` 启动即校验挂载目录，缺失就报错退出。
 > 所以本 README 进模板、进发布包、进新工程——它的存在就是目录存在的理由，**不要删**。
@@ -23,14 +23,14 @@
 
 ## 生产怎么切出去
 
-1. 删掉 `api/config.yaml` 的 `mounts` 里这条（它就是本地挂载的全部）：
+1. 删掉工程根 `config.yaml` 的 `mounts` 里这条（它就是本地挂载的全部）：
 
 ```yaml
   - prefix: /cdn
-    web: ../cdn
+    web: ./cdn
 ```
 
-2. 把真 CDN（对象存储 / nginx）的地址写进系统设置 `framework.market_cdn_url`；
+2. 把真 CDN（对象存储 / nginx）的**绝对地址**写进系统设置 `framework.market_cdn_url`；
    命令行等价写法是 `ojm market setup --url <地址>`。
 3. 索引（`bundles.yaml` / `manifests.yaml`）由 CDN 侧维护：`ojm market build-index` 在本地产出后自行上传。
 

package/templates/config.yaml

@@ -30,19 +30,20 @@
 # **这里没有 api 挂载是有意的**：本工程是 `src/<name>/{api,web}` 布局，模块分散在
 # `src/<name>/api` 下，而 mounts 的 api 项按 `<目录>/<模块>/manifest.yaml` 单层解析、
 # 不会递归（实测报 `module 'x' missing manifest.yaml`）。源码形态由 `ojm dev` 用
-# `--module-root src` 供给，产物形态由 `ojm preview` 用 `--api-path api/dist` 供给；
+# `--module-root src` 供给，产物形态由 `ojm preview` 用 `--api-path dist/api` 供给；
 # 两者与 mounts 的 api 项同时出现还会报「module declared in multiple places」。
 # 手写部署（不经 ojm）时才需要自己加回一条 `- prefix: /api` + `api: dist`。
 mounts:
   # 本地模拟 CDN：直出工程根 cdn/（内容见 cdn/README.md）。
-  # 红线：生产请删掉这一条挂载，并把 system 设置 framework.market_cdn_url 指向真 CDN。
+  # seed 的 framework.market_cdn_url 缺省即 /cdn（本站点自供），新工程免 market setup。
+  # 红线：生产请删掉这一条挂载，并把 system 设置 framework.market_cdn_url 指向真 CDN（绝对地址）。
   # 不得给此挂载设 spa——缺文件必须返回 404，回落 index.html 会让市场解析崩。
   - prefix: /cdn
     web: ./cdn
   # 生产若由 oj 直出前端（前后端同进程，即 ojm preview 的生产形态），
-  # 取消下一行注释并先 build 出 web/dist（preview 会自动注入等价挂载，无需手改）：
+  # 取消下一行注释并先 build 出 dist/web（preview 会自动注入等价挂载，无需手改）：
   # - prefix: "/"
-  #   web: "./web/dist"   # 相对 config.yaml → 工程根/web/dist
+  #   web: "./dist/web"   # 相对 config.yaml → 工程根/dist/web
   #   spa: true
   # 嵌套 handler 组（oj v0.1.64）无需配置开关，组织方式见 api.ts 顶部注释。
 

package/templates/init.include.yaml

@@ -8,7 +8,7 @@
 #  2. 模板自运行专属文件——templates 本身也是一个可 `pnpm dev` 的工程，
 #     它的 package.json / node_modules / bin / lock 绝不能泄漏进用户工程；
 #     package.json 由 init 现场生成（钉死真实版本，不带 workspace:/catalog:）。
-#  3. 构建与运行期产物——api/dist、web/dist、logs、签发的私钥与 sqlite；
+#  3. 构建与运行期产物——dist/api、dist/web、logs、签发的私钥与 sqlite；
 #     模板跑过 build/dev 后会留在本地，既不进用户工程，更不该让所有工程
 #     共享同一把私钥。
 #  4. 模板自用元数据——本清单自身。

package/templates/package.json

@@ -9,7 +9,9 @@
 		"preview": "ojm preview",
 		"info": "ojm info",
 		"typecheck": "tsc --noEmit -p tsconfig.json",
-		"typecheck:api": "tsc --noEmit -p src/tsconfig.json"
+		"typecheck:api": "tsc --noEmit -p src/tsconfig.json",
+		"bundle": "ojm build --bundle",
+		"new": "ojm new"
 	},
 	"devDependencies": {
 		"@ant-design/cssinjs": "catalog:",

package/templates/seed.mysql.sql

@@ -1,5 +1,6 @@
 -- 系统设置默认值（PRD §4.3；注释内禁英文分号）
 INSERT IGNORE INTO sys_setting (key, module, `group`, type, value, default_value, label_key, secret, update_time) VALUES ('framework.site_title', 'framework', 'general', 'string', 'React Antd Admin', 'React Antd Admin', 'system:setting.site_title', 0, 0);
-INSERT IGNORE INTO sys_setting (key, module, `group`, type, value, default_value, label_key, secret, update_time) VALUES ('framework.market_cdn_url', 'framework', 'security', 'string', '', '', 'system:setting.market_cdn_url', 0, 0);
+-- 系统设置默认值（PRD §4.3；注释内禁英文分号；framework.market_cdn_url 缺省 /cdn = 本站点自供，免 setup）
+INSERT IGNORE INTO sys_setting (key, module, `group`, type, value, default_value, label_key, secret, update_time) VALUES ('framework.market_cdn_url', 'framework', 'security', 'string', '/cdn', '/cdn', 'system:setting.market_cdn_url', 0, 0);
 INSERT IGNORE INTO sys_setting (key, module, `group`, type, value, default_value, label_key, secret, update_time) VALUES ('ldap.enabled', 'ldap', 'login', 'bool', '0', '0', 'system:setting.ldap_enabled', 0, 0);
 INSERT IGNORE INTO sys_setting (key, module, `group`, type, value, default_value, label_key, secret, update_time) VALUES ('sso.enabled', 'sso', 'login', 'bool', '0', '0', 'system:setting.sso_enabled', 0, 0);

package/templates/seed.pg.sql

@@ -1,5 +1,6 @@
 -- 系统设置默认值（PRD §4.3；注释内禁英文分号）
 INSERT INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('framework.site_title', 'framework', 'general', 'string', 'React Antd Admin', 'React Antd Admin', 'system:setting.site_title', 0, 0) ON CONFLICT DO NOTHING;
-INSERT INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('framework.market_cdn_url', 'framework', 'security', 'string', '', '', 'system:setting.market_cdn_url', 0, 0) ON CONFLICT DO NOTHING;
+-- 系统设置默认值（PRD §4.3；注释内禁英文分号；framework.market_cdn_url 缺省 /cdn = 本站点自供，免 setup）
+INSERT INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('framework.market_cdn_url', 'framework', 'security', 'string', '/cdn', '/cdn', 'system:setting.market_cdn_url', 0, 0) ON CONFLICT DO NOTHING;
 INSERT INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('ldap.enabled', 'ldap', 'login', 'bool', '0', '0', 'system:setting.ldap_enabled', 0, 0) ON CONFLICT DO NOTHING;
 INSERT INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('sso.enabled', 'sso', 'login', 'bool', '0', '0', 'system:setting.sso_enabled', 0, 0) ON CONFLICT DO NOTHING;

package/templates/src/_platform/api/fixtures/l1-test-user.sql

@@ -1,10 +1,9 @@
 -- L1 测试账号（仅 `oj test` 经 fixtures 灌入，不进 release 产物）。
 --
--- 为什么不能用 seed 的 admin 跑 L1 登录：
---   ① seed 的 admin 是 must_change=1 首登改密态（D12 生产语义），且初始口令 123456
---      只是开发便利——用户在 dev 库改过口令后（产品主动引导），admin 口令即漂移，
---      L1 若绑 admin/123456 会随机 401（本地实测踩过：dev 库口令被改成 12345678）。
---   ② 判权类端点（currentAccess/assertPermission）对 must_change=1 恒 403。
+-- 为什么不能用 seed 的开发账号（admin/superadmin 等）跑 L1 登录：
+--   ① seed 账号初始口令 123456 只是开发便利——用户在 dev 库改过口令后，口令即漂移，
+--      L1 若绑 seed 账号会随机 401（本地实测踩过：dev 库口令被改成 12345678）。
+--   ② 不用 must_change 解释：seed 账号现均为 0（2026-10-22 口径）；真正的原因是 ①。
 -- 故 additive 建一个专用账号：INSERT OR IGNORE 幂等，反复重放终态一致，
 -- 不碰 admin 既有行（用户的口令/状态不受 `oj test` 影响）。
 -- 按分号朴素切分（S006）：语句内不得含分号字面量。

package/templates/src/_platform/api/market/api.ts

@@ -87,7 +87,7 @@ export interface MarketEnv {
 
 /**
  * 宿主 versions.json 布局推导（B-11）：与 manifests.yaml 同层（release 根 = `sharedRoot`），
- * 不是站点产物根——两处根在 `src/<name>/{api,web}` 布局下已分流（`api/dist` vs `web/dist`）。
+ * 不是站点产物根——两处根在 `src/<name>/{api,web}` 布局下已分流（`dist/api` vs `dist/web`）。
  */
 export function versionsJsonPathOf(releaseRoot: string): string {
 	const trimmed = releaseRoot.replace(/\/+$/, "");
@@ -132,21 +132,22 @@ async function hostVersionsOf(env: MarketEnv): Promise<Record<string, string> |
 /**
  * oj serve release 布局生产缺省（P1-16 B3/B4；全字段可覆盖）。
  *
- * 两处根在 `src/<name>/{api,web}` 布局下分流，且都相对 fs jail 根（= config.yaml 所在目录）：
- *   release 根 `api/dist` —— 版本目录 / manifests.yaml / versions.json / migrations（后端产物）
- *   站点根   `web/dist`   —— modules/ + modules.json（前端产物，安装器 upsert 的落点）
+ * 两处根在 `src/<name>/{api,web}` 布局下分流（2026-10-22 起收进工程根 dist/），
+ * 且都相对 fs jail 根（= config.yaml 所在目录）：
+ *   release 根 `dist/api` —— 版本目录 / manifests.yaml / versions.json / migrations（后端产物）
+ *   站点根   `dist/web`   —— modules/ + modules.json（前端产物，安装器 upsert 的落点）
  * 暂存 / 任务 / 状态 / 信任库 / db 仍在 jail 根下：它们是安装器私有面，不属任何产物根。
  */
 export function marketEnv(): MarketEnv {
 	return {
-		sharedRoot: "api/dist",
+		sharedRoot: "dist/api",
 		staging: "modules/.staging",
 		taskDir: "modules/.install-tasks",
 		statePath: "modules/.solutions/state.yaml",
 		trustPath: ".solutions/trusted-keys.yaml",
 		dbPath: "db.sqlite",
-		siteModulesDir: "web/dist/modules",
-		modulesJsonPath: "web/dist/modules.json",
+		siteModulesDir: "dist/web/modules",
+		modulesJsonPath: "dist/web/modules.json",
 		apiPrefix: "/api",
 		ledgerHeadOf: journalHeadOf,
 	};
@@ -162,7 +163,9 @@ function fail(status: number, msg: string): never {
 }
 
 function fetchOf(env: MarketEnv): FetchInitFace {
-	return env.fetch ?? (globalThis as { fetch?: FetchInitFace }).fetch as FetchInitFace;
+	// 相对基址（feature：/cdn = 本站点自供）按请求源补全同源绝对 URL；绝对 http(s) 直通。
+	// 无请求上下文（无 Host）不猜原点、原样透传；runInstall 侧的 withSiteOrigin 包裹幂等。
+	return withSiteOrigin(env.fetch ?? (globalThis as { fetch?: FetchInitFace }).fetch as FetchInitFace);
 }
 
 function execOf(env: MarketEnv): ExecFace {

package/templates/src/_platform/api/seed.mysql.sql

@@ -1,8 +1,16 @@
 -- _platform 种子数据 mysql 方言覆盖（方言覆盖文件必胜；INSERT OR IGNORE → INSERT IGNORE）。
--- 语句分号切分与注释纪律同基线 seed.sql。
-INSERT IGNORE INTO users (username, password_hash, must_change) VALUES ('admin', '$2y$10$ylE2NdjnYiuEcq54W/KxH.bhvGaQQg3rbmYI3mcEHX6LdQEAqixeC', 1);
+-- 语句分号切分与注释纪律同基线 seed.sql；账号口径同基线（账号名=角色名，must_change=0）。
+INSERT IGNORE INTO users (username, password_hash, must_change) VALUES ('superadmin', '$2y$10$ylE2NdjnYiuEcq54W/KxH.bhvGaQQg3rbmYI3mcEHX6LdQEAqixeC', 0);
+INSERT IGNORE INTO users (username, password_hash, must_change) VALUES ('admin', '$2y$10$ylE2NdjnYiuEcq54W/KxH.bhvGaQQg3rbmYI3mcEHX6LdQEAqixeC', 0);
+INSERT IGNORE INTO users (username, password_hash, must_change) VALUES ('editor', '$2y$10$ylE2NdjnYiuEcq54W/KxH.bhvGaQQg3rbmYI3mcEHX6LdQEAqixeC', 0);
+INSERT IGNORE INTO users (username, password_hash, must_change) VALUES ('viewer', '$2y$10$ylE2NdjnYiuEcq54W/KxH.bhvGaQQg3rbmYI3mcEHX6LdQEAqixeC', 0);
+DELETE FROM sys_user_role WHERE role_name = 'superadmin' AND user_id = (SELECT id FROM users WHERE username = 'admin');
+UPDATE users SET must_change = 0 WHERE username IN ('superadmin', 'admin', 'editor', 'viewer');
 INSERT IGNORE INTO sys_role (name, module, title, builtin) VALUES ('superadmin', 'framework', '超级管理员', 1);
 INSERT IGNORE INTO sys_role (name, module, title, builtin) VALUES ('admin', 'framework', '系统管理员', 1);
 INSERT IGNORE INTO sys_role (name, module, title, builtin) VALUES ('editor', 'framework', '编辑', 1);
 INSERT IGNORE INTO sys_role (name, module, title, builtin) VALUES ('viewer', 'framework', '访客', 1);
-INSERT IGNORE INTO sys_user_role (user_id, role_name) SELECT id, 'superadmin' FROM users WHERE username = 'admin';
+INSERT IGNORE INTO sys_user_role (user_id, role_name) SELECT id, 'superadmin' FROM users WHERE username = 'superadmin';
+INSERT IGNORE INTO sys_user_role (user_id, role_name) SELECT id, 'admin' FROM users WHERE username = 'admin';
+INSERT IGNORE INTO sys_user_role (user_id, role_name) SELECT id, 'editor' FROM users WHERE username = 'editor';
+INSERT IGNORE INTO sys_user_role (user_id, role_name) SELECT id, 'viewer' FROM users WHERE username = 'viewer';

package/templates/src/_platform/api/seed.pg.sql

@@ -1,8 +1,16 @@
 -- _platform 种子数据 pg 方言覆盖（方言覆盖文件必胜；INSERT OR IGNORE → ON CONFLICT DO NOTHING）。
--- 语句分号切分与注释纪律同基线 seed.sql。
-INSERT INTO users (username, password_hash, must_change) VALUES ('admin', '$2y$10$ylE2NdjnYiuEcq54W/KxH.bhvGaQQg3rbmYI3mcEHX6LdQEAqixeC', 1) ON CONFLICT DO NOTHING;
+-- 语句分号切分与注释纪律同基线 seed.sql；账号口径同基线（账号名=角色名，must_change=0）。
+INSERT INTO users (username, password_hash, must_change) VALUES ('superadmin', '$2y$10$ylE2NdjnYiuEcq54W/KxH.bhvGaQQg3rbmYI3mcEHX6LdQEAqixeC', 0) ON CONFLICT DO NOTHING;
+INSERT INTO users (username, password_hash, must_change) VALUES ('admin', '$2y$10$ylE2NdjnYiuEcq54W/KxH.bhvGaQQg3rbmYI3mcEHX6LdQEAqixeC', 0) ON CONFLICT DO NOTHING;
+INSERT INTO users (username, password_hash, must_change) VALUES ('editor', '$2y$10$ylE2NdjnYiuEcq54W/KxH.bhvGaQQg3rbmYI3mcEHX6LdQEAqixeC', 0) ON CONFLICT DO NOTHING;
+INSERT INTO users (username, password_hash, must_change) VALUES ('viewer', '$2y$10$ylE2NdjnYiuEcq54W/KxH.bhvGaQQg3rbmYI3mcEHX6LdQEAqixeC', 0) ON CONFLICT DO NOTHING;
+DELETE FROM sys_user_role WHERE role_name = 'superadmin' AND user_id = (SELECT id FROM users WHERE username = 'admin');
+UPDATE users SET must_change = 0 WHERE username IN ('superadmin', 'admin', 'editor', 'viewer');
 INSERT INTO sys_role (name, module, title, builtin) VALUES ('superadmin', 'framework', '超级管理员', 1) ON CONFLICT DO NOTHING;
 INSERT INTO sys_role (name, module, title, builtin) VALUES ('admin', 'framework', '系统管理员', 1) ON CONFLICT DO NOTHING;
 INSERT INTO sys_role (name, module, title, builtin) VALUES ('editor', 'framework', '编辑', 1) ON CONFLICT DO NOTHING;
 INSERT INTO sys_role (name, module, title, builtin) VALUES ('viewer', 'framework', '访客', 1) ON CONFLICT DO NOTHING;
-INSERT INTO sys_user_role (user_id, role_name) SELECT id, 'superadmin' FROM users WHERE username = 'admin' ON CONFLICT DO NOTHING;
+INSERT INTO sys_user_role (user_id, role_name) SELECT id, 'superadmin' FROM users WHERE username = 'superadmin' ON CONFLICT DO NOTHING;
+INSERT INTO sys_user_role (user_id, role_name) SELECT id, 'admin' FROM users WHERE username = 'admin' ON CONFLICT DO NOTHING;
+INSERT INTO sys_user_role (user_id, role_name) SELECT id, 'editor' FROM users WHERE username = 'editor' ON CONFLICT DO NOTHING;
+INSERT INTO sys_user_role (user_id, role_name) SELECT id, 'viewer' FROM users WHERE username = 'viewer' ON CONFLICT DO NOTHING;

package/templates/src/_platform/api/seed.sql

@@ -1,19 +1,31 @@
 -- _platform 种子数据（只放数据，DDL 归 migrations/，S006 纪律）。
 -- 方言覆盖：seed.mysql.sql / seed.pg.sql（INSERT OR IGNORE 为 sqlite 专属语法，方言文件必胜，同迁移约定）。
 -- 注意：seed 按英文分号朴素切分语句，注释里也不要出现英文分号。
--- 账号生命周期 D12：admin 为 seed 超管（superadmin），must_change=1 首登强制改密——
--- 初始口令 123456 仅为开发便利，must_change 闭环兜底默认凭据窗口（口令不随机生成的取舍见计划 A2 阶段小结）
-INSERT OR IGNORE INTO users (username, password_hash, must_change) VALUES ('admin', '$2y$10$ylE2NdjnYiuEcq54W/KxH.bhvGaQQg3rbmYI3mcEHX6LdQEAqixeC', 1);
+-- 账号生命周期 D12（2026-10-22 调整）：四个内置角色各一个开发账号，**账号名=角色名**
+-- （superadmin/admin/editor/viewer，避免心智负担），口令均 123456，must_change=0 免首登改密——
+-- 纯开发便利（默认凭据不随机生成的取舍见计划 A2 阶段小结），生产部署须改密或删除
+INSERT OR IGNORE INTO users (username, password_hash, must_change) VALUES ('superadmin', '$2y$10$ylE2NdjnYiuEcq54W/KxH.bhvGaQQg3rbmYI3mcEHX6LdQEAqixeC', 0);
+INSERT OR IGNORE INTO users (username, password_hash, must_change) VALUES ('admin', '$2y$10$ylE2NdjnYiuEcq54W/KxH.bhvGaQQg3rbmYI3mcEHX6LdQEAqixeC', 0);
+INSERT OR IGNORE INTO users (username, password_hash, must_change) VALUES ('editor', '$2y$10$ylE2NdjnYiuEcq54W/KxH.bhvGaQQg3rbmYI3mcEHX6LdQEAqixeC', 0);
+INSERT OR IGNORE INTO users (username, password_hash, must_change) VALUES ('viewer', '$2y$10$ylE2NdjnYiuEcq54W/KxH.bhvGaQQg3rbmYI3mcEHX6LdQEAqixeC', 0);
+-- 历史 seed 把 admin 绑在 superadmin 上；收敛为账号名=角色名（幂等 DELETE，每次重放生效）。
+-- 已存在库中 admin 行可能残留 must_change=1，UPDATE 统一收敛为 0（四个均为 seed 自有开发账号）
+DELETE FROM sys_user_role WHERE role_name = 'superadmin' AND user_id = (SELECT id FROM users WHERE username = 'admin');
+UPDATE users SET must_change = 0 WHERE username IN ('superadmin', 'admin', 'editor', 'viewer');
 -- 框架内置角色（ROLES 单一真相：superadmin 安全敏感项 / admin 日常管理 / editor、viewer 页面门）
 INSERT OR IGNORE INTO sys_role (name, module, title, builtin) VALUES ('superadmin', 'framework', '超级管理员', 1);
 INSERT OR IGNORE INTO sys_role (name, module, title, builtin) VALUES ('admin', 'framework', '系统管理员', 1);
 INSERT OR IGNORE INTO sys_role (name, module, title, builtin) VALUES ('editor', 'framework', '编辑', 1);
 INSERT OR IGNORE INTO sys_role (name, module, title, builtin) VALUES ('viewer', 'framework', '访客', 1);
--- seed 超管绑定（sys_user_role 唯一权威源，D10）
-INSERT OR IGNORE INTO sys_user_role (user_id, role_name) SELECT id, 'superadmin' FROM users WHERE username = 'admin';
+-- 角色绑定（sys_user_role 唯一权威源，D10）：账号名=角色名一一对应
+INSERT OR IGNORE INTO sys_user_role (user_id, role_name) SELECT id, 'superadmin' FROM users WHERE username = 'superadmin';
+INSERT OR IGNORE INTO sys_user_role (user_id, role_name) SELECT id, 'admin' FROM users WHERE username = 'admin';
+INSERT OR IGNORE INTO sys_user_role (user_id, role_name) SELECT id, 'editor' FROM users WHERE username = 'editor';
+INSERT OR IGNORE INTO sys_user_role (user_id, role_name) SELECT id, 'viewer' FROM users WHERE username = 'viewer';
 -- 系统设置默认值（PRD §4.3；C4 设置页 / C5 登录方式发现的数据源；framework.market_cdn_url 安全组仅 superadmin 可改）
+-- framework.market_cdn_url 缺省 /cdn = 本站点自供（config.yaml 的 /cdn 挂载直出工程根 cdn/），脚手架免 setup；外部真 CDN 才改指绝对地址
 INSERT OR IGNORE INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('framework.site_title', 'framework', 'general', 'string', 'React Antd Admin', 'React Antd Admin', 'system:setting.site_title', 0, 0);
-INSERT OR IGNORE INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('framework.market_cdn_url', 'framework', 'security', 'string', '', '', 'system:setting.market_cdn_url', 0, 0);
+INSERT OR IGNORE INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('framework.market_cdn_url', 'framework', 'security', 'string', '/cdn', '/cdn', 'system:setting.market_cdn_url', 0, 0);
 INSERT OR IGNORE INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('ldap.enabled', 'ldap', 'login', 'bool', '0', '0', 'system:setting.ldap_enabled', 0, 0);
 INSERT OR IGNORE INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('sso.enabled', 'sso', 'login', 'bool', '0', '0', 'system:setting.sso_enabled', 0, 0);
 INSERT OR IGNORE INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('ldap_base_dn', 'ldap', 'ldap', 'string', '', '', 'system:setting.ldap_base_dn', 0, 0);

package/templates/src/_platform/api/solutions/api.ts

@@ -37,9 +37,9 @@ export type { SolutionRouteRow } from "../_lifecycle/verify-checks";
  */
 export function solutionsEnv(): SolutionsEnv {
 	return {
-		sharedRoot: "api/dist",
+		sharedRoot: "dist/api",
 		statePath: "modules/.solutions/state.yaml",
-		modulesJsonPath: "web/dist/modules.json",
+		modulesJsonPath: "dist/web/modules.json",
 		apiPrefix: "/api",
 	};
 }

package/templates/src/oj-market/web/api/context.ts

@@ -1,5 +1,5 @@
 import type { MarketClient } from "./client";
-import { createContext, useContext } from "react";
+import { createContext, use } from "react";
 import { httpMarketClient } from "./defaultClient";
 
 /** 市场客户端上下文（依赖注入位；默认 = 运行时 HTTP 实现，测试可替换为内存 fake） */
@@ -7,5 +7,5 @@ export const MarketClientContext = createContext<MarketClient>(httpMarketClient)
 
 /** 组件/hooks 取客户端（默认注入运行时实现） */
 export function useMarketClient(): MarketClient {
-	return useContext(MarketClientContext);
+	return use(MarketClientContext);
 }

package/templates/src/oj-market/web/components/InstallDialog.tsx

@@ -44,7 +44,7 @@ export function InstallDialog({ row, open, onClose, onDone, version, mode }: Ins
 	// onDone 对同一任务只通告一次：父级每次渲染都会换 onDone 身份，若只靠 deps 触发，
 	// 终态后 onDone → index.retry() → 父级重渲染 → onDone 身份变 → 再触发，会形成
 	// 无限请求循环（浏览器侧表现为 ERR_INSUFFICIENT_RESOURCES）。
-	const notifiedTaskId = useRef<string | null>(null);
+	const notifiedTaskIdRef = useRef<string | null>(null);
 
 	const targetVersion = version ?? row?.latest ?? null;
 	const title
@@ -54,9 +54,13 @@ export function InstallDialog({ row, open, onClose, onDone, version, mode }: Ins
 				? t("oj-market:card:upgrade")
 				: t("oj-market:task:installing");
 
-	// 打开即触发安装（version 缺省取 latest；已装视为升级；显式 version = 回滚降级安装）
+	// 打开即触发安装（version 缺省取 latest；已装视为升级；显式 version = 回滚降级安装）。
+	// 注：下面的同步 set 均为「弹窗打开/关闭生命周期」的有意重置与触发守卫；
+	// 曾尝试渲染期派生重置，但同组件 notifier effect 里的 onDone?.(record) 会触发
+	// eslint-react set-state-in-effect 的误判（prop 回调被解析回组件函数），故保留原结构。
 	useEffect(() => {
 		if (open && row && !started) {
+			// eslint-disable-next-line react/set-state-in-effect -- 有意：打开弹窗时置「已触发」守卫，保证安装只发起一次
 			setStarted(true);
 			client
 				.install({ name: row.name, version: targetVersion, source: "cdn" })
@@ -64,19 +68,22 @@ export function InstallDialog({ row, open, onClose, onDone, version, mode }: Ins
 				.catch(e => setTaskId(`__error__${e instanceof Error ? e.message : String(e)}`));
 		}
 		if (!open) {
+			// eslint-disable-next-line react/set-state-in-effect -- 有意：关闭弹窗时清空任务，下次打开是全新一次安装
 			setTaskId(null);
+			// eslint-disable-next-line react/set-state-in-effect -- 有意：关闭时复位触发守卫，配合上行清场
 			setStarted(false);
+			// eslint-disable-next-line react/set-state-in-effect -- 有意：关闭时清掉信任错误，避免残留到下次打开
 			setTrustError(null);
-			notifiedTaskId.current = null;
+			notifiedTaskIdRef.current = null;
 		}
 	}, [open, row, started, client, targetVersion]);
 
 	useEffect(() => {
 		if (!record || !isTerminal(record) || !done)
 			return;
-		if (notifiedTaskId.current === record.id)
+		if (notifiedTaskIdRef.current === record.id)
 			return;
-		notifiedTaskId.current = record.id;
+		notifiedTaskIdRef.current = record.id;
 		onDone?.(record);
 	}, [record, done, onDone]);
 
@@ -88,7 +95,7 @@ export function InstallDialog({ row, open, onClose, onDone, version, mode }: Ins
 		setTrustError(null);
 		try {
 			await client.trust(taskId);
-			notifiedTaskId.current = null;
+			notifiedTaskIdRef.current = null;
 			setTaskId(null);
 			setStarted(false);
 		}

package/templates/src/oj-market/web/components/RollbackDialog.tsx

@@ -1,6 +1,6 @@
 import type { IndexRow } from "../types";
 import { Alert, Modal, Radio, Space, Spin, Typography } from "antd";
-import React, { useEffect, useMemo, useState } from "react";
+import React, { useMemo, useState } from "react";
 import { useTranslation } from "react-i18next";
 import { useMarketHistory } from "../hooks/useMarket";
 import { compareVersions } from "../utils/semver";
@@ -34,9 +34,13 @@ export function RollbackDialog({ row, open, onClose, onRollback }: RollbackDialo
 		return [...versions].sort((a, b) => compareVersions(b, a)); // 较新的旧版在前
 	}, [row, status, data]);
 
-	useEffect(() => {
+	// 候选集变化（历史加载完成/切换方案）时默认选中最新旧版；
+	// 渲染期同步派生重置，替代 effect 内同步 set（react/set-state-in-effect）
+	const [prevCandidates, setPrevCandidates] = useState(candidates);
+	if (prevCandidates !== candidates) {
+		setPrevCandidates(candidates);
 		setSelected(candidates.length ? candidates[0] : null);
-	}, [candidates]);
+	}
 
 	const loading = status === "loading";
 

package/templates/src/oj-market/web/components/UninstallConfirm.tsx

@@ -19,22 +19,33 @@ export function UninstallConfirm({ row, open, onClose, onConfirmed }: UninstallC
 	const { t } = useTranslation();
 	const client = useMarketClient();
 	const [impact, setImpact] = useState<UninstallImpact | null>(null);
-	const [loading, setLoading] = useState(false);
 	const [error, setError] = useState<string | null>(null);
 
+	// 打开（或切换方案）即清场上一轮结果；渲染期同步派生重置，替代 effect 内同步 set
+	const rowKey = open && row ? row.name : null;
+	const [prevRowKey, setPrevRowKey] = useState(rowKey);
+	if (prevRowKey !== rowKey) {
+		setPrevRowKey(rowKey);
+		setImpact(null);
+		setError(null);
+	}
+
 	useEffect(() => {
 		if (!open || !row)
 			return;
-		setLoading(true);
-		setError(null);
-		setImpact(null);
+		let active = true;
 		client
 			.uninstallImpact(row.name)
-			.then(setImpact)
-			.catch(e => setError(e instanceof Error ? e.message : String(e)))
-			.finally(() => setLoading(false));
+			.then(i => active && setImpact(i))
+			.catch(e => active && setError(e instanceof Error ? e.message : String(e)));
+		return () => {
+			active = false;
+		};
 	}, [open, row, client]);
 
+	// 加载态派生：已打开且尚无结果/错误即视为预检中（替代原 effect 同步 setLoading）
+	const loading = rowKey !== null && impact === null && error === null;
+
 	return (
 		<Modal
 			title={t("oj-market:confirm:uninstallTitle")}

package/templates/src/oj-market/web/hooks/useMarket.ts

@@ -12,10 +12,12 @@ export type LoadState<T> = { status: "loading", data?: undefined } | { status: "
 export function useMarketIndex(): LoadState<IndexRow[]> & { retry: () => void } {
 	const client = useMarketClient();
 	const [state, setState] = useState<LoadState<IndexRow[]>>({ status: "loading" });
+	// 重试不复跑「先同步 set loading 再拉取」的加载函数（effect 内同步 set 触发
+	// react/set-state-in-effect），改为事件里置 loading + 递增 nonce 驱动 effect 重跑。
+	const [nonce, setNonce] = useState(0);
 
-	const load = useCallback(() => {
+	useEffect(() => {
 		let active = true;
-		setState({ status: "loading" });
 		client
 			.index()
 			.then(data => active && setState({ status: "ok", data }))
@@ -23,11 +25,14 @@ export function useMarketIndex(): LoadState<IndexRow[]> & { retry: () => void }
 		return () => {
 			active = false;
 		};
-	}, [client]);
+	}, [client, nonce]);
 
-	useEffect(() => load(), [load]);
+	const retry = useCallback(() => {
+		setState({ status: "loading" });
+		setNonce(n => n + 1);
+	}, []);
 
-	return { ...state, retry: load };
+	return { ...state, retry };
 }
 
 /** 任务轮询：给定 task_id，800ms 轮询至终态（done/failed/partial）；超时不抛，返回当前值 */
@@ -39,17 +44,20 @@ export function useInstallTask(taskId: string | null): {
 	const [record, setRecord] = useState<TaskRecord | null>(null);
 	const [done, setDone] = useState(false);
 
+	// 无任务 id / 切换任务 = 尚无任务：清空上一次任务的记录，避免「重新安装/信任后重试」时
+	// 旧终态（可能是 needs_trust）残留在弹窗里被误读成本次结果。
+	// （渲染期同步派生重置，替代 effect 内同步 set，规避 react/set-state-in-effect）
+	const [prevTaskId, setPrevTaskId] = useState(taskId);
+	if (prevTaskId !== taskId) {
+		setPrevTaskId(taskId);
+		setRecord(null);
+		setDone(false);
+	}
+
 	useEffect(() => {
-		// 无任务 id = 尚无任务：清空上一次任务的记录，避免「重新安装/信任后重试」时
-		// 旧终态（可能是 needs_trust）残留在弹窗里被误读成本次结果。
-		if (!taskId) {
-			setRecord(null);
-			setDone(false);
+		if (!taskId)
 			return;
-		}
 		let active = true;
-		setRecord(null);
-		setDone(false);
 		poll(
 			() => client.task(taskId),
 			r => r.status !== "running",
@@ -80,10 +88,11 @@ export function useInstallTask(taskId: string | null): {
 export function useMarketHistory(): LoadState<MarketHistory[]> & { retry: () => void } {
 	const client = useMarketClient();
 	const [state, setState] = useState<LoadState<MarketHistory[]>>({ status: "loading" });
+	// 同 useMarketIndex：重试走 nonce 驱动，不在 effect 链路里同步 set
+	const [nonce, setNonce] = useState(0);
 
-	const load = useCallback(() => {
+	useEffect(() => {
 		let active = true;
-		setState({ status: "loading" });
 		client
 			.history()
 			.then(data => active && setState({ status: "ok", data }))
@@ -91,9 +100,12 @@ export function useMarketHistory(): LoadState<MarketHistory[]> & { retry: () =>
 		return () => {
 			active = false;
 		};
-	}, [client]);
+	}, [client, nonce]);
 
-	useEffect(() => load(), [load]);
+	const retry = useCallback(() => {
+		setState({ status: "loading" });
+		setNonce(n => n + 1);
+	}, []);
 
-	return { ...state, retry: load };
+	return { ...state, retry };
 }

package/templates/src/system/web/locales/en-US.json

@@ -30,7 +30,7 @@
 			"displayName": "Display Name",
 			"email": "Email",
 			"roles": "Roles",
-			"status": "Status",
+			"status": "Account status (forbidden / password change)",
 			"actions": "Actions"
 		}
 	},

package/templates/src/system/web/locales/zh-CN.json

@@ -30,7 +30,7 @@
 			"displayName": "显示名",
 			"email": "邮箱",
 			"roles": "角色",
-			"status": "状态",
+			"status": "账号状态（禁用/首登改密）",
 			"actions": "操作"
 		}
 	},

package/templates/src/system/web/pages/users/roles.tsx

@@ -7,7 +7,7 @@ import { useTranslation } from "react-i18next";
 import { useNavigate, useParams } from "react-router";
 
 import { systemRolesGet, systemUsersGet, systemUsersRolesPut } from "../../__client/api";
-import { isForbidden } from "../errors";
+import { explainError, isForbidden } from "../errors";
 import { ForbiddenPanel } from "../forbidden";
 
 /**
@@ -36,6 +36,8 @@ export default function UserRolesPage() {
 			queryClient.invalidateQueries({ queryKey: ["system", "users"] });
 			navigate("/system/users");
 		},
+		// 403 全局 toast 已被请求层抑制，页面须自行反馈（admin 非 superadmin 手输 URL 的场景）
+		onError: e => message.error(explainError(e, t)),
 	});
 
 	const user = usersQuery.data?.find(u => String(u.id) === uid);

package/templates/tests/l1-builder.test.ts

@@ -11,8 +11,8 @@
 //   ③ notification：join ON 值条件 + UNION ALL + 字面量列 {lit,as} 的真渲染（场景 41 同款）。
 //
 // 登录账号：fixtures 的 l1tester（src/_platform/fixtures/l1-test-user.sql，仅 oj test 灌入）。
-// 不用 seed 的 admin：其 must_change=1（判权端点恒 403）且初始口令 123456 会随用户
-// 首登改密漂移——L1 绑 admin 曾实测 401。l1tester 为 additive 专用账号（must_change=0）。
+// 不用 seed 的 admin 等开发账号：初始口令 123456 会随用户在 dev 库改密漂移——
+// L1 绑 seed 账号曾实测 401。l1tester 为 additive 专用账号（must_change=0）。
 //
 // 运行：cd packages/cli/templates/api && ~/.local/share/oj/oj test -c config.yaml -d src -t tests