Repository navigation
Expand file tree
/
Copy pathatom.xml
More file actions
202 lines (108 loc) · 28 KB
/
Copy pathatom.xml
File metadata and controls
202 lines (108 loc) · 28 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
<title>Sunkejava's Blog</title>
<subtitle>让软件真正连接业务、设备与现实世界</subtitle>
<link href="https://www.sunkejava.com/atom.xml" rel="self"/>
<link href="https://www.sunkejava.com/"/>
<updated>2026-08-27T17:21:45.450Z</updated>
<id>https://www.sunkejava.com/</id>
<author>
<name>Sunke</name>
</author>
<generator uri="https://hexo.io/">Hexo</generator>
<entry>
<title>2026 技术实践回顾:基础平台、电子墨水屏与本地 AI</title>
<link href="https://www.sunkejava.com/2026/08/27/2026-engineering-focus/"/>
<id>https://www.sunkejava.com/2026/08/27/2026-engineering-focus/</id>
<published>2026-08-27T13:00:00.000Z</published>
<updated>2026-08-27T17:21:45.450Z</updated>
<content type="html"><![CDATA[<p>2026 年公开项目的重点可以归纳为三个方向:构建可复用的基础平台、让电子墨水屏具备完整服务能力,以及把本地 AI 接入真实工程流程。</p><span id="more"></span><h2 id="基础平台:减少重复开发"><a href="#基础平台:减少重复开发" class="headerlink" title="基础平台:减少重复开发"></a>基础平台:减少重复开发</h2><p><a href="https://github.com/sunkejava/MyBaseSystem">MyBaseSystem</a> 把通用后台能力重新按 DDD 与 Clean Architecture 组织。这里关注的不是再做一套用户角色页面,而是建立后续项目都能遵守的边界、接口规范和目录结构。</p><h2 id="墨水屏:软硬件必须一起设计"><a href="#墨水屏:软硬件必须一起设计" class="headerlink" title="墨水屏:软硬件必须一起设计"></a>墨水屏:软硬件必须一起设计</h2><p><a href="https://github.com/sunkejava/crossmux">CrossMux</a> 负责设备侧中文阅读、文件同步和 MQTT 智能待机;<a href="https://github.com/sunkejava/AirPageSystem">AirPageSystem</a> 负责服务端数据、模板、预览、调度和设备推送。两者把频繁变化的模板与数据留在服务端,把低功耗显示和必要校验留在设备端。</p><p>这种分工同样适用于其他资源受限设备:服务端承担复杂计算,设备端保持协议简单、状态明确、失败可恢复。</p><h2 id="本地-AI:性能只是一个维度"><a href="#本地-AI:性能只是一个维度" class="headerlink" title="本地 AI:性能只是一个维度"></a>本地 AI:性能只是一个维度</h2><p>本地大模型、YOLO、OCR 和 TTS 的实践让 AI 从在线接口变成可以控制的基础能力,但工程问题也随之增加:显存与上下文如何分配、长文档怎样分块、推理速度为什么随上下文下降、模型输出怎样进入有状态任务,以及失败后如何续跑。</p><p>真正可用的 AI 系统需要模型之外的任务队列、数据版本、进度、日志、人工确认和结果校验。Agent 也不应该获得无限权限,而应通过明确工具完成可审计操作。</p><h2 id="三个方向的共同点"><a href="#三个方向的共同点" class="headerlink" title="三个方向的共同点"></a>三个方向的共同点</h2><p>看似不同的项目最终都指向同一组原则:</p><ol><li>用明确边界隔离变化;</li><li>用状态和证据替代盲目重试;</li><li>把安全与恢复设计进正常流程;</li><li>先完成真实闭环,再提炼可复用能力;</li><li>让自动化减少重复劳动,而不是隐藏错误。</li></ol><p>这些原则会继续成为后续项目的技术主线。</p>]]></content>
<summary type="html">按公开项目梳理 2026 年的三个工程方向,以及它们背后共同的设计原则。</summary>
<category term="项目复盘" scheme="https://www.sunkejava.com/categories/%E9%A1%B9%E7%9B%AE%E5%A4%8D%E7%9B%98/"/>
<category term="DotNet10" scheme="https://www.sunkejava.com/tags/DotNet10/"/>
<category term="Embedded" scheme="https://www.sunkejava.com/tags/Embedded/"/>
<category term="LocalAI" scheme="https://www.sunkejava.com/tags/LocalAI/"/>
</entry>
<entry>
<title>MyBaseSystem:用 DDD 与整洁架构构建可复用的 .NET 10 基础系统</title>
<link href="https://www.sunkejava.com/2026/08/27/my-base-system-ddd-clean-architecture/"/>
<id>https://www.sunkejava.com/2026/08/27/my-base-system-ddd-clean-architecture/</id>
<published>2026-08-27T12:30:00.000Z</published>
<updated>2026-08-27T17:21:45.450Z</updated>
<content type="html"><![CDATA[<p><a href="https://github.com/sunkejava/MyBaseSystem">MyBaseSystem</a> 的目标,是把登录、用户、角色、权限、菜单、审计和基础配置等重复工作沉淀为长期复用的平台。前端基于 Vue 3 Monorepo,后端使用 .NET 10、DDD 与 Clean Architecture。</p><span id="more"></span><h2 id="通用系统最容易变成“大杂烩”"><a href="#通用系统最容易变成“大杂烩”" class="headerlink" title="通用系统最容易变成“大杂烩”"></a>通用系统最容易变成“大杂烩”</h2><p>基础系统功能多、关联广,很容易让控制器直接访问数据库,让权限判断散落在页面和接口里,最终每次复用都需要大幅裁剪。真正的复用不是拥有更多公共方法,而是拥有稳定的边界。</p><p>后端依赖方向始终指向内层:</p><figure class="highlight text"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><code class="hljs text">Api -> Application -> Domain<br>Infrastructure -> Application / Domain<br></code></pre></td></tr></table></figure><p>Domain 不依赖 EF Core 或 ASP.NET Core;Application 编排用例并定义端口;Infrastructure 实现存储、JWT 和外部服务;Api 只负责 HTTP 映射、认证与统一响应。</p><h2 id="前后端目录必须明确分离"><a href="#前后端目录必须明确分离" class="headerlink" title="前后端目录必须明确分离"></a>前后端目录必须明确分离</h2><p>所有前端代码放在 <code>frontend/</code>,所有 .NET 解决方案、源码和测试放在 <code>backend/</code>。这不是单纯为了目录美观,而是为了让工具链、依赖缓存、容器构建和 CI 任务拥有清晰作用域。</p><p>前端业务应用与通用组件继续分层;后端则按照领域、应用、基础设施和 API 分层。一个新业务模块应作为限界上下文接入,而不是继续向 SystemService 中堆方法。</p><h2 id="权限是服务端契约"><a href="#权限是服务端契约" class="headerlink" title="权限是服务端契约"></a>权限是服务端契约</h2><p>菜单用于导航,权限码用于授权,两者不能混为一谈。权限采用 <code>领域:资源:动作</code> 的形式,例如 <code>system:user:update</code>。前端可以据此隐藏按钮,但服务端仍必须执行最终授权。</p><p>用户获得角色后,菜单树应从权限结果动态生成;角色维护则同时展示菜单名称和代码,避免配置人员面对无法理解的标识符。</p><h2 id="开箱即用与生产安全之间的平衡"><a href="#开箱即用与生产安全之间的平衡" class="headerlink" title="开箱即用与生产安全之间的平衡"></a>开箱即用与生产安全之间的平衡</h2><p>SQLite 和管理员种子数据让项目可以快速启动,但生产环境必须更换 JWT 密钥和初始密码,并按目标数据库增加 Infrastructure Provider。领域层和应用层不应因为数据库从 SQLite 切换到 PostgreSQL 或 SQL Server 而改变。</p><p>基础系统的价值不在于功能列表有多长,而在于新项目接入后能否继续保持边界清楚、行为可测试、升级可控。</p>]]></content>
<summary type="html">说明通用后台为什么仍需要清晰边界,以及 MyBaseSystem 如何组织前后端目录、权限和模块扩展。</summary>
<category term=".NET" scheme="https://www.sunkejava.com/categories/NET/"/>
<category term="DotNet10" scheme="https://www.sunkejava.com/tags/DotNet10/"/>
<category term="Vue3" scheme="https://www.sunkejava.com/tags/Vue3/"/>
<category term="DDD" scheme="https://www.sunkejava.com/tags/DDD/"/>
<category term="CleanArchitecture" scheme="https://www.sunkejava.com/tags/CleanArchitecture/"/>
</entry>
<entry>
<title>AirPageSystem:从一张图片到可运营的墨水屏推送平台</title>
<link href="https://www.sunkejava.com/2026/08/26/airpage-system-design/"/>
<id>https://www.sunkejava.com/2026/08/26/airpage-system-design/</id>
<published>2026-08-26T12:00:00.000Z</published>
<updated>2026-08-27T17:21:45.450Z</updated>
<content type="html"><![CDATA[<p><a href="https://github.com/sunkejava/AirPageSystem">AirPageSystem</a> 基于 .NET 10 与 Vue 3,用于采集行情、服务器状态和自定义 JSON 数据,生成适合电子墨水屏的图片并按计划推送。</p><span id="more"></span><h2 id="推送图片只是最后一步"><a href="#推送图片只是最后一步" class="headerlink" title="推送图片只是最后一步"></a>推送图片只是最后一步</h2><p>一个可长期使用的平台至少需要处理数据源、模板、预览、设备、计划任务、权限、历史记录和失败重试。如果这些能力直接写在一个定时方法里,新增一种面板就会牵动整个系统。</p><p>项目将流程拆成稳定的几个阶段:采集数据、标准化模型、模板渲染、设备格式编码、推送、记录结果。新增数据源或模板时,只需要扩展相应阶段。</p><h2 id="墨水屏格式是硬约束"><a href="#墨水屏格式是硬约束" class="headerlink" title="墨水屏格式是硬约束"></a>墨水屏格式是硬约束</h2><p>目标设备使用 528×792、四级灰度和 2-bit BMP,并有文件大小限制。普通浏览器预览图即使看起来正确,也不代表固件一定能解码。</p><p>因此系统同时生成用于预览的 PNG 与固件兼容 BMP,并在推送前检查尺寸、调色板、位深、扫描方向和大小。格式校验必须位于服务端边界,不能把错误文件发送后再依赖设备兜底。</p><h2 id="调度系统要留下执行证据"><a href="#调度系统要留下执行证据" class="headerlink" title="调度系统要留下执行证据"></a>调度系统要留下执行证据</h2><p>Cron 到点未执行通常不是一句“调度器有问题”就能解释。任务可能被禁用、时区错误、进程当时未运行、前一次仍在执行,或者执行了但在数据采集阶段失败。</p><p>可靠调度至少应记录计划时间、实际开始时间、完成时间、触发来源、执行节点、状态和错误摘要。测试执行与计划执行应复用同一条执行管线,避免“测试正常、定时失败”成为两个不同系统。</p><h2 id="自定义能力需要安全边界"><a href="#自定义能力需要安全边界" class="headerlink" title="自定义能力需要安全边界"></a>自定义能力需要安全边界</h2><p>允许用户配置 HTTP JSON 数据源会引入 SSRF 风险。系统默认禁止访问环回和 RFC1918 私网,只有明确配置后才允许局域网监控。模板使用受限映射,而不是执行任意脚本。</p><p>可扩展并不等于无限执行能力。好的模板系统应该允许用户组合数据和布局,同时保持网络、凭据和代码执行边界可控。</p>]]></content>
<summary type="html">解析 AirPageSystem 的模板、数据源、设备、定时任务和灰度图编码边界。</summary>
<category term=".NET" scheme="https://www.sunkejava.com/categories/NET/"/>
<category term="DotNet10" scheme="https://www.sunkejava.com/tags/DotNet10/"/>
<category term="Vue3" scheme="https://www.sunkejava.com/tags/Vue3/"/>
<category term="EInk" scheme="https://www.sunkejava.com/tags/EInk/"/>
<category term="Scheduler" scheme="https://www.sunkejava.com/tags/Scheduler/"/>
</entry>
<entry>
<title>CrossMux:给小型墨水屏阅读器增加中文、同步与智能待机</title>
<link href="https://www.sunkejava.com/2026/08/25/crossmux-embedded-eink/"/>
<id>https://www.sunkejava.com/2026/08/25/crossmux-embedded-eink/</id>
<published>2026-08-25T12:00:00.000Z</published>
<updated>2026-08-27T17:21:45.450Z</updated>
<content type="html"><![CDATA[<p><a href="https://github.com/sunkejava/crossmux">CrossMux</a> 是基于 CrossPoint Reader 演进的社区固件,面向 ESP32-C3 的 Xteink X3/X4。项目目标不是简单增加几个菜单,而是在有限内存、存储、刷新速度和电量预算下,让设备具备更完整的中文阅读与联网能力。</p><span id="more"></span><h2 id="中文支持不是替换几段文案"><a href="#中文支持不是替换几段文案" class="headerlink" title="中文支持不是替换几段文案"></a>中文支持不是替换几段文案</h2><p>电子书中的中文涉及字体体积、字形缓存、换行规则和渲染速度。固件需要在 Flash、内存和排版质量之间取舍:字体不能无限增大,文本布局不能假设以空格断词,刷新区域也要尽量稳定。</p><p>因此中文化的核心是把 CJK 当作排版能力,而不是只把 UI 字符串翻译为中文。</p><h2 id="文件同步要避免留下半文件"><a href="#文件同步要避免留下半文件" class="headerlink" title="文件同步要避免留下半文件"></a>文件同步要避免留下半文件</h2><p>1.5.8 引入自托管同步服务。设备根据 SHA-256 跳过未变化文件,并使用临时文件和备份文件完成替换。这个设计解决的不是“怎样下载”,而是弱网络和断电条件下怎样保证文件系统仍然一致。</p><p>服务端使用 .NET 提供上传、清单和下载能力;固件端负责增量判断、安全落盘和目录约束。职责边界清晰后,两端都更容易测试。</p><h2 id="MQTT-智能待机的正确边界"><a href="#MQTT-智能待机的正确边界" class="headerlink" title="MQTT 智能待机的正确边界"></a>MQTT 智能待机的正确边界</h2><p>1.5.9 的智能待机由服务端生成天气、行情、歌词或自定义数据面板,设备通过 MQTT 接收更新。选择服务端渲染而不是让固件解释复杂模板,有三个原因:</p><ol><li>固件内存有限,不适合承载完整排版引擎;</li><li>模板和数据源变化频繁,服务端升级成本更低;</li><li>最终位图可在推送前预览和校验,降低设备端失败概率。</li></ol><p>设备端仍需处理断线重连、消息去重、图片校验和睡眠策略。网络功能不能无限阻止自动休眠,持续连接失败也必须主动让出资源。</p><h2 id="桌面模拟器的价值"><a href="#桌面模拟器的价值" class="headerlink" title="桌面模拟器的价值"></a>桌面模拟器的价值</h2><p>墨水屏设备编译、烧录和刷新都比普通 Web 调试慢。桌面模拟器让菜单布局、输入逻辑和部分渲染可以在主机上快速验证,把硬件测试集中到真正依赖设备的环节。这是嵌入式项目提升迭代速度最有效的工程投入之一。</p>]]></content>
<summary type="html">复盘 CrossMux 如何在资源受限的 ESP32-C3 墨水屏设备上组织中文阅读、文件同步和 MQTT 智能待机。</summary>
<category term="嵌入式" scheme="https://www.sunkejava.com/categories/%E5%B5%8C%E5%85%A5%E5%BC%8F/"/>
<category term="EInk" scheme="https://www.sunkejava.com/tags/EInk/"/>
<category term="CrossMux" scheme="https://www.sunkejava.com/tags/CrossMux/"/>
<category term="ESP32" scheme="https://www.sunkejava.com/tags/ESP32/"/>
<category term="MQTT" scheme="https://www.sunkejava.com/tags/MQTT/"/>
</entry>
<entry>
<title>远程 USB 连接为什么难:一条可观测链路的设计方法</title>
<link href="https://www.sunkejava.com/2026/07/12/remote-usb-diagnostics/"/>
<id>https://www.sunkejava.com/2026/07/12/remote-usb-diagnostics/</id>
<published>2026-07-12T12:00:00.000Z</published>
<updated>2026-08-27T17:21:45.450Z</updated>
<content type="html"><![CDATA[<p>远程 USB 最难处理的不是正常连接,而是偶发失败:同样的设备、相同的指令和相近的网络条件,有时几秒成功,有时一直停在“可见但不可用”。要解决这类问题,首先需要停止把整条链路看成一个接口调用。</p><span id="more"></span><h2 id="五层检查模型"><a href="#五层检查模型" class="headerlink" title="五层检查模型"></a>五层检查模型</h2><h3 id="1-硬件与供电层"><a href="#1-硬件与供电层" class="headerlink" title="1. 硬件与供电层"></a>1. 硬件与供电层</h3><p>确认端口上电状态、工作电压、电流、过流标志和 Hub 上游连接。多个端口同时启动时应分批上电,避免瞬时压降导致整个 Hub 重新枚举。</p><h3 id="2-Windows-枚举层"><a href="#2-Windows-枚举层" class="headerlink" title="2. Windows 枚举层"></a>2. Windows 枚举层</h3><p>使用设备实例 ID、父子拓扑和问题码判断设备是否完成枚举。只按 VID/PID 匹配不够,因为多个同型号设备可能共享这些字段。</p><h3 id="3-共享服务层"><a href="#3-共享服务层" class="headerlink" title="3. 共享服务层"></a>3. 共享服务层</h3><p>检查服务是否运行、枚举列表是否刷新、目标设备是否空闲,以及服务看到的地址是否稳定。这里要区分“服务无响应”和“服务响应但没有设备”。</p><h3 id="4-网络与映射层"><a href="#4-网络与映射层" class="headerlink" title="4. 网络与映射层"></a>4. 网络与映射层</h3><p>记录 DNS、TCP、认证、设备绑定和客户端驱动创建各阶段耗时。网络延迟较低时,固定几秒等待往往来自应用策略或枚举稳定窗口,而不是链路 RTT。</p><h3 id="5-业务验证层"><a href="#5-业务验证层" class="headerlink" title="5. 业务验证层"></a>5. 业务验证层</h3><p>设备出现在设备管理器并不是终点。必须执行一个只读、低风险的业务探针,例如读取设备信息或发送协议握手,确认上层确实可用。</p><h2 id="状态机优于固定延时"><a href="#状态机优于固定延时" class="headerlink" title="状态机优于固定延时"></a>状态机优于固定延时</h2><p>每一阶段都应包含进入条件、成功条件、软超时、硬超时和恢复策略。固定 <code>Task.Delay(3000)</code> 无法解释为什么等三秒,也无法在设备提前就绪时缩短耗时。</p><p>建议为一次连接生成统一 <code>CorrelationId</code>,把硬件控制、Windows 事件、服务日志、客户端日志和业务响应关联起来。这样才能回答“慢在哪里”,而不只是知道“最后失败了”。</p><h2 id="自动恢复的边界"><a href="#自动恢复的边界" class="headerlink" title="自动恢复的边界"></a>自动恢复的边界</h2><p>自动恢复应从轻到重:重新查询、刷新枚举、释放占用、重启单设备、端口断电重启,最后才考虑重启服务或主机。每一级都要限制次数并设置冷却时间。连续失败后应停止自动操作并告警,避免把原本局部的异常扩大成整机 USB 风暴。</p><p>远程 USB 的稳定性不是靠更多重试获得的,而是靠更细的状态、更准确的证据和有边界的恢复策略获得的。</p>]]></content>
<summary type="html">将远程 USB 从单次调用拆成设备供电、枚举、服务发现、网络映射和业务验证五层状态机。</summary>
<category term="USB与硬件" scheme="https://www.sunkejava.com/categories/USB%E4%B8%8E%E7%A1%AC%E4%BB%B6/"/>
<category term="Windows" scheme="https://www.sunkejava.com/tags/Windows/"/>
<category term="USB" scheme="https://www.sunkejava.com/tags/USB/"/>
<category term="USBIP" scheme="https://www.sunkejava.com/tags/USBIP/"/>
<category term="Diagnostics" scheme="https://www.sunkejava.com/tags/Diagnostics/"/>
</entry>
<entry>
<title>从 Windows 工具到远程设备链路:2022—2024 的系统集成实践</title>
<link href="https://www.sunkejava.com/2024/12/31/2022-2024-windows-usb-network-road/"/>
<id>https://www.sunkejava.com/2024/12/31/2022-2024-windows-usb-network-road/</id>
<published>2024-12-31T12:00:00.000Z</published>
<updated>2026-08-27T17:21:45.450Z</updated>
<content type="html"><![CDATA[<p>进入系统集成领域后,问题不再只发生在应用进程内部。一次远程设备连接可能依次经过业务服务、网络、硬件控制器、USB Hub、Windows PnP、设备驱动和客户端映射,任何节点异常都会表现为“设备连不上”。</p><span id="more"></span><h2 id="网络可达不等于设备可用"><a href="#网络可达不等于设备可用" class="headerlink" title="网络可达不等于设备可用"></a>网络可达不等于设备可用</h2><p><a href="https://github.com/sunkejava/SuperNAT">SuperNAT</a> 以及 USB/IP 相关仓库的研究,让我逐渐把“连接成功”拆成多层状态:</p><ul><li>TCP 或隧道是否建立;</li><li>远端服务是否能枚举设备;</li><li>Windows 是否完成驱动绑定;</li><li>设备接口是否进入可用状态;</li><li>客户端是否获得独占权并完成映射;</li><li>上层业务协议是否真正收到正确响应。</li></ul><p>只检查 Ping 或端口会制造大量误判。可靠系统必须给每一层定义可观测信号、超时和错误码。</p><h2 id="Windows-设备状态具有异步性"><a href="#Windows-设备状态具有异步性" class="headerlink" title="Windows 设备状态具有异步性"></a>Windows 设备状态具有异步性</h2><p>USB 上电后,PnP 枚举、驱动加载、接口创建和上层服务发现不是一个原子动作。设备管理器里出现名称,也不代表服务已经可以安全使用它。反过来,服务列表暂时缺少设备,也不一定意味着枚举最终失败。</p><p>因此链路控制不能堆固定延时,而应采用“状态轮询 + 总超时 + 稳定窗口”:只有关键状态连续满足一段时间,才进入下一步;失败时记录停在哪个节点,而不是只返回一个布尔值。</p><h2 id="恢复操作也可能失败"><a href="#恢复操作也可能失败" class="headerlink" title="恢复操作也可能失败"></a>恢复操作也可能失败</h2><p>禁用/启用设备、重启服务、释放串口和端口断电都属于恢复动作,但恢复动作本身可能阻塞、超时或引起设备重新编号。更安全的设计是:</p><ol><li>将可能卡住的系统调用隔离到独立进程;</li><li>给外层编排设置硬超时,超时后可终止隔离进程;</li><li>通过设备实例路径和硬件标识重新发现设备,不长期依赖 COM 号;</li><li>限制自动恢复频率,避免形成电源和枚举风暴;</li><li>保留操作前后的完整快照,方便定位真正原因。</li></ol><h2 id="形成链路化思维"><a href="#形成链路化思维" class="headerlink" title="形成链路化思维"></a>形成链路化思维</h2><p>这阶段最大的技术变化,是从“写一个控制设备的方法”转向“设计一条可验证、可恢复的连接状态机”。它后来也延伸到串口稳定性、MQTT 推送、定时任务和跨平台服务中:不要只关注成功路径,要把失败路径当作系统的一等公民。</p>]]></content>
<summary type="html">从网络穿透、USB/IP 与桌面工具出发,解释为什么系统集成的重点最终会落到完整链路和故障恢复。</summary>
<category term="项目复盘" scheme="https://www.sunkejava.com/categories/%E9%A1%B9%E7%9B%AE%E5%A4%8D%E7%9B%98/"/>
<category term="Windows" scheme="https://www.sunkejava.com/tags/Windows/"/>
<category term="USB" scheme="https://www.sunkejava.com/tags/USB/"/>
<category term="Networking" scheme="https://www.sunkejava.com/tags/Networking/"/>
</entry>
<entry>
<title>从 Web 到 .NET 桌面:2016—2021 公开仓库技术轨迹</title>
<link href="https://www.sunkejava.com/2021/12/31/2016-2021-public-repositories-review/"/>
<id>https://www.sunkejava.com/2021/12/31/2016-2021-public-repositories-review/</id>
<published>2021-12-31T12:00:00.000Z</published>
<updated>2026-08-27T17:21:45.450Z</updated>
<content type="html"><![CDATA[<p>GitHub 上最早的一批仓库始于 2016 年。现在回看,它们更像一份持续多年的技术实验记录:前端页面、播放器、博客主题、Java Web、CMS、爬虫、WPF 工具和 C# 公共类都曾是阶段性重点。</p><span id="more"></span><h2 id="2016:先把-Web-做出来"><a href="#2016:先把-Web-做出来" class="headerlink" title="2016:先把 Web 做出来"></a>2016:先把 Web 做出来</h2><p>早期项目集中在 HTML、JavaScript、Bootstrap、媒体播放、Hexo 和 Java Web。<code>FrontEndGuide</code>、<code>mediaelement</code>、<code>video.js</code>、<code>WebJava</code>、<code>WebDemo</code>、<code>cms</code> 等仓库反映了当时最直接的目标:快速理解页面、组件、后台和部署之间的完整关系。</p><p>这一阶段最大的收获并不是掌握了某个框架,而是形成了“可运行结果优先”的习惯。页面必须能打开,数据必须能展示,部署后必须能访问。后来做桌面、设备和服务端系统时,这个习惯仍然有效。</p><h2 id="2017—2019:从功能代码走向工具沉淀"><a href="#2017—2019:从功能代码走向工具沉淀" class="headerlink" title="2017—2019:从功能代码走向工具沉淀"></a>2017—2019:从功能代码走向工具沉淀</h2><p><a href="https://github.com/sunkejava/Common.Utility">Common.Utility</a> 汇总了文件、网络、序列化、加密、图像、文档、任务和扩展方法等常用能力。它代表了一个明显变化:不再满足于完成单个功能,而是开始考虑如何让代码在下一项目中复用。</p><p>同一时期的爬虫、音乐、定时器和桌面界面项目,则让网络请求、异步任务、UI 状态和异常处理逐渐成为日常问题。</p><h2 id="2020—2021:重点转向-C-、WPF-与-Windows"><a href="#2020—2021:重点转向-C-、WPF-与-Windows" class="headerlink" title="2020—2021:重点转向 C#、WPF 与 Windows"></a>2020—2021:重点转向 C#、WPF 与 Windows</h2><p>随着业务对桌面能力和系统集成的要求增加,技术重心逐步转向 C#/.NET。WPF 运行时检查、Inline Hook、桌面 UI 和各种 Windows 工具类,使关注点从“网页功能”扩展到进程、窗口、消息、系统 API 和运行时状态。</p><p>这段经历后来直接影响了几个长期方向:</p><ol><li>UI 自动化不能只依赖控件表面,需要理解窗口句柄、进程边界和可访问性树。</li><li>Windows API 调用必须考虑权限、超时和不可中断阻塞。</li><li>桌面软件的错误恢复比一次成功更重要。</li><li>公共能力要从复制代码升级为有边界、有测试、可观察的组件。</li></ol><h2 id="今天再看这些仓库"><a href="#今天再看这些仓库" class="headerlink" title="今天再看这些仓库"></a>今天再看这些仓库</h2><p>早期仓库使用的框架和写法并不都适合今天的新项目,但它们仍然有价值:它们解释了当前技术偏好从哪里来,也提醒我避免只追逐框架名称。真正长期有效的能力仍是问题拆解、边界识别、失败处理和完整交付。</p>]]></content>
<summary type="html">回看早期公开仓库,梳理从前端、Java Web 到 C#/.NET 和 Windows 桌面开发的技术迁移。</summary>
<category term="项目复盘" scheme="https://www.sunkejava.com/categories/%E9%A1%B9%E7%9B%AE%E5%A4%8D%E7%9B%98/"/>
<category term="Web" scheme="https://www.sunkejava.com/tags/Web/"/>
<category term="CSharp" scheme="https://www.sunkejava.com/tags/CSharp/"/>
<category term="WPF" scheme="https://www.sunkejava.com/tags/WPF/"/>
</entry>
</feed>