stealthis (Foodhy)

StealtThis.dev

StealtThis.dev是一个Bun工作区单仓库，用于可重用web实现的开源资源库：

• 展示网站(www)用于浏览和复制资源
• 文件网站(docs)使用星光向导
• 全屏演示运行器(lab)用于可运行的片段
• 项目图形浏览器(build)用于规划实施
• 数据库可视化工具(dbviz)用于关系模式命令和图表
• MCP服务器(mcp)将目录暴露给AI工具
• 远程移动应用(remotion)用于动画/视频合成

资源内容的规范来源存在于 packages/content/resources//.

网站本地化

apps/www 当前公开了这些本地化路由：

• en --英语
• es --西班牙语
• fr --法语
• ja --日语
• ms --马来语
• hi --印地语
• ko --朝鲜语
• nl --荷兰语
• de --德语
• pt-br --巴西葡萄牙语
• zh-hk -繁体中文（香港）
• zh-cn --简体中文（中国）
• it --意大利语
• pl --波兰语
• uk --乌克兰语

浏览器区域设置检测也会映射 UA 用户到 uk.

Monorepo结构

.
├── apps
│   ├── www        # Astro 5 showcase + library
│   ├── docs       # Astro + Starlight docs
│   ├── lab        # Full-screen demo runner (iframe srcdoc)
│   ├── build      # Astro + React graph builder
│   ├── dbviz      # Astro + React database visualizer
│   ├── mcp        # Hono + Cloudflare Worker MCP server
│   └── remotion   # Remotion compositions
├── packages
│   ├── content    # Source-of-truth resources and docs
│   ├── schema     # Zod schema + loaders/types
│   └── config     # Shared tsconfig/tailwind presets
└── scripts        # Import + vendor sync utilities

技术栈

• Bun工作区
• Astro 5（多应用程序）
• 星光（文档）
• React（构建器/远程集成）
• 顺风CSS
• Hono+牧马人（MCP的Cloudflare Worker）
• Zod+灰质+快速glob（内容模式/加载）
• 生物特征（绒毛/格式）

本地先决条件

• 包子 安装
• Wrangler/Remotion工具的节点兼容环境

快速开始

# from repo root
bun install

独立运行任何应用程序：

bun run dev:www      # http://localhost:4321
bun run dev:docs     # http://localhost:4322
bun run dev:lab      # http://localhost:4323
bun run dev:build    # http://localhost:4324
bun run dev:dbviz    # http://localhost:4327
bun run dev:mcp      # http://localhost:8787 (Wrangler)
bun run dev:remotion # http://localhost:4325

根脚本

# development
bun run dev:www
bun run dev:docs
bun run dev:lab
bun run dev:build
bun run dev:dbviz
bun run dev:mcp
bun run dev:remotion

# builds
bun run build         # www + docs + lab + build + styleforge + dbviz + mcp
bun run build:www
bun run build:docs
bun run build:lab
bun run build:build
bun run build:dbviz
bun run build:mcp
bun run build:remotion

# quality
bun run lint
bun run format

# content/catalog tooling
bun run sync:vendor
bun run import:examples
bun run --filter @stealthis/mcp catalog

生产URL

• 主要地点： https://stealthis.dev
• 文件： https://docs.stealthis.dev
• 实验室： https://lab.stealthis.dev
• 建设者： https://build.stealthis.dev
• DBViz： https://dbviz.stealthis.dev
• MCP： https://mcp.stealthis.dev/mcp

资源内容模型

每个资源都是一个自包含的文件夹：

packages/content/resources//
├── index.mdx
└── snippets/
    ├── html.html
    ├── style.css
    ├── script.js
    └── react.tsx (optional, plus other targets)

如果实验室中出现资源：

• 集 labRoute: // 在前线
• 提供 html.html, style.css，以及 script.js

支持的类别ID：

• web-animations
• web-pages
• ui-components
• patterns
• components
• pages
• prompts
• skills
• mcp-servers
• architectures
• boilerplates
• remotion

添加新资源

1. 创建 packages/content/resources//index.mdx 有有效的封面。
2. 在中添加片段 packages/content/resources//snippets/.
3. 如果可以在实验室中运行，请添加 labRoute 并包含HTML/CSS/JS代码片段。
4. 重新生成MCP目录：

bun run --filter @stealthis/mcp catalog

1. 验证：

bun run lint
bun run build:www
bun run build:lab
bun run build:mcp

模式+消费者对齐

如果添加/重命名类别/类型/目标字段，请保持这些字段同步：

• packages/schema/src/schema.ts
• packages/schema/src/types.ts
• apps/www/src/content/config.ts
• apps/www/src/i18n/index.ts （标签/过滤器）

MCP服务器

MCP Worker为生成的目录提供服务(apps/mcp/src/catalog.json)建造于 packages/content.

重要命令：

# regenerate catalog after content changes
bun run --filter @stealthis/mcp catalog

# local worker
bun run dev:mcp

# validate worker bundle
bun run build:mcp

主要终点：

• POST /mcp （MCP JSON-RPC传输）
• GET /tools/list_resources
• GET /tools/get_resource/:slug
• GET /tools/get_snippet/:slug/:target
• GET /tools/search?q=...
• GET /tools/get_lab/:slug

工作区注释

• 不要在中编辑生成的输出 dist/.
• 更喜欢重用来自的共享模块 packages/schema 和 packages/config.
• 在monorepo中使用Bun命令（项目标准）。
• 对于特定于应用程序的文档：

- apps/mcp/README.md - apps/remotion/README.md

部署（Cloudflare）

当前部署工作流使用：

• Cloudflare页面 www, docs, lab, build
• Cloudflare员工 mcp

参考命令记录在 COMMANDS.md.

存储库运行状况检查

对于本地开发启动后的路由/UI烟雾测试：

curl -s -o /dev/null -w "%{http_code}" http://localhost:4321/
curl -s -o /dev/null -w "%{http_code}" http://localhost:4321/library
curl -s -o /dev/null -w "%{http_code}" http://localhost:4323/
curl -s -o /dev/null -w "%{http_code}" http://localhost:4323//

许可证

资源默认为 MIT 通过frontmatter元数据。\ 如果您需要存储库范围的许可证，请添加顶级许可证 LICENSE 文件。