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.
This commit is contained in:
@@ -823,7 +823,7 @@ void net_process_messages(void) {
|
||||
}
|
||||
/* ===== UDP 数据面(2026-11-03 队列化改造)=====
|
||||
* 芯片事务全部在 netTask 里执行;源地址出参不搭 net_msg_t(按值拷贝,
|
||||
* AGENTS 禁止加"回传用"字段),而是经 net_udp.c 的 per-fd 槽写回调用方
|
||||
* 禁止加"回传用"字段),而是经 net_udp.c 的 per-fd 槽写回调用方
|
||||
* 内存,通知值只带结果码。执行体定义见 net_udp.c。 */
|
||||
case NET_MSG_UDP_BIND: {
|
||||
/* 打开芯片侧 Socket(恒服务器模式);端口 0 = 由执行体取动态游标 */
|
||||
@@ -1244,7 +1244,7 @@ int net_listen_locked(int sockfd) {
|
||||
* Socket 的 SINT(见 :469 门控)→ 全量清等于把别的在用 Socket 的门一并
|
||||
* 焊死,其 CONNECT/DISCONNECT 等边沿事件永久丢失(RECV 属条件位,下轮
|
||||
* 可补回,见 TRAP-NET-08)。
|
||||
* 全局寄存器交 net_poll 集中读清(AGENTS 模块约定:所有 CH395F 中断经
|
||||
* 全局寄存器交 net_poll 集中读清(模块约定:所有 CH395F 中断经
|
||||
* net_poll 集中读取并清除);本 Socket 残留的全局位被 net_poll 读到时
|
||||
* SINT 已为 0,自然收尾。TRAP-NET-12/-18 指定的两级预清落在
|
||||
* net_connect_locked / net_close_locked / relisten 隔离段,均为单 Socket,
|
||||
@@ -2561,7 +2561,7 @@ int net_close(int sockfd) {
|
||||
* -1 - 失败(BADF/INVAL/入队失败) int
|
||||
* 限定条件:1. 必须在【非 netTask】上下文调用(同其它 net_* API,netTask 内会自等死锁)
|
||||
* 2. 场景=应用放弃会话(对时 30s 预算耗尽、协议超时);EOF 路径**不要**调
|
||||
* (net 层 auto_relisten 已接管,见 AGENTS 单连接断开语义)
|
||||
* (net 层 auto_relisten 已接管 → docs/网络/网络自愈架构设计.md §4.10)
|
||||
* 函数说明:1. 单连接模型下挂起但 TCP 仍活的客户端会永久占住监听(keepalive
|
||||
* 被 PC 内核自动 ACK 判不死,《网络自愈架构设计》§5.2 E13);应用不得
|
||||
* net_close 监听 fd → 本 API 拆连接不拆监听
|
||||
@@ -2894,7 +2894,7 @@ int net_udp_get_mode(int sockfd) {
|
||||
* 返回值:字节数(> 0);<= 0 为**原始码**(NET_ERR_* 或 NET_ERR),errno 由公开入口写 int
|
||||
* 限定条件:参数已由本函数校验
|
||||
* 函数说明:1. 源地址回传不占 net_msg_t 字段——先在本任务上下文把出参登记进
|
||||
* net_udp 的 per-fd 槽(AGENTS:net_msg_t 按值拷贝,禁止加回传字段),
|
||||
* net_udp 的 per-fd 槽(net_msg_t 按值拷贝,禁止加回传字段),
|
||||
* netTask 执行时按槽写回调用方内存,通知值只带结果码。
|
||||
* 同一 fd 上槽位互斥:并发收包在数据报语义下无法区分归属,直接 BUSY。
|
||||
* 2. 本函数不碰 errno:超时与错误都以原始码返回,由 net_recvfrom /
|
||||
|
||||
Reference in New Issue
Block a user