wandering1
cc7f17f231
fix(dwt): stop resetting CYCCNT, a counter six modules share
...
Three of the six DWT CYCCNT users wrote the counter to zero on init:
console_log, net_latency_test and ch395f_reuse_bench. Every one of them
only ever takes the difference (CYCCNT - t0) against a local snapshot, so
the reset bought nothing and instead caused a bogus ~2^32 delta for
anyone who sampled across it. That delta trips the task_prof glitch guard
(TASK_PROF_GLITCH_CYC = 10 s worth of cycles), which discards the sample,
so a whole worst-case measurement could vanish silently.
All three call sites now leave the counter alone; the shared contract is
"enable only, never reset", documented at each of the six users. The
documented behaviour in the link latency test guide (section 4.3) is
updated to match.
Net source change is three deleted lines, no new executable code.
Verification:
- grep for a zero assignment to CYCCNT across the tree: no hits left.
- Keil build: Code=257932 RO-data=32108 RW-data=2104 ZI-data=152688,
0 errors 0 warnings.
- Host unit tests: console_log 153/153, task_prof 27/27, ioboard 100/100,
sb_link 164/164.
- Four console_log assertions pinned the absolute number of DWT register
touches; dropping the reset write lowers it by one, so their expected
counts move from 3 to 2 (and 4 to 3 for TC-CONLOG-093). The test text
now says why the third write disappeared.
- check_doc_links: 6 known issues, unchanged from baseline.
2026-11-16 19:58:44 +08:00
wandering1
e4981aa2f6
refactor(docs): point entry-file references at their new homes
...
AGENTS.md stopped being the store of record for build steps, Python env,
hardware pins, doc conventions, log cost and task ownership. Those facts
already live in docs, skills and role files; the entry file now only
points at them. This commit moves every reference that used to name the
entry file to the authoritative landing point, so a reader who follows a
link arrives at the fact instead of at a sentence that no longer exists.
What changed is links and prose, not behaviour. Code, scripts and tests
only have comment and docstring lines touched; the only non-comment edit
in the whole changeset is one note string inside the generated pin table
JSON, and its generator was changed in the same step so the two stay
byte-identical.
New landing points created before the references were retargeted:
- The console single-writer log design doc, section 7.1, is now the single
authority for log cost: about 90 B flash and 216 B stack per DBG_ line,
and the rule that deep call chains must predefine DBG_LINE_BUF_MAX.
It also carries the full list of the twelve translation units that have
tightened it, plus the grep command that decides the truth if the list
and the code ever disagree.
- The document writing standard, section 2, now holds the BOM list.
- keil-build skill gains an exit code table: 0 success, 1 build failure,
2 BuildEnvError, 3 usage, 4 build lock held. This corrects a belief
that was never actually written down anywhere: exit 2 does not simply
mean environment error, argparse also exits 2 and the wrapper script
was remapped so the two no longer collide.
Regenerated and checked byte for byte:
- The end-to-end architecture SVG in docs/images from its generator.
- tools/netlist_semantics/pinout_kb.json from gen_kb.py.
Both are idempotent; running the generators again produces no diff.
Deliberately not touched, because machines read them:
- scripts/check_bom_drift.py joins every line containing BOM and asserts
four paths are present, so the entry file BOM line must stay one line.
- scripts/gen_task_table.py reads the TASK_TABLE anchors directly.
- scripts/rename_maps and scripts/archive keep their historical wording;
they describe what happened, not what is true now.
Verified: doc links report the same six pre-existing findings as the base
commit and no new ones, generated-fresh passes, bom drift is clean across
101 files, and AGENTS.md itself is unchanged in this commit.
2026-11-16 19:38:27 +08:00
wandering1
ab20302999
refactor(agents): split entry file from role knowledge, add orchestration role
...
The entry file had grown to 194 lines, of which a large part duplicated
knowledge that already lived in skills, docs or role files. Worse, three
pieces of project knowledge existed only there, and ten roles were all
module implementers or reviewers: no role carried the Lead side
collaboration protocol, so "Lead only orchestrates, never implements" and
"the reviewer must not be the implementer" had no home anywhere.
AGENTS.md 194 lines / 13908 B -> 121 lines / 12283 B, 13 sections -> 9.
- Dropped four sections whole, each with an existing landing point:
build and verify (keil-build / serial-boot-test skills), Python env
(new-machine-setup skill), hardware pins (hardware spec doc section 2),
docs and diagrams (writing standard plus draw-diagram skill).
- Compressed project overview, iron rules, pre-commit, platform
constraints and module conventions into pointers plus the few facts that
must be seen every turn.
- The directory map changes from "directory | responsibility | can I
modify it" to "directory | can I modify it" and hands the detail to the
architecture overview section 7. The value of this table on the entry
file is the permission semantics, not a second copy of the tree.
- Delegation policy is the one section that grows in substance: four
always-present rules, reviewer is not implementer, rework needs fresh
evidence, the gate flow, three measured limits of the ledger plugin and
member revive/rebind.
Three machine anchors are untouched: the TASK_TABLE comment pair and its
body, the BOM list line (one line, four paths, the bom-drift checker
concatenates every line containing BOM), and the hook count sentence.
Line endings stay CRLF.
New roles:
- .dsh/roles/lead-orchestrator.md: the Lead collaboration protocol in two
parts, generic methodology and this project's specifics. Twelve
anti-patterns with the case behind each, an eleven-role split table
(what it owns, what it must not touch, when to call it), and ten
documented gaps between what the entry file claimed and what
dsh-plugin-team-ledger v0.2.0 actually does.
- .dsh/roles/bench-runner.md: bench execution and evidence collection, an
execution layer and explicitly not a decision layer. It has no write
tools and no gate submit/accept, because the person who reads the log
must not also judge the run.
Existing roles:
- mcu-specialist gains the kernel-before-start rule, including the legal
counterexample vTaskDelete(testTaskHandle) in Src/freertos.c. The
criterion is not "create or delete" but whether the call waits for the
scheduler or for time.
- algo-specialist gains the RS-485 wiring gate with the two contract
defects it stands on: a weak rx hook with a single 256 byte buffer, and
a direction switch back to RX that does not wait for TC.
- storage-specialist's owner statement is rewritten rather than appended:
defaultTask owns the config engine because its static state is unlocked,
and reading still advances the poll baseline and the debounce counters.
- README: eleven roles, order unified across the overview table, the
detailed sections and the selection guide.
Verified: gen_task_table --check, bom drift, mojibake, generated fresh and
doc links all clean, and doc links report the same six pre-existing
findings as before this change. Role files are CRLF free, no BOM.
2026-11-16 19:37:15 +08:00
wandering1
10323c4c22
feat(ioboard): board test suite for DI/DO, fix default_task conditional compile
...
Bench verification of the IO board needs an observation window: production
build has no consumer of ioboard_di_snap_read(), so the DI values were
invisible. Add TEST_SUITE_IOBOARD as a semi-automatic bench sequence and fix
two real bugs found while wiring it in.
New files:
- test/board/ioboard_test.h, test/board/ioboard_test_task.c
Test suite:
- Owns its own thread (iobTest, 4096 words) instead of running in testTask:
testTask is osPriorityBelowNormal, below defaultTask whose 1ms console
drain loop can starve a blocking wait in a lower priority context.
- Phases: bit-order self-check, DI eight-point bijection, DO point-by-point
toggle with operator confirmation, release-all on every exit path.
- Only exit is ioboard_release_all(); it is called from the entry guard,
every phase failure, the write-failure branch and the thread tail.
- Sample window is 20 reads x 2ms = 40ms and does overlap the 50ms
production poll. That is stated as harmless in the header: the driver
wraps the whole read in taskENTER_CRITICAL (26us, not the whole 40ms),
both sides only read, and a torn cross-reader sample is caught by the
debounce layer rather than acted upon.
default_task.c fix:
- DEFAULT_TASK_DI_PUBLISH_EN was defined twice: once at file scope and once
inside default_task_func(). #define has no scope, so the second was a
redefinition of the first. Collapsed to a single authoritative site.
- Add TEST_SUITE_STORAGE to the disable list: the STORAGE suite owns the
file system via testTask, and default_task_di_poll() referenced four
statics that live inside an !TEST_SUITE_STORAGE block, which broke the
STORAGE build with 11 errors.
- Shrink the !TEST_SUITE_STORAGE block to cover only
default_task_net_cfg_save_notify() and move the three declarations out;
move edges/fails into the #else branch so the empty branch references
none of the four statics.
Registration and gates:
- MDK-ARM/STM32F407-Demo.uvprojx and simulator/CMakeLists.txt entries.
- scripts/check_test_suite.py: whitelist TEST_SUITE_IOBOARD.
- scripts/stack_report.py: let a self-started thread that is not declared in
Src/freertos.c osThreadAttr_t still be budget checked.
- test/run_all_suites.py: bring the suite into the orchestrator view.
Verified: six-build matrix all 0 errors 0 warnings. CH395F/STORAGE/GD5F/RTC
and the product build are bit-identical at Code=257936; the IOBOARD build is
Code=264640 (+6704), which is the evidence that the suite really enters the
image. Host unit tests 100/100, stack report 1760/4096 words (57%).
2026-11-16 19:35:15 +08:00
wandering1
fd767d1dcd
feat(ioboard): 开入开出板驱动、去抖快照与主机侧单测接入
...
74HC165 开入 + 光耦继电器开出的完整硬件抽象层,接进 defaultTask
的 50ms 节拍。开入 8 路(第二块 165 数据线板上未接,故只有 8 位),
开出 4 路(高电平吸合)。
驱动 BSP drivers:
- IOBOARD/ioboard.c 装载与移位时序,每步注明数据手册依据;
SH/LD 拉高前先拉低 CLK,否则装载瞬间多移一位;
单次读取上界 26us(延时按最慢列 VCC 2V 全温区取值)。
- IOBOARD/ioboard_bits.c 位序组装纯函数,只依赖 stdint.h,
主机侧可直接 include 做单测:读 8 次为 H,G,F,E,D,C,B,A,
A 放 bit0(bit(7-i) = reads[i])。
- 极性集中在 IOBOARD_DO_LEVEL_ACTIVE 一处,接口语义统一为
mask 的 1 = 吸合。
业务接线:
- App/util/ioboard_di.c 通道去抖与双区快照,纯逻辑;
刻意不 include ioboard.h(其引脚宏会牵入 main.h),
两处路数常量由测试的编译期静态断言钉住。
- default_task.c 的 default_task_di_poll():读失败不喂去抖、
不写发布值,只把上一有效值加 valid=0 发布出去,
避免"全 0"被现场读成开入全部复归。
- 去抖实际粒度 50ms(每个轮询周期喂一拍),最坏上报约 100ms;
想要真 20ms 需另建定时器,本次不做。
- Src/main.c 在 app_main_init 之前调 ioboard_init(),
上电即把 4 路出口钉在全释放并确认 165 静止态。
测试:
- test/host/ioboard/ 100 条断言。位序主判据为单比特两端
(只有 A 得 0x01、只有 H 得 0x80)加八点双射穷举;
混合图样降级为辅助,因该图样曾先后被算成 0xA5、0x5A、0xAA。
- 去抖覆盖 20ms 边界、抖动不翻、跨 49.7 天回绕。
- 失败语义覆盖"失败保留上次有效值"与"失败窗口内的真实变位不丢"。
文档:
- 新增 docs/硬件平台/开入开出实施说明.md。
- 硬件规格与能力边界 §5 的能力边界现状改写:出口继电器与
开入回路已具备、业务层未接入;4 路开出只可台架验证,
不得用于真实跳闸。
- 修正 docs/文档规范.md §3.1:原文要求所有互链用仓库根相对,
与 check_doc_links.py 的实际解析基准矛盾(markdown 链接按
当前文档目录解析,反引号路径才按仓库根)。改为区分两类,
并补 §3.1b 写明对应校验器。
- 清理 docs/任务规划/登记簿.md 改名为硬件改版登记.md 后
遗留的 9 处旧名引用。
门禁: keil-build 0 Error 0 Warning;主机侧单测 ioboard 100/100、
sb_proto 45/45;pre-commit 48 根钩子全通过。
2026-11-16 18:30:31 +08:00
wandering1
d9f8dbfd90
fix(roles): 角色工具白名单改宿主注册名,ui-specialist 内联技能手册
...
8 个角色文件:
- 白名单里的 read/grep/glob 是幻影名(宿主未注册过),改为
ops_grep / ops_glob / ops_inspect_local_file,删除 read
- 公共工具组补 team_gate_* 六项(门禁账本插件已接入,成员
应能认领与提交门禁)
roles/README:
- tools 字段说明重写:两层名册对照表(全局层可限制 / 作用域层
不可限制)、三桶语义(可限制 / scopeLocal / unresolved)、
diag 三行原文;容错口径改为「多写名字不会让策略整批失效」
- 新增「一个必须知道的能力边界」:ops_discover_tools 能激活
写侧作用域工具,白名单不是安全边界
- 新增「关于模型」:角色 frontmatter 的 provider/model 只有
subagent_role 路径读,team 注入路径不带模型路由,成员一律
跑宿主默认模型,换模型走 team_member_revive
ui-specialist:
- 第三部分内联 ui-verify / lvgl-simulator / board-ui-nav /
font-regen 四个技能全文,成员无需 skill() 路由即得完整
规程(persona 28855B,上限 65536B);权威源仍是
.dsh/skills/,段首写明同步纪律
实测:插件真实 parseRoleDocument 通过;白名单计数
43/43/43/43/43/43/41/41;maxToolCalls 3000 不变。
2026-11-16 16:43:50 +08:00
wandering1
1b740e07b3
fix(dsh): 角色工具白名单先分区再 restrict,实现文档迁入插件目录
...
缺陷:dsh-ops 把 ops_* 注册在 agent 自己的作用域层
(inheritable:false),全局层名册里没有这些名字。角色白名单
一旦命中 ops_*,首次 restrict 就抛错,整份策略应用失败,成员
工具面完全不设防——四个专精角色此前实际没拿到过白名单。
修复:白名单改走「先分区、再 restrict」两步——作用域层名字由
分区器摘除交策略层,全局层一次性交 restrict。三条路径(初始
注入 / 降级重试 / rebind 重放)共用同一个分区器,行为逐字一致。
两条刻意设计:
- 白名单全被分区掉时 allow 集合为空,必须显式发 {"allow":[]}
(fail closed;省略即不限制,会静默放开全部工具)
- 未向任何提供方注册的名字报 not visible yet and not
restrictable,不得误报成「未注册」——注册时机问题不能把
将来能用的名字从白名单里丢掉
真机验收(宿主重启后取证):目标角色 doc-writer 走
applied in one pass (allow=35),白名单 43 项 = 4 作用域层 +
4 不可解析 + 35 进限制,与 diag 逐行自洽;成员工具面
qq_*/workbuddy_*/ImageGen 全部不可见;persona 逐字注入。
能力边界报备(未修,文档已写明):ops_discover_tools 可激活
写侧作用域工具绕过白名单——白名单是初始可见面裁剪,不是安全
边界;要封锁写权限须连它一起排除。
文档:实现说明从 docs/环境与部署 迁入插件自带 docs/(内容全部
是本插件内部实现,按知识各归其位原则);AGENTS.md 与 docs
索引同步改指向,全仓 doc-links 与 mermaid 门禁绿。
2026-11-16 16:42:59 +08:00
wandering1
9e538d2809
feat(dsh): 门禁账本插件接入 + 角色绑定跨重启还原
...
CI / 静态门禁 (pre-commit) (push) Failing after 43s
CI / 主机侧单测 (MSVC) (push) Failing after 24s
二、门禁与唤醒(新插件 dsh-plugin-team-ledger 0.2.0)
宿主 Agent Teams 缺两块能力,补在独立仓
D:/Code/AI/dsh-plugin-team-ledger:
- 状态存放:<工作区>/.dsh/team/gate.jsonl 追加账本,记验收
清单、实测证据、认领历史,跨重启存活;canonical JSON +
fsync,坏尾行截断恢复。
- 唤醒模型:门禁推进后按事件计划唤醒下一责任人,借活体
Lead 作 caller 走宿主 sendMessage;无定时器;30 分钟滑动
窗口限 4 次防复活风暴。
- 验收独立性由机器强制:执行人/历史认领者不能 accept,
checklist 逐项 passed=true 缺一不可。
- team_member_revive(Lead 专用):成员模型路由死亡后的
复活通道——可换 provider/model,再经 subagents.sendMessage
冷恢复唤醒,绕过宿主 roster 的 phase=active 门禁。
二、角色绑定跨重启还原(roles fork 0.5.2)
persona 与工具白名单只有运行中 agent 的内存态,宿主重启后
冷恢复的成员既无 persona 也无白名单——实测出现 doc-writer
成员带全量工具面(qq_*/ImageGen),属静默权限放大。改为
注入成功时持久化 childId -> {roleId, cwd} 到
~/.dsh/role-inject-bindings.json,并在 agent/created 时重放。
追加 team_member_rebind 补绑定,覆盖 0.5.2 之前已存在的成员。
三、配套
- .dsh/roles 八个角色白名单加入门禁工具;AGENTS.md 委派策略
补门禁/复活/重绑三套操作口径。
- docs/环境与部署/子Agent角色自动注入实现说明.md 新增
§5.1,记录绑定机制、存量成员缺口与「成员自省不可全信」的
台架教训。
2026-11-16 00:42:51 +08:00
wandering1
384ad5a80d
docs(ui): 页面补齐规划改为现状文档,按当前菜单树校准
...
docs/UI设计/页面补齐规划.md 280 行 -> 157 行,标题改为「UI 页面补齐现状」。
原文档是 2026-10-23 的立项规划(27 个空叶子、四批铺设、三套前置能力、
六个待拍板问题),这些都已落地,只剩三叶无数据源。改为逐页现状描述:
现状规模(实测核对 ui_menu_tree.txt 与 ui_page_registry.h):43 节点
(7 一级菜单 + 27 二级 + 8 三级)/ 30 叶 / 已绑 27 / 未绑 3(遥信类型、
遥信防抖、双点遥信)/ ui_page_*.c 30 个 / 像素黄金 74 张。
逐页现状按 6 组列出数据来源与代码落点:装置信息与实时数据(交流量
已由 Flash 字面量改为 ui_data_rt 快照 7 行、直流量 2 行、装置信息 8 行
全真值)、参数定值查看/整定两态共一份描述符、三遥设置、装置维护、
通讯参数、记录查询(七类 syslog + SOE + 运行报告 + 录波回放)。
未绑三叶写明唯一原因是缺开入数据源(硬件能力边界 H3),重开条件 =
RS-485 开入通道落地后按 ui_w_setlist 既有形态加描述符,非架构级工作。
厂家设置支逐项给结论(版本信息并入装置信息、元件配置不做、虚拟注入
未做且若做必须旁路真实采样)。
删除:版本快照表、2026-10-25/28/29/11-04 四轮复核叠加叙述、六个待拍板
问题、分批实施历史进度。字库现值同步为 218 字 / 324 字形。
同步更新引用:docs/README.md 索引描述、页面扩充详细方案.md 3 处
(定位语与归并叙述改为过去时)、UI_数据供给设计说明.md 3 处
(原引 §1/§3.1/§7 与「批 1」改指新节号)。
验证:check_doc_links --sections-strict 通过;pre-commit 48 钩子全 Passed。
2026-11-15 23:03:43 +08:00
wandering1
0c76be0fe8
docs(console): 控制台单写者日志档改为现状设计,引用全仓校准
...
CI / 静态门禁 (pre-commit) (push) Failing after 24s
CI / 主机侧单测 (MSVC) (push) Failing after 44s
按前面几篇的同一标准改造 docs/子系统设计/控制台单写者日志设计.md:
494 行 -> 320 行,只描述系统现状。
结构(10 节):1 设计目标与约束 / 2 总体架构(2.1 单写者模型、
2.2 文件清单、2.3 拓扑、2.4 台架采集口、2.5 并发语义)/ 3 详细设计
(3.1 环形缓冲、3.2 生产者路径、3.3 写者路径、3.4 裸发、3.4.1 行级
单一所有者、3.5 fputc 重定向、3.6 时间参数)/ 4 API 参考 / 5 常量 /
6 失效模式与可观测性 / 7 内存预算 / 8 设计决策与否决的替代方案 /
9 当前限制 / 10 相关文档。
删除:版本号块、背景(F1/F2 故障表与 C1/C2/C3 根因表)、验证记录、
实施时间线(12 条日期)、ORE 僵尸通道历史叙述与更正块、开放问题
O1~O4、附录 A(一次性评估全过程)。
新增当前限制五条:控制台口 RX 使能不消费(ORE 永不自愈,缓解 =
250 ms 预算 + 300 ms 冷却 + DWT 硬上界;根治 .ioc 改只发不收已裁定
不做,按长期现状对待)、极早期崩溃完全静默、ISR 直发与写者竞争
best-effort、dbg_console_tx_timeout 未接入 STALL 行、printf 逐字节开销。
2.4 只留软件面事实(台架端口 COM3、115200 8N1 只发不读);引脚与
端子接法归还 docs/架构设计/硬件规格与能力边界.md 2 节。
顺带纠正事实错误:原 3.1 写作「拷贝与推进 head 在同一次
taskENTER_CRITICAL 内完成」,实为 PRIMASK 窗口(CON_CRIT_ENTER/EXIT,
刻意不用内核临界区以免幻影环,见 console_log.c con_ring_try 注释)。
引用校准 14 处:
- 代码注释:Src/freertos.c 4.4.1 -> 3.4.1;Src/stm32f4xx_it.c 12 -> 9、
4.4.1 -> 3.4.1;App/task/protect_task.c 3.4 -> 2.5;
App/log/console_log.c 12 -> 9(三处)。
- 文档:看门狗设计说明 12 -> 9、4.4.1 -> 3.4.1;链路延迟测试说明
4 -> 8、3.4 -> 2.5;模拟器差距清单 4.1 -> 3.1;实机测试实施指南
两处 12 -> 9;硬件规格与能力边界、产品需求设计文档(2 处)、
参考产品复刻明细、屏板链路设计 的端子引用改指硬件规格档 2 节。
- 主机单测覆盖率口径第 9 条:生产者口径互斥疑点已收敛(入环判据与
写入现处同一 PRIMASK 窗口,3.1 节已统一为多生产者/单写者)。
验证:keil-build 0 Error 0 Warning;pre-commit 48 钩子全 Passed;
check_doc_links --sections-strict 通过。
2026-11-15 22:27:32 +08:00
wandering1
69431f4d2f
docs(screenlink): 验证状态收敛为未闭环清单,销项四条
...
屏板链路设计.md §9 由「已验证 + 未闭环」两小节收敛为单一「未闭环」:
- 删除 §9.1 已验证整表(九行历史台账),验证结论不再在文档中留档。
- 销项:剖析对照(画面静止 1 min、35 个 [PROF] 样本 uil
min 10937 / med 10999 / max 11024 us,等于 osDelay(10 ms) + 切换
开销,屏板链路每拍开销填不满一拍)、屏板排针收发脚方向(屏板方已
确认以丝印为准)、目视项(7 键 + 状态灯逐位 + 主动拔插用户台架
确认)、uiTask 拥塞面(太难测,取消,有问题再说)。
- §3.1 接线口径改写:排针方向以丝印 RX/TX 为准,网表 PA2/PA3 与
实物排针不是一回事;实操验收口径仍是看主机 rx 计数涨不涨。
- §9 现只剩两条:按键通路(真机未验过,现网日志 keys=0)、
键 9/10 语义(产品侧未定)。
连带修正三处失效引用:
- 产品需求设计文档 §5.16 的「屏板出图 = 端到端证据」改指屏板链路
设计.md §4(帧 B 结构所在节),原指向已删的 §9.1。
- 参考产品复刻明细 第三批状态:未闭环项例子(2 h 长稳、仪器项)
均已销项,改为直指 §9。
- 屏板链路设计.md 坑账本第 4 条 CH340 引用 §3.3 -> §3.2(§3 重编号
后 PC 顶替屏板已是 3.2)。
验证:check_doc_links --sections-strict 通过;pre-commit 48 钩子
全 Passed。
2026-11-15 22:04:46 +08:00
wandering1
1634088bd7
docs(screenlink): 屏板链路档去「说明」并瘦身,控制台档收编台架日志口
...
屏板链路设计说明.md -> 屏板链路设计.md(去档名「说明」,与 ADC 节拍 /
运行与自检记录两篇口径一致);控制台单写者日志设计说明.md 同改。
两档并存期间旧名引用 0 残留。
- 屏板链路 §3.2 台架日志口(RS232#1 / CN1 端子 / COM3)移入控制台档
§3.4:日志口的接线属 UART5 控制台通道,不属屏板链路;屏板档只留
「别去 CN1 找 USART1 端子」这句接线防错提示。
- 屏板链路 §7.1 由「根因账本 + 修复前后对比」改写为现状描述:延迟
应答机制表 + 耗时分解表 + 两个计数口径 + 已知边界,40 行压到 24 行。
顺带修正 §8 的错引:原指 `网络自愈架构设计.md` §8(实为「延后项」,
不含 uiTask 内容)改为 §4.1 `net_reconcile_tick`。
- §9.1 增补长稳行(串口日志 2026-11-13 18:31 -> 2026-11-15 21:43,
单次上电 51.2 h:rx=658262 ok=658262、crc/len/fmt/err 全 0、
drop=7 仅启动期、kerr/abor/bad=0、全程 off=0);§9.2 销项三条
(仪器项、2 h 长稳、len=7 观察项),新增「按键通路」一条——51.2 h
日志 keys=0 kq=0 dfok=0 dfold=0,延迟应答在真机上从未执行过。
- 删除 sb_frame_b_build_logo() 及 SB_LOGO_MAGIC_* / SB_SCREEN_W/H
与对应单测(TC-SBPROTO-022/023 全组、024c/024d),组帧入口只剩
sb_frame_b_build_image()。sb_proto 单测 59 -> 45 条,45/45 通过。
- cfg_file.c 出厂模板三条中文字面量改 \uXXXX 转义:消除全量重编时的
4 条 #870-D invalid multibyte character sequence,运行期字节不变,
源码回到纯 ASCII(符合「字符串字面量必须纯 ASCII」)。
验证:keil-build 0 Error 0 Warning;sb_proto 45/45、sb_link 164/164;
pre-commit 48 钩子全 Passed;check_doc_links --sections-strict 通过。
2026-11-15 21:51:24 +08:00
wandering1
f5902bcc21
docs(design): 运行/自检记录与 ADC 节拍两篇改为现状设计并去掉档名"说明"
...
两篇规划期文档改成对当前系统的描述,档名统一去掉"设计说明"的"说明"。
运行与自检记录:
- 旧档重写为现状版(10 节:概览 / 记录布局 / 写入路径 / 读取与呈现 /
事件分类 / 控制台日志 / 双端差异 / 内存 / 异常恢复 / 自测要点),
删掉需求表、调研摘要、模块清单动作列、实施步骤与开放问题。
- 按代码纠正:七类记录齐备(原文只写了两类)、自检描述串换成实际
落盘的 28 条、待机阈值以 ui_tokens.h 为准、记录页已走 ui_w_records
共享组件、容量满只删该文件而非整卷清空。
- 待机屏移出本篇:它不属于日志,归 UI 侧;内容页架构补"待机屏
(覆盖层)"一节,产品需求 FR-LOG-3 拆成单纯的上电/重启分类,
待机显示归口已有的 FR-UI-3。
ADC 采样节拍:
- §4.5 从 45 行压到 24 行,只留规则 / 违反的代价 / 为什么 / 兜底与
档案指针;九路置换实测表、A/B 对照、探针计数等取证归
ADC_Trap_Records.md 的 TRAP-ADC-01(那里已有完整档案)。
- adc1_gap 字段去掉"2026-10-21 起、此前固件为次数"的修订记录式括号。
- app_main.c 的注释改为指向 TRAP-ADC-01 取证、§4.5 设计口径。
引用同步:两个旧档名全仓替换(含代码注释、角色档、归档 id 表),
旧名残留 0;对 ADC 篇的 § 引用逐条复核落在真实章节上。
验证:48 个提交期钩子全通过,check_doc_links --sections-strict 通过。
2026-11-15 21:30:07 +08:00
wandering1
de6d5d863a
docs(cfg): 配置设计档补示例文件一章,写作规范补单篇自洽原则
...
配置文件设计.md 增加第 2 章「一份完整示例文件」:给出首启模板全文
(8 段 46 键,值全部对照工厂默认宏核对),再按段拆成 2.1~2.6 六张
键表(键 / 类型 / 出厂值 / 含义 + 生效时机),读者不必再翻别的文档
才能知道每个段的键是什么意思。
为保持文档自洽顺带收敛:
- 删掉文件格式章里重复的文件头代码块,改为指向第 2 章
- 删掉段表下「默认值见网络配置说明」的跳转,默认值现就在本篇
- 相关文档里把网络配置说明降级为对外使用手册
- 后续章号整体后移一位,交叉引用同步校准
doc-writer 角色补写作原则:原「同一事实只写一次」只覆盖跨篇去重,
照字面执行会逼出一篇到处跳转的文档。改为明确两条的分工——同一篇内
求完整、篇与篇之间求唯一,并给出判断标准(读者会不会被逼着另开一篇
才能读懂)与常见取舍。反模式表同步加一行。
验证:48 个提交期钩子全通过;check_doc_links / check_mermaid 通过。
2026-11-15 21:10:21 +08:00
wandering1
007f6a0e2f
docs(cfg): 配置设计档重写为现状版,删除旧二进制档叙述
...
原「配置文件设计说明.md」是 2026-09 的规划文档(P1~P8 实施计划、D1~D15
决策表、差距调研、模块清单动作列、已终结的开放问题),与现在跑的系统
已有明显出入。改写成只描述当前状态的「配置文件设计.md」。
新文档 9 节:概览 / 文件格式(路径与容量、语法、出厂模板原文、值类型)/
运行时机制(上电加载、外科手术式保存、2s 轮询与沉降、视图一致性守卫、
写者归属)/ 段与键表(8 段全满、注册顺序、接入新段模板、段回调)/
接口(引擎 API、平台后端)/ 内存占用(编译期钉死的 9217B 暂存)/
异常与恢复 / 双端差异 / 已知限制。
顺带修正一处事实错误:旧文档称 FTP STOR 是「写 .TMP 再 rename 原子更新」,
实际 lftpd receive_file 是原地覆写,已按代码现状改写。
旧二进制档(NCFG)的叙述按裁定从全仓移除:文档只描述当前状态,不再
交代旧版本兼容性。删掉网络配置说明 §3.2 整节(后续小节重排为 3.2~3.5),
并清理 README / 架构总览 / 产品需求 / 部署环境等 11 处同类叙述。
同步:
- 8 段注册、FTP 原地覆写、2s FAT mtime 粒度等数据更新进配置分层架构图,
重跑后与生成器逐字节一致,check_generated_fresh 里这条存量基线下架
- 全仓 24 处引用改用新文档名,旧节号逐条映射到新节号
- 文档规范 §7.1 变更记录例外名单 4 篇减为 3 篇(该档实际无变更记录表)
验证:48 个提交期钩子全通过;Keil 构建 0 错误 0 警告;
check_doc_links / check_mermaid / check_generated_fresh 均通过。
2026-11-15 20:55:04 +08:00
wandering1
26293f5054
docs(hw): 能力边界表收敛为 H1~H3,删除 H4/H5 与量纲引语块
...
CI / 静态门禁 (pre-commit) (push) Failing after 5m11s
CI / 主机侧单测 (MSVC) (push) Successful in 31s
V0.1 能力边界只留真正约束固件与产品决策的三条(双转换器无共同触发、
STM32 侧无中点偏置、无出口继电器与开入回路)。H4「无本地屏与按键」与
H5「无 SDIO」属产品形态而非能力欠缺,不再单列。
删除后把三处还指着旧内容的引用收口,避免悬空:
- 本文档自身的口径行 H1~H5 → H1~H3
- docs/README.md 索引条目的「能力边界 H1~H5 与量纲口径」→「H1~H3」
- 产品需求文档的两处 H1~H5,以及一处指向已删「§5 量纲口径」的引用
2026-11-15 20:11:45 +08:00
wandering1
df6e75a50d
docs(env): 部署环境要求通篇校正 + 体积快照回填至 2026-11-15
...
四处来源不同的漂移一次性收口。
- 钩子数:原有三个互不相符的说法(48/47/49),实测 config 内 53 个、
一次提交实跑 50 个(pre-commit 49 + commit-msg gitlint),manual 三根
不进提交期,四处统一
- 单测数:看门狗 39/39 实为 47/47;ci_local 主机侧「278 条」实为
48 个 runner / 4341 条断言
- 第 6 步原写 uv tool install pre-commit 再裸 pre-commit install,与
§2.4/§2.7 相冲突(pre-commit 随 .venv 装、INSTALL_PYTHON 指向 .venv),
改为 .venv 解释器调用;标题收为「cppcheck」
- 体积快照 2026-10-22 → 2026-11-15 实跑:Flash 232,536→288,628 B
(22.2%→27.5%),SRAM1 75,264→97,248 B(57.4%→74.2%,余量仅剩
33,824 B),CCM 不变;「余量集中在 SRAM1」的结论随之改口
- FTP 客户端三处统一为 MobaXterm(§4.2 / §4.4 / §5)
同时跟上文两句过时实测:.venv 已是干净 CPython 3.11(原写 Anaconda
3.12.4);CMake/Graphviz/cppcheck 的「本机实测」版本断言删除,改为
运行时核对。
2026-11-15 20:09:09 +08:00
wandering1
16cc064385
refactor(board-ui-nav): 台架存证迁入技能目录 artifacts/,ci-artifacts 清零
...
存证目录从仓库根的 ci-artifacts/ 搬进技能自己名下,规则更直观:谁的
证据跟谁走,不再堆在杂物区。
- board_ui_nav.py 新增 STORAGE_ROOT 常量,WALK_DIR 与 --walk 的默认
落点改指 .dsh/skills/board-ui-nav/artifacts/uinav/walk
- --outdir 的反向拒绝判据同步改口径:允许区从此前只认 ci-artifacts
字样,改为认存证根或 ci-artifacts 两处,避免新位置被直接拒跑
- 新增技能级 .gitignore(artifacts/),沿用 serial-assistant 等技能
内忽略运行时产物的先例;208 个存证文件均不入库
- 手册与流程文档的归档路径同步;wavebench 与 uinav、uiwalk 同属一套
台架流程产物,随导航器一并归位
2026-11-15 19:49:51 +08:00
wandering1
96a3d15efc
chore(gate): 门禁钩子改走 gate_python 启动器,worktree 统一插件模型
...
门禁解释器解耦
44 条 language: system 钩子此前把解释器写成仓库检出的绝对路径,换机、
换克隆目录都要重写。改为 entry 只写 scripts/gate_python.py + 脚本名,
由启动器按候选链解析:$DTU_GATE_PYTHON > <仓库>/.venv >
<仓库>/.gate/python > PATH。启动器用 execve 替换自身,并把选中的
解释器经 DTU_GATE_PYTHON 传给子进程,保证脚本内再调 Python 时一致。
实测 pre-commit 4.6.2 不展开 ${VAR};language: script 的 shebang 只做
纯 PATH 改写,会把决定权交给 PATH 首个 python,故不采用。
ci_local.py 预检识别启动器并报出解析结果。
并行工作树统一
task-worktree 新增 bench-gate(强制台架验收)与 merge(编排式合并),
删除 new/abort,done 标 DEPRECATED;台架通过记录改存
.agents/worktrees/.bench-pass-log。keil_build.py 的 plugin_tree_owner
识别 .agents/worktrees/<name> 并返回 pw:<name>。
check_doc_links / gen_refgraph / check_layer_deps 的扫描排除面补上
.agents;并行任务工作树方案重写为单一模型(7 节),取消工作树数量上限,
删历史实测记录节,两处 §7.3 悬空引用改为按语义引用。
文档与约定
本地工具路径环境变量方案 §5 重写为四节:谁跑在哪个 Python 上、写新钩子、
预检对号入座、动环境五步。文档规范的变更记录例外名单由 5 篇减为 4 篇
(本篇实际没有该节)。AGENTS.md 补委派验收口径三条。
验证:pre_commit run --all-files 48 钩子全 Passed;ci_local.py
--preflight-only 报 44 条经启动器 -> 仓库 .venv;keil-build 0 errors
0 warnings;check_doc_links --sections-strict 全通过。
2026-11-15 19:39:56 +08:00
wandering1
9f68b7bc03
feat(dsh): spawn_teammate 角色 persona 自动注入 + 测频带外饱和边界登记
...
CI / 静态门禁 (pre-commit) (push) Failing after 3m46s
CI / 主机侧单测 (MSVC) (push) Successful in 30s
一、子 Agent 角色自动注入(本批主线)
dsh-plugin-subagent-roles fork(仓库 .dsh/plugins/)新增事件路径注入:
spawn_teammate 的 prompt 首行写 @role:<角色id>,插件在子会话首轮模型
请求组装之前把 .dsh/roles/<id>.md 的 persona 注入其系统提示词,并应用
工具白名单。此前只有 subagent_role 路径自动注入,team 路径需 Lead 手工
拼接 persona,本批把两条路径拉齐。
实现要点(细节见 docs/环境与部署/子Agent角色自动注入实现说明.md):
- 在 lead 会话的 tool/call(spawn_teammate) 截获 @role 标记,在
subagent/catalog 拿 childId 后经 agents.get(childId) 注入——子会话侧
user/message 必然晚于首轮 system/message,只能在 lead 侧接力。
- tools.restrict() 只校验全局工具名,ops_* 等作用域工具混入会整批抛错;
降级为解析报错尾部 known global tools 求交集后重试。
- 保留子会话 @role 标记兜底路径(第 2 步起生效)+ 双去重集合。
- 诊断日志 ~/.dsh/role-inject-diag.log,一次健康注入 4 行。
配套文档与口径:
- 新增 docs/环境与部署/子Agent角色自动注入实现说明.md(实现参考 +
排障速查,9 章),docs/README.md 索引挂载。
- AGENTS.md 委派策略改为自动注入口径(无需手工拼接)。
- .dsh/roles/README.md 删去"调用预算"列:budget.js 的 arm() 只由
subagent_role 委派路径调用,teammate 路径不挂账,原列是假上限承诺;
改加脚注指向实现说明 §1.1。
二、测频幅值门放宽至 5 V + 带外饱和边界登记(freq.h)
- FREQ_AMP_MIN 50 V -> 5 V(用户裁定 2026-11-13):台架低端注入(标定
用 5~25 V 档)与低负荷工况也能测频;浮空二次域噪声几十 mV,仍差两个
数量级,噪声不测频的本意不变。
- 注释同步登记:IA 回退候选同拿 5.0 比较,二次电流 0.5~2 A 够不到
"5 A",只注电流实际不回退测频(电流域门限另裁);窗环钳位区间
[72,96] 只对 41.7~55.6 Hz 满足整倍条件,带外读数饱和钉沿。
- docs/算法/采集与算法层设计说明.md 新增 §7.3 准确测频带与带外饱和
(60 Hz 实证钉 ~55;用户裁定不改参数,只登记边界)。
验证:/keil-build 0 错误 0 警告(Code=256592 RO=32036 RW=2088
ZI=152584);pre-commit 52 钩子全绿(含 3 根 manual 阶段:cppcheck、
test-cppcheck、test-coverage)。
2026-11-14 10:07:27 +08:00
wandering1
e00531999d
merge: dsh-1741f418-0c10 合入 master(task-worktree 10项改进)
2026-11-13 17:00:13 +08:00
wandering1
5efb58eb45
refactor(task-worktree): 10项改进+清理旧版兼容
...
- 默认基线 v2-on-ui → master
- regen() 新增 ram_baseline.py --update/--write
- run_gates() 先 build 再 ci_local(修顺序错误)
- done 门禁失败时自动调 postmerge 补绿
- audit_residue 增加 git 冲突标记检测(JSON/TSV/CSV)
- plugin_trees() 同时扫描 .dsh-worktrees + .agents/worktrees
- harvest_memory() 只保留 dsh-mnemon,移除 workbuddy-ai 兼容
- done --dry-run 新增台账文件碰撞预检
- done 统一补绿链:regen→build→ci→postmerge
- SKILL.md 同步更新
2026-11-13 17:00:01 +08:00
wandering1
e544366b35
merge: dsh-1741f418-0c10 合入 master(FTP 控制通道超时改字节间隔语义,RAM 台账回填)
2026-11-13 16:24:47 +08:00
wandering1
8e1cc26c5d
fix(ftp): 控制通道超时改字节间隔语义,保活 NOOP 可续命会话
...
- lftpd_inet_read_line 预算原为「整行总时长」:t0 只在入口置一次,
保活型客户端的零散短行会被 30s 总预算误掐,会话周期被关闭
- 改为任何字节到达即重置 t0(字节间隔超时);空闲回收语义不变,
零字节静默满预算仍判超时释放
- 台架 2026-11-13:FileZilla 下载失败三方互证闭环——MobaXterm
单连接成功、本地探针服务器捕获 FileZilla 第二条控制连接行为、
ftplib 主机侧下载/上传全过
- 编译 0 错误 0 警告(keil_build)
2026-11-13 16:20:30 +08:00
wandering1
72779cab00
merge: 099a50a4 合入 master(cppcheck 两项风格提示修正)
...
来源:合并后主树全量 ci_local 复跑,manual 阶段 cppcheck 抓出
两处风格项(未用变量 / 可缩作用域),已按 ui-verify 链验证。
2026-11-13 16:03:20 +08:00
wandering1
099a50a49e
chore(ui/sim): 修 cppcheck 两项风格提示(未用变量 / 可缩作用域)
...
来源:合并后主树全量 ci_local 复跑,manual 阶段 cppcheck(提交期
不跑)抓出两处——sim_publish_data_frames 遗留未用变量 i;待机屏
sb_value_str 变量 n 作用域可缩进挂单位 if 块内。
验证:cppcheck 定向两文件 Passed;双端构建同码同数
(Code=256588 RO=32036 RW=2088 ZI=152584);菜单 8 态与内容页
74 张(含 rtlive A≠B 30 字节差)全过。
2026-11-13 16:03:01 +08:00
wandering1
bb7cea51da
merge: dsh-95f12db9-ba22 合入 master(待机页六路实时值 + 实时页自动刷新)
...
包含三笔提交:
- 待机显示页接入 UA/UB/UC/IA/IB/IC 六路实时值(v1.1)
- 内容页框架新增自动失效机制,交流量页 300ms 启用
- 其余五个实时页按内容变化节拍接入(dc/yx/clock/
device_info/runreport,info 页切通道二新鲜源)
验证:双端构建 0 错 0 警;菜单 8 态 + 内容页 74 张 +
rtlive 断言 PASS;三笔提交 52 钩子全绿;台账与体积
凭证随笔回填。
合并后在主树复跑全量门禁补齐合并提交期钩子盲区。
2026-11-13 15:01:18 +08:00
wandering1
a98d4e06e8
UI 其余五个实时页接入框架自动失效(按内容变化节拍分档取值)
...
- 描述符各加一行(机制 task-2 已建,本轮零框架代码改动):dc 300ms(电气量与
ac 同账);yx 500ms(遥信变位按 1s 内上屏到位,比 300 档少 40% 稳态重绘);
clock 1000ms(快变项只有墙钟秒尾);device_info / runreport 1000ms 并把新鲜度
源换到通道二 .auto_seq = ui_data_info_seq(info 与 rt 同拍 200ms 发布)
——各页取值账目在该页描述符注释
- docs/UI设计:供给说明 §5.5 改六页全接终态(用户裁定 2026-11-13);内容页架构
字段表/内存表/变更记录同步;自动化测试流程补 rtlive 覆盖行;页面扩充方案
追加 74 张现势注(带日期史实行冻结不动)
- .dsh/skills/lvgl-simulator:开关表加 --rtlive 行、黄金参考计数 66→74 同步
验证:模拟器 0错0警;菜单 8 状态 + 内容页 74 张 + rtlive PASS(lead 独立复跑
RC=0,池水位 5368/5448B 均不漂移——timer 开页创建关页销毁、分配归还);
Keil 0错0警且 Code/RO/RW/ZI 与 task-2 基线逐字节一致(只改常量值);BOM 全补回。
2026-11-13 14:51:49 +08:00
wandering1
a5142c6d9d
UI 内容页框架加实时页自动刷新机制(交流量页启用,300ms)
...
- ui_content_page:描述符尾部追加 auto_ms/auto_seq 可选字段(缺省=0/NULL=
旧行为逐位不变);页打开期间框架持一只 lv_timer,仅当发布序号变过才整页
失效(零空转失效),关页即销;新 API ui_content_page_auto_poll
- ui_page_ac.c:.auto_ms=300(≥200ms 发布节拍、避 400=2×200 锁相、300=
15×20ms LVGL 整刷周期;最坏屏上滞后 500ms;完整取值账目在代码注释)
- simulator:rt 帧装配收口 sim_fill_rt_frame(n=0 冻结帧保 74 张黄金逐字节
一致,n≥1 确定性斜坡);新增 --rtlive 两态自检 + 窗口模式 200ms 节拍发布;
check_content_pages.py 增 [rtlive] 零按键 A≠B 落屏断言
- docs/UI设计:供给说明新增 §5.5 自动刷新口径;内容页架构 §3.1/§四/§九 同步
(并修正 s_open 判定旧描述)
- 台账:Keil 构建后按固定顺序回填(Code=256,588 / RW_IRAM1 +8B / UI +8B)
验证:模拟器 0错0警;菜单 8 状态 + 内容页 74 张 + rtlive(A≠B 30 字节)PASS
(lead 独立复跑 RC=0);Keil 0错0警;mem-budget --gate / mem-numbers --scan 绿。
2026-11-13 14:23:06 +08:00
wandering1
5bab248dee
UI 待机显示页接入 UA/UB/UC/IA/IB/IC 六路实时值(v1.1)
...
- ui_standby.c:v1 占位(6 行恒 0.00A)→ ui_data 通道一按 seq 门控取帧,
yc 语义下标 {0,1,2,4,5,6}(跳 UN/IN);无首帧/坏质显 --;定点格式化复用
ui_w_editor_fmt_scaled;单位随 eng(引脚档不挂),口径逐字对齐 ui_page_ac.c
- ui_standby.h:头注与修改记录同步
- 文档 §5.2 按新口径改写;§1 R2 改为新需求口径(不再引 mockup);§9 对应
开放问题销项删行;版本 v1.4
验证:模拟器 0 错 0 警 + 菜单行/内容页/编码规范门禁 PASS + Keil 0 错 0 警;
--standby 截图双分支实证(UA/IA 显值、UB/UC/IB/IC 显 --)。
2026-11-13 13:11:42 +08:00
wandering1
40a2816a99
feat(adc): UN 标定完成、标定脚本归集到 test/host/cal/
...
CI / 静态门禁 (pre-commit) (push) Failing after 4m15s
CI / 主机侧单测 (MSVC) (push) Failing after 1m41s
- UN 通道 5 点最小二乘标定完成:r=555.382141, b=-1, 残差 0.038%, R²=0.99999967
- UA/IA/UN 三路 VALID 置位,保护解卡
- ROM 默认值更新为当前标定值(ADC_CAL_R_Q16_VOLT=555.144958)
- UB/UC/UN 通过 104 写入 ROM 默认值,config.ini 同步
- cal_fit.py 新增 ROLD 表自动读取,不再需要手传 --r-old
- 执行卡精简至 126 行,新增 cal_collect.py 采集脚本与 ROLD 填表
- 标定脚本(cal_fit/cal_write/cal_collect)归集到 test/host/cal/
- 全库文档路径引用同步更新(8 文件)
- UN 当前态文档改写:明确零序电压 U0 语义、本台架未接线状态
- 删除已失效的外部知识底座文档链接
2026-11-13 11:26:36 +08:00
wandering1
7c505b2457
refactor(adc): 最小二乘拟合移出固件,只留 PC 侧唯一实现
...
用户裁定(2026-11-13):设备本体只需要校正后的参数,不需要自己拟合
标定曲线,故固件侧最小二乘拟合整体移出,拟合的唯一实现留在 PC 侧
test/host/cal_fit.py。
删除的死代码(生产零调用、上一轮 map 里已被 linker 标 Removing):
- adc_cal.h:adc_cal_fit() 声明、8 个拒绝码、5 个常量
- adc_cal.c:s_div_round() / s_fit_accum() / adc_cal_fit() 共 224 行
- adc_cal_test.c:tc_00b_fit 226 行(184 -> 150 条)
原样保留的设备侧安全闸:
- adc_cal_apply() 折算、adc_cal_set() / adc_cal_set_ratio() 参数合法
带拦截(防工具写坏参数)、adc_cal_flags() / adc_cal_prot_blocked() /
adc_cal_rail_ths()。设备不「算」,但必须「用」和「验」。
测试面:
- cal_fit.py 转为唯一实现,新增 --selftest:承接原 C 侧金标向量
(r_q16=39322000 / b=12)与 4 条拒绝路径,共 11 条断言;已做变异
测试证明它会红(改坏圆整口径 -> 2 条 FAIL)
- cal_two_point.py 删除,两点工具由多点拟合取代
文档口径统一为「求参在 PC、设备只做折算与合法带校验」,6 篇 docs 同步;
执行卡改名 ADC多点标定执行流程.md(正文同步 5 点最小二乘口径)。
cfg 热重载吞段缺陷的解析器契约与 TC-CONFIG-063 机器钉一并入库。
Program Size 不变(Code=256196):删掉的是从未链接进镜像的死代码。
验证:Keil 0 errors 0 warnings;adc_cal 150/150;selftest 11/11;
ci_local.py RC=0(static 48/48、manual 三根、size-gate、host-unit
4341/4341);doc-links / mermaid / mojibake 全 0。
2026-11-13 08:09:09 +08:00
wandering1
1355dbe1b1
fix(cfg): 配置热重载吞段缺陷修复 + 两点标定工具链与台架实测落档
...
修复运行期改配置被打回出厂值的缺陷:cfg_file_poll() 按段循环复用同一
份读缓冲,而 s_parse() 通过 s_split_line()/s_key_value() 就地改写缓冲
(把换行与等号换成 NUL)。第一个段解析完,缓冲里已没有键值行,后续 7
个段静默保持出厂值;随后 run_par_store_save() 又把这份出厂值写回
config.ini,用户的标定值被永久覆盖。开机路径 cfg_file_load() 只解析一
轮,所以该缺陷长期不可见,只在运行中改配置时发作。
- s_parse() 改为非破坏性:入参 const char *,逐行 memcpy 到栈缓冲
(CFG_LINE_TEST_MAX + 1)后再交给会破坏缓冲的解析子函数;超长行跳
过(保存侧已拒绝落盘超长受管键行)。
- 新增 TC-CONFIG-063:同时改两段内容,断言第二个注册段也重载成功、
含负值 INT 键存活,把「热重载吞段」钉成机器面。
新增两点标定台架工具链(test/host/):
- cal_two_point.py:整数算术镜像 adc_cal_two_point(),支持单路模式与
从执行卡 CALDATA 表批量求解(--from-doc),带合法带与零点自检拦截。
- cal_write.py:复用 iec104_master 作库,经 104 定值段写 r 后写 b 并
读回校验,是所有写入的唯一入口。
adc_task 的 meas: 心跳行精度提到 4 位小数,标定读数需要。
文档:新增《采样数据校正全流程》(端到端导航)与《ADC 两点标定执行
流程》(台架执行卡,含 CALDATA 可填表);ADC通道映射说明新增 §7.3 台
架实测结果(UA 554.687914、IA 29.634259,出厂默认值保持不变);配置
文件设计说明新增解析器契约 v1.19;采集与算法层设计说明 §13 系列与
README 索引同步。
台架实测:UA r=554.687914(出厂 1000.0 偏大 1.80 倍,根因是接线分压
使 PT 一次侧只拿到一半电压,实测与参数算定 606.06 只差 8.5%)、IA
r=29.634259(与出厂 29.4118 只差 0.76%,反证链路未算错)。UN 按用户
裁定本轮不标定,保护闭锁(vl=0x11)是预期行为,未伪造 VALID。
同时入库 .dsh/roles 角色定义(原被 .gitignore 挡住)。
2026-11-13 01:35:58 +08:00
wandering1
18c087500a
fix(gates): doc-links 全库扫描排除 .agents 插件工作树
...
主树根跑 --all 时 rglob 会把仓内 .agents/worktrees/* 的整份仓库
副本一并索引,裸文件名解析出 3~4 份导致章节引用假红(本次合并
后复核实测 2 处失效引用 + 4 处芯片手册命名问题)。SKIP_PARTS
已排除同类 .dsh-worktrees,补上 .agents 一项即对齐。
只改 scripts/check_doc_links.py 一行;不改 pre-commit 的 exclude
(该处只喂 git tracked 文件,.agents 已被 .gitignore 挡住)。
修后 --all-files 48 钩子全绿、doc-links --all --sections-strict
全库 214 篇文档 rc=0。
2026-11-11 12:15:35 +08:00
wandering1
206dcf7f01
Merge branch 'dsh-98ce65ba-6235': 变比维三维折算 + 录波 v2
...
将采样板读数偏小修复合入主干:折算从二维 (code+b)×k 改为
三维 (code+b)×k×r,r 为端子二次值变比(int32 Q16);
新开单段 [adc_cal_sec](cfg 达 8/8 上限);录波段格式升 v2
(通道表加 r_q16,整段 5250→5282);文档与 13 套主机单测同步。
/keil-build 0 错误 0 警告;RAM 实测回填内存内容分配策略 §6.1。
2026-11-11 11:32:31 +08:00
wandering1
3675b89e8e
feat(adc): 新增变比维 r 三维折算,录波段格式升 v2
...
采样板注入 Ua=5V/Ia=0.5A 读数偏小,根因是固件只输出引脚电压、
缺「端子→引脚」变比。折算改三维:
工程量 = (code + b) × k[µV/码] × 1e-6 × r
k 保持 ROM 引脚 LSB,b 为零点,r 为端子变比(int32 Q16)。
变比不能并进 k:UA 端子域 k 达 1.5e5 µV/码、Q16 溢出 int32;
r 单独存 Q16 不溢出。两点标定改标 r,k 仍是板级事实。
- 新开单段 [adc_cal_sec](8 键 r_ua..r_in),cfg 段数达 8/8 上限
- 一次变比复用 prot_set 四项,不新开段;r=0 表示本路不折算
- ROM 默认带台架实测变比(电压族 1000、电流族 29.4118),
烧进固件即显二次值;VALID 仍须两点标定,两者互不派生
- eng 判据改「每路要么已配变比、要么削顶不显示」,不再看 VALID
- 104 地址 0x8050~0x8057 写 r,run_par_cal_r_set 写值与置脏同函数
- 录波 v2:通道表加 int32 r_q16,头 128→160、整段 5250→5282;
code_to_milli 用余数分解换等价单次圆整,20 万组大整数对拍 0 不符
- 文档同步:采集与算法层/通道映射/故障录波/网络配置/配置文件/
产品需求/内存台账,历史带日期实测数字按冻结口径不改
- 单测 13 套全绿,/keil-build 0 错误 0 警告(256024/31760/
2080/152368),RAM 实测回填内存内容分配策略 §6.1
2026-11-11 11:31:34 +08:00
wandering1
8115fb9a87
Merge branch 'dsh-447a9a36-1c96'
CI / 静态门禁 (pre-commit) (push) Failing after 5m1s
CI / 主机侧单测 (MSVC) (push) Failing after 42s
2026-11-11 01:06:17 +08:00
wandering1
b772117ed3
fix(wave): 落盘道改覆盖写,修回放页全板「该段不可读」
...
段名是 100 个槽位的轮转复用,而写者用 FA_OPEN_APPEND 打开:槽位复用时撞上
同名旧文件,新段接在旧段尾巴上,文件长成 5250 的整数倍。回放页读侧按单段
判 size == total,于是逐件落进 UI_WAVE_REJ_LEN(reject=2),全板没有一段
放得出来。
板级取证(100 件全部归档到 ci-artifacts/wave_append_backup_20261110/):
/wave 共 1868 段、9,807,000 B,尺寸全为 5250 的整数倍,恰好等于 5250 的
文件数为 0;逐段过 wave_read 校验全部合法、零损坏——数据一直是好的,只是
容器尺寸与写者语义相抵。
修法(用户裁定取写者截断,否掉读侧多段感知):打开模式改为
FA_WRITE|FA_CREATE_ALWAYS。本移植的覆盖分支会 remove_chain 并清零目录项
FileSize,是真截断;FA_CREATE_ALWAYS 单独用不含 FA_WRITE,两个位必须同给。
日志七本与 soe.log 仍用追加(靠历史累积,语义正确),读侧口径不动。
板端验收:新段尺寸恰好 5250 B;对已有 28 段的 WAVE00.BIN(147,000 B)录
一次当场变 5250 B,全目录总字节减 141,750 = 147,000 - 5,250。回放页从
bad 态(与黄金参考 shot_wave_play_bad 逐比特相同)转为正常态,页眉 24/24
行、页脚 20/20 行与 shot_wave_play 逐字节一致。
文档:故障录波设计说明 §5.2 陷阱表改打开模式完整口径,§10 新增收口记录;
带日期戳的 11-07 取证归档正文按当时口径冻结,只加一条口径已被推翻的指向。
2026-11-11 01:06:04 +08:00
wandering1
7b05d7bfd4
docs: 任务规划目录收缩——只留推进顺序与硬件缺陷,其余待办归模块文档
...
按用户裁定(2026-11-10)把 docs/任务规划/ 从"全量待办表"收成两个文件:
1. 登记簿.md 只记 V0.1 硬件缺陷 → V0.2 改版要求(双转换器无共同采样触发、
IA 前端差分滤波限制谐波带宽)。原 §1/§2/§4/§5/§6/§7/§8/§9 的待办按
"待办跟着所属模块走"清空,四类事实在删除前先落到新归属:
- 两点标定开工前要先拍板的三件事 → 算法层设计说明 §13.13(新节)
- 通讯设置页真机判据 → 网络配置说明 §3.6 内联
- 缩堆迁 CCM 后半、开入开出重开条件 → 原本各模块文档即唯一权威
2. 暂缓-RS485.md 删除,其唯一不可丢的"采集链路测试可验证性约束"三条与
完成判据并入 产品需求设计文档 §5.10。
3. 任务规划/README.md 去掉全部历史叙述(UI 补齐销项流水、net 收口过程、
故障录波近千字台账),只留:怎么用、条目规则、生成物单写者纪律、
推进顺序表(每行只写当前状态与卡点)、维护约定。
同步改写全库引用(约 60 处):AGENTS.md、docs/README.md、产品需求、UI、
子系统设计、内存管理、环境与部署、算法、测试说明、门禁说明、问题记录,
以及 App/ 与 Drivers/BSP/ 的头注释、脚本与 .pre-commit-config.yaml 注释。
顺带修掉三处已失效的引用目标:链路延迟测试的队列往返重验项改指实机测试
实施指南 §7.3;并行工作树的 <ID> 行去掉已退役的 N-x/S-x/T-x 编号族;
任务规划 README 的 §1 旧编号在技能示例里的引用。
门禁:check_doc_links --all --sections-strict 214 篇通过、无法判定 0;
pre-commit 全 Passed(doc-links / mermaid / 任务表 / 内存数字 / BOM /
UI 像素回归 / generated-fresh / layer-deps / bsp-err / skill-size);
keil-build 0 错误 0 警告(Code=255160 RO=31204 RW=2080 ZI=152152),
RAM 预算门禁 PASS(RW_IRAM1 73.9%、RW_CCM 87.9%)。
2026-11-10 20:33:30 +08:00
wandering1
ae09c5737a
docs: 删任务规划两份已完成文档,数据可信内容迁入算法层/硬件平台/登记簿
...
任务规划目录从 5 个文件收敛到 3 个:只留导航(README)、待办(登记簿)、
暂缓专项(暂缓-RS485)。
删除的两个文件都不再有现行读者:
- UI补齐.md 执行清单 2026-10-28 清空、上板判据 2026-11-06 台架轮已复核;
叶数口径迁 docs/UI设计/菜单页面设计.md §3.9,三条内容页硬规矩迁
docs/UI设计/内容页架构.md §7.1,两条未闭环待办迁登记簿 §7/§8。
- 数据可信.md 不是完成记录,而是被约 130 处代码头注释引用的设计约束,
因此按内容分三处落位后删除,不整篇丢弃。
数据可信内容的新归属(旧节号 → 新家):
- §2/§4 设计口径 → docs/算法/采集与算法层设计说明.md 新增 §13(13 小节),
§7 前置决策表 → §13.12 已定案的前置决策。
- §3 台阶与波次退出判据 → docs/硬件平台/ADC通道映射说明.md 新增 §9。
- §5 任务卡 → docs/任务规划/登记簿.md §7(拆成变比确认 / 两点标定两行)。
引用改写 34 文件 77 处路径引用 + 14 文件 24 处昵称引用 + 双重节号 35 处,
覆盖代码头注释、测试、生成器与文档;归档区历史路径改纯文本提及。
四个 SVG 生成器文案同步并重跑,产物随脚本同批提交。
同批处理两件事:
- 9 个 UTF-16 LE 证据文件转 UTF-8。end-of-file-fixer 按字节判末尾换行,
UTF-16 的换行是 0A 00、末字节 00,钩子会追加裸 0x0a 使文件变奇数长度,
8 个已实际损坏。转码后逐文件比对 HEAD 原文验证正文零丢失。
- 修回 App/cfg/cfg_file.c 被剥掉的 UTF-8 BOM(补 3 字节,未整文件重写)。
验证:/keil-build 0 错误 0 警告(Code=255160);check_doc_links --all
--sections-strict 221 篇全通过、无法判定 0;pre-commit 全量全 Passed。
2026-11-09 16:13:57 +08:00
wandering1
7027718dcd
Merge remote-tracking branch 'origin/master'
...
CI / 静态门禁 (pre-commit) (push) Failing after 31s
CI / 主机侧单测 (MSVC) (push) Failing after 44s
冲突三处,全部按「保留我方去废话后的结构,吸收远端新增事实」解:
- docs/硬件平台/ADC通道映射说明.md
远端新增 §7.2 ④ 段变比登记(电压族 606.06:1、电流族 29.4118 A/V)与
§8 逐通道验证四步;我方上一笔把该文改成只留现状。合并后 §7.1 四段表
的 ④ 行改为「已定死(参数算定)」并指向 §7.2,§8 保留四步验证(去掉
已完成标记与历史挂账叙述),§8.1 静态记录与 §8.2 交流动态记录并存。
- docs/内存管理/RAM使用分析与优化方案.md、RAM预算台账.md
受管内存快照区取远端数值,随后按合并后真实 .map 重跑
check_mem_numbers.py --write 与 ram_baseline.py --write 同步(构建
Program Size: Code=255160 RO=31204 RW=2080 ZI=152152,0 错误 0 警告)。
顺带修 §7.2 末尾一处指向 docs/任务规划/数据可信.md §8 的失效章节引用
(该文档已删 §8),改成陈述句。
门禁:check_doc_links --all --sections-strict 223 篇全通过、无法判定 0;
pre-commit 全 Passed。
2026-11-09 10:59:45 +08:00
wandering1
acf9f0d7e5
增加元器件说明
2026-11-09 10:27:22 +08:00
wandering1
ed1fe221e9
Merge pull request 'docs(wave): #93 修复板级验收轮证据与文档回填(续 #94)' ( #98 ) from docs-94-evidence into master
...
CI / 静态门禁 (pre-commit) (push) Failing after 4m29s
CI / 主机侧单测 (MSVC) (push) Successful in 36s
Reviewed-on: http://100.123.83.113:3001/wandering1/STM32F4-Base/pulls/98
2026-11-08 10:56:47 +08:00
super_agent_bot
1dbead5177
docs(wave): #93 修复板级验收轮证据与设计面回填(PR #94 第二提交)
...
CI / 静态门禁 (pre-commit) (pull_request) Failing after 3m59s
CI / 主机侧单测 (MSVC) (pull_request) Failing after 40s
- 证据目录 docs/测试说明/测试数据/wave_fix_20261107/:Before(旧固件烧录前实测
oldN_P0..P3)/ After(新固件 19:10:36 构建,F1 五条 + F2 五条全过)逐帧 raw3200+PNG、
serial 摘录与 sha 台账、boot_new2/3 启动报告、restore_verify(100 件逐字节还原 OK)、
samples 三件与 README(含复现口令与 i104 环境条件如实记录)。
- 设计说明 §10 修复记录:板级验收结果行回填 + 台架环境新事实(拼接盘态口径相抵记账)+
两条 i104 观察项(软复位首绑必失败 / 重试成功静默)建议各自开票。
- 手册 §4 步 7 判废行判读表 + 开页作废纪律、§8 [ERR] 停幕例外的坏段轮点名放行;
ui_task.c 注释指向改 §4 步 7 与 §8(纯注释,Code=254960 复建一致)。
- 任务规划 README 独立行:#93 修复与板级验收里程碑。
2026-11-07 23:42:10 +08:00
wandering1
fe84a80912
Merge pull request 'ftl: add P0 bench verification probes ( #85 )' ( #96 ) from dig-volume-view-283370226187 into master
...
CI / 静态门禁 (pre-commit) (push) Failing after 46s
CI / 主机侧单测 (MSVC) (push) Failing after 45s
Reviewed-on: http://100.123.83.113:3001/wandering1/STM32F4-Base/pulls/96
2026-11-07 22:20:58 +08:00
wandering1
ebb64f6df2
Merge branch 'master' into dig-volume-view-283370226187
CI / 静态门禁 (pre-commit) (pull_request) Failing after 29s
CI / 主机侧单测 (MSVC) (pull_request) Failing after 44s
2026-11-07 22:20:40 +08:00
wandering1
01fde986ee
Merge pull request 'docs(wave): 触发源字母汉字化注记——手册补 src 速查表,人读文案改「保护触发(P)」式(#83)' ( #97 ) from docs-trig-legend-83-6f432acbeab7 into master
...
Reviewed-on: http://100.123.83.113:3001/wandering1/STM32F4-Base/pulls/97
2026-11-07 22:12:29 +08:00
super_agent_bot
82a84a4264
docs(wave): 触发源字母汉字化注记——手册补 src 速查表,人读文案改「保护触发(P)」式(#83)
...
CI / 静态门禁 (pre-commit) (push) Failing after 45s
CI / 主机侧单测 (MSVC) (push) Failing after 42s
用户反馈「P 触发」这类字母看不懂(#83 评论 755)。
- 手册开头补「触发源字母速查」:M=手动录波 / P=保护启动触发 /
T=定时自抓(bench)/ -=本次上电未触发;注明四字母是串口与台架
脚本的 grep 契约、不改汉字,契约定义属主仍指设计说明 §9;
- 手册 §1/§5/§9、docs/README、任务规划 README §2.0 的人读文案把
裸字母改成「保护触发对时刻(src=P)」式汉字在前的写法;
- 串口字段 src=P / src=T 与测试数据目录下的抓帧原件逐字保留。
2026-11-07 22:09:39 +08:00
wandering1
2aa4561af6
Merge branch 'master' into dig-volume-view-283370226187
CI / 静态门禁 (pre-commit) (push) Failing after 46s
CI / 主机侧单测 (MSVC) (push) Failing after 45s
CI / 静态门禁 (pre-commit) (pull_request) Failing after 46s
CI / 主机侧单测 (MSVC) (pull_request) Failing after 44s
2026-11-07 22:06:44 +08:00
wandering1
33b52410f9
Merge pull request 'fix(wave): bench 定时自抓到期判定无符号回绕恒真修复,第四幕板级闭环入档(#84)' ( #95 ) from exec-issue-84-1f621ac1c3ce into master
...
CI / 静态门禁 (pre-commit) (push) Failing after 45s
CI / 主机侧单测 (MSVC) (push) Failing after 45s
Reviewed-on: http://100.123.83.113:3001/wandering1/STM32F4-Base/pulls/95
2026-11-07 22:05:57 +08:00