Merge origin/main and add check_login_only function

Author: opencode

.github/scripts/validate-no-react-hooks.js

@@ -0,0 +1,82 @@
+const fs = require('fs');
+const path = require('path');
+
+const REACT_HOOKS = [
+  'useState',
+  'useEffect',
+  'useContext',
+  'useReducer',
+  'useCallback',
+  'useMemo',
+  'useRef',
+  'useImperativeHandle',
+  'useLayoutEffect',
+  'useDebugValue',
+  'useDeferredValue',
+  'useTransition',
+  'useId',
+  'useSyncExternalStore',
+  'useInsertionEffect'
+];
+
+function checkFile(filePath) {
+  const content = fs.readFileSync(filePath, 'utf-8');
+  const errors = [];
+
+  for (const hook of REACT_HOOKS) {
+    const patterns = [
+      new RegExp(`\\b${hook}\\s*=`),
+      new RegExp(`\\bReact\\.${hook}\\b`),
+      new RegExp(`import\\s+\\{[^}]*\\b${hook}\\b[^}]*\\}\\s+from\\s+['"]react['"]`),
+      new RegExp(`const\\s+\\{\\s*${hook}\\s*\\}\\s*=\\s*React`)
+    ];
+
+    for (const pattern of patterns) {
+      if (pattern.test(content)) {
+        errors.push(`${hook} (${path.basename(filePath)})`);
+      }
+    }
+  }
+
+  return errors;
+}
+
+function scanDirectory(dir, relativePath = '') {
+  let allErrors = [];
+
+  if (!fs.existsSync(dir)) {
+    return allErrors;
+  }
+
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    const relPath = path.join(relativePath, entry.name);
+
+    if (entry.isDirectory()) {
+      if (entry.name === 'node_modules' || entry.name === '.git') {
+        continue;
+      }
+      allErrors = allErrors.concat(scanDirectory(fullPath, relPath));
+    } else if (entry.isFile() && entry.name.endsWith('.js')) {
+      allErrors = allErrors.concat(checkFile(fullPath));
+    }
+  }
+
+  return allErrors;
+}
+
+const skillsDir = path.join(__dirname, '..', 'skills');
+const errors = scanDirectory(skillsDir);
+
+if (errors.length === 0) {
+  console.log('✅ 未检测到 React Hooks 使用');
+  process.exit(0);
+} else {
+  console.error('❌ 检测到禁止使用的 React Hooks:');
+  errors.forEach(err => console.error(`   - ${err}`));
+  console.error('\n宜搭自定义页面必须使用类组件模式，禁止使用 React Hooks');
+  console.error('请参考 yida-custom-page skill 的开发规范');
+  process.exit(1);
+}

.github/scripts/validate-project-root.js

@@ -0,0 +1,34 @@
+const fs = require('fs');
+const path = require('path');
+
+function findProjectRoot(startDir) {
+  let current = startDir;
+  while (true) {
+    const hasReadme = fs.existsSync(path.join(current, 'README.md'));
+    const hasGit = fs.existsSync(path.join(current, '.git')) && fs.statSync(path.join(current, '.git')).isDirectory();
+
+    if (hasReadme || hasGit) {
+      return current;
+    }
+
+    const parent = path.dirname(current);
+    if (parent === current) {
+      return startDir;
+    }
+    current = parent;
+  }
+}
+
+const scriptDir = path.join(__dirname, 'skills', 'yida-login', 'scripts');
+const result = findProjectRoot(scriptDir);
+
+const yidaSkillsRoot = path.resolve(__dirname, '..', '..');
+
+if (result === yidaSkillsRoot) {
+  console.log(`✅ find_project_root 正确找到项目根目录: ${result}`);
+  process.exit(0);
+} else {
+  console.error(`❌ find_project_root 找到错误的根目录: ${result}`);
+  console.error(`   预期: ${yidaSkillsRoot}`);
+  process.exit(1);
+}

.github/workflows/ci.yml

@@ -31,6 +31,12 @@ jobs:
     - name: Validate SKILL.md integrity
       run: node .github/scripts/validate-skill-md.js
 
+    - name: Validate project root detection
+      run: node .github/scripts/validate-project-root.js
+
+    - name: Validate no React Hooks in JSX
+      run: node .github/scripts/validate-no-react-hooks.js
+
     - name: Install test dependencies
       run: npm install
 

pr-body.md

@@ -0,0 +1,24 @@
+## Summary
+
+在 SKILL.md 中添加「⚠️ 常见错误」速查章节，避免开发者犯常见错误：
+
+- 输入框使用 `defaultValue` + 直接赋值，而非 `value` + `setCustomState`
+- 禁止使用 Hooks（useState, useEffect）
+- 必须使用 `renderJsx` 函数名
+- 使用模块级 `_customState` 管理状态
+
+## Changes
+
+- 在「何时使用」章节后添加「⚠️ 常见错误」速查表格
+- 修复原文档中的一些格式问题
+
+## Preview
+
+在「何时使用」章节后添加了速查表格：
+
+| 错误写法 | 正确写法 | 说明 |
+|----------|----------|------|
+| input value + setCustomState | input defaultValue + _customState.xxx = | 避免输入框失焦 |
+| useState, useEffect | 禁止使用 | 仅支持 React 16 |
+| render() {} | renderJsx() {} | 必须用 renderJsx |
+| this.setState({...}) | _customState.xxx = ... | 用模块级状态对象 |

skills/yida-create-form-page/SKILL.md

@@ -556,6 +556,14 @@ yida-create-form-page/
 | `appType` | String | 是 | 应用 ID |
 | `formDataJson` | String | 是 | 表单数据（JSON 字符串） |
 
+> ⚠️ **注意**：DateField 字段的值必须是**时间戳（毫秒）**，不能是字符串。例如：
+> ```javascript
+> // ✅ 正确
+> dateField_xxx: new Date().getTime()
+> // ❌ 错误
+> dateField_xxx: '2024-01-15'
+> ```
+
 ```javascript
 this.utils.yida.saveFormData({
   formUuid: 'FORM-XXX',
@@ -578,6 +586,8 @@ this.utils.yida.saveFormData({
 | `formInstId` | String | 是 | 表单实例 ID |
 | `updateFormDataJson` | String | 是 | 需要更新的字段（JSON 字符串） |
 
+> ⚠️ **注意**：DateField 字段的值必须是**时间戳（毫秒）**。
+
 ```javascript
 this.utils.yida.updateFormData({
   formInstId: 'FINST-XXX',

skills/yida-create-page/SKILL.md

@@ -116,7 +116,9 @@ yida-create-page/
 
 1. **创建应用** → 使用 `yida-create-app` 技能获取 `appType`
 2. **创建自定义页面** → 本技能，获取 `pageId`（formUuid）
-3. **编写 JSX 源码** → 参考 `yida` 技能的开发规范
-4. **部署页面代码** → 使用 `yida-publish` 技能将代码部署到该页面
+3. **编写 JSX 源码** → **必须先加载 `yida-custom-page` skill**，严格按照其开发规范编写代码
+4. **部署页面代码** → 使用 `yida-publish-page` 技能将代码部署到该页面
+
+> ⚠️ **重要警告**：宜搭自定义页面使用类组件模式，**禁止使用 React Hooks**（useState/useEffect）。编写代码前必须先加载 `yida-custom-page` skill 查看完整的开发规范。
 
 > **提示**：如果需要创建的是表单页面（带字段的数据收集页），请使用 `yida-create-form-page` 技能。

skills/yida-custom-page/SKILL.md

@@ -306,6 +306,42 @@ var inputEl = document.getElementById("my-input");
 if (inputEl) { inputEl.value = ""; }
 ```
 
+9. **DateField 必须是时间戳格式**：保存日期字段时，值必须是 **时间戳（毫秒）**，不能是字符串。示例：
+```javascript
+// ❌ 错误：字符串格式
+dateField_xxx: '2024-01-15'
+
+// ✅ 正确：时间戳格式
+dateField_xxx: new Date().getTime()
+```
+
+10. **多端适配**：宜搭自定义页面会在 PC 端和移动端同时展示，样式需要兼容两种设备。使用 `this.utils.isMobile()` 判断设备类型，动态调整布局和样式：
+```javascript
+const isMobile = this.utils.isMobile();
+
+var styles = {
+  container: { 
+    padding: isMobile ? '12px' : '16px',  // 移动端padding更小
+    minHeight: '100vh'
+  },
+  card: {
+    padding: isMobile ? '12px' : '16px',   // 移动端更紧凑
+    marginBottom: isMobile ? '8px' : '12px'
+  }
+};
+```
+
+11. **清除默认 padding 和圆角**：宜搭自定义页面容器有默认 padding 和圆角，需要强制覆盖：
+```javascript
+var styles = {
+  container: { 
+    padding: '0 16px',
+    borderRadius: '0 !important',  // 清除默认圆角
+    minHeight: '100vh'
+  }
+};
+```
+
 ---
 
 ## API 参考