同一个 Agent，隔几天换个上下文，就不记得你之前交代过的偏好；写代码时，刚修过的 Bug 换个新 Session 又踩一遍。业界虽然有记忆张量、Mem0 等许多方案，但 “各家各自跑，标准不统一” 。近期，由国内外二十多所高校与研究机构联合发起的 Agent Memory Leaderboard (AML)  正式发布，并在 7 月 29 日启动了首届 Agent 记忆挑战赛。这不只是一个新榜单，而是试图为记忆系统建立一套 “统一、开放、可复现、可长期运行” 的评测基准。今天我们来聊聊，AML 到底在测什么？以及为什么它可能是 Agent 长线协作的关键基础设施。为什么需要一场“记忆大考”？过去一年，Agent Memory 的方法与产品快速涌现。但症结在于：评测标准不统一。数据集不统一：你的短对话，我的长上下文。回答模型不统一：有的用 GPT-4 测，有的用开源模型测。评分逻辑不统一：有的看重关键词命中，有的看重逻辑推理。这就导致一个尴尬的局面：一个系统在单一数据集上拿高分，未必代表它的整体记忆能力强；同一个方法换个回答模型，结果可能天差地别。“在这个领域，分数混合了记忆系统、回答模型和裁判规则等多重因素，很难单独衡量记忆本身的价值。”  这正是 AML 诞生的背景——需要一把“统一标尺”。AML 到底在测什么？—— 三项核心设计揭秘AML 并不打算再造一个单点 benchmark，而是搭建一个“只要接入，就能测全项”的长线体系。1. 统一评测机制：把变量锁死平台将参评系统的职责极度压缩：只提供 Add（写入）  和 Search（检索）  两个接口。回答（Answer）和评分（Eval）全部由平台统一大模型完成。这意味着，你再也不能用“我的模型更聪明”去掩盖“我的记忆检索能力差”。成绩的差异，将更多归因于记忆系统本身。2. 能力剖面重构：不只是总分，而是“诊断书”AML 打破了总分覆盖一切的现状。它将文本记忆拆解为 7 项核心能力：显式事实召回、关系与多跳组合、时间与事件序列；记忆治理（更新、冲突与遗忘）、个性化与关怀、规则与流程执行；认识论安全与隐私（证据不足不臆造、守住边界）。除文本外，它还引入了代码大类评测。系统需从真实 GitHub 仓库的历史 Issue/Pull Request 中检索过往工程经验，考察其抗噪能力和经验复用精准度。3. 低门槛、长期运行参赛者只需写好 Add/Search 接口即可，无需搭建全套评测环境。平台会统一运行、记录并公示结果，确保榜单的长期可追溯。不止是一个平台，它已经跑起来了一套评测体系是否站得住，最终要靠真实的系统来检验。AML 并非只停留在论文或架构图里——它已经进入了实战阶段。2026 年 7 月，基于上述评测平台，首届 Agent 记忆挑战赛（Agent Memory Challenge 2026） 正式启动。这是 AML 第一次面向全球社区开放征集参评系统，邀请研究者、开源项目维护者和商业产品团队，在同一条跑道上完成首次集中的横向评测。本次挑战赛的报名将持续至 8 月 7 日，成绩与榜单将于 8 月中旬 正式公布。与许多短期打榜活动不同，AML 本身是一个长期运行的平台。本次挑战赛更像是整个评测体系的首轮压力测试，所有参赛者的成绩将与系统版本绑定，长期可追溯；提交一次，即可在统一的评测规则下，获得覆盖 7 项文本记忆能力与 2 项代码记忆能力的全景评估报告。如果你是研究者或开发者，目前仍然可以前往官网报名，平台将承担所有评测与评审算力，你只需提供 Add/Search 接口即可参与：核心入口：官方公众号：记忆之巅排行榜报名官网：HTTPS://agentmemories.ai/competition/官方 GitHub 仓库：HTTPS://GitHub.com/AML-memory/agent-memory-leaderboard【结语】大模型 Agent 的演进，正从单次问答走向长线协作。而这背后最底层的基础设施，无疑是 “记忆系统” 。AML 的价值不仅仅在于发布一个排行榜，而在于为整个产业界和学术界提供了一个  “可以横向比较、相互复用诊断工具”的基准平台。当所有记忆系统都能在同一把尺子下比试，真正的好系统才能被识别、被验证、被持续改进。8 月中旬放榜日，无论你是否参赛，都值得蹲守一下这份首期成绩单。记忆技术要往前走，我们需要一套大家认可、任何人都能核验的度量衡。

神了，贴个图就发不出帖子，一直报‘系统错误，请稍后重试’回复区也发不了图，这种基础功能都没人测过吗？ 

九问的在线体验只是虚晃一枪吗？隔壁Dify、百炼我一键就在云上体验干活了点了九问的在线体验，只是做了一个‘华为云开发者空间’跳转，进来啥都没有，搜了10分钟也没有任何部署指南、体验案例  

报名链接：https://agentmemories.ai/competition/"Agent Memory Leaderboard"主要面向当前快速发展的 AI Agent Memory 方向，希望建立一个更加统一、公平的评测体系。目前不同 Memory 系统在架构、数据和评测方式上差异较大，缺少横向比较标准。这个赛事通过统一的评测框架，考察 Agent 在记忆召回、记忆更新、长期适应以及任务执行等方面的能力，帮助研究者和开发者更好地理解不同 Memory 方案的实际效果。首期赛事覆盖文本 Memory 和 Coding Memory 两个方向，面向学术研究和产业实践中的不同 Memory 系统开放评测，并将在8月中旬发布首期排行榜。

基于华为云码道（CodeArts）代码智能体的ForumAdmin：论坛管理系统一、项目简介本次实战我使用华为云码道（CodeArts）代码智能体完成了 ForumAdmin 论坛管理系统。项目围绕"管理员、版主、会员"三种角色展开，实现了登录、发帖、跟帖、删帖、置顶等论坛基础功能，同时实现了DFA敏感词过滤算法、管理员禁言与用户拉黑双层机制、BCrypt密码加密存储，以及Discourse风格的现代论坛UI，形成了功能完备、权限清晰、内容安全的论坛管理系统。代码仓库：ForumAdmin（GitCode）前端：Vue 3 + Vite + Element Plus + Pinia + Vue Router + Axios后端：Java 17 + Spring Boot 3 + MyBatis-Plus + Sa-Token + BCrypt + Druid数据库：MySQL 9.4ForumAdmin 首页二、原始任务与完成情况原题为：论坛管理。实现论坛的版主管理、版块管理、内容管理。需要登陆进入论坛，可以发帖、跟帖和删帖以及置顶等功能。同时能够对敏感词汇进行过滤，拉黑某些会员。我将原题拆成了可验收的功能项，并为每项建立"页面操作 + 后端权限"的证据闭环：原题要求实现方式对应证据登录进入论坛Sa-Token 会话管理、BCrypt 密码加密、注册、退出登录页、注册页版主管理ADMIN 分配版主；MODERATOR 可进入后台管理版块管理页、角色标签显示版块管理创建、编辑、删除、排序、版主绑定版块管理页内容管理帖子/回复分页管理、置顶、删除帖子列表、帖子详情页发帖登录会员选择版块并发布，发布前完成禁言校验和敏感词过滤发帖弹窗、发帖接口跟帖帖子详情页回复，禁言用户和被拉黑用户不可回复帖子详情页、回复区域删帖作者或管理者可删除；逻辑删除删除按钮、删除接口置顶ADMIN 或 MODERATOR 可置顶/取消置顶，置顶优先排序置顶按钮、帖子列表排序敏感词过滤DFA 算法 O(n) 时间复杂度，词库动态重载敏感词管理页、发帖过滤效果拉黑会员管理员禁言(全站) + 用户拉黑(个人)；发帖和回复前后端拦截黑名单页、禁言操作、拉黑按钮三、码道代码智能体开发实录我全程使用华为云码道（CodeArts）代码智能体进行开发，从项目初始化到最终UI改造，智能体深度参与了每个阶段。以下是按时间顺序的开发实录：3.1 项目创建与任务理解在码道代码智能体中创建项目后，我将原始任务描述提交给智能体："实现论坛的版主管理、版块管理、内容管理。需要登陆进入论坛，可以发帖、跟帖和删帖以及置顶等功能。同时能够对敏感词汇进行过滤，拉黑某些会员。"智能体准确理解了需求，并主动拆解为以下模块：用户认证与权限管理（登录/注册/角色控制）版块管理（CRUD + 版主绑定）帖子与回复（发帖/跟帖/删帖/置顶）敏感词过滤（DFA算法）拉黑会员（用户屏蔽机制）3.2 后端项目搭建智能体一步完成了 Spring Boot 3 后端项目初始化，包括：引入 spring-boot-starter-web、mybatis-plus-spring-boot3-starter、sa-token-spring-boot3-starter、druid-spring-boot-3-starter、spring-security-crypto 等核心依赖配置 application.yml（数据源、MyBatis-Plus逻辑删除、Sa-Token会话参数）创建 Result 统一响应封装和 GlobalExceptionHandler 全局异常处理设计6张数据库表（user / section / post / reply / sensitive_word / user_block），编写 init.sql3.3 前端项目搭建智能体使用 Vite 脚手架创建 Vue 3 前端项目，集成：Element Plus 组件库及图标库Pinia 状态管理（用户token和userInfo持久化）Axios 请求封装（baseURL代理、token拦截器、401自动跳转）Vue Router 路由配置（含登录守卫）3.4 核心功能实现智能体按模块逐步生成完整CRUD代码：5组 Entity + Mapper + Service + Controller：User、Section、Post、Reply、SensitiveWordSa-Token RBAC权限：实现 StpInterface 接口，根据用户uid动态返回角色列表BCrypt密码加密：注册时加密存储，登录时matches验证；DataInitializer启动自动检测并转换明文密码DFA敏感词过滤算法：智能体独立实现了确定有限自动机，包括字典构建、匹配检测、文本替换三个核心方法拉黑与禁言双层机制：新增 user_block 表和 UserBlockController，帖子列表SQL动态过滤被拉黑用户，回复前校验帖子作者是否拉黑了回复人3.5 Bug修复与优化开发过程中遇到多个问题，智能体均快速定位并修复：问题原因智能体解决方案版块名称乱码PowerShell管道传输SQL编码丢失移除SQL初始数据，改用Java DataInitializer自动初始化，确保UTF-8密码明文存储初始实现未加密引入BCryptPasswordEncoder，DataInitializer自动检测并转换后台管理按钮不可见仅ADMIN角色可见扩展为ADMIN和MODERATOR均可进入帖子详情API返回nullgetById不关联查询新增selectDetailById关联查询用户名/版块名/回复数帖子创建标题/内容为空前后端均未校验前端表单验证 + 后端参数非空校验3.6 UI改造智能体根据我确认的Discourse风格方案，完成了全部页面改造：创建公共 AppHeader 组件（白底头部 + Logo + 角色标签 + 管理入口）首页：横向分类标签 + 帖子行（头像+标题+分类标签+回复数）+ 浮动发帖按钮帖子详情：时间线流式回复（圆点+连线）+ 底部固定编辑器登录页：浅灰背景 + 圆角卡片后台管理：白底侧边栏 + 图标菜单配色统一：主背景#fff、链接蓝#0088cc、分类标签彩色3.7 开发效率总结通过码道代码智能体，整个项目从零到功能完备仅用时约2天。智能体在以下方面显著提升了效率：代码生成：后端CRUD、前端页面、API接口等重复性代码一键生成算法实现：DFA敏感词过滤等非平凡算法智能体独立完成Bug修复：编码乱码、密码明文等问题智能体快速定位根因并修复架构决策：技术选型（Sa-Token vs Spring Security）、权限模型设计等智能体给出了合理建议一致性保障：公共组件、统一响应封装、路由守卫等确保了代码风格一致四、系统架构与业务闭环整体架构保持前后端分离，开发模式下前端Vite Dev Server代理后端API：会员 / 版主 / 管理员 │ ▼ Vue 3 + Vite (5173) │ Axios → /api 代理 ▼ Sa-Token 会话认证 │ ├── 用户服务 ── BCrypt 密码验证 ├── 论坛业务服务 ── MyBatis-Plus ── MySQL 9.4 ├── RBAC 权限 ── ADMIN / MODERATOR / MEMBER ├── 敏感词 DFA ── 过滤/替换 └── 拉黑/禁言 ── 帖子过滤 + 回复拦截发帖和回复走统一治理链路：提交内容 → 校验是否被禁言（user.status = 0） → 校验是否被帖子作者拉黑 → DFA 敏感词过滤（替换为 ***） → 保存并返回这种设计确保了：禁言用户无法发帖和回帖；被拉黑用户的帖子不会出现在列表中；被帖子作者拉黑的用户无法回复该帖子；敏感词在保存前即被过滤替换。五、逐项功能实现1. 登录进入论坛系统支持注册、登录和退出。登录成功后前端携带 Sa-Token 的 UUID Token 访问需要授权的接口；密码使用 BCrypt 加密存储。登录页面注册页面登录接口实现：@PostMapping("/login") public Result<Map<String, Object>> login(@RequestBody Map<String, String> params) { User user = userService.login(params.get("username"), params.get("password")); Map<String, Object> data = new HashMap<>(); data.put("token", StpUtil.getTokenValue()); data.put("user", user); return Result.ok(data); } Sa-Token 权限配置，根据用户角色动态返回权限列表：@Component public class SaTokenConfig implements StpInterface { private final UserMapper userMapper; @Override public List<String> getPermissionList(Object loginId, String loginType) { return new ArrayList<>(); } @Override public List<String> getRoleList(Object loginId, String loginType) { List<String> roles = new ArrayList<>(); User user = userMapper.selectById(Long.valueOf(loginId.toString())); if (user != null) { roles.add(user.getRole()); } return roles; } } 2. 版主管理管理员可以在版块管理页为每个版块分配版主（通过 moderatorId 字段）。系统实现了三级角色权限控制：角色前台后台管理说明ADMIN发帖/回帖/删帖/置顶版块管理+用户管理(禁言)+敏感词管理超级管理员MODERATOR发帖/回帖/删帖/置顶可进入后台版主MEMBER发帖/回帖不可进入普通会员前端通过角色标签清晰展示当前用户身份：3. 版块管理系统实现了版块的创建、编辑、删除、排序和版主配置。DataInitializer 在启动时自动检查并修复版块数据，确保中文编码正确：private static final String[][] DEFAULT_SECTIONS = { {"技术交流", "讨论技术相关话题"}, {"生活杂谈", "分享生活点滴"}, {"求助问答", "提出问题寻求帮助"} }; 版块管理页面4. 发帖与跟帖登录会员可以选择版块发布帖子，并在帖子详情页回复。发帖与回复都会先检查禁言状态和拉黑关系，再进行敏感词过滤。发帖接口实现（含校验与敏感词过滤）：@PostMapping("/add") public Result<Void> add(@RequestBody Post post) { if (post.getTitle() == null || post.getTitle().trim().isEmpty()) { return Result.fail("标题不能为空"); } if (post.getContent() == null || post.getContent().trim().isEmpty()) { return Result.fail("内容不能为空"); } if (post.getSectionId() == null) { return Result.fail("请选择版块"); } Long userId = StpUtil.getLoginIdAsLong(); User user = userService.getById(userId); if (user.getStatus() == 0) { return Result.fail("您已被禁言，无法发帖"); } post.setUserId(userId); post.setTitle(sensitiveWordService.filter(post.getTitle())); post.setContent(sensitiveWordService.filter(post.getContent())); post.setIsTop(0); postService.save(post); return Result.ok(); } 回复接口实现（含拉黑校验）：@PostMapping("/add") public Result<Void> add(@RequestBody Reply reply) { Long userId = StpUtil.getLoginIdAsLong(); User user = userService.getById(userId); if (user.getStatus() == 0) { return Result.fail("您已被禁言，无法回复"); } Post post = postService.getById(reply.getPostId()); if (post != null && userBlockService.hasBlocked(post.getUserId(), userId)) { return Result.fail("帖子作者已拉黑您，无法回复"); } reply.setUserId(userId); reply.setContent(sensitiveWordService.filter(reply.getContent())); replyService.save(reply); return Result.ok(); } 帖子列表关联查询，一次SQL获取用户名、版块名和回复数：@Select("<script>" + "SELECT p.*, u.username, u.nickname, s.name AS section_name, " + "(SELECT COUNT(*) FROM reply r WHERE r.post_id = p.id AND r.is_deleted = 0) AS reply_count " + "FROM post p LEFT JOIN user u ON p.user_id = u.uid LEFT JOIN section s ON p.section_id = s.id " + "WHERE p.is_deleted = 0 " + "<if test='blockedIds != null and blockedIds.size() > 0'>" + "AND p.user_id NOT IN " + "<foreach collection='blockedIds' item='id' open='(' separator=',' close=')'>#{id}</foreach>" + "</if>" + " ORDER BY p.is_top DESC, p.create_time DESC" + "</script>") IPage<Post> selectPageAll(Page<Post> page, @Param("blockedIds") java.util.List<Long> blockedIds); 帖子详情页5. 删帖与置顶作者可以删除自己的帖子，管理员和版主可以执行管理删除。删除采用 MyBatis-Plus 逻辑删除（is_deleted 字段），不会物理清除数据。置顶操作更新 is_top 字段，帖子列表按置顶优先、时间倒序排列。置顶接口：@PutMapping("/top/{id}") public Result<Void> top(@PathVariable Long id, @RequestParam Integer isTop) { postService.setTop(id, isTop); return Result.ok(); } 逻辑删除配置：mybatis-plus: global-config: db-config: logic-delete-field: isDeleted logic-delete-value: 1 logic-not-delete-value: 0 6. 敏感词过滤敏感词管理支持新增、删除和动态重载。过滤算法采用 DFA（确定有限自动机），时间复杂度为 O(n)，其中 n 为待过滤文本长度，与敏感词数量无关。DFA 核心实现：@Component public class SensitiveWordFilter { private final Map<Character, Object> dictMap = new HashMap<>(); private static final String REPLACEMENT = "***"; public void loadWords(List<SensitiveWord> words) { dictMap.clear(); for (SensitiveWord sw : words) { String word = sw.getWord().trim(); if (word.isEmpty()) continue; Map<Character, Object> current = dictMap; for (int i = 0; i < word.length(); i++) { char c = word.charAt(i); Object next = current.get(c); if (next == null) { Map<Character, Object> newNode = new HashMap<>(); current.put(c, newNode); current = newNode; } else { current = (Map<Character, Object>) next; } } current.put('\0', null); } } public String filter(String text) { if (text == null || text.isEmpty()) { return text; } StringBuilder result = new StringBuilder(text); for (int i = 0; i < text.length(); i++) { int length = checkSensitiveWord(text, i); if (length > 0) { for (int j = i; j < i + length; j++) { result.setCharAt(j, REPLACEMENT.charAt(0)); } i += length - 1; } } return result.toString(); } @SuppressWarnings("unchecked") private int checkSensitiveWord(String text, int startIndex) { Map<Character, Object> current = dictMap; int length = 0; for (int i = startIndex; i < text.length(); i++) { char c = text.charAt(i); Object next = current.get(c); if (next == null) { break; } length++; current = (Map<Character, Object>) next; if (current.containsKey('\0')) { return length; } } return 0; } } 词库动态重载接口：@GetMapping("/refresh") public Result<Void> refresh() { sensitiveWordService.refreshDict(); return Result.ok(); } 敏感词管理页面7. 拉黑会员系统实现了双层机制：管理员禁言：全站级别，修改 user.status = 0，禁言用户可登录但无法发帖和回帖用户拉黑：个人级别，通过 user_block 表记录，拉黑后看不到对方帖子，对方无法回复自己的帖子操作执行者范围效果禁言管理员全站可登录，但无法发帖、回帖拉黑任何用户个人我看不到他的帖子，他不能回复我的帖子拉黑接口实现：@RestController @RequestMapping("/api/block") @RequiredArgsConstructor public class UserBlockController { private final UserBlockService userBlockService; @PostMapping("/add/{blockedUserId}") public Result<Void> block(@PathVariable Long blockedUserId) { Long userId = StpUtil.getLoginIdAsLong(); userBlockService.block(userId, blockedUserId); return Result.ok(); } @DeleteMapping("/remove/{blockedUserId}") public Result<Void> unblock(@PathVariable Long blockedUserId) { Long userId = StpUtil.getLoginIdAsLong(); userBlockService.unblock(userId, blockedUserId); return Result.ok(); } @GetMapping("/list") public Result<List<UserBlock>> myBlockList() { Long userId = StpUtil.getLoginIdAsLong(); return Result.ok(userBlockService.myBlockList(userId)); } } 帖子列表查询时动态过滤被拉黑用户的帖子：@GetMapping("/list") public Result<IPage<Post>> list(@RequestParam(required = false) Long sectionId, @RequestParam(defaultValue = "1") long page, @RequestParam(defaultValue = "10") long size) { List<Long> blockedIds = Collections.emptyList(); if (StpUtil.isLogin()) { blockedIds = userBlockService.getBlockedUserIds(StpUtil.getLoginIdAsLong()); } if (sectionId != null) { return Result.ok(postService.pageBySectionId(sectionId, page, size, blockedIds)); } return Result.ok(postService.pageAll(page, size, blockedIds)); } 黑名单管理页面8. Discourse 风格 UI系统采用 Discourse 风格的现代论坛 UI 设计，主要特点包括：白底头部：统一的 AppHeader 组件，包含 Logo、用户信息、角色标签、管理入口横向分类标签：版块以彩色标签形式横向排列，点击切换过滤帖子列表：每行显示头像、标题、分类标签、回复数，替代传统表格时间线流式回复：帖子详情页回复以圆点+连线的时间线形式展示底部固定编辑器：回复输入框固定在页面底部，随时可输入浮动发帖按钮：右下角圆形按钮，点击弹出发帖弹窗公共头部组件核心代码：<template> <header class="app-header"> <div class="header-inner"> <div class="header-left" @click="$router.push('/')"> <span class="logo">Forum</span> </div> <div class="header-right"> <span class="user-name">{{ userStore.userInfo?.nickname || '用户' }}</span> <el-tag v-if="userStore.userInfo?.role === 'ADMIN'" type="danger" size="small" effect="dark">管理员</el-tag> <el-tag v-else-if="userStore.userInfo?.role === 'MODERATOR'" color="#e6a23c" size="small" effect="dark" style="color:#fff;border:none">版主</el-tag> <el-tag v-else type="info" size="small" effect="plain">会员</el-tag> <el-button v-if="userStore.userInfo?.role === 'ADMIN' || userStore.userInfo?.role === 'MODERATOR'" text @click="$router.push('/admin')"> <el-icon><Setting /></el-icon> 管理 </el-button> <el-button text @click="$router.push('/blocklist')"> <el-icon><UserFilled /></el-icon> 黑名单 </el-button> <el-button text type="danger" @click="handleLogout"> <el-icon><SwitchButton /></el-icon> 退出 </el-button> </div> </div> </header> </template> 首页帖子列表核心代码：<div v-for="p in posts" :key="p.id" class="post-row" @click="$router.push(`/post/${p.id}`)"> <div class="post-avatar"> <el-avatar :size="36" :style="{ background: sectionColor(p.sectionId) }"> {{ (p.nickname || p.username || '?')[0] }} </el-avatar> </div> <div class="post-body"> <div class="post-title-row"> <el-tag v-if="p.isTop === 1" type="danger" size="small" effect="dark" class="top-tag">置顶</el-tag> <span class="post-title">{{ p.title }}</span> <span class="post-cat" :style="{ background: sectionColor(p.sectionId) + '18', color: sectionColor(p.sectionId) }">{{ p.sectionName }}</span> </div> <div class="post-meta"> <span class="meta-author">{{ p.nickname || p.username }}</span> <span class="meta-dot">·</span> <span class="meta-time">{{ p.createTime }}</span> </div> </div> <div class="post-stats"> <el-icon><ChatDotRound /></el-icon> <span>{{ p.replyCount || 0 }}</span> </div> </div> 首页全貌帖子详情时间线回复六、创新与易用性DFA 敏感词过滤：采用确定有限自动机算法，时间复杂度 O(n)（n为文本长度），与敏感词数量无关；词库支持动态热重载，无需重启服务。拉黑/禁言双层机制：管理员禁言为全站级别（修改 user.status），用户拉黑为个人级别（user_block 表），两者逻辑清晰、互不干扰，分别作用于不同场景。BCrypt 密码加密：使用 BCryptPasswordEncoder 加密存储密码，BCrypt 自带盐值，每次加密结果不同，抗彩虹表攻击。DataInitializer 启动时自动检测并转换明文密码。Discourse 风格 UI：白底头部、横向分类标签、时间线流式回复、底部固定编辑器、浮动发帖按钮，提供现代论坛体验。前后端双重校验：前端表单提交前验证必填项，后端接口同样校验参数非空，避免绕过前端直接提交空数据。数据自动修复：DataInitializer 启动时自动检测并修复中文乱码、明文密码、缺失数据等问题，确保系统开箱即用。七、码道新能力与华为云技术使用使用华为云码道（CodeArts）代码智能体完成全流程开发，从项目搭建、代码生成到功能实现和Bug修复；通过自然语言 Prompt 指导智能体完成数据库设计、CRUD 接口生成、敏感词算法实现、权限配置和 UI 改造；使用浏览器控制能力对 ADMIN、MODERATOR、MEMBER 等真实页面进行验收和截图，避免以 mock 页面冒充后端功能；项目级规则约束技术栈（SpringBoot3 + Vue3）、权限模型（RBAC 三级角色）和内容治理（DFA + 禁言 + 拉黑）。八、测试与验证结果项目完成了前端生产构建和后端编译验证：验证项结果后端编译mvn compile 通过前端生产构建npm run build 通过，所有组件正常打包浏览器真实验收多张页面证据，关键页面功能正常权限验证未登录跳转登录页，MEMBER 不可进入后台验证命令如下：# 后端编译 cd backend mvn compile # 前端生产构建 cd ../frontend npm run build九、本地运行本地开发# 1. 初始化数据库 mysql -u root -p < sql/init.sql # 2. 启动后端 cd backend mvn spring-boot:run # 3. 另开终端启动前端 cd frontend npm install npm run dev访问 http://localhost:5173，后端API端口为 8080。一键启动项目提供了 start.bat 一键启动脚本，双击即可同时启动后端和前端。默认账号账号密码角色adminadmin123ADMINmoderatormod123MODERATORmembermem123MEMBER十、逐项对应评分项项目成果与证据创新易用DFA敏感词O(n)过滤、拉黑/禁言双层机制、BCrypt加密、Discourse风格UI、前后端双重校验、数据自动修复功能完备原题10个功能点全部闭环；登录/注册/发帖/回帖/删帖/置顶/敏感词/禁言/拉黑/版块管理全部实现技术能力码道全流程开发、Sa-Token认证+RBAC、DFA算法、MyBatis-Plus逻辑删除、前后端分离架构文档完整性开发日志、数据库设计、API接口、本地运行说明、默认账号、一键启动脚本完整十一、项目成果总结这次实战让我从"实现一个能发帖的页面"，进一步走到了"构建一个权限正确、内容安全、UI现代、开箱即用的论坛系统"。ForumAdmin 已在本地完成核心功能、生产构建验证和真实页面验收；项目同时保留了开发日志、数据库设计、API接口文档和运行说明，方便评审复现。核心成果：6张数据库表：user / section / post / reply / sensitive_word / user_block，支持逻辑删除和自动时间填充DFA敏感词过滤：O(n)时间复杂度，动态词库热重载拉黑/禁言双层机制：全站禁言与个人屏蔽分离，逻辑清晰BCrypt密码加密：启动自动检测并转换明文密码Discourse风格UI：白底头部、横向分类标签、时间线回复、浮动发帖按钮一键启动：start.bat 双击即可运行

基于华为云码道（CodeArts）代码智能体的ForumAdmin：论坛管理系统一、项目简介本次实战我使用华为云码道（CodeArts）代码智能体完成了 ForumAdmin 论坛管理系统。项目围绕"管理员、版主、会员"三种角色展开，实现了登录、发帖、跟帖、删帖、置顶等论坛基础功能，同时实现了DFA敏感词过滤算法、管理员禁言与用户拉黑双层机制、BCrypt密码加密存储，以及Discourse风格的现代论坛UI，形成了功能完备、权限清晰、内容安全的论坛管理系统。代码仓库：ForumAdmin（GitCode）前端：Vue 3 + Vite + Element Plus + Pinia + Vue Router + Axios后端：Java 17 + Spring Boot 3 + MyBatis-Plus + Sa-Token + BCrypt + Druid数据库：MySQL 9.4ForumAdmin 首页二、原始任务与完成情况原题为：论坛管理。实现论坛的版主管理、版块管理、内容管理。需要登陆进入论坛，可以发帖、跟帖和删帖以及置顶等功能。同时能够对敏感词汇进行过滤，拉黑某些会员。我将原题拆成了可验收的功能项，并为每项建立"页面操作 + 后端权限"的证据闭环：原题要求实现方式对应证据登录进入论坛Sa-Token 会话管理、BCrypt 密码加密、注册、退出登录页、注册页版主管理ADMIN 分配版主；MODERATOR 可进入后台管理版块管理页、角色标签显示版块管理创建、编辑、删除、排序、版主绑定版块管理页内容管理帖子/回复分页管理、置顶、删除帖子列表、帖子详情页发帖登录会员选择版块并发布，发布前完成禁言校验和敏感词过滤发帖弹窗、发帖接口跟帖帖子详情页回复，禁言用户和被拉黑用户不可回复帖子详情页、回复区域删帖作者或管理者可删除；逻辑删除删除按钮、删除接口置顶ADMIN 或 MODERATOR 可置顶/取消置顶，置顶优先排序置顶按钮、帖子列表排序敏感词过滤DFA 算法 O(n) 时间复杂度，词库动态重载敏感词管理页、发帖过滤效果拉黑会员管理员禁言(全站) + 用户拉黑(个人)；发帖和回复前后端拦截黑名单页、禁言操作、拉黑按钮三、码道代码智能体开发实录我全程使用华为云码道（CodeArts）代码智能体进行开发，从项目初始化到最终UI改造，智能体深度参与了每个阶段。以下是按时间顺序的开发实录：3.1 项目创建与任务理解在码道代码智能体中创建项目后，我将原始任务描述提交给智能体："实现论坛的版主管理、版块管理、内容管理。需要登陆进入论坛，可以发帖、跟帖和删帖以及置顶等功能。同时能够对敏感词汇进行过滤，拉黑某些会员。"智能体准确理解了需求，并主动拆解为以下模块：用户认证与权限管理（登录/注册/角色控制）版块管理（CRUD + 版主绑定）帖子与回复（发帖/跟帖/删帖/置顶）敏感词过滤（DFA算法）拉黑会员（用户屏蔽机制）3.2 后端项目搭建智能体一步完成了 Spring Boot 3 后端项目初始化，包括：引入 spring-boot-starter-web、mybatis-plus-spring-boot3-starter、sa-token-spring-boot3-starter、druid-spring-boot-3-starter、spring-security-crypto 等核心依赖配置 application.yml（数据源、MyBatis-Plus逻辑删除、Sa-Token会话参数）创建 Result 统一响应封装和 GlobalExceptionHandler 全局异常处理设计6张数据库表（user / section / post / reply / sensitive_word / user_block），编写 init.sql3.3 前端项目搭建智能体使用 Vite 脚手架创建 Vue 3 前端项目，集成：Element Plus 组件库及图标库Pinia 状态管理（用户token和userInfo持久化）Axios 请求封装（baseURL代理、token拦截器、401自动跳转）Vue Router 路由配置（含登录守卫）3.4 核心功能实现智能体按模块逐步生成完整CRUD代码：5组 Entity + Mapper + Service + Controller：User、Section、Post、Reply、SensitiveWordSa-Token RBAC权限：实现 StpInterface 接口，根据用户uid动态返回角色列表BCrypt密码加密：注册时加密存储，登录时matches验证；DataInitializer启动自动检测并转换明文密码DFA敏感词过滤算法：智能体独立实现了确定有限自动机，包括字典构建、匹配检测、文本替换三个核心方法拉黑与禁言双层机制：新增 user_block 表和 UserBlockController，帖子列表SQL动态过滤被拉黑用户，回复前校验帖子作者是否拉黑了回复人3.5 Bug修复与优化开发过程中遇到多个问题，智能体均快速定位并修复：问题原因智能体解决方案版块名称乱码PowerShell管道传输SQL编码丢失移除SQL初始数据，改用Java DataInitializer自动初始化，确保UTF-8密码明文存储初始实现未加密引入BCryptPasswordEncoder，DataInitializer自动检测并转换后台管理按钮不可见仅ADMIN角色可见扩展为ADMIN和MODERATOR均可进入帖子详情API返回nullgetById不关联查询新增selectDetailById关联查询用户名/版块名/回复数帖子创建标题/内容为空前后端均未校验前端表单验证 + 后端参数非空校验3.6 UI改造智能体根据我确认的Discourse风格方案，完成了全部页面改造：创建公共 AppHeader 组件（白底头部 + Logo + 角色标签 + 管理入口）首页：横向分类标签 + 帖子行（头像+标题+分类标签+回复数）+ 浮动发帖按钮帖子详情：时间线流式回复（圆点+连线）+ 底部固定编辑器登录页：浅灰背景 + 圆角卡片后台管理：白底侧边栏 + 图标菜单配色统一：主背景#fff、链接蓝#0088cc、分类标签彩色3.7 开发效率总结通过码道代码智能体，整个项目从零到功能完备仅用时约2天。智能体在以下方面显著提升了效率：代码生成：后端CRUD、前端页面、API接口等重复性代码一键生成算法实现：DFA敏感词过滤等非平凡算法智能体独立完成Bug修复：编码乱码、密码明文等问题智能体快速定位根因并修复架构决策：技术选型（Sa-Token vs Spring Security）、权限模型设计等智能体给出了合理建议一致性保障：公共组件、统一响应封装、路由守卫等确保了代码风格一致四、系统架构与业务闭环整体架构保持前后端分离，开发模式下前端Vite Dev Server代理后端API：会员 / 版主 / 管理员 │ ▼ Vue 3 + Vite (5173) │ Axios → /api 代理 ▼ Sa-Token 会话认证 │ ├── 用户服务 ── BCrypt 密码验证 ├── 论坛业务服务 ── MyBatis-Plus ── MySQL 9.4 ├── RBAC 权限 ── ADMIN / MODERATOR / MEMBER ├── 敏感词 DFA ── 过滤/替换 └── 拉黑/禁言 ── 帖子过滤 + 回复拦截发帖和回复走统一治理链路：提交内容 → 校验是否被禁言（user.status = 0） → 校验是否被帖子作者拉黑 → DFA 敏感词过滤（替换为 ***） → 保存并返回这种设计确保了：禁言用户无法发帖和回帖；被拉黑用户的帖子不会出现在列表中；被帖子作者拉黑的用户无法回复该帖子；敏感词在保存前即被过滤替换。五、逐项功能实现1. 登录进入论坛系统支持注册、登录和退出。登录成功后前端携带 Sa-Token 的 UUID Token 访问需要授权的接口；密码使用 BCrypt 加密存储。登录页面注册页面登录接口实现：@PostMapping("/login") public Result<Map<String, Object>> login(@RequestBody Map<String, String> params) { User user = userService.login(params.get("username"), params.get("password")); Map<String, Object> data = new HashMap<>(); data.put("token", StpUtil.getTokenValue()); data.put("user", user); return Result.ok(data); } Sa-Token 权限配置，根据用户角色动态返回权限列表：@Component public class SaTokenConfig implements StpInterface { private final UserMapper userMapper; @Override public List<String> getPermissionList(Object loginId, String loginType) { return new ArrayList<>(); } @Override public List<String> getRoleList(Object loginId, String loginType) { List<String> roles = new ArrayList<>(); User user = userMapper.selectById(Long.valueOf(loginId.toString())); if (user != null) { roles.add(user.getRole()); } return roles; } } 2. 版主管理管理员可以在版块管理页为每个版块分配版主（通过 moderatorId 字段）。系统实现了三级角色权限控制：角色前台后台管理说明ADMIN发帖/回帖/删帖/置顶版块管理+用户管理(禁言)+敏感词管理超级管理员MODERATOR发帖/回帖/删帖/置顶可进入后台版主MEMBER发帖/回帖不可进入普通会员前端通过角色标签清晰展示当前用户身份：3. 版块管理系统实现了版块的创建、编辑、删除、排序和版主配置。DataInitializer 在启动时自动检查并修复版块数据，确保中文编码正确：private static final String[][] DEFAULT_SECTIONS = { {"技术交流", "讨论技术相关话题"}, {"生活杂谈", "分享生活点滴"}, {"求助问答", "提出问题寻求帮助"} }; 版块管理页面4. 发帖与跟帖登录会员可以选择版块发布帖子，并在帖子详情页回复。发帖与回复都会先检查禁言状态和拉黑关系，再进行敏感词过滤。发帖接口实现（含校验与敏感词过滤）：@PostMapping("/add") public Result<Void> add(@RequestBody Post post) { if (post.getTitle() == null || post.getTitle().trim().isEmpty()) { return Result.fail("标题不能为空"); } if (post.getContent() == null || post.getContent().trim().isEmpty()) { return Result.fail("内容不能为空"); } if (post.getSectionId() == null) { return Result.fail("请选择版块"); } Long userId = StpUtil.getLoginIdAsLong(); User user = userService.getById(userId); if (user.getStatus() == 0) { return Result.fail("您已被禁言，无法发帖"); } post.setUserId(userId); post.setTitle(sensitiveWordService.filter(post.getTitle())); post.setContent(sensitiveWordService.filter(post.getContent())); post.setIsTop(0); postService.save(post); return Result.ok(); } 回复接口实现（含拉黑校验）：@PostMapping("/add") public Result<Void> add(@RequestBody Reply reply) { Long userId = StpUtil.getLoginIdAsLong(); User user = userService.getById(userId); if (user.getStatus() == 0) { return Result.fail("您已被禁言，无法回复"); } Post post = postService.getById(reply.getPostId()); if (post != null && userBlockService.hasBlocked(post.getUserId(), userId)) { return Result.fail("帖子作者已拉黑您，无法回复"); } reply.setUserId(userId); reply.setContent(sensitiveWordService.filter(reply.getContent())); replyService.save(reply); return Result.ok(); } 帖子列表关联查询，一次SQL获取用户名、版块名和回复数：@Select("<script>" + "SELECT p.*, u.username, u.nickname, s.name AS section_name, " + "(SELECT COUNT(*) FROM reply r WHERE r.post_id = p.id AND r.is_deleted = 0) AS reply_count " + "FROM post p LEFT JOIN user u ON p.user_id = u.uid LEFT JOIN section s ON p.section_id = s.id " + "WHERE p.is_deleted = 0 " + "<if test='blockedIds != null and blockedIds.size() > 0'>" + "AND p.user_id NOT IN " + "<foreach collection='blockedIds' item='id' open='(' separator=',' close=')'>#{id}</foreach>" + "</if>" + " ORDER BY p.is_top DESC, p.create_time DESC" + "</script>") IPage<Post> selectPageAll(Page<Post> page, @Param("blockedIds") java.util.List<Long> blockedIds); 帖子详情页5. 删帖与置顶作者可以删除自己的帖子，管理员和版主可以执行管理删除。删除采用 MyBatis-Plus 逻辑删除（is_deleted 字段），不会物理清除数据。置顶操作更新 is_top 字段，帖子列表按置顶优先、时间倒序排列。置顶接口：@PutMapping("/top/{id}") public Result<Void> top(@PathVariable Long id, @RequestParam Integer isTop) { postService.setTop(id, isTop); return Result.ok(); } 逻辑删除配置：mybatis-plus: global-config: db-config: logic-delete-field: isDeleted logic-delete-value: 1 logic-not-delete-value: 0 6. 敏感词过滤敏感词管理支持新增、删除和动态重载。过滤算法采用 DFA（确定有限自动机），时间复杂度为 O(n)，其中 n 为待过滤文本长度，与敏感词数量无关。DFA 核心实现：@Component public class SensitiveWordFilter { private final Map<Character, Object> dictMap = new HashMap<>(); private static final String REPLACEMENT = "***"; public void loadWords(List<SensitiveWord> words) { dictMap.clear(); for (SensitiveWord sw : words) { String word = sw.getWord().trim(); if (word.isEmpty()) continue; Map<Character, Object> current = dictMap; for (int i = 0; i < word.length(); i++) { char c = word.charAt(i); Object next = current.get(c); if (next == null) { Map<Character, Object> newNode = new HashMap<>(); current.put(c, newNode); current = newNode; } else { current = (Map<Character, Object>) next; } } current.put('\0', null); } } public String filter(String text) { if (text == null || text.isEmpty()) { return text; } StringBuilder result = new StringBuilder(text); for (int i = 0; i < text.length(); i++) { int length = checkSensitiveWord(text, i); if (length > 0) { for (int j = i; j < i + length; j++) { result.setCharAt(j, REPLACEMENT.charAt(0)); } i += length - 1; } } return result.toString(); } @SuppressWarnings("unchecked") private int checkSensitiveWord(String text, int startIndex) { Map<Character, Object> current = dictMap; int length = 0; for (int i = startIndex; i < text.length(); i++) { char c = text.charAt(i); Object next = current.get(c); if (next == null) { break; } length++; current = (Map<Character, Object>) next; if (current.containsKey('\0')) { return length; } } return 0; } } 词库动态重载接口：@GetMapping("/refresh") public Result<Void> refresh() { sensitiveWordService.refreshDict(); return Result.ok(); } 敏感词管理页面7. 拉黑会员系统实现了双层机制：管理员禁言：全站级别，修改 user.status = 0，禁言用户可登录但无法发帖和回帖用户拉黑：个人级别，通过 user_block 表记录，拉黑后看不到对方帖子，对方无法回复自己的帖子操作执行者范围效果禁言管理员全站可登录，但无法发帖、回帖拉黑任何用户个人我看不到他的帖子，他不能回复我的帖子拉黑接口实现：@RestController @RequestMapping("/api/block") @RequiredArgsConstructor public class UserBlockController { private final UserBlockService userBlockService; @PostMapping("/add/{blockedUserId}") public Result<Void> block(@PathVariable Long blockedUserId) { Long userId = StpUtil.getLoginIdAsLong(); userBlockService.block(userId, blockedUserId); return Result.ok(); } @DeleteMapping("/remove/{blockedUserId}") public Result<Void> unblock(@PathVariable Long blockedUserId) { Long userId = StpUtil.getLoginIdAsLong(); userBlockService.unblock(userId, blockedUserId); return Result.ok(); } @GetMapping("/list") public Result<List<UserBlock>> myBlockList() { Long userId = StpUtil.getLoginIdAsLong(); return Result.ok(userBlockService.myBlockList(userId)); } } 帖子列表查询时动态过滤被拉黑用户的帖子：@GetMapping("/list") public Result<IPage<Post>> list(@RequestParam(required = false) Long sectionId, @RequestParam(defaultValue = "1") long page, @RequestParam(defaultValue = "10") long size) { List<Long> blockedIds = Collections.emptyList(); if (StpUtil.isLogin()) { blockedIds = userBlockService.getBlockedUserIds(StpUtil.getLoginIdAsLong()); } if (sectionId != null) { return Result.ok(postService.pageBySectionId(sectionId, page, size, blockedIds)); } return Result.ok(postService.pageAll(page, size, blockedIds)); } 黑名单管理页面8. Discourse 风格 UI系统采用 Discourse 风格的现代论坛 UI 设计，主要特点包括：白底头部：统一的 AppHeader 组件，包含 Logo、用户信息、角色标签、管理入口横向分类标签：版块以彩色标签形式横向排列，点击切换过滤帖子列表：每行显示头像、标题、分类标签、回复数，替代传统表格时间线流式回复：帖子详情页回复以圆点+连线的时间线形式展示底部固定编辑器：回复输入框固定在页面底部，随时可输入浮动发帖按钮：右下角圆形按钮，点击弹出发帖弹窗公共头部组件核心代码：<template> <header class="app-header"> <div class="header-inner"> <div class="header-left" @click="$router.push('/')"> <span class="logo">Forum</span> </div> <div class="header-right"> <span class="user-name">{{ userStore.userInfo?.nickname || '用户' }}</span> <el-tag v-if="userStore.userInfo?.role === 'ADMIN'" type="danger" size="small" effect="dark">管理员</el-tag> <el-tag v-else-if="userStore.userInfo?.role === 'MODERATOR'" color="#e6a23c" size="small" effect="dark" style="color:#fff;border:none">版主</el-tag> <el-tag v-else type="info" size="small" effect="plain">会员</el-tag> <el-button v-if="userStore.userInfo?.role === 'ADMIN' || userStore.userInfo?.role === 'MODERATOR'" text @click="$router.push('/admin')"> <el-icon><Setting /></el-icon> 管理 </el-button> <el-button text @click="$router.push('/blocklist')"> <el-icon><UserFilled /></el-icon> 黑名单 </el-button> <el-button text type="danger" @click="handleLogout"> <el-icon><SwitchButton /></el-icon> 退出 </el-button> </div> </div> </header> </template> 首页帖子列表核心代码：<div v-for="p in posts" :key="p.id" class="post-row" @click="$router.push(`/post/${p.id}`)"> <div class="post-avatar"> <el-avatar :size="36" :style="{ background: sectionColor(p.sectionId) }"> {{ (p.nickname || p.username || '?')[0] }} </el-avatar> </div> <div class="post-body"> <div class="post-title-row"> <el-tag v-if="p.isTop === 1" type="danger" size="small" effect="dark" class="top-tag">置顶</el-tag> <span class="post-title">{{ p.title }}</span> <span class="post-cat" :style="{ background: sectionColor(p.sectionId) + '18', color: sectionColor(p.sectionId) }">{{ p.sectionName }}</span> </div> <div class="post-meta"> <span class="meta-author">{{ p.nickname || p.username }}</span> <span class="meta-dot">·</span> <span class="meta-time">{{ p.createTime }}</span> </div> </div> <div class="post-stats"> <el-icon><ChatDotRound /></el-icon> <span>{{ p.replyCount || 0 }}</span> </div> </div> 首页全貌帖子详情时间线回复六、创新与易用性DFA 敏感词过滤：采用确定有限自动机算法，时间复杂度 O(n)（n为文本长度），与敏感词数量无关；词库支持动态热重载，无需重启服务。拉黑/禁言双层机制：管理员禁言为全站级别（修改 user.status），用户拉黑为个人级别（user_block 表），两者逻辑清晰、互不干扰，分别作用于不同场景。BCrypt 密码加密：使用 BCryptPasswordEncoder 加密存储密码，BCrypt 自带盐值，每次加密结果不同，抗彩虹表攻击。DataInitializer 启动时自动检测并转换明文密码。Discourse 风格 UI：白底头部、横向分类标签、时间线流式回复、底部固定编辑器、浮动发帖按钮，提供现代论坛体验。前后端双重校验：前端表单提交前验证必填项，后端接口同样校验参数非空，避免绕过前端直接提交空数据。数据自动修复：DataInitializer 启动时自动检测并修复中文乱码、明文密码、缺失数据等问题，确保系统开箱即用。七、码道新能力与华为云技术使用使用华为云码道（CodeArts）代码智能体完成全流程开发，从项目搭建、代码生成到功能实现和Bug修复；通过自然语言 Prompt 指导智能体完成数据库设计、CRUD 接口生成、敏感词算法实现、权限配置和 UI 改造；使用浏览器控制能力对 ADMIN、MODERATOR、MEMBER 等真实页面进行验收和截图，避免以 mock 页面冒充后端功能；项目级规则约束技术栈（SpringBoot3 + Vue3）、权限模型（RBAC 三级角色）和内容治理（DFA + 禁言 + 拉黑）。八、测试与验证结果项目完成了前端生产构建和后端编译验证：验证项结果后端编译mvn compile 通过前端生产构建npm run build 通过，所有组件正常打包浏览器真实验收多张页面证据，关键页面功能正常权限验证未登录跳转登录页，MEMBER 不可进入后台验证命令如下：# 后端编译 cd backend mvn compile # 前端生产构建 cd ../frontend npm run build九、本地运行本地开发# 1. 初始化数据库 mysql -u root -p < sql/init.sql # 2. 启动后端 cd backend mvn spring-boot:run # 3. 另开终端启动前端 cd frontend npm install npm run dev访问 http://localhost:5173，后端API端口为 8080。一键启动项目提供了 start.bat 一键启动脚本，双击即可同时启动后端和前端。默认账号账号密码角色adminadmin123ADMINmoderatormod123MODERATORmembermem123MEMBER十、逐项对应评分项项目成果与证据创新易用DFA敏感词O(n)过滤、拉黑/禁言双层机制、BCrypt加密、Discourse风格UI、前后端双重校验、数据自动修复功能完备原题10个功能点全部闭环；登录/注册/发帖/回帖/删帖/置顶/敏感词/禁言/拉黑/版块管理全部实现技术能力码道全流程开发、Sa-Token认证+RBAC、DFA算法、MyBatis-Plus逻辑删除、前后端分离架构文档完整性开发日志、数据库设计、API接口、本地运行说明、默认账号、一键启动脚本完整十一、项目成果总结这次实战让我从"实现一个能发帖的页面"，进一步走到了"构建一个权限正确、内容安全、UI现代、开箱即用的论坛系统"。ForumAdmin 已在本地完成核心功能、生产构建验证和真实页面验收；项目同时保留了开发日志、数据库设计、API接口文档和运行说明，方便评审复现。核心成果：6张数据库表：user / section / post / reply / sensitive_word / user_block，支持逻辑删除和自动时间填充DFA敏感词过滤：O(n)时间复杂度，动态词库热重载拉黑/禁言双层机制：全站禁言与个人屏蔽分离，逻辑清晰BCrypt密码加密：启动自动检测并转换明文密码Discourse风格UI：白底头部、横向分类标签、时间线回复、浮动发帖按钮一键启动：start.bat 双击即可运行

大家好，我本次训练营完成的项目是 CampFlow 训练营成果管理助手。这是一个面向华为云码道暑期实习训练营的 Web 工作台，用来帮助学生把在线学习、CodeArts Agent 辅助开发、项目构建、华为云部署、案例文档发布和最终作品链接提交这些分散任务整合到一个可追踪的流程中。一、项目背景在训练营实践过程中，我发现项目提交并不只是写出一个能运行的页面，还需要同时完成学习进度、CodeArts Agent 使用过程、项目部署、案例文档、附件材料和最终链接提交。任务节点比较分散，如果只靠临时记录，很容易出现材料遗漏、演示链接忘记回填、评分维度没有证据支撑等问题。因此我设计了 CampFlow，希望它既是一个可运行的训练营成果管理应用，也能反向辅助我整理最终提交材料。它把指导书中的评分维度和提交要求产品化，形成项目档案、里程碑、评分证据、智能体提示词和案例文档生成几个模块，让整个实习项目从开发到提交都更加清晰。二、作品链接作品演示地址：https://campflow-demo-20260727.fangtianchen3.chatgpt.site/案例中心链接：https://devstation.connect.huaweicloud.com/space/devportal/casecenter/11272f6a85244aad99d738b32bac093c/2三、技术选型本项目采用纯静态前端方案，核心技术如下：- CodeArts Agent：辅助需求分析、架构设计、功能开发、测试部署和案例文档整理- HTML / CSS / JavaScript：实现页面结构、交互逻辑和响应式布局- localStorage：在浏览器本地保存项目档案、里程碑、评分证据和开发记录- 华为云 OBS：托管静态网站并提供公网访问地址- Node.js assert：对得分计算、数据模型和文档生成逻辑进行基础测试选择纯静态方案的原因是训练营项目更看重完整交付闭环。静态 Web 应用部署简单、依赖少、访问稳定，适合快速完成从代码构建到华为云部署的全过程。四、需求分析根据训练营指导书，项目成果需要包含可运行应用、案例文档、演示链接或视频，并且 Web 类应用需要部署到华为云。评分维度包括创新易用、功能完备、技术能力、文档完整性和参与度。围绕这些要求，我将需求拆成五个方向：1. 成果管理：记录项目名称、应用方向、技术栈、演示链接和案例链接。2. 过程管理：把学习、开发、部署、发布等训练营节点转化为里程碑。3. 智能体协作：自动生成适合 CodeArts Agent 的阶段性提示词。4. 评分证据：按评分维度整理证据项、完成状态、说明和链接。5. 文档发布：根据项目档案和证据清单生成案例 Markdown 草稿。这样做的好处是，项目不只是“做完一个页面”，而是把提交要求转化成了可以持续检查的工作流。五、系统架构设计CampFlow 的整体结构比较轻量：```text用户浏览器  ├─ index.html：应用入口  ├─ assets/styles.css：界面样式和响应式布局  ├─ assets/app.js：状态管理、评分计算、提示词生成和 Markdown 生成  └─ localStorage：保存项目档案、评分证据、里程碑和开发记录```项目没有引入后端服务，所有数据保存在浏览器本地。对于训练营展示场景来说，这种方案可以降低部署复杂度，也避免后端账号、数据库和接口联调带来的额外成本。六、CodeArts Agent 辅助开发过程本项目按照 vibe coding 的思路使用 CodeArts Agent。我的实践方式不是一次性让智能体直接生成全部代码，而是分阶段推进：第一阶段是需求分析。我先让 CodeArts Agent 根据指导书梳理项目目标、评分维度和必须交付的材料，避免项目范围跑偏。第二阶段是架构设计。我让智能体输出静态前端架构、本地存储数据模型，以及每个页面模块需要承担的职责。第三阶段是功能开发。根据模块拆分，逐步实现仪表盘、项目档案、提示词生成、评分证据、案例文档生成和部署清单。第四阶段是调试验证。重点检查评分计算是否符合权重、localStorage 是否能正常保存、Markdown 文档是否能完整生成、部署文件是否齐全。第五阶段是文档整理。最后让智能体辅助把开发过程、部署步骤、项目亮点和总结整理成案例中心与论坛都能使用的材料。通过这种分阶段协作，CodeArts Agent 更像一个项目搭档，而不是简单的代码生成器。它帮助我把任务拆小，也让我在每一步都有可检查的输出。七、核心功能介绍1. 仪表盘：展示预计得分、证据完成数量、里程碑完成数量，并按指导书权重拆解评分维度。2. 项目档案：维护项目名称、应用方向、真实问题、解决方案、技术栈、考试状态、演示链接和案例链接。3. CodeArts 提示词生成：根据项目当前状态生成需求分析、架构设计、功能开发、调试部署和案例文档五类提示词，方便继续与智能体协作。4. 评分证据清单：按照创新易用、功能完备、技术能力、文档完整性和参与度五个维度组织证据项，支持完成状态和说明记录。5. 案例文档生成器：把项目档案、评分证据和开发记录拼装成 Markdown 草稿，减少最终发布时遗漏章节的风险。6. 部署清单：列出静态网站部署需要上传的文件，并提醒检查 OBS 桶、静态网站首页、公开访问策略和演示链接。八、部署过程项目最终部署在华为云 OBS 静态网站托管上。部署步骤如下：1. 创建 OBS 桶 `campflow-tj-20260726`，区域选择华东-上海一 `cn-east-3`。2. 上传静态网站文件，根目录包含 `index.html`，`assets` 目录包含 `app.js` 和 `styles.css`。3. 开启静态网站托管，默认首页设置为 `index.html`。4. 创建桶策略 `campflow-public-read`，允许公网读取静态网站对象。5. 访问 OBS 静态网站地址，确认页面可以正常打开。验证结果：- 首页 HTTP 状态为 200- 页面内容包含 CampFlow- 静态网站公网地址可访问九、测试与验收项目包含基础逻辑测试，主要验证数据模型、评分计算和文档生成相关逻辑。测试通过后，我又进行了浏览器访问检查，确认页面能够在本地和 OBS 环境中正常运行。验收时重点检查了以下内容：- 页面能正常加载- 仪表盘数据能展示- 表单内容能保存到 localStorage- 提示词能够生成- 案例文档能够生成- OBS 演示链接能够公网访问- 案例中心附件 PDF 小于 20MB十、遇到的问题与解决方式第一个问题是提交材料分散。训练营要求包含代码、部署、案例文档、演示链接等内容，开始时容易只关注开发本身，忽略最终提交材料。因此我把这些要求做成了应用中的评分证据和部署清单。第二个问题是静态部署的公开访问配置。OBS 上传文件后，如果没有正确配置静态网站托管和公开读策略，外部访问会失败。最后通过设置默认首页 `index.html` 和桶策略 `campflow-public-read` 解决。第三个问题是论坛和案例中心链接类型不同。案例中心链接用于案例提交，OBS 链接用于作品演示，而论坛链接用于社区帖子展示。理解这三类链接的区别后，最终提交路径就清晰了。## 十一、项目总结CampFlow 是一次围绕训练营真实提交场景设计的小型工具实践。它不只是一个静态页面，而是把 CodeArts Agent 使用过程、评分标准、部署清单和案例文档整理流程放在同一个工作台里。通过这个项目，我完成了从需求分析、智能体辅助开发、本地测试、OBS 部署、案例中心提交到论坛发布材料整理的完整闭环。后续如果继续扩展，可以加入截图上传、多人协作、华为云登录和一键生成提交材料等能力，让它从个人训练营工具升级为更通用的项目交付助手。以上就是我的训练营项目实践分享，欢迎大家交流指正。

大家好，我本次训练营完成的项目是 **CampFlow 训练营成果管理助手**。这是一个面向华为云码道暑期实习训练营的 Web 工作台，用来帮助学生把在线学习、CodeArts Agent 辅助开发、项目构建、华为云部署、案例文档发布和最终作品链接提交这些分散任务整合到一个可追踪的流程中。## 一、项目背景在训练营实践过程中，我发现项目提交并不只是写出一个能运行的页面，还需要同时完成学习进度、CodeArts Agent 使用过程、项目部署、案例文档、附件材料和最终链接提交。任务节点比较分散，如果只靠临时记录，很容易出现材料遗漏、演示链接忘记回填、评分维度没有证据支撑等问题。因此我设计了 CampFlow，希望它既是一个可运行的训练营成果管理应用，也能反向辅助我整理最终提交材料。它把指导书中的评分维度和提交要求产品化，形成项目档案、里程碑、评分证据、智能体提示词和案例文档生成几个模块，让整个实习项目从开发到提交都更加清晰。## 二、作品链接作品演示地址：https://campflow-tj-20260726.obs-website.cn-east-3.myhuaweicloud.com/案例中心链接：https://devstation.connect.huaweicloud.com/space/devportal/casecenter/11272f6a85244aad99d738b32bac093c/2## 三、技术选型本项目采用纯静态前端方案，核心技术如下：- CodeArts Agent：辅助需求分析、架构设计、功能开发、测试部署和案例文档整理- HTML / CSS / JavaScript：实现页面结构、交互逻辑和响应式布局- localStorage：在浏览器本地保存项目档案、里程碑、评分证据和开发记录- 华为云 OBS：托管静态网站并提供公网访问地址- Node.js assert：对得分计算、数据模型和文档生成逻辑进行基础测试选择纯静态方案的原因是训练营项目更看重完整交付闭环。静态 Web 应用部署简单、依赖少、访问稳定，适合快速完成从代码构建到华为云部署的全过程。## 四、需求分析根据训练营指导书，项目成果需要包含可运行应用、案例文档、演示链接或视频，并且 Web 类应用需要部署到华为云。评分维度包括创新易用、功能完备、技术能力、文档完整性和参与度。围绕这些要求，我将需求拆成五个方向：1. 成果管理：记录项目名称、应用方向、技术栈、演示链接和案例链接。2. 过程管理：把学习、开发、部署、发布等训练营节点转化为里程碑。3. 智能体协作：自动生成适合 CodeArts Agent 的阶段性提示词。4. 评分证据：按评分维度整理证据项、完成状态、说明和链接。5. 文档发布：根据项目档案和证据清单生成案例 Markdown 草稿。这样做的好处是，项目不只是“做完一个页面”，而是把提交要求转化成了可以持续检查的工作流。## 五、系统架构设计CampFlow 的整体结构比较轻量：```text用户浏览器  ├─ index.html：应用入口  ├─ assets/styles.css：界面样式和响应式布局  ├─ assets/app.js：状态管理、评分计算、提示词生成和 Markdown 生成  └─ localStorage：保存项目档案、评分证据、里程碑和开发记录```项目没有引入后端服务，所有数据保存在浏览器本地。对于训练营展示场景来说，这种方案可以降低部署复杂度，也避免后端账号、数据库和接口联调带来的额外成本。## 六、CodeArts Agent 辅助开发过程本项目按照 vibe coding 的思路使用 CodeArts Agent。我的实践方式不是一次性让智能体直接生成全部代码，而是分阶段推进：第一阶段是需求分析。我先让 CodeArts Agent 根据指导书梳理项目目标、评分维度和必须交付的材料，避免项目范围跑偏。第二阶段是架构设计。我让智能体输出静态前端架构、本地存储数据模型，以及每个页面模块需要承担的职责。第三阶段是功能开发。根据模块拆分，逐步实现仪表盘、项目档案、提示词生成、评分证据、案例文档生成和部署清单。第四阶段是调试验证。重点检查评分计算是否符合权重、localStorage 是否能正常保存、Markdown 文档是否能完整生成、部署文件是否齐全。第五阶段是文档整理。最后让智能体辅助把开发过程、部署步骤、项目亮点和总结整理成案例中心与论坛都能使用的材料。通过这种分阶段协作，CodeArts Agent 更像一个项目搭档，而不是简单的代码生成器。它帮助我把任务拆小，也让我在每一步都有可检查的输出。## 七、核心功能介绍1. 仪表盘：展示预计得分、证据完成数量、里程碑完成数量，并按指导书权重拆解评分维度。2. 项目档案：维护项目名称、应用方向、真实问题、解决方案、技术栈、考试状态、演示链接和案例链接。3. CodeArts 提示词生成：根据项目当前状态生成需求分析、架构设计、功能开发、调试部署和案例文档五类提示词，方便继续与智能体协作。4. 评分证据清单：按照创新易用、功能完备、技术能力、文档完整性和参与度五个维度组织证据项，支持完成状态和说明记录。5. 案例文档生成器：把项目档案、评分证据和开发记录拼装成 Markdown 草稿，减少最终发布时遗漏章节的风险。6. 部署清单：列出静态网站部署需要上传的文件，并提醒检查 OBS 桶、静态网站首页、公开访问策略和演示链接。## 八、部署过程项目最终部署在华为云 OBS 静态网站托管上。部署步骤如下：1. 创建 OBS 桶 `campflow-tj-20260726`，区域选择华东-上海一 `cn-east-3`。2. 上传静态网站文件，根目录包含 `index.html`，`assets` 目录包含 `app.js` 和 `styles.css`。3. 开启静态网站托管，默认首页设置为 `index.html`。4. 创建桶策略 `campflow-public-read`，允许公网读取静态网站对象。5. 访问 OBS 静态网站地址，确认页面可以正常打开。验证结果：- 首页 HTTP 状态为 200- 页面内容包含 CampFlow- 静态网站公网地址可访问## 九、测试与验收项目包含基础逻辑测试，主要验证数据模型、评分计算和文档生成相关逻辑。测试通过后，我又进行了浏览器访问检查，确认页面能够在本地和 OBS 环境中正常运行。验收时重点检查了以下内容：- 页面能正常加载- 仪表盘数据能展示- 表单内容能保存到 localStorage- 提示词能够生成- 案例文档能够生成- OBS 演示链接能够公网访问- 案例中心附件 PDF 小于 20MB## 十、遇到的问题与解决方式第一个问题是提交材料分散。训练营要求包含代码、部署、案例文档、演示链接等内容，开始时容易只关注开发本身，忽略最终提交材料。因此我把这些要求做成了应用中的评分证据和部署清单。第二个问题是静态部署的公开访问配置。OBS 上传文件后，如果没有正确配置静态网站托管和公开读策略，外部访问会失败。最后通过设置默认首页 `index.html` 和桶策略 `campflow-public-read` 解决。第三个问题是论坛和案例中心链接类型不同。案例中心链接用于案例提交，OBS 链接用于作品演示，而论坛链接用于社区帖子展示。理解这三类链接的区别后，最终提交路径就清晰了。## 十一、项目总结CampFlow 是一次围绕训练营真实提交场景设计的小型工具实践。它不只是一个静态页面，而是把 CodeArts Agent 使用过程、评分标准、部署清单和案例文档整理流程放在同一个工作台里。通过这个项目，我完成了从需求分析、智能体辅助开发、本地测试、OBS 部署、案例中心提交到论坛发布材料整理的完整闭环。后续如果继续扩展，可以加入截图上传、多人协作、华为云登录和一键生成提交材料等能力，让它从个人训练营工具升级为更通用的项目交付助手。以上就是我的训练营项目实践分享，欢迎大家交流指正。

一、案例介绍1.1 案例流程本次项目为期两周，依托华为开发者空间及华为云码道（CodeArts）代码智能体，完成"单词闯关"Web应用的全流程开发。具体日程安排如下：          1.2  适用对象                        ·高校学生                       ·个人开发者        1.3 资源总览                              本案例预计花费39元（使用训练营代金券）  资源名称规格单价（元） 华为云码道代码智能体基础版39         二、环境和资源准备华为云码道（CodeArts）代码智能体：集代码大模型、AI IDE、Code Agent为一体的智能编码产品。具  备强大的需求理解、架构设计和代码生成能力，支持智能体模式自动规划并执行复杂开发任务。本案例中作为开发平台，通过对话式交互快速完成固定资产管理系统的需求分析、架构设计和SDD文档生成。AI IDE华为云码道开发环境搭建本次实习使用华为开发者空间提供的云开发环境（ARM | 4 vCPUs 8GB | Ubuntu 24.04 Server定制版），配合华为云码道（CodeArts）代码智能体进行辅助开发。CodeArts代码智能体能够根据自然语言描述自动生成代码、定位Bug、解释代码逻辑，显著提升了开发效率。项目采用纯前端技术栈，无需后端服务器，使用HTML5 + CSS3 + JavaScript（ES6）开发，数据存储使用浏览器localStorage，无需数据库依赖。项目通过本地文件系统直接运行，使用浏览器打开index.html即可体验完整功能。CodeArts辅助开发工具在整个开发过程中，华为云码道（CodeArts）代码智能体发挥了关键作用，主要体现在以下几个方面：（1）需求理解与架构设计：通过自然语言描述项目需求（"2D背单词闯关游戏，结合搜打撤地图玩法"），CodeArts能够快速理解需求并生成项目目录结构、模块划分建议。例如，它建议将项目拆分为data（数据层）、js（逻辑层）、css（样式层）、assets（资源层）四个核心目录，实践证明这一划分清晰合理。（2）代码生成与迭代：CodeArts根据功能描述直接生成模块代码。以地图生成模块为例，描述"动态生成10×10地图，30%概率生成墙壁，BFS验证起点到终点可达性"后，CodeArts生成了完整的generateMap()函数，包含墙壁随机放置、BFS可达性检测、不可达时逐步移除墙壁等逻辑。后续迭代中，发现直接清空所有墙壁会导致无墙地图的问题，CodeArts准确识别了这一Bug并修复为逐步移除策略。（3）Bug定位与修复：开发过程中遇到多个典型Bug，CodeArts均能快速定位根因。例如：箱子搜索动画期间拖拽物品会重复触发事件监听器导致物品复制，CodeArts识别出setupBoxDrop()被重复调用的问题，引入boxDropInitialized标志防止重复绑定；背包中同ID物品的removeItem()会误删所有实例，CodeArts提出使用唯一实例ID（uid）替代直接存储itemId的方案，从根本上解决了冲突问题。（4）性能优化：当页面出现卡顿时，CodeArts分析出两个性能瓶颈——render()函数在按键长按时每秒触发30-40次全量重绘，以及墙壁查找使用Array.some()导致O(n)复杂度。它给出了requestAnimationFrame帧节流和Set数据结构优化的解决方案，有效改善了页面流畅度。三、项目介绍3.1 项目简介本次开发采用HTML5 Canvas（地图渲染）+ Web前端技术（HTML/CSS/JS）+ 华为云码道CodeArts代码智能体（辅助开发），这是一款将英语词汇学习与2D地图探索游戏相结合的Web应用，采用"搜打撤"（搜索-打击-撤离）玩法，让背单词变得有趣且富有挑战性。以下是核心功能：核心功能说明背单词支持雅思/GRE两套词书，Fisher-Yates算法随机打乱顺序，浏览式学习，完成当日任务后解锁地图游戏地图游戏10×10动态生成地图，BFS保证可达性，WASD操控角色移动，探索保险箱、走向撤离点双保险箱普通保险箱（直接搜索开启）与密码保险箱（需答5道单词题，正确率≥60%方可开启，稀有度更高）搜索动画打开保险箱时物品逐个搜索揭示，灰色底+旋转加载图标，每800ms揭示一个背包系统6×6网格，支持不同尺寸物品（1×1到3×3），拖拽拾取/丢弃/重排，双击自动拾取，碰撞检测收藏品70种收藏品（紫色普通29种/金色稀有30种/红色传说11种），带PNG图片和slots二维数组描述形状仓库展示撤离成功后收藏品持久化到仓库，按稀有度分类展示，未收集的显示"???"统计今日学习数、连续学习天数、总计学习数操作流程1. 在"设置"页选择词书和每日数量2. 在"背单词"页完成当日学习任务3. 进入"地图游戏"，WASD移动角色探索地图4. 走到保险箱自动打开搜索界面，拖拽物品到背包拾取5. 走到密码保险箱需答题开锁，获取更高稀有度物品6. 到达EXIT撤离点完成游戏，背包物品存入仓库3.2 系统架构设计本应用采用模块化前端架构，各模块职责清晰、松耦合协作。系统架构如下：├── index.html          // 主页面，含所有模态框HTML结构├── css/│   └── style.css       // 全局样式（网格/拖拽/搜索动画/稀有度配色）├── js/│   ├── data.js         // 数据加载模块（fetch JSON词库与收藏品）│   ├── storage.js      // localStorage持久化管理│   ├── settings.js     // 设置模块（词书选择/每日数量）│   ├── learn.js        // 背单词模块（Fisher-Yates随机/浏览式学习）│   ├── game.js         // 地图游戏核心（地图生成/移动/保险箱/答题）│   ├── backpack.js     // 背包系统（6×6网格/uid实例管理/碰撞检测/拖拽）│   ├── warehouse.js    // 仓库展示模块│   ├── stats.js        // 统计模块│   └── app.js          // 主应用逻辑（页面导航/模块初始化）├── data/│   ├── ielts.json      // 雅思词库（100词）│   ├── gre.json        // GRE词库（100词）│   └── collections.json // 收藏品数据（70项，含slots二维数组）└── assets/             // 70个PNG收藏品图片 + 2个保险箱图片数据流设计：词库数据通过fetch异步加载，收藏品数据包含slots二维数组描述物品在背包网格中的占用形状。游戏状态（地图、背包、保险箱）在单次游戏会话中维护，撤离成功后背包物品通过localStorage持久化到仓库。3.3 核心功能实现本应用"单词闯关"成功将英语词汇学习与2D地图探索游戏相结合，通过"搜打撤"玩法（搜索保险箱→答题开锁→拾取收藏品→安全撤离）将枯燥的背单词过程转化为有趣的游戏体验。核心技术方案包括：（1）模块化前端架构：9个JS模块各司其职，数据层（data.js/storage.js）与逻辑层（learn.js/game.js/backpack.js）分离，便于维护和扩展。（2）uid唯一实例ID机制：解决了背包系统中同ID物品共存的核心难题，是整个背包系统稳定运行的基石。（3）BFS地图生成算法：保证地图可达性的同时保留足够的墙壁和障碍，提供良好的探索体验。（4）双保险箱设计：普通保险箱与密码保险箱的差异化管理（开启方式、稀有度权重、物品数量）增加了游戏策略深度。（5）华为云码道（CodeArts）代码智能体辅助开发：从需求理解到Bug修复，CodeArts贯穿开发全流程，显著提升了开发效率和代码质量。3.2.1 背单词模块背单词模块采用浏览式学习交互，用户点击"记住了"按钮依次浏览当日单词。单词顺序使用Fisher-Yates洗牌算法随机打乱，确保每次学习顺序不同。词库支持雅思和GRE两套词书，切换词书时自动重置今日单词列表。完成当日学习任务后方可进入地图游戏，将学习与游戏形成正向激励闭环。以下是随机词序的代码模块：// learn.js — Fisher-Yates洗牌shuffleArray(array) {    for (let i = array.length - 1; i > 0; i--) {        const j = Math.floor(Math.random() * (i + 1));        [array[i], array[j]] = [array[j], array[i]];    }    return array;}3.2.2 地图游戏模块地图游戏是本应用的核心玩法，采用"搜打撤"（搜索-打击-撤离）模式。关键技术点包括：（1）动态地图生成：10×10网格，30%概率随机生成墙壁。使用BFS（广度优先搜索）验证起点(0,0)到终点(9,9)的可达性，若不可达则逐步移除墙壁直至可达，避免直接清空所有墙壁导致地图无遮挡。（2）保险箱系统：地图上分布两种保险箱——普通保险箱（灰色，直接搜索开启）和密码保险箱（金棕色，需答5道单词题且正确率≥60%方可开启）。密码保险箱的收藏品稀有度更高（权重：普通40/稀有45/传说15 vs 普通60/稀有30/传说10），且物品数量更多（3-4个 vs 2-3个）。保险箱开启后保留在地图上，玩家可返回拾取遗漏物品。（3）搜索动画：打开保险箱时，物品逐个"搜索"呈现——未搜索的物品显示灰色底色加白色旋转加载图标，每800ms揭示一个物品，搜索完成后才可拖拽拾取。这一设计增强了游戏的沉浸感和期待感。以下是核心代码：// game.js — 地图生成核心代码generateMap() {    const size = 10;    this.state.map = { size: size };     const walls = new Set();    for (let y = 0; y < size; y++) {        for (let x = 0; x < size; x++) {            if (Math.random() < 0.3 && !(x === 0 && y === 0)) {                walls.add(`${x},${y}`);            }        }    }     const exit = { x: size - 1, y: size - 1 };    walls.delete(`${exit.x},${exit.y}`);     // BFS验证可达性，不可达则逐步移除墙壁    let attempts = 0;    while (!this.isReachable(0, 0, exit.x, exit.y, walls, size) && attempts < 200) {        const wallArray = Array.from(walls);        if (wallArray.length === 0) break;        const randomWall = wallArray[Math.floor(Math.random() * wallArray.length)];        walls.delete(randomWall);        attempts++;    }     // 在可达区域随机放置保险箱    const reachable = this.getReachableCells(0, 0, walls, size);    const normalBoxCount = 3 + Math.floor(Math.random() * 3);    const quizBoxCount = 2 + Math.floor(Math.random() * 2);    // ... 放置逻辑省略     this.state.walls = Array.from(walls).map(key => {        const [x, y] = key.split(',').map(Number);        return { x, y };    });    this.state.boxes = boxes;    this.state.exit = exit;    this.buildWallSet();  // 预构建Set用于O(1)查找}3.2.3 背包系统背包系统是本应用最复杂的模块，参考"三角洲行动"的物品管理系统设计，关键技术难点及解决思路如下：（1）网格碰撞检测：背包为6×6网格，每个收藏品有不同尺寸（1×1到3×3），用slots二维数组描述占用形状。canPlace()函数遍历slots数组，检查目标区域所有格子是否均未被占用且不越界。（2）唯一实例ID管理：这是开发过程中遇到的核心技术难点。最初背包网格直接存储itemId，当两个同ID物品同时存在于背包时，removeItem()按ID删除会误删所有同ID实例，导致物品消失或数据错乱。解决方案是引入uid（唯一实例ID）机制——每次placeItem()时生成全局递增的uid，网格存储uid而非itemId，通过_uidMap（Map数据结构）映射uid到itemId。removeItem()按uid删除，精确移除单个实例，彻底解决同ID物品冲突问题。（3）拖拽交互：支持从保险箱拖拽物品到背包（拾取）、从背包拖拽物品到保险箱（丢弃）、背包内拖拽重排。拖拽时通过dataTransfer传递uid、itemId、context（来源标识）和originRow/originCol（原始位置），目标区域根据context判断操作类型。双击保险箱物品可自动拾取（autoPlace自动寻找空位）。（4）事件监听器重复绑定问题：在搜索动画期间，refreshLootUI()会重建DOM并重新绑定事件监听器。setupBoxDrop()对保险箱容器添加drop事件监听，若每次刷新都重新绑定，会导致同一容器上叠加多个监听器，拖拽丢弃时触发多次从而复制物品。解决方案是引入boxDropInitialized标志，确保drop监听器只绑定一次。以下是核心代码：// backpack.js — uid实例管理核心代码const Backpack = {    GRID_SIZE: 6,    CELL_PX: 50,    _uidCounter: 0,    _uidMap: new Map(),          // uid -> itemId 映射     getItemId(uid) {        return this._uidMap.get(uid) || null;    },     placeItem(grid, itemId, row, col) {        const item = DataManager.getCollection(itemId);        if (!item) return false;        if (!this.canPlace(grid, item, row, col)) return false;        const uid = ++this._uidCounter;       // 生成唯一实例ID        this._uidMap.set(uid, itemId);         // 建立映射        const slots = item.slots;        for (let r = 0; r < slots.length; r++) {            for (let c = 0; c < slots[r].length; c++) {                if (slots[r][c] === 1) {                    grid[row + r][col + c] = uid;  // 网格存uid而非itemId                }            }        }        return uid;    },     removeItem(grid, uid) {        for (let r = 0; r < this.GRID_SIZE; r++) {            for (let c = 0; c < this.GRID_SIZE; c++) {                if (grid[r][c] === uid) {                    grid[r][c] = null;        // 按uid精确删除，不影响同ID其他实例                }            }        }        this._uidMap.delete(uid);    },     getItemsInGrid(grid) {        const items = [];        const seen = new Set();        for (let r = 0; r < this.GRID_SIZE; r++) {            for (let c = 0; c < this.GRID_SIZE; c++) {                const uid = grid[r][c];                if (uid !== null && !seen.has(uid)) {                    seen.add(uid);                    const itemId = this._uidMap.get(uid);                    if (itemId !== undefined) items.push(itemId);                }            }        }        return items;    }};3.2.4 收藏品系统收藏品数据基于assets文件夹中的70个PNG图片文件定义，每项包含id、name、rarity（common/rare/legendary）、width、height、slots二维数组、image文件名和description。稀有度对应三种颜色边框：紫色（普通）、金色（稀有）、红色（传说）。物品在背包和仓库中均显示对应的PNG图片，而非文字名称。四、性能优化开发后期页面出现明显卡顿，经分析发现两个性能瓶颈并逐一解决：（1）渲染帧节流：原render()函数在每次按键移动时直接调用，长按方向键时每秒触发30-40次全量Canvas重绘。引入scheduleRender()方法，使用requestAnimationFrame将渲染调用合并到浏览器刷新周期，确保每帧最多重绘一次，显著降低CPU占用。（2）墙壁查找优化：原实现使用Array.some()遍历墙壁数组判断某格是否为墙，对于10×10地图每帧需100次查找，每次O(n)复杂度。改为在地图生成时构建Set数据结构（_wallSet），查找复杂度降为O(1)，render()和movePlayer()均受益。五、技术难点与解决思路5.1 背包同ID物品冲突问题描述：当保险箱中刷出与背包中已有物品相同ID的收藏品时，双击拾取后物品消失；拖拽丢弃时物品被大量复制。根因分析：背包网格直接存储itemId，removeItem()按itemId遍历删除所有匹配格子。当两个同ID物品共存时，删除操作会误删另一个实例的所有格子，导致数据错乱。解决方案：引入uid（唯一实例ID）机制。每次placeItem()生成全局递增uid存入网格，通过Map映射uid→itemId。removeItem()改为按uid精确删除单个实例，getItemsInGrid()按uid去重后映射回itemId列表。此方案从数据模型层面彻底解决了同ID物品冲突，所有上层操作（拖拽、双击、丢弃）无需特殊处理。5.2 事件监听器重复绑定问题描述：将背包物品拖拽到保险箱丢弃时，物品被复制出多份。根因分析：refreshLootUI()每次调用时重建DOM并重新调用setupBoxDrop()绑定drop事件。由于drop监听器绑定在容器元素上（而非子元素），innerHTML重建子元素不影响容器上的监听器，导致每次刷新叠加一个新监听器，拖拽时触发N次回调。解决方案：引入boxDropInitialized状态标志，setupBoxDrop()首次绑定后设为true，后续调用直接返回，确保drop监听器只绑定一次。5.3 地图可达性保证问题描述：随机生成墙壁后，起点到终点可能不可达；简单清空所有墙壁会导致无遮挡的空旷地图。解决方案：使用BFS检测可达性，若不可达则随机移除一面墙壁，重复检测直到可达。设置200次上限防止死循环。此策略在保证可达性的同时最大程度保留墙壁，维持地图的探索性。5.4 Canvas渲染性能问题描述：页面操作时出现明显卡顿，尤其在长按方向键移动角色时。解决方案：①使用requestAnimationFrame将render()调用合并到浏览器刷新周期，避免同一帧内多次重绘；②将墙壁数据从Array改为Set，查找复杂度从O(n)降为O(1)；③在地图生成时预构建wallSet，避免每次render重复计算。六、扩展资料6.1 源码仓库GitCode 公开仓库 lowfllly/huawei_internship默认分支：main6.2 开源内容边界公开仓库提供复现本案例所需的应用源码、测试、部署脚本和设计文档；训练营内部培训材料、个人凭据、本地开发工具配置及运行期数据按 .gitignore 与安全要求不纳入仓库。评审时建议先体验公网环境，再对照仓库中的实现、测试和设计文档核验关键功能。

码道赋能：EduGuide AI智能学习助教系统开发（FastAPI + React）案例介绍本案例依托华为云码道（CodeArts）代码智能体快速完成 EduGuide AI智能学习助教系统项目开发。EduGuide 是一款基于双层数据架构的 AI 驱动学习助手：全局资料库层支持用户上传 PDF/PPTX/DOCX/EPUB 等学习材料或搜索在线书籍，系统自动构建向量知识库（ChromaDB）；项目学习空间层由 AI Agent 自动生成个性化学习路径，通过多轮互动问答、自动测验出题评分、错题追踪与掌握度分析，驱动自适应学习闭环。项目采用 FastAPI + React 19 前后端分离架构，集成 DeepSeek（文本LLM）与 Qwen-VL（视觉模型）双 AI 通道，熔断器保障服务高可用。案例内容 完整案例在线体验地址： EduGuide AI智能学习助教系统（https://kayson.tech/）EduGuide 案例基于 AI 生成搭建，每次生成的项目效果略有不同，如需完整体验该案例可在源码处下载并体验。一、概述1.1 案例介绍本案例依托华为云码道快速完成 EduGuide AI智能学习助教系统项目开发。系统核心能力包括：智能资料管理：支持 PDF/PPTX/DOCX/EPUB/图片上传，AI自动解析提取文本；支持 Z-Library、Project Gutenberg、Library Genesis 三大书源在线搜索导入AI Agent 自适应学习：Agent 多阶段工作流（研究→大纲→教学方案→互动授课），SSE流式实时输出讲解内容多风格互动教学：支持苏格拉底式、隐喻式、严谨式、鼓励式四种教学风格，多轮问答+自由提问智能测验与评分：AI自动生成章节测验（选择/填空/简答/判断/论述），支持图片题AI评分学习报告与错题追踪：掌握度雷达图、薄弱知识点分析、错题重做、学习数据导出案例技术选型：层技术后端FastAPI (Python 3.11+) + SQLAlchemy 2.0 async + Alembic数据库PostgreSQL 16 + Redis 7 + ChromaDBAIDeepSeek (文本) + Qwen-VL (视觉) + sentence-transformers (嵌入)前端React 19 + TypeScript 6 + Ant Design 6 + Zustand 5 + Vite 8部署Nginx (反向代理) + Docker Compose华为云码道（CodeArts）代码智能体：一个理解项目需求，懂得编码之道，善用百器的实干派AI研发专家，开启你的编码自动驾驶模式。本案例中作为核心开发工具，通过智能体模式快速构建 EduGuide AI智能学习助教系统项目代码。EduGuide系统首页效果图1.2 适用对象企业个人开发者高校学生1.3 案例时间本案例总时长预计2小时。1.4 案例流程说明：开发者安装华为云码道 CodeArts 代码智能体；Python 3.11+ 安装配置；Node.js 20+ 安装配置；安装 Docker Desktop（含 Docker Compose）；从 GitHub 克隆 EduGuide 源码到本地；使用华为云码道理解项目代码结构与功能，完成环境配置、数据库初始化与项目启动验证；使用华为云码道进行功能扩展与调试优化。案例流程图1.5 资源总览本案例预计花费如下。资源名称规格 华为云码道（CodeArts）代码智能体专业版 DeepSeek API按量计费 Qwen-VL API按量计费 二、基础环境与资源准备2.1 AI IDE 华为云码道安装部署访问此专属开通链接，免费开通华为云码道（CodeArts）代码智能体体验版，无需复杂配置：一键开通华为云码道体验版！参考案例《AI IDE华为云码道（CodeArts）代码智能体安装部署》完成 Windows 版 AI IDE 华为云码道（CodeArts）代码智能体安装部署。华为云码道IDE主界面2.2 Python 3.11+ 安装配置FastAPI 后端运行依赖 Python 环境。使用快捷键 `Ctrl+Shift+``，新建 AI IDE 终端，输入以下命令查看 Python 环境是否安装？python --version如果没有安装，请参考案例《SKILL快速构建你的Java、Python和Node.js开发环境》一键配置 Python 开发环境。2.3 Node.js 20+ 安装配置React 19 + Vite 8 前端构建依赖 Node.js 环境（需 Node >= 20.19，因为 rolldown 导入 node:util 的 styleText，Node 18 不可用）。使用快捷键 `Ctrl+Shift+``，新建 AI IDE 终端，输入以下命令查看 Node.js 环境是否安装？node --version如果没有安装，请与码道对话，让码道帮助我们下载 Node.js 并配置环境变量。2.4 安装 Docker DesktopDocker Desktop 提供 Docker 引擎与 Docker Compose 编排能力，用于一键启动 PostgreSQL、Redis、后端、前端四个服务。参考 Docker 官方文档安装 Docker Desktop for Windows。安装完成后，在终端验证：docker --versiondocker compose version2.5 获取 AI API 密钥EduGuide 集成双 AI 通道，需分别获取 API 密钥：DeepSeek（文本LLM）：访问 DeepSeek 开放平台注册并获取 API Key，用于讲解生成、测验出题、评分、对话等文本智能能力。Qwen-VL（视觉模型）：访问阿里云百炼平台开通 Qwen-VL 模型并获取 API Key，用于图片资料的文字提取与理解。提示：两个平台均提供免费额度，足够开发调试使用。三、构建 EduGuide 应用3.1 部署项目代码项目技术栈层技术后端FastAPI (Python 3.11+) + SQLAlchemy 2.0 async + Alembic数据库PostgreSQL 16 + Redis 7 + ChromaDBAIDeepSeek (文本) + Qwen-VL (视觉) + sentence-transformers (嵌入)前端React 19 + TypeScript 6 + Ant Design 6 + Zustand 5 + Vite 8部署Nginx (反向代理) + Docker ComposeEduGuide系统架构图从 GitHub 克隆源码在码道终端中，输入以下命令将 EduGuide 源码克隆到本地：git clone https://github.com/HJGisfh/eduguide.gitcd eduguide3.2 码道理解项目代码结构与功能克隆完成后，让码道帮助我们理解整个项目的代码结构与功能。在码道对话框中，输入以下提示词：请分析当前 EduGuide 项目的完整代码结构，包括：1. 后端目录结构（api/models/services/schemas/ai/knowledge/infra 各模块职责）2. 前端目录结构（pages/components/store/services 各模块职责）3. 核心业务流程（用户上传资料→创建项目→Agent工作流→互动学习→测验评估的完整数据流）4. AI双通道架构（DeepSeek文本+Qwen-VL视觉+熔断器机制）5. 向量知识库RAG检索流程码道将自动分析项目代码，输出完整的项目架构说明，帮助开发者快速理解系统设计。码道对话：分析项目代码结构3.2.1 后端代码结构讲解项目入口 backend/main.py：app = FastAPI(title="EduGuide API", version="0.1.0", lifespan=lifespan)app.include_router(materials.router, prefix="/api/v1/materials", tags=["materials"])app.include_router(projects.router, prefix="/api/v1/projects", tags=["projects"])app.include_router(learning.router, prefix="/api/v1/learning", tags=["learning"])app.include_router(quizzes.router, prefix="/api/v1/quizzes", tags=["quizzes"])app.include_router(records.router, prefix="/api/v1/records", tags=["records"])app.include_router(books.router, prefix="/api/v1/books", tags=["books"])app.include_router(user.router, prefix="/api/v1/user", tags=["user"])app.include_router(auth.router, prefix="/api/v1/auth", tags=["auth"])8 个路由模块注册到 FastAPI 应用，统一使用 /api/v1 前缀。lifespan 生命周期管理中启动时检查书源健康状态，关闭时释放数据库连接池。API 路由层 backend/api/（9个文件）：文件职责auth.py用户注册/登录，返回 JWT 令牌user.py用户资料查询、教学风格更新materials.py资料 CRUD、文件上传、重试解析projects.py项目 CRUD、资料关联、Agent 工作流、聊天、测验、报告learning.py学习会话、讲解生成、互动问答、章节总结quizzes.py测验创建/提交/评分records.py学习进度、错题、薄弱点、统计、导出books.py书源搜索/导入deps.py依赖注入（JWT 认证获取当前用户）Service 业务层 backend/services/（11个文件）：文件核心功能auth_service.pybcrypt 密码哈希、JWT 令牌生成、注册/登录user_service.py用户资料查询、教学风格更新material_service.py资料 CRUD、文件解析调度、ChromaDB 清理project_service.py项目 CRUD、资料关联、活动记录、级联删除agent_service.py核心：Agent 多阶段工作流（研究→大纲→方案→授课）learning_service.py学习会话管理、讲解生成、互动问答、进度导航quiz_service.py测验创建/提交、AI 评分、掌握度计算、错题记录project_quiz_service.py项目级测验生成/评分、学习报告（雷达图+薄弱点）record_service.py学习记录查询、错题重做、薄弱点分析、数据导出chat_service.py项目聊天历史、SSE 流式对话（RAG 上下文+教学风格）book_service.py多源书籍搜索（并行）、书籍下载导入（CDN 回退）AI 模块 backend/ai/（7个文件）：文件功能maas_client.py统一 MaaS API 客户端（DeepSeek + Qwen-VL）circuit_breaker.py熔断器模式，AI 通道故障自动切换agent_prompts.pyAgent 工作流 Prompt 模板prompt_manager.pyPrompt 管理器edu_agent.py教育 Agent 编排stream_handler.pySSE 流式响应处理content_filter.py内容安全检查Knowledge 知识库模块 backend/knowledge/（5个文件）：文件功能kb_client.pyChromaDB 向量知识库客户端local_rag.py本地 RAG 检索增强生成text_extractor.py文档文本提取text_splitter.py文本分块处理parse_scheduler.py文档解析调度Models 数据模型层 backend/models/（21个模型类）：核心模型关系链：User → Material → Project → ProjectMaterial → AgentSession → ProjectOutline → TeachingPlan → LessonDesign，以及 Project → Quiz → Question → AnswerRecord → MistakeRecord，Outline → Chapter → Topic → LearningStep → Interaction，Chapter → Mastery。枚举定义 backend/models/enums.py：MaterialFormat：PDF/PPTX/DOCX/TXT/EPUB/PNG/JPG/JPEG/WEBP/BMPMaterialStatus：PARSING/READY/FAILEDSourceType：LOCAL/EXTERNAL/UPLOAD/ZLIBRARY/GUTENBERG/LIBRARY_GENESISTeachingStyle：SOCRATIC/METAPHOR/STRICT/ENCOURAGINGQuizStatus：IN_PROGRESS/COMPLETEDQuestionType：CHOICE/FILL/SHORT_ANSWER/TRUE_FALSE/ESSAYMasteryTrend：IMPROVING/STABLE/DECLININGTopicStatus：主题状态（DRAFT/LEARNING/COMPLETED）ChapterStatus：章节状态（NOT_STARTED/IN_PROGRESS/COMPLETED）StepStatus：学习步骤状态（PENDING/COMPLETED）InteractionType：互动类型（QUESTION/FREE_ASK）3.2.2 前端代码结构讲解路由配置 frontend/src/App.tsx：/login → 登录/注册页/learnspace → 学习空间（默认首页，项目列表）/library → 资料库/booksource → 书源广场/profile → 个人资料/project/:id → 项目详情（Tab导航）页面组件 frontend/src/pages/（6个页面目录）：页面功能Auth/登录/注册页面LearnSpace/学习空间主页（项目列表+新建项目）Library/资料库页面（上传/管理学习资料）BookSourcePlaza/书源广场（搜索/导入在线书籍）Profile/个人资料页面（教学风格设置）ProjectDetail/项目详情（GuidedLearning/LearningOutline/QuizCenter/LearningReport）核心组件 frontend/src/components/（8个组件目录）：组件功能Layout/AppLayout.tsx应用主布局（侧边栏+内容区）ChatWidget/聊天组件（消息列表+输入框+SSE流式显示）QuizRenderer/测验渲染器（5种题型交互式答题）BookSourceModal/书源搜索弹窗OutlineView/学习大纲视图（章节列表+确认/重新生成）NewProjectDrawer/新建项目抽屉StyleModal/教学风格选择弹窗MasteryRadar/掌握度雷达图组件状态管理 frontend/src/store/（7个 Zustand Store）：Store管理状态authStoretoken/userId/username/loading/errormaterialStorematerials[]/loadingprojectStoreprojects[]/currentProjectId/selectedTablearningStorechatMessages[]/isStreaming/agentPhase/agentProgress/outlinequizStorequestions[]/answers{}/results/currentQuizIdrecordStorereport(radarData/weakPoints/suggestions)userStoreprofile/teachingStyle/styleModalVisibleAPI 客户端 frontend/src/services/：apiClient.ts：axios 实例，自动注入 Bearer Token，401 时清除本地 TokensseClient.ts：SSE EventSource 封装，支持自定义事件监听api/index.ts：所有 API 函数集合（Auth/User/Materials/Projects/Books/Chat/Agent/Quiz/Report）3.3 环境配置与项目启动3.3.1 配置环境变量根据 backend/.env.example 创建 backend/.env，需配置以下变量：DATABASE_URL / REDIS_URL：数据库与缓存连接MAAS_API_KEY / MAAS_API_URL / MAAS_MODEL：DeepSeek API 密钥与地址QWEN_API_KEY / QWEN_API_URL / QWEN_MODEL：Qwen-VL API 密钥与地址JWT_SECRET：JWT 签名密钥注意：请将 API Key 替换为步骤 2.5 中获取的实际密钥。3.3.2 Docker Compose 一键启动在码道终端中，输入以下命令启动所有服务并验证：docker compose up -ddocker compose pscurl http://localhost:8000/health预期返回 {"status":"ok"}。终端：Docker Compose启动并验证Docker Compose 将自动启动 4 个服务：服务端口说明backend8000FastAPI 后端frontend80React 前端（Nginx）db15432PostgreSQL 16redis16379Redis 7启动后，后端 Dockerfile 会自动执行： 1. 使用 tomllib 从 pyproject.toml 提取依赖列表并安装 2. 等待 PostgreSQL 就绪 3. 运行 Alembic 数据库迁移（自动创建所有表） 4. 启动 Uvicorn 服务在浏览器中访问 http://localhost 验证前端页面是否正常加载。浏览器：EduGuide前端首页加载成功查看后端日志确认数据库迁移与书源健康检查：docker compose logs backend3.4 核心功能验证3.4.1 用户注册与登录验证在码道对话框中，输入以下提示词：请测试验证用户注册和登录功能：1. 注册用户：用户名 testuser，邮箱 test@example.com，密码 test1234562. 使用注册的用户登录，获取 JWT 令牌3. 使用令牌获取用户资料码道将调用 API 接口完成注册→登录→获取资料的完整流程验证。码道对话：测试注册登录接口浏览器：EduGuide登录页面3.4.2 学习资料上传与解析验证在码道对话框中，输入以下提示词：请测试验证学习资料上传功能：1. 使用上一步获取的 JWT 令牌2. 上传一个 PDF 文件到资料库3. 查看资料列表，确认资料状态从 parsing 变为 ready4. 查看资料详情，确认解析成功注意：资料上传后系统会自动解析并构建向量知识库，首次加载 sentence-transformers 嵌入模型需要下载约 90MB 模型文件。浏览器：资料库页面上传PDF浏览器：资料解析状态从parsing变为ready3.4.3 在线书源搜索验证在码道对话框中，输入以下提示词：请测试验证书源搜索功能：1. 搜索关键词 "machine learning"2. 确认返回搜索结果（书名、作者、来源）3. 选择一本书导入到资料库浏览器：书源广场搜索结果3.4.4 项目创建与 Agent 工作流验证在码道对话框中，输入以下提示词：请测试验证项目学习功能：1. 创建学习项目 "机器学习入门"，关联之前上传的资料2. 启动 Agent 工作流，观察 SSE 流式输出3. 确认 Agent 阶段从 idle → researching → outline_generated4. 确认学习大纲生成成功5. 确认大纲后，观察 Agent 进入 planning → ready 阶段6. 开始章节授课，观察 SSE 流式讲解输出这是系统最核心的功能验证，Agent 工作流完整阶段为：idle → researching → outline_generating → outline_generated → planning → ready → teaching → complete浏览器：学习空间-项目列表浏览器：Agent工作流启动-SSE流式输出浏览器：AI生成学习大纲3.4.5 互动问答与教学风格验证在码道对话框中，输入以下提示词：请测试验证互动问答功能：1. 在授课过程中，发送自由提问 "请解释一下梯度下降的原理"2. 观察 AI 流式回答3. 切换教学风格为 "metaphor"（隐喻式）4. 再次提问，观察回答风格变化浏览器：AI互动授课-SSE流式讲解浏览器：教学风格切换3.4.6 测验生成与评分验证在码道对话框中，输入以下提示词：请测试验证测验功能：1. 为第一章生成测验2. 查看生成的题目（确认包含多种题型）3. 提交答题结果4. 查看 AI 评分结果与评语5. 查看学习报告，确认雷达图数据与薄弱点分析浏览器：AI生成测验-多种题型浏览器：测验评分结果3.4.7 错题追踪与学习记录验证在码道对话框中，输入以下提示词：请测试验证学习记录功能：1. 查看学习进度概览2. 查看错题列表3. 重做一道错题4. 查看薄弱知识点分析5. 查看学习统计数据6. 导出学习数据浏览器：学习报告-掌握度雷达图浏览器：错题列表与薄弱知识点3.5 测试验证3.5.1 后端测试在码道终端中，运行后端测试（108个测试用例）：docker compose exec backend python -m pytest -v --tb=short终端：后端108个测试用例全部通过关键测试文件：文件测试内容tests/test_auth_service.py认证服务测试tests/test_api_auth.py认证 API 测试tests/test_material_service.py资料服务测试tests/test_project_service.py项目服务测试tests/test_api_projects.py项目 API 测试tests/test_chat_service.py聊天服务测试tests/test_quiz_service.py测验服务测试3.5.2 前端测试在码道终端中，运行前端测试（50个测试用例）：cd frontend && npm test终端：前端50个测试用例全部通过关键测试文件：文件测试内容store/__tests__/authStore.test.ts认证 Store 测试store/__tests__/materialStore.test.ts资料 Store 测试store/__tests__/projectStore.test.ts项目 Store 测试store/__tests__/learningStore.test.ts学习 Store 测试store/__tests__/quizStore.test.ts测验 Store 测试components/ChatWidget/__tests__/ChatWidget.test.tsx聊天组件测试components/QuizRenderer/__tests__/QuizRenderer.test.tsx测验渲染器测试3.5.3 前端类型检查docker compose exec frontend npx tsc -b注意：tsc -b 在 Docker 中捕获的类型错误比 vite dev 更严格，务必在推送前端代码前运行。至此，EduGuide 应用的构建与验证已全部完成。四、释放资源本案例所有服务均在本地 Docker 环境中运行，不涉及华为云付费资源。完成后在终端执行以下命令释放本地资源：docker compose down五、扩展资料说明如您在案例实操过程中遇到问题或有改进建议，欢迎到论坛帖评论区反馈，我们会及时响应处理。扩展学习资料： - FastAPI 官方文档：https://fastapi.tiangolo.com/ - React 官方文档：https://react.dev/ - Ant Design 组件库：https://ant.design/ - Docker Compose 文档：https://docs.docker.com/compose/ - 华为云码道（CodeArts）代码智能体：https://codearts.huaweicloud.com/案例关键亮点总结：维度说明构建方向学习智能助教、个性化学习计划核心创新双层架构（资料库+学习空间）+ AI Agent 多阶段工作流 + 双 AI 通道熔断技术特色FastAPI async + SQLAlchemy 2.0 + ChromaDB RAG + SSE 流式 + React 19码道价值代码结构理解、环境配置、功能验证、扩展开发全流程赋能源码获取GitHub 克隆到本地，码道直接分析已有代码进行改造调试 

TravelMap 编排—游记一体化平台：基于 CodeArts Agent 的全流程构建实践案例部署链接：https://travelmap.linykweb.top/本案例说明如何在本地环境中使用华为云码道完成需求规格、系统设计、编码、测试和运行，再将通过本地验收的应用部署到华为云。项目内容案例名称TravelMap 编排—游记一体化平台：基于 CodeArts Agent 的全流程构建实践核心工具华为云码道（CodeArts）代码智能体开发模式Idea 探索 + SDD 规范驱动 + TDD 测试驱动 + 人机协同迭代技术栈Next.js 15、React 18、TypeScript strict、tRPC、Prisma、PostgreSQL、Redis、TipTap、高德地图云上资源华为云 ECS、EVS、EIP、OBS、SWR，Docker Compose + Caddy当前演示地址https://travelmap.linykweb.top/项目源码GitCode：qq_26761683/travelmap案例适用人群独立开发者、产品经理、前端/全栈工程师、使用 AI 完成全栈开发、测试和部署的团队一、概述1.1 案例介绍1.1.1 旅行编排与协作问题旅行计划通常散落在许多工具里：灵感收藏在内容社区；地点保存在地图收藏夹；日期和时间写在表格；交通方案散落在聊天记录；同行人通过群聊反复确认；旅行结束后，又需要重新整理素材写游记。这些工具分别提供内容检索、地图查看和笔记记录能力，规划、执行和记录数据之间仍然缺少统一关联。一份多人行程会持续发生时间调整、地点替换、提醒补充和交通变化，群聊和表格无法提供稳定的版本、权限和冲突处理。我提出以下初始目标：构建支持时间编排、地图路线、多人协作和游记复用的旅行计划系统。这个目标仍需补充时间冲突、并发编辑、路线可信度、离线访问、AI 修改权限和数据恢复等要求。我先让华为云码道分析问题和边界，再形成可实现、可验收的产品定义。编码工作在需求、非目标和验收条件明确后开始。1.1.2 最终形成的产品定位经过多轮澄清和迭代，TravelMap 的产品范围确定为编排、协作和游记一体化平台：编排：以日期横轴、时间纵轴组织活动、交通、用餐、休息与组合模块。协作：支持 owner、editor、commenter、viewer 四级角色，以及邀请、在线状态、评注和事件级软锁。执行：提供旅行模式、路线信息、执行状态、离线恢复和版本历史。记录：帖子承载轻量图片内容，游记承载富文本叙事，编排可作为结构化组件插入游记。智能辅助：AI 读取偏好、查询资料、核验地点和路线，但只提交可审查的 Proposal；用户确认后才会应用到正式编排。工程交付：具备测试、迁移、构建、健康检查、对象存储、监控、备份、升级与回滚材料。1.1.3 Agent 开发方法人负责目标、价值和取舍；Agent 负责检索上下文、发现缺口、提出结构化方案。一个真实可交付的项目还必须可解释、可测试、可部署、可回滚，并能让后来者理解为什么这样设计。每个重要阶段都要留下四类证据：发现了什么问题、做出了什么决定、修改了哪些内容、怎样证明修改有效。项目规则、SDD 文档、TDD、类型检查、测试、构建和发布门禁用于确保每次变更可追溯、可验证和可复现。1.2 案例时间本案例从空目录开始，在本地完成应用构建和验证，最后部署单机 Demo。预计总时长约 12–16 小时，可分 2–3 天完成：阶段预计时间本地工具安装与空项目初始化45–60 分钟使用码道形成 Spec、Design 和 Tasks60–90 分钟内容、游记和基础用户功能2–3 小时编排、保存、离线和多人协作3–4 小时AI 规划、导入和可靠性处理2–3 小时本地测试、构建和页面验收1–2 小时华为云部署、验收和维护配置1.5–2 小时实际耗时受网络、依赖下载、数据库配置、第三方服务凭据和读者经验影响。本文提供完整流程和关键实现，读者可以按阶段执行并保存每个质量门结果。1.3 案例流程flowchart LR A["1. 提出旅行协作 Idea"] --> B["2. 码道完善需求与 SDD 规格"] B --> C["3. TDD 实现与反复迭代"] C --> D["4. 规范化代码、文档与质量门"] D --> E["5. 构建镜像并部署华为云"] E --> F["6. 健康检查、业务验收与资源释放"] 说明：提出编排、协作和游记一体化的产品目标；码道在探索阶段分析角色、边界和风险，并形成规格、设计和任务；每个重要实现遵循失败测试、最小完整修改、目标验证和全量验证的顺序；将反复对话中形成的产品决策沉淀为架构、协议、测试、运行手册和证据矩阵；使用 Docker、SWR、ECS、EVS、OBS、EIP 和 Caddy 完成可恢复的单机 Demo 部署；通过健康接口和真实页面展示效果，体验完成后备份数据并释放计费资源。1.4 资源总览资源名称使用阶段本案例用途推荐规格或版本华为云码道（CodeArts）代码智能体本地开发需求分析、代码库理解、编码、测试和部署材料生成本地 IDE/CLI，账号可用版本Git本地开发版本管理2.xNode.js 与 npm本地开发Web、脚本和测试运行时Node.js 20 LTSPostgreSQL本地开发权威业务数据16Redis本地协作验证Pub/Sub、Presence 和软锁7.4Docker Desktop 或 Docker Engine本地验证数据服务和生产镜像验证24+，Compose v2华为云 ECS、EVS、EIP部署与维护运行应用和持久化数据x86，4 vCPU / 8 GiB，100 GiB 数据盘华为云 OBS部署与维护公开媒体与私有数据库备份两个独立桶华为云 SWR部署与维护保存不可变应用镜像账号所在区域私有组织域名与 DNS部署与维护HTTPS 访问已备案域名或合规测试域名二、环境和资源准备本章全部在本地计算机完成。华为云资源从 3.9 节的部署阶段开始使用。2.1 安装本地开发工具从码道下载页安装 CodeArts IDE 或 CLI；在本地码道中登录账号，新建空工作区并选择本机目录；安装 Git 2.x、Node.js 20 LTS、npm、Docker Desktop 或 Docker Engine 24+；PostgreSQL 使用 16 版，Redis 使用 7.4 版；确认本地终端可以执行以下检查：git --version node --version npm --version docker --version docker compose version本案例使用本地文件系统、本地终端和本地浏览器完成开发。数据库可以直接安装在本机，也可以通过 Docker 启动。2.2 创建空项目先创建空目录和 Git 仓库：mkdir travel-map cd travel-map git init npm init -y 在码道中打开该目录，建立初始会话。第一项任务要求 Agent 只创建基础工程，不加入业务功能：请在当前空目录创建 Next.js 15、React 18 和 TypeScript strict 项目。 使用 App Router，配置 Tailwind CSS、Vitest、Testing Library 和 Playwright。 先生成 package.json、tsconfig.json、基础页面和测试配置。 完成后运行基础测试、类型检查和生产构建，并说明每个文件的职责。核心运行时依赖使用明确版本：npm install next@15.5.21 react@18.3.1 react-dom@18.3.1 npm install -D typescript@5.7.2 @types/node@22.10.0 \ @types/react@18.3.14 @types/react-dom@18.3.2随后由 Agent 按功能阶段补充 tRPC、Prisma、TipTap、Redis、图片处理和测试依赖，并生成 package-lock.json。从锁文件已经生成的阶段开始，统一使用：npm ci2.3 配置本地数据库和环境变量使用 Docker 启动本地 PostgreSQL：docker run --name travel-map-postgres \ -e POSTGRES_USER=postgres \ -e POSTGRES_PASSWORD=postgres \ -e POSTGRES_DB=travel_map \ -p 5432:5432 \ -d postgres:16-alpine基础开发阶段使用应用内置的单进程 WebSocket Gateway。实现 Redis 协作阶段后，再启动本地 Redis：docker run --name travel-map-redis \ -p 6379:6379 \ -d redis:7.4-alpine复制环境变量模板：cp .env.example .env openssl rand -base64 32 将生成值写入本地 .env 的 NEXTAUTH_SECRET，并保留以下本地数据库地址：DATABASE_URL="postgresql://postgres:postgres@localhost:5432/travel_map?schema=public" NEXTAUTH_URL="http://localhost:3000" OBJECT_STORAGE_PROVIDER="local" 地图、LLM 和联网搜索配置在对应功能阶段再填写。凭据只能存放在本地 .env，不能写入 Prompt、截图、日志快照或版本库。初始化数据库客户端和迁移：npm run db:generate npm run db:deploy2.4 配置本地码道工作流码道支持项目级代码生成、代码库理解、研发知识问答、测试生成、文件搜索与修改，以及在授权范围内运行 Git、npm、测试和构建命令。TravelMap 涉及前端、服务端、数据库、Worker 和部署文件，项目级索引可以让 Agent 在修改前读取相关实现。开发过程分为两个阶段：探索阶段：分析用户、场景、边界、风险和可选方案；规范阶段：将确认结果写入规格、设计、任务和验收清单。本案例使用以下 SDD 命令：/sdd-new → 生成需求规格 spec.md /sdd-design → 生成技术设计 design.md /sdd-tasks → 生成任务规划 tasks.md /sdd-apply → 按任务实施并更新状态本地开发流程如下：产品目标 → spec.md → design.md → tasks.md → 失败测试 → 最小完整实现 → 本地目标测试 → 本地全量测试和构建 → 浏览器验收 → 更新文档复杂任务按只读审查、测试定位、文档校验和主实施四类职责拆分。主 Agent 汇总证据后再修改文件，减少跨模块任务遗漏。三、构建 TravelMap 应用3.1 建立基础应用和本地质量门空项目完成依赖安装后，先建立稳定的目录和命令：src/app/ # 页面和 Route Handler src/components/ # 通用组件 src/features/ # 前端领域功能 src/server/ # Router、Service 和基础设施 prisma/ # Schema 和 migrations scripts/ # Worker 与校验脚本 __tests__/ # Vitest 测试 e2e/ # Playwright 测试 docs/ # 规格、设计和运行文档基础 package.json 至少提供以下命令：{ "scripts": { "dev": "tsx scripts/dev.ts", "build": "next build", "typecheck": "tsc --noEmit", "test:run": "vitest run", "test:e2e": "playwright test", "db:generate": "prisma generate", "db:deploy": "prisma migrate deploy" } } 先建立首页冒烟测试，再运行基础质量门：npm run test:run npm run typecheck npm run build npm run dev浏览器访问 http://localhost:3000。此时页面只需要显示项目名称和基础导航，后续功能按 tasks.md 分阶段加入。每个阶段开始前，Agent 读取 spec.md、design.md、tasks.md 和当前测试。3.2 从 Idea 到产品规格3.2.1 第一条 Prompt：先理解问题，不要立即写代码我给码道的起始任务可以概括为：我希望构建一个编排—游记一体化旅行平台。 核心功能包括高效率时间编排、地图路线、多人协作， 以及将结构化行程插入游记。 请先不要编码。先分析用户角色、核心旅程、关键对象、边界条件、 风险与分阶段实现方式；对不清楚的地方提出问题。这一步先确定领域和验收条件，随后再创建业务页面。Agent 将需求拆分为帖子、游记、编排、导入、用户、互动和管理后台等领域，并识别时间调度、地图数据、富文本、权限和内容审核等风险。阶段成果沉淀在：output/prd-travel-journey-platform.mddocs/arrangement-architecture.mddocs/case-report/sdd/spec.mddocs/case-report/sdd/design.mddocs/case-report/sdd/tasks.md3.2.2 统一行程列表与时间板编排模型第一版产品概念仍包含传统行程：每天若干地点，地点之间附路线。但在真实使用中，我发现它难以表达这些情况：一个活动有固定预约时间，但前后需要排队和缓冲；住宿、租车、通票跨越多天，却不应挤占普通时间格；同一天存在多个地点组合和容器；某些活动时间可以移动，某些只能在窗口内移动；拖动一个事件后，交通时间可能不再足够；旅行中只需要执行视图，不需要复杂编辑器。我让 Agent 重新分析领域模型，并停止继续扩展旧结构：请比较传统每日行程列表和日期 × 时间模块化编排两种模型。 重点分析固定事件、柔性事件、交通、缓冲、跨日背景周期、 组合容器、时间冲突、拖动与旅行执行模式。 给出统一模型，并说明哪些字段应由程序确定，哪些可以让用户或 AI 输入。最终，Arrangement 成为唯一的结构化旅行计划模型；旧 Itinerary 被迁移下线。活动、交通、用餐、休息和容器统一为事件，调度器以确定性规则处理时间与冲突。这也是一次重要的产品判断：当新模型已经覆盖旧模型时，继续维护两套近似能力只会放大复杂度。3.2.3 根据实现证据调整产品范围编排工作区完成基础验证后，多人协作和离线编辑被纳入产品范围，依据如下：编排天然由多人共同讨论；旅行现场的网络条件不可控；只有服务端版本、历史和恢复机制完整，协作才可信。因此我允许范围改变，但要求每次改变都回答三个问题：它是否强化核心价值，并避免无关功能堆积？现有架构是否能可靠承载？新增复杂度怎样通过测试和运维材料被控制？3.3 从规格到第一版可用产品3.3.1 安装基础技术并建立领域顺序层次技术选择理由Web 框架Next.js 15 + React 18同一工程承载页面、Server API 与 SSR类型系统TypeScript strict让跨前后端数据变更尽早暴露APItRPC + React Query端到端类型、缓存和请求状态管理数据库PostgreSQL + Prisma事务、关系模型、迁移与并发控制样式Tailwind CSS快速建立一致的响应式设计富文本TipTap结构化富文本与自定义编排节点地图高德地图地理编码、POI、路线、天气实时协作WebSocket + Redis + PostgreSQL Outbox低延迟广播与可靠事件记录结合图片处理Sharp + 本地存储/S3 适配服务端校验、重编码与存储接口测试Vitest + Testing Library + Playwright覆盖纯逻辑、组件、服务与浏览器流程基础架构完成后，按以下顺序实施：用户与认证 → 帖子和互动 → TipTap 游记 → Arrangement 编排 → 保存、历史和离线 → 多人协作 → AI 规划 → 智能导入 → 管理后台每个阶段先更新 Prisma Schema 和 API 契约，再实现页面与组件，最后运行目标测试、类型检查和构建。当前仓库包含约 383 个 TypeScript/TSX 文件、61,000 余行受版本管理的 TS/TSX/Prisma/SQL、47 个 Prisma 模型、27 条数据库迁移、133 个 Vitest 测试文件和 7 个浏览器 E2E 规格文件。这些统计用于说明当前工程规模和验证范围。3.3.2 实现编排工作区实施顺序：在 prisma/schema.prisma 中建立 Arrangement、ArrangementEvent、ArrangementRevision 和素材模型；建立 Zod 领域 Schema、五分钟吸附、半开区间冲突和容器边界测试；实现确定性调度器，通过纯逻辑测试后再接入页面；实现时间板几何、拖动、边缘缩放和素材命中；接入 tRPC 读写、自动保存、版本和 Revision；使用本地浏览器检查跨日拖动、短事件、固定事件、交通下限和公开视图。编排工作区需要提供清晰展示、即时拖放和显式冲突反馈：日期横轴、时间纵轴；五分钟吸附；跨日拖动和上下边缘缩放；活动、交通、用餐、休息和组合容器；全天栏与背景周期；交通时长下限和路线状态；评注轨道；素材库与公开素材复制；自动保存、撤销、重做、历史版本；时间板视图与旅行视图。点击事件可以查看地点、时间、备注与只读详情。公开视图会过滤私人备注、Checklist 等敏感执行信息。3.3.3 实现游记与编排动态关联实施顺序：建立 Journal 数据模型和 TipTap JSON 文档格式；实现标题、列表、引用、链接和图片节点；创建 arrangementBlock 扩展，节点只保存 arrangementId；服务端从文档中提取并校验 embeddedArrangementIds；阅读页通过公开投影读取最新编排；添加不存在、未公开、已删除和脏事件数据测试。游记编辑器直接提供标题、列表、引用、链接和多种图片布局。普通用户无需编写 Markdown。编排通过自定义富文本节点插入游记。这个设计解决了两个问题：作者不需要复制一份很快过时的静态表格；源编排更新后，阅读页可以读取最新的公开投影。3.3.4 内容社区与智能导入内容功能按帖子、互动、用户主页和导入任务的顺序实施。导入功能使用持久任务和 Worker，生成结果先保存为草稿，再由用户审核。平台同时保留帖子与游记：帖子适合轻量图片内容；游记适合图文长叙事；编排适合可执行计划；用户主页、评论、点赞、关注、收藏夹和通知把内容连接起来。智能导入支持 URL 与粘贴文本，能够把非结构化内容转为帖子或游记草稿；当游记中识别到可执行行程时，系统会同步生成编排并建立引用。受登录、反爬和来源平台规则影响时，产品提示用户改用手动粘贴。外部账号只能在合法授权下使用。本地验收包括：创建帖子并上传图片 → 创建富文本游记 → 创建编排 → 在游记中插入编排 → 发布并使用未登录窗口查看公开投影 → 提交文本导入任务 → Worker 生成草稿 → 用户审核后发布3.4 使用 Agent 进行问题定位和迭代3.4.1 我使用的固定迭代模板每次出现问题时，我向 Agent 提供完整的问题结构：现象：用户看到什么？ 期望：完成任务时应该怎样？ 证据：页面、日志、数据或测试说明了什么？ 边界：哪些数据不能破坏，哪些能力不能退化？ 方法：先写失败测试，再做最小完整修复。 验收：目标测试、全量测试、类型检查、构建和真实页面操作。例如：模块无法直接从素材库拖进容器，会被碰撞检测拒绝。 请先写能够稳定复现这个行为的测试，定位素材拖入与已存在模块拖动 是否错误地共用了碰撞规则。修复后验证容器落点、跨日拖动、撤销和自动保存。3.4.2 调整编排卡片的视觉层级编排早期版本能显示事件，但短事件、组合容器和多种时间层级挤在一起时，信息层级不清楚。Agent 先根据代码和页面生成修改方案，我再通过真实页面发现：短事件标题容易被截断；胶囊状态与主要标题争夺空间；交通、用餐和休息缺少快速区分；AI 浮层会遮挡设置或详情操作。我们逐项修改卡片几何、标记、颜色、悬停详情和浮层避让，并保留每轮修改前后的截图。3.4.3 约束 AI 规划的权限和执行流程早期 AI 规划采取自由工具循环：模型一次生成很大的完整对象，Schema 失败后又整份重写。真实运行中出现过：深层 JSON 截断或嵌套字符串；时间格式和持续时间关系矛盾；运行数小时仍在重复工具调用；Worker 中断后从头执行；搜索、地点和路线预算边界不一致；前端已经显示正文，但终态没有正确解锁。这些问题说明，继续扩大模型上下文或工具轮数无法解决结构校验和执行恢复问题。我和 Agent 共同将架构改为受控分阶段流程：理解需求 → 生成候选行程结构 → 联网研究 → POI 解析 → 路线与天气核验 → 确定性排程 → 事实与约束校验 → 有限局部修复 → 生成攻略 → 形成 Proposal → 用户确认后应用最终原则是：模型负责意图、候选和解释；程序负责 ID、时间、路线、派生字段和硬约束；失败只重试当前阶段；已验证阶段可以从检查点恢复；AI 不能直接覆盖正式编排；地点歧义、证据冲突或路线无法核验时必须阻断。3.4.4 增加可靠自动保存和版本控制自动保存早期只在修改后发送一次请求。加入离线和协作功能后，保存协议增加以下要求：客户端操作 ID 保证重试幂等；服务端版本号防止静默覆盖；冲突时进行可解释合并或要求用户处理；离线信封保存元数据和事件；网络恢复后按版本合并；Revision 记录操作者和变更；历史恢复生成新版本，并保留原有历史。保存流程覆盖客户端状态、网络重试、数据库版本和历史记录。3.4.5 构建可扩展协作链路Agent 先设计角色、邀请、评注与事件锁，再通过代码审查发现搜索越权、游标竞态和撤权后锁未释放等问题。最终协作链路包括：owner / editor / commenter / viewer；邮箱或链接邀请、有效期、次数和撤销；在线 Presence；事件级 15 秒软锁与 fencing token；PostgreSQL 有序事件和 Transactional Outbox；Redis Pub/Sub；独立 Collaboration Gateway 与 Relay；WebSocket → SSE → 持久游标轮询的降级链；序列缺口恢复与权威快照回退；Prometheus 指标和告警规则。协作交互的最终方案为：本地立即预览拖动；后台并行获取软锁；获得锁后才提交；锁冲突时自动撤销；拖动期间关闭位置过渡；WebSocket 误路由时快速失败并进入降级通道。自动化测试通过后仍需执行本地双会话浏览器验收，覆盖权限变化、锁冲突、断线和恢复。3.5 规范化项目上下文、测试与追踪3.5.1 项目上下文Agent 每次工作前需要读取当前项目文件，避免依赖旧会话中的过期信息。项目使用以下材料维持共同上下文：文档作用output/prd-travel-journey-platform.md完整产品需求和初始范围CODEARTS_CONTEXT.md历史决策、已实现能力、风险和凭据安全提醒docs/case-report/sdd/spec.md当前产品需求、非目标和可验收场景docs/case-report/sdd/design.md当前架构、数据流、可靠性、安全和部署设计docs/case-report/sdd/tasks.mdSDD 任务状态、代码证据、测试证据和发布待办docs/arrangement-architecture.md编排领域模型和前后端边界docs/arrangement-save-reliability.md自动保存、版本、冲突与恢复协议docs/arrangement-ai-planner-architecture.mdAI 分阶段规划与可信边界docs/arrangement-collaboration-scale-plan.md多实例协作架构docs/operations/arrangement-collaboration-runbook.md故障诊断与运维步骤3.5.2 TDD：先证明问题存在项目实现阶段遵循固定顺序：建立失败测试 → 运行并确认失败原因正确 → 实现最小完整改动 → 运行目标测试 → 运行全量验证 → 浏览器或生产环境验收 → 更新文档测试覆盖：调度器、五分钟吸附、跨日、DST 和时间几何；自动保存、离线恢复、版本冲突和 Proposal；协作协议、Outbox、Redis、WebSocket、软锁和权限；AI Worker、租约、心跳、账本、证据、路线、天气和 SSE；内容权限、URL 与图片安全、密钥信封；导入队列、LLM 结构校验和失败恢复；组件交互、无障碍和浏览器 E2E；Prisma migration 与 PostgreSQL 并发可靠性；健康接口和本地进程启动。最近一次完整实现会话记录了：133 个测试文件 727 项测试通过 TypeScript strict 检查通过 Next.js 生产构建通过本案例报告编写时没有把旧记录当成新的执行结果。当前仓库仍保留测试、Playwright 报告、截图和构建材料；发布新版本前应重新执行完整门禁。2026-07-26 编写本报告时又进行了独立复核：npm run typecheck：通过；npm run build：通过，保留既有 <img> 图片优化警告；npm run test:run：沙箱内 133 个文件中的 132 个通过，720/727 项通过；唯一未通过文件的 7 项均因沙箱禁止监听 127.0.0.1，错误为 listen EPERM，业务断言未失败；在批准本地监听的受控环境重跑该 WebSocket 文件，9/9 项通过。本次证据结论为：应用类型检查和生产构建通过；需要监听本地端口的 WebSocket 测试在允许本地监听的环境中通过。报告同时保留第一次运行时的环境限制和错误信息。3.5.3 需求—设计—实现—验证追踪一个需求只有同时具备以下证据，才算完成：需求设计/决策实现验证时间板拖放确定性调度 + 五分钟吸附scheduler.ts、时间板组件调度器、组件、E2E多人共同编辑权威版本 + 软锁 + 有序事件collaboration services协议、路由、Gateway、容量 HarnessAI 不直接改正式计划Proposal + 差异确认Proposal 服务与抽屉幂等、重基、应用测试断网可恢复离线信封 + 版本合并offline store / recovery离线浏览器用例3.6 完整项目结构与源码交付TravelMap 采用前后端一体的 Next.js 工程，核心目录如下：travel-map/ ├── src/app/ # 页面、路由与健康接口 ├── src/features/arrangements/ # 编排模型、调度器、自动保存与 UI ├── src/components/editor/extensions # TipTap 编排嵌入节点 ├── src/server/services/arrangements # Proposal、协作、公开投影等服务 ├── prisma/ # 数据模型、迁移和种子数据 ├── scripts/ # Worker、Gateway、Relay 与发布校验 ├── __tests__/ # 单元、组件、服务和部署资产测试 ├── e2e/ # Playwright 浏览器用例 └── docs/ # 架构、协议、部署与运行手册项目依赖由 package-lock.json 锁定，必须使用 npm ci，不能在案例步骤中把关键依赖写成无版本约束的临时安装命令。项目源码仓库地址为 GitCode：qq_26761683/travelmap。仓库完成推送后，读者可以通过 SSH 获取与本文对应的完整工程：git clone git@gitcode.com:qq_26761683/travelmap.git travel-map cd travel-map npm ci没有配置 GitCode SSH 公钥时，可以在仓库页面复制 HTTPS 地址。完成依赖安装后，继续执行 2.3 节的本地环境配置和 3.8 节的验证命令。3.7 关键代码讲解与释义本节解释六处核心实现。每一处均来自当前仓库，并关联相应测试或运行证据。3.7.1 确定性调度与可行性校验解决的问题：拖动事件或生成 AI 行程后，系统必须统一判断时间重叠、容器边界、时间窗口和不确定时长风险，不能由页面或模型各自给出结论。核心函数位于 src/features/arrangements/scheduler.ts：export function analyzeArrangement(events: readonly ArrangementEventInput[]) { const conflicts: ArrangementIssue[] = []; conflicts.push(...relativeTimeConflicts(events)); const expectedPairs = pairs(events, false); const expectedKeys = new Set( expectedPairs.map(([left, right]) => `${left.id}:${right.id}`), ); for (const [left, right] of expectedPairs) { conflicts.push({ kind: 'overlap', eventIds: [left.id, right.id], message: `${left.title}与${right.title}发生重叠`, }); } const risks: ArrangementIssue[] = pairs(events, true).flatMap( ([left, right]) => expectedKeys.has(`${left.id}:${right.id}`) ? [] : [{ kind: 'worst_case' as const, eventIds: [left.id, right.id], message: `${left.title}按最长时长可能影响${right.title}`, }], ); return { conflicts, risks, feasibleExpected: conflicts.length === 0, feasibleWorstCase: conflicts.length === 0 && risks.length === 0, }; } 逐项释义：relativeTimeConflicts 先处理相对另一个事件开始或结束的约束；pairs(events, false) 计算期望时长下的真实冲突，冲突会阻止保存或应用；pairs(events, true) 使用最长时长再次计算，只在新增组合中形成 worst_case 风险；feasibleExpected 与 feasibleWorstCase 分别表示预计时长和保守时长下的可行性，界面据此显示风险；同一函数还检查三级容器限制、子事件是否落在父容器内、窗口和最早/最晚时间，省略部分未在代码块中重复展示。这样设计的原因是：自然语言适合提出候选与解释，硬约束必须由确定性程序执行。对应测试为 __tests__/features/arrangement-scheduler.test.ts，界面效果对应 3.3.2 的公开编排与详情截图。3.7.2 可靠自动保存：防止断网和并发导致静默覆盖解决的问题：频繁拖动会产生连续快照；网络错误需要重试；多人同时编辑时，系统必须防止旧版本静默覆盖新版本。核心队列位于 src/features/arrangements/autosave.ts：constructor(options: ReliableAutosaveQueueOptions<TSnapshot>) { this.options = { debounceMs: 900, retryBaseMs: 750, retryMaxMs: 30_000, ...options, }; this.version = options.initialVersion; this.baseSnapshot = options.initialSnapshot; this.acknowledgedSerial = options.initialAcknowledgedSerial ?? 0; } const result = await this.options.save({ serial: active.serial, snapshot: active.snapshot, reason: active.reason, kind: active.kind, expectedVersion: this.version, clientMutationId: active.clientMutationId, }); this.version = result.version; this.acknowledgedSerial = Math.max( this.acknowledgedSerial, active.serial, ); 重试部分：const newest = this.pending as PendingEntry<TSnapshot> | null; const retry = newest && newest.serial > active.serial ? newest : { ...active, attempt: active.attempt + 1 }; this.pending = retry; const exponent = Math.min(retry.attempt, 8); const delay = Math.min( this.options.retryMaxMs, this.options.retryBaseMs * 2 ** exponent, ); this.publish({ status: 'retrying', nextRetryMs: delay, attempt: retry.attempt }); this.schedule(delay); 逐项释义：900ms 防抖减少拖动过程中的无效请求；expectedVersion 让服务端发现版本冲突，并拒绝最后写入者静默覆盖；clientMutationId 让同一次保存的网络重试具备幂等身份；serial 区分快照新旧，重试时优先保留更新的本地快照；网络型错误按指数退避，最多等待 30 秒；权限、参数等不可恢复错误进入 blocked，不做无限重试；冲突恢复会基于 baseSnapshot 合并，并把恢复后的权威版本回传界面。对应测试为 __tests__/features/arrangement-autosave.test.ts。3.4.4 节记录了该实现的产品背景和迭代过程。3.7.3 AI Proposal：AI 只提交建议，用户确认后才落盘解决的问题：AI 可能使用旧版本、生成无效时间或删除用户内容，因此不能直接覆盖正式编排。核心应用逻辑位于 src/server/services/arrangements/proposals.ts：const proposal = persistedProposal( await tx.arrangementProposal.findFirst({ where: { id: input.proposalId, ownerId: input.ownerId }, }), ); if (!proposal) notFound(); const replay = await tx.arrangementRevision.findUnique({ where: { proposalId: proposal.id }, select: { version: true }, }); if (replay || proposal.status === 'applied') { const version = replay?.version ?? proposal.appliedVersion; if (!version) { throw new TRPCError({ code: 'INTERNAL_SERVER_ERROR', message: '已应用提案缺少版本审计记录', }); } return { status: 'applied', proposalId: proposal.id, version, replayed: true }; } if (proposal.expiresAt && proposal.expiresAt.getTime() <= Date.now()) { await tx.arrangementProposal.update({ where: { id: proposal.id }, data: { status: 'expired' }, }); return { status: 'expired', proposalId: proposal.id }; } 应用前的版本与删除确认：if (arrangement.currentVersion !== input.expectedVersion) { throw new TRPCError({ code: 'CONFLICT', message: '编排版本已变化，请先重新预览提案', }); } const rebased = rebaseArrangementProposal(base, desired, current); if (rebased.status === 'conflict') { await tx.arrangementProposal.update({ where: { id: proposal.id }, data: { status: 'stale', validationReport: json({ valid: false, rebaseConflicts: rebased.conflicts, }), }, }); return { status: 'stale', proposalId: proposal.id, conflicts: rebased.conflicts }; } if (missingDeletionIds.length > 0 || unexpectedDeletionIds.length > 0) { return { status: 'confirmation_required', proposalId: proposal.id, missingDeletionIds, unexpectedDeletionIds, }; } 逐项释义：查询同时带 proposalId 和 ownerId，权限校验发生在服务端；ArrangementRevision.proposalId 是幂等屏障，同一 Proposal 重放不会生成两个版本；过期或验证不通过的 Proposal 会被拒绝；正式编排已变化时先重基；无法安全合并则返回 stale，要求重新预览；删除事件需要逐项确认，AI 提出的删除操作不得直接写入数据；最终修改和 Revision 审计记录在 Serializable 事务中一并完成。对应测试为 __tests__/features/arrangement-proposal.test.ts、__tests__/server/arrangement-proposal-service.test.ts 和 __tests__/prisma/arrangement-proposals.test.ts，界面效果对应 3.4.3 的 AI 编排助手截图。3.7.4 Transactional Outbox：数据库成功后，协作消息也能恢复解决的问题：如果数据库已提交但 Redis 广播失败，其他协作者会遗漏更新；如果多个 Relay 并行工作，还要避免乱序和重复认领。事件和 Outbox 在同一数据库事务中写入，代码位于 src/server/services/arrangements/collaboration.ts：const rows = await db.$queryRaw< Array<{ collaborationStreamSequence: bigint }> >(Prisma.sql` UPDATE "arrangements" SET "collaboration_stream_sequence" = "collaboration_stream_sequence" + 1 WHERE "id" = ${input.arrangementId} RETURNING "collaboration_stream_sequence" AS "collaborationStreamSequence"`); const event = await db.arrangementCollaborationEvent.create({ data: { arrangementId: input.arrangementId, streamSequence, actorId: input.actorId ?? null, type: input.type, version: input.version ?? null, payload, }, }); await db.arrangementCollaborationOutbox.create({ data: { eventSequence: event.sequence, arrangementId: input.arrangementId, channel: arrangementRedisKeys(input.arrangementId).channel, }, }); Relay 的认领条件位于 src/server/services/arrangements/collaboration-outbox-relay.ts：WHERE outbox."published_at" IS NULL AND outbox."available_at" <= CURRENT_TIMESTAMP AND NOT EXISTS ( SELECT 1 FROM "arrangement_collaboration_outbox" AS predecessor_outbox JOIN "arrangement_collaboration_events" AS predecessor_event ON predecessor_event."sequence" = predecessor_outbox."event_sequence" WHERE predecessor_outbox."arrangement_id" = outbox."arrangement_id" AND predecessor_outbox."published_at" IS NULL AND predecessor_event."stream_sequence" < event."stream_sequence" ) ORDER BY outbox."id" FOR UPDATE SKIP LOCKED逐项释义：每个编排原子递增 collaboration_stream_sequence，得到权威事件顺序；业务事件与 Outbox 同事务写入，避免数据库已经更新、消息仍未记录；NOT EXISTS 阻止同一编排的后续事件越过尚未发布的前序事件；FOR UPDATE SKIP LOCKED 允许多个 Relay 安全并行认领；Redis 发布失败时保留 Outbox，增加尝试次数并延后 availableAt，后续可以恢复；客户端仍通过 WebSocket、SSE 或持久游标轮询处理断线与序列缺口。对应测试为 __tests__/server/collaboration-outbox-relay.test.ts 和 __tests__/server/collaboration-outbox-listener.test.ts。3.7.5 游记嵌入与公开投影：保持最新，也不泄露私人执行信息解决的问题：游记需要展示编排，但复制一份完整 JSON 会很快过期；直接公开源数据又可能泄露 Checklist、私人备注和执行状态。编辑器节点只保存 arrangementId，阅读时获取最新数据，代码位于 src/components/editor/extensions/ArrangementBlockView.tsx：const { data: arrangement, isLoading } = trpc.arrangements.getById.useQuery( { id: arrangementId }, { enabled: Boolean(arrangementId), retry: false }, ); const events = (arrangement?.events ?? []).flatMap((event) => { const parsed = arrangementEventSchema.safeParse(event); return parsed.success ? [parsed.data] : []; }); {!isLoading && !arrangement && ( <div className="p-5 text-center text-xs text-slate-500"> 编排不存在、未公开或已被删除 </div> )} {arrangement && ( <ArrangementJourneyView title={arrangement.title} days={days} events={events} backgroundPeriods={periods.success ? periods.data : []} timeZone={arrangement.timeZone} compact /> )} 服务端公开投影位于 src/server/services/arrangements/public-projection.ts：return { ...arrangement, mode: 'planning', backgroundPeriods: [], events: arrangement.events.map((event) => { const constraints = event.constraints && typeof event.constraints === 'object' ? Object.fromEntries( Object.entries(event.constraints) .filter(([key]) => key !== 'manualLock'), ) : {}; return { ...event, executionStatus: 'pending', checklist: [], notes: null, constraints, }; }), } as T; 逐项释义：富文本节点只保存稳定引用，避免游记内产生一份无法同步的行程副本；读取时用 Zod safeParse 隔离脏事件，单条异常不会让整篇游记崩溃；不存在、未公开或删除时显示安全降级文案；服务端强制切回 planning，清空背景周期、Checklist、私人备注和实时执行状态；manualLock 属于私人编辑约束，不进入公开页面。对应测试为 __tests__/features/arrangement-public-projection.test.ts，效果对应 3.3.3 的游记阅读页截图。3.7.6 本地健康检查：区分进程存活与依赖就绪解决的问题：本地进程能够监听端口时，数据库或 Redis 仍可能不可用。存活检查和就绪检查需要分别返回状态。src/app/api/health/live/route.ts 提供进程存活检查：export async function GET() { return NextResponse.json({ status: 'ok', service: 'travel-map-web', timestamp: new Date().toISOString(), }, { status: 200, headers: { 'Cache-Control': 'no-store', 'X-Content-Type-Options': 'nosniff', }, }); } src/app/api/health/ready/route.ts 检查本地依赖：await prisma.$queryRaw`SELECT 1 AS ready`; const redis = await collaborationRedisConnections().catch(() => null); const redisStatus = process.env.COLLABORATION_TRANSPORT === 'redis' ? await redis?.health() ?? 'unavailable' : undefined; return NextResponse.json({ status: redisStatus === 'unavailable' ? 'degraded' : 'ready', checks: { database: 'ok', ...(redisStatus ? { redis: redisStatus } : {}), }, }); 逐项释义：/api/health/live 只确认 Web 进程能够响应；/api/health/ready 执行 SELECT 1，确认 PostgreSQL 可访问；启用 Redis 协作模式时，就绪接口继续检查 Redis；Redis 不可用时返回 degraded，数据库异常时返回 HTTP 503；两个接口均禁用缓存，避免旧健康结果影响判断。对应实现为两个健康 Route Handler。本地启动后使用 curl 验证，部署阶段继续复用相同接口。这六组代码对应调度、保存、AI 权限、协作事件、公开数据和运行状态六项核心质量要求。3.8 本地运行、测试和效果验收3.8.1 初始化并启动全部本地进程完成各功能任务后，执行：npm ci npm run db:generate npm run db:deploy npm run devnpm run dev 启动 Web、Import Worker 和 Planner Worker。设置 COLLABORATION_TRANSPORT=redis 后，还会启动 Collaboration Gateway 和 Relay。本地健康检查：curl -fsS http://localhost:3000/api/health/live curl -fsS http://localhost:3000/api/health/ready3.8.2 执行自动化质量门npm run test:run npm run typecheck npm run build本报告采集证据时，类型检查和生产构建通过。普通测试在受限沙箱中通过 720/727 项；7 项 WebSocket 测试因本地监听权限产生 listen EPERM。在允许本地监听的环境中重跑对应文件，9/9 项通过。报告保留两次执行条件和结果。3.8.3 执行本地浏览器验收按顺序检查：注册、登录和用户主页；帖子、游记和编排的创建与公开页面；时间板拖放、缩放、冲突提示、撤销和自动保存；游记插入编排和公开投影；邀请、成员角色、评注、事件锁和双会话同步；WebSocket 断开后的 SSE 与轮询降级；AI Planning Run、Proposal 预览和用户确认；URL/文本导入、草稿审核和失败重试；断网读取、网络恢复和版本合并。3.9 部署项目代码到华为云3.9.1 选择部署方案部署任务同样在码道会话中完成：Agent 先读取运行依赖、Worker、对象存储与长连接需求，再对照华为云官方文档比较 FunctionGraph、CCE、CAE、Flexus 与 ECS。最终选择按需 ECS 单机 Demo，原因是：项目包含 Web、导入 Worker、规划 Worker和协作常驻进程；需要 PostgreSQL、Redis、WebSocket、SSE 和图片处理；当前 Demo 采用 Compose，以控制部署时间和资源费用；所有资源都要能按需释放；同时保留未来迁移到 RDS 和多应用节点的路径。3.9.2 当前 Demo 架构公网用户 │ ▼ 域名 / HTTPS / EIP │ ▼ Caddy :80/:443 ├── Next.js Web :3000（仅容器内网） └── Collaboration Gateway :3001（仅容器内网） 单台按需 ECS + EVS ├── Web ├── Import Worker ├── Planner Worker ├── Collaboration Gateway ├── Collaboration Relay ├── PostgreSQL 16 ├── Redis 7.4 ├── Prometheus └── Redis/PostgreSQL Exporter ECS ──► OBS 公共读媒体桶 ECS ──► OBS 私有数据库备份桶 ECS ◄── SWR 不可变应用镜像3.9.3 第一步：准备 VPC、安全组、ECS、EVS 和 EIPDemo 推荐基线：资源建议ECS按需、x86、4 vCPU / 8 GiB系统盘80 GiB 通用型 SSDEVS 数据盘100 GiB，承载 PostgreSQL、Redis 和短期备份EIP按流量、5–10 Mbit/s 峰值安全组公网入方向80、443；22 仅允许固定管理 IP明确不开放：3000：只能由 Caddy 访问；3001：只能由 Caddy 转发 WebSocket；5432：PostgreSQL 只允许容器内网；6379：Redis 只允许容器内网；Docker API、Portainer 等管理端口。EVS 初始化时必须先用 lsblk、blkid、findmnt 确认目标盘，再格式化新盘。/etc/fstab 使用 UUID，不能假设重启后设备名不变。3.9.4 第二步：创建两个 OBS 桶媒体和备份不能共用一个桶：桶权限内容媒体桶公共读，禁止公共写用户上传并经过服务端重编码的公开图片数据库备份桶私有，建议服务端加密PostgreSQL 逻辑备份与校验和使用专用 IAM 用户和最小权限，不使用主账号 AK/SK。部署前运行：npm run deploy:check-storage该脚本依次执行上传测试对象、通过公网读取和删除对象，可以提前发现 Endpoint、Region、AK/SK、桶策略或公开 URL 配置错误。3.9.5 第三步：构建并推送 SWR 镜像在可信构建机执行：npm ci npm audit --omit=dev npm run test:run npm run typecheck npm run buildApple Silicon 为 x86 ECS 构建时：docker buildx build \ --platform linux/amd64 \ --build-arg NEXT_PUBLIC_AMAP_KEY=浏览器高德Key \ --build-arg NEXT_PUBLIC_AMAP_SECURITY_CODE=高德安全密钥 \ -t swr.实际区域.myhuaweicloud.com/组织名/travel-map:不可变版本号 \ --push \ . 这里有三条不可越过的边界：使用不可变标签，不长期依赖 latest；NEXT_PUBLIC_* 会进入浏览器 bundle，修改后必须重新构建；数据库、OBS、LLM 和加密密钥不能作为 build arg。3.9.6 第四步：生产配置与迁移生产配置分为 Compose 环境和应用环境：deploy/huawei-cloud/.env：镜像地址、域名、PostgreSQL/Redis 密码和数据目录；deploy/huawei-cloud/app.env：NextAuth、高德、LLM、OBS、健康检查和加密密钥。两个文件都不能提交到仓库，权限应设为 600。上线前先检查：npm run deploy:check-env docker compose --env-file .env config --quiet 再进行备份、拉取和迁移：./backup-postgres-to-obs.sh docker compose --env-file .env pull docker compose --env-file .env up -d postgres redis docker compose --env-file .env --profile tools run --rm migrate云上结构只允许：prisma migrate deploy不能使用 prisma db push 掩盖 migration drift。3.9.7 第五步：启动服务与 HTTPSdocker compose --env-file .env up -d --no-build docker compose --env-file .env ps Caddy 负责：80/443；自动 HTTPS；安全响应头；WebSocket 路由；SSE 关闭代理缓冲。更新 Caddyfile 后必须验证运行中的 Caddy 已加载新配置。项目曾出现文件已经上传、容器仍使用旧路由的问题，因此部署文档要求强制重建容器或明确重新加载 Caddy 配置。部署验收还发现拖动开始前等待远程 Redis 软锁会增加约一秒延迟。3.4.5 节记录的处理方式包括本地立即预览、后台获取软锁、获得锁后提交，以及锁冲突时撤销预览。该问题需要在真实网络环境中验证，本地回环网络无法提供同等延迟条件。3.9.8 第六步：健康与业务验收基础健康接口：curl -fsS https://travelmap.linykweb.top/api/health/live curl -fsS https://travelmap.linykweb.top/api/health/ready2026-07-26 本案例采集报告素材时，真实响应为：{"status":"ok","service":"travel-map-web"} {"status":"ready","checks":{"database":"ok","redis":"ok"}} 业务验收至少包括：注册、登录和管理员权限；帖子、游记和编排公开页；图片上传、读取和删除；导入任务由 Worker 领取；AI 规划 SSE 与轮询恢复；WebSocket 协作、撤权和重连；浏览器刷新、断网与离线恢复；OBS 备份对象可下载；pg_restore --list 能读取备份。3.9.9 更新、回滚和备份推荐发布顺序：备份数据库 → 推送新不可变镜像 → 拉取镜像 → 执行向前兼容 migration → 启动/重建服务 → 健康检查 → 业务冒烟 → 观察协作、Worker 和数据库指标应用回滚可以把 TRAVEL_MAP_IMAGE 改回上一个标签。数据库迁移不能简单假设可逆；涉及数据结构删除时，必须提前设计 expand/contract 迁移或通过备份恢复。每天备份默认意味着最长约 24 小时 RPO。报告不能把它写成高可用生产架构。3.9.10 单机 Demo 的边界当前架构是单故障域：ECS 故障会同时影响 Web、Worker、Redis 和 PostgreSQL；没有数据库主备自动切换；4C8G 下多个服务存在资源竞争风险；本地容量 Harness 的 1k/5k/10k 连接结果不等于云上已经承载相同并发；恢复时间取决于镜像、备份和人工操作。如果平台进入正式长期运营，演进方向是：PostgreSQL → RDS 主备 Redis → DCS 媒体 → 私有桶 + CDN/签名访问策略 Web/Gateway/Worker → 多节点 Caddy → ELB/Ingress 监控 → AOM/LTS 或完整可观测平台3.10 阶段成果3.10.1 产品成果帖子、游记和编排的一体化内容平台；可拖放、可缩放、可跨日的时间板；地点、路线、交通、缓冲、固定事件和背景周期；游记富文本与编排嵌入；收藏、评论、点赞、关注、通知和公开收藏夹；URL/文本智能导入与审核；用户、内容、举报、账号池和 AI 配置后台。3.10.2 协作成果四级成员角色；邀请、Presence、评注与事件锁；WebSocket/SSE/轮询降级；PostgreSQL Outbox + Redis；版本、审计、冲突与权限回收；Prometheus 指标和运行手册。3.10.3 AI 与可靠性成果持久 PlanningRun、租约、心跳、重试与 fencing token；分阶段、可恢复的规划流程；来源、证据、事实冲突和成本账本；地点、路线与天气 fail-closed；Proposal 差异审查和用户确认；失败任务按最新配置原地重试。3.10.4 工程成果TypeScript strict；Prisma migrations；单元、组件、服务、数据库和浏览器测试；Docker 多阶段镜像；华为云 Compose、Caddy、OBS、SWR 与备份材料；存活、就绪和规划健康接口；部署、协作、备份和故障排查文档。3.11 人与 Agent 的职责边界阶段我负责码道负责Idea提出真实问题、目标与价值判断展开角色、场景、边界与风险需求决定优先级和非目标生成规格、查漏补缺、保持一致性设计判断产品取舍分析架构、数据模型和实施路径实现审批范围和重要变更读取代码、生成测试、修改文件、执行命令迭代提供真实现象和体验判断定位根因、补回归测试、完成修复验收判断结果是否符合使用预期运行测试、类型检查、构建和浏览器操作部署掌握账号、凭据和生产授权生成部署材料、核对官方文档、执行受控命令运维决定故障处置和风险接受分析日志、健康状态和回滚路径以下三个决定由人负责：这个功能是否值得做；这个风险是否可以接受；什么证据足以说明已经完成。3.12 案例总结本案例形成了一套从空项目到完整应用的 AI 辅助开发流程：创建本地空项目 → Agent 完善需求 → 编写 Spec、Design 和 Tasks → 建立失败测试 → 实现最小完整改动 → 执行本地测试、构建和浏览器验收 → 部署华为云 → 配置健康检查、备份和回滚 → 更新架构、测试和运行文档项目完成了以下主要调整：使用模块化编排统一旧行程列表；增加多人协作、权限、软锁和有序事件；使用受控 Proposal 管理 AI 规划结果；为保存、恢复、规划和协作增加审计与验证证据；完成本地运行、华为云部署、监控、备份和回滚材料。每项重要变更均关联需求、设计、代码和验证结果。人负责产品取舍、风险接受和发布授权，Agent 负责上下文分析、任务实施和证据整理。四、释放资源删除云资源可能不可恢复。先确认体验已经结束，并把需要保留的数据下载到受控位置。4.1 备份并验证数据在 ECS 的 deploy/huawei-cloud 目录执行最后一次 backup-postgres-to-obs.sh；进入 对象存储服务 OBS > 桶列表 > 私有备份桶，下载最新数据库备份及校验和；使用 pg_restore --list <备份文件> 验证备份可读；导出需要保留的公开媒体对象；记录最后一个可用的 SWR 镜像不可变标签。如果没有完成以上步骤，后续删除 ECS、EVS 或 OBS 对象可能导致数据永久丢失。4.2 删除 ECS、EVS 和 EIP进入 弹性云服务器 ECS > 弹性云服务器，选择本案例 ECS，单击 更多 > 删除；在确认对话框中核对是否需要同时删除系统盘、数据盘并释放绑定的 EIP；进入 云硬盘 EVS > 云硬盘，检查是否仍有未随 ECS 删除的按需数据盘，确认无保留需求后删除；进入 虚拟私有云 VPC > 弹性公网 IP 和带宽，释放仍处于计费状态的 EIP 和带宽；最后检查 安全组 和 VPC，仅在没有其他业务资源依赖时删除。ECS 关机后，EVS、EIP 等资源仍可能计费。需要按资源清单逐项释放。4.3 清理 OBS、SWR 与访问凭据进入 容器镜像服务 SWR > 我的镜像 > 镜像版本，删除不再需要的 TravelMap 镜像版本；若整个组织还承载其他项目，不要删除组织；进入 对象存储服务 OBS > 桶列表，分别检查媒体桶和备份桶；下载需保留对象后清空版本、碎片和对象，再删除不再使用的桶；保留对象仍会计费；进入 统一身份认证服务 IAM > 用户 > 安全设置 > 访问密钥，停用或删除本案例专用 AK/SK；在域名服务商或 云解析服务 DNS > 公网域名 中删除不再使用的 TravelMap 解析记录；在费用中心检查 ECS、EVS、EIP、OBS 和其他按需资源是否仍有计费项。五、扩展资料说明5.1 可复用 Prompt5.1.1 Idea 完善请先不要编码。阅读项目上下文，围绕目标用户、核心旅程、关键对象、 边界条件、失败场景、非目标和阶段计划完善这个 Idea。 请区分事实、假设和需要我决定的产品取舍。5.1.2 架构审查请只读审查当前实现。先给出数据流、权限边界、并发模型和故障恢复链路， 再列出按严重度排序的问题。每个问题必须包含代码证据、影响范围、 建议方案和需要增加的测试。本轮不要修改文件。5.1.3 TDD 修复现象： 期望： 现有证据： 不可破坏的行为： 请先增加一个能稳定复现问题的失败测试，确认它因目标原因失败； 然后实现最小完整修复，运行目标测试、全量测试、类型检查和生产构建。 如果真实页面行为无法由测试证明，再执行浏览器验收。5.1.4 部署设计请先盘点项目的 Web、数据库、Worker、长连接、对象存储和凭据需求， 再对照华为云官方文档比较候选部署方案。 输出推荐架构、资源规格、网络边界、费用与故障域， 并列出上线前阻断项。本轮先分析，不生成虚假的成功结论。5.1.5 发布验收请按发布门禁检查：依赖安装、测试、类型、构建、Prisma migration、 Docker/Compose 配置、健康接口、对象存储、Worker、WebSocket、SSE、 备份和回滚。每项给出实际命令、结果和证据位置。 未执行的项目必须明确标记为未执行。5.3 官方与项目资料5.3.1 华为云码道华为云码道官方产品页产品介绍码道 IDE/CLI 下载CLI SDD 规范驱动开发CLI SkillsCLI 自定义命令CLI MCPCLI 子智能体CLI 权限管理CLI 沙箱机制代码库索引5.3.2 华为云部署弹性云服务器 ECS对象存储服务 OBSSWR 上传镜像CodeArts BuildCodeArts DeployCodeArts Deploy 快速入门

研途 TaskFlow——大学生训练营任务与专注管理应用一、概述1.1 案例介绍大学生在训练营、课程设计和创新实践中，常同时面对课程学习、项目开发、文档整理与答辩准备等任务，容易出现优先级混乱、进度不可见和学习过程难复盘的问题。本案例使用华为云码道（CodeArts）代码智能体辅助构建“研途 TaskFlow”响应式 Web 应用，将任务看板、番茄专注和数据分析整合在一个无需注册、打开即用的工具中。应用支持任务增删改查、状态流转、搜索筛选、逾期识别、专注计时、学习数据可视化，以及 JSON 数据导入导出；信息默认保存在浏览器本地，兼顾使用便利与隐私。1.2 适用对象高校学生训练营学员个人开发者1.3 案例时间本案例总时长预计 60 分钟，其中环境准备 10 分钟、代码部署 10 分钟、功能体验 25 分钟、测试与部署 15 分钟。1.4 案例流程需求分析 → 码道辅助设计 → 编写与调试 → 自动化测试 → 静态部署 → 功能体验 │ │ │ │ │ 真实学习场景 架构/页面/规则 CRUD/计时器 核心规则测试 华为云环境说明：分析训练营学习过程中的任务规划与专注管理需求；使用华为云码道辅助完成产品拆解、界面设计、业务代码生成与问题调试；在云开发环境中部署项目并体验任务看板、专注空间和数据分析；使用 Node.js 内置测试框架验证完成率、逾期判断、状态流转和数据导入规则；将静态资源部署至可访问的 Web 环境，完成演示与验收。1.5 资源总览本案例使用免费资源，不产生必要费用。资源名称规格单价华为开发者空间云开发环境Ubuntu 容器，建议 2 vCPU、4 GB 内存免费额度内免费华为云码道（CodeArts）代码智能体通用体验版免费浏览器Chrome、Edge 等现代浏览器免费二、环境和资源准备2.1 准备华为开发者空间登录华为开发者空间，进入 开发平台 > 云开发环境 > 容器，创建 Ubuntu 云开发环境。若只在个人电脑体验，也可直接使用 Windows、macOS 或 Linux 环境。2.2 准备开发工具建议环境如下：工具版本要求用途华为云码道（CodeArts）当前通用体验版辅助需求分析、编码和调试Git2.40 或更高版本版本管理和代码上传Node.js18 或更高版本运行自动化测试（应用运行不依赖 Node.js）Python3.10 或更高版本启动本地静态服务器（可选）可从华为云码道产品页面下载并安装当前版本。2.3 使用码道辅助开发在码道中打开项目目录，按阶段输入提示词。本案例使用的代表性提示词如下：你是一名 Web 产品工程师。请为大学生训练营设计一个任务与专注管理单页应用， 要求无需登录，支持任务 CRUD、三状态看板、截止日期、优先级、番茄钟、统计图表和本地持久化。 请先输出功能模块、数据模型、异常场景和验收标准，不要立即编写代码。请审查任务状态流转、逾期判断和导入数据校验逻辑，把纯业务函数拆分到 core.js， 并使用 Node.js 内置 node:test 编写边界测试。不要引入第三方依赖。码道用于辅助完成需求拆解、代码建议、错误定位和测试用例设计，开发者负责确认业务规则、审查生成代码并完成运行验证。三、构建研途 TaskFlow 应用3.1 系统架构设计应用采用纯前端分层架构，不依赖后端与数据库：┌─────────────────────────────────────────┐ │ 表现层：仪表盘 / 任务看板 / 专注 / 分析 │ ├─────────────────────────────────────────┤ │ 交互层：事件处理、表单校验、计时器 │ ├─────────────────────────────────────────┤ │ 业务层：完成率、逾期、状态流转、导入校验 │ ├─────────────────────────────────────────┤ │ 数据层：浏览器 localStorage / JSON 文件 │ └─────────────────────────────────────────┘核心数据模型：{ tasks: [{ id, title, category, priority, due, estimate, note, status, createdAt }], focusSessions: [{ id, task, minutes, date, time }] } 3.2 部署项目代码3.2.1 项目结构taskflow/ ├── index.html # 页面语义结构和各功能视图 ├── css/ │ └── style.css # 视觉主题、看板和响应式布局 ├── js/ │ ├── app.js # 状态管理、交互和本地持久化 │ └── core.js # 可独立测试的业务规则 ├── tests/ │ └── core.test.js # 自动化测试 ├── 案例文档.md # 本案例说明 └── README.md # 项目简介与启动方式3.2.2 下载源码项目源码已随案例提供。下载项目文件后，进入 TeskFlow 根目录即可继续操作。3.2.3 关键代码讲解1）任务状态流转任务按照“待开始 → 进行中 → 已完成 → 待开始”循环。业务规则被拆分为纯函数，便于测试：function nextStatus(status) { const validStatuses = ['todo', 'doing', 'done']; const index = validStatuses.indexOf(status); return validStatuses[(index + 1) % validStatuses.length]; } 2）任务逾期判断比较日期前先将当天时间归零，避免当前时分秒导致“今天截止”的任务被错误标为逾期；已完成任务不再显示逾期：function isOverdue(task, today = new Date()) { const end = new Date(today); end.setHours(0, 0, 0, 0); return task.status !== 'done' && new Date(task.due + 'T00:00:00') < end; } 3）本地数据持久化每次数据变化后写入 localStorage 并统一刷新视图。用户无需注册，刷新页面后数据仍然存在：function save() { localStorage.setItem('taskflow-data-v1', JSON.stringify(data)); renderAll(); } 4）安全导入导入 JSON 文件前验证顶层字段、数组类型和任务关键字段，避免错误数据破坏应用状态：function validateImport(data) { return !!data && Array.isArray(data.tasks) && Array.isArray(data.focusSessions) && data.tasks.every(task => task.id && task.title && ['todo', 'doing', 'done'].includes(task.status)); } 3.3 运行与调试在项目根目录启动静态服务器：python -m http.server 8080 浏览器访问本机的 8080 端口。也可以直接双击 index.html 运行。依次验证以下流程：点击“新建任务”，填写名称、分类、优先级、截止日期和备注并保存；在任务看板使用右箭头切换任务状态，编辑或删除任务；使用关键词、状态和分类组合筛选任务；进入专注空间，选择关联任务与专注时长，完成一次计时；进入数据分析，查看累计专注、七日趋势、分类分布和学习建议；导出 JSON 备份，再导入该文件验证数据恢复。3.4 自动化测试执行：node --test 测试覆盖：有任务和无任务时的完成率计算；已完成任务不应被标记为逾期；三种任务状态循环流转；非法备份数据应被拒绝。预期所有测试显示 pass，失败数为 0。3.5 关键技术难点与解决思路难点解决思路效果页面刷新后数据丢失统一使用 localStorage 持久化，并提供 JSON 备份无后端也能持续使用和迁移数据日期边界判断容易出错使用本地日期字符串，并将比较基准归零到当天 00:00当日任务不会误报逾期计时器与界面状态不同步用 totalSeconds、remaining 和 running 管理单一状态暂停、重置和完成记录行为一致业务代码难以测试将规则抽离到 UMD 格式的 core.js浏览器和 Node.js 可复用同一套逻辑手机端三列看板过窄使用 CSS 媒体查询将看板降为单列手机、平板与电脑均可操作3.6 应用创新点将训练营任务与番茄专注关联，专注记录能够标明对应任务；根据逾期数量与累计专注时长自动生成简短学习建议；无账号、无后端、零必要费用，适合个人学习和课堂快速部署；数据可导出与迁移，在强调隐私的同时解决本地存储不可跨设备的问题；原生技术栈无构建步骤，降低初学者阅读、修改和部署门槛。四、资源释放本案例默认使用免费的云开发环境且不购买付费资源。体验完成后，如不再使用开发者空间容器，可进入 开发平台 > 云开发环境 > 容器，停止或删除对应环境。删除前请确认代码已经提交至远程仓库，或已下载 JSON 数据备份。浏览器中的应用数据可通过“数据管理”页面导出；清理浏览器站点数据会删除 localStorage 中的任务和专注记录。五、扩展资料说明MDN：Window.localStorageMDN：使用媒体查询Git 官方文档华为云对象存储服务 OBS 文档

批量作业调度在企业数据架构中处于一个特殊的位置——它不属于任何一个具体的业务环节，却是几乎所有数据处理流程能够自动运转的前提条件。数据采集：依赖调度按时触发ETL任务，数据计算：依赖调度按序编排Spark/SQL作业，报表生成：依赖调度在上游数据就绪后自动启动汇总程序，账务处理：依赖调度在日切窗口内严格按序执行清算流程。调度系统的稳定性和效率直接决定了企业数据资产的时效性和业务流程的连续性。然而，这一“基础设施”定位也使批量作业调度面临独特挑战：需要对接企业内几乎所有涉及批量处理的异构系统，管理规模已从千级攀升至十万级乃至更高，数万作业构成的依赖链路中任何节点异常都可能出现级联传播的情况。运维人员需要的不再是“出了问题再排查”，而是全链路可观测、快速定位、精准干预的系统化能力。MoiaControl正是定位于这一核心基础设施层的企业级统一任务调度平台，由北京先进数通完全自主研发，历经二十余年迭代，覆盖银行、证券、保险、制造等行业超百家企业。本文将围绕统一管控、高可用架构、规模化弹性、智能运维、合规迁移五个维度，深入解读其技术能力与实践价值。 一、 打破孤岛：构建企业级调度"一张网现实困境：企业在数字化建设中往往形成多个“调度孤岛”——数据仓库有自己的ETL调度，业务系统用另一套批处理，报表平台又独立运行。当一个上游作业延迟，下游团队往往要逐一排查才能定位问题，跨系统的作业协调更依赖人工沟通，效率极低。 MoiaControl的破局之道：平台提供统一的任务编排引擎，支持将分散在不同系统、不同技术栈中的作业纳入统一管控。通过可视化配置界面，业务人员可直观构建复杂的作业依赖关系，系统自动处理执行顺序与依赖触发。无论是跨库的数据抽取、多环节的报表生成，还是涉及外部接口的订单清算，均可在同一平台完成全链路编排，实现“一处配置、全局联动”的调度效果。开发者无需在调度逻辑上反复调试，将精力真正释放到业务创新中。二、 韧性架构：让调度系统成为“不怕故障”的底座现实困境：调度系统的可用性往往被低估——一直到它宕机。传统调度方案中，单点故障可能导致整个数据链路中断，而简单的冷备方案切换时间长、数据一致性难保障，无法满足业务连续性要求。 MoiaControl的破局之道：平台采用分层解耦的分布式架构设计，将Web服务层、调度核心层、执行节点层独立部署，任何一层的局部故障都不会波及其他层级。调度核心层支持多节点集群运行，当某个节点出现异常时，集群内的其他节点可自动接管其任务，无需人工干预。平台还内置完善的故障恢复机制。通过事务状态持久化、执行数据本地缓存及自动补发等技术，确保系统在重启或灾难恢复后能够自动接续中断的任务，最大限度减少业务影响。针对跨数据中心场景，平台提供成熟的容灾部署方案，帮助企业构建同城或异地的调度高可用体系。三、 弹性应对：从容驾驭规模化调度挑战现实困境：随着数据中台、数据湖建设的推进，企业调度任务量从千级跃升至十万甚至百万级。传统基于轮询扫描的调度方式，在任务量激增时响应速度急剧下降，依赖作业间的触发延迟可能达到分钟级，严重影响数据时效性。 MoiaControl的破局之道：平台底层采用事件驱动架构，摒弃低效的定时扫描模式，任务状态变化即刻触发后续依赖，将作业间衔接延迟压缩至毫秒量级。执行层节点采用无状态设计，支持弹性伸缩——业务高峰期可快速扩容新节点接入集群，低谷期可动态释放资源，整个过程无需重启现有服务，调度业务零中断。在异构环境兼容方面，平台原生支持包括Shell脚本、SQL存储过程、Python程序、Spark/Hive大数据任务在内的多种主流作业类型，并提供插件扩展机制，企业可按需接入自定义任务类型，无需等待产品版本更新。配合节点级、作业级、资源级等多维度并发控制策略，平台能够在资源有限的情况下实现精细化调度，避免关键业务因资源争抢而延迟。四、 从被动到主动：重塑调度运维体验现实困境：传统的调度运维往往是“救火式”——作业失败了才知道，出了问题才去查。运维人员需要登录多个系统查看日志，人工比对上下游关系才能定位根因。夜间值班面对十几块监控屏幕已是常态，身心俱疲。 MoiaControl的破局之道：平台构建了一体化的调度运维中心，将分散的监控信息汇聚为统一视图。运维人员可通过流程图、拓扑图、列表等多种视角，实时掌握全链路任务执行状态。当某个节点出现异常，平台的依赖溯源能力可快速追溯该节点的完整上下游关系，帮助运维人员在数分钟内定位问题源头及影响范围，而非逐层排查。平台还支持自定义告警策略，可根据作业失败、超时、重试次数等多种条件触发通知，并支持多渠道分发。更值得关注的是，平台正在引入AI能力——运维人员可通过自然语言询问“昨天夜间哪些任务执行失败”或“本月任务平均耗时趋势”，平台可基于运行数据自动生成分析结果与优化建议，让调度运维从经验驱动转向数据驱动。五、 合规先行与存量迁移：兼顾当下与未来现实困境：信创政策的推进让许多企业面临调度平台国产化替代的压力。然而，替换一个运行多年的调度系统并非易事——历史作业配置的迁移、业务逻辑的平滑过渡、与现有系统的兼容对接，每一个环节都暗藏风险。 MoiaControl的破局之道：在信创适配方面，平台已完成与主流国产服务器芯片、操作系统、数据库及中间件的全面兼容认证，可满足企业核心系统自主可控的合规要求。在存量系统迁移方面，平台针对Control-M等主流调度软件提供了专业的配置迁移方案。通过专用工具可直接解析原有配置，将历史作业快速导入新平台，减少人工逐项重配的工作量。某金融机构在实际迁移过程中，成功将超过15000个存量作业平稳切换至MoiaControl，原系统运行环境保持不变，迁移完成后业务零中断。此外，平台提供开放的集成接口，便于与企业已有的监控系统、统一认证平台、办公协同系统等对接，降低系统整合的技术门槛，实现调度平台与企业IT生态的无缝融合。  调度系统的选择，本质上是企业对数据处理效率、业务连续性与运维成本的综合权衡。MoiaControl以二十余年的行业深耕为基础，将稳定可靠的架构设计、灵活适配的扩展能力与持续演进的智能化特性融为一体，为企业提供从调度规划、平台建设到持续运营的全周期支撑。

 2026 年，企业智能体（AI Agent）已从概念验证进入规模化落地阶段，成为企业数字化、智能化升级的核心基础设施。市场形成全栈大厂、开源生态、安全合规、垂直场景四大阵营，覆盖从个人开发者快速试水到大型集团私有化部署的全场景需求。一、评测背景与核心标准1.1 市场现状据 IDC 数据，2026 年中国企业级智能体市场规模突破 186 亿元，年增速 58%，头部平台占据 75% 市场份额。企业选型核心痛点集中在：开发门槛、数据安全、系统集成、幻觉抑制、成本可控、落地效率。1.2 评测核心维度（2026 企业级标准）模型底座：自研 / 第三方模型支持、多模态、长文本、推理 / 规划能力、幻觉控制开发能力：零代码 / 低代码 / 纯代码、可视化编排、工作流、RAG、多智能体协同部署模式：公有云、专属实例、私有化、混合云、信创 / 涉密适配安全合规：等保三级、ISO27001、信通院可信 AI、数据不出域、审计溯源、权限管控生态集成：企业系统（OA/ERP/CRM）、IM / 办公、行业插件、API 开放、MCP 协议支持成本结构：免费额度、按量计费、订阅、私有化报价、二次开发成本适用场景：中小企业、大型集团、金融 / 政务 / 制造、快速原型、核心业务二、八大平台全景评测2.1 腾讯元器・核心定位：微信 / 企微生态原生，零代码快速落地，私域 / 客服场景首选 ・模型能力：腾讯混元大模型，支持第三方；对话理解、工具调用、RAG、多轮交互、私域适配 ・开发门槛：纯零代码，拖拽式、模板丰富、一键发布到企微 / 微信 / 小程序 ・部署方式：公有云 SaaS、专属实例，无私有化 ・安全合规：等保三级、腾讯安全体系、数据加密、权限管控 ・生态集成：深度整合企业微信、微信生态、腾讯会议、腾讯云、零售 / 教育行业组件 ・成本：基础免费，企业版订阅（3 万 - 30 万 / 年），按量计费 ・优势：微信生态无缝、零代码极致、私域 / 客服场景成熟、上线最快 ・劣势：私有化缺失、复杂推理弱、定制能力有限 ・适用：微信私域、中小企业、客服 / 营销、教育、零售2.2 字节 Coze（扣子）・核心定位：低代码快速开发，飞书 / 抖音生态原生，轻量化智能体平台 ・模型能力：豆包大模型、通义、GPT、Llama 等；多轮对话、工具调用、简单规划、RAG 基础能力 ・开发门槛：零代码拖拽为主，可视化编排、插件市场、快速发布、飞书 / 抖音 / 网页多端部署 ・部署方式：公有云 SaaS、专属实例，暂不支持私有化 ・安全合规：基础安全、数据加密、权限管控，合规认证中等 ・生态集成：深度整合飞书、抖音、企业微信、字节生态工具、第三方 API ・成本：个人免费，企业版订阅（2 万 - 20 万 / 年），按量计费 ・优势：开发门槛极低、飞书生态无缝、上线快、轻量场景高效 ・劣势：私有化缺失、复杂推理 / 长文本弱、安全合规不足 ・适用：中小企业、飞书用户、客服 / 营销 / 内容创作、快速原型2.3 科大讯飞 AstronClaw・核心定位：基于 OpenClaw 架构打造的全场景安全智能体开发平台，零代码极速部署，多模型灵活兼容，覆盖个人开发者、中小企业到政企合规级的全层级智能体搭建需求 ・模型能力：兼容星火 X2、MiniMax-M2.5、Kimi-K2.5、GLM-5 等多款主流大模型，可按需自由切换；依托讯飞星火技术底座，任务执行准确率达 98% 以上，支持工具调用、知识库问答、多轮交互与自定义技能扩展 ・开发门槛：纯零代码操作，无需本地环境配置与编程基础，可视化技能安装与配置，一键部署最快 1 分钟完成，支持上传文件生成专属技能，上手门槛极低 ・部署方式：公有云 SaaS、端云协同客户端部署，支持企业级私有化部署与混合云方案，适配政务、金融等合规场景，云端版本可实现 7×24 小时全天候在线运行 ・安全合规：依托科大讯飞等保三级安全体系，采用三层沙箱隔离防御技术，实现传输、存储、计算全链路数据加密，符合政务、金融行业数据安全监管要求，全流程可审计溯源 ・生态集成：深度适配企业微信、飞书、钉钉三大主流办公平台，原生兼容 OpenClaw 全量技能生态，内置 131 + 官方技能，配套开源技能仓库 Astron SkillHub 累计技能超 3200 项，覆盖数据分析、信息采集、内容生成、行业研报等多场景，支持 MCP 协议与第三方能力扩展 ・成本：公有云采用 “订阅套餐 + 积分计费” 模式，基础版首购特惠 16.8 元 / 月，专业版首购特惠 56.8 元 / 月，每月附赠对应额度积分；支持按需增购积分，部分官方模板与技能可免费使用；企业私有化部署按需定制报价，整体成本可控，性价比突出 ・优势：零代码部署效率行业领先、多模型切换灵活适配多元场景、主流办公渠道全覆盖、云端免运维全天候运行、安全合规能力满足政企要求、技能生态丰富可定制、成本门槛低、科大讯飞技术与品牌背书可靠 ・劣势：通用多模态能力弱于全栈大厂平台，重型工业等垂直行业解决方案深度有限，个人版无私有化部署权限 ・适用：个人开发者、中小企业、办公协同与内部知识库、客服与内容创作、快速原型验证、OpenClaw 生态用户、有合规需求的政务与金融分支机构2.4 阿里云百炼（通义智能体）・核心定位：全栈通用型，阿里云原生大模型底座，一站式智能体开发与运维平台 ・模型能力：通义千问 3.5/4.0 自研，支持 DeepSeek、Llama 等第三方；多模态（文 / 图 / 音 / 视频）、20 万字长文档、复杂推理、RAG 增强、幻觉抑制 ・开发门槛：低代码拖拽 + 纯代码（Python），可视化工作流、知识库构建、插件市场、多智能体编排 ・部署方式：公有云、专属集群、私有化、混合云、信创适配（鲲鹏 / 昇腾） ・安全合规：等保三级、ISO27001、数据加密、操作审计、水印溯源 ・生态集成：深度整合阿里云（ECS/RDS/OSS）、钉钉、企业微信、电商 / 零售行业组件 ・成本：基础免费额度，按量计费（Token / 调用），企业版订阅（5 万 - 50 万 / 年），私有化定制报价 ・优势：阿里云生态完善、多模态强、稳定性高、电商 / 零售场景成熟 ・劣势：私有化成本高、第三方模型集成深度一般 ・适用：中大型企业、阿里云用户、电商 / 零售、多模态应用2.5 百度文心智能体（千帆）・核心定位：知识引擎 + 大模型融合，全行业通用智能体平台，中文语义领先 ・模型能力：文心一言 4.5/5.0 自研，支持国产 / 开源模型；长文本解析、知识图谱融合、复杂决策、RAG + 检索增强 ・开发门槛：零代码 / 低代码可视化、工作流、知识库、技能编排、多智能体协同 ・部署方式：公有云、专属实例、私有化、混合云、政务 / 金融合规部署 ・安全合规：信通院可信 AI、等保三级、数据隔离、审计、幻觉可追溯 ・生态集成：百度智能云、飞桨、百度搜索、企业微信、行业知识库（医疗 / 法律 / 制造） ・成本：免费试用，按量计费，企业版订阅（4 万 - 40 万 / 年），私有化定制 ・优势：中文理解顶尖、知识能力强、政务 / 制造适配好、开源生态友好 ・劣势：多模态弱于阿里、生态广度一般 ・适用：知识密集型行业（法律 / 医药 / 制造）、政务、中小企业2.6 Dify（开源社区）・核心定位：开源 LLMOps + 智能体平台，灵活定制、自托管，开发者 / 中小企业首选 ・模型能力：支持 100 + 模型（GPT、Claude、通义、文心、Llama）；RAG、工作流、多智能体、插件扩展 ・开发门槛：低代码可视化 + 纯代码（Python/TypeScript），开源可二次开发、社区插件丰富 ・部署方式：公有云 SaaS、Docker 自托管、私有化部署、混合云 ・安全合规：自托管数据完全可控，基础安全，需企业自行完成合规认证 ・生态集成：开源社区、GitHub、企业系统 API、MCP 协议、第三方插件（500+） ・成本：开源免费（自托管），SaaS 版订阅（1 万 - 10 万 / 年），私有化无额外授权费 ・优势：完全开源、模型自由、定制强、成本极低、开发者友好 ・劣势：无官方技术支持、运维复杂、企业级安全 / 合规需自建 ・适用：技术团队、中小企业、开源爱好者、定制化需求、预算有限2.7 蚂蚁 Agentar・核心定位：金融级高可信智能体，全链路合规、长思维链、复杂决策，金融 / 能源首选 ・模型能力：蚂蚁自研大模型，金融行业微调；十万级长思维链、复杂逻辑推理、RAG + 行业知识、幻觉极低 ・开发门槛：低代码 + 专业代码，金融工作流、风控 / 信贷模板、多智能体协同 ・部署方式：私有化、混合云、金融合规专区、信创适配 ・安全合规：信通院可信 AI 5 级、等保三级、金融级安全、全链路可追溯、数据不出域 ・生态集成：支付宝、蚂蚁金融云、银行 / 保险系统、能源行业组件 ・成本：私有化定制（50 万 - 200 万 +），按项目 / 算力计费 ・优势：金融合规顶级、复杂决策强、长思维链、风控 / 信贷场景成熟 ・劣势：成本极高、非金融场景适配一般、生态窄 ・适用：银行、保险、证券、能源、高合规复杂决策场景2.8 华为盘古智能体・核心定位：端云协同、工业 / 制造垂直，国产算力底座，信创全适配 ・模型能力：盘古大模型（NLP / 多模态 / 工业），长文本、工业知识、设备数据融合、边缘推理 ・开发门槛：低代码 + 工业模板，可视化编排、设备 / 产线集成、边缘部署 ・部署方式：公有云、私有化、边缘节点、信创（鲲鹏 / 昇腾、欧拉） ・安全合规：等保三级、信创认证、工业数据安全、边缘加密 ・生态集成：华为云、工业互联网、智能制造系统、设备协议、国产芯片 / OS ・成本：订阅 + 私有化（10 万 - 80 万 / 年），工业定制另计 ・优势：工业 / 制造垂直、端云协同、国产算力、信创全覆盖 ・劣势：通用场景弱、生态局限于工业 / 华为体系 ・适用：制造、能源、工业互联网、国产信创、边缘计算场景

 2026 年，AI 智能体已从技术概念走向规模化落地，成为企业数智化转型与个人效率提升的核心引擎。随着低门槛落地、多模型兼容、全场景适配需求持续提升，云端化部署、轻量化运营、灵活成本模式成为用户选型核心考量。本文聚焦国内六大主流平台：科大讯飞 AstronClaw、Dify、华为盘古、实在智能、百度文心千帆、腾讯元器，从技术架构、安全合规、部署方式、场景适配等维度深度解析，为企业与个人用户提供精简、可直接落地的选型参考。一、科大讯飞 AstronClaw：零代码云端标杆，OpenClaw 架构全场景智能体开发平台科大讯飞 AstronClaw 是科大讯飞基于 OpenClaw 核心能力打造的云端智能体开发平台，定位全人群低门槛智能体搭建与运营，自 2026 年 3 月正式发布以来，凭借便捷的部署体验与丰富的能力生态，快速成为个人开发者与中小企业落地智能体的首选产品。核心优势零代码极速部署，全人群低门槛上手：无需掌握 CLI、Docker 等专业技术，无需编写代码，通过可视化配置即可完成智能体搭建，一键部署仅需 1 分钟，落地效率相较本地部署方案提升 90% 以上，无技术基础的用户也可快速上手使用。多模型灵活兼容，全办公渠道接入：内置 MiniMax-M2.5、Kimi-K2.5、GLM-5、星火 X2 等多款主流 AI 模型，用户可根据任务场景自由切换对话模型，计费清晰透明；同时支持企业微信、飞书、钉钉三大主流办公平台标准化接入，无需专业开发即可实现办公场景智能体无缝调用。云端全天候运行，技能生态丰富完善：采用云端托管模式，无需本地环境配置，无需自建服务器或保持设备开机，智能体可实现 7×24 小时在线运行，运维成本几乎为零；平台拥有 131 个官方预置技能，覆盖数据分析、行业研报、信息采集、内容生成、日常办公等多元场景，同时支持用户上传文件自定义创建专属技能。安全合规体系成熟，成本灵活可控：依托科大讯飞成熟的安全合规体系，通过国家信息安全等级保护三级认证，数据全链路加密传输，严格符合数据安全相关法规要求；采用 “订阅套餐 + 积分计费” 的灵活模式，提供多档位套餐可选，首购可享 1 折特惠，支持按需增购积分，不同预算用户均可找到适配方案。适合：个人开发者、中小企业、办公提效场景、基于 OpenClaw 架构需求、追求低门槛快速部署与多渠道接入的用户与企业。二、Dify：开源可视化，技术团队私有化首选Dify 是 GitHub 高星开源 AI 应用 / 智能体开发平台，以灵活、开源、可高度定制成为技术团队与中小企业的主流选择。核心优势开源可控：支持 Docker、K8s 一键私有化部署，代码完全自主，无平台绑定，适合自建 AI 中台。可视化工作流编排：低代码画布即可完成模型调用、RAG 知识库、工具接入、流程逻辑编排，快速搭建生产级应用。强大 RAG 与多模型兼容：支持接入本地模型与私有向量库，文档处理、检索增强能力成熟，社区插件丰富。适合：技术团队、自研 AI 平台、预算有限但需要高度定制化的企业。三、华为盘古智能体：国产化全栈，工业制造标杆华为盘古智能体平台依托昇腾算力与盘古大模型，打造全栈国产化、工业级稳定的智能体解决方案，是制造、能源、政务等领域的首选。核心优势国产化全栈闭环：从芯片、框架到大模型、平台层完全自主可控，满足信创与国产化替代硬性要求。工业级高可用：支持零代码 / 低代码混合开发，提供智能体开发、测试、部署、运维全链路能力，模型无感切换，保障生产环境稳定。行业深度适配：在钢铁、化工、装备制造等传统工业场景优势突出，可处理复杂设备数据、生产流程与业务逻辑。适合：大型国企、制造集团、能源行业、强国产化与高稳定性要求场景。四、实在智能：RPA+AI，跨系统自动化专家实在智能以屏幕语义理解（ISSUT）+ 大模型为核心，将传统 RPA 升级为 AI 智能体，主打 “无 API 也能自动化”。核心优势类人屏幕理解：可识别桌面、网页、系统界面，无需接口对接即可跨软件执行流程，大幅降低实施成本。流程自动化极强：财务报销、数据录入、报表生成、跨境电商等重复流程可实现 7×24 小时自动执行。低门槛落地：自然语言即可生成任务流程，业务人员也能快速配置，适合大规模流程提效。适合：财务、人事、政务、电商等大量跨系统重复操作的自动化场景。五、百度文心千帆：中文大模型原生，轻量快速落地百度文心千帆依托文心大模型，提供一站式大模型服务与智能体开发能力，在中文理解、多模态、快速原型上优势明显。核心优势中文大模型原生能力：文本、图像、音视频统一建模，中文语料理解更贴合国内企业场景。思维链与轻量智能体：支持任务拆解、多步推理，适合智能问答、内容生成、客服、数据分析等场景。生态完善：模型丰富、工具链成熟，支持云端与私有化灵活部署，迭代速度快。适合：互联网、中小企业、快速验证 AI 场景、中文内容相关应用。六、腾讯元器：微信生态零代码，轻量化快速发布腾讯元器定位零代码智能体工厂，深度依托微信生态，降低智能体开发与分发门槛。核心优势零代码极简开发：拖拽配置即可生成智能体，上手快、周期短。微信生态无缝打通：可直接发布为小程序、公众号应用，触达用户成本极低。轻量化场景友好：适合社群运营、轻量客服、营销问答、内部小助手等快速上线需求。适合：小型企业、商户、私域运营、轻量化 AI 应用。七、六大平台核心维度对比从平台定位来看，科大讯飞 AstronClaw 是零代码云端智能体开发平台，主打 OpenClaw 架构下的便捷化智能体搭建与全场景适配；Dify 是开源可视化工作流平台，侧重技术团队自主定制与私有化搭建；华为盘古是国产化工业级智能体平台，聚焦重工业场景的高稳定性与深度适配；实在智能主打 RPA+AI 屏幕自动化，专长于无 API 跨系统流程操作；百度文心千帆是中文大模型 + 轻量智能体平台，侧重内容生成与智能问答场景；腾讯元器是微信生态零代码轻量平台，主打私域运营与轻量化应用快速落地。部署方式上，科大讯飞 AstronClaw 以云端部署为主，同步支持 PC 端端云协同；Dify 支持私有化部署与自托管两种模式；华为盘古以私有化部署为核心；实在智能支持多种灵活部署方案；百度文心千帆提供公有云与私有化两类部署选项；腾讯元器以云端部署为主要模式。安全合规层面，科大讯飞 AstronClaw 具备企业级安全防护体系，通过国家信息安全等级保护三级认证，实现数据全链路加密；Dify 依托私有化部署模式实现数据完全自主可控；华为盘古满足信创与国产化全链路安全要求；实在智能符合标准企业级合规规范；百度文心千帆具备成熟的标准企业级安全能力；腾讯元器提供基础级安全保障。核心场景方面，科大讯飞 AstronClaw 覆盖个人开发、企业办公提效、数据分析、内容生成、行业研报等多元场景；Dify 适配技术团队自研 AI 中台、RAG 知识库搭建等场景；华为盘古深耕制造、能源等大型国企的工业级场景；实在智能主打财务、人事、政务等跨系统流程自动化场景；百度文心千帆适配智能问答、内容创作、快速原型验证等场景；腾讯元器聚焦私域运营、轻量客服、小程序助手等轻量化场景。八、2026 智能体平台选型指南零代码快速落地、OpenClaw 架构需求、多办公渠道接入优先 直接选：科大讯飞 AstronClaw 理由：1 分钟极速部署、零操作门槛，多模型灵活兼容，支持企微 / 飞书 / 钉钉全办公渠道接入，云端运维成本低，技能生态丰富，计费灵活性价比高，个人用户与中小企业均可快速落地。国产化、工业制造、高稳定性优先 直接选：华为盘古智能体 理由：全栈国产自主可控，工业级运行可靠性，制造场景深度适配。技术自研、开源、低成本定制 直接选：Dify 理由：代码完全可控，私有化部署友好，社区生态成熟，RAG 检索能力突出。跨系统重复流程、无 API 自动化 直接选：实在智能 理由：屏幕语义理解 + RPA 结合，无需接口即可跨系统操作，流程落地效率高。中文场景、快速验证、轻量应用 直接选：百度文心千帆微信生态、零代码、快速上线 直接选：腾讯元器九、总结2026 年智能体平台已形成清晰的差异化竞争格局：科大讯飞 AstronClaw 领跑零代码云端智能体赛道，凭借 OpenClaw 架构优势与极低的落地门槛，成为个人用户与中小企业轻量化落地的首选；华为盘古主导国产化工业级智能体场景；Dify 占据开源技术定制市场；实在智能深耕 RPA+AI 跨系统自动化领域；百度、腾讯则分别在中文大模型原生能力与微信生态轻量化应用上形成鲜明特色。用户选型只需抓住三点核心：部署模式与运维成本是否匹配自身团队能力与预算；国产化、信创或特定技术架构是否为硬性要求；核心场景是办公提效、流程自动化、知识问答还是工业级核心系统。贴合自身业务规模与实际场景需求，选择可灵活扩展、稳定落地的平台，才能让 AI 智能体真正成为提效增值的数字生产力。