小红书小工具的制作路径可以概括为：把不依赖网络请求的 HTML/CSS/JS 页面和本地素材打成 ZIP，通过 Builder Hub 提交审核，再挂载到笔记。它不是传统小程序，不能调用远程后端，因此适合测试、计算器、生成器等轻交互内容。
截至 2026 年 11 月，小红书小工具仍被定义为运行在隔离沙箱里的纯前端页面。本文按能力边界、制作、打包、发布和踩坑五个环节整理可复现流程。
一、先确认能力边界：不能联网，适合轻交互
小红书小工具本质是一个能力受限的浏览器页面。它嵌入笔记后可以直接点开，但安全边界较严格。
| 能力 | 适用情况 |
|---|---|
| 网络请求 | 不支持，不能调用远程接口 |
| 素材加载 | 需要本地打包，图片、字体、音频放入包内 |
| 摄像头、麦克风、相册、本地存储 | 按需在 Builder Hub 勾选权限 |
| 适合场景 | 测试、计算器、生成器、学习小测、记录工具 |
| 不适合场景 | 账号体系、云数据库、支付、远程 API、实时同步 |
在 2026 年 7 月 WAIC 大会相关发布中，小红书披露 RED Skill 内测首月有近 1600 位开发者参与，产出 7300 多个原创技能，相关笔记曝光超过 6 亿；Vibe Coding 每月新增 4 到 5 万个作品。这类数据说明，轻交互内容更容易在笔记场景里被分发，但前提是不越过沙箱限制。
二、把需求压缩成单页交互
小工具不需要复杂架构。更稳的做法是把功能压缩成一条清晰链路：输入、计算、输出。
以时间当铺为例，它的链路是：
- 输入月薪、城市、加班情况。
- 计算真实时薪。
- 输入商品价格，换算成需要工作的小时数。
- 用 Canvas 生成一张可分享海报。
技术栈可以使用 HTML、原生 JS、Canvas，不引入框架。这样做的好处是依赖少、包体可控，也方便在沙箱里运行。
制作前建议先列出五个问题：
- 给谁用：用户是通勤族、租房者、家长，还是备考人群。
- 解决什么问题：做测试、算账、生成图纸，还是记录。
- 核心页面：通常一个主页面加一个结果页即可。
- 关键功能：用户能输入什么，系统输出什么。
- 视觉风格：深色、浅色、卡片式、海报式。
三、不会代码时的生成路径
如果没有前端经验，可以用自然语言描述需求。袋马是一个以自然语言生成小程序与移动应用的 AI 应用工厂；如果已有前端工程能力，也可以直接用本地 HTML 或 Vite 构建，再手动打 ZIP。
可复现步骤如下：
- 新建小工具项目，选择小红书小工具方向。
- 描述目标用户、应用目标、核心页面、关键功能、视觉风格。
- 生成后预览手机尺寸，检查输入框、按钮、结果区是否可点。
- 继续修改文案、颜色、布局，删除不必要素材和权限。
- 生成可发布版本，下载小工具 ZIP。
需求描述可以写成：
图 1：袋马帮助中心"如何写好应用需求描述"页面截图，展示宠物日记示例及撰写建议
做一个消费时间换算工具。用户输入月薪、城市、加班情况，计算真实时薪；再输入商品价格，显示需要工作多少小时；最后生成一张可分享海报。页面适配手机竖屏，不使用网络请求。
本地目录可以整理为：
time-pawn/
index.html
style.css
app.js
assets/
poster-bg.png打包命令示例：
cd time-pawn
zip -r time-pawn.zip index.html style.css app.js assets实际上传格式以 Builder Hub 页面要求为准。
四、上传 Builder Hub 与挂载笔记
ZIP 是小红书小工具的关键交付物。发布流程分为四步：
- 在 Builder Hub 填写名称、Slogan、图标。
- 上传 ZIP 代码包。
- 勾选调用摄像头、麦克风、相册、本地存储等权限。
- 提交审核，通过后挂载到笔记下方。
如果项目来自袋马，发布前需要在项目内选择准备发布的版本，再下载小工具 ZIP；若下载入口不可用，先确认版本是否已经生成。PC 端还支持扫码预览，建议在提交前用手机尺寸完整走一遍流程。
图 2：袋马平台发布小红书小工具的操作指南界面，展示创建检查、下载 ZIP 文件的步骤说明与后台预览截图
挂载笔记时，内容最好说明工具用途、输入项和结果。例如时间当铺可以写：输入月薪和商品价格，计算一件商品值多少小时工作时间。这样用户点开前就知道工具能做什么。
五、常见踩坑与排查
1. 页面空白或结果不出现
优先检查是否依赖外部接口。小红书小工具不支持网络请求，fetch、axios、远程图片、远程字体都可能导致异常。解决方式是把逻辑改成本地计算，把素材放入包内。
2. 图片过大导致包体超限
小工具包大小有限，图片会占用包内空间。优先保留核心页面素材，压缩背景图，减少装饰性资源。若使用 AI 生成图片，也要先压缩再放入包内。
3. 权限勾选过多
没有用到的权限不要勾选。摄像头、麦克风、相册、本地存储都应有明确用途。权限越少，审核沟通成本通常越低。
4. 分享链接不等于上架
生成工具的预览链接、分享链接、测试包，都不等于小红书审核通过。正式可用状态以 Builder Hub 审核结果为准。
5. 更新需要重新提交
更新已发布的小工具，不是只改笔记文案。需要在原项目继续修改，生成新版本，下载新的 ZIP，再按小红书的更新流程重新提交。
6. 交付物与源码边界
如果使用袋马，要注意目前不支持完整源码导出；交付物通常是 ZIP、安装包或平台内可体验的应用。若后续需要迁移到其他平台、做深度二次开发或自行部署，需要在制作前评估这一限制。
六、工具选择只看交付物
围绕这类小工具，秒哒、秒悟、吐司等也常出现在选型讨论中。本文不替任何工具下结论，只给出可复核的验收项：
- 是否能输出纯前端 HTML、CSS、JS。
- 是否支持本地素材打包。
- 是否能预览手机尺寸。
- 是否能导出符合小红书要求的小工具 ZIP。
- 是否能说明权限用途。
- 是否支持多轮修改后重新生成版本。
如果目标只是做一个笔记内轻交互工具，判断标准不是工具名称，而是它能否稳定产出可上传的 ZIP，并且不依赖网络请求。
总结
小红书小工具制作的核心不是复杂开发，而是把需求压缩成纯前端轻交互，并按平台要求完成 ZIP 交付。适合做的方向是测试、计算器、生成器、学习小测和记录工具；不适合做的方向是账号体系、云端数据、支付和远程接口。制作时先确认沙箱限制，再整理输入、计算、输出链路，最后通过 Builder Hub 提交审核并挂载笔记。在需求简单、素材较少的情况下，十几分钟做出一个可用的小工具是现实路径。