# @happyvertical/smrt-template-sveltekit 中文文档

规范地址：https://npmcn.com/package/%40happyvertical/smrt-template-sveltekit/

版本：0\.62\.1
npm 元数据更新时间：2026-11-17T07:59:05.838Z
中文译文更新时间：2026-11-17T10:10:47.760Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40happyvertical/smrt-template-sveltekit
原文对照：https://npmcn.com/package/%40happyvertical/smrt-template-sveltekit/?lang=original
项目主页：https://github.com/happyvertical/smrt#readme
源码仓库：https://github.com/happyvertical/smrt

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：481 kB，117 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：svelte ^5\.57\.1，@sveltejs/kit ^2\.70\.3，@happyvertical/sql \>=0\.89\.12，@happyvertical/smrt-ui 0\.62\.1，@happyvertical/smrt-chat 0\.62\.1，@happyvertical/smrt-core 0\.62\.1，@happyvertical/smrt-jobs 0\.62\.1，@happyvertical/smrt-types 0\.62\.1，@happyvertical/smrt-users 0\.62\.1，@happyvertical/smrt-agents 0\.62\.1，@happyvertical/smrt-svelte 0\.62\.1，@happyvertical/smrt-app-mcp 0\.62\.1，@happyvertical/smrt-prompts 0\.62\.1，@happyvertical/smrt-tenancy 0\.62\.1，@happyvertical/smrt-inference 0\.62\.1，@happyvertical/smrt-workflows 0\.62\.1，@happyvertical/smrt-app-runtime 0\.62\.1，@happyvertical/smrt-preferences 0\.62\.1
- 首次发布：2026-06-23T01:18:51.208Z
- 最新版本发布：2026-11-17T07:59:05.586Z
- 近 30 天下载量：14644（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：365（近 12 个月 365 个）

## 中文简介

S-m-r-t框架集成的最小 SvelteKit 项目模板

## 安装

```sh
npm install @happyvertical/smrt-template-sveltekit
```

也可以使用：`pnpm add @happyvertical/smrt-template-sveltekit`、`yarn add @happyvertical/smrt-template-sveltekit`、`bun add @happyvertical/smrt-template-sveltekit`

## README

# {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢

SvelteKit 最小“从地上学习和建造”模板 {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}嗯... 软件包导出 `copyTemplate()`, (中文(简体) ), `getTemplatePath()`,以及 `templateInfo` 这是 `sveltekit` 模板 `smrt gnode create`。 。 。 .

## 1\. 安装和运行

通过公共CLI的脚手架:

```bash
node --input-type=module -e "import { copyTemplate } from './packages/template-sveltekit/index.js'; copyTemplate('./my-app', { name: 'my-app' })"
cd my-app
pnpm install
cp .env.example .env
pnpm app:install
```

从单列波根运行复制命令 . `smrt gnode create --template=sveltekit` 使用同样的 `copyTemplate()` 输出.

所生成的项目需要node.js 26.0.0或更新和pnpm 11.25.0. 被钉住 全部直接使用 `@happyvertical/smrt-*` 包到当前单列波 发布,包括 opt- in MCP Apps 依赖性(在发布时提示) `scripts/sync-template-versions.mjs`· ; `--check` 探测到漂移.

`smrt gnode create <name> --mcp-apps` 已安装、 本地和 Git 支持 子目录模板。 插件名称必须满足被绑定的代理插件 1.0.0 世代开始前的计划. `smrt mcp-apps validate` 应用 正式关闭的插件/ MCP 计划下线, 然后是 s- m-r- t 端点和证书 检查。 现有的每一项范围登记指令都必须是 " 有条理的 " `#` 财务报告和审定财务报表 `;` 评论意见得到支持。 已成功创建的 MCP 缓存主机 进程认证器, 在请求中保留 JWKS 密钥, 同时 每项请求的主要决议和任务授权仍然有效.

方案脚手架:

```js
import { copyTemplate } from '@happyvertical/smrt-template-sveltekit';

copyTemplate('/absolute/path/to/my-app', {
  name: 'my-app',
  overwrite: false,
});
```

`copyTemplate()` 转换未覆盖的工程名称, 如 `my-app` 输入 运行时安全软件包身份 `@smrt-app/my-app`; 明确范围包 名称保留。 它还排除了软件包内部 `.svelte-kit` 测试 固定装置.

## 2\. 了解生成的文件

已选中的模板包含作者对象, 一个服务器模块 (单位:千美元)`src/lib/server/smrt.ts`,运行时间及其选项),细钩并 用于挂载软件包处理器、页面和配置的路径。 没有船 操作员脚本。 维特生成 `.smrt/manifest.json`, (中文(简体) ), `.smrt/smrt-knowledge.json`, (中文(简体) ), `.smrt/register.js`, (中文(简体) ), `src/lib/server/smrt-register.ts`, (中文(简体) ), `src/lib/types/smrt-generated/`,以及 `src/routes/api/**/+server.ts`全部被忽略和排斥在脚手架之外 固定装置.

`vite.config.ts` 实值 `plugins: [sveltekit(), smrt()]`页:1 `@happyvertical/smrt-core/vite` 预设应用装饰器转换、扫描 对象目录,生成本地路线和类型,并消耗 软件包 `smrt.config.ts` 清单 `consumer.packages` (档案,租赁, 用户). `@happyvertical/smrt-cli` 是一个直接的 dev 依赖,因为 生命周期脚本 `smrt app <operation>`。 。 。 .

## 3\. 定义第一个对象

一个没有对象的新应用船: `src/lib/objects/index.ts` 是一个空桶, 主页为空状态,没有注册或迁移.

Note 示例保存在模板外, 在 `examples/notes/`,作为一个 `src/`\- 形状树你可以复制到生成的应用程序中:

```bash
cp -r packages/template-sveltekit/examples/notes/src/. my-app/src/
```

它又说 `src/lib/objects/Note.ts` (带有产权和正文的必要租户对象) 字段,一个小符号 `NoteCollection` 保持生成的 CLI/MCP 运行时间 命令可构造,和 a `@smrt()` 显示 CRUD 的配置 REST、MCP、WebMCP定义和具有API可写授权列表的CLI)和a `/notes` 页 次 然后说:

1.  导出到 `src/lib/objects/index.ts`数字 : `export { Note, NoteCollection } from './Note.js';`
2.  链接 `/notes` 从 `nav` 阵列 `src/routes/+layout.svelte`。 。 。 .
3.  运行 `pnpm db:migrate`。 。 。 .

以同样的方式添加自己的对象. `vite.config.ts` 已经扫描 `src/lib/objects`。 。 。 .

## 4\. 数据库初始化或迁移

生成本地工程在当前用户的操作系统中使用 SQLite 默认的应用程序数据目录 :

```bash
pnpm db:migrate
```

脚本构建首先更新列表、注册、类型和 API 路线,然后运行 `smrt app migrate`,操作锁定并运行 `smrt db:migrate`。堕落者 `smrt db:setup` 命令为 未记录或未发运.

## 5\. 了解租户的背景

`src/hooks.server.ts` 挂载 `createSmrtSvelteKitRuntime()` 从 `@happyvertical/smrt-app-runtime/sveltekit`它解决了URL租户候选人 改为单独的 `selectedTenantId`编号 :`selectedTenantSlug` 当地人,不 从选择中建立查询上下文。 会话步骤继而进行 并且只有其会员授权的租户才进入s-m-r-t租赁范围.

不信任的租户头被忽略. 申请可以通过 `selectTenant` 页:1 路径,签名-cookie,或信任的出入口选择器,但选择必须保留 与授权分离,会话开关必须使用 `switchSessionTenant()`。 。 。 .

## 6\. 了解用户、简介、成员、角色和权限

生成的项目会消耗当前配置文件,用户会显示 通过运行时间加载已签名的会话, 仅输入租户语境 被证实为现役成员。 用户是认证 身份, 配置文件是个人化元数据, 成员加入一个用户到一个 租户和角色,角色地图,允许记录,会议出版 解析权限快照 .

示例页的表单动作要求 `assertOperationPermission()` 准确的说 示意图. 供应商专用登录和供应仍然是应用软件的扩展 点.

## 7\. 将数据装入SvelteKit页面

实例 `/notes` 页面载数 笔记行入 `+page.server.ts`,返回纯序列 数据,并声明 `depends('smrt:notes')`。斯维尔特5页读取水分 `$props()` 数据和电话 `invalidate('smrt:notes')` 在成功的形式之后 变相. 它不获取初始数据 `onMount` 或者说 `$effect`。 。 。 .

## 8\. 使用生成的REST、MCP、WebMCP和CLI接口

REST 路由生成于 `src/routes/api`. MCP和WebMCP描述符 来自相同的动作元数据。 CLI 命令可通过 已声明的 dev 依赖 :

```bash
pnpm smrt objects
pnpm smrt schema <YourObject>
pnpm smrt generate-mcp --no-config --no-readme
```

根布局连接生成的 `webMcpToolDefinitions` 以物配主者发誓, 因此,每个浏览器页面只默认暴露出已生成的读效模型工具. 写作和破坏效果需要明确的网页自选,以及所有 自定义动作通过它们被认证生成的 REST 路由执行 。 对a 较小的页面特定表面, 通过过滤 `definitions` 数组或使用 框架不可知性 `registerWebMcpTools()` API 来自 `@happyvertical/smrt-web`。 。 。 . 独家CLI的公开 `objects` 财务报告和审定财务报表 `schema` 命令在此工作 源首模板. 通过通用 CLI 执行本地对象 CRUD 还需要一个编译的 JavaScript 项目切入点.

## 9\. 添加可选的活浏览器数据

`@happyvertical/smrt-web` 包含在同步放行中,因为 根提供者加载生成的 WebMCP 定义。 没有单独的安装 需要WebMCP。 实时浏览器收藏仍为每页选择;导入 仅在需要交互式客户端数据的页面上提供收集帮助.

生成项目 README 显示当前水合模式 : `createSmrtCollection(getCollectionDefinition('notes'), { initialData, basePath: '/api' })` 接下来是 `liveCollection()`。根布局为 只读的WebMCP注册不会实现活集.

## 10\. 毕业后开始学习

使用此模板来学习和焦点化,地基化的应用程序. 选择 [`smrt-start`](https://github.com/happyvertical/smrt-start){\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}这只犬 应用程序模板,当您想要生产形状基线时。 这个包 故意避免成为第二个生产启动者.

生成的项目有一个峡谷 `runtime.profile` 和确定性 `app:*` 操作。 当地国家留在源外. 生产基准 使用适配器-节点,并包括一个容器外加单独的任务/计划工人; 编译需要操作员提供的数据库机密和云示例 描述提供者的组成,而不假装提供. 安装/启动/停止/恢复是本地标注的命令;已部署的网络进程 直接运行生产节点建造或容器.

每个支助的本地网络入口点(`app:start` 或者说 `pnpm dev`共享一个 写作员租借到源检出之外。 需要直接开始生产 明确的回转 `HOST`; 首选 `app:start`。文件系统备份和逻辑 导入失败在写入器存在时关闭; 逻辑导出读取每个模型 上传资产为 除外。 制作图像保留生成的显示和操作员 CLI 要求医生/进出口.

## 常见问题

### @happyvertical/smrt-template-sveltekit 是什么？

S-m-r-t框架集成的最小 SvelteKit 项目模板

### 如何安装 @happyvertical/smrt-template-sveltekit？

在项目目录运行 npm install @happyvertical/smrt-template-sveltekit，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：svelte（^5\.57\.1）、@sveltejs/kit（^2\.70\.3）、@happyvertical/sql（\>=0\.89\.12）、@happyvertical/smrt-ui（0\.62\.1）、@happyvertical/smrt-chat（0\.62\.1）、@happyvertical/smrt-core（0\.62\.1）、@happyvertical/smrt-jobs（0\.62\.1）、@happyvertical/smrt-types（0\.62\.1）、@happyvertical/smrt-users（0\.62\.1）、@happyvertical/smrt-agents（0\.62\.1）、@happyvertical/smrt-svelte（0\.62\.1）、@happyvertical/smrt-app-mcp（0\.62\.1）、@happyvertical/smrt-prompts（0\.62\.1）、@happyvertical/smrt-tenancy（0\.62\.1）、@happyvertical/smrt-inference（0\.62\.1）、@happyvertical/smrt-workflows（0\.62\.1）、@happyvertical/smrt-app-runtime（0\.62\.1）、@happyvertical/smrt-preferences（0\.62\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @happyvertical/smrt-template-sveltekit 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @happyvertical/smrt-template-sveltekit 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @happyvertical/smrt-template-sveltekit 可以商用吗？

@happyvertical/smrt-template-sveltekit 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @happyvertical/smrt-template-sveltekit 的下载量有多少？

根据 npm 官方下载统计，@happyvertical/smrt-template-sveltekit 在 2026/10/17 – 2026/11/15 这 30 天内被下载 14,644 次，日均约 488 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @happyvertical/smrt-template-sveltekit 还在维护吗？

最新版本 0\.62\.1 发布于 2026/11/17（今天）；至今共发布 365 个版本，其中过去 12 个月发布了 365 个；首次发布于 2026/06/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

