智体工厂

Advanced

做出第一个应用之后:
进阶三日课

入门营教会你"做一个能用的";这门课教你"做好、管住、团队一起用"。 三个模块各半天到一天,全部以你自己的业务应用为实战对象。

建议先完成入门 5 小时 可自学可跟课 产出:可团队共用的应用 + 运维手册
MODULE A

多实体关联设计

半天

单实体的应用撑不起真实业务——"招聘需求"和"候选人"和"面试评价"是三种东西。 这半天教你把业务拆成正确的实体,并让它们正确地连起来。

你会学到

  • · 实体识别:一句话需求里藏着几个"东西"
  • · 关系建模:一对多、多对多怎么选
  • · 字段设计:类型、必填、状态枚举
  • · 视图映射:什么实体配列表,什么配看板

活教材

HR 招聘后台:招聘需求 ↔ 候选人 ↔ 面试评价,三实体两条一对多关系,五个视图各司其职。

打开这个教材

动手练习

把你入门营做的单实体应用升级为双实体:画出实体关系,写下各自字段清单,然后让智能体实现,对照设计查漏。

高频错误(课上重点拆)

把"状态"做成实体 · 一个字段塞多件事("周五下午3点例会"塞进一个文本框) · 关系方向搞反(应该是"评价属于候选人"而不是反过来) · 实体拆太碎(8 个实体的第一版基本都做不完)。

MODULE B

数据迁移与版本管理

半天 · 场景 C 实战

业务一定会长,应用一定得改。这门课的核心问题只有一个:大改版本时,已录入的数据怎么办? 这正是四场景里最容易被忽略、也最伤人的"场景 C"。

你会学到

  • · 冻结旧版:自动生成 freeze_v0.x.html,旧数据永远可回
  • · 迁移函数:旧字段 → 新字段的映射写法
  • · 版本号语义:什么时候升 0.x,什么时候升 1.0
  • · CHANGELOG:每次改动记什么、怎么记

活教材

完整演练文档里的场景 C:HR 招聘后台从 v0.3 推翻重做到 v1.0,老数据一条不丢地迁过来。

读场景 C 演练

动手练习

在你的应用里故意做一次破坏性改动(加必填字段 + 改字段名),先录 5 条数据,再用场景 C 流程迁移,验证零丢失。

黄金规则(课上反复强调)

任何大改之前:先导出一次 JSON 备份,再让智能体冻结旧版。有后路,才敢大改。

MODULE C

团队共用与部署

一天

应用做出来只是开始——放到团队里真用起来,要解决"怎么发给大家、数据怎么汇总、以后谁维护"三件事。 单文件应用天生轻,但要用对方法。

方案 怎么发 数据汇总 适合
① 文件直发微信/邮件发 HTML 文件,各自双击各自导出 JSON,一人合并3-5 人小团队起步
② 内网静态托管放到 IIS / Nginx / 内部文件服务器同 ①(数据仍在各浏览器)有 IT 的企业,统一入口
③ 云静态托管Vercel / 对象存储静态页面同 ①;异地可访问分散团队 / 需要外网访问

你会学到

  • · 三种部署方案的操作步骤与取舍
  • · 数据"各自录、定期并"的协作流
  • · 备份与恢复:导出的 JSON 怎么管
  • · 安全边界:什么数据适合放这类应用

活教材

会议纪要管理:行动项看板天然适合"各自认领、每周合并"的协作模式;设置页内置数据导出就是为这一课准备的。

打开这个教材

动手练习

把你的应用发给一位同事真用三天;收集 TA 的三条反馈改一版;写一页《团队使用说明》(发放方式/录入规则/汇总周期)。

Outcome

三天之后,你手里有什么

  • 一个双实体以上、团队正在用的业务应用
  • 一套数据迁移与版本管理操作手册
  • 一份团队分发与数据汇总方案
  • 《团队使用说明》一页纸

两种上法

自学:按上面三个模块做练习,卡住查帮助知识库或做找茬练习练手感;
跟课:进阶班随每期内训后开,也可按月陪跑——团队真用起来的问题,现场拆。

Help Center

帮助知识库

学员在家做作业时最常问的 19 个问题,按四类整理。输入关键词即时过滤——没找到的,微信直接问。

安装与启动 · 5 条

Demo 双击打不开 / 打开是乱码?

优先用 Chrome 或 Edge 打开;确认下载的是完整 index.html(40-55 KB),微信传输时选"文件"而不是压缩图。仍乱码时右键 → 打开方式 → 选择浏览器。

Skill 拷进去了,Codex 不识别?

三个检查点:① 拷贝的是整个 business-assistant-agent/ 文件夹,不是里面的散文件;② 路径在 .codex/skills/ 下(Windows:C:\Users\你的用户名\.codex\skills\);③ 拷完重启 Codex。仍不行就对它说「你现在有哪些 Skill」排查。

使用时需要一直联网吗?

生成阶段需要网络;生成好的应用首次打开会加载一次 CDN 样式,之后浏览器有缓存,断网也能正常使用。数据从来不上传。

手机上能用这些应用吗?

可以。所有应用都做了移动端适配(导航收进汉堡菜单、表格可横滑)。把 HTML 文件发到手机浏览器打开即可;但生成/修改应用建议在电脑上做。

用什么浏览器最好?

Chrome / Edge 最新版最佳,Safari 与 Firefox 也支持。不建议 IE 和老旧内嵌浏览器(政务系统内置的那种)。验收前记得看控制台无报错(F12)。

数据与安全 · 5 条

我录入的数据存在哪里?

存在你自己浏览器的 localStorage 里——不上传任何服务器,我们和工具厂商都看不到。同一台电脑同一浏览器下持续有效。

换电脑 / 换浏览器,数据怎么迁?

旧电脑:设置页 → 导出数据(得到 JSON);新电脑:打开同一个应用文件 → 设置页 → 导入。注意要在同一浏览器里操作,导出的 JSON 建议按日期命名存档。

清理了浏览器数据,记录全没了?

"清除浏览器数据"会清掉 localStorage——这正是我们反复强调定期导出的原因。养成习惯:每周五导出一次 JSON;升级应用版本前必导出。

多人可以同时用一个应用吗?

可以分发、不能实时同步:每人双击各自使用,数据各存各的;按约定周期各自导出,由一人合并(进阶课模块 C 专门教这套协作流)。需要实时多人的场景属于定制开发范畴。

敏感数据(薪酬、身份信息)能放吗?

因为数据只存本地、不经服务器,这类应用其实是涉密场景的优选之一;但请注意:录入内容会经过 AI 工具生成界面——涉密信息建议只在"最终应用"里录,不要把涉密内容写进需求描述。

生成与迭代 · 5 条

生成到一半断了 / 卡住了?

别重开对话!直接说"从刚才断掉的地方继续"。已生成的部分都在。预防:一次只让它做一个视图(先列表页,再看板),小步生成不容易断。

改需求会把已录的数据弄丢吗?

按四场景走就不会:小改(字段增删)走场景 A,会自动写数据迁移;推翻重做走场景 C,先冻结旧版再迁移。记住口诀:大改之前,先导出备份。

怎么让它生成的页面符合我要的风格?

给参照,别给形容词。发一个你喜欢的网站链接让它"参照这个风格";或说具体要素:留白多、细边框、主色 #2456F6、数字用等宽字体。"大气一点"这类词它只能猜。

生成得很慢,有办法提速吗?

两个习惯:① 需求一次说清,减少来回;② 拆小任务——"先做列表页"比"把整个系统做了"快得多也更稳。首次生成慢是正常的,迭代会快很多。

怎么看当前是哪个版本?怎么回退?

应用设置页显示当前版本号;每次改动应记入 CHANGELOG。回退:场景 C 会自动保留 freeze_v旧版本.html,双击旧文件即回到老版本(数据各自独立,注意先导出)。

团队与部署 · 4 条

怎么把应用发给同事用?

最简单:微信/邮件直接发 index.html 文件,对方双击即用。注意微信发送选"文件"方式;后续你改了版本,重发一次文件即可(提醒对方先导出自己的数据再换新文件)。

能在公司内网统一部署吗?

能,而且很简单:把 index.html 放到任意静态文件服务(IIS 默认站点 / Nginx / 内部文件服务器),全公司用同一个网址打开。内网部署不影响数据存储方式(仍在各自浏览器)。

每个人录的数据,怎么汇总到一处?

标准流程:约定周期(如每周五)各自在设置页导出 JSON → 发给汇总人 → 汇总人在自己的应用里逐份导入。10 人以内团队这套流程完全够用;更大的数据流需求属于定制范畴。

培训结束后,谁来维护这些应用?

这正是我们设计培训的初衷:会提需求的人自己维护。结课 30 天内微信群免费答疑;之后可选择按月陪跑(讲师定期复盘 + 疑难处理),也可以完全自主。

这里没有你的问题?直接问

加微信 18235156686,备注「提问」, 学员的问题我们都会回,高频问题会持续补进这个知识库。

进阶路上卡住了?备注「进阶」来找我

加微信 18235156686,备注「进阶」, 免费领《进阶实战手册》(实体关系画法 + 场景 C 检查单 + 部署方案对比表)。学到哪一步卡住,直接发截图问。