环境部署 on Ranch's Blog

Obsidian 个人知识库搭建全记录

Sat, 04 Jul 2026 08:00:00 +0800

Obsidian 个人知识库搭建全记录

引言

基于 Karpathy LLM Wiki 方法论，在 Obsidian 中搭建 AI 辅助个人知识库的完整过程。记录了每个阶段的真实决策、踩过的坑和最终方案。

正文

让 AI 阅读方法论并设计结构

你：阅读Karpathy wiki 方法论，帮我把仓库里的wiki文件夹的结构给建立起来

AI 读完后，按照 Karpathy 的三层架构（raw / wiki / schema）设计了初始目录。经过讨论，确定了三个兴趣方向：

1
2
3

it-tech/    ← IT 技术（编程、框架、工具、架构）
finance/    ← 投资理财（概念、策略、标的分析）
reading/    ← 阅读随记（书籍、文章、跨书主题）

初始结构采用了严格的嵌套方案，后来扁平化调整，去掉了多余层级。

目录演变

初始方案（三层嵌套）            最终方案（扁平）
─────────────────             ────────────────
ai_wiki/                      ai_wiki/
├── wiki/                     ├── raw/          ← 原始资料
│   ├── raw/                  ├── wiki/         ← 知识库
│   ├── wiki/                 │   ├── it-tech/
│   │   ├── it-tech/          │   ├── finance/
│   │   ├── finance/          │   └── reading/
│   │   └── reading/          ├── assets/       ← 配图
│   └── meta/                 └── meta/

第一篇素材

在 raw/ 放入第一篇资料后直接说 ingest，AI 自动完成：归类子目录 → 读取内容 → 创建概念页 + 实体页 → 更新索引 → 写日志。

发现 raw/ 根目录需要整理

使用 Obsidian Web Clipper 剪藏的笔记直接掉进 raw/ 根目录，杂乱无章。于是加了一条规则：

每次 Ingest 时，自动将 raw/ 根目录下的未分类笔记按内容归类到对应子目录。

写入 meta/CLAUDE.md，从此再也不用手动分类。

merge 外部 CLAUDE.md

发现 helloianneo/obsidian-ai-second-brain 的 CLAUDE.md 更完整，将其与本地规则合并，形成了当前 meta/CLAUDE.md 的基础。

索引页的演变

最初的 index.md 只是一个简单的文章列表：

1
2
3

## IT技术
- [概念页](概念页.md) — 说明
- [实体页](实体页.md) — 说明

用了几个来回后，逐步进化成了动态仪表盘。

踩过的坑

问题	原因	解决
仪表盘完全不显示	未启用 DataviewJS 查询	Dataview 设置 → 开启 Enable Dataview JavaScript queries
CSS 不生效	`cssclasses` 应写作 `cssclass`（单数）	修正 frontmatter key
统计卡片对不齐	`dv.el({container})` 参数不可靠	改用`document.createElement` + `dv.container.appendChild`
整个 DVJS 块不渲染	模板字符串内嵌 IIFE 解析失败	把逻辑提到外面先算好
用户名读取报错	`require('os')` 在 Obsidian 中不可用	改用`app.vault.adapter.basePath` 提取
底部索引不显示	用`document.createElement` 但忘了 `appendChild`	创建元素后要手动附加到容器

功能模块迭代顺序

统计卡片 → 文章数、资料数、总计，三列等宽 Grid
兴趣方向 → 各区域文章数 + 标签列表
主题切换 → 🌙 emoji 按钮，一键切换深色/浅色
最近更新 → 按修改时间排序，显示相对时间
每日诗句 → 从诗词歌赋.md 按天轮换
随机索引 → 每天随机展示各区域最多 5 篇
知识图谱 → 点击跳转 Obsidian 关系图谱

主题切换

最初用文字按钮，后来改为纯 emoji 切换：

btn.onclick = () => {
  const isDark = document.body.classList.contains('theme-dark');
  document.body.classList.toggle('theme-dark', !isDark);
  document.body.classList.toggle('theme-light', isDark);
  btn.textContent = isDark ? '☀️' : '🌙';
};

每日诗句

从 wiki/reading/books/诗词歌赋.md 读取，以当天日期为种子选一行，同一天不重复：

const content = await dv.io.load("wiki/reading/books/诗词歌赋.md");
const poemLines = content.split('\n').filter(l => /^\s*\d+\./.test(l));
const d = Math.floor((new Date() - new Date(new Date().getFullYear(), 0, 0)) / 86400000);
const raw = poemLines[d % poemLines.length].replace(/^\s*\d+\.\s*/, '').trim();

问候语按时间段切换

时间段	问候
7:00–8:59	👋 早上好
9:00–10:59	👋 上午好
11:00–12:59	👋 中午好
13:00–16:59	👋 下午好
17:00–22:59	👋 晚上好
23:00–6:59	👋 夜深了，早点休息吧

用户名自动读取

从 vault 路径 C:\Users\{userName}\... 提取，不硬编码：

1
2

const userName = (app.vault.adapter.basePath || '')
  .match(/[\\/]Users[\\/]([^\\/]+)/)?.[1];

meta/CLAUDE.md 的演变

从一个简单规则文件逐步演变成完整的工作手册：

版本	新增内容
v1	Web Clipper 分类规则
v2	merge 外部 CLAUDE.md（Ingest / Query / Lint 三大触发行为）
v3	唤醒自动检查（哈喽/hello 触发）
v4	图片管理规则（命名、分类、外链处理）
v5	Frontmatter 规范（created / published）
v6	精简冗余规则，保留核心流程
v7	log.md 改为新条目插最前面

Frontmatter 规范

---
title: 页面标题
tags: [主分类, 子分类]
created: 2026-07-04       # 我在 wiki 建页日期
published: 2024-06-21     # 原始资料发布日期（有时效性内容必填）
sources:
  - raw/主题/来源文件名.md
---

assets/ 目录建立

assets/
├── it-tech/       ← IT 技术配图
├── finance/       ← 理财配图
└── reading/       ← 阅读配图

不按页面类型细分，一张图可能被多处引用。

命名规范

格式：文章缩写-编号.扩展名

xbi-analysis-01.webp
xbi-analysis-02.webp
xbi-analysis-03.webp
xbi-analysis-04.png

图片管理流程

Web Clipper 剪藏后按 Ctrl+Shift+D 下载附件到 assets/
Ingest 时检查外链图片，提示下载到本地
散落的图片移入对应主题子目录
引用路径统一为 ![assets/主题/xxx.png](assets/主题/xxx.png.md)

初始化目录结构

你：阅读Karpathy wiki 方法论，帮我把仓库里的wiki文件夹的结构给建立起来

灌入第一篇资料

你： ingest

搭建仪表盘

你：我想调整obsidian的面板，更美观，更能展现我的wiki

你：我希望有一个切换深色/浅色主题的按钮

你：仪表盘能加上每天展示一行诗句，从诗词歌赋.md读取

日常 Ingest

你： ingest

健康检查

你：检查一下wiki是否搭建完善，做一轮健康检查

添加自定义规则

你：我使用Obsidian Web Clipper，网页笔记会直接放到raw/，你更新的时候把源笔记也在raw里面分类一下，写成一条规则到meta/CLAUDE.md

唤醒自动检查

你：哈喽

查询知识库

你：我想查询一下为什么房价会跌

拓展

（留空，按需补充）

附录

参考文章

[raw/it-tech/Karpathy wiki 方法论](raw/it-tech/Karpathy wiki 方法论.md) — Karpathy LLM Wiki 方法论（原始 gist）
meta/CLAUDE — AI 工作规则完整版
wiki/it-tech/concepts/llm-wiki-methodology — LLM Wiki 方法论概念页
wiki/it-tech/entities/karpathy-wiki — Karpathy’s LLM Wiki 实体页
wiki/it-tech/notes/obsidian-ai-knowledge-base-guide — Obsidian + Claude AI 搭建指南（第三方）
Karpathy AI+Obsidian 知识库教程 - 栗氪聊AI — 飞书文档（第三方）
helloianneo/obsidian-ai-second-brain — CLAUDE.md 模板参考

版权信息

本文原载于 Ray’s Wiki，请遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。

PowerShell $PROFILE 实用手册

Thu, 28 May 2026 10:00:00 +0800

前言

⚠️ 警告

本篇文章内容，主要针对 PowerShell 实用性配置，不涉及终端美化，请酌情食用。

$PROFILE 是 PowerShell 中一个非常重要的自动变量，它存储了 PowerShell 配置文件（Profile）的路径。通过编辑它，你可以打造一个完全符合自己习惯的终端环境。

下面是一段快速预览——将以下内容保存到你的 $PROFILE 中，立即体验语法高亮、智能补全、自定义提示符和文件图标：

# 1. 语法高亮与智能提示补全（默认自带，可在此优化）
Set-PSReadLineKeyHandler -Key Tab -Function MenuComplete
Set-PSReadLineOption -PredictionSource HistoryAndPlugin
Set-PSReadLineOption -PredictionViewStyle ListView
Set-PSReadLineOption -Colors @{
    Command = 'Yellow'
    Number = 'Magenta'
}

# 2. 自定义提示符（显示时间与当前路径）
function prompt {
    $date = Get-Date -Format 'HH:mm:ss'
    Write-Host "[$date] " -NoNewline -ForegroundColor Gray
    Write-Host "$(Get-Location) " -NoNewline -ForegroundColor Cyan
    return "> "
}

# 3. 文件Icons
Import-Module -Name Terminal-Icons

如何配置你的 $Profile

查看路径

在终端输入 echo $PROFILE 查看当前配置文件的具体路径。

创建文件

如果文件不存在，使用以下命令创建（注意如果 Documents 目录被 OneDrive 同步，建议将路径指向非同步目录）：

`1`	`if (!(Test-Path $PROFILE)) { New-Item -Type File -Path $PROFILE -Force }`

编辑配置

在终端输入 notepad $PROFILE（或在 VS Code 中输入 code $PROFILE）打开并编辑文本。

📌 重要

PSReadLine：优化命令历史、自动补全以及智能语法高亮。

常用路径别名：通过 Set-Alias 将常用长命令或路径设为简写。

快捷函数：创建自定义函数（如一键进入工作目录、一键清空终端缓存等）。

环境变量：配置全局变量或 API Key，供脚本或工具直接调用。

1. 语法高亮与智能提示补全

默认自带，可在 $PROFILE 中进一步优化：

# ==========================================
# 1. 核心功能：输入字母按 Tab 键，直接弹出命令选单
# ------------------------------------------
# 将 Tab 键功能修改为：输入字母后按 Tab，弹出所有相关命令的网格菜单
Set-PSReadLineKeyHandler -Key Tab -Function MenuComplete

# ==========================================
# 2. 核心功能：历史命令智能感知与全列表显示
# ------------------------------------------
# 开启历史与插件预测
Set-PSReadLineOption -PredictionSource HistoryAndPlugin

# 默认将预测显示样式设置为"列表视图(ListView)"，输入时会直接展开下拉列表
Set-PSReadLineOption -PredictionViewStyle ListView

# ==========================================
# 3. 界面美化与颜色自定义（可根据喜好修改）
# ------------------------------------------
# 设置提示列表的颜色（命令为黄色，数字为品红）
Set-PSReadLineOption -Colors @{
    Command = 'Yellow'
    Number = 'Magenta'
}

# （可选）Windows 剪贴板习惯：Ctrl + C 复制，Ctrl + V 粘贴
Set-PSReadLineKeyHandler -Key "Ctrl+v" -Function Paste
Set-PSReadLineKeyHandler -Key "Ctrl+c" -Function Copy

2. （可选）自定义提示符（显示时间与当前路径）

function prompt {
    $date = Get-Date -Format 'HH:mm:ss'
    Write-Host "[$date] " -NoNewline -ForegroundColor Gray
    Write-Host "$(Get-Location) " -NoNewline -ForegroundColor Cyan
    return "> "
}

3. 常用别名和快捷方式

1
2

Set-Alias cls Clear-Host
function cdws { Set-Location "C:\你的常用工作目录" }

4. （可选）显示文件夹 Icons

在 PowerShell 中输入以下代码。

第一行代码，从官方信任源下载并安装 Terminal-Icons 模块：

1
2

Install-Module -Name Terminal-Icons -Repository PSGallery -Force -Scope AllUsers
Set-ExecutionPolicy RemoteSigned -Force

然后将以下代码粘贴到 $PROFILE 文件的最底部：

1
2

# 自动导入终端图标模块
Import-Module -Name Terminal-Icons

5. （可选）集成 Oh My Posh 主题

需提前安装模块。以下代码仅供参考，详见教程 —— 使用 Oh My Posh 为 PowerShell 或 WSL 设置自定义提示符

1
2

# Oh-My-Posh 配置示例
oh-my-posh init pwsh --config "$HOME\AppData\Local\Programs\oh-my-posh\themes\jandedobbeleer.omp.json" | Invoke-Expression

6. 配置生效

编辑完成后保存关闭记事本，输入 . $PROFILE 立刻应用修改。

7. 开启脚本权限（如遇报错）

如果提示无法加载文件，需要以管理员身份运行 PowerShell，并执行策略：

`1`	`Set-ExecutionPolicy RemoteSigned`

拓展

💡 提示

这里博主安装了新的 Notepad.exe，但是 PowerShell 中输入 notepad 命令依旧使用的是旧的 notepad.exe。

要解决这个问题，需要先"挪走"原有的旧版记事本。但由于它是系统核心文件，直接删除或改名会被系统拒绝。

按照以下两步操作，先解锁权限并改名，然后再创建链接。

#  1. 将旧记事本的所有者修改为当前管理员组
takeown /f "C:\Windows\system32\notepad.exe" /a

#  2. 赋予管理员组对该文件的完全控制权限
icacls "C:\Windows\system32\notepad.exe" /grant administrators:F

#  3. 将旧记事本重命名为备份文件（腾出位置）
Rename-Item -Path "C:\Windows\system32\notepad.exe" -NewName "notepad.exe.bak"

1
2

# 第二个路径可替换为你使用的其他记事本软件路径（如 Notepad3 等）
New-Item -ItemType SymbolicLink -Path "C:\Windows\system32\notepad.exe" -Target "C:\Program Files\WindowsApps\Microsoft.WindowsNotepad_11.2604.5.0_x64__8wekyb3d8bbwe\Notepad\Notepad.exe"

参考文章

使用 Oh My Posh 为 PowerShell 或 WSL 设置自定义提示符 - Microsoft Learn

版权信息

本文原载于 Ranch’s Blog，遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。

VS Code 配置 C & C++ 编程运行环境

Sat, 09 Nov 2024 20:27:17 +0800

准备工作

下载 VS Code 安装包

官方下载链接：【Visual Studio Code - Code Editing. Redefined】

下载 Msys2

Github下载链接：【msys2-installer】

安装软件

`VSCodeUserSetup-x64.exe`

双击运行VSCodeUserSetup-x64-1.94.0.exe运行安装程序

`msys2-x86_64.exe`

双击msys2-x86_64-20240727.exe运行安装程序

当按下完成之后，会弹出打开一个 MSYS2 终端窗口。

在此终端中，通过输入以下命令并按回车键，安装 MinGW-w64 工具链：

`1`	`pacman -S --needed base-devel mingw-w64-ucrt-x86_64-toolchain`

出现这个界面，直接按回车键，默认接受所有的安装包。

当系统提示是否继续安装时，请输入y并回车。

当所有的包都安装好后，直接关闭终端。打开安装 MSYS2 的目录，先找到ucrt64文件夹并进入，再找到bin文件夹并进入，然后在地址栏中，复制路径。如果一开始用默认路径，那路径就是C:\msys64\ucrt64\bin。

然后在搜索框中输入 编辑系统环境变量，并打开编辑系统环境变量的设置界面。

在系统属性的弹窗中，点击环境变量。

在弹出的环境变量弹窗中，找到用户变量的Path，并双击打开。

此时会弹出编辑环境变量的窗口，先点击新建按钮，然后会在空白行中出现一个输入框和一个闪烁的光标，在这里粘贴上刚刚复制的路径，最后点击确定按钮回到上层弹窗。

最后，依次点击右下角确定退出。最后做一下测试，按组合键Win + r之后，输入cmd回车。

1
2
3

gcc --version
g++ --version
gdb --version

安装VS Code 扩展

汉化扩展包（可选）

C/C++ 环境扩展包

测试 VS Code 的 C/C++ 编程环境

创建代码文件夹

VS Code 是一款基于文件夹进行代码编辑和管理的编辑器，通常我们会把新建一个文件夹来管理同一个项目的代码，并在 VS Code 中打开。

单个 .c 文件的运行和调试

为了方便管理代码，我们先选中C文件夹，再点击新建文件夹按钮。

此时会在C文件夹的下级出现一个输入框，我们新建一个名为test的文件夹。

鼠标右键test文件夹，在弹出的菜单中选择新建文件。在输入框中输入我们接下来要进行调试代码文件名，命名为test.c，注意，一定要是 .c 结尾。

接下来就可以输入一个调试程序了，我的代码如下：

#include <stdio.h>
 
int main()
{
    for (int i = 0; i < 5; i++)
        printf("Hello Ranch~%d\n", i);

    return 0;
}

写好测试代码后，点击右上角的调试按钮，这时会弹出调试程序的选项，选择第一个，也是本教程前面安装的 gcc 编译工具。

如果要进行简单的断点调试，可以在行号前加一个断点，操作也很简单，只需用鼠标左键点一下行号左边的空白处即可。如下图所示，是在第六行处加了一个断点。

这时再去运行程序，搜索框下面就会出现调试的面板，面板上有六个按钮，分别是继续、逐过程、单步调试、单步跳出、重启和停止。

📌 重要

以下是 VS Code 中的 C 语言代码调试面板功能的解释：

继续（Continue）：继续执行程序，直到遇到下一个断点或程序结束。

逐过程（Step Over）：逐行执行当前行，如果当前行是函数调用，则进入该函数并执行完毕。

单步调试（Step Into）：逐行执行当前行，如果当前行是函数调用，则进入该函数并停在函数内的第一行。

单步跳出（Step Out）：执行完当前函数的剩余部分，并停在当前函数被调用的下一行。

重启（Restart）：重新启动程序的调试会话，即从程序的起点开始执行。

停止（Stop）：停止程序的调试会话，结束调试过程并关闭程序执行。

多个 .c 文件的运行与测试

如果想要进行多个 .c 文件编译后的调试，就需要进行一些配置修改。如果进行过一次编译运行，我们会发现在资源管理器的C文件夹下，多出一个.vscode的文件夹，这个文件夹里面有个tasks.json的文件

这个文件是用于定义任务配置，这些任务可以在 VS Code 中运行，例如编译代码、运行测试、启动调试器等。

tasks.json文件是一个 JSON 格式的文件，其中包含了任务的配置信息，包括任务名称、命令、参数等。通过编辑tasks.json文件，我们可以自定义项目中的各种任务，并在 VS Code 中方便地执行这些任务。

当前的 VS Code 的运行效果还不是很理想，双击打开tasks.json文件修改一下编译运行功能。下图是对该 JSON 文件做了部分解释。

具体修改如下图所示，我注释掉了原来的${file}，并新增一行*.c，表示并非指定某一个 .c 文件，而是当前文件夹下所有的.c文件。

同时也把${fileDirname}\\${fileBasenameNoExtension}.exe注释掉，改成${fileDirname}\\program.exe，那么多个 .c 文件编译之后的可执行文件就是program.exe。

然后点击左侧的运行与调试，再点击创建launch.json文件。

然后 VS Code 会新建一个 JSON 文件，点击右下角的添加配置，在弹出的下拉菜单中选择C/C++：（gdb）启动。

修改为下图红框所示内容，“program”后的内容就是前面提到的tasks.json文件中的编译后产生的可执行文件。"miDebuggerPath"后面的则是前面安装的 MinGW-W64 的 gdb 工具的路径。修改后保持关闭。

附录

参考文献

《VS Code 配置 C/C++ 编程运行环境（保姆级教程）》

版权信息

本文原载于 Ranch’s Blog，遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。

【转载】Windows 下包管理器 Scoop 的安装与使用

Sat, 09 Nov 2024 20:12:54 +0800

转载自《Windows 下包管理器 Scoop 的安装与使用 - Muxiner’s Blog》

🍉 什么是 Scoop ？

😶‍🌫️ 可以去看【Scoop Github 上的介绍】。

😶‍🌫️ 还有官方文档【Scoop Wiki】w

😶‍🌫️ 官网【https://scoop.sh/】

Scoop 是 Windows 上的命令行安装工具。

🙈 可以用来干嘛？

🦥 通过命令行界面，Scoop 可以顺畅地安装应用程序。（官方说明）

🌲 没有权限弹出窗口
🌲 隐藏 GUI 向导式安装程序
🌲 防止因而安装大量程序造成 PATH 污染
🌲 避免安装和卸载程序的不当使用
🌲 自动查找并安装依赖项
🌲 自动执行所有额外的设置步骤来获取工作程序

🍉 安装 Scoop

🍊 准备工作

PowerShell ：确保已安装 PowerShell 5.0 或更高版本。

Windows 10 以及更高的版本默认安装的 PowerShell 5.0。
确保以允许 Powershell 执行本地脚本。
1

set-executionpolicy remotesigned -scope currentuser
Unrestricted 也可以，但是安全性较低。

最好使用 RemoteSigned。

🍑 安装在默认位置

默认安装在 C:\Users\username\scoop 路径下。

执行命令：

`1`	`Invoke-Expression (New-Object System.Net.WebClient).DownloadString('https://get.scoop.sh')`

或是执行（更短的）：

`1`	`iwr -useb get.scoop.sh \| iex`

2022.11.17 更新：

为加快 Scoop 的安装速度，主要是下载速度，使用代理进行加速下载。

fastgit 下载

下载 scoop_install.ps1：

`1`	`curl -o scoop_install.ps1 https://raw.fastgit.org/scoopinstaller/install/master/install.ps1`

修改 scoop_install.ps1 中文件下载地址：

`1`	`(Get-Content scoop_install.ps1).replace('https://github.com/ScoopInstaller/', 'https://download.fastgit.org//ScoopInstaller/') \| Set-Content scoop_install.ps1`

安装 Scoop：./scoop_install.ps1
删除 scoop_install.ps1：rm scoop_install.ps1

github proxy 下载

下载 scoop_install.ps1：

`1`	`curl -o scoop_install.ps1 https://ghproxy.com/https://raw.githubusercontent.com/scoopinstaller/install/master/install.ps1`

修改 scoop_install.ps1 中文件下载地址：

`1`	`(Get-Content scoop_install.ps1).replace('https://github.com/ScoopInstaller/', 'https://ghproxy.com/https://github.com/ScoopInstaller/') \| Set-Content scoop_install.ps1`

安装 Scoop：./scoop_install.ps1
删除 scoop_install.ps1：rm scoop_install.ps1

🍑 自定义安装目录

例如将 Scoop 安装在 C:\Scoop 路径下。

需要添加该路径到用户变量中：

`1`	`$env:SCOOP='C:\scoop'`

`1`	`[environment]::setEnvironmentVariable('SCOOP',$env:SCOOP,'User')`

当然也可以添加到系统变量中：

不过此时需要以管理员身份运行 PowerShell ，或是以管理员身份运行 Windows Terminal，再打开 PowerShell ，否则会报错：
1
[environment]::setEnvironmentVariable('SCOOP',$env:SCOOP,'Machine')

添加完环境变量后需要重启 PowerShell 或 Terminal 等待变量生效。

然后再执行安装指令：

`1`	`iwr -useb get.scoop.sh \| iex`

安装方式同上，点此跳转到新的安装方式

🍑 自定义全局应用安装目录

例如自定义将全局应用安装在 C:\apps 路径下：

就需要将该目录添加到系统变量中，步骤同上文相同：

😶‍🌫️ 以管理员身份运行
😶‍🌫️ $env:SCOOP_GLOBAL='C:\apps'
😶‍🌫️ [environment]::setEnvironmentVariable('SCOOP_GLOBAL',$env:SCOOP_GLOBAL,'Machine')
😶‍🌫️ 安装指令：scoop install -g <app>

合起来就是：

1
2
3

$env:SCOOP_GLOBAL='C:\apps'
[environment]::setEnvironmentVariable('SCOOP_GLOBAL',$env:SCOOP_GLOBAL,'Machine')
scoop install -g <app>

🍉 使用 Scoop

查看 scoop 的命令：

`1`	`scoop help`

查看命令的详细信息：

1
2
3

scoop help <command>
# for example: scoop help install 
# For more detailed information on INSTALL

执行 scoop help install ：

Usage: scoop install <app> [options]

e.g. The usual way to install an app (uses your local 'buckets'):
     scoop install git

To install an app from a manifest at a URL:
     scoop install https://raw.githubusercontent.com/ScoopInstaller/Main/master/bucket/runat.json

To install an app from a manifest on your computer
     scoop install \path\to\app.json

Options:
  -g, --global              Install the app globally
  -i, --independent         Don't install dependencies automatically
  -k, --no-cache            Don't use the download cache
  -u, --no-update-scoop     Don't update Scoop before installing if it's outdated
  -s, --skip                Skip hash validation (use with caution!)
  -a, --arch <32bit|64bit>  Use the specified architecture, if the app supports it

🍒 安装应用

分为两种情况：

😃为当前用户安装

安装路径：scoop\apps

scoop 路径默认在 C:\User\username 。

若是自定义安装路径，例如上文的位置，则在 C:\Scoop

安装命令：

1
2
3

scoop install <app>
# for example:
# scoop install nano

😃为所有用户安装

默认的安装路径：C:\ProgramData\scoop

若是如上文所示，自定义了全局应用安装目录，则安装路径：C:\apps

需要以管理员身份运行。

安装命令：

1
2
3

scoop install <app> -g
# for example:
# scoop install nano -g

🍒 卸载应用

😃卸载某一程序

`1`	`scoop uninstall <app>`

😃卸载程序并移除配置文件

`1`	`scoop uninstall <app> -p`

😃卸载全局程序

`1`	`scoop uninstall <app> -g`

😃更多信息

`1`	`scoop help uninstall`

🍒 更新

😃更新 scoop 及所有 bucket 但不更新 app

`1`	`scoop update`

😃更新某一 app

`1`	`scoop update <app>`

😃更新 scoop、bucket、app

`1`	`scoop update *`

😃更新全局 app

`1`	`scoop update <app> -g`

😃更多信息

`1`	`scoop help update`

🍒 其他有用操作

😃查看已安装 app

`1`	`scoop list`

😃查看可更新 app

`1`	`scoop status`

😃查看某 app 主页

`1`	`scoop home <app>`

😃查看「已知库」

`1`	`scoop bucket known`

😃添加「已知库」

`1`	`scoop bucket add <bucket>`

😃查看已添加的库

`1`	`scoop bucket list`

😃删除已添加的库

`1`	`scoop bucket rm <bucket>`

😃添加第三方库

`1`	`scoop bucket add <bucket> <bucket_url>`

😃删除已安装软件的旧版本

`1`	`scoop cleanup *`

😃清理软件缓存

通常是下载的软件安装包。

以下命令清除所有缓存，即清空 Scoop 目录下的 cache 文件夹。

`1`	`scoop cache rm *`

🍉 进阶

更多信息请查看【官方文档】。

附录

参考文献

转载自《Windows 下包管理器 Scoop 的安装与使用 - Muxiner’s Blog》

版权信息

本文原载于 Muxiner’s Blog，遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。

掌握 Docker魔法：Windows 11 平台上的完美容器部署终极指南

Fri, 08 Nov 2024 21:43:41 +0800

前言

什么是 Docker ？

容器工作的原理

容器的架构

Docker包括三个基本概念：

镜像（Image）：Docker 镜像（Image），就相当于是一个 root 文件系统。比如官方镜像 ubuntu:16.04 就包含了完整的一套 Ubuntu16.04 最小系统的 root 文件系统。
容器（Container）：镜像（Image）和容器（Container）的关系，就像是面向对象程序设计中的类和实例一样，镜像是静态的定义，容器是镜像运行时的实体。容器可以被创建、启动、停止、删除、暂停等。
仓库（Repository）：仓库可看成一个代码控制中心，用来保存镜像。

Docker 的优势

为何使用 Docker ？

Docker 支持开发人员使用简单的命令访问这些本机容器化功能，并通过节省工作量的应用程序编程接口 (API) 自动执行。与 LXC 相比，Docker 提供了以下功能：

增强的无缝容器可移植性：虽然 LXC 容器通常引用特定于机器的配置，但 Docker 容器无需修改即可在任何桌面、数据中心和云环境中运行。
更轻巧且更细粒度的更新：通过使用 LXC，可以在单个容器中组合多个进程。这样就可以构建持续运行的应用，即使为了更新或修复而关闭某个部分也不例外。
自动化容器创建：Docker 可以基于应用源代码自动构建容器。
容器版本控制：Docker 可以跟踪容器映像的版本，回滚到先前的版本，以及跟踪版本的构建者和构建方式。它甚至可以只上传现有版本和新版本之间的增量。
容器复用：现有容器可用作基本映像（本质上类似于用于构建新容器的模板）。
共享容器库：开发人员可以访问包含数千个用户贡献容器的开源注册表。

在初步认识了解了Docker后，下面正式进入Docker安装环节！

安装

进入Docker官网

首先先到Docker官网下载最新官方Docker for Windows链接：【下载Docker】

启动 Microsoft Hyper-V

在电脑上打开“控制面板”->“程序”-> “启动或关闭Windows功能”。

勾选Hyper-V功能

并勾选以下功能

重启后安装Docker

双击安装 docker

默认配置

等待安装结束

安装完毕后，点击Close and log out

电脑重启后，点击Docker程序

现在程序就正常启动啦

加速

配置aliyun镜像加速

如果pull操作比较慢，接下来需要配置一下镜像代理，便于更快速的拉取资源！
登录aliyun官网：《镜像加速器》

使用

查看

`1`	`docker --versionn`

获取镜像

`1`	`docker pull xxx`

查看镜像

`1`	`docer images`

删除镜像

# 删除指定的镜像
docker rmi xxx.image

# 清理本地的Docker镜像
docker image prune -f

启动容器

以下命令使用xxx镜像启动一个容器，参数为以命令模式进入该容器：

`1`	`docker run -it xxx /bin/bash`

也可以：

`1`	`docker run -it -rm --entrypoint /bin/bash 镜像名`

所以，更常用的是这种后台启动的方式:

`1`	`docker run -itd xxx /bin/bash`

交互容器

运行容器后正常启动状态，使用如下命令：

# 先在后台启动
docker run -itd --entrypoint /bin/bash reqpython 

# 查看刚才run的容器名 如：test 
docker ps 

# 再进入容器内部
docker exec -it test /bin/bash

只是做测试用，测试完后，不想保留容器，使用如下命令：

`1`	`docker run -it --rm --entrypoint /bin/bash 镜像名`

删除容器

# 删除单个
docker rm -f <容器ID>

# 批量删除
docker rm -f <容器ID>1 <容器ID>2 <容器ID>……

查看容器

`1`	`docker ps -a`

容器的暂停与恢复

# 暂停容器的运行，但是容器并没有运行
docker pause <容器ID>

# 恢复容器的暂停
docker unpause <容器ID>

容器的停止与重启

# 使用此命令会停止容器的运行,如果想不停止运行，可以使用暂停的命令。
docker stop <容器ID>

# 重启容器
docker restart <容器ID>

进入容器

先查看容器的名字

`1`	`docker ps -a`

再使用如下命令进入容器

`1`	`docker exec -it 容器的名字 /bin/bash`

更新容器

查看端口情况

查看端口开发情况

`1`	`netstat -nlpt`

查看端口占用情况

# 查看所有
ps aux

# 查看指定服务
ps aux | grep docker

查看端口映射

`1`	`docker port <容器ID>`

查看进程号（PID）

先查找容器ID

`1`	`docker ps -a`

传入<容器ID>查找PID

docker inspect -f '{{.State.Pid}}' <容器ID>

docker container top <容器ID>

ps aux | grep <容器ID>

获取容器内部正在运行的任务的占用内存资源情况

`1`	`docker stats --no-stream <容器ID>`

复制本地文件到容器内

`1`	`docker cp 本地文件路径 <容器ID>/<容器名>:容器内部存放文件位置`

打包容器为镜像

`1`	`docker commit <容器ID> <打包后的镜像名>:<版本号>`

附录

参考文献

《【Docker】掌握 Docker魔法：Windows 11 平台上的完美容器部署终极指南》

版权信息

本文原载于 Ranch’s Blog，遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。

超详细的wsl2教程：windows上的linux子系统

Sat, 02 Nov 2024 21:54:21 +0800

前置条件

CPU 虚拟化

修改BIOS设置（VMX/AMD-v）

windows 功能

适用于Linux的windows子系统
虚拟机平台

安装

默认 ubuntu 发行版

管理员权限打开 cmd

`1`	`wsl --install kali-linux --web-download`

查看在线发行版

`1`	`wsl --list --online`

查看安装的子系统

`1`	`wsl --list -v`

如果 windows下 sublinux 安装出现“不能访问网络位置+有关网络排除故障的信息”

netsh winsock reset
netsh int ip reset all
netsh winhttp reset proxy
ipconfig /flushdns

使用

切换默认子系统

`1`	`wsl --set-default xxx`

启动指定的子系统

`1`	`wsl -d kali-linux`

卸载

`1`	`wsl --unregister kali-linux`

备份

# 导出
wsl --export kali-linux kali.tar

# 导入
wsl --import kali2 D:/wsl C:\Users\admin\Desktop

kali 打开桌面窗口

wsl2 黑科技

WSLg

允许 Linux 里面带有UI的应用程序，直接以 Windows 窗口的形式打开

显卡直通

1
2

# 查看显卡
nvidia-smi

镜像网络模式

在 C:\Users\xxx 下面创建 .wslconfig 文件

1
2

[wsl2]
networkingMode = mirrored

然后保存，使用 wsl --shutdown 关闭虚拟机，等 8 秒。

kali 安装 Win-Kex

参考官方文档：【Win-Kex为Kali Linux提供GUI桌面体验】

win-kex支持以下三种模式

窗口模式

要在支持声音的 Window 模式下启动 Win-KeX，请运行以下任一命令：

Kali WSL 内部：kex --win -s
在 Windows 的命令提示符上：wsl -d kali-linux kex --win -s

有关更多信息，请参阅【 Win-KeX 窗口模式使用文档】。

增强的会话模式

要在具有声音支持和 ARM 解决方法的增强会话模式下启动 Win-KeX

请运行以下任一命令：

Kali WSL 内部：kex --esm --ip -s
在 Windows 的命令提示符上：wsl -d kali-linux kex --esm --ip -s

有关更多信息，请参阅【 Win-KeX 增强型会话模式使用文档】。

无缝模式

使用无缝模式（win-kex SL），请在WSL设置里，将网络模式更改为NAT

进入kali系统，修改/etc/resolv.conf文件里的nameserver，其IP地址与windows中vEthernet (WSL (Hyper-V firewall))IP地址一致。

要在具有声音支持的无缝模式下启动 Win-KeX，请运行，运行以下任一：

Kali WSL 内部：kex --sl -s
在 Windows 的命令提示符上：wsl -d kali-linux kex --sl -s

有关更多信息，请参阅【 Win-KeX SL 使用文档】。

附录

参考文献

《WSL2 + linux配置流程超详细指南 | mednight4》

版权信息

本文原载于 Ranch’s Blog，遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。

Win11使用JEnv管理多版本jdk

Tue, 22 Oct 2024 19:37:09 +0800

JEnv 介绍

【JEnv-for-Windows】是一个专为Windows系统设计的开源工具，由FelixSelter开发，其核心功能是让开发者能够轻松地在不同版本的Java开发工具包（JDK）之间进行切换。

关键技术和框架

批处理脚本：用于创建快捷的Java版本切换逻辑；
PowerShell脚本：用于环境变量的动态管理，兼容性增强，以及更高级的操作；
无需额外依赖：直接通过环境变量和脚本操作来实现JDK版本的管理。

这是如何运作的呢？

准备工作和详细安装步骤

步骤一：下载JDK并配置

安装 JDK

jdk-1.8

正常一步一步安装【jdk-8u421-windows-x64.exe】

jdk-xxx

将其他版本jdk的.zip压缩包解压到对应文件夹

配置环境变量

①新建系统变量JAVA_HOME，路径为jdk8路径

②新建系统变量CLASSPATH，指定类搜索路径

③系统变量Path中添加对应路径

步骤二：JEnv-for-Windows项目获取

从GitHub克隆该仓库到本地对应文件夹

`1`	`git clone https://github.com/FelixSelter/JEnv-for-Windows.git`

步骤三：JEnv环境准备

删除旧的JAVA_HOME

添加JEnv到系统路径

将刚克隆的项目路径添加到系统的环境变量Path中，确保可以从任何地方调用jenv.bat脚本。

步骤四：初始化与配置

首次运行JEnv

`1`	`jenv -help`

添加JAVA环境

接下来，将其他版本jdk添加到JEnv管理中

1
2

jenv add jkd8 C:\Environment\Java\jdk-1.8
jenv add jdk17 C:\Environment\Java\jdk-17.0.12

步骤五：验证

列出jenv管理的所有jdk版本：

`1`	`jenv list`

用命令切换jdk版本：

`1`	`jenv use {name}`

日常操作及使用方法

添加新的Java环境（需要绝对路径）
jenv add<name> <path>
示例：jenv add jdk15 D:\Programme\Java\jdk-15.0.1
更改当前会话的 java 版本
jenv use<name>
示例：jenv use jdk15
脚本编写的环境变量：
—PowerShell: $ENV:JENVUSE="jdk17"
—CMD/BATCH:set "JENVUSE=jdk17"
清除当前会话的 java 版本
jenv use remove
示例：jenv use remove
用于脚本编写的环境变量：
—PowerShell: $ENV:JENVUSE=$null
—CMD/BATCH:set "JENVUSE="
全局更改您的 java 版本
jenv change<name>
示例：jenv change jdk15
始终在此文件夹
jenv local<name>
中使用此 java 版本示例：jenv local jdk15
清除此文件夹的 java 版本
jenv local remove
示例：jenv local remove
列出所有 Java 环境
jenv list
示例：jenv list
从 JEnv 列表中删除现有的 JDK
jenv remove<name>
示例：jenv remove jdk15
允许使用位于 java 目录
jenv link<Executable name>
中的 javac、javaw 或其他可执行文件示例：jenv link javac
卸载 jenv 并自动恢复您选择的 Java 版本
jenv uninstall<name>
示例：jenv uninstall jdk17
自动搜索要添加的 java 版本
jenv autoscan [–yes|-y]?<path>?
示例：jenv autoscan "C:\Program Files\Java"
示例：jenv autoscan// 将搜索整个系统示例：jenv autoscan -y "C:\Program Files\Java"// 将接受默认值

附录

参考文献

JEnv-for-Windows 安装与配置完全指南

版权信息

本文原载于 Ranch’s Blog，遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。