@happyvertical/smrt-template-sveltekit

中文文档
0.62.1发布于 2026/11/17MITTypeScriptES Module近 30 天下载 1.5万

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

中文使用文档
文档目录10 节
  1. 1. 安装和运行
  2. 2. 了解生成的文件
  3. 3. 定义第一个对象
  4. 4. 数据库初始化或迁移
  5. 5. 了解租户的背景
  6. 6. 了解用户、简介、成员、角色和权限
  7. 7. 将数据装入SvelteKit页面
  8. 8. 使用生成的REST、MCP、WebMCP和CLI接口
  9. 9. 添加可选的活浏览器数据
  10. 10. 毕业后开始学习

{\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的脚手架:

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 密钥, 同时 每项请求的主要决议和任务授权仍然有效.

方案脚手架:

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/- 形状树你可以复制到生成的应用程序中:

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 默认的应用程序数据目录 :

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 依赖 :

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{\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 共发布 365 个版本,首次发布于 2026/06/23;过去 12 个月发布了 365 个版本。

版本发布日期距今
0.62.1latest2026/11/17今天
0.62.02026/11/17今天
0.61.62026/11/161 天前
0.61.52026/11/161 天前
0.61.42026/11/161 天前
0.61.32026/11/152 天前

关于 @happyvertical/smrt-template-sveltekit 的常见问题

@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 和提交记录判断。