docs: 固化 Pandoc 分发与内部许可策略

This commit is contained in:
SkyJourney
2026-07-30 10:49:21 +08:00
parent 81d9099eae
commit fb3ddada39
9 changed files with 428 additions and 11 deletions
+27 -8
View File
@@ -1,6 +1,6 @@
# v0.6.0 DOCX 导出与 Markdown 工具栏设计
状态:阶段 1 设计冻结,尚未开始功能实现
状态:阶段 1 架构已冻结;阶段 2 Pandoc 运行时与许可证方案已冻结
## 1. 版本目标
@@ -153,15 +153,19 @@ Desktop 只提供平台运行时、传输与保存能力。
### 4.3 Pandoc 分发
- 开发环境允许通过显式配置或 `PATH` 使用本地 Pandoc
- Docker 镜像安装项目固定版本;
- Windows Desktop 通过发行包资源目录携带固定版本;
- 固定使用 Pandoc `3.9.0.2`,不在构建时跟随 latest
- 开发环境允许通过 `DOCX_PANDOC_PATH``PATH` 使用相同版本;
- Docker amd64 使用官方 Linux 静态发行包,安装到
`/opt/pandoc/3.9.0.2/`
- Windows Desktop 将官方 ZIP 中的 `pandoc.exe`、许可证和版权文件放入
`process.resourcesPath` 下的固定资源目录;
- 用户输入不得成为可执行路径或任意命令行参数;
- 启动时或导出前校验版本,并通过 capability 状态报告不可用原因;
-布前记录 Pandoc 许可证、源码获取方式和第三方声明
- 下一阶段实测 Docker 镜像与 Desktop 安装包的体积增量
- 启动时或导出前校验精确版本,并通过 capability 状态报告不可用原因;
-行时保留 GPL、版权声明和精确版本源码获取方式
- Pandoc 继续作为独立子进程,不链接或导入其程序代码
最终版本号和分发方式在阶段 2 根据许可证与实际包体测试冻结。
官方文件、SHA-256、路径优先级、包体实测和许可证义务见
[Pandoc 运行时与分发规范](PANDOC_DISTRIBUTION.md)。
### 4.4 动态 reference.docx
@@ -286,6 +290,21 @@ Front Matter 表单工具和 ECharts YAML 工具不在 `v0.6.0` 实现,但必
DOCX 沿用当前无历史数据库原则。Markdown、图片、中间 PNG、动态模板和
最终 DOCX 只存在于当前请求或桌面保存流程中。
### 6.4 当前项目许可与内部发行
- 当前仓库采用公司内部专属许可证,包元数据标记为 `UNLICENSED`
- 公司内部可以共享源码,并分发 Web/Docker、Desktop、ZIP 和测试产物;
- 未经书面许可,不向公司外部或公开网络分发项目源码与二进制;
- 用户文档和导出结果不因使用本软件而自动受项目许可证约束;
- 三套 Typora 复制主题只允许随公司内部发行物分发;
- Apache License 2.0 是未来公开 GitHub 时的候选许可证,不在当前阶段
自动授予;
- 公开前必须重新审查第三方依赖、主题、字体、Pandoc 源码义务及 Git
历史。
根许可证和第三方边界分别见仓库根目录 `LICENSE`
`THIRD_PARTY_NOTICES.md`
## 7. 验收矩阵
### 7.1 文档内容