---
name: deppon-npm-private-registry
description: >-
    在使用 deppon 系列 Cursor skills 生成代码前，说明如何通过团队私有 npm 安装 @deppon/* 包、以包内
    README 与类型定义为权威依据（而非依赖 deppon-npm  monorepo 的 site 示例）。在用户分发 skill、
    外仓接入、私有 registry、.npmrc、@deppon 安装 时应用。
---

# deppon 私有 npm 接入（skills 分发前提）

## 结论

**可以**：把 `.cursor/skills/` 复制给任意 Vue 3 工程；对方只要从**同一私有源**安装约定的 `@deppon/*` 包，skills 中的模式即可落地。  
**不要求**对方克隆 `deppon-npm` 或存在 `site/src/views/examples`。

## 安装与源

-   使用团队提供的 **registry 与认证方式**（`~/.npmrc` 或项目级 `.npmrc`：**勿把 token 写进 skill 或提交仓库**）。
-   常见包（以实际发布名为准）：
    -   `@deppon/deppon-template` — `ProForm`、`ProTable`、`ProLayout`、`ProDialog`、`ProField` 等
    -   `@deppon/deppon-ui` — 基础 UI（与 template 联用）
    -   `@deppon/deppon-router` — 路由与 `depponPush` / viewTab 等
    -   `@deppon/deppon-request` — HTTP 封装
    -   `@deppon/deppon-skills` — Cursor Agent Skills（`npm install` 后可用 `deppon-skills-install` 同步到 `.cursor/skills`）
    -   `@deppon/deppon-cli` — 组件文档 / Demo / API 离线查询 + MCP（`deppon list`、`deppon mcp`）

具体版本与 peer 依赖（如 `vue`、样式/less）以**各包在 npm 上声明的 `peerDependencies` 与 README**为准。

## 权威依据（生成代码时读哪里）

按优先级：

1. **`node_modules/@deppon/<包名>/README.md`** 及包内链出的 **`USAGE.md`、`VITE_USAGE.md`**（若 tarball 中包含）。
2. **`node_modules/@deppon/<包名>/es/**/\*.d.ts`\*\*（或包文档指明的 typings 目录）— props、事件、导出组件名。
3. 团队内部文档 / Storybook（若有 URL，以用户项目配置为准，skill 不硬编码内网地址）。

**不要**默认 `Read` `deppon-npm` 仓库下的 `site/src/views/examples/*.vue`；仅在用户**明确打开该 monorepo** 且要求对齐内部 demo 时再查。

## 给 Skill 分发方的说明

-   专项 skills（如 `deppon-pro-form`）描述的是 **API 用法模式**；细节必须与**消费者已安装的包版本**一致。
-   若对方包版本落后，可能出现 props 不一致 — 以对方 `node_modules` 内类型为准。

## 自检

-   [ ] 目标项目已能从私有源安装 `@deppon/*` 且构建通过
-   [ ] 生成/修改代码前已结合 **README + d.ts** 核对组件名与 props