MetaLog 作品使用手册

# MetaLog · 念头日志冲突后的元认知复盘工具（手机优先 Web App）by **metahuman lab**。情绪上来时先冷静，用 3 道题对齐事实与念头，再经疏导对话生成复盘卡——看见自己的思维模式，并得到下次可以怎么说。适用于 **外滩大会 2026 · 阿里云百炼 / Model Studio** 参赛方向。 --- ## 在线体验（评审请用此链接） **https://ironnn314159-d9g3mjnpe99f88a82-1464523475.tcloudbaseapp.com** - 推荐：**手机浏览器**打开（也可桌面缩小窗口） - **无需登录**、无需注册、无需评委自行配置 API Key - 核心链路可直接点开体验；疏导与复盘卡由阿里云百炼（通义）生成 - 若页面像旧版，请无痕窗口或强制刷新（CDN 可能缓存数分钟） **作品使用手册（单独页，提交表单可填）：** https://ironnn314159-d9g3mjnpe99f88a82-1464523475.tcloudbaseapp.com/handbook/ **公开仓库：** https://gitee.com/ironnn23333/metalog --- ## 作品使用手册本手册供评审与体验者按步骤走通核心功能。完整体验约 **3–5 分钟**。 ### 1. 打开应用 1. 用手机浏览器访问上方体验链接 2. 首页看到 **MetaLog / 念头日志** 3. 点 **开始复盘** 底部也可进入「我的模式」「关于」。 ### 2. 冷静（约 45 秒）进入复盘后先进入冷静页：倒计时引导深呼吸，**先别回消息**。倒计时结束后点 **开始问答**（也可在倒计时中直接开始）。 ### 3. 三道事实题（一题一题答） | 顺序 | 问题 | 怎么填 | |------|------|--------| | 1 | 这次主要跟谁有关？ | 选关系对象；选「其他」时补一句说明 | | 2 | 发生了什么？ | 尽量写客观事实，少写评价；支持文字，也可语音/图片辅助 | | 3 | 当时的情绪和念头？ | 填情绪/身体感受，以及脑子里当时认定了什么 | 填完后点 **进入疏导**。 ### 4. 疏导对话 - 助手会先接住你的处境，再做轻量分析，并抛出一个由你主导的问题 - 像聊天一样回复即可（支持多轮） - 用户说满约 **3 轮**后，会出现分叉： - **生成复盘卡**：进入下一步 - **再聊一会**：继续疏导；之后仍可随时点生成 - 也可在对话过程中主动点 **生成复盘卡** ### 5. 复盘卡生成后会看到一张结构化复盘卡，常见内容包括： - 共情开场 - 事实摘要 - 可能的认知模式标签（假设，**不是诊断**） - 可能被忽略的并行因素 - 下次可尝试的 3 句话（可复制） - 给自己的一句 meta 提示可操作： - **保存**：写入本机浏览器（localStorage） - **导出图片 / 复制文本**：便于分享或留档 - 返回疏导继续聊，或回首页 ### 6. 我的模式首页 → **我的模式**：查看本地历史复盘次数、关系分布、高频认知标签等轻量统计。第一次复盘前这里为空，属正常。 ### 7. 关于 / 边界 / 隐私 - **不是**心理诊疗，不做诊断，不保证和好 - **不**教吵架、报复或阴阳 - 复盘卡是认知模式假设，供自我观察 - 记录默认只存在本机浏览器；清除站点数据会丢失历史 - 疏导与生成复盘卡时，会将填写内容发到后端，调用 **阿里云百炼**；服务异常时会回落到本地规则引擎，仍可走完流程 ### 评审自检清单 - [ ] 链接可打开，无空白页 - [ ] 冷静 → 3 题 → 疏导 → 生成复盘卡可走通 - [ ] 复盘卡有可读内容；可保存 / 导出 - [ ] 「我的模式」在保存后可见记录 --- ## 一句话介绍（提交用）情绪冲突后，先冷静再对齐事实与念头；用百炼通义做疏导对话，生成带认知模式标签与「下次怎么说」的复盘卡，并在本地回看自己的思维模式。 ## 技术栈与百炼能力 - 前端：Vite + React + TypeScript + Tailwind（手机优先 Web） - 后端：Hono API，部署于阿里云函数计算 - 静态托管：腾讯云 CloudBase - 模型：阿里云百炼 DashScope - 疏导对话：`qwen3.7-flash` - 复盘卡生成：`qwen3.7-plus` --- ## 本地运行 ```bash cd metalog cp .env.example .env # 编辑 .env，填入 DASHSCOPE_API_KEY（可不填，会走本地复盘引擎） npm install npm run dev ``` - 前端：http://127.0.0.1:5173 - API：http://127.0.0.1:8787 手机真机调试：同一 Wi-Fi 下用电脑局域网 IP 访问 Vite 端口（可在 `vite.config.ts` 加 `server.host: true`）。 ## 公网部署说明 ### 当前参赛架构 - 前端：CloudBase 静态托管（上方体验链接） - API：阿里云 FC（`metalog` 函数），前端通过 `VITE_API_BASE` 调用重新部署前端示例： ```bash cd metalog # 确保 .env 中有 TENCENT_SECRET_*、CLOUDBASE_ENV_ID、VITE_API_BASE 等 npm run deploy:tcb # 或前后端一起：npm run deploy:cn ``` ### 阿里云函数计算（API） ```bash cd metalog # 1) 在阿里云控制台创建 AccessKey：https://ram.console.aliyun.com/manage/ak npx s config add # 选 Alibaba Cloud，填 AccessKeyID / AccessKeySecret # 2) 确保本地 .env 里有 DASHSCOPE_API_KEY export $(grep -v '^#' .env | xargs) npm run deploy:fc ``` ### Vercel（海外备用）前端与 `/api` 同站部署。 1. 打开 https://vercel.com 注册/登录 2. 本地：`npx vercel login && npx vercel --prod` 3. 配置环境变量 `DASHSCOPE_API_KEY`（及可选模型名）后再次 `--prod` `.vercel.app` 在国内部分网络可能打不开，正式评审请用上方 CloudBase 链接。备用（单进程）：`npm run build && npm start`。