diff --git a/.obsidian/workspace.json b/.obsidian/workspace.json index 136a3b2..9b90c0b 100644 --- a/.obsidian/workspace.json +++ b/.obsidian/workspace.json @@ -4,66 +4,24 @@ "type": "split", "children": [ { - "id": "6f5c5cdf13008dbc", + "id": "a55e4df4ee5dcc4a", "type": "tabs", "children": [ { - "id": "9a5781991bf94030", - "type": "leaf", - "state": { - "type": "bases", - "state": { - "file": "未命名 1.base", - "viewName": "表格" - }, - "icon": "lucide-table", - "title": "未命名 1" - } - }, - { - "id": "25c9f7051aac05b3", + "id": "c1c9b81829eaeb44", "type": "leaf", "state": { "type": "markdown", "state": { - "file": "docs/Obsidian笔记体系/Daily/2026-01-13.md", + "file": "docs/Obsidian笔记体系/Projects/claude code/claude-code启动.md", "mode": "source", "source": false }, "icon": "lucide-file", - "title": "2026-01-13" - } - }, - { - "id": "59894255df52f532", - "type": "leaf", - "state": { - "type": "markdown", - "state": { - "file": "docs/Obsidian笔记体系/Projects/知你-调测/知你--调测.md", - "mode": "source", - "source": false - }, - "icon": "lucide-file", - "title": "知你--调测" - } - }, - { - "id": "c40cc65d2419fc22", - "type": "leaf", - "state": { - "type": "markdown", - "state": { - "file": "docs/学习笔记/Android WindowManagerService (WMS) 架构深度解析(第一次提示词).md", - "mode": "source", - "source": false - }, - "icon": "lucide-file", - "title": "Android WindowManagerService (WMS) 架构深度解析(第一次提示词)" + "title": "claude-code启动" } } - ], - "currentTab": 3 + ] } ], "direction": "vertical" @@ -225,37 +183,40 @@ "command-palette:打开命令面板": false } }, - "active": "c40cc65d2419fc22", + "active": "c1c9b81829eaeb44", "lastOpenFiles": [ - "docs/学习笔记/Android WindowManagerService核心原理深度解析(专家第二次提示词).md", - "docs/学习笔记/Android性能分析标准化操作手册.md", - "docs/学习笔记/Android游戏整机性能卡顿与丢帧根因分析与优化指南.md", - "docs/学习笔记/Android整机性能分析与问题定位实战指南.md", - "docs/学习笔记/DevOps学习.md", - "docs/cursor/cursor使用技巧.md", - "docs/Obsidian/高频命令.md", + "docs/Obsidian笔记体系/Projects/claude code/Claude 功能.md", + "docs/Obsidian笔记体系/Projects/claude code/claude-code启动.md", + "docs/Obsidian笔记体系/Projects/龙虾/腾讯云服务器龙虾使用文档.md", + "docs/Obsidian笔记体系/Projects/claude code", "docs/cursor/cursor.md", - "docs/Obsidian笔记体系/Projects/聊天平台/测试用例.md", - "docs/Obsidian笔记体系/Projects/聊天平台/知你客服 6 号(检索增强记忆).md", - "docs/Obsidian笔记体系/Projects/聊天平台/聊天模型记忆解解方案.md", - "docs/Obsidian笔记体系/Projects/聊天平台/未命名.md", - "docs/Obsidian笔记体系/Projects/聊天平台/知你客服5号的设计.md", - "docs/Obsidian笔记体系/Projects/聊天平台/agent智能体性能调测.md", - "docs/Obsidian笔记体系/Projects/聊天平台/接入方式.md", - "docs/Obsidian笔记体系/Projects/聊天平台/聊天平台.md", - "docs/adb调试命令/adb常用命令.md", - "docs/Obsidian笔记体系/Projects/聊天平台/app.md", - "docs/Obsidian笔记体系/Projects/聊天平台/数据库配置.md", + "docs/Obsidian笔记体系/Projects/陪诊/数据库配置.md", + "docs/Obsidian笔记体系/Projects/陪诊/后台管理系统访问和登录信息.md", "docs/Obsidian笔记体系/Projects/saars开发/数据库配置.md", - "docs/Obsidian笔记体系/Projects/saars开发/aiapply/智能配置助手功能已完成.md", - "docs/Obsidian笔记体系/Projects/saars开发/aiapply/聊天智能机器人(苏苏).md", - "docs/Obsidian笔记体系/Projects/saars开发/aiapply/电商系统用户订单处理流程设计方案.md", - "docs/Obsidian笔记体系/Projects/saars开发/aiapply/个人简历.md", - "docs/Obsidian笔记体系/Projects/saars开发/aiapply/# 创建Agent经验总结.md", - "docs/Obsidian笔记体系/Projects/aitsc/ai提示词常用命令.md", + "docs/Obsidian笔记体系/Projects/saars开发/服务器本地防火墙开放某个端口.md", + "docs/Obsidian笔记体系/Projects/未命名.md", + "docs/Obsidian笔记体系/Projects/女童生长激素项目/项目目录位置.md", + "docs/Obsidian笔记体系/Projects/龙虾", + "docs/Obsidian笔记体系/Projects/陪诊", + "未命名 1.base", + "docs/Obsidian笔记体系/Daily/2026-01-13.md", + "docs/Obsidian笔记体系/Projects/知你-调测/知你--调测.md", + "docs/Obsidian笔记体系/Projects/知你-调测/数美文本风险拦截实施方案.md", + "docs/Obsidian笔记体系/Projects/知你-调测/知你包名信息.md", + "docs/# Android WindowManagerService (WMS) 架构深度解析(专家第一次提示词).md", + "docs/学习笔记/Android整机性能分析与问题定位实战指南.md", + "docs/学习笔记/Android游戏整机性能卡顿与丢帧根因分析与优化指南.md", + "docs/学习笔记/DevOps学习.md", + "docs/学习笔记/honor工作资料.md", + "docs/学习笔记/Java学习.md", + "docs/学习笔记/MkDocs 是什么.md", + "docs/学习笔记/效率提升.md", + "docs/学习笔记/Android WindowManagerService (WMS) 架构深度解析(第一次提示词).md", + "docs/adb调试命令/adb常用命令.md", + "docs/android面试/系统原理/WMS原理.md", + "docs/android面试/系统原理/WMS面试.md", "docs/Obsidian笔记体系/Projects/聊天平台", "docs/Obsidian笔记体系/Projects/aitsc", - "未命名 1.base", "docs/Obsidian笔记体系/Projects/提示词大师", "docs/学习笔记/产品经理", "Pasted image 20260129111501.png", @@ -269,9 +230,6 @@ "Pasted image 20260129111404.png", "Pasted image 20260129111354.png", "docs/产品经理", - "docs/Obsidian笔记体系/Projects/女童生长激素项目", - "docs/学习笔记/php", - "docs/cursor/php", - "com.xiaomi.appstore.appclaim.signature.verification.apk" + "docs/Obsidian笔记体系/Projects/女童生长激素项目" ] } \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/claude code/Claude 功能.md b/docs/Obsidian笔记体系/Projects/claude code/Claude 功能.md new file mode 100644 index 0000000..4c600e6 --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/claude code/Claude 功能.md @@ -0,0 +1,70 @@ +Claude Code,Anthropic 的官方 CLI 工具,专为软件工程任务设计的交互式代理。以下是我的主要能力: + + 🔧 核心功能 + + 代码编辑与开发 + - 读取、编辑、创建文件 + - 修复 bug 和添加新功能 + - 重构代码和优化架构 + - 解释代码逻辑和架构 + + 文件与目录操作 + - 搜索文件和内容(Glob、Grep) + - 批量修改和重命名 + - 项目管理与组织 + + Git 版本控制 + - 查看状态、差异和日志 + - 提交代码和创建分支 + - 创建和管理 Pull Request + + 构建与测试 + - 运行构建命令(npm、bun、gradle 等) + - 执行测试和调试 + - 分析构建错误 + + 🛠️ 可用工具 + + 专用工具 + - Read/Edit/Write - 文件读写编辑 + - Glob/Grep - 文件搜索和内容搜索 + - Bash - 执行 shell 命令 + - Agent - 启动专业代理处理复杂任务 + + 协作工具 + - TaskCreate/TaskUpdate - 任务管理和进度跟踪 + - AskUserQuestion - 获取用户决策和偏好 + - EnterPlanMode - 复杂任务规划 + + 外部集成 + - WebFetch/WebSearch - 获取网络信息 + - GitHub 操作(通过 gh CLI) + + ⚙️ 工作特点 + + 智能工作流 + - 先读取再编辑(确保安全) + - 优先使用专用工具而非 Bash + - 并行调用工具提高效率 + - 自动压缩历史保持上下文 + + 安全与规范 + - 检查代码安全漏洞 + - 遵循最佳实践 + - 避免不必要的重构 + - 保持代码简洁性 + + 📁 环境支持 + + - 当前环境:Windows 11(使用 Unix shell 语法) + - 运行时:Bun(JavaScript/TypeScript 项目) + - Git:支持完整版本控制操作 + - 记忆系统:可保存项目信息和用户偏好 + + 💡 典型用例 + + 1. Bug 修复:分析错误,定位问题,提供修复方案 + 2. 功能开发:规划实现,编写代码,测试验证 + 3. 代码审查:分析代码质量,提出改进建议 + 4. 项目迁移:升级依赖,适配新环境 + 5. 文档编写:生成 README、API 文档等 \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/claude code/claude-code启动.md b/docs/Obsidian笔记体系/Projects/claude code/claude-code启动.md new file mode 100644 index 0000000..1a13b66 --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/claude code/claude-code启动.md @@ -0,0 +1,4 @@ +cd D:\cd\claude-code +bun install +bun run build +bun run dev \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/知你-调测/知你包名信息.md b/docs/Obsidian笔记体系/Projects/知你-调测/知你包名信息.md new file mode 100644 index 0000000..990c6c0 --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/知你-调测/知你包名信息.md @@ -0,0 +1,3 @@ +包名:com.xunpaisoft.social +公钥:9017939b7cda5c41482a8baaeae587cd9025525ac30b9644293a1e4bc8f6b825 +MD5签名:10bc581409188dd39ed38bad24353be7 diff --git a/docs/Obsidian笔记体系/Projects/陪诊/后台管理系统访问和登录信息.md b/docs/Obsidian笔记体系/Projects/陪诊/后台管理系统访问和登录信息.md new file mode 100644 index 0000000..ca325a6 --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/陪诊/后台管理系统访问和登录信息.md @@ -0,0 +1,145 @@ + + +## 后台管理系统访问和登录信息 + +### 访问地址 + +- 前端地址:`http://localhost:80` +- 后端API:`http://localhost:8039` + +### 启动方式 + +1. 启动后端服务(如果未启动) + +cd /home/renjianbo/saars/rlz/rlz + +mvn spring-boot:run + +2. 启动前端服务 + +cd /home/renjianbo/saars/rlz/rlz-ui + +npm install # 首次运行需要 + +npm run dev + +### 默认登录账户 + +根据数据库和 RuoYi 框架配置,默认管理员账户为: + +|用户名|密码|说明| +|---|---|---| +|admin|admin123|超级管理员(推荐使用)| +|ry|admin123|测试账户| + +### 登录步骤 + +1. 打开浏览器访问:`http://localhost:80` +2. 输入用户名:`admin` +3. 输入密码:`admin123` +4. 输入验证码(如需要) +5. 点击“登录” + +### 注意事项 + +1. 如果无法登录: + + - 确认后端服务已启动(端口8039) + - 确认前端服务已启动(端口80) + - 检查数据库连接是否正常 +2. 密码已修改: + + - 可通过数据库重置密码 + - 或联系系统管理员 +3. 安全建议: + + - 首次登录后立即修改密码 + - 生产环境不要使用默认密码 + +已创建详细说明文档:`后台管理系统访问说明.md`,包含更多故障排查和安全建议。 + + +对外访问的网址 是多少 + +前端服务端口使用8050 + +后台管理系统访问说明.md + +--- + +**最后更新**: 2026-01-26 + +**系统版本**: RuoYi 3.8.3 + +后台管理系统访问说明.md + +--- + +**最后更新**: 2026-01-26 + +**系统版本**: RuoYi 3.8.3 + +后台管理系统访问说明.md + +--- + +**最后更新**: 2026-01-26 + +**系统版本**: RuoYi 3.8.3 + +README.md + +# 构建测试环境 + +npm run build:stage + +# 构建生产环境 + +npm run build:prod + +``` + +已将前端服务端口改为8050,并更新相关配置。修改如下: + +## 已完成的配置修改 + +### 1. 前端配置文件 (`rlz-ui/vue.config.js`) + +- 端口:`80` → `8050` +- 后端代理:`9090` → `8039`(与当前后端端口一致) + +### 2. 文档更新 + +- `对外访问地址说明.md` - 已更新所有端口信息 +- `后台管理系统访问说明.md` - 已更新访问地址 +- `rlz-ui/README.md` - 已更新访问地址 + +## 访问地址 + +### 本地访问 + +- 前端地址:`http://localhost:8050` +- 后端API:`http://localhost:8039` + +### 公网访问 + +- 前端地址:`http://101.43.95.130:8050` +- 后端API:`http://101.43.95.130:8039` + +## 启动前端服务 + +cd /home/renjianbo/saars/rlz/rlz-ui + +npm run dev + +启动后访问:`http://localhost:8050` + +## 如需对外访问 + +如需通过公网访问前端,需要开放防火墙端口: + +sudo firewall-cmd --permanent --add-port=8050/tcp + +sudo firewall-cmd --reload + +配置已完成。启动前端服务后即可通过 `http://localhost:8050` 访问后台管理系统。 \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/陪诊/数据库配置.md b/docs/Obsidian笔记体系/Projects/陪诊/数据库配置.md new file mode 100644 index 0000000..020cc33 --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/陪诊/数据库配置.md @@ -0,0 +1 @@ +DATABASE_URL=mysql+pymysql://root:!Rjb12191@gz-cynosdbmysql-grp-d26pzce5.sql.tencentcdb.com:24936/rlz?charset=utf8mb4 \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/龙虾/腾讯云服务器龙虾使用文档.md b/docs/Obsidian笔记体系/Projects/龙虾/腾讯云服务器龙虾使用文档.md new file mode 100644 index 0000000..3f480c9 --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/龙虾/腾讯云服务器龙虾使用文档.md @@ -0,0 +1,71 @@ +## 一、你现在的状态 + +✅ MiniMax 模型配置成功 + +✅ 默认模型:minimax/MiniMax-M2.7 + +✅ API Key 绑定成功 + +✅ 国内 baseUrl 正确 + +✅ AI 可正常聊天 + +✅ 运行在 CentOS 7.6 计算云 + Docker + +--- + +## 二、你以后只需要记住 3 条命令 + +### 1. 进入 AI 聊天(最常用) + +bash + +运行 + +``` +docker exec -it openclaw-docker-openclaw-gateway-1 openclaw tui +``` + +### 2. 查看模型列表 + +bash + +运行 + +``` +docker exec -it openclaw-docker-openclaw-gateway-1 openclaw models list +``` + +### 3. 重启龙虾(出问题时用) + +bash + +运行 + +``` +docker restart openclaw-docker-openclaw-gateway-1 +``` + +--- + +## 三、关键避坑(你遇到的所有坑) + +1. 宿主机不能直接用 openclaw 命令 → 必须进 Docker +2. 容器名不是 openclaw → 正确是:openclaw-docker-openclaw-gateway-1 +3. 不能手动写配置文件 → 必须用 openclaw configure +4. 必须设置中国区 baseUrl:[https://api.minimax.chat/v1](https://api.minimax.chat/v1) +5. API Key 泄露一定要重置 + +--- + +## 四、你现在可以直接用 + +输入聊天命令 → 打字 → 回车 → AI 回复! + +--- + +### 一句话总结 + +你的 CentOS7.6 计算云 + Docker 龙虾 + MiniMax 已经完全正常运行! + +随时能用,不会再报错!🦞✅ \ No newline at end of file diff --git a/docs/学习笔记/Java学习.md b/docs/学习笔记/Java学习.md index 7fe7df2..c704581 100644 --- a/docs/学习笔记/Java学习.md +++ b/docs/学习笔记/Java学习.md @@ -1,85 +1,85 @@ -# Java 学习笔记 - -## 基础语法 - -### 变量和数据类型 - -```java -// 基本数据类型 -int age = 25; -double price = 99.99; -boolean isActive = true; -String name = "Java"; -``` - -### 控制结构 - -```java -// if-else -if (age >= 18) { - System.out.println("成年人"); -} else { - System.out.println("未成年人"); -} - -// for 循环 -for (int i = 0; i < 10; i++) { - System.out.println(i); -} -``` - -## 面向对象 - -### 类和对象 - -```java -public class Person { - private String name; - private int age; - - public Person(String name, int age) { - this.name = name; - this.age = age; - } - - public void introduce() { - System.out.println("我是 " + name + ",今年 " + age + " 岁"); - } -} -``` - -## 集合框架 - -### List - -```java -List list = new ArrayList<>(); -list.add("Java"); -list.add("Python"); -list.add("Go"); -``` - -### Map - -```java -Map map = new HashMap<>(); -map.put("Java", 1); -map.put("Python", 2); -``` - -## 常用工具类 - -### String 操作 - -```java -String str = "Hello World"; -str.length(); // 长度 -str.substring(0, 5); // 子串 -str.split(" "); // 分割 -``` - -## 学习资源 - -- [Oracle Java 教程](https://docs.oracle.com/javase/tutorial/) -- [Java 官方文档](https://docs.oracle.com/en/java/) - +# Java 学习笔记 + +## 基础语法 + +### 变量和数据类型 + +```java +// 基本数据类型 +int age = 25; +double price = 99.99; +boolean isActive = true; +String name = "Java"; +``` + +### 控制结构 + +```java +// if-else +if (age >= 18) { + System.out.println("成年人"); +} else { + System.out.println("未成年人"); +} + +// for 循环 +for (int i = 0; i < 10; i++) { + System.out.println(i); +} +``` + +## 面向对象 + +### 类和对象 + +```java +public class Person { + private String name; + private int age; + + public Person(String name, int age) { + this.name = name; + this.age = age; + } + + public void introduce() { + System.out.println("我是 " + name + ",今年 " + age + " 岁"); + } +} +``` + +## 集合框架 + +### List + +```java +List list = new ArrayList<>(); +list.add("Java"); +list.add("Python"); +list.add("Go"); +``` + +### Map + +```java +Map map = new HashMap<>(); +map.put("Java", 1); +map.put("Python", 2); +``` + +## 常用工具类 + +### String 操作 + +```java +String str = "Hello World"; +str.length(); // 长度 +str.substring(0, 5); // 子串 +str.split(" "); // 分割 +``` + +## 学习资源 + +- [Oracle Java 教程](https://docs.oracle.com/javase/tutorial/) +- [Java 官方文档](https://docs.oracle.com/en/java/) + diff --git a/docs/学习笔记/MkDocs 是什么.md b/docs/学习笔记/MkDocs 是什么.md index ccc0188..45156d4 100644 --- a/docs/学习笔记/MkDocs 是什么.md +++ b/docs/学习笔记/MkDocs 是什么.md @@ -1,1258 +1,1258 @@ -# MkDocs 是什么 - -## - -**MkDocs** 是一个**快速、简单、优雅的静态网站生成器**,专门用于从 Markdown 文件构建项目文档。它的设计目标非常明确:让创建美观、实用的文档网站变得尽可能轻松。 - -### 核心特点 - -**1. 极简配置** - -- 只需一个 YAML 配置文件 (`mkdocs.yml`) - -- 几分钟内即可搭建起完整的文档站点 - -**2. Markdown 驱动** - -- 所有内容都使用 Markdown 编写 - -- 对开发者友好,学习成本低 - -**3. 丰富的主题系统** - -- 内置多个主题(如 `material`、`readthedocs`) - -- Material for MkDocs 主题尤为强大,支持: - - - 响应式设计 - - - 深色/浅色模式 - - - 搜索功能 - - - 多级导航 - - - 代码高亮 - -### 在你的 DevOps 平台中的角色 - -在你的“个人超级 DevOps 平台”中,**MkDocs 作为个人知识库**: - -text - -# 典型结构 - -docs/ # 你的知识库 -├── index.md # 首页 -├── devops-platform.md # DevOps平台搭建记录 -├── kubernetes-guide.md # K8s学习笔记 -├── api-references/ # API文档 -└── troubleshooting.md # 排错手册 -mkdocs.yml # 配置文件 - -### 为什么适合你的技术栈? - -**与你的其他组件完美集成:** - -1. **与 Gitea 结合** - - - 将 MkDocs 源码存储在 Gitea 中 - - - 使用 Git Hook 自动构建和部署文档 - - - 用 Gitea 的 Wiki 做协作,MkDocs 做正式知识库 - -2. **与 MinIO 结合** - - - 将构建的静态文档网站托管到 MinIO - - - 使用 MinIO 作为文档附件存储 - -3. **作为知识沉淀中心** - - - 记录你的 DevOps 平台搭建过程 - - - 编写团队技术规范 - - - 整理问题解决方案 - -### 快速示例 - -**安装:** - -bash - -pip install mkdocs mkdocs-material - -**创建新站点:** - -bash - -mkdocs new my-knowledge-base -cd my-knowledge-base - -**简单配置 (`mkdocs.yml`):** - -yaml - -site_name: 我的技术知识库 -theme: - name: material - features: - - navigation.tabs - - navigation.sections - - search.suggest - - search.highlight - -nav: - -- 首页: index.md -- DevOps平台: - - 架构设计: devops/architecture.md - - 部署指南: devops/deployment.md -- 移动开发: - - CI/CD流程: mobile/ci-cd.md - - 发布管理: mobile/release.md - -**编写内容 (`docs/index.md`):** - -markdown - -# 欢迎来到我的知识库 - -这里是个人超级 DevOps 平台的所有技术文档。 - -## 平台组件 - -- **代码管理**: Gitea -- **依赖管理**: Nexus -- **文档管理**: MkDocs -- **监控告警**: Sentry + Grafana - -**本地预览:** - -bash - -mkdocs serve - -# 在 http://localhost:8000 查看 - -### 进阶用法 - -**版本化文档:** - -yaml - -theme: - name: material - features: - - navigation.tabs - - navigation.tabs.sticky - language: zh - -extra: - version: - provider: mike - -plugins: - -- search -- mike: - alias_type: symlink - -**与 CI/CD 集成:** - -yaml - -# GitLab CI 示例 - -pages: - stage: deploy - script: - - pip install mkdocs mkdocs-material - - mkdocs build - - mv site public - artifacts: - paths: - - public - only: - - main - -### 优势总结 - -✅ **简单易用** - Markdown 编写,配置简单 -✅ **维护方便** - 版本控制友好 -✅ **部署灵活** - 生成静态文件,可托管到任何地方 -✅ **搜索强大** - 内置全文搜索 -✅ **移动友好** - 响应式设计 -✅ **社区活跃** - 丰富的插件生态 - -在你的 DevOps 生态中,MkDocs 是**文档即代码**理念的完美实践,它让技术文档的编写、维护和发布变得和写代码一样规范高效。 - -vscode下载 - -我来详细介绍如何下载和安装 Visual Studio Code (VSCode),这是开发者必备的代码编辑器。 - -## 下载 VSCode 的几种方式 - -### 1. **官方网站下载**(最推荐) - -**访问官网:** [https://code.visualstudio.com/](https://code.visualstudio.com/) - -官网会自动检测你的操作系统,推荐合适的版本: - -- **Windows 用户**:下载 `.exe` 安装包 - -- **macOS 用户**:下载 `.dmg` 文件或 `.zip` 压缩包 - -- **Linux 用户**:提供多种包格式(`.deb`, `.rpm`, `.tar.gz`) - -### 2. **各平台具体下载地址** - -**Windows:** - -text - -https://code.visualstudio.com/sha/download?build=stable&os=win32-x64-user - -**macOS:** - -- Intel 芯片: - -text - -https://code.visualstudio.com/sha/download?build=stable&os=darwin - -- Apple Silicon (M1/M2/M3): - -text - -https://code.visualstudio.com/sha/download?build=stable&os=darwin-arm64 - -**Linux:** - -text - -https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-x64 - -### 3. **使用包管理器安装** - -**Windows (Winget):** - -bash - -winget install Microsoft.VisualStudioCode - -**macOS (Homebrew):** - -bash - -brew install --cask visual-studio-code - -**Ubuntu/Debian:** - -bash - -sudo apt update -sudo apt install software-properties-common apt-transport-https wget -wget -q https://packages.microsoft.com/keys/microsoft.asc -O- | sudo apt-key add - -sudo add-apt-repository "deb [arch=amd64] https://packages.microsoft.com/repos/vscode stable main" -sudo apt update -sudo apt install code - -**CentOS/RHEL/Fedora:** - -bash - -sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc -sudo sh -c 'echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/vscode.repo' -sudo dnf install code # 或 sudo yum install code - -### 4. **便携版下载** - -如果你想要免安装版本: - -- **Windows**:下载 `VSCode-win32-x64-XX.X.X.zip` - -- **macOS**:下载 `VSCode-darwin-x64-XX.X.X.zip` - -- **Linux**:下载 `VSCode-linux-x64-XX.X.X.tar.gz` - -## 安装步骤 - -### **Windows 安装** - -1. 下载 `.exe` 安装包 - -2. 双击运行安装程序 - -3. 同意许可协议 - -4. 选择安装选项(推荐勾选): - - - ✅ 将“通过 Code 打开”操作添加到 Windows 资源管理器文件上下文菜单 - - - ✅ 将“通过 Code 打开”操作添加到 Windows 资源管理器目录上下文菜单 - - - ✅ 将 Code 注册为受支持的文件类型的编辑器 - - - ✅ 添加到 PATH(允许从命令行运行 `code`) - -### **macOS 安装** - -1. 下载 `.dmg` 文件 - -2. 双击打开磁盘映像 - -3. 将 VSCode 图标拖到“应用程序”文件夹 - -4. 首次运行时,可能会提示“无法打开”,需要: - - - 右键点击 VSCode → 打开 - - - 或在“系统偏好设置 → 安全性与隐私”中允许打开 - -### **Linux 安装** - -**使用 .deb 包 (Ubuntu/Debian):** - -bash - -sudo dpkg -i code_*.deb -sudo apt-get install -f # 安装依赖 - -## 首次设置建议 - -安装完成后,建议进行以下配置: - -### 1. **安装中文语言包** - -1. 打开 VSCode - -2. 按 `Ctrl+Shift+X` 打开扩展面板 - -3. 搜索 `Chinese (Simplified)` - -4. 点击安装并重启 - -### 2. **推荐扩展**(根据你的 DevOps 需求) - -**通用开发:** - -- `GitLens` - Git 增强 - -- `Git History` - Git 历史查看 - -- `Error Lens` - 错误提示增强 - -- `Path Intellisense` - 路径自动补全 - -**DevOps 相关:** - -- `Docker` - Docker 支持 - -- `Kubernetes` - K8s 支持 - -- `YAML` - YAML 语言支持 - -- `HashiCorp Terraform` - Terraform 支持 - -**文档编写:** - -- `Markdown All in One` - Markdown 增强 - -- `markdownlint` - Markdown 格式检查 - -- `Paste Image` - 粘贴图片到 Markdown - -**你的技术栈扩展:** - -- `Gradle for Java` - Gradle 支持 - -- `MinIO` - MinIO 文件管理 - -- `Gitea` - Gitea 集成 - -### 3. **常用配置** - -json - -// settings.json -{ - "editor.fontSize": 14, - "editor.tabSize": 2, - "editor.formatOnSave": true, - "editor.codeActionsOnSave": { - "source.fixAll": "explicit" - }, - "files.autoSave": "afterDelay", - "terminal.integrated.defaultProfile.windows": "Git Bash", - "workbench.colorTheme": "Default Dark Modern", - "workbench.iconTheme": "material-icon-theme" -} - -## 便携版使用(无需安装) - -如果你下载的是便携版: - -**Windows:** - -1. 解压 `VSCode-win32-x64-XX.X.X.zip` 到任意目录 - -2. 运行 `Code.exe` - -**macOS/Linux:** - -1. 解压压缩包 - -2. 进入解压目录,运行 `./Code`(可能需要 `chmod +x`) - -## 验证安装 - -打开终端/命令提示符,输入: - -bash - -code --version - -# 或 - -code --help - -如果正确安装,会显示版本信息: - -text - -1.84.2 -... - -## 小贴士 - -1. **自动更新**:VSCode 默认启用自动更新,可以在设置中调整 - -2. **Insiders 版本**:如果想体验最新功能,可以下载 [VSCode Insiders](https://code.visualstudio.com/insiders/) - -3. **同步设置**:登录 Microsoft/GitHub 账号可同步设置到不同设备 - -4. **命令行使用**:安装时添加到 PATH 后,可以在终端中用 `code .` 打开当前目录 - -## 快速开始 - -安装完成后,你可以: - -1. 按 `F1` 或 `Ctrl+Shift+P` 打开命令面板 - -2. 输入 `>Git: Clone` 克隆你的 Gitea 仓库 - -3. 开始编写你的 DevOps 平台代码和文档 - -VSCode 是搭建和维护你的“个人超级 DevOps 平台”的绝佳工具,配合你提到的 Gitea、MkDocs 等组件,能极大提升开发效率! - -- **Typora**(所见即所得) - 下载 - -# Typora 下载和安装指南 - -## 官方下载渠道 - -### 1. **官方网站** - -**访问:** [https://typora.io/](https://typora.io/) - -点击首页的 "Download" 按钮,会自动推荐适合你系统的版本。 - -### 2. **各平台直接下载链接** - -**Windows:** - -- 64位:https://typora.io/windows/typora-setup-x64.exe - -- 32位:https://typora.io/windows/typora-setup-ia32.exe - -**macOS:** - -- Intel:https://typora.io/mac/Typora.dmg - -- Apple Silicon (M1/M2/M3):https://typora.io/mac/Typora.dmg (通用版本) - -**Linux:** - -bash - -# Debian/Ubuntu - -wget -qO - https://typora.io/linux/public-key.asc | sudo tee /etc/apt/trusted.gpg.d/typora.asc -sudo add-apt-repository 'deb https://typora.io/linux ./' -sudo apt update -sudo apt install typora - -# 或直接下载 .deb 包 - -https://typora.io/linux/Typora-linux-x64.deb - -### 3. **国内镜像/备用下载** - -由于网络原因,如果官网下载慢,可以尝试: - -**GitHub Releases:** - -text - -https://github.com/typora/typora-issues/releases - -**第三方镜像站:** - -- 腾讯软件中心:https://pc.qq.com/detail/10/detail_22850.html - -- 华为云镜像:https://mirrors.huaweicloud.com/typora/ - -## 安装步骤 - -### **Windows 安装** - -1. 下载 `.exe` 安装包 - -2. 双击运行安装程序 - -3. 选择安装位置(默认 `C:\Program Files\Typora`) - -4. 创建桌面快捷方式和开始菜单项 - -5. 完成安装 - -### **macOS 安装** - -1. 下载 `.dmg` 文件 - -2. 双击打开磁盘映像 - -3. 将 Typora 图标拖到 "应用程序" 文件夹 - -4. 首次运行时,如果提示 "无法打开": - - - 右键点击 Typora → 打开 - - - 或进入 "系统偏好设置 → 安全性与隐私" → 点击 "仍要打开" - -### **Linux 安装** - -bash - -# 使用 .deb 包安装 - -sudo dpkg -i Typora-linux-x64.deb -sudo apt install -f # 修复依赖 - -# 或使用 Snap - -sudo snap install typora - -## 许可证激活 - -**注意:Typora 现在是付费软件**(从 2021.11 开始) - -### 1. **试用版** - -- 提供 15 天免费试用 - -- 试用期满后需要购买许可证 - -### 2. **购买许可证** - -1. 访问:[https://store.typora.io/](https://store.typora.io/) - -2. 选择许可证类型: - - - **个人版**:$14.99(3台设备) - - - **商业版**:$29.99(3台设备) - - - **教育优惠**:有折扣 - -3. 购买后会收到许可证密钥 - -### 3. **激活步骤** - -1. 打开 Typora - -2. 菜单栏选择 `帮助 → 我的许可证...` - -3. 输入邮箱和许可证密钥 - -4. 激活成功 - -## 替代方案(如果你不想付费) - -### **免费开源替代品** - -1. **MarkText** - 类似 Typora 的免费开源编辑器 - - - GitHub:[GitHub - marktext/marktext: 📝A simple and elegant markdown editor, available for Linux, macOS and Windows.](https://github.com/marktext/marktext) - - - 下载:[Releases · marktext/marktext · GitHub](https://github.com/marktext/marktext/releases) - -2. **Obsidian** - 强大的知识库工具,免费个人使用 - - - 官网:[https://obsidian.md/](https://obsidian.md/) - -3. **Zettlr** - 学术写作的 Markdown 编辑器 - - - 官网:[https://www.zettlr.com/](https://www.zettlr.com/) - -4. **VSCode + Markdown 扩展** - - bash - - # 安装以下扩展 - - 1. Markdown All in One - 2. Markdown Preview Enhanced - 3. Markdown Preview Github Styling - -### **旧版本 Typora** - -如果你有旧版本 (v0.11.18 及之前),可以继续使用: - -- GitHub 旧版本下载:https://github.com/typora/typora-issues/issues/8102 - -- **注意**:旧版本可能存在安全漏洞 - -## Typora 基本使用 - -### 1. **界面概览** - -text - -左侧:文件树或大纲视图 -中间:编辑区域(所见即所得) -右侧:大纲导航 - -### 2. **常用快捷键** - -- `Ctrl + /`:切换源代码模式 - -- `Ctrl + B`:加粗 - -- `Ctrl + I`:斜体 - -- `Ctrl + K`:插入链接 - -- `Ctrl + Shift + I`:插入图片 - -- `Ctrl + T`:插入表格 - -- `Ctrl + Shift + M`:数学公式 - -- `Ctrl + 1~6`:标题级别 - -### 3. **与你的 DevOps 平台集成** - -**配合 Gitea:** - -1. 在 Typora 中编写 Markdown 文档 - -2. 保存到 Git 仓库目录 - -3. 使用 Git 命令或 Git 客户端提交到 Gitea - -**配合 MkDocs:** - -yaml - -# mkdocs.yml 配置 Typora 兼容 - -markdown_extensions: - -- admonition -- codehilite -- footnotes -- meta -- toc: - permalink: true -- pymdownx.superfences -- pymdownx.tabbed - -### 4. **图片处理配置** - -yaml - -# Typora 偏好设置 → 图像 - -- 复制图片到 ./${filename}.assets 文件夹 -- 对本地位置的图片应用上述规则 -- 对网络位置的图片应用上述规则 - -## 主题和样式 - -### 内置主题: - -1. **Github** - GitHub 风格 - -2. **Night** - 深色主题 - -3. **Pixyll** - 简洁风格 - -4. **Whitey** - 纯白简洁 - -### 自定义 CSS: - -1. 打开主题文件夹:`文件 → 偏好设置 → 外观 → 打开主题文件夹` - -2. 创建 `user.base.user.css` 文件 - -3. 添加自定义样式: - -css - -/* 自定义样式 */ -body { - font-family: "Microsoft YaHei", sans-serif; - max-width: 900px; - margin: 0 auto; -} - -img { - border-radius: 8px; - box-shadow: 0 2px 8px rgba(0,0,0,0.1); -} - -## 常见问题解决 - -### Q1: 下载速度慢? - -- 使用国内镜像站 - -- 使用下载工具(IDM、迅雷等) - -- 尝试 GitHub Releases - -### Q2: 安装失败? - -**Windows:** - -- 以管理员身份运行 - -- 关闭杀毒软件临时 - -- 检查系统版本(需要 Win7 以上) - -**macOS:** - -bash - -# 如果提示 "已损坏" - -sudo xattr -rd com.apple.quarantine /Applications/Typora.app - -**Linux:** - -bash - -# 依赖问题 - -sudo apt --fix-broken install - -### Q3: 许可证问题? - -- 检查网络连接 - -- 确认邮箱和密钥正确 - -- 访问 https://typora.io/dev_release.html 检查服务状态 - -## 推荐配置(用于 DevOps 文档) - -### 1. **工作流设置** - -text - -1. 在 Typora 中编写 Markdown -2. 保存到 Git 管理的 docs/ 目录 -3. 使用 MkDocs 构建静态网站 -4. 部署到服务器或 GitHub Pages - -### 2. **写作模板** - -创建模板文件 `template.md`: - -markdown - ---- - -title: {{title}} -date: {{date}} -tags: -category: - ---- - -# {{title}} - -## 概述 - -## 详细内容 - -## 参考链接 - -### 3. **自动化脚本** - -bash - -#!/bin/bash - -# auto_build.sh - 自动构建文档 - -cd /path/to/docs -typora --wait-for-signal-to-close document.md -mkdocs build -git add . -git commit -m "Update documentation" -git push - -## 总结 - -Typora 是一款优秀的 Markdown 编辑器,特别适合: - -- 个人知识库管理(配合你的 MkDocs) - -- 技术文档编写 - -- 日常笔记记录 - -如果你需要完全免费的方案,建议考虑 **MarkText** 或 **Obsidian**。对于你的 DevOps 平台,Typora 的所见即所得特性确实能提升 Markdown 文档的编写体验。 - -本回答由 AI 生成,内容仅供参考,请仔细甄别。 - -image.png - -PNG 33.06KB - -下载好了,如何安装 - -根据你提供的信息,你已经下载了 MarkText 的 Windows 安装文件。以下是详细的安装步骤: - -## 方法一:使用安装向导(推荐) - -### 步骤: - -1. **找到下载的文件** - - - 通常在 `Downloads`(下载)文件夹中 - - - 文件名类似:`marktext-setup-x.x.x.exe`(x.x.x 是版本号) - -2. **运行安装程序** - - - 双击 `.exe` 文件 - - - 如果出现安全警告,点击"运行"或"更多信息 → 仍要运行" - -3. **选择安装类型** - - text - - Install for: (选择安装范围) - □ Just me (当前用户) - ☑ All users (requires admin privileges) (所有用户,需要管理员权限) - - - **推荐选择**:`All users`(需要管理员权限) - -4. **选择安装位置** - - - 默认位置:`C:\Program Files\MarkText\` - - - 可以点击"Browse"更改安装路径 - -5. **创建快捷方式** - - - 桌面快捷方式(推荐勾选) - - - 开始菜单文件夹 - -6. **完成安装** - - - 点击"Install"开始安装 - - - 安装完成后点击"Finish" - -## 方法二:使用包管理器安装 - -### 如果已经下载了安装包,直接使用方法一即可。以下是使用包管理器的方法: - -### 1. **使用 Chocolatey**(需要先安装 Chocolatey) - -cmd - -# 以管理员身份打开命令提示符或 PowerShell - -choco install marktext - -### 2. **使用 Winget**(Windows 11 自带,Win10 可能需要安装) - -cmd - -# 以管理员身份打开终端 - -winget install marktext - -## 验证安装 - -### 检查是否安装成功: - -1. **启动程序** - - - 从开始菜单搜索"MarkText" - - - 双击桌面快捷方式(如果创建了) - -2. **命令行验证** - - cmd - - # 打开命令提示符或 PowerShell - - marktext --version - - # 或 - - marktext --help - -3. **文件关联**(可选) - - - 安装后,MarkText 可能会询问是否关联 `.md` 文件 - - - 点击"是"即可用 MarkText 打开所有 Markdown 文件 - -## 首次使用设置 - -### 1. **选择主题** - -打开 MarkText 后,你会看到: - -- **Dark Theme** - 深色主题 - -- **Light Theme** - 浅色主题 - -- **Graphite Theme** - 石墨主题 - -- **Ulysses Theme** - Ulysses 风格 - -- **Material Dark** - Material 深色 - -- **Cadmium Light** - 镉浅色 - -### 2. **基本配置** - -按 `Ctrl+,` 打开设置: - -json - -{ - // 编辑器设置 - "autoSave": true, // 自动保存 - "autoSaveDelay": 1000, // 自动保存延迟(毫秒) - "defaultFontSize": 16, // 默认字体大小 - - // 编辑器行为 - "editorLineWidth": 800, // 编辑器行宽 - "fontFamily": "Arial", // 字体 - - // Markdown 设置 - "preferLooseListItem": true, // 宽松列表 - "bulletListMarker": "-", // 列表标记 - - // 图像设置 - "imageFolderPath": "assets", // 图片保存文件夹 - "setImageFolder": true // 自动创建图片文件夹 -} - -### 3. **设置中文界面** - -1. 按 `Ctrl+,` 打开设置 - -2. 搜索 `locale` - -3. 将 `locale` 改为 `zh-CN` - -4. 重启 MarkText - -## 常见问题解决 - -### Q1:安装时提示"需要管理员权限"? - -- **解决方法**: - - 1. 右键点击安装程序 - - 2. 选择"以管理员身份运行" - - 3. 或者选择"Just me"(仅当前用户)安装选项 - -### Q2:安装后无法启动? - -- **解决方法**: - - 1. 重启电脑 - - 2. 检查防病毒软件是否阻止 - - 3. 重新安装 - - 4. 查看 Windows 事件查看器中的错误信息 - -### Q3:如何卸载? - -cmd - -# 方法1:控制面板卸载 - -# 方法2:使用包管理器 - -winget uninstall marktext - -# 或 - -choco uninstall marktext - -## 快速开始使用 - -### 1. **创建第一篇文档** - -1. 按 `Ctrl+N` 新建文件 - -2. 输入内容: - - markdown - - # 我的第一篇 Markdown - - ## 这是副标题 - - - 列表项1 - - 列表项2 - - **粗体文本** *斜体文本* - - [链接](https://example.com) - -3. 按 `Ctrl+S` 保存 - -### 2. **常用快捷键** - -- `Ctrl+N`:新建文件 - -- `Ctrl+O`:打开文件 - -- `Ctrl+S`:保存 - -- `Ctrl+Shift+S`:另存为 - -- `Ctrl+/`:切换源代码模式 - -- `Ctrl+B`:加粗 - -- `Ctrl+I`:斜体 - -- `Ctrl+K`:插入链接 - -- `Ctrl+Shift+I`:插入图片 - -### 3. **与你的 DevOps 平台集成** - -将 MarkText 作为你的 Markdown 编辑器: - -bash - -# 在 Git 仓库中编辑文档 - -cd /path/to/your/docs - -# 用 MarkText 打开文件 - -marktext README.md - -# 或 - -marktext . - -## 高级功能 - -### 1. **多标签页** - -- 支持同时打开多个文件 - -- 标签页可拖拽重新排列 - -### 2. **多种编辑模式** - -- **源代码模式** - 纯文本编辑 - -- **打字机模式** - 当前行居中 - -- **专注模式** - 淡化其他内容 - -### 3. **导出功能** - -支持导出为: - -- HTML - -- PDF - -- 纯文本 - -### 4. **Git 集成** - -内置简单的 Git 支持: - -- 显示 Git 状态 - -- 提交消息 - -- 差异对比 - -## 配置为默认 Markdown 编辑器 - -### Windows 10/11: - -1. 右键点击 `.md` 文件 - -2. 选择"打开方式" → "选择其他应用" - -3. 找到 MarkText,勾选"始终使用此应用打开 .md 文件" - -4. 点击"确定" - -完成安装后,你就可以用 MarkText 来编写你的 MkDocs 文档、技术笔记等,配合你的 DevOps 平台使用了! - -image.png - -PNG 64.83KB - -点击哪个文件安装呢? - -从你提供的文件列表来看,这是一个 **MarkText 的源代码项目目录**,而不是可以直接安装的安装程序。 - -让我帮你分析一下: - -## 📁 **目录结构分析** - -text - -├── docs/ # 文档文件夹 -├── src/ # 源代码文件夹 -├── static/ # 静态资源 -├── resources/ # 应用资源 -├── package.json # Node.js 项目配置文件 -├── electron-builder.yml # Electron 构建配置 -└── 其他配置文件... - -## 🚨 **重要:这不是安装包!** - -你下载的是 **MarkText 的源代码**,需要**编译构建**后才能得到安装程序。 - -## 🛠️ **如何正确安装 MarkText** - -你有两个选择: - -### **选择一:下载正式安装包(推荐)** - -1. **访问 MarkText 官方发布页**: - [Releases · marktext/marktext · GitHub](https://github.com/marktext/marktext/releases) - -2. **下载正确的安装包**: - - - Windows:`marktext-setup-x.x.x.exe` (x.x.x是版本号) - - - macOS:`marktext-x.x.x.dmg` - - - Linux:`marktext-x.x.x-x86_64.AppImage` - -3. **双击安装包安装** - -### **选择二:从源码构建安装** - -如果你确实想从这个源码构建: - -bash - -# 1. 安装 Node.js (v14+) - -# 从 https://nodejs.org/ 下载安装 - -# 2. 安装 Yarn - -npm install -g yarn - -# 3. 进入项目目录 - -cd "你下载的文件夹路径" - -# 4. 安装依赖 - -yarn install - -# 5. 运行开发版本 - -yarn run dev - -# 6. 构建安装包(可选) - -yarn run build - -## 📦 **快速对比** - -| 类型 | 文件 | 说明 | -| --------- | --------------------------- | ------ | -| **✅ 安装包** | `.exe`, `.dmg`, `.AppImage` | 双击即可安装 | -| **❌ 源代码** | 文件夹 + 配置文件 | 需要编译构建 | - -## 🔍 **检查你下载的文件** - -如果你是通过以下方式下载的: - -- **GitHub 的绿色 "Code" 按钮** → 下载的是源代码 - -- **Git clone 命令** → 下载的是源代码 - -- **Release 页面的 "Source code"** → 下载的是源代码 - -**正确的方式**:在 Release 页面找到 **Assets**(资源)部分,下载那里的文件。 - -## 🎯 **立即获取安装包的步骤** - -1. **访问**:[Releases · marktext/marktext · GitHub](https://github.com/marktext/marktext/releases) - -2. **找到最新版本**(如 v0.17.1) - -3. **展开 "Assets"** 部分 - -4. **下载对应系统的文件**: - - text - - Windows用户下载: - marktext-setup-x.x.x.exe (约 90 MB) - 或 - marktext-setup-x.x-x64.exe - -## 💡 **如果你已经下载了源代码** - -你可以: - -1. **保留源代码**:用于学习或二次开发 - -2. **删除源代码**:如果你只需要使用软件 - -## 📝 **总结建议** - -**普通用户**:直接去 Release 页面下载安装包,简单快捷 -**开发者**:可以保留源代码进行学习和定制 - -**记住这个关键点**: - -- **`.exe` 文件** = 可以直接安装 - -- **文件夹+配置文件** = 需要编译构建 - -现在就去 Release 页面下载真正的安装包吧!这样你就能立即开始使用 MarkText 了。 +# MkDocs 是什么 + +## + +**MkDocs** 是一个**快速、简单、优雅的静态网站生成器**,专门用于从 Markdown 文件构建项目文档。它的设计目标非常明确:让创建美观、实用的文档网站变得尽可能轻松。 + +### 核心特点 + +**1. 极简配置** + +- 只需一个 YAML 配置文件 (`mkdocs.yml`) + +- 几分钟内即可搭建起完整的文档站点 + +**2. Markdown 驱动** + +- 所有内容都使用 Markdown 编写 + +- 对开发者友好,学习成本低 + +**3. 丰富的主题系统** + +- 内置多个主题(如 `material`、`readthedocs`) + +- Material for MkDocs 主题尤为强大,支持: + + - 响应式设计 + + - 深色/浅色模式 + + - 搜索功能 + + - 多级导航 + + - 代码高亮 + +### 在你的 DevOps 平台中的角色 + +在你的“个人超级 DevOps 平台”中,**MkDocs 作为个人知识库**: + +text + +# 典型结构 + +docs/ # 你的知识库 +├── index.md # 首页 +├── devops-platform.md # DevOps平台搭建记录 +├── kubernetes-guide.md # K8s学习笔记 +├── api-references/ # API文档 +└── troubleshooting.md # 排错手册 +mkdocs.yml # 配置文件 + +### 为什么适合你的技术栈? + +**与你的其他组件完美集成:** + +1. **与 Gitea 结合** + + - 将 MkDocs 源码存储在 Gitea 中 + + - 使用 Git Hook 自动构建和部署文档 + + - 用 Gitea 的 Wiki 做协作,MkDocs 做正式知识库 + +2. **与 MinIO 结合** + + - 将构建的静态文档网站托管到 MinIO + + - 使用 MinIO 作为文档附件存储 + +3. **作为知识沉淀中心** + + - 记录你的 DevOps 平台搭建过程 + + - 编写团队技术规范 + + - 整理问题解决方案 + +### 快速示例 + +**安装:** + +bash + +pip install mkdocs mkdocs-material + +**创建新站点:** + +bash + +mkdocs new my-knowledge-base +cd my-knowledge-base + +**简单配置 (`mkdocs.yml`):** + +yaml + +site_name: 我的技术知识库 +theme: + name: material + features: + - navigation.tabs + - navigation.sections + - search.suggest + - search.highlight + +nav: + +- 首页: index.md +- DevOps平台: + - 架构设计: devops/architecture.md + - 部署指南: devops/deployment.md +- 移动开发: + - CI/CD流程: mobile/ci-cd.md + - 发布管理: mobile/release.md + +**编写内容 (`docs/index.md`):** + +markdown + +# 欢迎来到我的知识库 + +这里是个人超级 DevOps 平台的所有技术文档。 + +## 平台组件 + +- **代码管理**: Gitea +- **依赖管理**: Nexus +- **文档管理**: MkDocs +- **监控告警**: Sentry + Grafana + +**本地预览:** + +bash + +mkdocs serve + +# 在 http://localhost:8000 查看 + +### 进阶用法 + +**版本化文档:** + +yaml + +theme: + name: material + features: + - navigation.tabs + - navigation.tabs.sticky + language: zh + +extra: + version: + provider: mike + +plugins: + +- search +- mike: + alias_type: symlink + +**与 CI/CD 集成:** + +yaml + +# GitLab CI 示例 + +pages: + stage: deploy + script: + - pip install mkdocs mkdocs-material + - mkdocs build + - mv site public + artifacts: + paths: + - public + only: + - main + +### 优势总结 + +✅ **简单易用** - Markdown 编写,配置简单 +✅ **维护方便** - 版本控制友好 +✅ **部署灵活** - 生成静态文件,可托管到任何地方 +✅ **搜索强大** - 内置全文搜索 +✅ **移动友好** - 响应式设计 +✅ **社区活跃** - 丰富的插件生态 + +在你的 DevOps 生态中,MkDocs 是**文档即代码**理念的完美实践,它让技术文档的编写、维护和发布变得和写代码一样规范高效。 + +vscode下载 + +我来详细介绍如何下载和安装 Visual Studio Code (VSCode),这是开发者必备的代码编辑器。 + +## 下载 VSCode 的几种方式 + +### 1. **官方网站下载**(最推荐) + +**访问官网:** [https://code.visualstudio.com/](https://code.visualstudio.com/) + +官网会自动检测你的操作系统,推荐合适的版本: + +- **Windows 用户**:下载 `.exe` 安装包 + +- **macOS 用户**:下载 `.dmg` 文件或 `.zip` 压缩包 + +- **Linux 用户**:提供多种包格式(`.deb`, `.rpm`, `.tar.gz`) + +### 2. **各平台具体下载地址** + +**Windows:** + +text + +https://code.visualstudio.com/sha/download?build=stable&os=win32-x64-user + +**macOS:** + +- Intel 芯片: + +text + +https://code.visualstudio.com/sha/download?build=stable&os=darwin + +- Apple Silicon (M1/M2/M3): + +text + +https://code.visualstudio.com/sha/download?build=stable&os=darwin-arm64 + +**Linux:** + +text + +https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-x64 + +### 3. **使用包管理器安装** + +**Windows (Winget):** + +bash + +winget install Microsoft.VisualStudioCode + +**macOS (Homebrew):** + +bash + +brew install --cask visual-studio-code + +**Ubuntu/Debian:** + +bash + +sudo apt update +sudo apt install software-properties-common apt-transport-https wget +wget -q https://packages.microsoft.com/keys/microsoft.asc -O- | sudo apt-key add - +sudo add-apt-repository "deb [arch=amd64] https://packages.microsoft.com/repos/vscode stable main" +sudo apt update +sudo apt install code + +**CentOS/RHEL/Fedora:** + +bash + +sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc +sudo sh -c 'echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/vscode.repo' +sudo dnf install code # 或 sudo yum install code + +### 4. **便携版下载** + +如果你想要免安装版本: + +- **Windows**:下载 `VSCode-win32-x64-XX.X.X.zip` + +- **macOS**:下载 `VSCode-darwin-x64-XX.X.X.zip` + +- **Linux**:下载 `VSCode-linux-x64-XX.X.X.tar.gz` + +## 安装步骤 + +### **Windows 安装** + +1. 下载 `.exe` 安装包 + +2. 双击运行安装程序 + +3. 同意许可协议 + +4. 选择安装选项(推荐勾选): + + - ✅ 将“通过 Code 打开”操作添加到 Windows 资源管理器文件上下文菜单 + + - ✅ 将“通过 Code 打开”操作添加到 Windows 资源管理器目录上下文菜单 + + - ✅ 将 Code 注册为受支持的文件类型的编辑器 + + - ✅ 添加到 PATH(允许从命令行运行 `code`) + +### **macOS 安装** + +1. 下载 `.dmg` 文件 + +2. 双击打开磁盘映像 + +3. 将 VSCode 图标拖到“应用程序”文件夹 + +4. 首次运行时,可能会提示“无法打开”,需要: + + - 右键点击 VSCode → 打开 + + - 或在“系统偏好设置 → 安全性与隐私”中允许打开 + +### **Linux 安装** + +**使用 .deb 包 (Ubuntu/Debian):** + +bash + +sudo dpkg -i code_*.deb +sudo apt-get install -f # 安装依赖 + +## 首次设置建议 + +安装完成后,建议进行以下配置: + +### 1. **安装中文语言包** + +1. 打开 VSCode + +2. 按 `Ctrl+Shift+X` 打开扩展面板 + +3. 搜索 `Chinese (Simplified)` + +4. 点击安装并重启 + +### 2. **推荐扩展**(根据你的 DevOps 需求) + +**通用开发:** + +- `GitLens` - Git 增强 + +- `Git History` - Git 历史查看 + +- `Error Lens` - 错误提示增强 + +- `Path Intellisense` - 路径自动补全 + +**DevOps 相关:** + +- `Docker` - Docker 支持 + +- `Kubernetes` - K8s 支持 + +- `YAML` - YAML 语言支持 + +- `HashiCorp Terraform` - Terraform 支持 + +**文档编写:** + +- `Markdown All in One` - Markdown 增强 + +- `markdownlint` - Markdown 格式检查 + +- `Paste Image` - 粘贴图片到 Markdown + +**你的技术栈扩展:** + +- `Gradle for Java` - Gradle 支持 + +- `MinIO` - MinIO 文件管理 + +- `Gitea` - Gitea 集成 + +### 3. **常用配置** + +json + +// settings.json +{ + "editor.fontSize": 14, + "editor.tabSize": 2, + "editor.formatOnSave": true, + "editor.codeActionsOnSave": { + "source.fixAll": "explicit" + }, + "files.autoSave": "afterDelay", + "terminal.integrated.defaultProfile.windows": "Git Bash", + "workbench.colorTheme": "Default Dark Modern", + "workbench.iconTheme": "material-icon-theme" +} + +## 便携版使用(无需安装) + +如果你下载的是便携版: + +**Windows:** + +1. 解压 `VSCode-win32-x64-XX.X.X.zip` 到任意目录 + +2. 运行 `Code.exe` + +**macOS/Linux:** + +1. 解压压缩包 + +2. 进入解压目录,运行 `./Code`(可能需要 `chmod +x`) + +## 验证安装 + +打开终端/命令提示符,输入: + +bash + +code --version + +# 或 + +code --help + +如果正确安装,会显示版本信息: + +text + +1.84.2 +... + +## 小贴士 + +1. **自动更新**:VSCode 默认启用自动更新,可以在设置中调整 + +2. **Insiders 版本**:如果想体验最新功能,可以下载 [VSCode Insiders](https://code.visualstudio.com/insiders/) + +3. **同步设置**:登录 Microsoft/GitHub 账号可同步设置到不同设备 + +4. **命令行使用**:安装时添加到 PATH 后,可以在终端中用 `code .` 打开当前目录 + +## 快速开始 + +安装完成后,你可以: + +1. 按 `F1` 或 `Ctrl+Shift+P` 打开命令面板 + +2. 输入 `>Git: Clone` 克隆你的 Gitea 仓库 + +3. 开始编写你的 DevOps 平台代码和文档 + +VSCode 是搭建和维护你的“个人超级 DevOps 平台”的绝佳工具,配合你提到的 Gitea、MkDocs 等组件,能极大提升开发效率! + +- **Typora**(所见即所得) + 下载 + +# Typora 下载和安装指南 + +## 官方下载渠道 + +### 1. **官方网站** + +**访问:** [https://typora.io/](https://typora.io/) + +点击首页的 "Download" 按钮,会自动推荐适合你系统的版本。 + +### 2. **各平台直接下载链接** + +**Windows:** + +- 64位:https://typora.io/windows/typora-setup-x64.exe + +- 32位:https://typora.io/windows/typora-setup-ia32.exe + +**macOS:** + +- Intel:https://typora.io/mac/Typora.dmg + +- Apple Silicon (M1/M2/M3):https://typora.io/mac/Typora.dmg (通用版本) + +**Linux:** + +bash + +# Debian/Ubuntu + +wget -qO - https://typora.io/linux/public-key.asc | sudo tee /etc/apt/trusted.gpg.d/typora.asc +sudo add-apt-repository 'deb https://typora.io/linux ./' +sudo apt update +sudo apt install typora + +# 或直接下载 .deb 包 + +https://typora.io/linux/Typora-linux-x64.deb + +### 3. **国内镜像/备用下载** + +由于网络原因,如果官网下载慢,可以尝试: + +**GitHub Releases:** + +text + +https://github.com/typora/typora-issues/releases + +**第三方镜像站:** + +- 腾讯软件中心:https://pc.qq.com/detail/10/detail_22850.html + +- 华为云镜像:https://mirrors.huaweicloud.com/typora/ + +## 安装步骤 + +### **Windows 安装** + +1. 下载 `.exe` 安装包 + +2. 双击运行安装程序 + +3. 选择安装位置(默认 `C:\Program Files\Typora`) + +4. 创建桌面快捷方式和开始菜单项 + +5. 完成安装 + +### **macOS 安装** + +1. 下载 `.dmg` 文件 + +2. 双击打开磁盘映像 + +3. 将 Typora 图标拖到 "应用程序" 文件夹 + +4. 首次运行时,如果提示 "无法打开": + + - 右键点击 Typora → 打开 + + - 或进入 "系统偏好设置 → 安全性与隐私" → 点击 "仍要打开" + +### **Linux 安装** + +bash + +# 使用 .deb 包安装 + +sudo dpkg -i Typora-linux-x64.deb +sudo apt install -f # 修复依赖 + +# 或使用 Snap + +sudo snap install typora + +## 许可证激活 + +**注意:Typora 现在是付费软件**(从 2021.11 开始) + +### 1. **试用版** + +- 提供 15 天免费试用 + +- 试用期满后需要购买许可证 + +### 2. **购买许可证** + +1. 访问:[https://store.typora.io/](https://store.typora.io/) + +2. 选择许可证类型: + + - **个人版**:$14.99(3台设备) + + - **商业版**:$29.99(3台设备) + + - **教育优惠**:有折扣 + +3. 购买后会收到许可证密钥 + +### 3. **激活步骤** + +1. 打开 Typora + +2. 菜单栏选择 `帮助 → 我的许可证...` + +3. 输入邮箱和许可证密钥 + +4. 激活成功 + +## 替代方案(如果你不想付费) + +### **免费开源替代品** + +1. **MarkText** - 类似 Typora 的免费开源编辑器 + + - GitHub:[GitHub - marktext/marktext: 📝A simple and elegant markdown editor, available for Linux, macOS and Windows.](https://github.com/marktext/marktext) + + - 下载:[Releases · marktext/marktext · GitHub](https://github.com/marktext/marktext/releases) + +2. **Obsidian** - 强大的知识库工具,免费个人使用 + + - 官网:[https://obsidian.md/](https://obsidian.md/) + +3. **Zettlr** - 学术写作的 Markdown 编辑器 + + - 官网:[https://www.zettlr.com/](https://www.zettlr.com/) + +4. **VSCode + Markdown 扩展** + + bash + + # 安装以下扩展 + + 1. Markdown All in One + 2. Markdown Preview Enhanced + 3. Markdown Preview Github Styling + +### **旧版本 Typora** + +如果你有旧版本 (v0.11.18 及之前),可以继续使用: + +- GitHub 旧版本下载:https://github.com/typora/typora-issues/issues/8102 + +- **注意**:旧版本可能存在安全漏洞 + +## Typora 基本使用 + +### 1. **界面概览** + +text + +左侧:文件树或大纲视图 +中间:编辑区域(所见即所得) +右侧:大纲导航 + +### 2. **常用快捷键** + +- `Ctrl + /`:切换源代码模式 + +- `Ctrl + B`:加粗 + +- `Ctrl + I`:斜体 + +- `Ctrl + K`:插入链接 + +- `Ctrl + Shift + I`:插入图片 + +- `Ctrl + T`:插入表格 + +- `Ctrl + Shift + M`:数学公式 + +- `Ctrl + 1~6`:标题级别 + +### 3. **与你的 DevOps 平台集成** + +**配合 Gitea:** + +1. 在 Typora 中编写 Markdown 文档 + +2. 保存到 Git 仓库目录 + +3. 使用 Git 命令或 Git 客户端提交到 Gitea + +**配合 MkDocs:** + +yaml + +# mkdocs.yml 配置 Typora 兼容 + +markdown_extensions: + +- admonition +- codehilite +- footnotes +- meta +- toc: + permalink: true +- pymdownx.superfences +- pymdownx.tabbed + +### 4. **图片处理配置** + +yaml + +# Typora 偏好设置 → 图像 + +- 复制图片到 ./${filename}.assets 文件夹 +- 对本地位置的图片应用上述规则 +- 对网络位置的图片应用上述规则 + +## 主题和样式 + +### 内置主题: + +1. **Github** - GitHub 风格 + +2. **Night** - 深色主题 + +3. **Pixyll** - 简洁风格 + +4. **Whitey** - 纯白简洁 + +### 自定义 CSS: + +1. 打开主题文件夹:`文件 → 偏好设置 → 外观 → 打开主题文件夹` + +2. 创建 `user.base.user.css` 文件 + +3. 添加自定义样式: + +css + +/* 自定义样式 */ +body { + font-family: "Microsoft YaHei", sans-serif; + max-width: 900px; + margin: 0 auto; +} + +img { + border-radius: 8px; + box-shadow: 0 2px 8px rgba(0,0,0,0.1); +} + +## 常见问题解决 + +### Q1: 下载速度慢? + +- 使用国内镜像站 + +- 使用下载工具(IDM、迅雷等) + +- 尝试 GitHub Releases + +### Q2: 安装失败? + +**Windows:** + +- 以管理员身份运行 + +- 关闭杀毒软件临时 + +- 检查系统版本(需要 Win7 以上) + +**macOS:** + +bash + +# 如果提示 "已损坏" + +sudo xattr -rd com.apple.quarantine /Applications/Typora.app + +**Linux:** + +bash + +# 依赖问题 + +sudo apt --fix-broken install + +### Q3: 许可证问题? + +- 检查网络连接 + +- 确认邮箱和密钥正确 + +- 访问 https://typora.io/dev_release.html 检查服务状态 + +## 推荐配置(用于 DevOps 文档) + +### 1. **工作流设置** + +text + +1. 在 Typora 中编写 Markdown +2. 保存到 Git 管理的 docs/ 目录 +3. 使用 MkDocs 构建静态网站 +4. 部署到服务器或 GitHub Pages + +### 2. **写作模板** + +创建模板文件 `template.md`: + +markdown + +--- + +title: {{title}} +date: {{date}} +tags: +category: + +--- + +# {{title}} + +## 概述 + +## 详细内容 + +## 参考链接 + +### 3. **自动化脚本** + +bash + +#!/bin/bash + +# auto_build.sh - 自动构建文档 + +cd /path/to/docs +typora --wait-for-signal-to-close document.md +mkdocs build +git add . +git commit -m "Update documentation" +git push + +## 总结 + +Typora 是一款优秀的 Markdown 编辑器,特别适合: + +- 个人知识库管理(配合你的 MkDocs) + +- 技术文档编写 + +- 日常笔记记录 + +如果你需要完全免费的方案,建议考虑 **MarkText** 或 **Obsidian**。对于你的 DevOps 平台,Typora 的所见即所得特性确实能提升 Markdown 文档的编写体验。 + +本回答由 AI 生成,内容仅供参考,请仔细甄别。 + +image.png + +PNG 33.06KB + +下载好了,如何安装 + +根据你提供的信息,你已经下载了 MarkText 的 Windows 安装文件。以下是详细的安装步骤: + +## 方法一:使用安装向导(推荐) + +### 步骤: + +1. **找到下载的文件** + + - 通常在 `Downloads`(下载)文件夹中 + + - 文件名类似:`marktext-setup-x.x.x.exe`(x.x.x 是版本号) + +2. **运行安装程序** + + - 双击 `.exe` 文件 + + - 如果出现安全警告,点击"运行"或"更多信息 → 仍要运行" + +3. **选择安装类型** + + text + + Install for: (选择安装范围) + □ Just me (当前用户) + ☑ All users (requires admin privileges) (所有用户,需要管理员权限) + + - **推荐选择**:`All users`(需要管理员权限) + +4. **选择安装位置** + + - 默认位置:`C:\Program Files\MarkText\` + + - 可以点击"Browse"更改安装路径 + +5. **创建快捷方式** + + - 桌面快捷方式(推荐勾选) + + - 开始菜单文件夹 + +6. **完成安装** + + - 点击"Install"开始安装 + + - 安装完成后点击"Finish" + +## 方法二:使用包管理器安装 + +### 如果已经下载了安装包,直接使用方法一即可。以下是使用包管理器的方法: + +### 1. **使用 Chocolatey**(需要先安装 Chocolatey) + +cmd + +# 以管理员身份打开命令提示符或 PowerShell + +choco install marktext + +### 2. **使用 Winget**(Windows 11 自带,Win10 可能需要安装) + +cmd + +# 以管理员身份打开终端 + +winget install marktext + +## 验证安装 + +### 检查是否安装成功: + +1. **启动程序** + + - 从开始菜单搜索"MarkText" + + - 双击桌面快捷方式(如果创建了) + +2. **命令行验证** + + cmd + + # 打开命令提示符或 PowerShell + + marktext --version + + # 或 + + marktext --help + +3. **文件关联**(可选) + + - 安装后,MarkText 可能会询问是否关联 `.md` 文件 + + - 点击"是"即可用 MarkText 打开所有 Markdown 文件 + +## 首次使用设置 + +### 1. **选择主题** + +打开 MarkText 后,你会看到: + +- **Dark Theme** - 深色主题 + +- **Light Theme** - 浅色主题 + +- **Graphite Theme** - 石墨主题 + +- **Ulysses Theme** - Ulysses 风格 + +- **Material Dark** - Material 深色 + +- **Cadmium Light** - 镉浅色 + +### 2. **基本配置** + +按 `Ctrl+,` 打开设置: + +json + +{ + // 编辑器设置 + "autoSave": true, // 自动保存 + "autoSaveDelay": 1000, // 自动保存延迟(毫秒) + "defaultFontSize": 16, // 默认字体大小 + + // 编辑器行为 + "editorLineWidth": 800, // 编辑器行宽 + "fontFamily": "Arial", // 字体 + + // Markdown 设置 + "preferLooseListItem": true, // 宽松列表 + "bulletListMarker": "-", // 列表标记 + + // 图像设置 + "imageFolderPath": "assets", // 图片保存文件夹 + "setImageFolder": true // 自动创建图片文件夹 +} + +### 3. **设置中文界面** + +1. 按 `Ctrl+,` 打开设置 + +2. 搜索 `locale` + +3. 将 `locale` 改为 `zh-CN` + +4. 重启 MarkText + +## 常见问题解决 + +### Q1:安装时提示"需要管理员权限"? + +- **解决方法**: + + 1. 右键点击安装程序 + + 2. 选择"以管理员身份运行" + + 3. 或者选择"Just me"(仅当前用户)安装选项 + +### Q2:安装后无法启动? + +- **解决方法**: + + 1. 重启电脑 + + 2. 检查防病毒软件是否阻止 + + 3. 重新安装 + + 4. 查看 Windows 事件查看器中的错误信息 + +### Q3:如何卸载? + +cmd + +# 方法1:控制面板卸载 + +# 方法2:使用包管理器 + +winget uninstall marktext + +# 或 + +choco uninstall marktext + +## 快速开始使用 + +### 1. **创建第一篇文档** + +1. 按 `Ctrl+N` 新建文件 + +2. 输入内容: + + markdown + + # 我的第一篇 Markdown + + ## 这是副标题 + + - 列表项1 + - 列表项2 + + **粗体文本** *斜体文本* + + [链接](https://example.com) + +3. 按 `Ctrl+S` 保存 + +### 2. **常用快捷键** + +- `Ctrl+N`:新建文件 + +- `Ctrl+O`:打开文件 + +- `Ctrl+S`:保存 + +- `Ctrl+Shift+S`:另存为 + +- `Ctrl+/`:切换源代码模式 + +- `Ctrl+B`:加粗 + +- `Ctrl+I`:斜体 + +- `Ctrl+K`:插入链接 + +- `Ctrl+Shift+I`:插入图片 + +### 3. **与你的 DevOps 平台集成** + +将 MarkText 作为你的 Markdown 编辑器: + +bash + +# 在 Git 仓库中编辑文档 + +cd /path/to/your/docs + +# 用 MarkText 打开文件 + +marktext README.md + +# 或 + +marktext . + +## 高级功能 + +### 1. **多标签页** + +- 支持同时打开多个文件 + +- 标签页可拖拽重新排列 + +### 2. **多种编辑模式** + +- **源代码模式** - 纯文本编辑 + +- **打字机模式** - 当前行居中 + +- **专注模式** - 淡化其他内容 + +### 3. **导出功能** + +支持导出为: + +- HTML + +- PDF + +- 纯文本 + +### 4. **Git 集成** + +内置简单的 Git 支持: + +- 显示 Git 状态 + +- 提交消息 + +- 差异对比 + +## 配置为默认 Markdown 编辑器 + +### Windows 10/11: + +1. 右键点击 `.md` 文件 + +2. 选择"打开方式" → "选择其他应用" + +3. 找到 MarkText,勾选"始终使用此应用打开 .md 文件" + +4. 点击"确定" + +完成安装后,你就可以用 MarkText 来编写你的 MkDocs 文档、技术笔记等,配合你的 DevOps 平台使用了! + +image.png + +PNG 64.83KB + +点击哪个文件安装呢? + +从你提供的文件列表来看,这是一个 **MarkText 的源代码项目目录**,而不是可以直接安装的安装程序。 + +让我帮你分析一下: + +## 📁 **目录结构分析** + +text + +├── docs/ # 文档文件夹 +├── src/ # 源代码文件夹 +├── static/ # 静态资源 +├── resources/ # 应用资源 +├── package.json # Node.js 项目配置文件 +├── electron-builder.yml # Electron 构建配置 +└── 其他配置文件... + +## 🚨 **重要:这不是安装包!** + +你下载的是 **MarkText 的源代码**,需要**编译构建**后才能得到安装程序。 + +## 🛠️ **如何正确安装 MarkText** + +你有两个选择: + +### **选择一:下载正式安装包(推荐)** + +1. **访问 MarkText 官方发布页**: + [Releases · marktext/marktext · GitHub](https://github.com/marktext/marktext/releases) + +2. **下载正确的安装包**: + + - Windows:`marktext-setup-x.x.x.exe` (x.x.x是版本号) + + - macOS:`marktext-x.x.x.dmg` + + - Linux:`marktext-x.x.x-x86_64.AppImage` + +3. **双击安装包安装** + +### **选择二:从源码构建安装** + +如果你确实想从这个源码构建: + +bash + +# 1. 安装 Node.js (v14+) + +# 从 https://nodejs.org/ 下载安装 + +# 2. 安装 Yarn + +npm install -g yarn + +# 3. 进入项目目录 + +cd "你下载的文件夹路径" + +# 4. 安装依赖 + +yarn install + +# 5. 运行开发版本 + +yarn run dev + +# 6. 构建安装包(可选) + +yarn run build + +## 📦 **快速对比** + +| 类型 | 文件 | 说明 | +| --------- | --------------------------- | ------ | +| **✅ 安装包** | `.exe`, `.dmg`, `.AppImage` | 双击即可安装 | +| **❌ 源代码** | 文件夹 + 配置文件 | 需要编译构建 | + +## 🔍 **检查你下载的文件** + +如果你是通过以下方式下载的: + +- **GitHub 的绿色 "Code" 按钮** → 下载的是源代码 + +- **Git clone 命令** → 下载的是源代码 + +- **Release 页面的 "Source code"** → 下载的是源代码 + +**正确的方式**:在 Release 页面找到 **Assets**(资源)部分,下载那里的文件。 + +## 🎯 **立即获取安装包的步骤** + +1. **访问**:[Releases · marktext/marktext · GitHub](https://github.com/marktext/marktext/releases) + +2. **找到最新版本**(如 v0.17.1) + +3. **展开 "Assets"** 部分 + +4. **下载对应系统的文件**: + + text + + Windows用户下载: + marktext-setup-x.x.x.exe (约 90 MB) + 或 + marktext-setup-x.x-x64.exe + +## 💡 **如果你已经下载了源代码** + +你可以: + +1. **保留源代码**:用于学习或二次开发 + +2. **删除源代码**:如果你只需要使用软件 + +## 📝 **总结建议** + +**普通用户**:直接去 Release 页面下载安装包,简单快捷 +**开发者**:可以保留源代码进行学习和定制 + +**记住这个关键点**: + +- **`.exe` 文件** = 可以直接安装 + +- **文件夹+配置文件** = 需要编译构建 + +现在就去 Release 页面下载真正的安装包吧!这样你就能立即开始使用 MarkText 了。 diff --git a/未命名 1.base b/未命名 1.base index e69de29..f165474 100644 --- a/未命名 1.base +++ b/未命名 1.base @@ -0,0 +1,3 @@ +views: + - type: table + name: 表格