{\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 页 次 然后说:
- 导出到
src/lib/objects/index.ts数字 :export { Note, NoteCollection } from './Note.js'; - 链接
/notes从nav阵列src/routes/+layout.svelte。 。 。 . - 运行
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
要求医生/进出口.