|
|
@@ -0,0 +1,32 @@
|
|
|
+# 2026-10-19
|
|
|
+
|
|
|
+## 测报灯工作逻辑说明(DOCX 交付)
|
|
|
+
|
|
|
+- 任务:阅读固件代码,输出《测报灯工作逻辑说明》docx,覆盖工作控制流程、光控/时控/雨控、高低温与电压保护、推杆电机超时、振动、补光与拍照时序。
|
|
|
+- 交付:`output/49b29c0a-ed4d-48ee-9533-bd67f4901523/stage3/测报灯工作逻辑说明.docx`(64 KB,A4,2 节:封面 + 正文,19 张表,页脚页码)。
|
|
|
+ 中间产物:`stage1/final_draft.md`、`stage2/formatted-测报灯工作逻辑说明.html`、`stage2/design_tokens.json`、`pipeline-state.yaml`。
|
|
|
+- 代码依据(`control.c` / `sht30_collect.c` / `hmi.c` / `main.c`)关键值:
|
|
|
+ - 光控:ADC>500 或 lux>500 判白天,1000×100ms≈100s 消抖;夜晚且 `light_over_tim>0` 才工作;天亮持续 1h 重装 `sunBar*3600`。
|
|
|
+ - 雨控:ADC>250 连续 10 次(≈1s)触发;无雨 36000 次(100ms)= 60min 解除。
|
|
|
+ - 温度:`tph` 默认 70(50~80)、`tpl` 默认 5(-50~50);解除区间 `tpl+5 ~ tph-10`(默认 10~60℃)。
|
|
|
+ - 电压:<22.0V 欠压(计数 100×10ms,注释写 10s、实际约 1s)、>24.0V 解除;<12V 关外设;<5V 持续 10s 判掉电。
|
|
|
+ - 推杆:上/下仓门 20s(200×100ms)、排虫推杆 20s/段、清扫 50s/向(全程 105s)、转仓 30s(600×50ms)。
|
|
|
+ - 振动:ON 100ms + OFF 1000ms × `shake_sec`(默认 1);补光 60s 名义(实际约 66s,含 5s+1s 阻塞);相机在 15s 触发。
|
|
|
+- 文档中已标注 7 条"注释与实现不一致"(欠压确认时间、雨控解除时长、光控计数非严格连续、拍照实际 66s、状态位注释方向、无过压保护、时控仍受天亮影响)。
|
|
|
+
|
|
|
+## 售后运维版(同一内容的通俗改写)
|
|
|
+
|
|
|
+- 用户反馈:技术版太专业,面向售后运维要通俗简洁。据此重做:《测报灯工作逻辑说明-售后运维版》
|
|
|
+ `output/2619b508-f70f-44a4-b4c5-a4c1e7c5693e/stage3/测报灯工作逻辑说明-售后运维版.docx`(51 KB,8 章 + 9 表,约 6 页)。
|
|
|
+- 改写策略(可复用):去掉全部函数名/寄存器/代码标识符;改问句式标题("什么情况会自动停机");
|
|
|
+ 每章一段白话引入;保留数字但用口语描述("连续 1 小时"而非 30000 次计数);
|
|
|
+ 新增《常见问题怎么排查》《日常维护》两章(现象→原因→处理三段式),这是运维最需要的部分。
|
|
|
+- 技术版保留在同级目录 `49b29c0a-.../stage3/`,未覆盖。
|
|
|
+
|
|
|
+## 本机 docx 生成环境(重要)
|
|
|
+
|
|
|
+- `tencent-docx` 的 `scripts/wb/local/setup-html-to-docx.sh` 在 Windows 上会失败(脚本按 Unix 布局找 `$VENV/bin/python`,且 `rm -rf` 被 safe-delete 拦),退出码 2。
|
|
|
+- 可用替代:用 `D:/ProgramData/anaconda3/python.exe`(3.12.4)建 venv 到
|
|
|
+ `C:/Users/Administrator/.workbuddy/binaries/python/envs/html2docx`,再 `pip install --only-binary=:all: -r <plugin>/skills/html-to-docx/scripts/requirements.txt`(Pillow<11 需 Py3.12,故不能用托管 3.13)。
|
|
|
+- 转换命令:`cd <plugin>/skills/html-to-docx/scripts && <venv>/Scripts/python.exe -m html_to_docx convert in.html -o out.docx --margin-top 2.5 --margin-bottom 2.0 --margin-left 2.5 --margin-right 2.5`
|
|
|
+- html-review 脚本可直接用托管 3.13 跑;本次首轮 72 分(裸字号/裸间距 + h2 后直跟 h3),修完 100 分。
|