发布装配的特征校验与父链核对
版本号提交一度落在旧基线，装配阶段的特征检查——制品必须包含新功能标识——在生产切换前将其拦下。发布前实测提交父链，不轻信同步命令的输出。
查看工程说明
每次发布固定制品哈希并保留回退版本。父链核对通过后才允许装配与切换，异常制品直接丢弃重建，生产不受影响。
RECENT / LOG
近期工程记录
以下内容只保留可复用的工程结论。项目名称、客户信息、部署地址和业务数据均不公开。
8 条记录
在线预览的类型白名单
预览只对 PDF、位图与纯文本开放内联渲染；HTML 与 SVG 可携带脚本、Office 文档无原生查看器，一律强制附件下载。可见性与下载同口径，不可见与不存在同样返回 404。
查看工程说明
预览入口只对可预览类型出现，避免把用户引导到无法安全渲染的内容。下载改为流式分块并显示实时进度。
流式中转的内存边界与并发闸
下载网关以流式方式中转远端文件，内存占用与文件大小无关；并发上限满载时快速返回 429，而不是排队拖垮上游。
查看工程说明
审计记录实际送出的字节数，中断按独立口径落库。网关全程不落盘、不缓存，单文件规模受远端内存与带宽约束限制。
工具 API 的能力边界与审计要求
新增工具接口前，先定义调用主体、授权范围、数据访问级别和失败语义。只读查询与写操作分离，敏感能力由服务端鉴权并记录审计事件。
查看工程说明
接口不能绕过既有业务规则，也不能通过错误响应、日志或导出文件泄露超出权限的数据。能力范围应由后端控制，调用端只负责提出请求。
批量处理中的候选保留与逐行确认
批量导入不应将多来源结果压缩为单一结论。系统保留来源、版本和失败状态，冲突项并列展示；未完成业务确认的记录不得进入正式输出。
查看工程说明
技术匹配只能生成候选，不能替代业务决策。系统负责整理证据、维持行级状态，并在结果不完整时阻断导出。
增量归档的证据链与一致性校验
归档流程先识别新增或变化文件，再依据正文内容判断类型和版本。提交前生成变更计划，提交后核对清单、目标路径和 SHA-256。
查看工程说明
文件名和目录只能作为线索，不能作为分类证据。来源不明确时保持待确认；归档采用复制操作，源文件维持只读。
定时任务的幂等与状态恢复
调度记录必须持久化，并区分已认领、已执行、待确认和失败状态。进程重启后沿用原状态，不能根据文件是否存在直接推断是否需要重试。
查看工程说明
补偿流程先核对当前版本副本和历史记录。证据足以确认成功时只修正状态，不重复执行外部动作；证据不足则进入人工确认。
按变更范围实施最小化发布
发布范围应与代码变更保持一致。前端修复只替换前端制品，服务端、数据库和网络配置保持不变，除非变更证据明确涉及这些组件。
查看工程说明
发布前固定制品版本并备份配置，完成与改动直接相关的健康检查。回退步骤和目标版本在发布前确定。
PROJECT / INDEX
项目导航
我维护的项目各设独立介绍页，含项目说明、使用入口与下载地址。 全部项目
CURRENT / WORK
当前工程方向
工作重点是将高风险业务流程中的边界、状态和验证标准落实到系统实现，而不是单纯增加功能数量。
01
WORKFLOW SYSTEMS
业务系统与受控工作流
设计并实现查询、批量导入、候选核对与受控导出；近期扩展到资料在线预览、流式下载网关与实时目录浏览。业务规则集中维护，前后端权限一致，正式输出可追溯到数据来源和操作记录。
- 来源与版本追踪
- 行级人工确认
- 不完整状态阻断
02
DESKTOP AUTOMATION
Windows 桌面自动化
实现定时任务、文件识别、异常提醒与安装升级。通过持久化状态和幂等逻辑，控制重复执行、崩溃恢复和版本升级期间的数据连续性。
- 幂等调度与并发控制
- 异常状态持久化
- 升级数据兼容
03
DOCUMENT ENGINEERING
文档与表格工程
将模板、表格、扫描件和交付文档纳入可重复执行的处理流程。结构解析与视觉渲染结合，核对模板继承、分页、字段来源和文件一致性。
- 结构化解析与 OCR
- 渲染和逐页检查
- 来源与哈希校验
WORKING / RULES
工程准则
这些准则用于约束实现和交付，也用于判断一个功能是否真正完成。
- 01
证据不足时不推断
缺少来源的字段保持待确认，冲突结果同时保留。系统不替代业务责任人作最终判断。
- 02
验证范围与变更范围一致
测试、关键响应、视觉检查和文件哈希随版本保存，并覆盖本次改动可能影响的接口与数据。
- 03
缩小公开面与权限面
不收集非必要数据，不开放非必要接口。运行权限、网络访问和依赖来源均采用最小范围。
- 04
回退方案属于交付内容
变更生产状态前明确备份、恢复步骤和验证方法。无法回退的操作必须单独评估和确认。
ABOUT / 3SOFT
工程实践与技术记录
我从事业务系统、桌面自动化和文档工程相关开发，关注需求到交付之间容易被忽略的部分，包括权限模型、数据来源、异常处理和部署回退。 本站记录可公开的工程方法与实现思路，不包含客户材料、生产配置或内部截图。