@lark-apaas/coding-steering 0.1.69-beta.0 → 0.1.69

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/coding-steering",
-  "version": "0.1.69-beta.0",
+  "version": "0.1.69",
   "description": "Stack-specific steering content for miaoda-coding templates",
   "type": "module",
   "files": [

package/steering/nestjs-react-fullstack/skills/coding-guide/SKILL.md

@@ -220,7 +220,7 @@ shared/
 
 **通用规则**：Agent 的全部验证入口（截图 / E2E / 接口测试 / 手写 curl）都在沙箱内部，不论直连 vite 还是经沙箱内 nginx 8080，都不经过平台网关。凡是由平台网关按路径接管的接口，在 Agent 侧一律不可达，与应用是否发布无关（实例见「`__runtime__` 接口在 Agent 验证入口下不可达」）。
 
-- **看页面 / 白屏 / 交互**：优先用截图、视觉检查或 E2E 工具，并只传相对路径；有视觉检查工具时先用它，需要验证交互或数据时再用 E2E；工具会打开沙箱内预览入口（E2E 走沙箱内 nginx 8080，不是平台网关）。不要用 `curl` 拿 HTML 判断页面是否渲染。
+- **看页面 / 白屏 / 交互**：优先用截图、视觉检查或 E2E 工具，并只传相对路径；工具会打开沙箱内预览入口（E2E 走沙箱内 nginx 8080，不是平台网关）。不要用 `curl` 拿 HTML 判断页面是否渲染。
 - **测后端接口**：优先用接口测试工具，只传以 `/api` 或 `/openapi` 开头的业务路径；工具会自动拼 `CLIENT_BASE_PATH`、选择正确 dev 端口，并补 CSRF 与用户身份。
 - **必须手写 curl 调 `/api/*` 时**：打 client dev server，不要打 NestJS `SERVER_PORT`；URL 必须带 `$CLIENT_BASE_PATH`，并同时带 `Cookie: suda-csrf-token=<X>` 与 `X-Suda-Csrf-Token: <X>`（两值字面相等）。漏 basePath 是 404，漏 CSRF 是 403，都不是业务代码 bug，不要为此改 csrf 中间件或给接口加白名单。
 - **不要直连 NestJS 端口**：会绕过 dev server / 网关注入，`x-larkgw-suda-webuser` 缺失后 `userContext.userId` 为空，依赖身份的接口会误判。

package/steering/nestjs-react-fullstack/skills_common/trigger-guide/SKILL.md

@@ -17,6 +17,14 @@ gate-tools:
 3. 自动化任务只会调用应用的已发布版本，开发预览不会接收自动触发；新增或修改 `@BindTrigger` 处理器后必须发布才会生效。尚未发布时，明确告诉用户“代码已提交，发布后生效”，不要说任务已在运行。
 4. 用户只要求准备任务或运行意图不明确时，保持 `inactive`，并明确告知用户任务尚未运行。
 
+### 开发态不会触发 cron / record_change
+
+`cron` 和 `record_change` 的真实触发只投递到线上已发布版本（未发布则执行失败），开发态 dev server 收不到，与 `Active`、cron 时间、数据是否变更都无关。因此在开发态：
+
+- 不要通过改数据、把 cron 改到最近时间再 `sleep` 来等触发，也不要因为“没触发”去改处理器或换方案。普通模式应用的开发态与线上共用数据库，改数据还可能真的触发一次线上任务。
+- 只验证业务逻辑：逻辑放在 service 方法中，通过已有接口或临时调试入口直接调用，验证后删除临时入口；需要按触发器完整跑一次时，请用户在自动化面板点击“测试”。
+- 真实触发须发布后验证：发布 → `ENABLE` → `GET` 确认 `Active=true` → 查看线上日志。未发布时直接告诉用户“发布后生效”。
+
 ### 目录结构
 
 ```text