create-dwy 0.12.1 → 0.12.2

package/templates/claude-global/skills//345/256/211/345/205/250/dwy-sdk-spec/references/python-commercial-guide.md

@@ -0,0 +1,147 @@
+# Python 商业版 SDK 完整打包指南
+
+目标：发布到 PyPI 的 wheel 内**不含 `.py` 源文件**，只含编译后的 `.so` 与必要类型存根。
+
+## 决策树
+
+```
+模块类型
+├── 公开 API 入口（如 mypkg/__init__.py）→ 保留 .py（用户要 import）
+├── 内部实现（_ 开头，如 mypkg/_engine.py）→ 编译为 .so
+└── 类型存根（.pyi）→ 保留（用户 IDE 提示）
+```
+
+## 工具选择
+
+| 工具 | 优势 | 推荐场景 |
+|---|---|---|
+| **Cython** | 成熟、setuptools 集成无缝、编译快 | **默认选择**，纯 Python → .so |
+| Nuitka | 优化更激进、支持整包编译 | 大型业务逻辑、想编译整个包 |
+
+下面以 Cython 为准。
+
+## 项目结构示例
+
+```
+mypkg/                              # 包根目录
+├── pyproject.toml
+├── MANIFEST.in
+├── .gitignore
+├── src/
+│   └── mypkg/
+│       ├── __init__.py             # 公开入口（保留 .py，re-export）
+│       ├── client.py               # 公开 API（保留 .py）
+│       ├── _engine.py              # 内部核心（编译为 .so）
+│       ├── _engine.pyi             # 类型存根（保留）
+│       ├── _utils.py               # 内部工具（编译为 .so）
+│       └── _utils.pyi              # 类型存根（保留）
+```
+
+## pyproject.toml 配置
+
+```toml
+[build-system]
+requires = ["setuptools>=68.0", "Cython>=3.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "mypkg"
+version = "1.0.0"
+requires-python = ">=3.11"
+
+[tool.setuptools]
+include-package-data = true
+zip-safe = false
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+mypkg = ["*.pyi", "py.typed"]
+
+[tool.setuptools.exclude-package-data]
+mypkg = [
+    "_*.py",        # 排除以 _ 开头的源文件（已编译为 .so）
+    "*.c",          # Cython 中间产物
+    "*.pyx",        # Cython 源
+    "*.pyc",
+    "__pycache__/*",
+]
+```
+
+## setup.py（Cython 入口）
+
+```python
+from setuptools import setup
+from Cython.Build import cythonize
+from pathlib import Path
+
+# 找所有 _ 开头的 .py 模块（命名约定：内部模块用 _ 前缀）
+internal_modules = [
+    str(p) for p in Path("src/mypkg").glob("_*.py")
+    if p.name != "__init__.py"
+]
+
+setup(
+    ext_modules=cythonize(
+        internal_modules,
+        compiler_directives={"language_level": "3"},
+    ),
+)
+```
+
+## MANIFEST.in
+
+```
+graft src
+include README.md LICENSE py.typed
+include src/mypkg/*.pyi
+
+# 全局排除源码与中间产物
+global-exclude _*.py
+global-exclude *.pyx *.pxd *.c
+global-exclude *.pyc *.pyo
+global-exclude __pycache__ .DS_Store
+```
+
+`graft src` 含整个 src/，然后 `global-exclude _*.py` 排掉内部源；公开 `.py` 保留（如 `__init__.py` / `client.py` 不以 `_` 开头）。
+
+## 构建命令
+
+```bash
+# 清理旧产物
+rm -rf build/ dist/ src/*.egg-info/
+
+# 编译 + 打包
+python -m build
+
+# 验证 wheel 内不含 _ 开头的 .py
+unzip -l dist/*.whl | grep -E '_.*\.py$' && echo "FAIL: source leaked" || echo "OK"
+```
+
+## 验收清单（流程 B 用）
+
+| 检查项 | 命令 |
+|---|---|
+| pyproject.toml 含 Cython | `grep -E 'cython\|Cython' pyproject.toml` |
+| `_*.so` 存在 | `find src -name '_*.so' -type f` 应该有输出 |
+| MANIFEST.in 排除源码 | `grep -E 'global-exclude.*_\*\.py' MANIFEST.in` |
+| wheel 内无 `_*.py` | `unzip -l dist/*.whl \| grep -E '_.*\.py$'` 应该为空 |
+| .gitignore 含编译产物 | `grep -E '^\*\.so\b\|^build/\b\|^dist/\b' .gitignore` |
+
+## 常见踩坑
+
+| 现象 | 原因 | 修复 |
+|---|---|---|
+| wheel 里有 `.py` 源 | `exclude-package-data` 没匹配到 / MANIFEST.in 缺 global-exclude | 同时配 setup 配置 + MANIFEST.in |
+| 装完后 `ImportError: cannot import name '_engine'` | `__init__.py` 用了 `from . import _engine` 但 .so 命名空间不对 | 确保 `.so` 文件在包内，名字与 import 路径一致 |
+| `pip install -e .` 后 import 慢 | 开发模式没编译 .so，跑了 .py | 开发用 `python setup.py build_ext --inplace` 触发编译 |
+| 跨平台 wheel（manylinux / macOS） | 单平台编译产物只能装到对应平台 | 用 `cibuildwheel`（项目已有 dwy-cibuildwheel skill） |
+
+## 参考 dwy-shared 内已有 SDK
+
+`backend/`（`dwyeapi`）当前是**开源版**（pyproject.toml 无 Cython 配置）。若要转商业版：
+1. 把 `src/dwyeapi/security.py` / `database.py` 重命名为 `_security.py` / `_database.py`
+2. `__init__.py` 加 re-export 维持公开 API
+3. 加 Cython 配置、MANIFEST.in、setup.py
+4. 重新发布 → 装完后用户 import 路径不变，但拿不到 .py 源

package/templates/claude-global/skills//345/256/211/345/205/250/dwy-sdk-spec/references/sensitive-patterns.md

@@ -0,0 +1,112 @@
+# SDK 接口注释敏感模式清单
+
+`check_comments.py` 的规则源。SDK 对外注释（Python docstring、JSDoc、TSDoc）**只写**功能含义、入参格式、返回值、异常，下列模式一律视为泄露。
+
+## 模式表
+
+| 模式 ID | 正则 | 风险 | 误报豁免（如有） |
+|---|---|---|---|
+| `internal-domain` | `[\w-]+\.(internal\|corp\|local\|intranet)\b` | 暴露内网域名结构 | 出现在 example.com / your-domain 等示例语 → 视为示例 |
+| `private-ip` | `\b(10\.\d+\.\d+\.\d+\|192\.168\.\d+\.\d+\|172\.(1[6-9]\|2\d\|3[01])\.\d+\.\d+)\b` | 暴露内网 IP | — |
+| `sql-statement` | `\b(SELECT\|UPDATE\|DELETE\|INSERT)\b[^.]*\b(FROM\|WHERE\|SET\|INTO)\b` | 暴露表结构、查询逻辑 | 行含 `example`/`e.g.` 视作示例语 |
+| `redis-key-pattern` | `\b(cache\|redis\|fmt\|lock\|queue):[a-z_]+:` | 暴露缓存键 schema | — |
+| `jira-ticket` | `\b[A-Z]{2,6}-\d{2,6}\b` | 暴露内部工单系统 | 行含「示例」「example」豁免 |
+| `internal-service` | `\b[a-z_]+_(service\|server\|grpc\|rpc)_(v\d\|prod\|stg\|dev)\b` | 暴露内部服务命名 | — |
+| `service-port` | `:(\d{4,5})\b` 且行内含 `connect\|server\|host\|endpoint\|address` | 暴露内网服务端口 | 默认端口 80/443/8080 豁免，example 示例豁免 |
+| `internal-email` | `[\w.+-]+@(?!example\.com\|gmail\.com\|outlook\.com)[\w.-]+\.[a-z]{2,}` | 暴露员工邮箱 | 公开公司域名（github.io 等）豁免 |
+| `aws-arn` | `arn:aws:[a-z0-9-]+:[a-z0-9-]*:\d+:[a-zA-Z0-9-_/:]+` | 暴露 AWS 账号 ID 与资源 | — |
+| `cred-keyword` | `\b(API_KEY\|TOKEN\|SECRET\|PASSWORD\|PRIVATE_KEY)\s*[=:]\s*['"][\w-]+['"]` | 注释里硬编码凭证 | 占位 `xxx` / `<your-token>` 豁免 |
+| `aws-key` | `\bAKIA[0-9A-Z]{16}\b` | AWS Access Key ID | — |
+
+## 正例 vs 反例
+
+### Python docstring
+
+**反例**：
+
+```python
+def get_user(user_id: str):
+    """
+    Connect to https://users.internal.corp.com/v2/profile via gRPC.
+    Query SELECT * FROM users_prod WHERE id = ? with cache key cache:user:{id}.
+    Owner: john.doe@anthropic.io. See PAY-1234 for context.
+    """
+```
+
+**正例**：
+
+```python
+def get_user(user_id: str):
+    """
+    获取用户基本资料。
+
+    Args:
+        user_id: 用户唯一标识符（UUID 格式）。
+
+    Returns:
+        UserProfile，含 name / email / created_at 字段。
+
+    Raises:
+        UserNotFoundError: user_id 不存在时抛出。
+        AuthenticationError: 当前会话无权限读取该用户资料。
+
+    Example:
+        >>> user = get_user("user-123")
+        >>> user.name
+        'Alice'
+    """
+```
+
+### TypeScript JSDoc
+
+**反例**：
+
+```typescript
+/**
+ * Fetch user from db.internal.corp:5432 (table users_prod).
+ * Uses Redis cache key fmt:user:{id} ttl 3600s.
+ * Fallback to backup_db at 10.0.0.5:5432 if primary down.
+ * See JIRA USR-456, contact #user-platform on internal Slack.
+ */
+export async function fetchUser(id: string): Promise<UserProfile> { ... }
+```
+
+**正例**：
+
+```typescript
+/**
+ * 获取用户基本资料。
+ *
+ * @param id 用户唯一标识符（UUID 格式）
+ * @returns 用户资料对象，含 name / email / created_at 字段
+ * @throws {UserNotFoundError} id 不存在时抛出
+ * @throws {AuthenticationError} 当前会话无权限读取该用户资料
+ *
+ * @example
+ * ```ts
+ * const user = await fetchUser("user-123");
+ * console.log(user.name);
+ * ```
+ */
+export async function fetchUser(id: string): Promise<UserProfile> { ... }
+```
+
+## 应该写什么 vs 不应该写什么
+
+| 类别 | 应该写 | 不应该写 |
+|---|---|---|
+| 接口功能 | 业务语义（「获取用户资料」） | 实现路径（「调用 gRPC service xxx」） |
+| 入参 | 类型、格式、约束（UUID、长度上限） | 上游表字段、内部 schema 字段名 |
+| 返回 | 字段语义 | 来自哪张表、哪个缓存键 |
+| 异常 | 业务异常类、触发条件 | 数据库连接错误细节、内部 RPC 失败码 |
+| 示例 | 公开占位（`user-123` / `example.com`） | 真实用户 ID、真实邮箱、内网域名 |
+| 链接 | 公开文档 URL、相对路径文档 | 内网 wiki、JIRA、Slack、Confluence 链接 |
+
+## 行内豁免约定
+
+误报场景在该行追加注释：
+
+- Python：`# sdk-spec: ignore`
+- TS/JS：`// sdk-spec: ignore`
+
+豁免**单行**，不豁免整段。要长期豁免某文件 → 在 `~/.config/dwy-sdk-spec/projects.json` 的对应项目下加 `ignore_files: ["path/to/file.py"]`（未来支持，当前手动用行内豁免）。

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

@@ -0,0 +1,260 @@
+#!/usr/bin/env python3
+"""扫 Python docstring 与 JS/TS JSDoc 中的敏感模式。
+
+用法:
+    check_comments.py <root> [--sdk-paths <json>] [--format text|json]
+
+退出码:
+    0 = 无违规
+    1 = 有违规
+    2 = 用法错误
+"""
+from __future__ import annotations
+
+import argparse
+import ast
+import json
+import re
+import sys
+from dataclasses import dataclass, asdict
+from pathlib import Path
+from typing import Iterable
+
+
+# 敏感模式表，与 references/sensitive-patterns.md 对齐
+PATTERNS: list[tuple[str, re.Pattern[str]]] = [
+    ("internal-domain", re.compile(r"\b[\w-]+\.(internal|corp|local|intranet)\b", re.I)),
+    ("private-ip", re.compile(
+        r"\b(?:10\.\d{1,3}\.\d{1,3}\.\d{1,3}"
+        r"|192\.168\.\d{1,3}\.\d{1,3}"
+        r"|172\.(?:1[6-9]|2\d|3[01])\.\d{1,3}\.\d{1,3})\b"
+    )),
+    ("sql-statement", re.compile(
+        r"\b(SELECT|UPDATE|DELETE|INSERT)\b[^.\n]{0,80}\b(FROM|WHERE|SET|INTO)\b", re.I
+    )),
+    ("redis-key-pattern", re.compile(r"\b(cache|redis|fmt|lock|queue):[a-z_]+:")),
+    ("jira-ticket", re.compile(r"\b[A-Z]{2,6}-\d{2,6}\b")),
+    ("internal-service", re.compile(
+        r"\b[a-z_]+_(?:service|server|grpc|rpc)_(?:v\d|prod|stg|stage|dev)\b"
+    )),
+    ("aws-arn", re.compile(r"arn:aws:[a-z0-9-]+:[a-z0-9-]*:\d+:[a-zA-Z0-9-_/:]+")),
+    ("aws-key", re.compile(r"\bAKIA[0-9A-Z]{16}\b")),
+    ("cred-keyword", re.compile(
+        r"\b(API_KEY|TOKEN|SECRET|PASSWORD|PRIVATE_KEY)\s*[=:]\s*['\"][\w\-./+]{6,}['\"]"
+    )),
+]
+
+# 弱模式（仅在行内有上下文关键字时命中，降误报）
+PORT_PATTERN = re.compile(r":(\d{4,5})\b")
+PORT_CONTEXT = re.compile(r"\b(connect|server|host|endpoint|address|listen|bind)\b", re.I)
+
+EMAIL_PATTERN = re.compile(r"[\w.+-]+@[\w.-]+\.[a-z]{2,}")
+PUBLIC_EMAIL_DOMAINS = {
+    "example.com", "example.org", "example.net",
+    "gmail.com", "outlook.com", "hotmail.com", "qq.com", "163.com",
+    "yourdomain.com", "your-domain.com", "domain.com",
+}
+
+# 行内示例 / 占位关键字 → 整行视为示例不告警
+EXAMPLE_HINTS = re.compile(r"\b(example|示例|e\.g\.|placeholder|占位|your[- ]?domain|<.*>)\b", re.I)
+
+# 行内豁免
+IGNORE_MARKER = re.compile(r"#\s*sdk-spec:\s*ignore|//\s*sdk-spec:\s*ignore")
+
+
+@dataclass
+class Violation:
+    file: str
+    line: int
+    pattern: str
+    match: str
+    context: str
+
+
+def scan_text(file_rel: str, text: str, start_line_offset: int = 0) -> list[Violation]:
+    """扫一段连续文本（docstring 或注释块），返回违规列表。
+
+    `text` 内部带换行，`start_line_offset` 是该文本第一行在文件中的实际行号。
+    """
+    out: list[Violation] = []
+    for i, line in enumerate(text.splitlines(), start=start_line_offset):
+        if IGNORE_MARKER.search(line):
+            continue
+        line_stripped = line.strip()
+        if not line_stripped:
+            continue
+
+        is_example = bool(EXAMPLE_HINTS.search(line))
+
+        # 主模式
+        for pat_name, pat in PATTERNS:
+            for m in pat.finditer(line):
+                if is_example and pat_name in {"sql-statement", "internal-domain", "jira-ticket"}:
+                    continue
+                out.append(Violation(
+                    file=file_rel, line=i,
+                    pattern=pat_name, match=m.group(0),
+                    context=line_stripped[:160],
+                ))
+
+        # 端口（弱模式）
+        if not is_example and PORT_CONTEXT.search(line):
+            for m in PORT_PATTERN.finditer(line):
+                port = int(m.group(1))
+                if port in {8080, 8000, 3000, 5000, 5173, 5432, 6379, 9000}:
+                    # 常见示例端口，跳过
+                    continue
+                out.append(Violation(
+                    file=file_rel, line=i,
+                    pattern="service-port", match=m.group(0),
+                    context=line_stripped[:160],
+                ))
+
+        # 邮箱（弱模式）
+        if not is_example:
+            for m in EMAIL_PATTERN.finditer(line):
+                email = m.group(0)
+                domain = email.split("@", 1)[1].lower()
+                if domain in PUBLIC_EMAIL_DOMAINS:
+                    continue
+                out.append(Violation(
+                    file=file_rel, line=i,
+                    pattern="internal-email", match=email,
+                    context=line_stripped[:160],
+                ))
+    return out
+
+
+def scan_python_file(path: Path, root: Path) -> list[Violation]:
+    rel = str(path.relative_to(root))
+    try:
+        source = path.read_text(encoding="utf-8")
+    except (UnicodeDecodeError, OSError):
+        return []
+    try:
+        tree = ast.parse(source)
+    except SyntaxError:
+        return []
+
+    out: list[Violation] = []
+    # 模块、函数、类、异步函数的 docstring
+    for node in ast.walk(tree):
+        if not isinstance(node, (ast.Module, ast.FunctionDef, ast.AsyncFunctionDef, ast.ClassDef)):
+            continue
+        doc = ast.get_docstring(node, clean=False)
+        if not doc:
+            continue
+        # docstring 首行在 node.body[0].lineno（第一条 Expr 是字符串）
+        first_stmt = node.body[0] if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef, ast.ClassDef)) else node.body[0]
+        start_line = getattr(first_stmt, "lineno", 1)
+        out.extend(scan_text(rel, doc, start_line_offset=start_line))
+    return out
+
+
+# 匹配 JS/TS 的 /** ... */ JSDoc 块（不含其他 /* */ 注释）
+JSDOC_BLOCK = re.compile(r"/\*\*(.*?)\*/", re.DOTALL)
+# 行注释 //
+LINE_COMMENT = re.compile(r"^\s*//\s?(.*)$")
+
+
+def scan_js_file(path: Path, root: Path) -> list[Violation]:
+    rel = str(path.relative_to(root))
+    try:
+        source = path.read_text(encoding="utf-8")
+    except (UnicodeDecodeError, OSError):
+        return []
+
+    out: list[Violation] = []
+
+    # JSDoc 块
+    for m in JSDOC_BLOCK.finditer(source):
+        block_text = m.group(1)
+        # 起始行号
+        start_line = source.count("\n", 0, m.start()) + 1
+        # 去掉每行的 leading * 和空白
+        cleaned_lines = []
+        for line in block_text.splitlines():
+            cleaned_lines.append(re.sub(r"^\s*\*\s?", "", line))
+        out.extend(scan_text(rel, "\n".join(cleaned_lines), start_line_offset=start_line))
+
+    # 行内注释（只扫描，因为商业 SDK 内部实现的行注释虽然不打包但开发期能看到）
+    # 注：源文件其实是否打包取决于配置，行注释泄露主要看是否打包 src/
+    # 跨边界谨慎起见也扫
+    for i, line in enumerate(source.splitlines(), start=1):
+        lm = LINE_COMMENT.match(line)
+        if not lm:
+            continue
+        comment = lm.group(1)
+        out.extend(scan_text(rel, comment, start_line_offset=i))
+
+    return out
+
+
+def iter_target_files(root: Path, sdk_paths: list[str] | None) -> Iterable[Path]:
+    """枚举要扫的文件。sdk_paths 为 None 时全扫；否则只扫指定路径。"""
+    excludes = {
+        "node_modules", ".venv", "venv", "dist", "build",
+        ".git", "__pycache__", ".mypy_cache", ".pytest_cache",
+        ".ruff_cache", ".tox", "egg-info", "site-packages",
+    }
+    bases = [root / p for p in sdk_paths] if sdk_paths else [root]
+    for base in bases:
+        if not base.exists():
+            continue
+        for p in base.rglob("*"):
+            if not p.is_file():
+                continue
+            if any(part in excludes or part.endswith(".egg-info") for part in p.parts):
+                continue
+            suf = p.suffix.lower()
+            if suf in {".py", ".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"}:
+                yield p
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Scan SDK comments for sensitive patterns.")
+    parser.add_argument("root", help="Project root directory (absolute path)")
+    parser.add_argument("--sdk-paths", default=None,
+                        help='JSON {"python":[...], "js":[...]} relative to root. Omit to scan all.')
+    parser.add_argument("--format", choices=["text", "json"], default="text")
+    args = parser.parse_args()
+
+    root = Path(args.root).resolve()
+    if not root.is_dir():
+        print(f"ERROR: not a directory: {root}", file=sys.stderr)
+        return 2
+
+    target_paths: list[str] | None = None
+    if args.sdk_paths:
+        try:
+            sdk_spec = json.loads(args.sdk_paths)
+        except json.JSONDecodeError as e:
+            print(f"ERROR: invalid --sdk-paths JSON: {e}", file=sys.stderr)
+            return 2
+        target_paths = []
+        for key in ("python", "js"):
+            target_paths.extend(sdk_spec.get(key, []))
+
+    violations: list[Violation] = []
+    for fp in iter_target_files(root, target_paths):
+        if fp.suffix == ".py":
+            violations.extend(scan_python_file(fp, root))
+        else:
+            violations.extend(scan_js_file(fp, root))
+
+    if args.format == "json":
+        print(json.dumps([asdict(v) for v in violations], ensure_ascii=False, indent=2))
+    else:
+        if not violations:
+            print("OK: no sensitive patterns found")
+        else:
+            print(f"FAIL: {len(violations)} violation(s) found:\n")
+            for v in violations:
+                print(f"  {v.file}:{v.line}  [{v.pattern}]  match={v.match!r}")
+                print(f"    > {v.context}")
+
+    return 1 if violations else 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

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

@@ -0,0 +1,110 @@
+#!/usr/bin/env bash
+# JS/TS SDK 发布前文件清单审计（npm pack --dry-run）
+# 用法: check_js_publish.sh <js_sdk_root> --edition commercial|opensource
+
+set -euo pipefail
+
+if [[ $# -lt 3 ]]; then
+  echo "Usage: $0 <js_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 npm >/dev/null 2>&1; then
+  echo "ERROR: npm not found in PATH" >&2
+  exit 2
+fi
+
+echo "[1/2] Running npm pack --dry-run in $PKG_ROOT ..."
+
+# npm pack --dry-run --json 输出包内文件列表
+# 注：某些 npm 版本 --json 输出到 stderr，--silent 抑制非 JSON 输出
+PACK_OUTPUT=$(cd "$PKG_ROOT" && npm pack --dry-run --json 2>/dev/null) || {
+  echo "ERROR: npm pack --dry-run failed; run 'npm install' first?" >&2
+  exit 2
+}
+
+# 提取文件路径列表
+FILES=$(echo "$PACK_OUTPUT" | jq -r '.[0].files[].path' 2>/dev/null) || {
+  echo "ERROR: failed to parse npm pack output:" >&2
+  echo "$PACK_OUTPUT" | head -20 >&2
+  exit 2
+}
+
+echo "[2/2] Audit result (edition=$EDITION):"
+echo "----------------------------------------"
+
+# 致命级（任何版本都禁）
+CRITICAL_REGEX='(^|/)(\.env(\..+)?|\.npmrc|\.pypirc|\.git-credentials|id_rsa|id_ed25519|secrets\.json|credentials\.json)$|\.(pem|key|p12)$|(^|/)\.aws/credentials$'
+
+# 开源版黑名单
+OPENSOURCE_DENY_REGEX='(^|/)(src|tests|__tests__|\.git|\.github|\.gitlab-ci\.yml|\.travis\.yml|\.circleci|\.vscode|\.idea|node_modules|\.husky)/|(^|/)(tsconfig.*\.json|vite\.config\.|vitest\.config\.|tsup\.config\.|rollup\.config\.|webpack\.config\.|jest\.config\.|\.eslintrc.*|\.prettierrc.*|eslint\.config\.|prettier\.config\.|commitlint\.config\.|\.gitignore|\.gitattributes|\.DS_Store|Thumbs\.db|pnpm-lock\.yaml|package-lock\.json|yarn\.lock)|\.(map|tsbuildinfo|swp|swo)$|\.(test|spec)\.(ts|tsx|js|jsx)$'
+
+# 商业版白名单（其他视为违规）
+COMMERCIAL_ALLOW_REGEX='^(dist/|bin/|package\.json$|README(\..+)?$|LICEN[SC]E(\..+)?$|CHANGELOG(\..+)?$)'
+
+violations=()
+critical=()
+
+while IFS= read -r f; do
+  [[ -z "$f" ]] && continue
+
+  if [[ "$f" =~ $CRITICAL_REGEX ]]; then
+    critical+=("$f")
+    continue
+  fi
+
+  if [[ "$EDITION" == "opensource" ]]; then
+    if [[ "$f" =~ $OPENSOURCE_DENY_REGEX ]]; then
+      violations+=("$f  [denied by opensource rules]")
+    fi
+  else
+    if [[ ! "$f" =~ $COMMERCIAL_ALLOW_REGEX ]]; then
+      violations+=("$f  [not in commercial whitelist]")
+    fi
+  fi
+done <<< "$FILES"
+
+if [[ ${#critical[@]} -gt 0 ]]; then
+  echo "[CRITICAL] secret-like files in package — 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
+
+count=$(echo "$FILES" | grep -c .)
+echo "OK: package passes $EDITION audit ($count file(s))"