【安心陪诊 Agent】Node.js 20 + Express 4 实战：陪诊市场假设与任务链契约测试

应用名称：安心陪诊 Agent
统一合集：安心陪诊 Agent｜HarmonyOS 高校创新赛
关键词标签：harmonyos / AI Agent / 医疗陪诊

市场前景分析：银发陪诊、家庭照护和 AI Agent 的交叉机会

摘要：从真实用户需求、付费场景和可持续服务角度分析项目价值。 本系列基于“安心陪诊 Agent”完整项目，从产品立项、UI、Agent、Web Demo、HarmonyOS 迁移和竞赛材料角度连续复盘。本文关键词：银发经济、陪诊服务、AI Agent、市场分析。

​编辑

​编辑​编辑

目录

• 项目背景与本文重点
• 场景拆解：为什么这个问题值得做
• 设计稿与页面结构
• Agent 或接口实现路径
• 代码片段与工程细节
• 安全边界、测试和可迁移性
• 小结与下一步

项目背景与本文重点

安心陪诊 Agent 的定位很明确：它不是诊断系统，也不是线上问诊平台，而是一个围绕真实就医流程做信息整理、任务拆解和家属协同的智能体原型。项目当前实现了可运行 Web Demo：前端使用原生 HTML、CSS、JavaScript，后端使用 Node.js 原生 HTTP 服务，核心 Agent 采用本地规则与结构化输出，提供 /api/plan 和 /api/chat 两个接口。视觉资产包括 image2 生成的项目总览、五页 UI 原型、Agent 流程图、桌面端和移动端演示截图，以及一套 image2 风格演示 PPT。

在安心陪诊 Agent 中，安全边界一直放在功能之前。它可以帮用户整理症状、提示材料、生成医生问题、提醒复查，但不能替医生诊断，也不能给药物剂量。这个边界看似保守，却是项目能被认真评审的关键，因为健康信息场景最怕“看起来很智能，实际上越界”。

​编辑

​编辑​编辑

​编辑

​编辑​编辑

场景拆解：为什么这个问题值得做

如果把这个项目迁移到 HarmonyOS，本文提到的模块仍然成立：页面层负责展示和交互，服务层负责计划生成和对话组织，数据层负责保存必要记录，系统能力层再接入日历、提醒、语音和小艺智能体。也就是说，当前 Web Demo 不是临时玩具，而是为后续 HAP 真机演示预留了清晰骨架。

从 市场前景 的角度看，市场前景分析：银发陪诊、家庭照护和 AI Agent 的交叉机会 不是一个单点功能，而是一条围绕真实就医行为展开的任务链。很多项目在介绍 AI 时会把重点放在“能回答问题”，但安心陪诊 Agent 更关注“回答之后用户能不能行动”。这也是它适合写成技术文章的原因：背后既有产品判断，也有界面、接口、规则、测试和提交材料的工程约束。

在真实就医前，家属常常需要同时处理挂号、路线、证件、医保、药盒、检查单和老人情绪。到了诊室里，医生真正需要的是清楚的事实：哪里不舒服、持续多久、什么情况下加重、既往病史是什么、现在吃什么药。就医结束后，又要把医嘱、复查时间、观察指标同步给家里其他人。安心陪诊 Agent 的价值就在于把这些散落的信息整理成可执行任务，而不是让用户面对一大段泛泛的医疗说明。

设计稿与页面结构

这一篇最重要的观察是：医疗陪诊场景不能把复杂性全部推给用户。老人和家属在医院里的压力来自时间、窗口、材料、检查单、医生沟通和复查安排。产品如果只给一个聊天框，用户仍然不知道下一步做什么；所以本文会把 设计稿 拆成输入、处理、输出、验证四个层次。

项目采用五页统一结构：首页、准备台、流程、家属同步、我的。首页负责建立信任和展示完整能力；准备台负责采集患者信息并生成计划；流程页把就医前 24 小时、就医前 12 小时、到院就诊、就医后当天拆成步骤；家属同步页把复杂信息压缩成可转发摘要；我的页面集中展示安全边界和 C4 赛题匹配。这个结构的好处是评委或读者不需要猜项目能做什么，打开后能顺着任务路径看完闭环。

Agent 或接口实现路径

为了让文章在 CSDN 上更有参考价值，我不会只写“项目很好看”。更有价值的部分是说明为什么这么设计、怎么实现、哪里容易踩坑、如何验证。比如同样是生成清单，直接给一段长文字和拆成卡片是完全不同的体验；同样是 AI 回复，冷冰冰的百科回答和陪诊式确认也会带来完全不同的信任感。

本项目没有把 Agent 写成不可解释的黑盒。它先通过症状关键词、就诊时间、既往病史、当前用药和家属担心生成结构化 profile，再根据 profile 生成科室方向、医生问题、提醒事项、家属摘要和对话回复。这样做的优点是演示稳定、结果可解释、迁移成本低；缺点是规则覆盖需要持续扩充。对于比赛原型来说，这个取舍是合理的，因为评审最先关心的是项目是否能完整演示、是否有清楚边界、是否能落地到鸿蒙能力。

代码片段与工程细节

下面这个片段展示了本文相关的一个关键工程点。代码不是为了炫技，而是让读者能看到项目不是只有效果图，背后有真实的输入、处理和输出链路。

一句话创意： 把一次看病前后的症状资料、挂号分诊、医生问题、医院流程、用药核对、 复查提醒和家属同步，整理成一条可执行、可对话的安全陪诊流程。

工程实现时，我更建议先把接口返回结构固定下来，再去调 UI。比如计划接口可以稳定返回 department、timeline、questions、reminders、familyBrief、cards；对话接口可以稳定返回 headline、actions、doctorInfo、hospitalInfo、followUps 和 safety。前端只要按照结构渲染，就能避免页面逻辑越来越散。

安全边界、测试和可迁移性

安全边界需要同时出现在三个地方：第一，产品文案中要明确“只做就医流程整理，不做诊断”；第二，Agent 输出中遇到胸痛、呼吸困难、意识不清等急症信号时必须提示线下急救或急诊；第三，代码和测试中要覆盖这些路径，防止后续功能扩展时把边界稀释。迁移到 HarmonyOS 后，这些边界还应该体现在权限申请、隐私说明、数据存储和上架材料中。

实现复盘

如果把“市场前景”作为这一篇的核心关键词，文章就不能只停留在结论，而要把判断依据写出来。高质量项目文章通常有三个共同点：一是有真实问题，二是有可复现路径，三是有失败或边界意识。安心陪诊 Agent 正好具备这些素材：它有生活痛点，有页面和接口，有安全约束，也有后续 HarmonyOS 真机化计划。写作时把这些内容展开，读者才会觉得这不是一篇宣传稿，而是一篇可以借鉴的工程复盘。

评审视角

可维护性

这一篇最重要的观察是：医疗陪诊场景不能把复杂性全部推给用户。老人和家属在医院里的压力来自时间、窗口、材料、检查单、医生沟通和复查安排。产品如果只给一个聊天框，用户仍然不知道下一步做什么；所以本文会把 可维护性 拆成输入、处理、输出、验证四个层次。

CSDN 写作提示

后续扩展

实现复盘

评审视角

可维护性

CSDN 写作提示

后续扩展

高质量补充：从可演示到可信赖

这一篇围绕市场前景分析：银发陪诊、家庭照护和 AI Agent 的交叉机会展开，但安心陪诊 Agent 的核心不只是做一个页面，而是把老年就医前、中、后的任务拆清楚。高质量项目文章需要回答三个问题：用户为什么需要它、系统怎样把需求变成可执行计划、哪些边界必须明确告诉用户。

1. 场景证据：不是泛聊天，而是陪诊任务链

安心陪诊 Agent 的对话范围应当收敛在陪诊流程内：整理症状描述、提醒携带材料、生成医生沟通清单、记录复查安排、给家属同步重点。它不做诊断、不推荐处方、不替代医生判断。把这个边界写在文章里，能让评审看到项目不是随意套一个 AI 聊天框，而是在医疗辅助场景里做了风险控制。

2. 工程证据：前端、接口和规则 Agent 如何协作

当前 Demo 可以按三层理解：前端负责收集患者信息和展示任务卡片，Node 服务负责把页面请求拆到/api/plan与/api/chat，规则 Agent 负责输出结构化计划和安全提示。后续迁移到 HarmonyOS 时，可以把计划生成、提醒、家属同步和隐私说明拆成独立模块，降低页面和业务规则互相耦合的风险。

patient input -> /api/plan 生成陪诊任务 -> /api/chat 回答流程问题 -> safety guard 限制医疗风险表达 -> family summary 输出家属可读清单

3. 安全边界：医疗类项目必须主动说明不能做什么

医疗陪诊类作品最容易被质疑的不是页面是否好看，而是是否越界。文章需要明确：系统只做信息整理和流程提醒，不判断病情严重程度，不给药物剂量，不承诺挂号或检查结果，不把个人健康信息上传到未说明的第三方服务。这个边界越清晰，作品越像一个可以继续打磨的真实产品。

4. 验收清单：发布前应该能被复查

5. 测试样例：让评委能复现核心价值

为了让文章更像真实项目复盘，每篇都应该给出一组可复现样例。比如输入“老人明天去三甲医院复查，子女不能陪同，担心材料漏带和医生问题记不住”，系统应该输出就医前准备、到院流程、医生沟通问题、检查后记录和家属同步摘要。这个样例能同时覆盖用户痛点、Agent 规划能力和页面交互闭环，比单纯描述“支持智能对话”更容易让评委理解。

如果页面或接口失败，也要有明确兜底。前端应提示用户重新填写关键字段，Node 服务应返回结构化错误，Agent 回复应避免编造医疗判断。文章里写出这些失败处理，不会显得项目弱，反而能证明开发者知道医疗类应用的边界和风险。

case: 老人复查陪诊 input: 就诊时间、医院科室、症状摘要、家属关注点 output: 材料清单、沟通问题、院内任务、复查提醒 fallback: 信息不足时先追问，不输出诊断和处方建议

6. 后续升级：从 Web Demo 到 HarmonyOS 场景

后续如果继续打磨，可以把安心陪诊 Agent 拆成 HarmonyOS 端的几个稳定入口：首页展示当日陪诊计划，服务卡片提醒复查和材料，小艺智能体负责自然语言唤起，Preferences 或 RDB 保存本地记录。这样既能保持隐私优先，又能让作品从 Web Demo 走向更贴近鸿蒙生态的参赛形态。

这也是 CSDN 系列文章需要统一标签和合集的原因：读者看到的不是一篇孤立文章，而是一条从需求分析、UI 原型、Agent 规则、接口实现、HarmonyOS 迁移到参赛材料的完整路径。完整路径越清楚，项目越容易被认为是认真做过的作品。

最终交付时，还可以把 Demo 地址、核心截图、接口样例和隐私边界放到同一份 README 中，让老师或评委不用翻很多文件就能快速复查。这样的资料组织方式，会比只强调“用了 AI”更能体现项目完成度。

这样处理后，文章就不只是“我做了一个 Demo”，而是把项目目标、实现证据、医疗安全边界和竞赛表达放在同一条线上。对 CSDN 高质量审核和比赛材料复盘来说，这比重复铺字数更稳。

工程复查补强：让文章具备可验证证据

这一段用于补齐文章的工程证据链。主题是【安心陪诊 Agent】市场前景分析：银发陪诊、家庭照护和 AI Agent 的交叉机会，所属项目是安心陪诊 Agent。一篇扎实的技术文章不能只写功能完成，还要说明真实场景、关键代码、边界处理、验证步骤和失败兜底。

quality_check: app: 安心陪诊 Agent topic: 【安心陪诊 Agent】市场前景分析：银发陪诊、家庭照护和 AI Agent 的交叉机会 evidence: screenshot + code + validation table fallback: empty state + error state + manual review note

复查时重点看三点：第一，读者是否能按文章复现核心流程；第二，文章是否避免泛泛而谈，能落到具体模块；第三，失败场景是否有明确提示，而不是只展示成功路径。满足这些条件后，文章更像一篇可落地、可复查、可继续迭代的工程记录。

工程深度补充：从页面表现走到可复查实现

这一部分把安心陪诊 Agent的文章主题【安心陪诊 Agent】市场前景分析：银发陪诊、家庭照护和 AI Agent 的交叉机会继续落到工程证据上。读者不只看到结论，还能看到输入、处理、输出、异常兜底和验收方式。

type AgentIntent = "plan" | "chat" | "summary"; interface AgentRequest { intent: AgentIntent; userText: string; safeMode: boolean; } function routeAgent(req: AgentRequest) { if (!req.userText.trim()) return { type: "empty", message: "请先补充就医需求" }; if (req.safeMode && /诊断|剂量|处方/.test(req.userText)) { return { type: "guard", message: "仅提供就医准备建议，不替代医生判断" }; } return { type: req.intent, message: "进入陪诊任务编排" }; }

这段代码的重点不是堆功能，而是把文章里的核心判断拆成稳定输入、明确输出和可解释的失败分支。读者复用时可以先保留接口形状，再替换成自己的业务字段。

实际提交前还需要做一次人工复查：标题是否和正文一致，封面是否能在列表页看清，代码是否和项目主题相关，图片是否能解释流程，结尾是否有可执行的验证清单。

小结与下一步

本文围绕“市场前景分析：银发陪诊、家庭照护和 AI Agent 的交叉机会”复盘了安心陪诊 Agent 的一个关键侧面。这个项目当前已经具备创意描述、设计稿、作品介绍文档、可运行 Demo 和演示 PPT。后续如果继续冲击更高质量的竞赛提交，建议补充三类材料：真机 HAP 运行证明、用户访谈或可用性测试报告、5 分钟以内演示视频。对 CSDN 读者来说，最值得借鉴的不是某一个页面，而是从痛点、设计、代码、边界、测试到提交材料的完整闭环。

市场分析 v1.0：范围、工具版本与验证边界

本文以安心陪诊 Agent Web Demo v1.0 为观察样本，前端环境为 Node.js 20.11.1、Express 4.18.3 和 Chrome 126。这里讨论的是信息整理、提醒与家属协作的产品机会，不把市场分析写成医疗诊断、医院承诺或商业收益保证。

{ "demoVersion": "1.0.0", "runtime": "Node.js 20.11.1", "server": "Express 4.18.3", "validation": ["task-flow", "privacy-boundary", "responsive-layout"] }

验证不是市场预测

如果要进一步验证市场机会，应使用明确样本、访谈问题和时间范围，并把定性反馈与产品结论分开记录，避免把假设包装成数据结论。

Demo v1.1：固定依赖与任务链契约测试

草稿中的 Web Demo 基线固定为 Node.js 20.11.1、Express 4.18.3 和 Chrome 126。这里的测试对象不是“市场规模是否成立”，而是用户输入能否稳定生成陪诊待办，以及隐私边界是否被代码拒绝。

1. 最小可复现依赖

{ "name": "care-companion-agent-demo", "version": "1.1.0", "private": true, "type": "module", "engines": { "node": "20.11.1" }, "dependencies": { "express": "4.18.3" }, "scripts": { "start": "node server.mjs", "test": "node --test tests/*.test.mjs" } }

版本号使用精确值而不是范围，避免安装时悄悄升级主依赖。复查前执行node --version，输出应为v20.11.1，再执行npm ci使用锁文件安装。

2. 任务计划只接受必要字段

export function buildCompanionPlan(input) { const hospital = String(input.hospital || '').trim(); const visitAt = Date.parse(String(input.visitAt || '')); if (!input.privacyAccepted) { return { ok: false, code: 'PRIVACY_NOT_ACCEPTED' }; } if (!hospital) { return { ok: false, code: 'HOSPITAL_REQUIRED' }; } if (!Number.isFinite(visitAt)) { return { ok: false, code: 'VISIT_TIME_INVALID' }; } return { ok: true, tasks: [ { id: 'confirm-route', title: '确认医院入口与路线' }, { id: 'prepare-materials', title: '核对用户填写的材料清单' }, { id: 'family-sync', title: '向家属同步行程状态' } ] }; }

函数不接收疾病结论、处方或剂量字段，也不把自由文本自动解释成医疗建议。它只把用户确认过的信息转换为流程任务。

3. 使用 Node 内置测试复查三条边界

import test from 'node:test'; import assert from 'node:assert/strict'; import { buildCompanionPlan } from '../src/plan.mjs'; test('隐私未确认时拒绝生成', () => { const result = buildCompanionPlan({ hospital: '示例医院', visitAt: '2026-07-18T09:00:00+08:00', privacyAccepted: false }); assert.equal(result.code, 'PRIVACY_NOT_ACCEPTED'); }); test('缺少医院时返回明确错误', () => { const result = buildCompanionPlan({ hospital: '', visitAt: '2026-07-18T09:00:00+08:00', privacyAccepted: true }); assert.equal(result.code, 'HOSPITAL_REQUIRED'); }); test('合法输入生成三个流程任务', () => { const result = buildCompanionPlan({ hospital: '示例医院', visitAt: '2026-07-18T09:00:00+08:00', privacyAccepted: true }); assert.equal(result.ok, true); assert.equal(result.tasks.length, 3); });

复查命令为npm ci、npm test、npm start。文章只给出可执行用例和明确断言，不把预期结果冒充为已经完成的用户调研；真实市场结论仍需记录样本数量、访谈时间和原始反馈。