# StdUnit.Tags

> StdUnit.Tags 是一套面向工业硬件交互场景的 .NET 类库（net8.0，MIT，跨平台）。它把「通道 + 测点 + 逻辑」组织成一个**测点项目**，并以类似 PLC 的**串行轮询**方式运行：每轮依次执行【执行意图 → 读取输入 → 处理逻辑 → 刷写输出】。入口之间并行，入口内部严格串行。

给 AI 的提示：**优先读下面第一份**。它是自包含的事实清单，含铁律、API / XML 速查、可直接抄的任务配方，以及「报错信息 → 病因」对照表。

## AI 参考手册（首选）

- [AI 参考手册 · 原始 Markdown](https://tags.doc.stdunit.com/assets/999.AI.markdown): 约 800 行。含铁律 M1–M14、核心 API 签名、XML 属性默认值与报错文案、7 个驱动的地址语法、8 个任务配方、故障排查表，以及 AOT / 裁剪宿主的注意事项。**机器可读，推荐直接抓取这一份。**
- [AI 参考手册 · 网页版](https://tags.doc.stdunit.com/assets/999.AI.html): 同一内容的 HTML 渲染版，带目录与站内搜索，适合人读。

## 教程（面向人）

- [教程入口](https://tags.doc.stdunit.com/): Chapter 1 起步 ~ Chapter 10 访问者模式（设计动机、概念的由来与综合练习），外加 Chapter 11 ~ 14 的驱动专题（SimpleFiles / S7 / OpcUa / ModbusTcp）与部署专题（AOT 支持）。
- [整站单页版](https://tags.doc.stdunit.com/print.html): 所有章节合并为一页，便于一次性阅读或抓取。

## 相关

- [类库源码仓库](https://github.com/StdUnit/StdUnit.Tags): 本文档所述的实现。仓库根目录的 `AGENTS.md` 面向在该仓库内编码的 AI 代理。
- [S7 模拟器](https://github.com/StdUnit/S7SvrSim): 无需真实 PLC 即可做端到端验证，便于编写自动化测试。