系统环境

• macOS Sonoma
• VSCode
• Continue
• Ollama

VSCode

你可以从其官方网站下载 VS Code：https://code.visualstudio.com/

Continue 插件

在 VS Code 的扩展商店中搜索并安装 "Continue" 插件。

Continue 将模型分为以下四种类型：

• Chat model（聊天模型）
• Autocomplete model（自动补全模型）
• Embeddings model（嵌入模型）
• Reranking model（重排模型）

Ollama

之前写过一篇关于 DeepSeek 离线使用的文章，可参考：DeepSeek离线使用

Chat 功能模型

Qwen2.5-Coder 简介

通义千问2.5-Coder（Qwen2.5-Coder）是阿里云最新推出的专注于代码处理的 Qwen 大语言模型系列，亦称为 CodeQwen。该系列提供六种主流模型尺寸：0.5B、1.5B、3B、7B、14B 和 32B，以满足不同开发人员的多样化需求。通过对海量代码数据进行训练，Qwen2.5-Coder 在保持强大数学和推理能力的基础上，显著增强了在代码应用场景中的表现。

ollama pull qwen2.5-coder:7b-instruct

Autocomplete 模型

Continue 推荐使用开源模型 StarCoder2-3B 作为自动补全模型。

ollama pull starcoder2:3b

我还尝试了 DeepSeek Coder 6.7B

ollama run deepseek-coder:6.7b

整体使用体验上来讲，StarCoder2-3B 快一些，当然这还是看个人环境配置。

Embedding 模型

官方推荐为 Nomic Embed Text 模型，这一模型很小。

ollama pull nomic-embed-text

Reranking

Reranking 目前暂时不用。

OpenWebUI

OpenWebUI 是一个 Ollama 官方支持的 Web 应用，通过它可实现一个类似 GPT 的页面。可以通过 Docker 方式安装：

docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

访问网页：http://localhost:3000/ 即可使用。

Continue

使用快捷键 Cmd+L 打开对话框：

添加 Chat 模型

Provider 选择为 Ollama，Model 选 Autodetect，会自动检测已经安装好的本地模型。

之后三个模型将会检测出来，并弹出 config.json 配置文件：

配置参考

"models": [
   {
     "title": "Qwen2.5 Coder 7B Instruct",
     "provider": "ollama",
     "model": "qwen2.5-coder:7b-instruct",
     "completionOptions": {
       "maxTokens": 2048 // 根据情况调整，默认600, 太少可能被截断
     },
     "useLegacyCompletionsEndpoint": false
   },
   {
     "model": "AUTODETECT",
     "title": "Autodetect",
     "provider": "ollama"
   }
 ],
 "tabAutocompleteModel": {
   "title": "StarCode2 3B",
   "provider": "ollama",
   "model": "starcoder2:3b"
 },
 "embeddingsProvider": {
   "provider": "ollama",
   "model": "nomic-embed-text"
 }

使用

Chat 模型使用的两种方式：

1. 选择代码后，对 AI 进行提问。

2. 通过 @ 方法进行提问。

@ 后，插件会检索目录文件，获取到对应的具体方法位置。

Autocomplete 模型使用

写代码的时候，AI 会生成代码。当出现建议时，按 Tab 键可以接受整个建议。不想使用当前的建议，按 Esc 键可以拒绝它。只想接受建议的一部分，可以使用更精细的控制，按 Cmd（Mac）或 Ctrl（Windows/Linux）+ 右箭头键 →。

Edit 功能使用

选中一段代码，按下 Cmd（Mac）或 Ctrl（Windows/Linux） + I 来激活 Edit 输入框。简单明了地描述需求，即可。

• 格式化代码
• 编写注释
• 生成单元测试
• 重构函数或方法

如果又有更长的描述需求，建议使用 Chat。

Action 功能

斜杠命令

Action

iTerm2安装

直接前往 iTerm2 官网 下载, 解压并双击安装

zsh安装

Oh My Zsh 是一款命令行工具，它基于 zsh 命令行，提供了丰富的主题、插件

# curl
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
# wget
sh -c "$(wget -O- https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

p10k安装

powerlevel10k 是一款 zsh 主题，快速、高效和开箱即用

安装

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ~/powerlevel10k
echo 'source ~/powerlevel10k/powerlevel10k.zsh-theme' >>~/.zshrc
source ~/.zshrc

配置

p10k configure

根据提示，选择即可

插件安装

支持的所有插件：https://github.com/ohmyzsh/ohmyzsh/wiki/Plugins

推荐几个插件：

• 代码高亮

  # zsh-syntax-highlighting
  git clone https://github.com/zsh-users/zsh-syntax-highlighting.git  ~/.   oh-my-zsh/plugins/zsh-syntax-highlighting
  
  配置：
  plugins=(... zsh-syntax-highlighting)

• 命令补全

  # zsh-autosuggestion
  git clone https://github.com/zsh-users/zsh-autosuggestions.git  ~/.oh-my-zsh/plugins/zsh-autosuggestions
  
  配置：
  plugins=(... zsh-autosuggestions)

• Z 目录跳转 : 通过z命令，直接跳转到访问最多的目录，要启用Z, 修改ZSHRC文件，plugin数组中添加z即可

plugins=(... z)

• kubectl

plugins=(... kubectl)

• asdf

plugins=(... asdf)

• tig

plugins=(... tig)

Shell Integration

当你SSH 到到远端服务器的时候，发现里面的 Host、User、Current Path 等信息不能和 Status bar同步，装它就对了。 当然，它功能不只如此，还可以文件上传下载、历史命令查看等.

安装

在安装完 iTerm2 的 shell integration 后会在终端界面中最左侧多出一个蓝色三角形的标记。如图：

标记说明当前 shell 支持 shell integration。如需关闭标记，可以在 iTerm2 > Preferences > Profiles > (your profile) > Terminal 最下面 > Shell Integration 关闭 Show mark indicators

服务端：

curl -L https://iterm2.com/shell_integration/bash \
-o ~/.iterm2_shell_integration.bash

编辑 ~/.bash_profile 或者 ~/.profile增加下面一行

source ~/.iterm2_shell_integration.bash

下载文件

注意 只有ls的才可以， ls -al 的可能会失败

上传文件

如果在 ~/.ssh/config 中配置了远端服务器的认证信息，然后SSH 到远端服务器后，cd 到期望上传的目录中,按住 Option 键，将文件拖入 iTerm 2 的窗口中，就会调用 scp 进行上传。

剪切板历史

ommand + Shift + h可以呼出粘贴历史，支持模糊检索。

既然是开源，那就可以本地部署 ，特别是B端企业，哈哈

Ollama 安装

直接去Ollama官方

安装完成后，去命令行测试下

运行模型

选择需要的模型，并复制命令即可。Ollama地址

为了测试，我这里选择了个1.5b 参数的小模型

命令行用起来还是不太方便的，推荐两个浏览器插件

1. Chrome: Page Assist
2. Edge: OLLAMA Chat

这样离线使用就方便多了。
当然，如果用不惯插件，可以使用Open-WebUI

提示词

转自 https://mp.weixin.qq.com/s/JHgJQiFK_nE8edpb-bpRWg

第一，明确问题核心

大家在使用GPT的时候，通常都是以“你是一个XXX，”作为开头，在使用DeepSeek时，你只需要直接讲出你的**“目标”和“场景”**，引擎会自行完成语义理解。

举个例子：

❌ 不当提问：
“我想学编程，但不知道怎么做，能告诉我吗？”

✅ 好的提问：
“作为零基础学习者，如何快速入门Python编程？请推荐学习路径和资源。”

第二，结构化描述

尽量结构化你的提问，如果问题比较复杂，可以分点说明背景、需求以及具体问题。

举例来说：

❌ 笼统的提问：
“帮我写一个代码。”

✅ 结构化提问：

“我需要用Python写一个爬虫，要求：

1. 爬取某网站文章标题和发布时间；
2. 数据保存为CSV文件；
3. 避免触发反爬机制。请提供示例代码和关键步骤说明。”

第三，使用关键词

尤其是在一些专业性比较强的领域，如金融、法律、计算机、生物等等，使用关键术语有助于AI识别和理解你想提问的领域。

示例：

❌ 不好的提问：
“如何提高阅读速度？”

✅ 关键词提问：
“有哪些科学验证的 速读技巧（如视幅扩展、减少回视）？请提供训练方法。”

第四，提供具体示例

当你需要做数据分析、解题或者处理复杂问题的时候，可以给出输入/输出案例，帮助AI更好的理解场景。

举例来说：
❌ 抽象的提问：
“怎么处理数据？”

✅ 示例化的提问：
“我有一组销售数据，格式如下：

如何用Excel计算 7天移动平均销售额？请分步说明公式。”

第五，限制范围

尽可能提出明确范围的问题，避免过于开放的问题，这样AI的回答会更精准、更有指导性。记得加上一句“用通俗的语言”，这样输出的内容可读性更强。

示例：
❌ 开放提问：
“什么是人工智能？”

✅ 限定范围提问：
“用通俗语言解释人工智能的 核心技术分支（如机器学习、深度学习、NLP），并说明其实际应用场景。”

第六，分步提问

复杂问题拆解为多个小问题，不要问大而全的问题、不要笼统提问。

举例：

❌ 大而全的提问：
“如何开发一个电商App？”

✅ 分步提问：

1. “开发一个电商App需要哪些核心技术栈？”
2. “请推荐适合新手的跨平台开发框架及学习资源。”
3. “设计用户登录功能时，如何确保安全性？”

第七，验证与追问

DeepSeek 支持追问、验证的多轮交互方式，根据回答进一步确认或补充信息，你会得到更有建设性的回答。

举例说明：
初始提问：
“量子计算的基本原理是什么？”
追问示例：
“您提到的‘量子叠加’和传统二进制有何区别？能否举例说明？”

总结

以上，就是官方给出的7个提问技巧，如果你仍然觉得麻烦，那么最后给你一个 通用提问模板，只要记住这一个就够了。

提问模板：

使用示例：

祝贺你，击败了90%的人，现在已经是DeepSeek高手了！

基本概念

易的定义

1. 变化
2. 不易
3. 易简

易——乾卦：时间、创造力

简—一坤卦：空间、承受力

八卦-两仪图

先天八卦图

中间太极图，又称 阴阳鱼

乾 - 天 - 天
坤 - 地 - 地
离 - 火 - 日
水 - 坎 - 月
震 - 雷 - 长男
巽 - 风 - 长女
艮 - 山 - 山
兑 - 泽 - 沼泽

乾坤生六子。（卦象变为家庭结构）

八卦歌

乾三连（天），坤六断（地）；
震仰盂（雷），艮覆碗（山）；
离中虚（火），坎中满（水）；
兑上缺（泽），巽下断（风）。

有兴趣可了解下后天八卦

八卦的象征

1. 乾：为父 为首 为马 为刚健
2. 坤：为母 为腹 为牛 为顺从
3. 震：为长男 为足 为龙 为行动
4. 巽：为长女 为股 为鸡 为顺利
5. 坎：为中男 为耳 为猪 为坎陷（危险的意思）
6. 离：为中女 为眼 为雉 为附丽（依靠、依附）
7. 艮：为少男 为手 为狗 为阻止
8. 兑：为少女 为口 为羊 为喜悦

经(卦爻辞)

周文王，姓姬名昌，生年不详。《易经》六十四卦卦辞、 (384)爻辞为其所作。

七年牢狱，在里面研究八卦

易经里的卦，其实是答案。这个和上学是不一样的，上学是通过题目找到答案，易经是通过答案，找到理由。时间长就累计了自己的经验。

卦序歌六十四卦卦序歌

64 等于 上30 下34

上下经卦名次序歌

乾坤屯（zhǔn）蒙需讼师， 比小畜（xù）兮履泰否，

同人大有谦豫随， 蛊临观兮噬嗑贲（bì），

剥复无妄大畜颐， 大过坎离三十备。

咸恒遁兮及大壮， 晋与明夷家人睽，

蹇（jiǎn）解损益夬（guài）姤（gòu）萃， 升困井革鼎震继，

艮渐归妹丰旅巽， 兑涣节兮中孚至，

小过既济兼未济， 是为下经三十四。

上下经卦变歌

讼自遁变泰归妹，否从渐来随三位。

首困噬嗑未济兼，蛊三变贲井既济。

噬嗑六五本益生，贲原于损既济会。

无妄讼来大畜需，咸旅恒丰皆疑似。

晋从观更睽有三，离与中孚家人系。

蹇利西南小过来，解升二卦相为赘。

鼎由巽变渐涣旅，涣自渐来终于是。

易传注

又称，十翼（辅助的意思，像10个翅膀）,是对卦爻辞的注释和解读，是后人对经典的阐发和解读，包括《彖传》、《象传》、《系辞传》、《文言传》等合称《十翼》。

彖传[tuàn chuán] 彖传

《彖传》为《易传》中的一部分，是解释六十四卦卦辞的

象传[xiàng zhuàn] 象传

“天行健，君子以自强不息”（乾卦☰）
“地势坤，君子以厚德载物”（坤卦☷）
“随风巽，君子以申命行事”（巽卦☴）
“渐雷震，君子以恐惧修省”（震卦☳）
“善如水，君子以作事谋始”（坎卦☵）
“火同人，君子以类族辨物”（离卦☲）
“步泽履，君子以辨民安志”（兑卦☱）
“艮山谦，君子以裒多益寡”（艮卦☶）

爻

卦中的一条条断开或者连接的横线 即为 爻

爻： 横为阳，断为阴，九为阳，六为阴

示例：

地山谦 （ 注意念法 ），最下面念初，最上面念上

当位（爻的位置）

初、三、五属刚位适合阳爻

二、四、上属柔位适合阴爻

自强不息-乾卦(上）

基本概念

为了足够通俗，俺先要介绍一些基本概念。

信道（channel）

这是通讯领域非常基本的概念，肯定要先聊聊它。
通俗地说，信道就是“传送信息的通道”。

信道的类型

首先，信道可以从广义上分为“物理信道 ＆ 逻辑信道”。
顾名思义，“物理信道”就是直接使用某种【物理介质】来传送信息；至于“逻辑信道”——是基于“物理信道”之上抽象出来的玩意儿（待会儿讲到“协议栈”的时候再聊）。

信道的带宽

“带宽”指的是：某个信道在单位时间内最大能传输多少比特的信息。
请注意：
电气领域 ＆ 计算机领域都有“带宽”这个概念，但两者的定义不太一样。电气领域所说的“带宽”指的是“模拟带宽”，单位是“赫兹/Hz”；计算机领域所说的“带宽”指“数字带宽”，单位是“比特率”或“字节率”。
后续章节提到“带宽”，都是指计算机领域的术语。

带宽的单位——容易把外行绕晕

“比特率”或“字节率”很容易搞混淆。用英文表示的话——大写字母 B 表示【字节】；小写字母 b 表示【比特】。

由于带宽的数字通常很大，要引入“K、M、G”之类的字母表示数量级，于是又引出一个很扯蛋的差异——“10进制”与“2进制”的差异。
【10进制】的 K 表示 1000；M 表示 1000x1000（1百万）
【2进制】的 K 表示 1024（2的10次方）；M 表示 1024x1024（2的20次方）
为了避免扯皮，后来国际上约定了一个规矩：对【2进制】的数量级要加一个小写字母 i。比如说：Ki 表示 1024；Mi 表示 1024x1024 ...... 以此类推。
举例：
1Kbps 表示“1000比特每秒”
1KiBps 表示“1024字节每秒”

信道的工作模式：单工 VS 半双工 VS 全双工

再来说说信道的工作模式。大致可以分为如下三种。为了让大伙儿比较好理解，俺对每一种都举相应的例子。

单工（simplex）
比如“电台广播”就是典型的【单工】。“电台”可以发信号给“收音机”，但“收音机”【不能】发信号给“电台”。

半双工（half-duplex）
比如“单条铁路轨道”，就是典型的【半双工】。火车在单条铁轨上，可以有两种运行方向；但对于同一个瞬间，只能选其中一个方向（否则就撞车了）。

全双工（full-duplex）
比如“光纤”就是典型的【全双工】。在同一根光导纤维中，可以有多个光束【同时相向】传播，互相不会干扰对方。

端点

为了叙述方便，俺把参与通讯的对象（主体）称作“通讯端点”，简称“端点”。
这里的“端点”是广义的，可以是硬件（比如某个网卡），也可以是软件（比如某个应用程序）。

单播、组播/多播、广播、选播

对于“网络通讯”，至少得有 N 个端点参与，并且【N ≥ 2】才有意义。
当 N 个端点构成一个网络，这时候就会涉及到“单播、组播、广播”这几个概念。
通俗地说：
单播（unicast）——发送给网络中的指定的【单个】端点
组播/多播（multicast）——发送给网络中的指定的【多个】端点
广播（broadcast）——发送给网络中的【所有】端点
选播（anycast）——发送给网络中随机选择的【单个】端点

通讯协议（protocol）

所谓的“通讯协议”就是：参与通讯的各方所采用的某种【约定】。只有大家都遵守这个约定，才有可能相互传递信息。
打个比方：如果两个人要用自然语言交流，前提是：双方使用相同（或相互兼容）的自然语言。
“通讯协议”就类似某种自然语言，参与通讯的多个端点，都必须能理解这个语言。

从“分层”到“参考模型”

分层

在聊“分层”之前，先说说“分工”。比如在一个公司中，通常设有不同的工种/岗位，这就【分工】。
对于网络通讯也是如此，不太可能用一种通讯协议完成所有的信息传递任务（注：对于特别简单的网络，或许有可能只用单一协议；但如今的网络通讯已经很复杂，用【单个】通讯协议包办所有事情，已经不太可能）
一旦采用了多种通讯协议，这几种协议之间，该如何配合捏？
在网络通讯领域，采用的是【分层】的设计思路。多个层次的协议在一起协同工作，技术上称作“协议栈”（洋文叫做“protocol stack”）。

协议栈的原理

对于多层次的协议栈。每个层次都有各自的“端点”（进行通讯的主体）。处于【同一层次】的两个端点会使用该层次的协议进行通讯（注：同一个层次的协议，可能只有一个，也可能有多个）。
除了最顶层，每个层次的端点会向其【直接】上层提供“服务”；除了最底层，每个层次的端点会调用【直接】下层提供的“服务”（这里所说的“服务”指某种“编程接口”，技术行话叫 API）。

（“协议栈”的示意图)

（“服务”与“协议”之间的关系)

逻辑信道

（前一个小节说了）每个层次会向上一个层次提供服务（API 调用）。对上层而言，调用下层提供的 API 发送信息，其效果相当于在使用某种【信道】进行通讯，这也就是俺在 基本概念 那个章节所说的“逻辑信道”。

（“逻辑信道”示意图)

数据格式的原理

大部分协议会把要传送的数据切割为 N 份，每一份就是一个数据包。
通常来说，数据包的格式有如下三部分：

头部
身体（也称作“有效载荷”）
尾部（注：很多协议没有尾部）

如果你收过快递，可以把“网络数据包”与“快递包裹”作一个对照——
数据包的“头/尾”，就类似于快递包裹的【包装袋】。数据包的“身体”，就类似于快递包裹里面的东西。

对于【相邻】两层的协议，【下】层包含【上】层。也就是说：下层协议的【载荷】就是上层协议的【整体】。
还是以快递举例：
假设你从网上买了一台笔记本电脑。电脑出厂时，电脑厂商肯定会提供一个包装盒。快递公司在寄送这台笔记本的时候，又会在笔记本的盒子外面再加一个包装袋。对应到网络协议——“快递公司的包装袋”相当于【下层】协议；“电脑厂商的包装盒”，相当于【上层】协议。

（上下层协议的格式及包含关系)

网络分层的参考模型

上述所说的“分层 ＆ 协议栈”只是一个抽象的（笼统的）思路。具体要分几层？每一层要干啥事儿？这些都是很有讲究滴！网络技术发展了几十年，已经有很多牛人提出了各种不同的划分方案，称之为“网络分层的参考模型”（为了打字省力，以下简称“模型”）。
在各种模型中，名气最大的当然是“OSI 模型”（洋文称作“OSI model”）。在后续的章节中，俺会以这个模型为主体，进行介绍。
除了“OSI 模型”还有一个很出名的模型是“TCP/IP 模型”（因为互联网很成功，它才跟着出名）。
对“TCP/IP 模型”的分层，不同的文章或书籍，说法不太一样（“3层、4层、5层”皆有），这就引发了一些争议。包括几位热心读者也在博客留言，表达不同意见。为了避免一家之言，贴出维基百科的“这个链接”，其中给出了几种比较有名的说法。
另外，俺想提醒一下：
由于本文是基于【OSI 模型】进行展开。对于 TCP/IP 模型到底算几层，这方面的争论【不】影响本文后续的内容。

OSI 概述

OSI 的历史

“OSI”的全称是“Open System Interconnection”。先说说它的历史。
上世纪70年代，“国际电信联盟”（ITU）想对各国的电信系统（电话/电报）建立标准化的规格；与此同时，“国际标准化组织”（ISO）想要建立某种统一的标准，使得不同公司制造的大型主机可以相互联网。
后来，这两个国际组织意识到：“电信系统互联”与“电脑主机互联”的性质差不多。于是 ISO 与 ITU 就决定合作，两家一起干。这2个组织的2套班子，从上世纪70年代开始搞，搞来搞去，搞了很多年，一直到1984年才终于正式发布 OSI 标准。

OSI 标准的两个组成部分

严格来讲，OSI 包括两大部分——
其一，抽象的概念模型，也就是前面提到的【OSI model】；
其二，针对这个概念模型的具体实现（具体的通讯协议），洋文叫做【OSI protocols】。

（前面说了）OSI 是由 ISO ＆ ITU 联手搞出来滴。这两个国际组织里面的人，要么是来自各国的电信部门，要么是来自各国的高校学者。总而言之，既有严重的官僚风气，又有明显的学究风气。（正是因为这两种风气叠加，所以搞了很多年，才搞出 OSI）
OSI 的协议实现（OSI protocols），不客气地说，就是一堆垃圾——据说把 OSI protocols 所有的协议文档，全部打印成 A4 纸，摞起来得有一米多高！是不是很吓人？协议搞得如此复杂，严重违背了 IT 设计领域的 KISS 原则。
由于 OSI protocols 实在太复杂，后来基本没人用。但 OSI model 反而广为流传，并且成为“网络分层模型”中名气最大，影响力最广的一个。
因此，本文后续章节中，凡是提到 OSI，指的是【OSI model】。

OSI 模型的7层

OSI 模型总共分7层，示意图参见如下表格：

| 层次 | 中文名 | 洋文名 |
|

认识车架各个部位名称

确认碗组类型

头管内部是这个样子

没有卡轴承的地方

需要装外置碗组

此图为头管的横截面

上下一样大是叫直管的头管

上小下大为椎管

PS：直管的头管不代表只能装直管前叉

头管

椎管头管也不代表只能装椎管前叉

注意安装转换碗组后

头管下部分会突出一块大概1cm

如果对车架几何非常挑剔的人要注意

还有很老的1英寸的前叉现在都没了，淘汰了

以及还有很阴间的捷安特od2规格

市面上绝大多数的前叉尺寸都是上面这俩规格

所以只要碗组跟车架能适配就行了

·还有一些车架自带的有可调碗组

·这种车肯定会给你配好你需要的所有的东西

·例如stumpjumper evo的车架

·直管转椎管转换座

·想把老的牛逼前叉装现代车很好的方案例如：rockshox的图腾

把立盖螺丝

把立盖（碗组盖）

花心 碗组安装顺序

防水盖 外置碗组要先把轴承碗

装到车架上

束紧环（铝斜管）

上下轴承

前叉底挡（直管，椎管）

碳纤维舵管花心

舵管规格讲过了就不过多赘述

前叉行程

轮径

偏移量，花鼓开裆，碟片尺寸

前叉行程决定了你这根前叉的总长度

几乎所有的车架在出厂的时候就设定好了长度

前叉行程

如果没经验的话不要私自更改

前叉长了你的车头会高，整个车的几何都会有影响最关键的是会增大头管的压力，有断头管的风险私自更改几何之后有质保的车架一般也都会拒保查找你车架的详情页，看前叉的行程是多少就ok

轮径一般就是26,27.5,29

按照车架规定好的就行

加大轮径变相的也是加长了前叉行程

如果要大一号，例如27.5改到29的前轮

前叉行程短20mm的话影响不大

来自B站：叫我小姜咯

这里主要用 pymysql 和threading。

• pymysql 用来做CRUD
• threading 用来处理并发

#!/usr/bin/python3
# -*- coding: utf-8 -*-

import requests
import logging
import pymysql
from threading import Thread

#
DBHOST = "192.168.1.32"
DBUSRE = "root"
DBPASSWORD = "xxxxxx"
DBPORT = 3306
PROMETHEUS = "http://192.168.3.130:9090/"

# db: jkprometheus
# table: alert_history_data

logging.basicConfig(format='%(asctime)s - %(pathname)s[line:%(lineno)d] - %(levelname)s: %(message)s',
                    level=logging.INFO)

class DBConnect(object):

    def __init__(self, host, user, password, port):
        self.host = host
        self.user = user
        self.password = password
        self.port = port

    def db_init(self):

        create_db = "CREATE DATABASE " \
                    "IF NOT EXISTS jkprometheus  " \
                    "DEFAULT CHARSET utf8 " \
                    "COLLATE utf8_general_ci"

        conn = pymysql.connect(host=self.host, user=self.user, password=self.password, port=self.port)
        cursor = conn.cursor()
        cursor.execute(create_db)
        conn.close()

    def table_init(self):
        use_db = "USE jkprometheus"
        alert_history_data = "CREATE TABLE " \
                       "IF NOT EXISTS alert_history_data" \
                       "( " \
                       "id int primary key auto_increment, " \
                       "project varchar(30) not null default '河南县域', " \
                       "instance varchar(30), " \
                       "job varchar(100), " \
                       "created datetime not null default CURRENT_TIMESTAMP, " \
                       "description varchar(2222)," \
                       "summary varchar(2222)," \
                       "alert_state varchar(2222)," \
                       "severity varchar(11)," \
                       "active_at varchar(100)" \
                       ")"
        conn = pymysql.connect(host=self.host, user=self.user, password=self.password, port=self.port)
        cursor = conn.cursor()
        cursor.execute(use_db)
        cursor.execute(alert_history_data)
        conn.close()

    def run_sql(self, sql):
        use_db = "USE jkprometheus"
        conn = pymysql.connect(host=self.host, user=self.user, password=self.password, port=self.port)
        cursor = conn.cursor()
        cursor.execute(use_db)
        try:
            result = cursor.execute(sql)
            conn.commit()
            return True, result
        except Exception as e:
            logging.error(repr(e))
            return True, repr(e)
        conn.close()


class JkPrometheus(object):

    def __init__(self, username=None, password=None, server=None, verify=False):
        self.username = username
        self.password = password
        self.server = server

        self._login = False
        self._token = None
        self._header = None

    @staticmethod
    def set_header(self, k, v):
        self._header[k] = v

    def login(self):
        self.set_header('Content-Type', 'application/json')

        return True

    def _is_login(self):
        # get_token_url = '{}/oauth/token'.format(self._server)

        self._login = True if self.login() else False

    def alert_data(self):
        url = "{}/api/v1/alerts".format(self.server)
        response = requests.get(url).json()
        # logging.info(response)

        if response['data']['alerts']:
            alerts = response['data']['alerts']

            return True, alerts
        else:
            return False, None


    def alert_history_insert(self, instance, job, description, summary,active_at, alert_state, severity):


        sql = 'select id from alert_history_data where active_at=\"{}\" and alert_state=\"{}\"'.format(active_at,alert_state)

        success, data =  DBConnect(user=DBUSRE, password=DBPASSWORD, host=DBHOST, port=DBPORT).run_sql(sql=sql)

        if not data:
            sql = 'INSERT INTO alert_history_data(instance, job, description, summary,active_at,alert_state,severity) ' \
                  'VALUES (\"{}\",\"{}\",\"{}\",\"{}\",\"{}\",\"{}\",\"{}\"' \
                  ');'.format(
                        instance,
                        job,
                        description,
                        summary,
                        active_at,
                        alert_state,
                        severity
                )
        else:
            sql = 'UPDATE alert_history_data SET  severity=\"{}\" WHERE active_at=\"{}\" and alert_state=\"{}\"'.format(severity,active_at,alert_state)

        DBConnect(user=DBUSRE, password=DBPASSWORD, host=DBHOST, port=DBPORT).run_sql(sql=sql)

if __name__ == '__main__':

    logging.info('alert_data - start')

    threads = list()

    DBConnect(user=DBUSRE, password=DBPASSWORD, host=DBHOST, port=DBPORT).db_init()
    DBConnect(user=DBUSRE, password=DBPASSWORD, host=DBHOST, port=DBPORT).table_init()

    prom = JkPrometheus(server=PROMETHEUS)
    success, alerts = prom.alert_data()


    def prom_to_mysql(instance, job, description, summary, active_at, alert_state, severity):
        prom.alert_history_insert(
            instance=instance,
            job=job,
            description=description,
            summary=summary,
            active_at=active_at,
            alert_state=alert_state,
            severity=severity
        )

    for alert in alerts:
        instance = alert.get('labels').get('instance')
        severity = alert.get('labels').get('severity')
        job = alert.get('labels').get('job')
        description = alert.get('annotations').get('description')
        summary = alert.get('annotations').get('summary')
        active_at = alert.get('activeAt')
        alert_state = alert.get('state')
        threads.append(Thread(target=prom_to_mysql, args=(instance, job, description, summary,active_at, alert_state,severity )))
        threads[-1].start()

    for thread in threads:
        thread.join()

    logging.info('alert_data - done')

| 耗材类型 | 优点 | 缺点 | 适用场景 |
|

可以创建3D可视化效果，例如静态图像、3D动画、VFX（视觉特效）快照和视频编辑。非常适合那些受益于其统一解决方案和响应式开发过程的独立和小型工作室

详情 参考中文社区 手册

Bilibili 笔记

常用操作

场景的编辑

位移：shift+鼠标中键

旋转：长按鼠标中键

缩放：滚动鼠标中键

位移：G

旋转: R

缩放 :S

再点击xyz，会沿着对应的轴向进行编辑

1：正面，3：侧面，5：透视图，7:顶图

实心点：最大化显示

/：独显

插件——node——勾选即可

键盘映射——可以设置相对应的快捷键

倒角：ctrl+B

透显：alt+z

循环切割：Ctrl +Ｒ

插入：　Ｉ

挤压：　Ｅ

选面 按I 插入，按E挤压

• 3D打印三个阶段，包括等材制造、减材制造和增材制造。
  • 等材制造： 例如打铁 铁锅等
  • 减材制造：例如机床切割等
  • 增材制造：3D打印
• 建模常见的两种方式。3D设计，3D扫描
• 四种常见的3D打印技术：光固化成型（SLA）、激光选区烧结、三维印刷（3DP）和熔融堆积（FDM）。

使用场景

当前的

1. 建筑行业
2. 玩具
3. 航空 航天 （未来的月球基地）
4. 影视制作（道具）
5. 汽车制作（特别是设计和概念车）
6. 医疗行业 （比如牙齿等定制器械
7. 文物（博物馆 复刻等
8. 食品行业（巧克力、蛋糕等等）

未来的

1. 机器普及且成熟，大家可以导出买原料打印自己想要的东西/事物
2. 打印器官等
3. 太空基地构建
4. 打印衣服（目前已经可以打印，比如鞋）
5. 4D打印，添加了时间维度，再特定的时间/场景 又不同的形态

软件

• 123D design （ 上手快，停更很久了，不推荐）
• DX （ 新手上手难度太高）
• Blender （开源的，个人喜欢这个，小白从这里开始入门了）
• Rhino（犀牛，专业）
• Fusion 360 （据说整合了123D的功能）

工具准备

测量

• 游标卡尺
• 卷尺

拆支撑

• 尖嘴钳

• 木工凿

用到其他工具如水口钳那代表耗材问题，或者机器出问题，拓竹的支撑就没难拆过）

防翘边

纹理板刚开始不建议使用，如果平台不粘了将板子洗一洗。（拓竹要是防翘边，那一定是有问题，换耗材，清理热床）

粘合

• 慢干型：AB胶（哥俩好）、木工胶
• 速干型：502、亚克力胶水（推荐）

表面处理

• 细节处理：刻刀、美工刀、打火机（防风/喷枪)
• 表面打磨：砂纸、锉刀
• 层纹覆盖：（拓竹没啥必要，还是老样子，要外观上光固化）

上色

• 普通：丙烯颜料、画笔、
• 进阶：喷漆，自喷漆、喷笔+水性漆

拓竹的AMS系统直接多色打印够用

保养

• 六角扳手
• 螺丝刀套装
• 润滑剂

尺寸：45 x 45 x 45

设计： mayCAD （专业铝型材设计软件，可直接导出所需物料）

本想参考B站 UP 阿碰碰碰碰碰 的封装视频 将铁架换成铝型材进行封装的，经过一番折腾，最终选择使用网络机柜做封箱了，主要基于两点，一是成本低，二是承重多，AMS lite 和物料可以放在机柜上面。

| 名称 | 数量 | 参考价（元） |
|

相关信息

由于本博客部署在 GitHub Pages 上，而 Github 禁止了百度爬取。故将博客添加到百度收录 SEO 中，增强网站的访问

查看网站是否收录

在百度中输入 site:<域名> 查看网站是否收录。

例如：site:sankgao.github.io

添加网站

1. 登陆 百度资源搜索平台

2. 点击 用户中心 -> 站点管理 添加网站

3. 选择站点属性

   提示

   站点验证成功后，站点领域信息 30 天内只能修改一次，请谨慎设置！

4. 验证网站

   验证网站有两种方式，选择一个验证方式，根据提示完成验证。

   • 文件验证

   • HTML 标签验证

博客中添加验证代码

本人选择的是 HTML 标签验证，在博客中添加上述代码。

博客主题 提供了在页面的 frontmatter 中配置 head 选项，自主添加特定标签到页面 <head>，会自动注入 <meta name="keywords" content="SEO plugin" />。

所以将下面代码添加到网站根目录下的 README 文件中（docs/README.md）：

head:
  - - meta
    - name: baidu-site-verification
      content: codeva-jJHuz4vkzL

相关信息

本博客使用的是 VuePress-v2 版本加 vuepress-theme-hope 主题 搭建

VuePress 介绍

VuePress-v2 官网

什么是 VuePress

VuePress 是一个以 Markdown 为中心的静态网站生成器。您可以使用 Markdown 来书写内容（如：文档、博客等），然后 VuePress 会帮助您生成一个静态网站来展示它们。

VuePress 诞生的初衷是为了支持 Vue.js 及其子项目的文档需求，但是现在它已经在帮助大量用户构建他们的文档、博客和其他静态网站。

它是如何工作的

一个 VuePress 站点本质上是一个由 Vue 和 Vue Router 驱动组成的单页面应用（SPA）。

路由 会根据您的 Markdown 文件的相对路径来自动生成。每个 Markdown 文件都通过 markdown-it 编译为 HTML，然后将其作为 Vue 组件的模板。因此，您可以在 Markdown 文件中直接使用 Vue 语法，便于您嵌入一些动态内容。

在开发过程中，我们启动一个常规的开发服务器（dev-server），并将 VuePress 站点作为一个常规的 SPA。如果您以前使用过 Vue 的话，您在使用时会感受到非常熟悉的开发体验。

在构建过程中，我们会为 VuePress 站点创建一个 服务端渲染（SSR） 的版本，然后通过虚拟访问每一条路径来渲染对应的 HTML。这种做法的灵感来源于 Nuxt 的 nuxt generate 命令，以及其他的一些项目，比如 Gatsby。

VuePress 优点

VuePress 是以 Vue 为驱动的 静态网站生成器，具有以下优点：

• 简洁至上
  • 以 Markdown 为中心的项目结构，以最少的配置帮助您专注于写作
• Vue 驱动
  • 享受 Vue 的开发体验，可以在 Markdown 中使用 Vue 组件，又可以使用 Vue 来开发自定义主题
• 高性能
  • VuePress 会为每个页面预渲染生成静态的 HTML，同时，每个页面被加载的时候，将作为 SPA 运行
• 主题
  • 提供了一个开箱即用的默认主题。您也可以挑选一个社区主题，或者创建一个您自己的主题
• 插件
  • 灵活的插件API，使得插件可以为您的站点提供许多即插即用的功能
• 打包工具
  • 默认的打包工具是 Vite，也同样支持 Webpack

快速搭建

依赖环境

• Node.js v14.18.0+
• Yarn v1 classic（可选）

手动安装

1. 创建并进入一个新目录

   mkdir vuepress-starter
   cd vuepress-starter

2. 初始化项目

3. 将 VuePress 安装为本地依赖

4. 在 package.json 中添加一些 scripts

   {
     "scripts": {
       "docs:dev": "vuepress dev docs",
       "docs:build": "vuepress build docs",
     }
   }

5. 将默认的临时目录和缓存目录添加到 .gitignore 文件中

   echo 'node_modules' >> .gitignore
   echo '.temp' >> .gitignore
   echo '.cache' >> .gitignore

6. 创建您的第一篇文档

   mkdir docs
   echo '# Hello VuePress' > docs/README.md

7. 在本地启动服务器来开发您的文档网站

VuePress 会在 http://localhost:8080 启动一个热重载的开发服务器。当您修改您的 Markdown 文件时，浏览器中的内容也会自动更新。

效果：

配置

配置文件

如果没有任何配置，您的 VuePress 站点仅有一些 最基础 的功能。为了更好地自定义您的网站，让我们首先在您的文档目录下创建一个 .vuepress 目录，所有 VuePress 相关的文件都将会被放在这里。您的项目结构可能是这样：

├─ docs
│  ├─ .vuepress
│  │  └─ config.ts
│  └─ README.md
├─ .gitignore
└─ package.json

VuePress 站点的基本配置文件是 .vuepress/config.js，但也同样支持 TypeScript 配置文件。您可以使用 .vuepress/config.ts 来得到更好的类型提示。

具体而言，我们对于配置文件的路径有着约定（按照 优先顺序）：

当前工作目录 cwd 下：

• vuepress.config.ts
• vuepress.config.js
• vuepress.config.mjs

源文件目录 sourceDir 下：

• .vuepress/config.ts
• .vuepress/config.js
• .vuepress/config.mjs

您也可以通过 命令行接口 的 --config 选项来指定配置文件：

vuepress dev docs --config my-config.js

一个基础的配置文件是这样的：

import { defineUserConfig } from 'vuepress'

export default defineUserConfig({
  lang: 'zh-CN',
  title: '您好， VuePress ！',
  description: '这是我的第一个 VuePress 站点',
})

页面

VuePress 是以 Markdown 为中心的。您项目中的每一个 Markdown 文件都是一个单独的页面。

路由

默认情况下，页面的路由路径是根据您的 Markdown 文件的 相对路径 决定的。

假设这是您的 Markdown 文件所处的目录结构：

└─ docs
   ├─ guide
   │  ├─ getting-started.md
   │  └─ README.md
   ├─ contributing.md
   └─ README.md

将 docs 目录作为您的 sourceDir，例如您在运行 vuepress dev docs 命令。此时，您的 Markdown 文件对应的路由路径为：

| 相对路径 | 路由路径 |
| :

package.json 文件

packag.json 是项目的配置文件，常见的配置有配置项目启动、打包命令，声明依赖包等

在项目根目录下的 package.json 中添加 scripts

{
  "scripts": {
    "dev": "vuepress dev docs",
    "build": "vuepress build docs"
  }
}

完整的 package.json 文件：

{
  "name": "vuepress-starter",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "dev": "vuepress dev docs",
    "build": "vuepress build docs",
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "MIT",
  "devDependencies": {
    "@vuepress/client": "2.0.0-beta.61",
    "vue": "^3.2.47",
    "vuepress": "2.0.0-beta.61"
  }
}

• name：指定项目包的名称
• version：指定版本号。遵循 semver 版本规范
  • 1：代表主版本号，表示有破坏性的更新
  • 0：代表次版本号，表示有功能的新增
  • 0：代表修订号，表示有 bug 的修复
• description：项目的描述信息
• main：main 字段是一个模块的 id，它是您程序的主要入口
• scripts：指定项目的一些内置脚本命令
  • dev：启动程序
  • build：给本地环境打包
  • test：一般用于执行测试，单元测试、*-lint……
• keywords：一组项目的技术关键词
• author：项目作者
• license：项目的 开源许可证
  • MIT：MIT 许可证是一种非常宽松的开源许可证，允许将软件用于商业和非商业用途，并且允许修改、分发和私有化软件
  • ISC：ISC 许可证它的全称是 Internet Systems Consortium 许可证。ISC 许可证的主要特点是非常灵活和简洁，没有对用户和使用者的限制，同时也不对软件的衍生产品做限制
• devDependencies：开发依赖，项目开发环境需要用到而运行时不需要的依赖，用于辅助开发

站点配置

base

• 类型：string

• 默认值：/

• 详情：

  • 部署站点的基础路径

• 示例：

  export default {
    base: '/',
  }

lang

• 类型：string

• 默认值：en-US

• 详情：

  • 站点的语言
  • 它将会在最终渲染出的 HTML 中作为 <html> 标签的 lang 属性
  • 它可以设置在不同语言的 locales 中
  • 如果在不同语言中设置则这里的设置 不生效

• 示例：

  export default {
    lang: 'zh-CN',
  }

title

• 类型：string

• 默认值：''

• 详情：

  • 站点的标题
  • 它将会作为所有页面标题的后缀，并且在默认主题的导航栏中显示
  • 它可以设置在不同语言的 locales 中
  • 如果在不同语言中设置则这里的设置 不生效

• 示例：

  export default {
    title: 'VuePress',
  }

description

• 类型：string

• 默认值：''

• 详情：

  • 站点的描述
  • 它将会在最终渲染出的 HTML 中作为 <meta name="description" /> 标签的 content 属性。它会被每个页面的 Frontmatter 中的 description 字段覆盖
  • 它可以设置在不同语言的 locales 中
  • 如果在不同语言中设置则这里的设置 不生效

• 示例：

  export default {
    description: '使用 VuePress-v2 搭建的个人博客',
  }

head

• 类型：HeadConfig[]

• 默认值：[]

• 详情：

  • 在最终渲染出的 HTML 的 <head> 标签内加入的额外标签
  • 您可以通过 [tagName, { attrName: attrValue }, innerHTML?] 的格式来添加标签
  • 它可以设置在不同语言的 locales 中
  • 如果在不同语言中设置则这里的设置 不生效

• 示例：

  export default {
    head: [
      ['link', { rel: 'icon', href: '/logo.png' }]
    ],
  }

locales

• 类型：{ [path: string]: Partial<SiteLocaleData> }

• 默认值：{}

• 详情：

  • 多语言支持的各个语言 locales
  • 可以使用的字段有：lang、title、description、head

• 示例：

  export default {
    locales: {
      // 键名是该语言所属的子路径
      // 作为特例，默认语言可以使用 '/' 作为其路径。
      '/': {
        lang: 'en-US',
        title: 'VuePress',
        description: 'Vue-powered Static Site Generator',
      },
      '/zh/': {
        lang: 'zh-CN',
        title: 'VuePress',
        description: 'Vue 驱动的静态网站生成器',
      },
    },
  }

主题配置

• 类型：Theme

• 详情：

  • 设置站点要使用的主题
  • 如果不设置该选项，将会使用默认主题

• 示例：

  import { defaultTheme } from 'vuepress'
  
  export default {
    theme: defaultTheme({
      locales: {
        '/': {
          selectLanguageName: 'English',
        },
        '/zh/': {
          selectLanguageName: '简体中文',
        },
      },
    }),
  }

dest

• 类型：string

• 默认值：${sourceDir}/.vuepress/dist

• 详情：

  • 指定 vuepress build 命令的输出目录

• 示例：

  import { defaultTheme } from 'vuepress'
  
  export default {
    theme: defaultTheme({
      dest: "docs/.vuepress/dist",
    }),
  }

temp

• 类型：string
• 默认值：${sourceDir}/.vuepress/.temp
• 详情：
  • 指定临时文件目录

cache

• 类型：string
• 默认值：${sourceDir}/.vuepress/.cache
• 详情：
  • 指定缓存文件目录

public

• 类型：string
• 默认值：${sourceDir}/.vuepress/public
• 详情：
  • 指定 Public 文件目录

pagePatterns

• 类型：string[]
• 默认值：['**/*.md', '!.vuepress', '!node_modules']
• 详情：
  • 指定页面文件的 Patterns。这些 Patterns 是相对于 Source 目录的

plugins 插件配置

• 类型：PluginConfig[]

• 详情：

  • 要使用的插件
  • 该配置项接收一个数组，其中的每一个数组项是一个或一组插件

• 示例：

  import { googleAnalyticsPlugin } from '@vuepress/plugin-google-analytics'
  
  export default {
    plugins: [
      googleAnalyticsPlugin({
        id: 'G-XXXXXXXXXX'
      }),
    ],
  }

主题配置

locales

• 类型：{ [path: string]: Partial<DefaultThemeLocaleData> }

• 默认值：{}

• 详情：

  • 多语言支持的各个语言 locales
  • 所有在 Locale 配置 内的配置项都可以在 locales 中使用
  • 该配置项仅能在 默认主题 内生效，注意不要和 站点配置 中的 locales 混淆

• 示例：

  import { defaultTheme } from 'vuepress'
  
  export default {
    theme: defaultTheme({
      locales: {
        '/': {
          selectLanguageName: 'English',
        },
        '/zh/': {
          selectLanguageName: '简体中文',
        },
      },
    }),
  }

Locale 配置

该 Locale 内的配置项可以作为一般配置使用，也可以使用在 locales 内。

colorMode

• 类型：'auto' | 'light' | 'dark'

• 默认值：'auto'

• 详情：

  • 默认颜色模式
  • 如果设置为 'auto' ，则会根据 prefers-color-scheme 自动设置初始颜色模式

• 示例：

  import { defaultTheme } from 'vuepress'
  
  export default {
    theme: defaultTheme({
      colorMode: 'auto',
    }),
  }

colorModeSwitch

• 类型：boolean

• 默认值：true

• 详情：

  • 是否启用切换颜色模式的功能
  • 如果设置为 true，将会在导航栏展示一个切换颜色模式的按钮

• 示例：

  import { defaultTheme } from 'vuepress'
  
  export default {
    theme: defaultTheme({
      colorModeSwitch: true,
    }),
  }

home

• 类型：string

• 默认值：/

• 详情：

  • 首页的路径
  • 它将被用于：导航栏中 Logo 的链接或 404 页面的 返回首页 链接

• 示例：

  import { defaultTheme } from 'vuepress'
  
  export default {
    theme: defaultTheme({
      home: '/',
    }),
  }

navbar

• 类型： false | (NavbarItem | NavbarGroup | string)[]

• 默认值： []

• 详情：

  • 导航栏配置
  • 设置为 false 可以禁用导航栏
  • 为了配置导航栏元素，您可以将其设置为 导航栏数组，其中的每个元素是 NavbarItem 对象、NavbarGroup 对象、或者 字符串
    • NavbarItem 对象 应该有一个 text 字段和一个 link 字段，还有一个可选的 activeMatch 字段
    • NavbarGroup 对象 应该有一个 text 字段和一个 children 字段。 children 字段同样是一个 导航栏数组
    • 字符串 应为目标页面文件的路径。它将会被转换为 NavbarItem 对象，将页面标题作为 text，将页面路由路径作为 link

• 示例：

  import { defaultTheme } from 'vuepress'
  
  export default {
    theme: defaultTheme({
      navbar: [
        // NavbarItem
        {
          text: 'Foo',
          link: '/foo/',
        },
        // NavbarGroup
        {
          text: 'Group',
          children: ['/group/foo.md', '/group/bar.md'],
        },
        // 字符串 - 页面文件路径
        '/bar/README.md',
        // 嵌套 Group - 最大深度为 2
        {
          text: 'Group',
          children: [
            {
              text: 'SubGroup',
              children: ['/group/sub/foo.md', '/group/sub/bar.md'],
            },
          ],
        },
        // 控制元素何时被激活
        {
          text: 'Group 2',
          children: [
            {
              text: 'Always active',
              link: '/',
              // 该元素将一直处于激活状态
              activeMatch: '/',
            },
            {
              text: 'Active on /foo/',
              link: '/not-foo/',
              // 该元素在当前路由路径是 /foo/ 开头时激活
              // 支持正则表达式
              activeMatch: '^/foo/',
            },
          ],
        },
      ],
    }),
  }

logo

• 类型：null | string

• 详情：

  • Logo 图片的 URL
  • Logo 图片将会显示在导航栏的左端
  • 设置为 null 可以禁用 Logo

• 示例：

  export default {
    theme: defaultTheme({
      // Public 文件路径
      logo: '/images/hero.png',
      // URL
      logo: 'https://vuejs.org/images/logo.png',
    }),
  }

logoDark

• 类型：null | string

• 详情：

  • 在夜间模式中使用的 Logo 图片的 URL
  • 如果您想在夜间模式中使用不同的 Logo 图片，就可以使用该配置
  • 设置为 null 可以在夜间模式下禁用 Logo。忽略该配置项将会在夜间模式中使用 logo 配置

• 示例：

  export default {
    theme: defaultTheme({
      // Public 文件路径
      logoDark: '/images/hero.png',
      // URL
      logoDark: 'https://vuejs.org/images/logo.png',
    }),
  }

repo

• 类型：string

• 详情：

  • 项目仓库的 URL
  • 它将被用作 仓库链接 的链接。仓库链接将会显示为导航栏的最后一个元素

• 示例：

  export default {
    theme: defaultTheme({
      // 如果您按照 `organization/repository` 的格式设置它
      // 我们会将它作为一个 GitHub 仓库
      repo: 'vuejs/vuepress',
      // 您也可以直接将它设置为一个 URL
      repo: 'https://gitlab.com/foo/bar',
    }),
  }

selectLanguageText

• 类型：string

• 详情：

  • 选择语言菜单的文字
  • 如果您在站点配置中设置了多个 locales，那么 选择语言菜单 就会显示在导航栏中仓库按钮的旁边
  • 该配置项 仅能在主题配置的 locales 的内部生效

• 示例：

  export default {
    theme: defaultTheme({
      locales: {
        '/': {
          selectLanguageText: 'Languages',
        },
        '/zh/': {
          selectLanguageText: '选择语言',
        },
      },
    }),
  }

selectLanguageAriaLabel

• 类型：string

• 详情：

  • 选择语言菜单的 aria-label 属性
  • 它主要是为了站点的可访问性（a11y）
  • 该配置项 仅能在主题配置的 locales 的内部生效

• 示例：

  export default {
    theme: defaultTheme({
      locales: {
        '/': {
          selectLanguageAriaLabel: 'Languages',
        },
        '/zh/': {
          selectLanguageAriaLabel: '选择语言',
        },
      },
    }),
  }

selectLanguageName

• 类型：string

• 详情：

  • Locale 的语言名称
  • 该配置项 仅能在主题配置的 locales 的内部生效。它将被用作 locale 的语言名称，展示在 选择语言菜单 内

• 示例：

  export default {
    theme: defaultTheme({
      locales: {
        '/': {
          selectLanguageName: 'English',
        },
        '/zh/': {
          selectLanguageName: '简体中文',
        },
      },
    }),
  }

sidebar

• 类型：false | 'auto' | SidebarConfigArray | SidebarConfigObject

• 默认值：'auto'

• 详情：

  • 侧边栏配置
  • 您可以通过页面的 sidebar frontmatter 来覆盖这个全局配置
  • 设置为 false 可以禁用侧边栏
  • 如果您设置为 'auto'，侧边栏会根据页面标题自动生成
  • 为了手动配置侧边栏元素，您可以将其设置为 侧边栏数组，其中的每个元素是一个 SidebarItem 对象 或者一个 字符串
    • SidebarItem 对象 应该有一个 text 字段，有一个可选的 link 字段、一个可选的 children 字段和一个可选的 collapsible 字段。 children 字段同样是一个 侧边栏数组。collapsible 字段来控制它是否可折叠
    • 字符串 应为目标页面文件的路径。它将会被转换为 SidebarItem 对象，将页面标题作为 text，将页面路由路径作为 link，并根据页面小标题自动生成 children
  • 如果您想在不同子路径中使用不同的侧边栏，您可以将该配置项设置为 侧边栏对象
    • Key 为路径前缀
    • Value 为 侧边栏数组

• 示例1：

  export default {
    theme: defaultTheme({
      // 侧边栏数组
      // 所有页面会使用相同的侧边栏
      sidebar: [
        // SidebarItem
        {
          text: 'Foo',
          link: '/foo/',
          children: [
            // SidebarItem
            {
              text: 'github',
              link: 'https://github.com',
              children: [],
            },
            // 字符串 - 页面文件路径
            '/foo/bar.md',
          ],
        },
        // 字符串 - 页面文件路径
        '/bar/README.md',
      ],
    }),
  }

• 示例2：

  export default {
    theme: defaultTheme({
      // 侧边栏对象
      // 不同子路径下的页面会使用不同的侧边栏
      sidebar: {
        '/guide/': [
          {
            text: 'Guide',
            children: ['/guide/README.md', '/guide/getting-started.md'],
          },
        ],
        '/reference/': [
          {
            text: 'Reference',
            // 可折叠的侧边栏
            collapsible: true,
            children: ['/reference/cli.md', '/reference/config.md'],
          },
        ],
      },
    }),
  }

sidebarDepth

• 类型：number

• 默认值：2

• 详情：

  • 设置根据页面标题自动生成的侧边栏的最大深度
    • 设为 0 来禁用所有级别的页面标题
    • 设为 1 来包含 <h2> 标题
    • 设为 2 来包含 <h2> 和 <h3> 标题
    • ...
  • 最大值取决于您通过 markdown.headers.level 提取了哪些级别的标题
  • 由于 markdown.headers.level 的默认值是 [2, 3]，因此 sidebarDepth 的默认最大值是 2
  • 您可以通过页面的 sidebarDepth frontmatter 来覆盖这个全局配置

• 示例：

  export default {
    theme: defaultTheme({
      sidebarDepth: 2,
    }),
  }

editLink

• 类型：boolean

• 默认值：true

• 详情：

  • 是否启用 编辑此页 链接
  • 您可以通过页面的 editLink frontmatter 来覆盖这个全局配置

• 示例：

  export default {
    theme: defaultTheme({
      editLinks: true,
    }),
  }

editLinkText

• 类型：string

• 默认值：'Edit this page'

• 详情：

  • 编辑此页 链接的文字

• 示例：

  export default {
    theme: defaultTheme({
      editLinkText: '编辑此页',
    }),
  }

docsDir

• 类型：string

• 默认值：''

• 详情：

  • 文档源文件存放在仓库中的目录名
  • 它将会用于生成 编辑此页 的链接

• 示例：

  export default {
    theme: defaultTheme({
      docsDir: 'docs',
    }),
  }

lastUpdated

• 类型：boolean

• 默认值：true

• 详情：

  • 是否启用 最近更新时间戳
  • 您可以通过页面的 lastUpdated frontmatter 来覆盖这个全局配置。要注意的是，如果您已经将该选项设为了 false，那么这个功能会被完全禁用，并且无法在 locales 或页面 frontmatter 中启用

• 示例：

  export default {
    theme: defaultTheme({
      lastUpdated: true,
    }),
  }

lastUpdatedText

• 类型：string

• 默认值：'Last Updated'

• 详情：

  • 最近更新时间戳 标签的文字

• 示例：

  export default {
    theme: defaultTheme({
      lastUpdatedText: '上次更新',
    }),
  }

notFound

• 类型：string[]

• 默认值：['Not Found']

• 详情：

  • 404 页面 的提示信息
  • 当用户进入 404 页面时，会从数组中随机选取一条信息进行展示

• 示例：

  export default {
    theme: defaultTheme({
      notFound: [
        '这里什么都没有',
        '我们怎么到这来了？',
        '这是一个 404 页面',
        '看起来我们进入了错误的链接',
      ],
    }),
  }

backToHome

• 类型：string

• 默认值：'Back to home'

• 详情：

  • 404 页面中 返回首页 链接的文字

• 示例：

  export default {
    theme: defaultTheme({
      backToHome: '返回首页',
    }),
  }

openInNewWindow

• 类型：string

• 默认值：'open in new window'

• 详情：

  • ExternalLinkIcon. 链接内的 sr-only 文字
  • 它主要是为了站点的可访问性（a11y）

• 示例：

  export default {
    theme: defaultTheme({
      openInNewWindow: '在新窗口打开',
    }),
  }

toggleColorMode

• 类型：string

• 默认值：'toggle color mode'

• 详情：

  • 切换颜色模式按钮的标题文字
  • 它主要是为了站点的可访问性（a11y）

• 示例：

  export default {
    theme: defaultTheme({
      toggleColorMode: '切换颜色模式',
    }),
  }

toggleSidebar

• 类型：string

• 默认值：'toggle sidebar'

• 详情：

  • 切换侧边栏按钮的标题文字
  • 它主要是为了站点的可访问性（a11y）

• 示例：

  export default {
    theme: defaultTheme({
      toggleSidebar: '切换侧边栏',
    }),
  }

Frontmater 站点首页

默认的主题提供了一个首页（Homepage）的布局（用于这个网站的主页）。

想要使用它，需要在您的根级 README.md 或 index.md 的 YAML front matter 指定 home: true。

首页

本节的 Frontmatter 只会在首页中生效。

home

• 类型：boolean

• 详情：

  • 设定该页面是 首页 还是 普通页面
  • 如果您不设置该 Frontmatter 或将其设为 false，则该页面会是一个 普通页面

• 示例：

Node 内存泄漏耗尽

<

vuepress-theme-hope 主题

在 VuePress 中，有三种配置概念：

• 站点配置：这是您在配置文件中直接导出的对象
• 主题配置：传递给 hopeTheme 的第一个对象
• 页面配置：由在页面顶部基于 YAML 语法的 Frontmatter 提供

使用主题

多语言

设置语言

您需要为每个语言设置 lang 选项。即使您只在使用单个语言，您也必须在 .vuepress/config.{js,ts} 中设置 lang。

多语言配置

locales 是一个对象，其键为每个语言的路径前缀，值为该语言的配置，可以包含 title、description、lang 等。

您应当为每个语言设置 lang 选项，以便主题和插件能够正确的处理它们。

如果站点和主题配置中的 locales 对象只包含 "/" 一个键，则主题不会显示语言切换菜单。当您通过 locales 设置多个键，即存在多个语言的时候，我们会在导航栏显示语言切换菜单。

为每个语言设置主题选项

与站点配置和 @vuepress/theme-default 的主题配置相同，vuepress-theme-hope 也支持您在主题选项中设置 locale 选项，并为每种语言设置不同的配置。

主题配置

主题基本选项

• hostname：当前网站部署到的域名
• auther：文章显示的默认作者
• favicon：站点图标
• navbar：导航栏配置
• sidebar：侧边栏配置
• locales：主题的多语言配置，您可以在这里分别为每个语言设置单独的选项
• extraLocales：站点的额外语言环境，其中键名是语言名称，值是站点路径，:route 将替换为当前路由路径
• hotReload：是否需要在开发服务器启用完整功能与热更新。是否在开发服务器中启用热重载

主题功能选项

博客选项

主题通过使用 vuepress-plugin-blog2 提供博客功能，且该功能默认 禁用。

要启用博客插件并使用默认选项，您可以在主题选项中设置 plugins.blog: true。

• blog.name：博主姓名

• blog.avatar：博主头像

• blog.description：口号、座右铭或介绍语

• blog.intro：博主的个人介绍地址

  注

  填写后将可以点击 博主信息 中的头像或姓名进入个人介绍页

• blog.medias：博主的媒体链接配置

  • 如果社交媒体已在下方列表中，您可以直接设置 社交媒体名称: 社交媒体地址

  • 否则，您应该传入一个元组 社交媒体名称: [社交媒体地址, 社交媒体 SVG 图标字符串或路径]

  • 元组的第二个元素应该是一个合法的 SVG 字符串或是一个完整的 SVG 文件路径

    可用的社交媒体

    • "Baidu"：百度
    • "BiliBili"：哔哩哔哩
    • "Bitbucket"：Bitbucket
    • "Dingding"：钉钉
    • "Discord"：Discord
    • "Douban"：豆瓣
    • "Dribbble"：Dribbble
    • "Email"：邮件
    • "Evernote"：印象笔记
    • "Facebook"：脸书
    • "Flipboard"：红板报
    • "Gitee"：码云
    • "GitHub"：GitHub
    • "Gitlab"：Gitlab
    • "Gmail"：谷歌邮箱
    • "Instagram"：Instagram
    • "Lark"：飞书
    • "Line"：Line
    • "Linkedin"：领英
    • "Pinterest"：拼趣
    • "Pocket"：Pocket
    • "QQ"：QQ
    • "Qzone"：QQ 空间
    • "Reddit"：红迪
    • "Rss"：RSS 地址
    • "Steam"：蒸汽
    • "Skype"：Skype
    • "Telegram"：电报
    • "Twitter"：推特
    • "Wechat"：微信
    • "Weibo"：微博
    • "Whatsapp"：瓦次艾普
    • "Youtube"：油管
    • "Zhihu"：知乎

    （请不要好奇为什么这里一定要加上特别奇怪的中文翻译）

• blog.roundAvatar：是否剪裁头像为圆形形状。默认值：false

• blog.sidebarDisplay：是否在侧边栏展示博主信息。默认值："mobile"

  • "mobile"：在移动视图中显示在侧边栏中
  • "always"：总是展示在侧边栏中
  • "none"：永远不在侧边栏展示

• blog.timeline：时间轴的顶部文字。默认值："昨日不在"

• blog.articlePerPage：每页的文章数量。默认值：10

• blog.articleInfo：文章列表中展示的文章信息。默认值：["Author", "Original", "Date", "PageView", "Category", "Tag", "ReadingTime"]

  • "Author"：作者

  • "Category"：分类

  • "Date"：写作日期

  • "Original"：是否原创

  • "Tag"：标签

  • "ReadingTime"：预计阅读时间

  • "PageView"：页面浏览量

    注意

    默认情况下，ReadingTime 和 Word 在开发服务器中不可用，查看原因以及如何启用它

加密配置

• encrypt.global：是否全局加密。默认值：false

• encrypt.admin：最高权限密码，可以以数组的形式设置多个

• encrypt.config：加密配置，为一个对象，键名为匹配的路径，键值为对应的密码，接受字符串或字符串数组

  例子

  {
    // 这会加密整个 guide 目录，并且两个密码都是可用的
    "/guide/": ["1234", "5678"],
    // 这只会加密 config/page.html
    "/config/page.html": "1234"
  }

主题布局选项

导航栏

• navbar：导航栏配置
• navbarIcon：是否在导航栏显示图标。默认值：true
• navbarLayout：自定义导航栏布局。默认值：{ start: ["Brand"], center: ["Links"], end: ["Language", "Repo", "Outlook", "Search"] }
• logo：导航栏图标，应为基于 .vuepress/public 文件夹的绝对路径
• logoDark：夜间模式下导航栏图标，应为基于 .vuepress/public 文件夹的绝对路径
• repo：仓库配置，用于在导航栏中显示仓库链接
• repoDisplay：是否在导航栏显示仓库链接。默认值：true
• repoLabel：用于导航栏仓库按钮的无障碍标签
• navbarAutoHide：是否在向下滚动时自动隐藏导航栏。默认值："mobile"
• hideSiteNameOnMobile：是否在移动视图下隐藏站点名称。默认值：true

侧边栏

• sidebar：侧边栏配置
• sidebarIcon：是否在侧边栏显示图标。默认值：true
• sidebarSorter：结构侧边栏排序器。默认值：["readme", "order", "title", "filename"]
  • readme：README.md 或 readme.md 在前
  • order：正序在前并按其值升序排列，负序在后并按其值降序排列
  • date：按日期升序排序
  • date-desc：按日期降序排序
  • title：按标题字母顺序排序
  • filename：按文件名字母顺序排序
• headerDepth：侧边栏嵌套的标题深度。默认值：2

路径导航

• breadcrumb：是否全局启用路径导航。默认值：true
• breadcrumbIcon：是否在路径导航显示图标。默认值：true
• prevLink：是否在页面底部显示上一篇链接。默认值：true
• nextLink：是否在页面底部显示下一篇链接。默认值：true

标题

• titleIcon：是否在页面标题旁显示图标。默认值：true
• pageInfo：文章信息，可以填入数组，数组的顺序是各条目显示的顺序。填入 false 使其被禁用。默认值：["Author", "Original", "Date", "Category", "Tag", "ReadingTime"]
  • "Author"：作者
  • "Date"：写作日期
  • "Original"：是否原创
  • "Category"：分类
  • "Tag"：标签
  • "ReadingTime"：预计阅读时间
  • "Word"：字数
  • "PageView"：页面浏览量

Meta

• lastUpdated：是否显示页面最后更新时间。默认值：true
• contributors：是否显示页面贡献者。默认值：true
• editLink：是否展示编辑此页链接。默认值：true
• editLinkPattern：编辑链接的匹配。其中 :repo :branch :path 会被自动替换为 docsRepo docsBranch 和 docsDir + filePath
• docsRepo：文档仓库。默认值：repo
• docsBranch：文档所在分支。默认值："main"
• docsDir：文档在仓库中的目录。默认值：""

页脚

• footer：页脚的默认内容，可输入 HTMLString
• copyright：默认的版权信息，设置为 false 来默认禁用它。默认值："Copyright © <作者>"
• displayFooter：是否默认显示页脚。默认值：false

杂项

• home：当前语言的主页路径，用于导航栏图标和返回主页按钮的链接。默认值：当前 locale 的键名
• rtl：是否使用 RTL 布局。默认值：false
• toc：是否在桌面模式下右侧展示标题列表。默认值：true

主题外观选项

• iconAssets：字体图标资源链接，支持 'iconfont' 和 'fontawesome' 关键字
• darkmode：深色模式支持。默认值："switch"
  • "switch"：在深色模式，浅色模式和自动之间切换
  • "toggle"：在深色模式和浅色模式之间切换
  • "auto"：自动根据用户设备主题或当前时间决定是否应用深色模式
  • "enable"：强制深色模式
  • "disable"：禁用深色模式
• themeColor：主题色选择器配置。默认值：false
• fullscreen：是否显示全屏按钮。默认值：false
• backToTop：是否显示返回顶部按钮。默认值：true
• mobileBreakPoint：切换桌面布局和移动布局的窗口宽度，单位像素。默认值：719
• pcBreakPoint：切换桌面布局和宽屏布局的窗口宽度，单位像素。默认值：1440
• pure：是否开启纯净模式。默认值：false
• print：是否在桌面模式下显示打印按钮。默认值：true
• iconPrefix：通常情况下，它可以识别 iconAssets 并自动设置，如果识别失败，您可以手动设置图标的 FontClass 前缀

主题行为选项

hopeTheme() 接受可选的第二个参数，即行为选项。行为选项控制主题的行为。

行为选项也可接受一个布尔值：

• false：意味着所有选项都设置为 false
• true：意味着 { check: true, compact:true, custom :false, debug: false }

• check：是否执行附加检查。检查包括运行时检查和 frontmatter 检查。不兼容的值将被警告。默认值：true
• compact：是否兼容历史版本（v1 最新版本和 v2 beta 版本）。默认值：true
• custom：是否启用通过别名导入组件的自定义支持。默认值：false
• debug：是否在调试模式下运行。默认值：false

Frontmatter 配置

信息 Frontmatter 配置

• title：当前页面内容标题，默认为 Markdown 文件中的第一个 h1 标签内容
• shortTitle：当前页面的短标题，会在导航栏、侧边栏和路径导航中作为首选
• description：当前页面内容描述
• icon：当前页面图标的 FontClass 或文件路径（建议填写）
• author：作者，如果不填，则会回退到默认作者
• isOriginal：当前文章是否为原创。默认值：false
• date：写作时间。格式：YYYY-MM-DD 或 YYYY-MM-DD hh:mm:ss
• category：分类
• tag：标签
• sticky：是否在列表中置顶。当填入数字时，数字越大，排名越靠前。默认值：false
• star：是否收藏在博客主题的文章列表中。当填入数字时，数字越大，排名越靠前。默认值：false
• article：是否将该文章添加至文章列表中。默认值：true
• timeline：是否将该文章添加至时间线中。默认值：true
• image：设置预览图（分享图），请填入绝对路径
• banner：设置横幅图片（宽屏分享图），请填入绝对路径

布局 Frontmatter 配置

• pageInfo：文章信息展示项目

  | 条目 | 对应内容 | 页面 frontmatter 值 |
  | :

动态标题

安装

用法

将依赖包导入配置文件 config 文件。

配置参数类型声明

• showIcon：文档在当前标签时显示的图标。默认：""
• showText：文档在当前标签时显示的标题。默认："(/≧▽≦/)咦！又好了！"
• hideIcon：文档不在当前标签时显示的图标。默认：""
• hideText：文档不在当前标签时显示的标题。默认："(●—●)喔哟, 崩溃啦！"
• recoverTime：标签改变后恢复标题的时间。默认："2000"（毫秒）

鼠标点击

安装

pnpm add @moefy-canvas/theme-popper

用法

将依赖包导入配置文件 config 文件，并将 vuepress-plugin-popper 目录导入到 plugins 目录下（plugins 目录与 config 文件在同级目录下）。

import { PopperShape } from "@moefy-canvas/theme-popper";
import { popperPlugin } from "./plugins/vuepress-plugin-popper";

export default defineUserConfig({
  // 插件配置
  plugins: [
    popperPlugin({
      config: {
        shape: PopperShape.Star,
        size: 1.95,
        numParticles: 10,
      },
    }),
  ],
})

配置参数类型声明

• shape：形状

  • PopperShape.Star：星形。默认值：PopperShape.Star
  • PopperShape.Circle：圆形

• size：设置大小。默认值：1.75

• numParticles：设置粒子数。默认值：10

看板娘

安装

用法

将依赖包导入配置文件 config 文件。

import { ohmylive2dPlugin } from 'vuepress-plugin-oh-my-live2d';

export default defineUserConfig({
  // 插件配置
  plugins: [
    ohmylive2dPlugin({
      source: "https://oml-api.tj520.top",
      models: [
        {
          path: "/pio/index.json", scale: 1.5, x: 10, y: 0,
        },
        {
          path: "/pa15_3701/normal/normal.model3.json", scale: 1, x: 10, y: 0,
          stageStyle: {
            height: "330",
          },
        },
        // 更多
      ],
      tips: {
        style: {
          width: 150,
          height: 70,
          offsetX: 20,
          offsetY: 50,
        },
        welcomeTips: {
          message: {
            daybreak: "早上好！一日之计在于晨，美好的一天就要开始了。",
            morning: "上午好！工作顺利嘛，不要久坐，多起来走动走动哦！",
            noon: "中午了，工作了一个上午，现在是午餐时间！",
            afternoon: "午后很容易犯困呢，来杯咖啡吧~",
            dusk: "傍晚了！工作一天幸苦啦~",
            night: "晚上好，今天过得怎么样呢？",
            lateNight: "已经这么晚了呀，早点休息吧，晚安~",
            weeHours: "这么晚还不睡吗？当心熬夜秃头哦！"
          },
        },
      },
    })
  ],
})

配置参数类型声明

• source：Live2D Model 的来源，支持 本地路径 或 远程 url。默认为 https://oml-api.tj520.top

• models：模型配置已支持配置多个，之后可以在面板的控件中对其切换

  • path：模型具体路径，在加载模型时会与 source 选项进行拼接。默认为 /pio/index.json
  • scale：模型的缩放比例。默认为 1
  • x：模型在舞台中 X 轴方向的位置。默认为 0
  • y：模型在舞台中 Y 轴方向的位置。默认为 0

• tip：提示框配置

  • style：用于设置提示框样式

    • width：设置提示框宽度。默认为 230
    • height：设置提示框高度。默认为 100
    • offsetX：提示框在 X 轴方向的偏移量。默认为 0
    • offsetY：提示框在 Y 轴方向的偏移量。默认为 0

  • stageStyle：用于配置舞台样式

    • height：设置舞台的高度。默认为 auto

  • welcomeTips：模型在初次加载完之后的提示配置

    • massage：在对应时间段提示的内容

      • daybreak：早晨 5-7 点提示信息内容
      • morning：早上 8-11 点提示信息内容
      • noon：中午 12-13 点提示信息内容
      • afternoon：下午 14-17 点提示信息内容
      • dusk：傍晚 18-19 点提示信息内容
      • night：晚上 20-21 点提示信息内容
      • lateNight：深夜 22-23 点提示信息内容
      • weeHours：凌晨 0-4 点提示信息内容

export default defineUserConfig({
  // 插件配置
  plugins: [
    ohmylive2dPlugin({
      source: "/assets/live2d/vscode-live2d-models",
      models: [
        {
          path: "/bilibili-22/index.json", scale: 2, x: 10,
        },
        {
          path: "/bilibili-33/index.json", scale: 1.5, x: 10,
        },
        {
          path: "/girls-frontline/AN94-1/normal/model.json", scale: 0.7,
        },
        {
          path: "/girls-frontline/AN94-1/destroy/model.json", scale: 0.7,
        },
        {
          path: "/girls-frontline/AN94-2/normal/model.json", scale: 0.7,
        },
        {
          path: "/girls-frontline/AN94-2/destroy/model.json", scale: 0.7,
        },
        {
          path: "/girls-frontline/G11/normal/model.json", scale: 0.4,
        },
        {
          path: "/girls-frontline/G11/destroy/model.json", scale: 0.5,
        },
        {
          path: "/girls-frontline/HK416-1/normal/model.json", scale: 0.7,
        },
        {
          path: "/girls-frontline/HK416-1/destroy/model.json", scale: 0.7, x: 10,
        },
        {
          path: "/girls-frontline/HK416-2/normal/model.json", scale: 0.7,
        },
        {
          path: "/girls-frontline/HK416-2/destroy/model.json", scale: 0.7,
        },
        {
          path: "/girls-frontline/Kar98k/normal/model.json", scale: 0.7,
        },
        {
          path: "/girls-frontline/Kar98k/destroy/model.json", scale: 0.7,
        },
        {
          path: "/girls-frontline/M4A1-1/normal/model.json", scale: 1.5,
        },
        {
          path: "/girls-frontline/M4A1-1/destroy/model.json", scale: 1.5,
        },
        {
          path: "/girls-frontline/M4A1-2/normal/model.json", scale: 0.5,
        },
        {
          path: "/girls-frontline/M4A1-2/destroy/model.json", scale: 0.5,
        },
        {
          path: "/girls-frontline/M4-SOPMOD-II-1/normal/model.json", scale: 0.5,
        },
        {
          path: "/girls-frontline/M4-SOPMOD-II-1/destroy/model.json", scale: 0.5,
        },
        {
          path: "/girls-frontline/M4-SOPMOD-II-2/normal/model.json", scale: 0.7,
        },
        {
          path: "/girls-frontline/M4-SOPMOD-II-2/destroy/model.json", scale: 0.7,
        },
        {
          path: "/girls-frontline/UMP9/normal/model.json", scale: 0.5,
        },
        {
          path: "/girls-frontline/UMP45-1/normal/model.json", scale: 1.5,
        },
        {
          path: "/girls-frontline/UMP45-1/destroy/model.json", scale: 1.5,
        },
        {
          path: "/girls-frontline/UMP45-2/normal/model.json", scale: 0.7,
        },
        {
          path: "/girls-frontline/UMP45-2/destroy/model.json", scale: 0.7,
        },
        {
          path: "/girls-frontline/UMP45-3/normal/model.json", scale: 0.8,
        },
        {
          path: "/girls-frontline/UMP45-3/destroy/model.json", scale: 0.8,
        },
        {
          path: "/girls-frontline/WA2000-1/normal/model.json", scale: 0.7,
        },
        {
          path: "/girls-frontline/WA2000-1/destroy/model.json", scale: 0.7,
        },
        {
          path: "/girls-frontline/WA2000-2/normal/model.json", scale: 1.5,
        },
        {
          path: "/girls-frontline/WA2000-2/destroy/model.json", scale: 1.5,
        },
        {
          path: "/girls-frontline/WA2000-3/normal/model.json", scale: 0.7,
        },
        {
          path: "/girls-frontline/WA2000-3/destroy/model.json", scale: 0.7,
        },
        {
          path: "/haru02/haru02.model.json", scale: 0.7,
        },
        {
          path: "/haruto/haruto.model.json", scale: 1.5,
        },
        {
          path: "/hijiki/hijiki.model.json", scale: 1.5,
        },
        {
          path: "/index/index.model.json", scale: 2,
          stageStyle: {
            height: "240",
          },
        },
        {
          path: "/kanzaki/kanzaki.model.json", scale: 2,
          stageStyle: {
            height: "330",
          },
        },
        {
          path: "/kesshouban/model.json", scale: 1.5, x: 70,
        },
        {
          path: "/koharu/koharu.model.json", scale: 1.5,
        },
        {
          path: "/murakumo/index.json", scale: 2, x: 20,
        },
        {
          path: "/nico/nico.model.json", scale: 1.5,
        },
        {
          path: "/potion-Maker-Pio/index.json", scale: 3.3,
        },
        {
          path: "/potion-Maker-Tia/index.json", scale: 3.3,
        },
        {
          path: "/shizuku-48/index.json", scale: 2,
          stageStyle: {
            height: "350",
          },
        },
        {
          path: "/shizuku-pajama/index.json", scale: 2,
          stageStyle: {
            height: "350",
          },
        },
        {
          path: "/tororo/tororo.model.json", scale: 1.5,
        },
        {
          path: "/wanko/wanko.model.json", scale: 1.5, y: 130,
        },
      ],
    }),
  ],
})

官方文档对它的说明如下：

Tig is an ncurses-based text-mode interface for git. It functions mainly as a Git repository browser, but can also assist in staging changes for commit at chunk level and act as a pager for output from various Git commands.

如果你使用的是 Windows 系统，那么在安装 Git 时应该已经内置安装了 tig。通常在 <Git>/usr/bin 目录下可以找到。

其他系统安装命令如下：

• MacOS: brew install tig
• Ubuntu/Debian: sudo apt install tig
• Fedora/RHEL: sudo dnf install tig

tig 布局通常是这样，包含一个状态窗口（最后那行）和一个或多个视图。默认通常只显示一个视图，当然也可以分屏显示多个视图（下面对主视图的介绍中就可以看到分屏显示的情况）。

目前，tig 有 13 种视图，我们从主视图入手，因为它是 tig 的默认视图。

在终端执行 tig 命令即可进入 tig 的主视图，主视图中显示的是当前工作目录所在的 Git 仓库的提交日志。默认高亮选中第一行，即最后的日志。

注意，这是一个可滚动浏览的提交日志列表，你可以通过快捷键在列表中进行导航。其操作方式类似于 vi，如果你熟悉 vi，那么应该可以快速上手。

j/k 键：可以让光标上下移动选中相应的提交日志行。

Enter 键：选中某条提交日志行的状态下按 Enter 键，终端窗口会被分屏，左屏仍显示提交日志列表，右屏显示被选中的提交日志的详细信息。此时，焦点会自动切换到右屏中，即j/k 键将在右屏进行导航。

J/K：如果此时需要在左屏各条提交日志间进行导航，可使用 J/K，右屏内容会随着选中的提交日志而即时改变。

也可以使用上下方向键进行左屏导航。

Tab 键：当然，也可以按 Tab 键将焦点切换回左屏，使用 j/k 键进行导航。

Q/Ctrl + c：退出 tig。

很显然，快捷键很多，而这只是一小部分。因此，通常你不可能记住所有快捷键，好在在 tig 的任一视图你都可以按下 h 键来查看帮助视图，其中完整列出了所有快捷键。

一种操作对应的快捷键通常也不止一个，因此，你不需要记住所有快捷键，只需要选择性记住适合自己习惯的那个。

按 r 键进入引用视图，该视图会显示分支、远程节点和标签。

j/k 键：与主视图类似，上下移动光标导航。

Enter 键：类似地，分屏显示选中引用的提交日志。

C ：当焦点在引用视图上时，会询问是否执行 git checkout 命令，即切换分支；焦点在日志视图上时，会询问是否执行 git cherry-pick 命令。

按 s/S 键进入状态视图，该视图会分组显示暂存（暂存待提交）、未暂存（修改未暂存）和不跟踪的文件。

j/k 键：仍是上下导航。

Enter 键：如果选中的是暂存或未暂存文件，将分屏显示差异视图；如果选中的是未跟踪的文件，将分屏显示文件内容。

u 键：如果选中的是暂存文件，则会取消暂存，这可能让其回到未暂存或不跟踪的文件列表；如果选中的是未暂存或不跟踪的文件，则会将其暂存。

! 键：选中的是未暂存文件，丢弃文件修改。其他状态文件不能执行该操作。

C：提交。

日志视图（l）：显示完整日志信息和差异统计。

差异视图（d）：显示当前工作副本与上次提交之间的差异，如果当前工作副本是干净的，则显示上次提交的更改。

树视图（t）：以目录方式展示仓库结构，并在其中导航查看文件内容。

暂存视图（c）：显示（未）暂存文件的更改以及不跟踪的文件的内容。

贮藏视图（y）：显示贮藏列表。

正则视图（g）：正则查找，匹配文件名及文本内容。

分页器视图（p）

帮助视图（h）：键绑定快速查看帮助。

官方主页 - GitHub Pages

官方手册 - GitHub Pages

Tig GitHub Repository

一定要搞清楚交付的标准，不清楚标准就意味着返工的概率极大。如何搞清楚，工作需要达到的状态？

SMART公式

• 具体化（Specific）：明确具体指标和细节。
• 可衡量（Measurable）：确保目标可以量化。
• 可实现（Achievable）：目标可行，不理想化。
• 相关性（Relevant）：与总目标相关联。
• 有时限（Time-bound）：明确的完成时间。

请示工作

比如，工作中遇到问题等，不要上来就问该怎么办？需要带着方案（ >2个 ）去。用RIDE模型，说服老板支持你。

RIDE模型

R-risk：风险，目前的困境

I-interest： 利益，引入共同利益

D-difference： 差异，A方案和B方案的区别

E-effect：影响，适当体现一些缺点（全挑好的说不真实）

汇报工作

PREP

• Point（结论先行）：上来就给结论，直击重点。
• Reason（再讲理由）：陈述原因，给出有说服力的依据
• Example（拿出事例）：最好给一个实例
• Point（重述结论）：将发散的思维回归结论，强化观点

分享工作

如果做团队分享，一定要多维分析，不可泛泛而谈

5W2H

从7个维度思考，广泛应用于产品、业务、项目运营可行性分析，问题解决和落地方法论。

What： 产品背景

Who： 目标人群

Why： 预期目标

Where： 使用场景

When：需求节点

How：如何验证

How much：用多少资源

不仅分享可用，很多场景都可以套用。业务/场景分析等

复盘(SOP总结)

GRAI法则

G-Goal：回顾目标

R-Result：评估结果，方向校准，数据验证

A-Analysis：分析成功/失败原因，表层/深层原因，偶发性和必然性

I-Insight：总结规律方法论

其他

65个思维模型

参考这个文章，可以有个大概的了解

选择原因

1. 开源，相对安全可靠
2. 离线使用，不会上传数据
3. 高度的定制 (可双拼挂音形)

安装

下载地址: https://rime.im/download/

macos安装完后，通常右上角会出现如上的图标，如果没有出现，尝试重启或重新登陆。

功能说明

1. 重新部署：当修改了配置文件时，用于配置生效使用
2. 同步用户数据：同步用户配置、造词、字频记录(如何通过CLI同步)
3. 用户设定：打开用户配置文件夹（RIME都是以配置文件为主，无图形化）
4. 在线文档
5. 检查更新

配置文件

雾凇配置参考

雾凇配置详解

感谢大佬的配置。建议直接下载别人的先使用，需要个人定制的，再去详细了解配置文件

小鹤音形

只支持音形

http://flypy.ysepan.com/

下载音形文件，打开用户设定 ，将你的文件覆盖即可。

支持双拼&音形

解压下载的文件，

1. 将build/*bin 文件复制都build目录下。
2. 将flypy*文件，复制到rime目录
3. 修改default.yaml 添加音形

schema_list:
  - schema: flypy # 小鹤音形

重新部署即可，切换输入法的快捷定义是

switcher:
  caption: "[方案菜单]"
  hotkeys:
    - F2

按快捷键F2，即可切换输入方式，具体以你个人的设置为准

配置同步（CLI）

#!/bin/bash
if [ -n "$(pgrep 'Squirrel')" ]; then
    cpu_usage=$(ps -p $(pgrep 'Squirrel') -o %cpu=);
    if [ "$(echo "$cpu_usage == 0" | bc -l)" -eq 1 ]; then
        cd ~/Library/Rime
        DYLD_LIBRARY_PATH="/Library/Input Methods/Squirrel.app/Contents/Frameworks" "/Library/Input Methods/Squirrel.app/Contents/MacOS/Squirrel" --quit
        DYLD_LIBRARY_PATH="/Library/Input Methods/Squirrel.app/Contents/Frameworks" "/Library/Input Methods/Squirrel.app/Contents/MacOS/rime_dict_manager" -s
    fi
fi

如果觉得脚本不方便，可直接输入以下内容

22 22 * * * if [ -n "$(pgrep 'Squirrel')" ]; then cpu_usage=$(ps -p $(pgrep 'Squirrel') -o %cpu=); if [ "$(echo "$cpu_usage == 0" | bc -l)" -eq 1 ]; then cd ~/Library/Rime && DYLD_LIBRARY_PATH="/Library/Input Methods/Squirrel.app/Contents/Frameworks" "/Library/Input Methods/Squirrel.app/Contents/MacOS/Squirrel" --quit && DYLD_LIBRARY_PATH="/Library/Input Methods/Squirrel.app/Contents/Frameworks" "/Library/Input Methods/Squirrel.app/Contents/MacOS/rime_dict_manager" -s; fi; fi

语言模型支持

在LMDG的发布页下载模型。我下载的是amz-v2n3m1-zh-hans.gram

将模型放到Rime的家目录，MacOS下是 ~/Library/Rime

新建使用的输入法的自定义配置文件，一下以小鹤双拼为例

在patch下，添加如下代码，重新载入配置即可

patch:
  grammar:
    language: amz-v2n3m1-zh-hans  
    collocation_max_length: 5
    collocation_min_length: 2
  translator/contextual_suggestions: true
  translator/max_homophones: 7
  translator/max_homographs: 7

pip install mysqlclient==1.4.4

安装 mysqlclient 会出现下面的问题：

mysql_config not found

若不需要安装mysql服务，直接安装客户端即可

brew install mysql-client pkg-config

安装完成后，检查命令是否可执行

which mysql_config

箬笠报错如下

Exception: Can not find valid pkg-config name.
      Specify MYSQLCLIENT_CFLAGS and MYSQLCLIENT_LDFLAGS env vars manually

修改环境变量

export MYSQLCLIENT_CFLAGS=$(mysql_config --cflags)
export MYSQLCLIENT_LDFLAGS=$(mysql_config --libs)

此时继续安装 mysqlclient

pip install mysqlclient==1.4.4

若报错如下

    ld: library not found for -lzstd
    clang: error: linker command failed with exit code 1 (use -v to see invocation)
    error: command '/usr/bin/gcc' failed with exit code 1

安装zstd

brew install zstd

修改环境变量

export CFLAGS="-I$(brew --prefix)/include"
export LDFLAGS="-L$(brew --prefix)/lib"

# 若不生效，则使用

export LDFLAGS="-L/opt/homebrew/Cellar/zstd/1.5.6/lib"
#具体版本以安装的版本为准

再次安装即可

postgre

  × python setup.py egg_info did not run successfully.
  │ exit code: 1
  ╰─> [23 lines of output]
      running egg_info
      creating /private/var/folders/bp/jkzx65zj6sq1xj6bb5bkt03w0000gn/T/pip-pip-egg-info-37d85hev/psycopg2.egg-info
      writing /private/var/folders/bp/jkzx65zj6sq1xj6bb5bkt03w0000gn/T/pip-pip-egg-info-37d85hev/psycopg2.egg-info/PKG-INFO
      writing dependency_links to /private/var/folders/bp/jkzx65zj6sq1xj6bb5bkt03w0000gn/T/pip-pip-egg-info-37d85hev/psycopg2.egg-info/dependency_links.txt
      writing top-level names to /private/var/folders/bp/jkzx65zj6sq1xj6bb5bkt03w0000gn/T/pip-pip-egg-info-37d85hev/psycopg2.egg-info/top_level.txt
      writing manifest file '/private/var/folders/bp/jkzx65zj6sq1xj6bb5bkt03w0000gn/T/pip-pip-egg-info-37d85hev/psycopg2.egg-info/SOURCES.txt'
      
      Error: pg_config executable not found.
      
      pg_config is required to build psycopg2 from source.  Please add the directory
      containing pg_config to the $PATH or specify the full executable path with the
      option:
      
          python setup.py build_ext --pg-config /path/to/pg_config build ...
      
      or with the pg_config option in 'setup.cfg'.
      
      If you prefer to avoid building psycopg2 from source, please install the PyPI
      'psycopg2-binary' package instead.
      
      For further information please check the 'doc/src/install.rst' file (also at
      <https://www.psycopg.org/docs/install.html>).
      
      [end of output]
  
  note: This error originates from a subprocess, and is likely not a problem with pip.
error: metadata-generation-failed

× Encountered error while generating package metadata.
╰─> See above for output.

note: This is an issue with the package mentioned above, not pip.
hint: See above for details.

https://stackoverflow.com/questions/66888087/cannot-install-psycopg2-with-pip3-on-m1-mac

安装pgsql

 brew install postgresql@16

导入环境变量

export PATH="/opt/homebrew/opt/postgresql@16/bin:$PATH"
export LDFLAGS="-L/opt/homebrew/opt/postgresql@16/lib"
export CPPFLAGS="-I/opt/homebrew/opt/postgresql@16/include"

认证登录

客户端工具redis-di登录

redis-cli
redis-cli -h redisd ip
redis-cli -h xxx -p xxx

# redis的认证
>auth password

redis-cli -a password

数据类型

常见的有字符串、列表、集合、等

字符串

›set name aaa

›keys *

>get name

>set name bbb

> del name

#增加key并赋值 #混示所有的key #获取key的佶 ＃重新绘key赋佶 #别除key

命令不区分大小写：>GET name

key区分大小写：>get Name

列表

127.0.0.1:6379> rpush name aaa  # rpush 依次在右边添加，lpush反之
(integer) 1
127.0.0.1:6379> rpush name bbb
(integer) 2
127.0.0.1:6379> rpush name vvv
(integer) 3
127.0.0.1:6379> rpush name ccc
(integer) 4
127.0.0.1:6379> get name
(error) WRONGTYPE Operation against a key holding the wrong kind of value
127.0.0.1:6379> scan 0
1) "0"
2) 1) "name"
127.0.0.1:6379> llen name
(integer) 4
127.0.0.1:6379> lrange name 0 4  # 列表需要使用lrange查看
1) "aaa"
2) "bbb"
3) "vvv"
4) "ccc"

# 删除第三个值
127.0.0.1:6379> lrem name 3 vvv
(integer) 1
127.0.0.1:6379> lrange name 0 4
1) "aaa"
2) "bbb"
3) "ccc"

# 弹出
lpop 左弹出
rpop 右弹出

集合

127.0.0.1:6379> sadd set s1
(integer) 1
127.0.0.1:6379> SMEMBERS set  # 列出集合的元素
1) "s1"
127.0.0.1:6379> sadd set s2
(integer) 1
127.0.0.1:6379> SMEMBERS set
1) "s1"
2) "s2"
127.0.0.1:6379> srem set s1  # 删除
(integer) 1
127.0.0.1:6379> SMEMBERS set
1) "s2"
127.0.0.1:6379>

spop 随机删除1个