v1.5.0

v1.5.0 更新说明

本次版本包

包名	平台	说明
doc-optimizer-v1.5.0-win-x64.exe	Windows x64	NSIS 安装包
doc-optimizer-v1.5.0-win-arm64.exe	Windows ARM64	信创 ARM 平台
doc-optimizer-v1.5.0-x86_64.AppImage	Linux x64	AppImage 格式
doc-optimizer-v1.5.0-amd64.deb	Linux x64	Debian/Ubuntu 安装包
doc-optimizer-v1.5.0-x64.dmg	macOS x64	Intel Mac
doc-optimizer-v1.5.0-arm64.dmg	macOS ARM64	Apple Silicon Mac
doc-optimizer-portable.zip	Windows 通用	便携版（免安装）
backend_server.exe	Windows	后端服务（独立运行）
doc-optimizer-cli.exe	Windows	CLI 命令行工具

版记（末页）—— 完全符合 GB/T 9704-2012

• 分隔线：上下两条 0.35mm 黑色实线，与版心等宽
• 抄送机关：左空一字 + 悬挂缩进（回行与冒号后首字对齐），3号仿宋（16pt）
• 印发机关与印发日期：同一行，左空一字 + 右空一字，左右两端对齐
• 版记换页逻辑：末页剩余空间不足 30mm 时自动分页

页码

• 字体：4号半角宋体阿拉伯数字（14pt）
• 格式：一字线 — {PAGE} —，数字与一字线之间保留半字空格
• 奇偶页不同：奇数页（右页）居右空一字，偶数页（左页）居左空一字
• 位置：页码顶端距版心下边缘 7mm
• 单面打印：支持居中模式

版头

• 发文机关标志：方正小标宋简体 30pt 红色
• 发文字号+签发人：同行左右两端对齐（发文号左、签发人右），16pt 仿宋

模板规则

• 模板规则保存功能：支持前端编辑并保存检查规则
• 规则保存 API：PUT /api/templates/{template_id}/rules

SQLite 优化

• 启用 WAL 模式，提升并发读写性能
• 连接池配置（pool_size=5, max_overflow=10）
• SQLITE_BUSY 自动重试（指数退避）

其他改进

• 数据库定期备份机制
• 文件锁机制（多文档并发处理）
• 认证 Token 自动获取（前端启动时自动同步）
• 页码奇偶页设置（前端传参归一化 + settings.xml 文档级开关）
• CI 流程：添加 ruff（Python 代码检查）和 ESLint（前端代码检查）
• Release 流程：body_path 自动降级（文件不存在时生成默认说明）
• 表格定位修复：preview-download 保留 insert_after_index
• 解析/生成快照测试
• 关于页面：GitHub 版本检测提醒

vv1.4.9

Release Notes — v1.4.9

发布日期：2026-06-30

🎯 本次重点

包名统一为英文

所有分发包的文件名已统一为英文格式，不再包含中文字符：

包名	平台	说明
doc-optimizer-v1.4.9-win-x64.exe	Windows x64	NSIS 安装包
doc-optimizer-v1.4.9-win-arm64.exe	Windows ARM64	信创 ARM 平台
doc-optimizer-v1.4.9-x86_64.AppImage	Linux x64	AppImage 格式
doc-optimizer-v1.4.9-amd64.deb	Linux x64	deb 安装包
doc-optimizer-v1.4.9-x64.dmg	macOS x64	DMG 安装包
doc-optimizer-v1.4.9-arm64.dmg	macOS ARM64	Apple Silicon
doc-optimizer-v1.4.9-portable.zip	全平台	便携版（无需安装）

仓库清理

• 移除 Git 跟踪中的非必要文件（旧阶段报告、工具脚本、测试辅助文件等 40+ 文件）
• 重命名中文目录 公文模板/ → dotx_templates/
• 新增 .gitignore 规则，防止 Office 临时文件、构建产物、本地脚本被意外入库
• 新增 pre-commit 钩子，自动检测中文路径和禁止提交的文件类型
• 完善 CONTRIBUTING.md 提交规范

⚠️ 注意

本次发布为项目清理优化版本，功能与 v1.4.8 一致，仅包名和仓库结构优化。

v1.4.8: 编排功能全面修复+GB/T 9704合规增强

Release Notes — v1.4.8

发布日期：2026-06-30

🎯 本次重点

编排功能全面修复

• 修复版头/版记不应用到下载文档的问题（optimize_document 路径无注入逻辑）
• 修复版头段落顺序错误（机关名→空行→字号→签发人→红线）
• 修复 RED_LINE / BLACK_LINE 占位符文字出现在文档中
• 修复表格位置丢失（新增 source_doc_id 传递源文档结构）
• 修复下载按钮闭包捕获旧配置值（config → configRef.current）
• 修复缓存数据丢失（三重缓存：模块级Map + sessionStorage + localStorage）

GB/T 9704 标准合规增强

• 修正标题行距：28.95pt → 33pt（标题/一级/二级/三级标题）
• 添加页脚距离：2.5cm（GB/T 9704 标准）
• 新增 8 条检查规则 + 8 条修复规则（标题行距、标题缩进、落款字体）
• 检查规则从 31 条提升至 39 条，修复规则从 25 条提升至 33 条

格式增强

• 表格智能对齐：表头居中加粗、数字右对齐、序号列居中、短文本居中
• 内联标题分割：标题+正文同段落时自动拆分
• 附件分页标记：附件前自动插入分页符
• 空行处理三模式：keep_all / delete_single / keep_single
• CLI 接口：支持 format / check / optimize 子命令

安全加固

• 添加 Bearer Token 认证中间件
• 修复路径遍历漏洞（office.py / manager.py / style_manager.py）
• 修复错误信息泄露内部路径（所有路由文件）
• 修复加密密钥文件权限（0600）
• 修复 datetime.utcnow() 废弃警告
• 修复文件上传竞态条件（UUID 前缀）

前端优化

• 启用 TypeScript strict 模式
• 修复 9 个页面的 AbortController 缺失
• 修复 A4PageRenderer useMemo 失效
• 修复 apiClient 类型安全（移除 as any）
• 修复 setTimeout 泄漏（DocumentProcess / ImportTemplate）
• 修复 Map 无限增长（MarkdownOptimize）
• 添加 Electron sandbox 模式
• 日志 RotatingFileHandler（10MB, 5 备份）

后端资源管理

• AI Provider 添加 async context manager（__aenter__/__aexit__）
• Office Bridge 临时文件清理（BackgroundTask）
• 规则引擎缓存失效机制
• 模型健康检测非阻塞（asyncio.to_thread）

📦 本次版本包

包名	平台	说明
doc-optimizer-v1.4.8-win-x64.exe	Windows x64	NSIS 安装包
doc-optimizer-v1.4.8-win-arm64.exe	Windows ARM64	信创 ARM 平台
AI.-1.4.8-x86_64.AppImage	Linux x64	AppImage 格式
AI.-1.4.8-amd64.deb	Linux x64	deb 安装包
AI.-1.4.8.dmg	macOS x64	DMG 安装包
AI.-1.4.8-arm64.dmg	macOS ARM64	Apple Silicon
doc-optimizer-v1.4.8-portable.zip	全平台	便携版（无需安装）
backend_server.exe	Windows	后端服务
doc-optimizer-cli.exe	Windows	CLI 工具

🔧 技术变更

后端变更文件（26个）

• main.py, auth.py, optimize.py, ai.py, check.py, documents.py, office.py, templates.py
• settings.py, template_download.py, api_models.py, ai_structure_analyzer.py
• converter.py, generator.py, modifier.py, structure_analyzer.py
• checker.py, engine.py, fixer.py, manager.py, style_manager.py
• models.py, document_service.py, model_health.py, crypto.py, logger.py
• 新增: wfp_cli.py

前端变更文件（24个）

• A4PageRenderer.tsx, client.ts, main.tsx, A4Preview.tsx, AISettings.tsx
• CheckCenter.tsx, DocumentProcess.tsx, EnhancedA4Preview.tsx
• ImportTemplate.tsx, Rules.tsx, TemplateRules.tsx, Templates.tsx
• Workspace.tsx, tsconfig.app.json, ai-status.ts, useDocumentConfig.tsx
• download.ts, electron/main.ts, RightPanel.tsx, Sidebar.tsx
• App.tsx, MarkdownOptimize.tsx, main.tsx

规则变更（1个）

• rules/official/_common.yaml（+119 行）

📊 统计

• 测试通过率：88/98（90%），10 个失败均为预存问题
• TypeScript 编译：零错误
• Vite 构建：1.13 秒
• 代码变更：52 个文件，+2694 行，-1293 行

⚠️ 已知限制

• AI 集成测试需要配置 API Key 才能运行
• Electron 打包需要 PyInstaller 环境
• 信创平台（银河麒麟/统信）需要预装 LibreOffice 用于 .doc/.wps 转换

v1.4.7: Xinchuang Cross-Platform Support

Xinchuang Cross-Platform Support (Phase 1)

Linux Support

• converter.py: LibreOffice headless for .doc/.wps conversion on Linux
• Electron main.ts: Cross-platform backend binary path (no .exe hardcode)
• Icon: Unified icon.png for all platforms
• Build: AppImage + deb targets for Linux x86_64 and ARM64

Build Scripts

• electron:build:linux (x86_64)
• electron:build:linux:arm64 (Kunpeng/Phytium)
• build_backend.py: Platform-aware binary suffix

Supported Platforms

Platform	Package	Status
Windows x64	NSIS Setup .exe	Ready
Linux x64 (UOS/Kylin)	AppImage / deb	Build command ready, needs Linux env
Linux ARM64 (Kunpeng)	AppImage / deb	Build command ready, needs Linux env
macOS (future)	dmg	Target configured

Download

• Windows: AI公文智能优化助手 Setup 1.4.7.exe (below)
• Linux: Run
  pm run electron:build:linux on Linux machine

v1.4.6: table positioning + bold range fix + run-level rendering

table positioning + bold range fix + run-level rendering + parser EMU fix + code audit fixes

v1.4.5: 预览下载修复 + Markdown表格端到端修复

预览下载修复

• 新增 API: POST /api/optimize/preview-download — 从前端预览数据（段落+表格）实时生成 docx
• 下载按钮重构: EnhancedA4Preview 不再依赖 /api/optimize/{id}/download（需先优化），直接从当前预览状态生成文件
• WYSIWYG: 下载时传递前端配置的页边距给生成器

Markdown 表格端到端修复

• 端到端验证：markdown |方案|航线组合|... → 4x6 表格完整写入 docx
• 表格从 paragraphs 分离 → 存入 Table 对象 → 生成 docx 表格 → 下载完整保留

v1.4.4: AI模型监控 + Markdown表格修复 + 全量版权注释

AI 模型可用性定时检测

• 后台每 60s 自动检测所有已配置 AI provider 的可用性
• GET /api/ai/status 端点返回在线状态和响应延迟
• AI 配置页面实时显示模型状态卡片（在线/离线/延迟ms）
• 支持 OpenAI 兼容接口 + Anthropic Claude 专用检测

Markdown 表格转换修复

• 根因：/convert-markdown API 只返回 paragraphs，tables 数据丢失
• 修复：API 响应新增 tables 字段，完整序列化 Table/TableCell
• A4 预览支持渲染 markdown 表格（边框、表头加粗、单元格 padding）

全量版权注释

• 所有 Python (.py) 和 TypeScript (.tsx/.ts) 文件统一添加 MIT 版权头
• 标准化格式：(c) 2026 Jose AI (https://www.linhut.cn)
• 以后新建代码文件必须添加版权注释

其他

• 完整发版流程记录到 build-process 记忆
• README 功能描述新增 A4实时预览、Markdown转公文、AI模型监控、格式提取器

v1.4.3: A4预览版头国标对齐 + 版头智能检测

A4 预览版头格式与国标对齐（参考 gongwen 项目数值）

• 发文机关标志: 22pt→30pt, #CC0000→**#E00000**, letterSpacing: 3pt→0
• 版头→标题间距: 空二行 (lineSpacing×2pt)
• 红色反线颜色: #CC0000→**#E00000**, 上方紧凑间距 4pt

A4PreviewModal 增强

• 版头智能检测 — 通过红色文本自动识别发文机关标志
• 发文字号检测 — 正则匹配 X发〔YYYY〕N号 标准格式
• 版记检测 — 通过
  ole=cc 自动识别抄送段落
• 后端 preview API 新增 �old、color 字段

空行渲染优化

• 空段落紧凑渲染: line-height 0.6 + minHeight 限制
• A4PreviewModal 与 EnhancedA4Preview 空行处理完全一致

字体映射统一 + 页码修正

• FONT_MAP 补全: 两个组件映射完全一致
• 页码字号: 10pt→14pt（四号字），字体改为宋体优先
• 版记: 抄送左空一字，印发机关/日期缩进

其他

• 网页访问按钮显示前端访问端口 5173（非后端 8765）

v1.4.1

v1.4.1 — 预览空白修复 + 规则引擎按类型优化 + 安全加固

预览修复（P0）

• A4PreviewModal 错误处理：catch 块不再静默吞错，显示错误 + 重试按钮
• 空段落状态：A4Preview/A4PreviewModal 均增加空数据判断
• 路径解析增强：preview/download 端点增加 OUTPUT_DIR 文件名回退查找

规则引擎按文档类型优化（P0）

• 22 个 YAML 规则文件清理：移除与 _common.yaml 重复的格式规则
• manager.py 去重合并：按 field/target+action 去重，不再产生重复检查
• heading_1 对齐修正：center → left（GB/T 9704 左空二字）
• 补充页码格式检查规则（CHK-C023/C024）
• 文档类型自动检测：upload 按文件名关键词推断类型

安全修复（P0）

• API Key 环境变量化：源码不再包含明文密钥
• CORS 配置收紧：allow_origins 改为 localhost 白名单
• 前端移除明文测试 KEY

后端修复（P1）

• 版本号统一为 1.4.1
• 规则缓存失效：PUT/DELETE/import 操作后自动清缓存
• 错误消息不截断
• 模板创建写入 USER_RULES_DIR（非只读目录）
• 上传临时文件清理

v1.0.5 — AI公文智能优化助手

AI 公文智能优化助手 v1.0.5

核心能力

• 规则引擎: 190 条检查 + 180 条修复规则，22 种法定公文文种
• AI 分析: 23+ 服务商，按文种定制规则，建议可勾选应用
• 智能修复: 字体/字号/缩进/行距/页边距一键修复
• 图片保留: 优化后文档中的图片不会丢失
• 本地运行: 数据不离开本机，API Key 加密存储

安装

下载 AI公文智能优化助手 Setup 1.0.5.exe，双击安装即可。
Windows 10/11，自带全部依赖无需额外安装。

开源

https://github.com/linhut/document-ai-assistant