@tfdesign/b-end 1.0.12 → 1.0.13

package/README.md

@@ -1,8 +1,8 @@
-# @tf-designsystem/b-end（B 端组件库 · 可安装包）
+# @tfdesign/b-end（B 端组件库 · 可安装包）
 
-这个包的目标：**让对方在任意 Cursor + Vite/React 项目里安装后，可以直接 `import { … } from '@tf-designsystem/b-end'` 使用**与 TFDS 平台一致的 **B 端全量组件**（见包内 `src/index.js`）、**页面模板 / PATTERNS**，并拿到与 TFDS 一致的 **Token / theme.css**。
+这个包的目标：**让对方在任意 Cursor + Vite/React 项目里安装后，可以直接 `import { … } from '@tfdesign/b-end'` 使用**与 TFDS 平台一致的 **B 端全量组件**（见包内 `src/index.js`）、**页面模板 / PATTERNS**，并拿到与 TFDS 一致的 **Token / theme.css**。
 
-> **独立 npm 安装**：发布时 `prepack` 会把主仓 `src/data/systems/b-end/` 打包到包内 `src/_b_end_runtime/`，因此对方 `npm i @tf-designsystem/b-end` 后**不必 clone 主仓库**即可解析组件源码。
+> **独立 npm 安装**：发布时 `prepack` 会把主仓 `src/data/systems/b-end/` 打包到包内 `src/_b_end_runtime/`，因此对方 `npm i @tfdesign/b-end` 后**不必 clone 主仓库**即可解析组件源码。
 
 ---
 
@@ -119,14 +119,13 @@ Skill 目录内的关键文件：
 
 ### 安装方式（任选一种）
 
-- **GitHub Packages 私有包（推荐授权成员）**
-先在本机或项目 `.npmrc` 配置（不要追加全局 `--registry`）：
+- **npmjs 公共包（推荐）**
+如需发布权限，在本机或项目 `.npmrc` 配置 npm token；仅安装通常不需要额外 registry 配置：
   ```ini
-  @tf-designsystem:registry=https://npm.pkg.github.com
-  //npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN
+  //registry.npmjs.org/:_authToken=YOUR_NPM_TOKEN
   ```
   ```bash
-  npm i react react-dom lucide-react "@tf-designsystem/b-end@^1.0.0" --save
+  npm i react react-dom lucide-react "@tfdesign/b-end@^1.0.0" --save
   ```
 - **本地 `file:`（联调最快 / 平台分发 zip）**
   ```bash
@@ -139,9 +138,9 @@ Skill 目录内的关键文件：
 
 ```css
 @import "tailwindcss";
-@import "@tf-designsystem/b-end/theme.css";
+@import "@tfdesign/b-end/theme.css";
 @source "./**/*.{js,jsx,ts,tsx}";
-@source "../node_modules/@tf-designsystem/b-end/**/*.{js,jsx}";
+@source "../node_modules/@tfdesign/b-end/**/*.{js,jsx}";
 ```
 
 若入口 CSS **未找到** `@import "tailwindcss"` → 不改写文件，终端打印手动步骤提示。
@@ -150,16 +149,16 @@ Skill 目录内的关键文件：
 
 ```bash
 # 跳过 CSS 自动补丁（保持 CSS 文件不变）
-SKIP_TFDS_CSS_PATCH=1 npm i "@tf-designsystem/b-end" --save
+SKIP_TFDS_CSS_PATCH=1 npm i "@tfdesign/b-end" --save
 
 # 跳过 Skill 复制（如 CI 环境只需依赖不需 IDE Skill）
-SKIP_TFDS_CURSOR_SKILL=1 npm i "@tf-designsystem/b-end" --save
+SKIP_TFDS_CURSOR_SKILL=1 npm i "@tfdesign/b-end" --save
 ```
 
 ### 安装后验证（可选，只读）
 
 ```bash
-node node_modules/@tf-designsystem/b-end/scripts/check-tfds-integration.mjs
+node node_modules/@tfdesign/b-end/scripts/check-tfds-integration.mjs
 ```
 
 ---
@@ -183,15 +182,14 @@ npm i file:../TFDS-Design-Skill/packages/tfds-b-end
 先在本机或项目 `.npmrc` 配置 GitHub Packages registry 与个人 token：
 
 ```ini
-@tf-designsystem:registry=https://npm.pkg.github.com
-//npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN
+//registry.npmjs.org/:_authToken=YOUR_NPM_TOKEN
 ```
 
 ```bash
-npm i react react-dom lucide-react "@tf-designsystem/b-end@^1.0.0" --save
+npm i react react-dom lucide-react "@tfdesign/b-end@^1.0.0" --save
 ```
 
-安装者需要拥有该 package 的 Read 权限，token 至少需要 `read:packages`。包页：[GitHub Packages 包页](https://github.com/orgs/TF-Designsystem/packages/npm/package/b-end)。维护者发版见仓库内 `packages/tfds-b-end/PUBLISH.md`。
+安装者需要拥有该 package 的 Read 权限，token 至少需要 `npm install` 权限。包页：[GitHub Packages 包页](https://github.com/orgs/TF-Designsystem/packages/npm/package/b-end)。维护者发版见仓库内 `packages/tfds-b-end/PUBLISH.md`。
 
 ---
 
@@ -201,11 +199,11 @@ npm i react react-dom lucide-react "@tf-designsystem/b-end@^1.0.0" --save
 
 ```css
 @import "tailwindcss";
-@import "@tf-designsystem/b-end/theme.css";
+@import "@tfdesign/b-end/theme.css";
 
 /* Tailwind v4 推荐 @source（与 tailwind.config content 二选一） */
 @source "./**/*.{js,jsx,ts,tsx}";
-@source "../node_modules/@tf-designsystem/b-end/**/*.{js,jsx}";
+@source "../node_modules/@tfdesign/b-end/**/*.{js,jsx}";
 ```
 
 > `theme.css` 包含 `@theme { ... }` 的完整 token 定义（由 TFDS 的 `generateThemeCssVars()` 生成）。
@@ -221,7 +219,7 @@ export default {
   content: [
     './index.html',
     './src/**/*.{js,jsx,ts,tsx}',
-    './node_modules/@tf-designsystem/b-end/**/*.{js,jsx}',
+    './node_modules/@tfdesign/b-end/**/*.{js,jsx}',
   ],
 };
 ```
@@ -237,7 +235,7 @@ export default {
 头像类组件默认使用包内本地成员头像素材：`Avatar` 图片态未传 `src` 时会随机取本地成员头像；需要稳定绑定时可从包内导出的 `getTeamMemberByIndex` / `getTeamAvatarBySeed` 获取本地头像后传给 `avatarSrc`。不要为默认头像使用 pravatar / Unsplash / placeholder 外链。
 
 ```jsx
-import { NavBar, Button, Table, ChatInput } from '@tf-designsystem/b-end';
+import { NavBar, Button, Table, ChatInput } from '@tfdesign/b-end';
 
 export default function Demo() {
   return (
@@ -253,7 +251,7 @@ export default function Demo() {
 ### 4.1 页面模板：IM 对话（静态片段）
 
 ```jsx
-import { IMConversationPattern } from '@tf-designsystem/b-end';
+import { IMConversationPattern } from '@tfdesign/b-end';
 
 export default function ImDemoPage() {
   return (
@@ -264,7 +262,7 @@ export default function ImDemoPage() {
 }
 ```
 
-> 重要：`IMConversationPattern` 会间接依赖 `ChatBubble → Avatar/Tooltip/...` 等链路。请确保 Tailwind 扫描覆盖到包内所有 `.jsx`（`node_modules/@tf-designsystem/b-end/**/*.{js,jsx}` 通常足够）。
+> 重要：`IMConversationPattern` 会间接依赖 `ChatBubble → Avatar/Tooltip/...` 等链路。请确保 Tailwind 扫描覆盖到包内所有 `.jsx`（`node_modules/@tfdesign/b-end/**/*.{js,jsx}` 通常足够）。
 
 ---
 
@@ -281,7 +279,7 @@ export default function ImDemoPage() {
 ### 5.2 跳过自动释放
 
 ```bash
-SKIP_TFDS_CURSOR_SKILL=1 npm i @tf-designsystem/b-end
+SKIP_TFDS_CURSOR_SKILL=1 npm i @tfdesign/b-end
 ```
 
 ### 5.3 用户如何在 Cursor 里唤起（`/tfds`）
@@ -326,7 +324,7 @@ TFDS 规范只应在显式调用时读取，**不要**放进 `AGENTS.md`、`.tra
 | **Cursor**         | 重新打开项目 / 新开 Agent 会话后输入 `/tfds`；若未出现，确认 `.cursor/skills/tfds/SKILL.md` 后重启 Cursor          | ✅ `.cursor/skills/tfds/`               |
 | **Claude Code**    | 重启 Claude Code 会话后输入 `/tfds`；若不支持 Skill 热加载，直接引用 `skills/tfds/SKILL.md`                     | ✅ `.claude/skills/tfds/`               |
 | **Codex**          | 必须新开/重启 Codex 会话后输入 `/tfds`；当前会话通常不会热加载新安装的 `~/.codex/skills/tfds/`                  | ✅ `~/.codex/skills/tfds/` + `.codex/skills/tfds/` |
-| **Trae**           | 不会自动出现 `/tfds`；把 `node_modules/@tf-designsystem/b-end/skills/tfds/` 加入项目知识库（命名 `tfds`），之后 `@tfds` 引用 | ❌ 故意不写 `.trae/rules/`（避免 always-on 污染） |
+| **Trae**           | 不会自动出现 `/tfds`；把 `node_modules/@tfdesign/b-end/skills/tfds/` 加入项目知识库（命名 `tfds`），之后 `@tfds` 引用 | ❌ 故意不写 `.trae/rules/`（避免 always-on 污染） |
 | **其他 IDE / Agent** | 不保证支持 `/tfds`；显式让 AI 先读 `AI_READ_FIRST.md`，再按其指引读取 `skills/tfds/SKILL.md`                    | —                                      |
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tfdesign/b-end",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "private": false,
   "type": "module",
   "description": "TFDS B-end React components + Tailwind v4 theme.css; self-contained npm install (no monorepo clone required).",