aiagent/docs/天工虚拟团队演示项目.md

天工虚拟团队演示项目

记录由「天工虚拟团队 / 虚拟公司」能力生成、并经人工完善打磨的演示项目。 每个项目一节,含路径、技术栈、端口、核心功能、完善记录与启动方式,便于演示与复用。

最后更新:2026-07-13(收录:Framework 知识管理软件、渭南「今天吃啥」、家庭阅读激励工具、家庭泡饮制作助手)

---

1. Framework 知识管理软件

结构化的「框架知识库」:按 框架 → 分类(可多级) → 条目 组织,支持 Markdown 编辑与全文检索。适合沉淀某个技术框架/领域的结构化知识。

基本信息

项	内容
生成方式	天工虚拟公司(Company-context)生成,上下文为 Framework + SQLite + 部门协作
项目路径	D:\workspace\aiagent\team_projects\b9b14925-f054-43d0-b2f0-6ed6b38dbe4b\Company-context-Framework-SQLite--Depart
前端	Vue 3 + Pinia + Vite,dev 服务器 http://localhost:3000
后端	FastAPI + SQLite,http://127.0.0.1:8080(API 前缀 /api,文档 /docs)
数据库	项目根目录 framework.db(SQLite,WAL 模式)
定位	本地单机工具(不做鉴权/多租户)

核心功能

• 框架 / 分类(支持多级子分类)/ 条目 全 CRUD;行内重命名
• Markdown 编辑器:编辑/分屏/预览三模式;格式工具栏(粗体、标题、列表、引用、代码、链接、表格等);图片粘贴/上传(转 base64 内嵌);Ctrl+S 保存
• 全文检索(SQLite FTS5,BM25 排序 + 高亮片段)
• 标签管理与侧栏标签筛选
• 知识树拖拽:条目同分类内重排、跨分类移动、分类同层级重排
• 数据 导入 / 导出(JSON)
• 深色 / 浅色主题切换(Catppuccin Mocha / Latte,记忆到 localStorage,可跟随系统)
• Toast 通知 + 自定义确认框(已替换原生 confirm/alert)

完善记录(2026-07 人工打磨)

• 安全:修复存储型 XSS —— 所有 v-html 渲染经 src/utils/sanitize.ts(DOMPurify)消毒
• Bug:修复切换条目时把旧编辑串写进新条目导致的数据丢失
• 工程:修复生产构建脚本(build 改为 vite build,类型检查另置 typecheck),npm run build 可正常出产物
• 体验:引入 toast + Promise 版确认框;切换框架不再闪屏;新建条目后自动展开所属分类
• 功能:知识树拖拽排序/移动;Markdown 工具栏 + 图片粘贴上传;后端补 language 字段持久化

启动方式

详见项目根目录 启动说明.md。要点(Git Bash,两个终端):

1. 后端(:8080)—— 必须用 aiagent 的 venv Python(系统 Python312 没装 uvicorn):

cd "D:/workspace/aiagent/team_projects/b9b14925-f054-43d0-b2f0-6ed6b38dbe4b/Company-context-Framework-SQLite--Depart"
/d/workspace/aiagent/backend/venv/Scripts/python.exe -c "
import importlib.util, uvicorn
spec = importlib.util.spec_from_file_location('integration_config', '01-integration-config.py')
m = importlib.util.module_from_spec(spec); spec.loader.exec_module(m)
uvicorn.run(m.app, host='127.0.0.1', port=8080, log_level='info')
"

2. 前端(:3000):

cd "D:/workspace/aiagent/team_projects/b9b14925-f054-43d0-b2f0-6ed6b38dbe4b/Company-context-Framework-SQLite--Depart"
npm run dev

3. 访问:http://localhost:3000/

备注

• 前端 /api 经 Vite 代理转发到后端 :8080(见 vite.config.ts),生产 dist/ 本身不含该代理。
• 相关记忆:项目定位「本地单机工具」、v-html 必须消毒(见 auto-memory project_framework_km_app.md)。

---

2. 「今天吃啥」渭南家常菜推荐助手

面向家庭日常的「今天吃啥」推荐工具,专治「每天不知道午晚餐做什么」。内置 69 道陕西渭南口味家常菜,一键推荐、换一批、生成一周菜单与买菜清单。纯前端 + 本地 JSON 数据,离线可用(PWA)。

基本信息

项	内容
生成方式	天工虚拟公司「西安瑞来兹软件科技有限公司」生成(上下文 HTML/CSS/JS + JSON + 60UI + 部门协作)
实现路径	D:\workspace\aiagent\team_projects\b9b14925-f054-43d0-b2f0-6ed6b38dbe4b\Company-context-HTMLCSSJSJSON60UIDepartm
设计路径	D:\workspace\aiagent\team_projects\afc033d4-a781-4bad-a495-0c30a6807ea2\Company-context-HTMLCSSJSJSON60UIDepartm(菜品数据表、线框图、高保真原型)
公司工作区	backend\company_projects\457441b0-7ed3-4948-843a-5d5b6dfc7c01
技术栈	原生 HTML + CSS + JavaScript(无框架),数据 dishes.json;PWA(manifest.json + sw.js)
数据	dishes.json 共 69 道菜,字段:id / 菜名 / 分类 / 类型 / 食材 / 做法 / 耗时分钟 / 标签
定位	本地单机 / 离线优先,无后端、无鉴权

核心功能

• 今天吃啥:一键随机推荐一道(可按午/晚、荤素、耗时等筛选)
• 换一个 / 换一批:不满意即刻重摇
• 一周菜单:自动排布 7 天午晚餐,避免近期重复
• 买菜清单:按选中菜品聚合食材,生成采购清单
• 收藏:标记常做/爱吃的菜
• 忌口 / 不再推荐:屏蔽不吃的菜,后续不再出现
• PWA:可「添加到主屏幕」,断网仍可用(sw.js 缓存)

启动方式

纯静态站点,任意静态服务器即可(数据为本地 dishes.json,fetch 需经 HTTP,不能直接 file:// 打开):

cd "D:/workspace/aiagent/team_projects/b9b14925-f054-43d0-b2f0-6ed6b38dbe4b/Company-context-HTMLCSSJSJSON60UIDepartm"
python -m http.server 5500
# 浏览器打开 http://localhost:5500/

备注

• download_images.py / generate_icons.py 为辅助脚本(下载菜品图、生成 PWA 图标),非运行时依赖。
• 相关记忆:菜谱偏渭南口味 + 极简交互(见 auto-memory user_family.md);菜品图可从下厨房批量扒取(xiachufang_dish_images.md)。

---

3. 家庭阅读激励工具(孩子阅读打卡)

儿童(5-8 岁)阅读习惯养成 App:孩子三步拍照打卡赚积分(星星),家长端一屏管理多个孩子、自定义积分规则、上架实物奖品并审批兑换。核心定位为行为设计工具而非内容平台。

基本信息

项	内容
生成方式	天工虚拟公司「西安瑞来兹软件科技有限公司」生成(上下文 SQLite + Flutter/React Native + 部门协作)
项目路径	D:\workspace\aiagent\team_projects\afc033d4-a781-4bad-a495-0c30a6807ea2\Company-context-SQLiteFlutter-React-Nati
当前状态	设计/文档阶段产物(PRD、竞品分析、积分引擎、设计系统、线框图、高保真原型、内测脚本),尚无可运行代码
目标技术栈	跨平台 Flutter / React Native + 本地 SQLite(纯本地存储、离线优先)
定位	纯本地存储,零隐私风险,无需登录/注册,照片存本地沙盒

双角色模型

• 儿童端(Reader,5-8 岁):拍照打卡、查看积分/进度、浏览奖品并申请兑换、角色互动;单次使用 ≤30 秒
• 家长端(Manager,28-40 岁):多孩子一屏管理、审批兑换、自定义积分规则、奖品库存管理、数据统计

核心功能(MVP,摘自 PRD 功能矩阵 F01–F54)

• 打卡:拍照 3 步闭环 + 成功动画/音效、重复打卡拦截、拍照预览重拍、打卡日历热力图
• 积分:大数字展示 + 进度条、连续打卡火焰标记、完整积分流水、手动加减分、规则查看、基础分/连续加成配置、规则变更不追溯
• 奖品:商店浏览 + 够/不够标识、详情弹窗兑换、家长添加/编辑奖品与库存(快速 ±1)、按奖品独立审批开关
• 兑换:申请创建 + 积分冻结(pending)、待审批列表角标、审批含库存二次校验、拒绝退还积分、发放状态标记、兑换记录
• 孩子管理:添加(初始化向导)、编辑、全局常驻切换器
• 系统:双模式入口(单击进儿童端 / 长按 3 秒进家长端)、本地存储隐私承诺、卡通角色 App 图标

差异化壁垒(基于 6 款竞品分析)

1. 实物奖品兑换闭环(拍照打卡→积分→兑换→库存扣减)——竞品完全空白
2. 纯本地 + 离线优先(零隐私风险)——完全空白
3. 多孩子一屏管理(顶部切换器全局常驻)——仅 Beanstack 半覆盖
4. 家长 100% 自定义积分规则——完全空白

备注

• 目录内主要为 Markdown 设计文档 + 08-设计系统Token清单.css;无前端/后端可运行代码,如需上线仍待 Flutter/RN 工程实现。
• 关键文档:08-PRD完整产品需求文档.md、04-积分规则引擎与奖品兑换体系设计.md、08-高保真UI设计系统与页面规范.md、10-高保真交互原型与动效标注.md、09-内测验证测试脚本.md。

---

4. 家庭泡饮制作助手

面向家庭日常的「饮品菜谱」工具——像菜谱一样,不过做的是喝的。内置 59 款家庭饮品,每款含配料清单、分步做法、真实照片,以及「饮品档案」(作用 / 口感 / 特点 / 适宜人群 / 不适宜人群 / 产地)。纯前端单文件,双击即用、离线可看。含渭南/陕西本地特色(富平柿饼、临潼石榴、关中油茶、陕西杏皮茶)与「补血养气」专区。

基本信息

项	内容
生成方式	天工虚拟公司「西安瑞来兹软件科技有限公司」生成(上下文 HTML/CSS/JS + JSON + UI + 部门协作),Phase3 产物整合打磨
成品路径	D:\workspace\aiagent\deliverables\家庭泡饮制作助手\(可直接使用的成品)
技术栈	原生 HTML + CSS + JavaScript(无框架),数据内联 DRINKS_DATA(与 drinks.json 同步),真实图片 images/
数据	内联 DRINKS_DATA 共 59 款,字段:id / name / category / subcategory / description / prepTime / difficulty / servings / ingredients / steps / tags / seasonal / profile
图片	images/drink-001.jpg ~ drink-059.jpg 共 59 张真实照片(从下厨房按名抓取);加载失败自动降级为分类 emoji
定位	本地单机 / 离线优先 / 自包含单文件,无后端、无鉴权

数据分类(59 款)

• 咖啡 6 · 茶饮 6 · 果汁 6 · 奶茶 5 · 气泡饮品 5 · 养生饮品 20 · 奶昔冰沙 6 · 特调饮品 5
• 养生饮品最全:含花草茶(菊花枸杞、玫瑰、洛神花等)、滋补茶、暖饮,以及补血款(五红补血汤、阿胶红枣枸杞茶、红糖姜枣茶、桑葚枸杞饮、甜菜根胡萝卜苹果汁、黑芝麻核桃糊)

核心功能

• 分类浏览:首页 8 大分类卡片(动态计数),点入看该类全部饮品
• 补血养气推荐:首页顶部横滑专区,按 补血 标签自动收集(贫血 / 气血不足 / 经期调理)
• 搜索:全局模糊搜索(名称、食材、标签、分类、简介),下拉即时结果
• 筛选:按标签(chips)、难度多维筛选
• 收藏:标记常喝的饮品(localStorage 记忆)
• 详情页:大图 Hero、元信息条、配料清单(可勾选)、分步做法、饮品档案(作用/口感/特点/适宜/不适宜/产地)、同分类推荐
• 真实照片 + 优雅降级:每款配下厨房真图,onerror 失败回退分类 emoji,不留空白

完善记录(2026-07 人工打磨)

• 整合成品:把虚拟公司 Phase3 的 index.html + drinks.json 整合到干净目录,修复原纯 emoji 卡片不显示图片的问题(注入 card-photo / detail-hero-photo)
• 真实图片:download_images.py 从下厨房按饮品名抓取 59 张真图,images/{id}.jpg
• 扩充内容:从 20 款扩到 59 款——补花草茶、陕西/渭南本地特色、补血专题,并各分类均衡补充
• 饮品档案:为全部 59 款补充 6 项档案字段,详情页新增「🏷 饮品档案」卡片
• 首页专区:新增「🩸 补血养气推荐」横滑卡片(数据驱动,加补血款自动出现)
• 数据一致性:所有改动同步 index.html 内联 DRINKS_DATA 与 drinks.json,分类 count 按数据自动重算;修复原 drinks.json 一处非法半角引号

启动方式

自包含单文件,数据已内联,直接双击打开即可(图片为相对路径,file:// 下正常显示):

D:\workspace\aiagent\deliverables\家庭泡饮制作助手\index.html

如需以 drinks.json 为数据源调试,可起静态服务器:

cd "D:/workspace/aiagent/deliverables/家庭泡饮制作助手"
python -m http.server 5501
# 浏览器打开 http://localhost:5501/

备注

• download_images.py(抓图)、add_flower_teas.py / add_batch2.py / add_profiles_and_anemia.py / add_batch4.py(历次数据注入脚本)均为辅助脚本,非运行时依赖。
• 相关记忆:偏渭南口味 + 极简交互(见 auto-memory user_family.md);菜品/饮品图可从下厨房批量扒取(xiachufang_dish_images.md)。