create-dwy 0.12.0 → 0.12.2

package/templates/claude-global/skills//345/256/211/345/205/250/dwy-sdk-spec/scripts/check_python_publish.sh

@@ -0,0 +1,171 @@
+#!/usr/bin/env bash
+# Python SDK 发布前文件清单审计（不实际发布）
+# 用法: check_python_publish.sh <python_sdk_root> --edition commercial|opensource
+
+set -euo pipefail
+
+if [[ $# -lt 3 ]]; then
+  echo "Usage: $0 <python_sdk_root> --edition commercial|opensource" >&2
+  exit 2
+fi
+
+PKG_ROOT="$1"
+shift
+
+EDITION=""
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --edition) EDITION="$2"; shift 2 ;;
+    *) echo "ERROR: unknown arg: $1" >&2; exit 2 ;;
+  esac
+done
+
+if [[ "$EDITION" != "commercial" && "$EDITION" != "opensource" ]]; then
+  echo "ERROR: --edition must be 'commercial' or 'opensource'" >&2
+  exit 2
+fi
+
+if [[ ! -d "$PKG_ROOT" ]]; then
+  echo "ERROR: not a directory: $PKG_ROOT" >&2
+  exit 2
+fi
+
+if ! command -v python >/dev/null 2>&1 && ! command -v python3 >/dev/null 2>&1; then
+  echo "ERROR: python not found in PATH" >&2
+  exit 2
+fi
+PY=$(command -v python || command -v python3)
+
+# 临时构建目录
+TMPDIR=$(mktemp -d -t dwy-sdk-spec-py-XXXX)
+trap 'rm -rf "$TMPDIR"' EXIT
+
+echo "[1/3] Building wheel to $TMPDIR ..."
+(cd "$PKG_ROOT" && "$PY" -m build --outdir "$TMPDIR") >&2
+
+WHEEL=$(find "$TMPDIR" -name '*.whl' -type f | head -1)
+if [[ -z "$WHEEL" ]]; then
+  echo "ERROR: no wheel produced" >&2
+  exit 2
+fi
+echo "[2/3] Listing wheel contents: $(basename "$WHEEL")"
+
+# 列文件（剥掉 .dist-info 路径前缀，便于审计）
+FILES=$(unzip -Z1 "$WHEEL")
+
+# 致命级（任何版本都禁）
+declare -a CRITICAL_PATTERNS=(
+  '(^|/)\.env(\..+)?$'
+  '(^|/)\.npmrc$'
+  '(^|/)\.pypirc$'
+  '(^|/)\.git-credentials$'
+  '(^|/)id_rsa$'
+  '(^|/)id_ed25519$'
+  '\.pem$'
+  '\.key$'
+  '\.p12$'
+  '(^|/)secrets\.json$'
+  '(^|/)credentials\.json$'
+)
+
+# 开源版黑名单
+declare -a OPENSOURCE_DENY=(
+  '__pycache__/'
+  '\.pyc$'
+  '\.pyo$'
+  '\.egg-info/'
+  '\.mypy_cache/'
+  '\.pytest_cache/'
+  '\.ruff_cache/'
+  '\.pdb$'
+  '(^|/)\.git/'
+  '(^|/)\.gitignore$'
+  '(^|/)\.DS_Store$'
+  '(^|/)\.vscode/'
+  '(^|/)\.idea/'
+  '\.bak$'
+  '\.swp$'
+)
+
+# 商业版白名单（其他视为违规）
+declare -a COMMERCIAL_ALLOW=(
+  '\.so$'
+  '\.pyi$'
+  '(^|/)py\.typed$'
+  '\.dist-info/'
+  '(^|/)LICEN[SC]E(\..+)?$'
+  '(^|/)README(\..+)?$'
+  '\.json$'
+  '\.txt$'
+)
+
+violations=()
+critical=()
+
+while IFS= read -r f; do
+  [[ -z "$f" ]] && continue
+
+  # 致命级
+  for pat in "${CRITICAL_PATTERNS[@]}"; do
+    if [[ "$f" =~ $pat ]]; then
+      critical+=("$f")
+      continue 2
+    fi
+  done
+
+  if [[ "$EDITION" == "opensource" ]]; then
+    for pat in "${OPENSOURCE_DENY[@]}"; do
+      if [[ "$f" =~ $pat ]]; then
+        violations+=("$f  [denied: $pat]")
+        break
+      fi
+    done
+  else
+    # commercial: 白名单检查
+    # 排除目录条目（以 / 结尾）
+    [[ "$f" == */ ]] && continue
+    matched=0
+    for pat in "${COMMERCIAL_ALLOW[@]}"; do
+      if [[ "$f" =~ $pat ]]; then
+        matched=1
+        break
+      fi
+    done
+    # 单独允许：包根的 __init__.py（公开入口）/ 不以 _ 开头的 .py
+    if [[ $matched -eq 0 ]] && [[ "$f" =~ \.py$ ]]; then
+      base=$(basename "$f")
+      if [[ "$base" == "__init__.py" ]] || [[ ! "$base" =~ ^_ ]]; then
+        matched=1
+      fi
+    fi
+    if [[ $matched -eq 0 ]]; then
+      violations+=("$f  [not in commercial whitelist]")
+    fi
+  fi
+done <<< "$FILES"
+
+echo "[3/3] Audit result (edition=$EDITION):"
+echo "----------------------------------------"
+
+if [[ ${#critical[@]} -gt 0 ]]; then
+  echo "[CRITICAL] secret-like files in wheel — DO NOT PUBLISH:"
+  for f in "${critical[@]}"; do
+    echo "  $f"
+  done
+  echo ""
+fi
+
+if [[ ${#violations[@]} -gt 0 ]]; then
+  echo "[VIOLATION] ${#violations[@]} file(s) violate $EDITION rules:"
+  for v in "${violations[@]}"; do
+    echo "  $v"
+  done
+  echo ""
+  exit 1
+fi
+
+if [[ ${#critical[@]} -gt 0 ]]; then
+  exit 1
+fi
+
+echo "OK: wheel passes $EDITION audit ($(echo "$FILES" | wc -l | tr -d ' ') file(s))"

package/templates/claude-global/skills//345/256/211/345/205/250/dwy-sdk-spec/scripts/detect_sdk.sh

@@ -0,0 +1,71 @@
+#!/usr/bin/env bash
+# 探测项目内的 Python / JS SDK 子包
+# 用法: detect_sdk.sh <project_root>
+# 输出: JSON {"python": [...], "js": [...]}  路径相对项目根
+
+set -euo pipefail
+
+PROJECT_ROOT="${1:-$(pwd)}"
+
+if [[ ! -d "$PROJECT_ROOT" ]]; then
+  echo "ERROR: not a directory: $PROJECT_ROOT" >&2
+  exit 2
+fi
+
+# 找 Python SDK：pyproject.toml 含 [project] 段，或 setup.py
+find_python_sdks() {
+  local results=()
+  # 项目根
+  if [[ -f "$PROJECT_ROOT/pyproject.toml" ]] && grep -q '^\[project\]' "$PROJECT_ROOT/pyproject.toml" 2>/dev/null; then
+    results+=(".")
+  elif [[ -f "$PROJECT_ROOT/setup.py" ]]; then
+    results+=(".")
+  fi
+  # 子目录（限 2 层深度，排除 node_modules / .venv / venv / dist / build / .git）
+  while IFS= read -r f; do
+    local d
+    d=$(dirname "$f")
+    local rel="${d#"$PROJECT_ROOT"/}"
+    # 验证含 [project] 段
+    if grep -q '^\[project\]' "$f" 2>/dev/null; then
+      results+=("$rel")
+    fi
+  done < <(find "$PROJECT_ROOT" -mindepth 2 -maxdepth 3 -name pyproject.toml -type f \
+           -not -path "*/node_modules/*" \
+           -not -path "*/.venv/*" \
+           -not -path "*/venv/*" \
+           -not -path "*/dist/*" \
+           -not -path "*/build/*" \
+           -not -path "*/.git/*" 2>/dev/null)
+
+  # 去重
+  printf '%s\n' "${results[@]}" | awk 'NF && !seen[$0]++'
+}
+
+# 找 JS SDK：package.json 含 main / exports / module 字段
+find_js_sdks() {
+  local results=()
+  if [[ -f "$PROJECT_ROOT/package.json" ]] && jq -e '.main // .exports // .module' "$PROJECT_ROOT/package.json" >/dev/null 2>&1; then
+    results+=(".")
+  fi
+  while IFS= read -r f; do
+    local d
+    d=$(dirname "$f")
+    local rel="${d#"$PROJECT_ROOT"/}"
+    if jq -e '.main // .exports // .module' "$f" >/dev/null 2>&1; then
+      results+=("$rel")
+    fi
+  done < <(find "$PROJECT_ROOT" -mindepth 2 -maxdepth 3 -name package.json -type f \
+           -not -path "*/node_modules/*" \
+           -not -path "*/.venv/*" \
+           -not -path "*/dist/*" \
+           -not -path "*/build/*" \
+           -not -path "*/.git/*" 2>/dev/null)
+
+  printf '%s\n' "${results[@]}" | awk 'NF && !seen[$0]++'
+}
+
+python_list=$(find_python_sdks | jq -R . | jq -s .)
+js_list=$(find_js_sdks | jq -R . | jq -s .)
+
+jq -n --argjson py "$python_list" --argjson js "$js_list" '{python: $py, js: $js}'

package/templates/claude-global/skills//345/256/211/345/205/250/dwy-sdk-spec/scripts/init_config.sh

@@ -0,0 +1,97 @@
+#!/usr/bin/env bash
+# dwy-sdk-spec 配置缓存读写
+# 用法:
+#   init_config.sh get <project_path>
+#   init_config.sh set <project_path> <edition> <languages_json> <sdk_paths_json>
+#   init_config.sh reset <project_path>
+#   init_config.sh list
+
+set -euo pipefail
+
+CONFIG_DIR="${HOME}/.config/dwy-sdk-spec"
+CONFIG_FILE="${CONFIG_DIR}/projects.json"
+
+ensure_config() {
+  mkdir -p "$CONFIG_DIR"
+  if [[ ! -f "$CONFIG_FILE" ]]; then
+    echo '{"version":"1","projects":{}}' > "$CONFIG_FILE"
+  fi
+  # 检测损坏
+  if ! jq empty "$CONFIG_FILE" 2>/dev/null; then
+    echo "ERROR: $CONFIG_FILE is corrupted. Back it up and delete to reset." >&2
+    exit 2
+  fi
+}
+
+cmd_get() {
+  local project_path="$1"
+  ensure_config
+  jq --arg p "$project_path" '.projects[$p] // null' "$CONFIG_FILE"
+}
+
+cmd_set() {
+  local project_path="$1"
+  local edition="$2"
+  local languages_json="$3"
+  local sdk_paths_json="$4"
+
+  if [[ "$edition" != "commercial" && "$edition" != "opensource" ]]; then
+    echo "ERROR: edition must be 'commercial' or 'opensource', got: $edition" >&2
+    exit 2
+  fi
+
+  ensure_config
+  local now
+  now=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+
+  local tmp
+  tmp=$(mktemp)
+  jq \
+    --arg p "$project_path" \
+    --arg e "$edition" \
+    --argjson l "$languages_json" \
+    --argjson s "$sdk_paths_json" \
+    --arg t "$now" \
+    '.projects[$p] = {edition: $e, languages: $l, sdk_paths: $s, configured_at: $t}' \
+    "$CONFIG_FILE" > "$tmp"
+  mv "$tmp" "$CONFIG_FILE"
+
+  echo "OK: cached $project_path -> $edition"
+}
+
+cmd_reset() {
+  local project_path="$1"
+  ensure_config
+  local tmp
+  tmp=$(mktemp)
+  jq --arg p "$project_path" 'del(.projects[$p])' "$CONFIG_FILE" > "$tmp"
+  mv "$tmp" "$CONFIG_FILE"
+  echo "OK: removed $project_path from cache"
+}
+
+cmd_list() {
+  ensure_config
+  jq '.projects | to_entries | map({path: .key, edition: .value.edition, languages: .value.languages})' "$CONFIG_FILE"
+}
+
+main() {
+  if [[ $# -lt 1 ]]; then
+    echo "Usage: $0 {get|set|reset|list} [args...]" >&2
+    exit 2
+  fi
+  local action="$1"
+  shift
+
+  case "$action" in
+    get)   cmd_get "$@" ;;
+    set)   cmd_set "$@" ;;
+    reset) cmd_reset "$@" ;;
+    list)  cmd_list ;;
+    *)
+      echo "ERROR: unknown action: $action" >&2
+      exit 2
+      ;;
+  esac
+}
+
+main "$@"

package/templates/claude-global/skills//345/274/200/345/217/221/346/265/201/347/250/213/dwy-code-flow-docs/SKILL.md

@@ -0,0 +1,170 @@
+---
+name: dwy-code-flow-docs
+description: 代码逻辑梳理文档。把指定的代码流程整理成非 IT 人员能看懂的 Markdown 文档(Mermaid 流程图 + 概述 + 关键配置 + 依赖关系)。触发场景:用户说"梳理 XX 逻辑"/"整理 XX 流程"/"帮我梳理一下 XXX"(创建)、"更新 XX 逻辑"/"刷新 XX 文档"(更新)、"现在梳理了哪些逻辑"/"列出已梳理的流程"(查询)、"强制重新梳理 XX"/"重扫 XX"(重扫)。文档存在用户指定根目录,扁平结构+中文文件名,YAML frontmatter 记录 sources + git commit,更新时先用 git diff 判断有无变化,无变化跳过、有变化只读 diff,大幅节省 token。
+---
+
+# dwy-code-flow-docs
+
+把代码流程梳理成非 IT 人员能看懂的 Markdown 文档。Claude 主动读代码,套统一模板,放在用户指定根目录。
+
+---
+
+## 何时触发
+
+| 用户原话样例 | 操作类型 |
+|---|---|
+| 梳理 XX 逻辑 / 整理 XX 流程 / 帮我梳理一下 XXX | **创建** |
+| 更新 XX 逻辑 / 刷新 XX 文档 / 重新梳理 XX(无"强制") | **更新** |
+| 现在梳理了哪些逻辑 / 列出已梳理的流程 / 已经梳理过哪些 | **查询** |
+| 强制重新梳理 XX / 重扫 XX / rescan XX | **重扫** |
+
+---
+
+## 根目录配置
+
+每个项目第一次使用时,先确认存储根目录。
+
+### 读取顺序
+1. 读项目根 `.claude/code-flow-docs.config`,格式 `root=<绝对路径>`
+2. 文件不存在 → 问用户:"代码逻辑文档存到哪里?给我一个绝对路径"
+3. 拿到路径后:
+   - 检查路径父目录存在;不存在则提示用户先创建
+   - 写入 `.claude/code-flow-docs.config`,内容仅一行 `root=<绝对路径>`
+   - 在该路径下创建 `INDEX.md`(若不存在)
+
+### 配置文件示例
+```
+root=/Users/chances/WebstormProjects/ai-quant/docs/code-flows
+```
+
+---
+
+## 操作:创建新文档
+
+1. 从用户原话提取**逻辑名称**(如"配额计算"、"因子流式查询")
+2. 目标路径 = `<root>/<逻辑名称>.md`
+3. 文件已存在 → 提示"该逻辑已梳理过,是否要更新?",改走**更新**流程
+4. 文件不存在 → 进入读代码阶段:
+   - 用 Grep 工具按关键词扫描(中英混合,如 `quota|配额|billing|deduct`)
+   - 读相关文件,弄清楚流程
+   - 按 `templates/logic-doc.md` 套模板生成文档
+   - 写质量参照 `examples/配额计算.md`
+5. **写 YAML frontmatter(必填,不可省略)**:
+   - `title`: 逻辑名称
+   - `updated`: 今天日期 (YYYY-MM-DD)
+   - `last_commit`: `git rev-parse HEAD` 的完整 hash
+   - `sources`: 实际读过的文件**相对项目根**的路径列表
+   - `scan_keywords`: 这次 grep 用过的关键词列表
+6. 更新 INDEX.md(不存在则按 `templates/INDEX.md` 创建),新增一行
+7. 输出文件**完整绝对路径**给用户
+
+---
+
+## 操作:更新已有文档
+
+**核心:先 git diff 判断有无变化,无变化直接退出,不读代码。**
+
+1. 读 `<root>/<逻辑名称>.md` 的 YAML frontmatter,拿 `last_commit` 和 `sources`
+2. 跑命令(**不带 HEAD,含未提交改动**):
+   ```bash
+   git diff --stat <last_commit> -- <sources 列表展开>
+   ```
+3. 输出为空 → 告诉用户:
+   > "自 `<last_commit 短 hash>` 以来,相关代码无变化。文档已是最新,无需更新。"
+   退出,不做任何写入。
+4. 有输出 → 跑 `git diff <last_commit> -- <sources>` 看具体 diff hunk
+5. 只读 diff 涉及的代码片段(不读完整文件,除非 diff 涉及的函数依赖外部上下文)
+6. 重写整个文档(整篇重写策略),更新 frontmatter:
+   - `updated`: 今天日期
+   - `last_commit`: 当前 `git rev-parse HEAD` 的完整 hash
+   - `sources`: 如果有新增相关文件,加入列表
+7. 更新 INDEX.md 对应行的"更新时间"
+8. 输出:"已更新 `<完整绝对路径>`,本次变化:`<git diff --stat 摘要>`"
+
+---
+
+## 操作:查询梳理过的逻辑
+
+1. 读 `<root>/INDEX.md`
+2. 直接把表格输出给用户
+
+INDEX.md 不存在 → "还没梳理过任何逻辑,说'梳理 XX 逻辑'开始第一个。"
+
+---
+
+## 操作:强制重扫
+
+用户说"强制重新梳理 XX" / "重扫 XX" / "rescan XX":
+
+1. 读现有文档的 `scan_keywords`
+2. 用这些关键词重新 grep,允许找到新文件(扩大 sources)
+3. 走"创建新文档"完整流程,覆盖原文件
+4. 更新 `sources`(可能扩大)和 `last_commit` 和 `updated`
+5. 更新 INDEX.md 对应行
+
+---
+
+## 写作规范(产出文档质量底线)
+
+### 通用
+- 面向**非 IT 读者**。避免行话(如 channel、pub-sub、middleware、callback)。必须用专业词时,后面括号补一句白话解释。
+- 时间统一 `YYYY-MM-DD`,不要 `2026/5/17` 或 `5月17日`。
+
+### 1. 概述 (1 段, 3-5 句)
+讲清楚"这段代码是做什么的、解决什么问题、什么时候被触发"。
+
+### 2. 实现逻辑
+
+#### 流程图 (Mermaid `flowchart`,**只用 flowchart,禁止 sequenceDiagram**)
+- 节点用中文标签
+- 决策点用 `{}` 菱形
+- 主路径 + 异常路径都画
+- 节点数 5-15 个;超 15 个考虑拆子流程
+
+#### 关键步骤 (3-7 条有序列表)
+每条:**步骤名**: 一句话解释**做什么** + 一句话解释**为什么这么做**
+
+### 3. 关键配置 (表格)
+- 列:`配置项 | 默认值 | 说明 | 位置`
+- 位置格式 `` `相对路径:行号` ``
+- **只列有人会改的配置**(超时、TTL、批大小、开关、阈值、Cron 表达式),硬编码常量不列
+
+### 4. 依赖关系 (bullet)
+- 每个依赖:**名称**: 用途 + 涉及的 key/表/接口
+- **最后一行必须明确写"不依赖什么"**(常见组件:PostgreSQL/Redis/DolphinDB/MinIO/外部 API),避免读者猜测
+
+---
+
+## 文件结构
+
+### Skill 端
+```
+.claude/skills/dwy-code-flow-docs/
+├── SKILL.md                  ← 本文件
+├── templates/
+│   ├── logic-doc.md          ← 单文档模板
+│   └── INDEX.md              ← 总目录模板
+└── examples/
+    └── 配额计算.md            ← 质量样本(参考它的详尽程度)
+```
+
+### 产出端(用户指定的 root)
+```
+<root>/
+├── INDEX.md
+├── 配额计算.md
+├── 因子流式查询.md
+└── 用户鉴权.md
+```
+
+---
+
+## 禁止
+
+- 禁止把代码原文大段贴进文档(读者是非 IT 人员)
+- 禁止用 ASCII 流程图(必须用 Mermaid)
+- 禁止时序图 `sequenceDiagram`(只用 `flowchart`)
+- 禁止时间格式不一致
+- 禁止省略 frontmatter(下次更新就丢失增量优化能力)
+- 禁止不更新 INDEX.md(总目录必须和实际文件同步)
+- 禁止跳过 git diff 直接重读所有代码(违反 token 优化原则)

package/templates/claude-global/skills//345/274/200/345/217/221/346/265/201/347/250/213/dwy-code-flow-docs/examples//351/205/215/351/242/235/350/256/241/347/256/227.md

@@ -0,0 +1,64 @@
+---
+title: 配额计算
+updated: 2026-05-17
+last_commit: a3f8c2d4e5f6a1b2c3d4e5f6a7b8c9d0e1f2a3b4
+sources:
+  - quant-cloud/backend/packages/quant-billing/src/quant_billing/quota.py
+  - quant-cloud/backend/packages/quant-billing/src/quant_billing/models.py
+  - quant-cloud/backend/packages/quant-billing/src/quant_billing/tasks/reset.py
+scan_keywords: [quota, 配额, billing, deduct, plan_quota]
+---
+
+# 配额计算
+
+**更新时间**: 2026-05-17
+
+## 1. 概述
+
+用户每次调用数据查询 API(如查因子、查 Tick)时,系统都会先检查这个用户的剩余配额够不够。
+够 → 扣掉本次消耗,放行业务逻辑;不够 → 返回 429 错误,告诉用户超限。
+配额按月重置,套餐升级立即生效新配额。整个判断走 Redis 缓存,保证高并发下不卡顿。
+
+## 2. 实现逻辑
+
+### 2.1 流程图
+
+```mermaid
+flowchart TD
+    A[用户 API 请求] --> B{Redis 有缓存?}
+    B -->|有| C[读取剩余配额]
+    B -->|无| D[查 PostgreSQL]
+    D --> E[写入 Redis 缓存 5 分钟]
+    E --> C
+    C --> F{剩余配额 ≥ 本次消耗?}
+    F -->|是| G[Redis 原子扣减]
+    F -->|否| H[返回 429 配额不足]
+    G --> I[异步任务同步到 PostgreSQL]
+    I --> J[放行业务逻辑]
+```
+
+### 2.2 关键步骤
+
+1. **读取配额**: 先查 Redis,5 分钟没人查就过期。为什么用 Redis: 配额查询是高频操作,直接打 DB 扛不住。
+2. **原子扣减**: 用 Redis 的 `DECRBY` 指令保证并发安全。为什么不用 DB 行锁: Redis 内存操作快几十倍,而且并发请求多时行锁会排队。
+3. **异步落盘**: Redis 扣减成功后,丢一个异步任务把最新值同步回 PostgreSQL。为什么异步: 接口响应不能等 DB 写完,异步保证用户体验。
+4. **月度重置**: 每月 1 日 0 点定时任务把所有用户的"已用配额"清零。为什么定时: 套餐周期是按月计的,统一时间点重置便于对账。
+5. **套餐升级**: 用户升级套餐时,服务会主动清除该用户的 Redis 缓存,下次请求会从 DB 重新拉取新配额上限。
+
+## 3. 关键配置
+
+| 配置项 | 默认值 | 说明 | 位置 |
+|--------|--------|------|------|
+| Redis 缓存 TTL | 300 秒 | 配额数据在 Redis 里保留多久 | `quant_billing/quota.py:23` |
+| 月度重置时间 | 每月 1 日 00:00 | Cron 表达式 `0 0 1 * *` | `quant_billing/tasks/reset.py:8` |
+| 套餐配额表名 | `plan_quotas` | PostgreSQL 表,存每个套餐对应的月度配额 | `quant_billing/models.py:45` |
+| 异步落盘队列 | `quota_sync` | ARQ 队列名,负责同步 Redis → PostgreSQL | `quant_billing/worker.py:12` |
+| 超限返回码 | 429 | 配额不足时返回的 HTTP 状态码 | `quant_billing/quota.py:67` |
+
+## 4. 依赖关系
+
+- **PostgreSQL**: 读写 `quotas` 表(每个用户的当月已用量)和 `plan_quotas` 表(每个套餐的配额上限)
+- **Redis**: 缓存 + 原子扣减,key 格式 `quant:quota:{user_id}`,TTL 5 分钟
+- **ARQ (异步任务框架)**: `quota_sync` 队列负责把 Redis 的扣减结果异步同步回 PostgreSQL,接口不等待
+- **dwyeapi 框架**: 走统一异常体系,配额不足时抛 `BusinessError(code="QUOTA_EXCEEDED")`,前端按 code 显示提示
+- **不依赖**: DolphinDB、MinIO、外部支付接口

package/templates/claude-global/skills//345/274/200/345/217/221/346/265/201/347/250/213/dwy-code-flow-docs/templates/INDEX.md

@@ -0,0 +1,7 @@
+# 代码逻辑梳理总目录
+
+最后更新: {{YYYY-MM-DD}}
+
+| # | 标题 | 概述 | 更新时间 | 文档 |
+|---|------|------|----------|------|
+| 1 | {{标题}} | {{一句话概述, 30 字内}} | {{YYYY-MM-DD}} | [{{标题}}.md](./{{标题}}.md) |

package/templates/claude-global/skills//345/274/200/345/217/221/346/265/201/347/250/213/dwy-code-flow-docs/templates/logic-doc.md

@@ -0,0 +1,49 @@
+---
+title: {{逻辑标题}}
+updated: {{YYYY-MM-DD}}
+last_commit: {{git_full_hash}}
+sources:
+  - {{relative/path/to/file1.py}}
+  - {{relative/path/to/file2.py}}
+scan_keywords: [{{kw1}}, {{kw2}}, {{kw3}}]
+---
+
+# {{逻辑标题}}
+
+**更新时间**: {{YYYY-MM-DD}}
+
+## 1. 概述
+
+{{1 段, 3-5 句。讲清楚"这段代码是做什么的、解决什么问题、什么时候被触发"。
+面向非 IT 读者,避免行话。}}
+
+## 2. 实现逻辑
+
+### 2.1 流程图
+
+```mermaid
+flowchart TD
+    A[起点] --> B{判断条件}
+    B -->|条件1| C[动作1]
+    B -->|条件2| D[动作2]
+    C --> E[终点]
+    D --> E
+```
+
+### 2.2 关键步骤
+
+1. **步骤名一**: 做什么 / 为什么这么做
+2. **步骤名二**: 做什么 / 为什么这么做
+3. **步骤名三**: 做什么 / 为什么这么做
+
+## 3. 关键配置
+
+| 配置项 | 默认值 | 说明 | 位置 |
+|--------|--------|------|------|
+| {{配置项名}} | {{默认值}} | {{用途说明}} | `{{相对路径:行号}}` |
+
+## 4. 依赖关系
+
+- **{{依赖名}}**: {{用途, 涉及的 key/表/接口}}
+- **{{依赖名}}**: {{用途, 涉及的 key/表/接口}}
+- **不依赖**: {{明确列出常见但不涉及的组件,如 DolphinDB / MinIO / 外部 API}}