From 145a2ab411d75f576ece27a933879ba700b6a470 Mon Sep 17 00:00:00 2001 From: thzxx Date: Sun, 19 Apr 2026 20:55:31 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E7=AD=96=E7=95=A5?= =?UTF-8?q?=E4=B8=BA=E7=AC=AC=E4=B8=89=E6=96=B9=E5=BA=93=E6=9C=AC=E5=9C=B0?= =?UTF-8?q?=E5=8C=96=EF=BC=8C=E4=B8=8D=E5=86=8D=E8=A6=81=E6=B1=82=E9=9B=B6?= =?UTF-8?q?=E5=A4=96=E9=83=A8=E4=BE=9D=E8=B5=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 5 ++++- docs/DEVELOPMENT.md | 7 +++++-- 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 8b2bec6..4da881d 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ **基于 TypeScript + Electron 的本地 Ollama AI 桌面客户端** -全离线运行 · 数据本地存储 · 零外部依赖 +全离线运行 · 数据本地存储 · 第三方库本地化 [![版本](https://img.shields.io/badge/version-5.1.5-brightgreen?style=flat-square)](https://gitee.com/thzxx/metona-ollama-desktop/releases) [![平台](https://img.shields.io/badge/platform-Windows%20x64-blue?style=flat-square)](https://gitee.com/thzxx/metona-ollama-desktop/releases) @@ -278,6 +278,9 @@ src/ │ └── style.css # 暖色调亮色主题 │ ├── assets/icons/ # 应用图标 +├── src/vendor/ # 第三方库本地化（ESM + 类型声明 + LICENSE） +│ ├── marked.js # Markdown 解析库（v18） +│ └── dompurify.js # HTML 净化库（v3） ├── docs/ # 文档 │ ├── BUILD.md # 构建指南 │ ├── CHANGELOG.md # 更新日志 diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.md index a8cf5f3..4b0adf5 100644 --- a/docs/DEVELOPMENT.md +++ b/docs/DEVELOPMENT.md @@ -6,7 +6,7 @@ ## 一、项目概述 -Metona Ollama Desktop 是基于 TypeScript + Electron 的本地 Ollama AI 桌面客户端，面向 Windows 平台。项目采用零外部依赖策略（仅 sql.js 为运行时依赖），所有核心功能（Markdown 解析、SHA-256、HTML 净化器等）均内联实现。 +Metona Ollama Desktop 是基于 TypeScript + Electron 的本地 Ollama AI 桌面客户端，面向 Windows 平台。项目采用第三方库本地化策略：成熟的第三方库直接 vendor 到 `src/vendor/` 目录内引用，不依赖 npm 运行时安装（sql.js 因含 WASM 二进制除外）。所有核心功能（SHA-256 等）均内联实现。 --- @@ -75,6 +75,9 @@ src/ │ └── chat-db.ts # SQLite 渲染端数据库接口 │ └── styles/ │ └── style.css # 暖色调亮色主题 +├── vendor/ # 第三方库本地化（ESM + 类型声明 + LICENSE） +│ ├── marked.js # Markdown 解析库 +│ └── dompurify.js # HTML 净化库 └── ... ``` @@ -303,7 +306,7 @@ perf: 性能优化 ## 九、注意事项 -1. **零外部依赖**：新增功能优先使用内联实现，避免引入 npm 包（sql.js 除外） +1. **第三方库本地化**：新增依赖优先成熟稳定库，vendor 到 `src/vendor/` 目录内引用（ESM + 类型声明 + LICENSE），避免 npm 运行时依赖（sql.js 因含 WASM 除外） 2. **安全优先**：所有文件/命令操作必须经过安全检查层 3. **日志完整**：关键操作必须记录到执行日志面板 4. **无超时设计**：工作空间相关操作不设超时，由用户控制生命周期