历阶 Helix · Beta 冲刺随笔 Day2
历阶 Helix · Beta 冲刺随笔 Day2
| 这个作业属于哪个课程 | 202601福大-软件工程实践-W班 |
|---|---|
| 这个作业要求在哪里 | 团队作业—Beta 冲刺 + 事后诸葛亮 |
| 团队名称 | 历阶 |
| 这个作业的目标 | 记录 Beta 冲刺第 2 天的检索与正文读入改造:检索词规范化与合并、双引擎并行、文库站配额与补位、正文清洗与质量分级,以及开发过程中修掉的 analyze 500;并入 11-17 站会、周蔚琳的 3D 修复与林彩华的回归结果 |
| 其他参考文献 | 《构建之法》;历阶 Helix · Beta 冲刺随笔 Day1 |
目录
- 历阶 Helix · Beta 冲刺随笔 Day2
- 一、Scrum
- 二、今日签入
- 今日修掉的五个问题
- 三、测试回归
- 问题总览
- 问题 1:本地库缺表,新接口集体 500
- 问题 2:subtask_id 空串把整条落库打回
- 问题 3:15 秒超时把分析成果挡在门外
- 四、任务状态
- 五、运行情况
- 六、站会
一、Scrum
| 成员 | 昨天站会至今完成了什么 | 花费 | 问题 | 到明天站会前 |
|---|---|---|---|---|
| 柳钰舒 | 检索与读入整条线:生成 queries.ts(规范化 + 三档合并 + 泛用词守卫);重写 retrieval.ts(方向配额、同 host 上限、文库站每站 1 条、死链重试与补位、读入补位、质量分级、段落截断、不再退化成仅检索词);引擎换成博查 + 智谱并行;容量 12/6/4/24s、perQuery 10;draft.ts 每步最多挂 3 条材料、检索词 6–8 条;readers 正文清洗升到 0.4.0;修 analyze 500 与材料去重 | 未单独计时 | 智谱召回仍会跑偏(「python 装饰器」类查询带回 php.cn 的 AI 工具文);文库站正文读不出,属检索源结构问题;11-17 回归又在我这条链路的下游开了两项(见第三节) | 先修回归的问题 2、3,再跑压测;检索词质量单独开一轮 |
| 周蔚琳 | 按 11-15 测试报告修 3D 自习室三处:lint 16 个 error 清到 0,渲染期写 ref 挪进 effect,three.js 场景关掉 react-hooks/refs 与 immutability;WebGL 上下文丢失后不再白屏,给出刷新提示和刷新按钮;从 2D 返回后再点楼梯、笔记本、台历不再被上次没走完的缩放状态吞掉,800 毫秒内没完成就直接进对应页面。提交 cf9615e 已推 dev,推前先接上远端的新提交,钩子通过 | 未单独计时 | 6 条 warning 按报告登记缓办,没算进这次必须清掉的缺陷;场景仍读种子数据,真实待办和到期复习没接上 | 这三处不再改交互。回归通过就不在热区上加新入口;读真实任务与复习留到 D5,和王婉怡一起做 |
| 林彩华 | 11-17 跑了每日回归包(lint、类型检查、构建)与检索功能边界用例,产出《测试问题报告 2026-11-17》,共 3 条:GET /api/notes 500、重新生成时 stage_checks 落库崩溃、AI 计划导入超时 | 未记小时 | 3 条都还没修;问题 1 要重跑 _setup/migrate.sql 才能恢复 | 问题 2、3 修完后按「重新生成」与「导入计划」两条路径复测 |
二、今日签入
| 提交 | 说明 | 改动 |
|---|---|---|
20b112a | feat(readers): 网页正文清洗并升级到 0.4.0 | 3 文件,+57 / −9 |
5048c36 | feat(web): 检索链路重写,博查与智谱双引擎并行 | 5 文件,+834 / −136 |
c250546 | chore(web): 检索引擎环境变量改为智谱 | 1 文件,+4 / −1 |
cce7481 | fix(web): stage_checks 结果约束支持 pending | 3 文件,+17 / −1 |
ce95285 | fix(web): analyze 落库前按 URL 去重材料 | 1 文件,+5 |
cf9615e | fix(web): 补上 3D 自习室的 lint 门禁、画布丢失提示和返回后热区(周蔚琳) | 文件数待补 |
主提交链接:
5048c36:https://devcloud.cn-north-4.huaweicloud.com/codehub/project/08ad145e89cd43d89513e75bf09dd94e/codehub/3098723/5048c360da5000c682ba3e60f976ca78a0977c2e/commitdetail?ref=dev20b112a:https://devcloud.cn-north-4.huaweicloud.com/codehub/project/08ad145e89cd43d89513e75bf09dd94e/codehub/3098723/20b112a760ae5b86b45cd769fe804e8a5980aaeb/commitdetail?ref=dev
引擎为什么换。 Tavily 不是配置错,是本机网络握手不过:DNS 与 443 都通,TLS 握手被 RST,Python、Node、PowerShell 三种客户端结果一致(fetch failed、WinError 10054)。同环境下博查正常,所以判定是 Tavily 侧不可用,不是本地防火墙。换成智谱 Web Search(POST /api/paas/v4/web_search,search_intent=false、content_size=high),按次计费 search_std 0.01 元/次。先只接智谱是可行的,但博查单查询有 10 条硬上限(count 传 15/20 也只回 10),单引擎候选池不够,所以两边并行、各取 10 条再按 URL 合并。
为什么不再退化成「仅检索词」。 旧逻辑是「读不出达标正文 → 整条退成检索意图」,用户点到的是提示,不是资源。现在只要检索到真实链接,哪怕全部探测为死链、或读不出正文,也返回真实链接并标 bodyReady=false,卡片能跳。只有「一条候选都没有 / 完全没配 key」才退回检索意图。
文库站为什么单列配额。 圆锥曲线这类查询,博查前排被 book118、豆丁、道客、淘豆占满,这些页面多为付费预览,能读出完整正文的比例很低。所以文库站每站最多 1 条、不占方向破格名额,检索深度提到 10 条,读入补位时优先挑已证明能读出正文的站点。
容量为什么一起调。 单改条数没用:draft.ts 原来用 resources[i % len] 给每步挂材料,每步只有 1 条,抓到 12 条前端也只看到 5–6 条。改成轮转铺满、每步最多 3 条,同时把 maxTotal 8→12、readyTarget 4→6、读入并行 3→4、总预算 15s→24s。
周蔚琳的 3D 修复。 三处问题都源自 Day1 回归:lint 把 three.js 逐帧改相机判成违规,场景文件再改就交不进去;WebGL 丢失后画布只剩白;从 2D 返回后热区点击被 zoomView 残留状态吃掉。修法是 ref 写入挪进 effect、场景目录按规则豁免并写明理由、丢失时给提示与刷新按钮、被守卫拦住时先清状态再重开推进、800 毫秒没跳转就强制跳。她的心得是「热区失灵不是镜头没播完,是页面不说话」——兜底要能自己跳转,不能等用户刷新。
今日修掉的五个问题
| 问题 | 根因 | 处理 | 结果 |
|---|---|---|---|
| 卡片标「仅检索词」,按钮「去检索」,点了只弹提示,进不了真实资源 | 读不出达标正文就整条退化成 search_only,检索到的链接被丢掉 | 有真实链接就返回链接并标 bodyReady=false,只有零候选才退回检索意图 | 12/12 条带真实 URL,无 search_only 卡片 |
| 一次 analyze 只出 5–6 条材料 | draft.ts 每步只挂 1 条(主因);maxTotal 偏小;两个引擎实际只有一个在跑 | 每步轮转最多 3 条 + 容量 12/6/4/24s + 双引擎并行 | 5–6 条变 12 条,候选池 59 → 109 |
| analyze 必 500,整条事务回滚 | stage_checks.result='pending' 与库约束 stage_checks_result_check 冲突 | 约束加入 pending,幂等迁移 0006_stage_checks_pending.sql,_journal.json 登记 idx 3 | analyze 200,resources 的 query 落库 12/12 |
| Tavily 全部失败 | 443 能建连,TLS 握手被对端 RST | 代码、类型、.env.example、自检项全部删掉,接入智谱并行 | 单查询 bocha=10 / zhipu=10 |
| 同一条材料挂在多个步骤,前端重复展示 | 模型把同一批材料同时挂多步 | analyze.ts 写入前按 URL(无 URL 用标题)去重 | 同一任务不再出现重复 URL |

三、测试回归
测试人林彩华。环境:本地 npm run dev(http://localhost:3000)、Chrome、普通用户登录态。执行内容:每日回归包(lint、类型检查、构建)与检索功能边界用例。三条问题都还没修,处理排在 11-18。
问题总览
| 编号 | 现象 | 冲刺归属 | 根因 | 影响 | 修复方向 |
|---|---|---|---|---|---|
| 1 | 拉取代码后 GET /api/notes 返回 500「服务暂时不可用」 | Alpha 交付物 + Beta 环境同步 | 本地库没执行过含 notes 表的完整 _setup/migrate.sql,查询打到不存在的表 | 笔记列表全量不可用;暴露部署流程缺「数据库迁移」这一步 | 重跑 migrate.sql(建表脚本幂等);把「拉代码后同步迁移」写进部署清单 |
| 2 | 任务详情点「↺ 重新生成」无反馈,约 15 秒后 stage_checks 落库崩溃 | 七步分析落库链路(柳钰舒线) | 插入层级测试项时 subtask_id 传空字符串,uuid 列报 invalid input syntax for type uuid,事务回滚 | 重新生成 100% 失败,本次成果全丢;按钮没有 loading | 空值传 null 而不是空串;按钮加 loading 与可感知的失败提示 |
| 3 | AI 计划导入后甘特图与台阶都为空,任务列表只剩空壳计划 | AI 计划导入链路 | analyzeTask 沿用前端默认 15 秒超时,七步分析远超 15 秒被中断;createTask 已落库无法回滚 | 用户以为导入成功、数据实际丢失;库里残留 2 条孤儿计划 | analyzeTask 超时放到 180 秒;失败时清理空壳计划;导入期间给等待态 |
问题 1:本地库缺表,新接口集体 500
拉最新代码后直接拿旧库起 dev,进「分析笔记」页面触发 GET /api/notes,Failed query: select ... from "notes",服务端兜底成 500,前端抛 ApiError 并连续失败两次。
仓库侧是完整的:_setup/migrate.sql 第 65–75 行有 notes 建表,第 273、288 行有外键与索引。问题在本机库按早期脚本初始化、拉代码后没重跑迁移。定性是环境同步缺失,不是业务代码缺陷;但正好说明部署时「数据库迁移」不能省。处理:重跑迁移脚本、重启 dev,确认接口回 200;并把这条写进部署清单(郑聪凌那条线)。
问题 2:subtask_id 空串把整条落库打回
复现:配好检索引擎变量后重启 dev → 任务详情点「↺ 重新生成」→ 看页面反馈与 [retrieval] 日志。
检索这一段是正常的:engine=zhipu、candidates=60、hostLimited=1、deadRetried=6、refilled=3、degraded=false。崩在检索下游的落库:六条 stage_checks 插入语句的第 4 个参数 subtask_id 都是空字符串,列是 uuid,Postgres 直接拒绝,analyzeTask 整个事务回滚,排期、材料、核对项一起丢。
这条和我 11-16 修的 pending 约束是两处不同的原因:那次是库约束不认 pending 这个状态值;这次是「层级测试项不挂具体子任务」被写成空串而不是 NULL。同一张表、不同字段,不能合成一条记。修复时还要顺手核对 quote_anchor、answer 这些走 default 的列有没有同样的空值写法。
问题 3:15 秒超时把分析成果挡在门外
导入链路先 createTask 落库,再调 analyzeTask 跑七步分析。前端 request 骨架默认 15 秒就 AbortController 中断并抛 408,而实测这套分析远超 15 秒——草案生成那条链路显式传了 90 秒,所以同一个引擎在草案侧没暴露。中断后任务已落库、成果没写入:甘特图「本周还没有排期」、任务详情 0 级台阶 0 材料,库里残留两条 total_days=0、subtasks=0 的孤儿计划,重复导入还会继续产生新的。
修法按报告的三层走:超时放到 180 秒、失败时清理空壳计划(调 DELETE /api/tasks/[id])、导入期间给「导入中…」等待态。超时参数在 lib/api/tasks.ts,这两处要和前端一起改。存量那两条孤儿计划手工删掉。
四、任务状态
| 任务 | 状态 |
|---|---|
| 检索词规范化 | 完成 |
| 相似词合并 + 泛用词守卫 | 完成 |
| 同 host 去重 | 完成 |
| 文库站每站 1 条 | 完成 |
| 死链重试 + 补位 | 完成 |
| 读入补位 | 完成 |
| 正文清洗 0.4.0 | 完成 |
| 质量分级 + 段落截断 | 完成 |
| 三级降级 + 统计外露 | 完成 |
| 每步最多 3 条材料 | 完成 |
| analyze 500(过程中新增) | 完成 |
| 材料去重(过程中新增) | 完成 |
燃尽图

五、运行情况
本地 web/ 跑 npm run dev(3000),readers/ 跑 uvicorn(8765)。每次 analyze 在服务端打一行:
[retrieval] engine=bocha+zhipu queries=6->6 candidates=109 refilled=0 readReady=7/8 resources=12 degraded=false
两条正常路径的实测:
- 六级听力 转折信号词 笔记符号:12 条,
oh100/koolearn/51jzrc/huatu/sohu/eudic均读出 900–3800 字正文,13.4s。 - 学习高中数学圆锥曲线:12 条,椭圆 7 / 双曲线 3 / 抛物线 1,科普中国(双曲线渐近线)、dtime(抛物线公式)、百度知道(椭圆推导)都读出正文,53.4s。
正文清洗单独复核(真实页面):
CSDN 椭圆文 832 字 / 5 段
doc.rust-lang.org 2926 字 / 10 段,首尾结构正常
六、站会
截图如下。
相关推荐
好用免费猴PDM查阅器v1.7
# 好用免费猴PDM查阅器 一个用 Python 写的 **PowerDesigner `.pdm` 模型阅读器**:不用装 PowerDesigner,双击就能把 `.pdm` 里的表、字段、主键、索引、外键、注释全部摊开看,任意内容可直接复制,并一键导出 Excel / HTML / Markdown / 建表 DDL。 - **v1.7**:彻底修掉「再点表就覆盖已打开的 sheet」——已打开的表单独记成一份标签列表,和左侧「选中」不再共用状态,**筛选框找表后再点,永远是新开一个标签、绝不动已有的**;已打开的表在清单里显示为**绿色**,再点它是「切回那个标签」,`Ctrl`+单击才关掉 - **v1.6**:左侧清单**点一下就打开**(不用再按 Ctrl / Shift);启动默认进「标签页切换」;标签页开着 5 张以上时切「并排分屏」会自动弹窗让你挑要保留的 4 张 - **v1.5**:两种多表视图 ——「并排分屏」(≤4 栏,窄栏也显示全部列,Shift+滚轮 / 中键拖动可横向滚动)+「标签页切换」(像 Excel sheet 一样一个表一个标签,最多 12 个,看另一张表时其余自动隐藏);exe 图标改用 Windows 原生多尺寸设置,标题栏/任务栏不再被拉伸糊掉 - **v1.4**:多表分屏 —— 左侧按住 Ctrl / Shift 多选表,右侧每张表开一个独立面板并排展示(最多 4 个,各栏自动等宽),超了会弹窗让你自己挑;exe 换成新的像素猴子图标 - **v1.3**:打开过的文件会被记住,下次启动自动载入同一批模型并回到上次查看的表,不用每次重新选 - **v1.2**:新增程序内复制(任意表格框选 → Ctrl+C / 右键复制,支持 Tab 分隔与 Markdown) - 单文件实现,`pdm_viewer.py` 一个文件
用于计算系统状态的卡尔曼最优增益和最小均方误差(MMSE)估计研究(Matlab代码实现)
内容概要:本文围绕“用于计算系统状态的卡尔曼最优增益和最小均方误差(MMSE)估计研究”展开,系统阐述了卡尔曼滤波在动态系统状态估计中的核心作用,重点探讨了最优增益的递推计算方法与基于最小均方误差准则的状态更新机制。研究内容涵盖线性系统状态估计的完整流程,包括状态预测、协方差传播、创新计算、卡尔曼增益求解及状态校正等关键步骤,并通过Matlab代码实现了算法的仿真验证,展示了其在噪声环境下对系统状态进行高精度跟踪的有效性。文中不仅强调理论推导,还注重工程实现细节,帮助读者深入理解卡尔曼滤波的数学本质与自适应特性。; 适合人群:具备线性代数、概率统计及控制理论基础知识,熟悉Matlab编程语言,从事自动化、电子信息、通信工程、导航制导、信号处理、物联网或智能系统研发等相关领域的研究生、科研人员及工程技术人员。; 使用场景及目标:①应用于传感器数据融合、目标跟踪、惯性导航(如GNSS/INS组合导航)、工业过程监控等存在噪声干扰的状态估计任务;②帮助读者掌握卡尔曼滤波从数学建模到代码实现的全过程,深入理解MMSE估计原理及其在提升系统鲁棒性与精度方面的关键作用;③为后续学习非线性滤波算法(如扩展卡尔曼EKF、无迹卡尔曼UKF)以及更复杂的多传感器融合架构奠定坚实的理论与实践基础。; 阅读建议:建议读者结合提供的Matlab代码逐行调试运行,重点关注预测与更新过程中各矩阵的维度变化与数值演化,尝试调整过程噪声与观测噪声的协方差参数,观察其对滤波收敛速度、估计精度及卡尔曼增益自适应调节的影响,从而深刻领会滤波器的设计思想与调参技巧。
适合政府进行产业链技术缺口识别的分析工具有哪些?.docx
科易网基于行业知识库+行业大数据+科技资源要素+AI模型,以AI,赋能技术转移、成果转化、技术经理人培训、知识产权管理、区域产业分析与布局、地方科技招商、创新创业大赛等场景,推出科技创新领域的AI工具、场景化服务和数智化解决方案,推动科技创新与产业创新智能化发展。
Hybrid Mount
杂交挂载元模块 Hybrid Mount Metamodule
【储能选址定容】基于多目标粒子群算法的配电网储能选址定容(Matlab代码实现)
内容概要:本文系统阐述了基于多目标粒子群算法(MOPSO)的配电网储能选址定容优化方法,旨在科学解决储能系统在配电网络中的最佳安装位置与容量配置问题。研究构建了一个综合考虑网损最小化、电压偏差改善和投资成本节约的多目标优化模型,并采用改进的多目标粒子群算法进行高效求解,获得一组代表不同权衡关系的Pareto最优解集,进而结合模糊决策等多属性决策方法从中遴选出最理想的折衷方案。文中详细剖析了算法的核心原理、数学建削过程及求解策略,并提供了完整的Matlab代码实现,通过在标准IEEE测试系统上的仿真实验,充分验证了该方法在提升配电网运行经济性、改善电能质量及增强系统综合效益方面的有效性与优越性。; 适合人群:具备电力系统分析、优化算法基础知识的研究生、科研人员及从事电网规划、储能系统设计与运行的工程技术人员。; 使用场景及目标:①研究配电网中储能系统的科学规划与优化配置方法;②深入学习多目标优化算法在电力系统规划领域的实际应用与实现技巧;③掌握基于Matlab平台的电力系统仿真建模与优化编程能力,为相关课题研究提供技术支持。; 阅读建议:在阅读时应重点关注多目标优化模型的构建逻辑、粒子群算法的改进机制及其在电力系统约束处理上的实现细节,建议结合提供的Matlab代码进行逐行调试与复现,通过调整系统参数、约束条件和权重系数等方式,深入探究算法的性能表现和优化结果的变化规律,以达到融会贯通的学习效果。


