diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..c71f2e4 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,71 @@ +# 项目目标 + +本仓库用于配置家中的 DNAKE(狄耐克)设备网络,通过 ADB 在设备上配置 `ip route`、IP 转发及必要的 NAT 规则,打通家庭局域网到电梯控制设备的通信。最终通过 Python 和微程序提供手动、快速的呼梯/开梯入口。 + +“打开电梯”的具体行为以现有设备协议和实测结果为准;不要将发送成功直接等同于电梯已经执行。微程序的具体平台尚未确定,不默认指定为微信小程序。 + +# 设备与网络 + +- 用户已确认可通过 `adb connect 192.168.3.3:5555` 和 `adb shell` 连接 DNAKE 设备。 +- 路由配置在 DNAKE 的 ADB shell 内执行,区分宿主机命令和设备端命令。 +- 以下拓扑来自仓库现有记录,操作前读取实际配置确认: + +| 角色 | 地址/接口 | 用途 | +| --- | --- | --- | +| DNAKE 家庭网接口 | `192.168.3.3/24`,`eth1` | ADB 连接、现有 UDP 转发入口 | +| DNAKE 设备网接口 | `192.168.9.57/24`,`eth0` | 通向电梯设备所在网络 | +| 电梯控制目标 | `192.168.9.4:5060` | 现有 SIP MESSAGE 的目标 | +| 开发 Mac | 历史地址 `192.168.3.33` | Python 客户端,地址需按实际网络确认 | + +宿主机连接与只读检查示例: + +```sh +adb connect 192.168.3.3:5555 +adb devices +adb -s 192.168.3.3:5555 shell +``` + +进入设备 shell 后检查: + +```sh +id +ip addr +ip route +ip rule +cat /proc/sys/net/ipv4/ip_forward +iptables -t nat -L -n -v +iptables -L FORWARD -n -v +``` + +同时连接多台 ADB 设备时,始终使用 `-s 192.168.3.3:5555` 指定设备。连接成功不代表具备修改路由、防火墙的权限;先检查实际权限。 + +# 仓库结构与现状 + +- `apps/socket/main.py`:Python UDP/SIP MESSAGE 发送脚本,直接运行会发送真实呼梯请求。 +- `apps/socket/app.py`:FastAPI 服务,端口 `3001`;现有 `/api/router?path=floor` 会调用发送脚本,`path=test` 是占位接口。 +- `server/`:Bun/TypeScript 服务,开发命令为 `bun run dev`;当前 `src/lib.ts` 的 `sendSipMessage` 只生成并打印消息,没有实际发送 UDP,不视为已完成呼梯功能。 +- `docs/`:Astro 文档站,使用 pnpm;开发命令 `pnpm dev`,构建命令 `pnpm build`,均在该目录执行。 +- `docs/src/pages/ip-step.md`、`ip-step-back.md`:已有网络配置记录。 +- `docs/src/pages/adb.mdx`、`python.mdx`:ADB 和 Python 示例。 +- 当前未发现微程序实现或 Python 项目依赖清单;`apps/socket/README.md` 中的 `uv sync` 需在补齐项目配置后再使用。 + +# 开发约定 + +- 默认使用中文沟通、注释和维护文档。围绕网络连通、Python 呼梯、微程序手动入口逐步完善,避免无关重构。 +- 设备 IP、端口、网卡、SIP 用户及楼层等参数应可配置,不把历史值当作所有环境的固定值。 +- 当前消息示例包含 `elev=1`、`direct=2`、`floor=13`、`family=2`、`event=appoint`;这些是已有值,业务含义和设备支持范围需要验证,不凭空推断。 +- 区分直接路由与向 `192.168.3.3:5060` 发送后 DNAT 的方案;`ip route`、IP 转发和 NAT 各有用途,不能互相替代。 +- 修改网络配置前记录现有路由、规则和转发状态;采用范围明确、可重复执行的增量配置,并提供对应回滚步骤。不要直接照搬旧文档中清空整张 iptables 表、修改全局默认策略或关闭 SELinux 的操作。 +- 记录配置是临时生效还是重启后保留,持久化方式需根据设备环境确认。 +- SIP 头使用 CRLF;`Content-Length` 按最终实际发送的消息体 UTF-8 字节数计算,避免换行转换后长度失配。 +- 手动入口应防止连续误触;超时或无响应不能直接认定执行失败,也不要自动重复发送可能已执行的呼梯指令。 +- 不将仅打印消息、UDP 发送成功或 HTTP 成功响应表述为实际呼梯成功;分别报告发送结果、协议响应与设备执行确认。 + +# 验证与交付 + +- 用户确认实际执行结果由人工观察电梯判断;程序仅报告发送及协议响应,不要求程序自动判断电梯是否动作。重启后的恢复步骤见 `docs/src/pages/ip-step.md`。 + +- 文档修改检查命令、路径及与代码的一致性;只有涉及文档站功能或构建时才运行对应构建。 +- Python/服务修改优先离线检查消息编码、配置处理、错误返回及接口行为;使用模拟 UDP 接收端验证发送,避免测试时误触真实设备。 +- 真实设备联调以用户当前指令范围为准:初始化文档不包含修改设备网络或发送呼梯请求;用户明确要求配置或呼梯联调后,继续完成相应操作。 +- 交付说明写明修改内容、验证方式和未验证部分。需要更新的操作说明同步到 `docs/`,不要把历史示例当作已经实测成功的结论。 diff --git a/apps/socket/main.py b/apps/socket/main.py index 6cddf7c..7f6682e 100644 --- a/apps/socket/main.py +++ b/apps/socket/main.py @@ -29,7 +29,8 @@ def send_sip_message(): /elev/appoint '''.format(receiver_sip=receiver_sip, receiver_ip=receiver_ip) - # 计算消息体长度(字节数) + # 按实际发送的 CRLF 消息体计算字节数 + xml_body = xml_body.replace('\n', '\r\n') content_length = len(xml_body.encode('utf-8')) # 构造SIP MESSAGE请求(严格使用\r\n换行) @@ -44,10 +45,10 @@ Max-Forwards: 70 User-Agent: DnakeVoip v1.0 Content-Length: {content_length} -{xml_body}''' +''' # 替换换行符为\r\n(确保符合SIP协议) - sip_message = sip_message.replace('\n', '\r\n') + sip_message = sip_message.replace('\n', '\r\n') + xml_body try: # 创建UDP socket并发送消息 @@ -56,7 +57,7 @@ Content-Length: {content_length} sock.settimeout(5) # 发送消息 sock.sendto(sip_message.encode('utf-8'), (target_ip, target_port)) - print(f"已发送SIP消息到 {target_ip}:{target_port}") + print(f"已发送SIP消息到 {target_ip}:{target_port};电梯是否执行请人工确认") print("\n发送的消息内容:") print(sip_message) @@ -66,10 +67,10 @@ Content-Length: {content_length} print(f"\n收到来自 {addr} 的响应:") print(response.decode('utf-8', errors='ignore')) except socket.timeout: - print("\n未收到响应(可能对方未回复或网络延迟)") + print("\n未收到协议响应;请人工查看电梯是否执行,不自动重发") except Exception as e: print(f"发送失败:{str(e)}") if __name__ == "__main__": - send_sip_message() \ No newline at end of file + send_sip_message() diff --git a/docs/src/pages/ip-step.md b/docs/src/pages/ip-step.md index 7eecfaf..4ed2b71 100644 --- a/docs/src/pages/ip-step.md +++ b/docs/src/pages/ip-step.md @@ -1,3 +1,54 @@ +## 重启后恢复(2026-10-14 联调记录) + +本次检查发现:两侧路由及 DNAT/SNAT 规则仍在,但 `ip_forward=0`,且原有电梯放行规则位于 `natctrl_FORWARD` 的 DROP 之后。无需重复添加路由,应开启转发并在 DROP 之前放行指定电梯通信。 + +宿主机执行: + +```sh +adb connect 192.168.3.3:5555 +adb -s 192.168.3.3:5555 shell +``` + +设备 shell 中先检查并记录当前状态: + +```sh +ip route +ip rule +cat /proc/sys/net/ipv4/ip_forward +iptables -t nat -S +iptables -S +``` + +确认网络仍与本文一致且原有 DNAT/SNAT 规则存在后,执行: + +```sh +echo 1 > /proc/sys/net/ipv4/ip_forward +iptables -C FORWARD -i eth1 -o eth0 -p udp -d 192.168.9.4 --dport 5060 -m comment --comment dnake-recovery-out -j ACCEPT || iptables -I FORWARD 1 -i eth1 -o eth0 -p udp -d 192.168.9.4 --dport 5060 -m comment --comment dnake-recovery-out -j ACCEPT +iptables -C FORWARD -i eth0 -o eth1 -p udp -s 192.168.9.4 --sport 5060 -m comment --comment dnake-recovery-in -j ACCEPT || iptables -I FORWARD 2 -i eth0 -o eth1 -p udp -s 192.168.9.4 --sport 5060 -m comment --comment dnake-recovery-in -j ACCEPT +iptables -L FORWARD -n -v --line-numbers +``` + +检查带 `dnake-recovery` 标记的规则位于系统 DROP 之前。上述配置是运行时配置,尚未配置开机自动恢复;不要清空系统防火墙规则。 + +退出设备 shell 后,在仓库根目录执行一次真实呼梯请求: + +```sh +python3 apps/socket/main.py +``` + +本次收到 `SIP/2.0 200 OK`,XML 响应包含 `resultCode=200`。随后按用户要求再次发送一次,用户人工观察确认呼梯成功。后续仍以人工观察判断实际执行结果,协议响应不能替代执行确认。脚本使用现有 `floor=13` 等参数,不自动重复发送。 + +本次修改前快照保存在宿主机 `/tmp/dnake-before-recovery-20261014.txt`(临时文件)。若需撤回本次设备改动,在设备 shell 执行: + +```sh +iptables -D FORWARD -i eth1 -o eth0 -p udp -d 192.168.9.4 --dport 5060 -m comment --comment dnake-recovery-out -j ACCEPT +iptables -D FORWARD -i eth0 -o eth1 -p udp -s 192.168.9.4 --sport 5060 -m comment --comment dnake-recovery-in -j ACCEPT +# 本次修改前 ip_forward 为 0;恢复后会停止路由转发 +echo 0 > /proc/sys/net/ipv4/ip_forward +``` + +以下是历史配置方案,可能包含清空规则等操作;日常恢复优先使用上面的定向增量步骤。 + ## 需求描述 有一个andorid有两个网口,一个网口是A局域网,一个是B局域网。