create-dwy 0.25.3 → 0.26.0

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-sdk-spec/references/js-commercial-guide.md

@@ -1,133 +0,0 @@
-# JS/TS 商业版 SDK 完整打包指南
-
-目标：发布到 npm 的 `.tgz` 内**不含 src/、不含 sourcemap、不含 tsconfig**，只含压缩后的 `dist/` 与 `.d.ts` 类型定义。
-
-## 关键原则
-
-- `package.json` 的 `files` 字段是**白名单**，优先级高于 `.npmignore`
-- 用 `tsup` 或 `rollup` 打包，强制 `minify: true` + `sourcemap: false` + `legalComments: 'none'`
-- `.d.ts` 单独生成（用户要类型提示），但不能带 `.d.ts.map`（会映射回源码）
-
-## 工具选择
-
-| 工具 | 优势 | 推荐场景 |
-|---|---|---|
-| **tsup** | 零配置、内置 dts + 多格式 | **默认选择** |
-| rollup + rollup-plugin-dts | 配置灵活、生态成熟 | 复杂 bundle 拆分 |
-| esbuild | 最快、最小 | 简单单文件 SDK |
-
-下面以 tsup 为准。
-
-## 项目结构示例
-
-```
-mysdk/
-├── package.json
-├── tsup.config.ts
-├── tsconfig.json                   # 仅本地用，不发
-├── .gitignore
-├── .npmignore                      # 可选（files 优先）
-├── src/
-│   ├── index.ts                    # 入口
-│   ├── client.ts                   # 公开 API
-│   └── _internal/                  # 内部模块
-│       └── engine.ts
-└── dist/                           # 构建产物（唯一发布内容）
-    ├── index.js                    # ESM，minified
-    ├── index.cjs                   # CJS，minified
-    └── index.d.ts                  # 类型定义（无 .map）
-```
-
-## tsup.config.ts
-
-```typescript
-import { defineConfig } from 'tsup'
-
-export default defineConfig({
-  entry: ['src/index.ts'],
-  format: ['esm', 'cjs'],
-  dts: true,                  // 生成 .d.ts
-  sourcemap: false,           // 关键：不生成 .map（防止源码可还原）
-  minify: true,               // 压缩
-  legalComments: 'none',      // 去掉 /*! */ 版权注释（可能含路径）
-  splitting: false,           // 不拆分（防止内部模块结构暴露）
-  clean: true,                // 构建前清 dist/
-  treeshake: true,
-})
-```
-
-## package.json
-
-```json
-{
-  "name": "@dwydev/mysdk",
-  "version": "1.0.0",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "prepublishOnly": "pnpm build && npm pack --dry-run"
-  },
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org/",
-    "access": "public"
-  }
-}
-```
-
-`files` 白名单只列 3 项 → 其他全部不发（src/、tests/、tsconfig.json、tsup.config.ts、node_modules/ 自动不发）。
-
-## 构建命令
-
-```bash
-# 清理 + 打包
-rm -rf dist/
-pnpm build
-
-# 验证 dist/ 无 .map
-find dist -name '*.map' -type f && echo "FAIL: sourcemap leaked" || echo "OK: no sourcemap"
-
-# 干跑看 .tgz 内容
-npm pack --dry-run --json | jq '.[] | .files[] | .path'
-```
-
-## 验收清单（流程 B 用）
-
-| 检查项 | 命令 |
-|---|---|
-| package.json 有 files 白名单 | `jq '.files \| length > 0' package.json` |
-| files 不含 src/ | `jq '.files \| any(. == "src" or . == "src/")' package.json` 应为 false |
-| tsup 配置 minify + 无 sourcemap | `grep -E 'minify.*true' tsup.config.*` + `grep -E 'sourcemap.*false' tsup.config.*` |
-| dist/ 下无 .map | `find dist -name '*.map'` 应为空 |
-| .gitignore 含 .env / *.tsbuildinfo | `grep -E '\.env\\|\.tsbuildinfo' .gitignore` |
-
-## 常见踩坑
-
-| 现象 | 原因 | 修复 |
-|---|---|---|
-| 用 `.npmignore` 但 files 也定义了 | `files` 优先，`.npmignore` 被忽略 | 二选一，推荐只用 `files` |
-| `.tgz` 里有 `.DS_Store` | macOS 系统文件，没被 ignore | `.gitignore` 加 `.DS_Store`；npm 默认会带 .gitignore 规则 |
-| 发布后 .d.ts 含内部路径 | tsup 生成的 .d.ts 没合并 | 用 `dts: { resolve: true }` 合并所有类型，或改用 rollup-plugin-dts |
-| 装完后用户 IDE 跳转到 minified 代码 | `.d.ts.map` 不小心发了 | 检查 `dist/` 无 `.d.ts.map`，tsup 默认不生成 |
-| `bin` 字段指向的 CLI 被压缩后报 "no entry" | 缺 shebang `#!/usr/bin/env node` | tsup 配 `banner: { js: '#!/usr/bin/env node' }` |
-
-## 参考 dwy-shared 内已有 SDK
-
-`frontend/eui/` / `frontend/ekit/` 当前是**开源版**（Vite 构建，含 `vite-plugin-dts`）。若要转商业版：
-1. 把 Vite 换成 tsup（或在 Vite 配置加 `build.minify: 'terser'` + `build.sourcemap: false`）
-2. `package.json` 添加 `files: ["dist", "README.md", "LICENSE"]`
-3. 删除 `dist/` 下所有 `.map` 文件
-4. 跑 `npm pack --dry-run` 验收

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-sdk-spec/references/publish-blacklist.md

@@ -1,106 +0,0 @@
-# PyPI / npm 发布黑名单
-
-`check_python_publish.sh` / `check_js_publish.sh` 的规则源。
-
-## Python（PyPI）
-
-### 商业版：白名单（其他一律违规）
-
-| 允许的文件 / 模式 | 说明 |
-|---|---|
-| `*.so` | 编译产物 |
-| `*.pyi` | 类型存根（无源） |
-| `py.typed` | 标记包支持类型检查 |
-| `*.dist-info/**` | wheel 元数据（METADATA / RECORD / WHEEL / entry_points.txt 等） |
-| `LICENSE` `LICENSE.*` `LICENCE` | 许可证（可在包外） |
-| `README` `README.*` | 仅 dist-info 内 |
-| `<pkg>/__init__.py` | 公开入口（如果用了 re-export 模式） |
-| `<pkg>/<public_module>.py` | 不以 `_` 开头的公开 API 模块 |
-| 业务必要资源（图片、json、模板） | 列入 `package-data` |
-
-### 开源版：黑名单（任意命中视为违规）
-
-| 禁止的文件 / 模式 | 原因 |
-|---|---|
-| `__pycache__/**` | 字节码缓存，可反编译 |
-| `*.pyc` `*.pyo` | 同上 |
-| `*.egg-info/**` | 旧式构建元数据，含本地路径 |
-| `.mypy_cache/**` `.pytest_cache/**` `.ruff_cache/**` | 开发工具缓存 |
-| `.pdb` `.idb` | 调试符号 |
-| `.env` `.env.*` `.env.local` | 环境变量（凭证） |
-| `.pypirc` | PyPI 凭证（致命） |
-| `.git/**` `.gitignore` | 版本控制（含历史） |
-| `.DS_Store` `Thumbs.db` | 系统文件 |
-| `.vscode/**` `.idea/**` | IDE 配置（可能含路径） |
-| `*.bak` `*.swp` `*.swo` `*~` | 编辑器临时文件 |
-
-## npm
-
-### 商业版：白名单（其他一律违规）
-
-| 允许的文件 / 模式 | 说明 |
-|---|---|
-| `dist/**` | 构建产物（minified） |
-| `package.json` | 必有 |
-| `README` `README.*` | 用户必读 |
-| `LICENSE` `LICENSE.*` `LICENCE` | 许可证 |
-| `CHANGELOG` `CHANGELOG.*` | 可选 |
-| `bin/**` | 仅 CLI 包 |
-| `*.d.ts` 在 dist/ 内 | 类型定义 |
-
-### 开源版：黑名单（任意命中视为违规）
-
-| 禁止的文件 / 模式 | 原因 |
-|---|---|
-| `src/**` `tests/**` `__tests__/**` | 源码 / 测试（占体积） |
-| `*.test.ts` `*.spec.ts` `*.test.js` `*.spec.js` | 测试文件 |
-| `*.map` `*.js.map` `*.d.ts.map` | sourcemap（源码可还原） |
-| `*.tsbuildinfo` | TS 增量编译信息（含路径） |
-| `tsconfig*.json` | 编译配置 |
-| `vite.config.*` `vitest.config.*` `tsup.config.*` `rollup.config.*` `webpack.config.*` | 打包配置 |
-| `.eslintrc*` `.prettierrc*` `eslint.config.*` `prettier.config.*` | Lint 配置 |
-| `.env` `.env.*` | 环境变量（凭证） |
-| `.npmrc` `.yarnrc` `.pnpmrc` | 包管理器配置（含 token） |
-| `.git/**` `.gitignore` `.gitattributes` | 版本控制 |
-| `.github/**` `.gitlab-ci.yml` `.travis.yml` `.circleci/**` | CI 配置（含 secret 引用） |
-| `.vscode/**` `.idea/**` `*.swp` | IDE / 编辑器 |
-| `.DS_Store` `Thumbs.db` | 系统文件 |
-| `node_modules/**` | 依赖（npm 自动忽略，但 .npmignore 错误时可能漏出） |
-| `pnpm-lock.yaml` `package-lock.json` `yarn.lock` | 锁文件（npm 默认忽略） |
-| `.husky/**` `commitlint.config.*` | Git hook 配置 |
-
-## 致命级（任何版本都禁）
-
-无论商业 / 开源，下列文件一旦发到 PyPI / npm 都视为**严重事故**，必须立即 `npm unpublish` / 联系 PyPI 删除：
-
-| 文件 | 风险 |
-|---|---|
-| `.env*` | 含 API key / DB 密码 / 第三方凭证 |
-| `.npmrc` `.pypirc` `.git-credentials` | 仓库 / 包管理器登录凭证 |
-| `id_rsa` `id_ed25519` `*.pem` `*.key` `*.p12` | SSH / TLS 私钥 |
-| `secrets.json` `credentials.json` `.aws/credentials` | 云服务凭证 |
-| `*.pdb` 含调试源 / `.dSYM` | 调试符号文件 |
-
-`check_*_publish.sh` 命中致命级 → 输出 `[CRITICAL]` 并提示用户立即从 registry 下架。
-
-## 校验自动化
-
-每次 `pre-publish` 钩子建议接 skill：
-
-**Python**（`pyproject.toml`）：
-
-```toml
-# 暂无标准 prepublish hook，推荐 Makefile / justfile
-```
-
-**npm**（`package.json`）：
-
-```json
-{
-  "scripts": {
-    "prepublishOnly": "pnpm build && npm pack --dry-run && dwy-sdk-spec check"
-  }
-}
-```
-
-（注：`dwy-sdk-spec check` 是未来 CLI 子命令计划，当前在 Claude Code 中触发 skill）

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-sdk-spec/references/python-commercial-guide.md

@@ -1,147 +0,0 @@
-# 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-github-action-publish 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/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-sdk-spec/references/sensitive-patterns.md

@@ -1,112 +0,0 @@
-# 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`
-
-豁免**单行**，不豁免整段。要长期豁免某文件 → 在 `<project_root>/.dwy/sdk-spec/config.json` 加 `ignore_files: ["path/to/file.py"]`（未来支持，当前手动用行内豁免）。