create-dwy 0.6.4 → 0.6.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-dwy",
-  "version": "0.6.4",
+  "version": "0.6.5",
   "description": "项目脚手架与 Claude Code 配置同步工具",
   "type": "module",
   "bin": {

package/src/sync.js

@@ -93,6 +93,29 @@ async function scanCommands(sourceDir) {
   return commands.sort((a, b) => a.name.localeCompare(b.name))
 }
 
+/**
+ * 扫描 hooks 目录
+ */
+async function scanHooks(sourceDir) {
+  const hooksDir = path.join(sourceDir, 'hooks')
+  if (!await fs.pathExists(hooksDir)) return []
+
+  const entries = await fs.readdir(hooksDir, { withFileTypes: true })
+  const hooks = []
+
+  for (const entry of entries) {
+    if (entry.name === '.gitkeep') continue
+    hooks.push({
+      name: entry.name,
+      description: entry.isDirectory() ? '钩子目录' : '钩子脚本',
+      sourcePath: path.join(hooksDir, entry.name),
+      type: 'hook',
+    })
+  }
+
+  return hooks.sort((a, b) => a.name.localeCompare(b.name))
+}
+
 /**
  * 用 inquirer 做交互式多选
  */
@@ -225,15 +248,17 @@ export async function syncClaude() {
   const skills = await scanSkills(sourceDir)
   const rules = await scanRules(sourceDir)
   const commands = await scanCommands(sourceDir)
+  const hooks = await scanHooks(sourceDir)
 
-  console.log(chalk.yellow(`Found ${skills.length} skills, ${rules.length} rules, ${commands.length} commands\n`))
+  console.log(chalk.yellow(`Found ${skills.length} skills, ${rules.length} rules, ${commands.length} commands, ${hooks.length} hooks\n`))
 
   // 交互式选择
   const selectedSkills = await promptSelection(skills, 'Skills')
   const selectedRules = await promptSelection(rules, 'Rules')
   const selectedCommands = await promptSelection(commands, 'Commands')
+  const selectedHooks = await promptSelection(hooks, 'Hooks')
 
-  const totalSelected = selectedSkills.length + selectedRules.length + selectedCommands.length
+  const totalSelected = selectedSkills.length + selectedRules.length + selectedCommands.length + selectedHooks.length
   if (totalSelected === 0) {
     console.log(chalk.yellow('\nNo skills/rules/commands selected.'))
   }
@@ -250,12 +275,26 @@ export async function syncClaude() {
   }
   syncedCount += await syncSettings(sourceDir, projectTargetDir)
 
+  // Hooks 同步到项目级 .claude/hooks/（settings.json 用 $CLAUDE_PROJECT_DIR 引用）
+  if (selectedHooks.length > 0) {
+    const hooksTargetDir = path.join(projectTargetDir, 'hooks')
+    await fs.ensureDir(hooksTargetDir)
+    for (const hook of selectedHooks) {
+      const dest = path.join(hooksTargetDir, hook.name)
+      await fs.copy(hook.sourcePath, dest, { overwrite: true })
+      await fs.chmod(dest, 0o755)
+      syncedCount++
+      console.log(chalk.green(`  ✓ hooks/${hook.name}`))
+    }
+  }
+
   // CLAUDE.md 同步到全局
   await fs.ensureDir(globalTargetDir)
   syncedCount += await syncClaudeMd(sourceDir, globalTargetDir)
 
   console.log(chalk.blue(`\nDone! Synced ${syncedCount} items.`))
   console.log(chalk.gray(`  Project config → ${projectTargetDir}`))
+  console.log(chalk.gray(`  Hooks          → ${path.join(projectTargetDir, 'hooks')}`))
   console.log(chalk.gray(`  CLAUDE.md      → ${globalTargetDir}`))
 }
 

package/templates/claude-global/rules/dwy-payload-limits.md

@@ -1,3 +1,11 @@
+---
+description: 用户输入 / HTTP 请求体 / 文件上传的长度与大小限制。涉及表单字段 maxlength、Nginx client_max_body_size、Pydantic max_length、分页 page_size 上限、批量操作 items 限制、文件上传大小与像素校验时触发。
+paths:
+  - "**/*.vue"
+  - "**/*.py"
+  - "**/nginx*.conf"
+---
+
 # 数据载荷三层长度限制规则
 
 防止大文本 DoS、内存耗尽、带宽滥用。所有涉及用户输入 / HTTP 请求体 / 文件上传的场景必须遵循三层限制,单层失守即高风险。

package/templates/claude-global/settings.json

@@ -6,27 +6,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash ~/.claude/hooks/pre-git-commit-sensitive-check.sh"
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Edit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash ~/.claude/hooks/post-sync-claude-global.sh"
-          }
-        ]
-      },
-      {
-        "matcher": "Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash ~/.claude/hooks/post-sync-claude-global.sh"
+            "command": "bash $CLAUDE_PROJECT_DIR/.claude/hooks/pre-git-commit-sensitive-check.sh"
           }
         ]
       }

package/templates/claude-global/skills/dwy-dolphindb/SKILL.md

@@ -0,0 +1,91 @@
+---
+name: dwy-dolphindb
+description: >
+  DolphinDB 开发规范与最佳实践审查。当用户要求生成、修改、审查或优化涉及
+  DolphinDB 的 Python/SQL 代码、脚本拼接、批量写入、查询优化、连接管理、分区
+  裁剪、数据类型转换、Docker 配置或测试 Mock 时，**必须**使用此 skill。即使
+  用户没有明确提到 "DolphinDB"，但只要代码中出现 dolphindb、run_ddb、
+  loadTable、append!、dropPartition、DBConnectionPool、DDBSession、tickDB、
+  factorDB 等关键字，或涉及 TSDB 分区、时间序列数据库存储、金融 tick 数据/因子
+  数据写入，也要触发此 skill。用于确保代码符合社区版 8GB 内存限制、2 节点集群
+  限制、分区裁剪、输入校验、批量写入 ≤500K 行等硬约束。
+---
+
+# DolphinDB 开发规范 Skill
+
+## 何时使用
+
+只要任务涉及以下任一内容，立即读取 `references/dolphindb-rules.md` 并按本 skill 执行审查：
+
+- 编写或修改调用 DolphinDB 的 Python 代码（`run_ddb`、`run_ddb_with_data`、`DDBSession`、`DBConnectionPool` 等）
+- 编写或修改 DolphinDB 脚本（`loadTable`、`append!`、`dropPartition`、`select` 等）
+- 批量写入 tick 数据或因子数据到 DolphinDB
+- 查询 DolphinDB 中的 tick/因子数据，尤其是 WHERE 条件设计
+- 数据类型转换（Feather/Pandas → DolphinDB）
+- Docker 中部署或配置 DolphinDB
+- 为 DolphinDB 相关代码编写测试 Mock
+- 代码审查（CR）时发现文件包含 DolphinDB 调用
+
+## 使用步骤
+
+### 1. 加载完整规则
+
+读取 `references/dolphindb-rules.md`。该文件包含全部 12 章规则，是审查的唯一权威来源。
+
+### 2. 识别代码中涉及的规则章节
+
+根据当前任务内容，判断主要涉及哪些章节：
+
+| 任务类型 | 重点章节 |
+|---|---|
+| 查询脚本编写 | 三（分区裁剪）、八（查询优化） |
+| 批量数据写入 | 二（连接管理）、四（批量写入）、十（数据类型映射） |
+| 脚本拼接/动态生成 | 五（脚本语法）、六（输入校验） |
+| 服务层 Python 代码 | 二（连接管理）、六（输入校验）、十（数据类型映射） |
+| Docker/部署配置 | 九（Docker 环境） |
+| 测试代码 | 十一（测试 Mock） |
+| 代码审查/CR | 全部，尤其是十二（检查清单） |
+
+### 3. 执行规则审查
+
+对生成的或已有的代码，逐条检查相关章节的**强制规则**和**违规检测**项。
+
+**审查输出格式：**
+
+对每处问题，使用以下格式报告：
+
+```
+⚠️ [规则章节] 具体问题
+   违规代码：<摘录>
+   修复建议：<具体修改后的代码>
+   原因：<引用规则中的说明>
+```
+
+对符合规则的代码，可以简要确认：
+
+```
+✅ [规则章节] 符合要求 — <简要说明>
+```
+
+### 4. 特别关注以下致命违规
+
+以下问题会直接导致生产故障或 OOM，必须零容忍：
+
+1. **分区列被函数包裹**（如 `date(trade_date)`）→ 全表扫描 → 8GB OOM
+2. **单次 append 超过 500K 行** → TSDB 报错 `exceeds max limit`
+3. **未校验的外部输入拼接到脚本** → 脚本注入风险
+4. **连接池做 upload + run** → 变量跨连接不可见
+5. **select *** → 传输全部 30+ 列，浪费带宽和内存
+6. **分页使用 `LIMIT x OFFSET y`** → DolphinDB 不支持 OFFSET 关键字
+7. **`asyncio.to_thread(pool.run, script)`** → SDK v3 的 `pool.run()` 已是原生 async，无需包装
+
+### 5. 检查清单应用
+
+如果任务是**代码审查**或**最终确认**，逐条过一遍 `references/dolphindb-rules.md` 第十二章的检查清单（12 项），并给出通过/不通过的明确结论。
+
+## 输出要求
+
+- 审查结果必须结构化，按规则章节分组
+- 对每一处违规，必须给出**可落地的修复代码**，不能只说"不符合规则"
+- 如果代码完全符合规则，明确声明"所有 DolphinDB 相关规则检查通过"
+- 如果任务只是生成代码，在生成过程中就内联应用规则，生成完毕后给出简要的合规确认

package/templates/claude-global/skills/dwy-dolphindb/evals/evals.json

@@ -0,0 +1,44 @@
+{
+  "skill_name": "dwy-dolphindb",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "帮我写一个 Python 函数，把一个大 pandas DataFrame（约 200 万行 tick 数据）写入 DolphinDB 的 tickDB snapshots 表。表的分区列是 trade_date 和 order_book_id。函数接收 filepath（feather 格式）和 trade_date 参数。",
+      "expected_output": "生成的代码必须使用 DDBSession 复用连接、分批次 ≤500K 行写入、每批后 del + gc.collect()、用 pyarrow 分片读取、外部输入经过校验、使用 run_ddb_with_data 或 session.upload_and_run。不能出现连接池 upload、单次 append 全部数据、pd.read_feather 全量加载。",
+      "files": [],
+      "assertions": [
+        "代码中包含 BATCH_SIZE 且值 ≤ 500000",
+        "代码中使用了 gc.collect()",
+        "代码中没有使用 pd.read_feather 一次性读取大文件",
+        "代码中使用了 DDBSession 或 run_ddb_with_data 而非连接池做 upload",
+        "代码中包含对外部输入（如 trade_date、filepath）的校验逻辑"
+      ]
+    },
+    {
+      "id": 2,
+      "prompt": "写一个 FastAPI 端点 /api/tick/query，接收 stock_code、start_date、end_date 参数，从 DolphinDB tickDB snapshots 表查询数据并返回。请直接写实现代码。",
+      "expected_output": "生成的代码必须对输入参数校验、WHERE 条件直接命中分区列（trade_date 和 order_book_id）而不使用函数包裹、只 select 需要的列、使用 DolphinDB 分页语法 limit offset, count（而非 LIMIT OFFSET）、使用 PIVOT BY 或合并聚合查询减少往返。",
+      "files": [],
+      "assertions": [
+        "WHERE 子句中没有 date()、month()、year() 等函数包裹分区列",
+        "查询中没有 select *",
+        "分页语法是 limit {offset}, {page_size} 而不是 limit {page_size} offset {offset}",
+        "代码中包含输入校验（validate_stock_code 或类似逻辑）",
+        "没有使用 asyncio.to_thread(pool.run)"
+      ]
+    },
+    {
+      "id": 3,
+      "prompt": "审查以下代码是否符合 DolphinDB 开发规范，指出所有问题并给出修复后的代码：\n```python\nasync def import_tick_data(filepath: str, trade_date: str):\n    df = pd.read_feather(filepath)\n    script = f'append!{loadTable(\"dfs://tickDB\", \"snapshots\"), data}'\n    await run_ddb(f'upload data = {df}')\n    await run_ddb(script)\n    return {\"status\": \"ok\"}\n\nasync def query_ticks(stock_code: str, start: str, end: str):\n    script = (\n        f'select * from loadTable(\"dfs://tickDB\", \"snapshots\") '\n        f'where date(trade_date) >= {start} and date(trade_date) <= {end} '\n        f'and order_book_id = \"{stock_code}\" '\n        f'limit 100 offset 0'\n    )\n    return await run_ddb(script)\n```",
+      "expected_output": "审查报告必须指出：1) pd.read_feather 全量加载问题；2) 连接池 upload + run 导致变量跨连接不可见；3) 未校验 filepath、trade_date、stock_code；4) date(trade_date) 函数包裹分区列导致全表扫描；5) select *；6) limit 100 offset 0 语法错误；7) 缺少 BATCH_SIZE 和 gc.collect()。每项必须给出修复代码。",
+      "files": [],
+      "assertions": [
+        "输出中明确指出了 date(trade_date) 或分区列被函数包裹的问题",
+        "输出中明确指出了 select * 的问题",
+        "输出中明确指出了 limit 100 offset 0 语法错误",
+        "输出中明确指出了连接池 upload + run 的问题",
+        "输出中为每个问题都提供了修复后的代码片段"
+      ]
+    }
+  ]
+}

package/templates/claude-global/skills/dwy-dolphindb/references/dolphindb-rules.md

@@ -0,0 +1,342 @@
+# DolphinDB 开发规则
+
+所有涉及 DolphinDB 的代码必须遵循以下规则。AI 生成或修改代码时，必须逐条检查。
+
+## 一、社区版硬约束
+
+| 约束 | 值 | 违反后果 |
+|---|---|---|
+| 最大内存 | 8GB（建议 `maxMemSize=5`，留 3GB 给 OS） | 进程 OOM 崩溃 |
+| 最大集群节点数 | 2（允许 1 controller + 1 datanode 的最小集群） | 超出被许可证拒绝;无法扩展到 3 节点以上 |
+| 最大并发客户端连接 | 512（`maxConnections=512`） | 新连接直接被拒 |
+| TSDB 单次 append | ≤ 204MB（约 800K 行 × 30 列） | 报错 `exceeds max limit` |
+| 高可用 / Raft / 异步复制 | 不支持 | 多副本能力需企业版 |
+
+### 本项目部署侧配置（非社区版硬限，是 VM/机器约束）
+
+- VM 规格：**2 核 8 GB**（与社区版 8 GB 内存硬限一致）
+- 因 CPU 只有 2 核，`workerNum` 和客户端 `dolphindb_pool_size` 按经验值 `2`，避免大量并行争抢 CPU；**这不是社区版硬限，而是 2 核机器上的合理取值**
+- 512 并发连接是协议层上限，实际可持有的连接远少于这个数，不要把它当作"应该开 512 条"的指令
+
+### 违规检测
+如果代码中出现以下情况，必须提示：
+- 单次 `append!` 数据超过 500K 行（安全上限）
+- `maxMemSize` > 8
+- 集群配置超过 2 个节点
+- 客户端 `dolphindb_pool_size` 显著高于 CPU 核数（在 2 核机器上 > 4 需说明理由）
+
+## 二、连接与会话管理
+
+### 强制规则
+
+| 场景 | 使用方式 | 原因 |
+|---|---|---|
+| 只读查询 | `run_ddb(script)` — 连接池 | 池自动管理连接复用 |
+| 单次 upload + run | `run_ddb_with_data(script, data)` — 独立 Session | 确保 upload 和 run 在同一连接 |
+| 批量 upload（多次循环） | `DDBSession` — 复用 Session | 避免每批新建/关闭连接的开销 |
+
+```python
+# ❌ 用连接池做 upload + run（变量跨连接不可见）
+await run_ddb("upload_var = ...")  # 连接 A
+await run_ddb("select * from upload_var")  # 可能路由到连接 B → 变量不存在
+
+# ✅ 独立 Session 保证同一连接
+await run_ddb_with_data(script, {"batch_data": df})
+
+# ✅ 批量操作复用 Session
+session = DDBSession()
+try:
+    for batch in batches:
+        await session.upload_and_run(script, {"batch_data": batch})
+finally:
+    session.close()
+```
+
+### SDK v3 异步 API
+- `DBConnectionPool.run()` 在 SDK v3 中是 **原生 async**，直接 `await pool.run(script)`
+- **禁止** `asyncio.to_thread(pool.run, script)`（会产生 "coroutine never awaited" 警告）
+- `Session.run()` 仍然是 **同步**，需要 `asyncio.to_thread()` 包装
+
+## 三、分区裁剪（性能关键）
+
+### 强制规则
+**WHERE 条件必须直接命中分区列，禁止对分区列使用函数。**
+
+```python
+# ❌ 函数包裹分区列 → 全表扫描 → 8GB OOM
+WHERE date(datetime) = 2020.01.01
+WHERE month(trade_date) = 2020.01M
+WHERE string(order_book_id) = "000001.XSHE"
+
+# ✅ 直接范围过滤 → 分区裁剪生效
+WHERE trade_date = 2020.01.01
+WHERE trade_date >= 2020.01.01, trade_date < 2020.02.01
+WHERE order_book_id in [`000001.XSHE`000002.XSHE]
+```
+
+### tickDB 分区列
+- 第一级：`trade_date`（VALUE 分区，按日）
+- 第二级：`order_book_id`（HASH 分区，20 桶）
+
+### factorDB 分区列
+- 第一级：`trade_date`（VALUE 分区，按月）
+- 第二级：`factor_name`（VALUE 分区）
+
+### 违规检测
+如果 DolphinDB 查询脚本中出现以下模式，必须提示：
+- `date(...)` / `month(...)` / `year(...)` 包裹分区列
+- `WHERE 1=1` 无分区条件（全表扫描）
+- `select * from loadTable(...)` 无 WHERE 子句
+
+## 四、批量写入
+
+### 强制规则
+
+```python
+BATCH_SIZE = 500_000  # TSDB 上限 204MB，500K 行 ≈ 120MB（安全余量）
+```
+
+| 规则 | 说明 |
+|---|---|
+| 每批 ≤ 500K 行 | TSDB 单次 append 内存上限 204MB |
+| 每批后 `gc.collect()` | 释放 Python 侧内存 |
+| 每批后 `del batch_df` | 显式释放 DataFrame 引用 |
+| 大文件用 pyarrow 分片读取 | `pf.read_table()` + `table.slice()` 避免全量加载 |
+| 复用 Session | 批量循环中不要每批新建连接 |
+
+```python
+# ✅ 标准批量上传模式
+table = pf.read_table(filepath)  # memory-mapped，不全量加载
+session = DDBSession()
+try:
+    for i in range(num_batches):
+        arrow_slice = table.slice(i * BATCH_SIZE, BATCH_SIZE)
+        batch_df = prepare_batch(arrow_slice.to_pandas())
+        del arrow_slice
+        await session.upload_and_run(script, {"batch_data": batch_df})
+        del batch_df
+        gc.collect()
+finally:
+    session.close()
+```
+
+### 禁止的写法
+```python
+# ❌ 一次性读取大文件到 pandas（OOM）
+df = pd.read_feather("10M_rows.ftr")  # 2.6GB 内存
+
+# ❌ 单次 append 超过 500K 行
+await run_ddb_with_data(script, {"data": df_1million_rows})
+
+# ❌ 不释放内存
+for batch in batches:
+    await session.upload_and_run(script, {"data": batch})
+    # 忘记 del + gc.collect()
+```
+
+## 五、DolphinDB 脚本语法
+
+### 列名定义必须单行
+```python
+# ❌ 多行 backtick 列名 → 语法错误
+schema = table(1:0,
+    `col1`col2
+    `col3`col4,
+    [INT, INT, INT, INT])
+
+# ✅ 单行定义
+colNames = `col1`col2`col3`col4
+colTypes = [INT, INT, INT, INT]
+schema = table(1:0, colNames, colTypes)
+```
+
+### 多值过滤的 backtick 拼接
+```python
+# ✅ 正确的 Symbol 列表拼接
+symbols = ["000001.XSHE", "000002.XSHE"]
+symbols_str = "`" + "`".join(symbols)
+script = f"... order_book_id in [{symbols_str}]"
+# 生成: order_book_id in [`000001.XSHE`000002.XSHE]
+```
+
+### 脚本拼接用分号 + 换行
+```python
+# ✅ 多语句用 ;\n 分隔
+script = (
+    f'tickData = select * from loadTable("dfs://tickDB","snapshots") '
+    f'where {ts_filter};\n'
+    f'{user_script};\n'
+    f'exec count(*) from result'
+)
+```
+
+## 六、输入校验（安全关键）
+
+### 强制规则
+**所有外部输入在拼接到 DolphinDB 脚本前，必须经过 `validators.py` 校验。**
+
+| 类型 | 正则 | 示例 |
+|---|---|---|
+| 因子名 | `^[a-zA-Z0-9_]{1,50}$` | `alpha_vwap_001` |
+| 股票代码 (ukey) | `^\d{6}\.[A-Z]{2}$` | `000001.SZ` |
+| 日期 | `^\d{4}\.\d{2}\.\d{2}$` | `2024.01.02` |
+
+```python
+# ✅ 先校验再拼接
+validate_factor_name(factor_name)  # 不通过则抛 BusinessError
+script = f'... factor_name = "{factor_name}"'
+
+# ❌ 未校验直接拼接 → 脚本注入风险
+script = f'... factor_name = "{user_input}"'
+```
+
+### 违规检测
+如果代码中出现以下情况，必须提示：
+- f-string 拼接 DolphinDB 脚本时使用了未经 `validate_*` 校验的变量
+- 用户输入直接出现在 `run_ddb()` 的 script 参数中
+
+## 七、分区操作
+
+### 删除分区用 `dropPartition`，不用 `DELETE`
+```python
+# ✅ dropPartition — 原子操作，无 tombstone
+dropPartition(db, partitionPath, tableName)
+
+# ❌ DELETE — 标记删除，产生 tombstone，需后续 GC
+delete from loadTable("dfs://tickDB", "snapshots") where trade_date = 2020.01.01
+```
+
+### 新增分区值
+配置 `newValuePartitionPolicy=add`，VALUE 分区自动扩展，无需预创建。
+
+## 八、查询优化
+
+### 聚合查询合并
+```python
+# ❌ 3 次查询
+min_date = await run_ddb("select min(trade_date) ...")
+max_date = await run_ddb("select max(trade_date) ...")
+count = await run_ddb("select count(*) ...")
+
+# ✅ 1 次查询
+result = await run_ddb(
+    'select min(trade_date) as earliest, max(trade_date) as latest, count(*) as total '
+    'from loadTable("dfs://tickDB","snapshots")'
+)
+```
+
+### 多因子查询用 PIVOT BY
+```python
+# ✅ DolphinDB 服务端完成列转换，无需 Python 端 merge
+script = (
+    'select value from loadTable("dfs://factorDB","factors") '
+    f'where {where_clause} '
+    'pivot by trade_date, ukey, factor_name'
+)
+```
+
+### 分页查询用 `limit offset, count`
+```python
+# ❌ SQL 标准语法 — DolphinDB 不支持 OFFSET 关键字
+f"select * from loadTable(...) limit {page_size} offset {offset}"
+
+# ✅ DolphinDB 分页语法：limit 跳过行数, 返回行数
+offset = (page - 1) * page_size
+f"select * from loadTable(...) limit {offset}, {page_size}"
+```
+
+### 只查需要的列
+```python
+# ❌ select *（传输全部 30 列）
+"select * from loadTable(...)"
+
+# ✅ 只取需要的列
+"select trade_date, time, order_book_id, last, volume from loadTable(...)"
+```
+
+## 九、Docker 环境注意事项
+
+### DolphinDB v3 Alpine 镜像
+| 问题 | 解决方案 |
+|---|---|
+| 无 `curl` | 用 `wget` 替代 |
+| `localhost` 解析到 IPv6 | healthcheck 用 `127.0.0.1` |
+| macOS 无 `/etc/hostname` `/etc/machine-id` | 不要挂载这两个文件 |
+| 自定义 cfg 中 `logFile`/`volumes` 路径与 Docker volume 冲突 | 只覆盖必要参数，其余用默认值 |
+| `dataSync + CacheEngine` 必须同时启用 | 开发环境建议都不配置，用默认值 |
+
+### healthcheck 配置
+```yaml
+healthcheck:
+  test: ["CMD-SHELL", "wget -qO- --timeout=3 http://127.0.0.1:8848/ || exit 1"]
+  start_period: 30s  # DolphinDB 启动较慢，给足初始化时间
+  interval: 5s
+  timeout: 5s
+  retries: 10
+```
+
+### 后端连接配置
+```
+DOLPHINDB_HOST=dolphindb    # Docker 服务名（不是 localhost）
+DOLPHINDB_PORT=8848
+DOLPHINDB_POOL_SIZE=2       # 2 核机器的经验值;社区版协议上限是 512 并发,不是 2
+```
+
+## 十、数据类型映射
+
+### Feather/Pandas → DolphinDB
+
+| Python/Pandas 类型 | DolphinDB 类型 | 转换方式 |
+|---|---|---|
+| `uint32` (日期如 20191205) | `DATE` | `pd.to_datetime(str, format='%Y%m%d')` |
+| `uint32` (时间如 91509000) | `INT` | `.astype('int64')` |
+| `float64` | `DOUBLE` | 无需转换 |
+| `uint64` | `LONG` | `.astype('int64')` |
+| `uint32` | `INT` | `.astype('int64')` |
+| `float64` 含 NaN → 整数 | `INT` | `.fillna(0).astype('int64')` |
+| `object` (字符串) | `SYMBOL` | `.astype(str)` |
+
+### 注意事项
+- DolphinDB 不接受 `uint` 类型，必须先转 `int64`
+- NaN 不能直接转整数，必须先 `fillna(0)`
+- `SYMBOL` 类型是 DolphinDB 的字典编码字符串，适用于低基数列（如股票代码）
+
+## 十一、测试 Mock 规范
+
+### DolphinDB 测试不连真实服务
+```python
+# conftest.py 中使用 autouse fixture mock 所有 DolphinDB 调用
+@pytest.fixture(autouse=True)
+def mock_dolphindb():
+    async def mock_run_ddb(script):
+        if "snapshots" in script and "count" in script.lower():
+            return pd.DataFrame({"count": [1000]})
+        # ... 基于脚本内容的模式匹配
+        return pd.DataFrame()
+
+    with patch("app.services.tick_service.run_ddb", side_effect=mock_run_ddb):
+        yield
+```
+
+### Mock 必须覆盖所有 import 路径
+```python
+# 每个 service 文件都有独立的 import，必须分别 patch
+patch("app.services.tick_service.run_ddb", ...)
+patch("app.services.tick_archive.run_ddb", ...)
+patch("app.services.tick_compute.run_ddb", ...)
+```
+
+## 十二、检查清单
+
+每次涉及 DolphinDB 的代码变更，必须逐条检查：
+
+- [ ] WHERE 条件是否命中分区列？是否有函数包裹分区列？
+- [ ] 批量写入是否 ≤ 500K 行？是否有 `gc.collect()`？
+- [ ] 外部输入是否经过 `validators.py` 校验？
+- [ ] 使用 `run_ddb` 还是 `run_ddb_with_data`？场景是否匹配？
+- [ ] 连接池大小是否与 CPU 核数匹配（2 核机器建议 `pool_size=2`）？
+- [ ] 查询是否只 select 了需要的列？
+- [ ] 多次聚合查询能否合并为一次？
+- [ ] 脚本中 backtick 列名是否在单行内？
+- [ ] 新增 service 文件的 `run_ddb` 导入是否在 conftest.py 中 mock？
+- [ ] 分页查询是否使用 `limit offset, count` 语法？（禁止 `LIMIT x OFFSET y`）

package/templates/claude-global/skills/dwy-eui/SKILL.md

@@ -18,129 +18,6 @@ description: "@dwydev/eui Vue 3 组件库速查。当用户在使用 Vue 3 构
 
 ---
 
-## 安装与引入
-
-```bash
-pnpm add @dwydev/eui
-```
-
-```ts
-// 按需导入（推荐）
-import { EButton, EInput, ETable } from '@dwydev/eui'
-
-// 全局注册（Vue plugin）
-import EUI from '@dwydev/eui'
-app.use(EUI)
-```
-
-```ts
-// 主题 CSS（必须引入）
-import '@dwydev/eui/theme'          // 基础样式 + tokens
-import '@dwydev/eui/theme/dark'     // 暗色模式（可选）
-import '@dwydev/eui/theme/tokens'   // 仅 design tokens（可选）
-```
-
-### 全局配置 EConfigProvider（必须）
-
-**EConfigProvider 是使用 EUI 的前置条件。** 必须在 App 根组件用 `<EConfigProvider>` 包裹整个应用，否则以下功能不生效：
-
-- 国际化（日期选择器、月份/年份选择器等显示为英文而非中文）
-- 全局组件尺寸统一控制
-- 弹层 z-index 统一管理
-- 组件内部 UI 文案（确定/取消/暂无数据等）
-
-#### 基础用法
-
-```vue
-<!-- App.vue -->
-<script setup lang="ts">
-import { EConfigProvider } from '@dwydev/eui'
-</script>
-
-<template>
-  <EConfigProvider>
-    <RouterView />
-  </EConfigProvider>
-</template>
-```
-
-使用默认配置即可满足中文项目需求，无需传任何 props。
-
-#### Props
-
-| Prop | 类型 | 默认值 | 说明 |
-|------|------|--------|------|
-| size | `'sm' \| 'default' \| 'lg'` | `'default'` | 所有组件的全局尺寸 |
-| zIndex | `number` | `2000` | 弹层组件（Dialog/Drawer/Popover 等）的基准 z-index |
-| locale | `Record<string, string>` | 见下方 | 国际化配置 |
-
-#### locale 配置
-
-locale 是一个扁平的键值对象，包含两部分内容：
-
-| 字段 | 默认值 | 说明 |
-|------|--------|------|
-| name | `'zh-CN'` | **BCP 47 语言标签**，控制日期选择器（EDatePicker）、日历（ECalendar）等组件的本地化显示（月份名、星期名、年份格式等） |
-| confirm | `'确定'` | 确认按钮文案 |
-| cancel | `'取消'` | 取消按钮文案 |
-| close | `'关闭'` | 关闭按钮文案 |
-| loading | `'加载中...'` | 加载状态文案 |
-| empty | `'暂无数据'` | 空状态文案 |
-| search | `'搜索'` | 搜索占位文案 |
-| selectPlaceholder | `'请选择'` | 选择器默认占位文案 |
-| inputPlaceholder | `'请输入'` | 输入框默认占位文案 |
-
-#### 自定义配置示例
-
-```vue
-<!-- 英文项目 -->
-<EConfigProvider
-  size="sm"
-  :z-index="3000"
-  :locale="{
-    name: 'en-US',
-    confirm: 'OK',
-    cancel: 'Cancel',
-    close: 'Close',
-    loading: 'Loading...',
-    empty: 'No data',
-    search: 'Search',
-    selectPlaceholder: 'Please select',
-    inputPlaceholder: 'Please input',
-  }"
->
-  <RouterView />
-</EConfigProvider>
-```
-
-#### 嵌套覆盖
-
-EConfigProvider 支持嵌套，内层配置覆盖外层。适用于局部区域需要不同配置的场景：
-
-```vue
-<EConfigProvider>                                          <!-- 全局中文 -->
-  <EConfigProvider :locale="{ name: 'en-US', ... }">      <!-- 局部英文 -->
-    <EDatePicker type="month" />                           <!-- 显示英文月份 -->
-  </EConfigProvider>
-</EConfigProvider>
-```
-
-#### 实现原理
-
-EConfigProvider 内部做了两件事：
-1. 通过 Vue `provide/inject` 向子树注入 size、zIndex、locale 配置，EUI 组件通过 `useConfigProvider()` 读取
-2. 包裹 reka-ui 的 `ConfigProvider`，将 `locale.name` 透传为 reka-ui 的全局 locale，所有基于 reka-ui 的日期类组件自动继承
-
-#### 不使用 EConfigProvider 的后果
-
-| 功能 | 不包裹时的表现 |
-|------|--------------|
-| EDatePicker 月份/星期 | 显示英文（Jan、Feb、Mon、Tue） |
-| ECalendar 月份/星期 | 显示英文 |
-| 组件尺寸 | 各组件使用各自默认值，无法统一控制 |
-| 弹层 z-index | 各组件使用各自默认值，可能层级混乱 |
-| UI 文案 | useConfigProvider() 使用内部默认值（中文），但不保证一致性 |
-
 ## 命名约定
 
 - 组件前缀 `E`：`EButton`, `EInput`, `EDialog`