Auto-sync: 2026-04-17 08:37

This commit is contained in:
2026-04-17 08:38:12 +08:00
parent 6caa1c2f47
commit a0a48bd334
247 changed files with 6577 additions and 3061 deletions

26
wiki/concepts/AI代理.md Normal file
View File

@@ -0,0 +1,26 @@
---
title: "AI代理Agent"
type: concept
tags: [ai, cursor, agent]
date: 2026-04-17
---
## Definition
基于 AI 模型的自动化任务助手,可以按模式生成代码、规划任务或回答问题。在 Cursor 中AI 代理有三种模式Plan规划、Agent执行、Ask咨询
## Context
- Cursor 中的 AI 代理
## Key Modes
- **Plan 模式**:生成计划,不修改代码
- **Agent 模式**:执行计划,会修改代码文件
- **Ask 模式**:仅返回文本答案,不改动文件
## Usage
1. Plan 模式用于生成开发计划
2. Agent 模式用于实际代码生成
3. Ask 模式用于咨询问题,安全无副作用
## Related Concepts
- [[Plan Mode]]:方案预览模式
- [[Build Mode]]:实际执行模式

28
wiki/concepts/ARM64.md Normal file
View File

@@ -0,0 +1,28 @@
---
title: "ARM64"
type: concept
tags: [linux, 架构, cpu, arm]
date: 2026-04-16
---
## Definition
ARM64AArch64是 64 位 ARM 架构,广泛用于移动设备、嵌入式系统和部分服务器(如 AWS Graviton、阿里云倚天710
## Aliases
- AArch64
- aarch64
## Key Characteristics
- 低功耗设计,效率优先
- 64 位寻址能力
- Apple SiliconM 系列芯片)也使用 ARM64 架构
- 部分云服务器使用 ARM 架构以降低成本
## Related Concepts
- [[x86_64]]:另一种 64 位架构Intel 和 AMD 处理器使用
## Usage
在 Linux 中可通过以下命令检测:
- `uname -m` 输出 aarch64
- `lscpu` Architecture 字段显示 aarch64
- `/proc/cpuinfo` 显示 AArch64 或 ARMv8

View File

@@ -0,0 +1,42 @@
---
title: "Alertmanager"
type: concept
tags: [alerting, prometheus, notification, devops]
sources: [家庭监控方案-prometheus-grafana-node-exporter-cadvisor-blackbox]
last_updated: 2026-04-16
---
## Definition
Alertmanager 是 Prometheus 告警处理组件,负责接收 Prometheus server 发送的告警,进行抑制、分组后推送到各种通知渠道。
## Key Features
- **抑制Inhibition**:避免冗余告警
- **分组Grouping**:将相似告警合并
- **路由Routing**:基于标签匹配发送到不同接收者
- **通知渠道**邮件、Slack、Teams、Telegram、PagerDuty、webhook 等
## Configuration Structure
```yaml
route:
receiver: default
group_wait: 10s
group_interval: 5m
repeat_interval: 3h
receivers:
- name: default
email_configs:
- to: "example@example.com"
```
## Common Notification Types
- 邮件email
- Slack
- Microsoft Teams
- Telegram
- PagerDuty
- Webhook
## Connections
- [[Alertmanager]] ← receives_alerts ← [[Prometheus]]
- [[Alertmanager]] → sends_notifications → [[Grafana]](可选集成)

View File

@@ -0,0 +1,28 @@
---
title: "Bind Mount"
type: concept
tags: [docker, volume]
---
## 定义
Bind Mount绑定挂载是 Docker 的一种卷挂载方式,将宿主机上的文件或目录直接映射到容器内部,实现宿主机与容器间的文件共享。
## 工作原理
- 将宿主机目录 `/home/user/project` 挂载到容器内的 `/app`
- 宿主机上的文件修改可实时反映到容器内
- 容器内生成的文件可直接在宿主机访问
## 应用场景
- 开发环境:代码修改实时生效,无需重新构建镜像
- 日志收集:容器日志直接写入宿主机目录
- 配置文件:共享配置文件
## 优点
- 实现代码修改实时生效
- 无需重新构建镜像即可测试代码变更
- 便于调试和迭代开发
## 关联概念
- [[Docker]]:容器化平台
- [[docker-compose.yml]]Docker Compose 配置
- [[Volume]]Docker 持久化数据的另一种方式

View File

@@ -0,0 +1,48 @@
---
title: "Blackbox_exporter"
type: concept
tags: [exporter, prometheus, blackbox, monitoring]
sources: [家庭监控方案-prometheus-grafana-node-exporter-cadvisor-blackbox]
last_updated: 2026-04-16
---
## Definition
Blackbox_exporter 是 Prometheus 官方提供的黑盒探测 exporter通过 HTTP、HTTPS、TCP、ICMP、DNS 等协议探测目标可用性和性能。
## Supported Modules
- **HTTP/HTTPS**探测状态码、响应时间、TLS 证书
- **TCP**:端口连通性
- **ICMP**主机可达性ping
- **DNS**:域名解析
## Use Cases
- 网站可用性监控
- TLS 证书到期告警
- DNS 解析监控
- 内网服务健康检查
## Key Metrics
- `probe_success`探测是否成功0/1
- `probe_duration_seconds`:探测耗时
- `probe_http_status_code`HTTP 状态码
- `probe_ssl_earliest_cert_expiry`SSL 证书到期时间
## Common Alert Rules
- HTTP 探测失败(连续 3 次)
- TLS 证书剩余 < 14 天
- 响应时间 > 阈值
## Docker 部署
```yaml
blackbox:
image: prom/blackbox-exporter:latest
ports:
- "9115:9115"
```
## Default Port
- 9115
## Connections
- [[Blackbox_exporter]] ← scrapes_by ← [[Prometheus]]
- [[Blackbox_exporter]] ← blackbox_monitoring ← [[Uptime Kuma]](可选集成)

View File

@@ -0,0 +1,22 @@
---
title: "Build Mode"
type: concept
tags: [ai-coding, workflow]
---
## 定义
OpenCode 的实际执行模式,接收指令后进行代码修改。
## 使用方式
在 OpenCode TUI 中按 Tab 键从 Plan 模式切换回 Build 模式。
## 作用
- 执行 AI 生成的实现方案
- 接收自然语言指令进行代码修改
- 支持 /undo 撤销修改
- 支持 /redo 重做修改
## 关联
- [[Plan Mode]]
- [[Vibe Coding]]
- [[OpenCode]]

View File

@@ -0,0 +1,22 @@
---
title: "Claude Code Templates"
type: concept
tags: []
date: 2026-04-17
---
## Definition
Claude Code 预配置模板平台,提供开箱即用的 Skills、Agents、MCP 模板。
## Types
- Skills可扩展的 Claude Code 技能模块
- Agents预配置的代理模板
- MCPModel Context Protocol 集成模板
## Installation
```bash
npx claude-code-templates@latest --skill=<template-name> --yes
```
## Related Entities
- [[AITmpl]]:模板提供网站

View File

@@ -0,0 +1,27 @@
---
title: "CloudDrive2"
type: concept
tags: [cloud-storage, aliyun, nas, mount]
date: 2026-04-16
---
## Definition
CloudDrive2 是一款第三方云盘挂载工具可以将阿里云盘、115 等云存储服务挂载为本地磁盘,在 NAS 上使用时可通过 Web 界面管理。
## Key Features
- 云盘挂载:将云盘映射为本地文件系统路径
- 多平台支持:支持 Synology、QNAP、威联通等 NAS 设备
- Web 管理界面:提供图形化配置界面
- 扫码授权:移动端 App 扫码即可完成云盘授权
- 离线下载:部分版本支持云盘离线下载功能
## Installation (Synology)
1. 在套件中心添加矿神源
2. 搜索 CloudDrive2 并安装
3. DSM 7+ 需要执行命令修复权限:`sudo sed -i 's/package/root/g' /var/packages/CloudDrive2/conf/privilege`
4. 打开 Web 界面配置云盘
## Related
- [[阿里云盘]]CloudDrive2 支持挂载的云盘之一
- [[Synology]]CloudDrive2 运行的平台
- [[Docker]]CloudDrive2 在 NAS 上的运行方式

View File

@@ -0,0 +1,26 @@
---
title: "Cloudflare D1"
type: concept
tags: [Cloudflare, Database, Serverless]
sources: []
last_updated: 2026-04-16
---
## Definition
Cloudflare D1 是 Cloudflare 提供的无服务器 SQL 数据库服务,基于 SQLite 实现。
## Core Features
- 完全托管,无需服务器管理
- 按查询次数计费
- 与 Cloudflare Workers 原生集成
- 支持读写分离
- 全球低延迟
## Use Cases
- 作为 Web 应用的后端数据库
- 存储用户数据、会话信息
- 作为 NodeWarden 等应用的数据库后端
## Connections
- [[Cloudflare Workers]] ← integrates_with ← [[Cloudflare D1]]
- [[Serverless-Computing]] ← uses ← [[Cloudflare D1]]

View File

@@ -0,0 +1,27 @@
---
title: "Cloudflare R2"
type: concept
tags: [Cloudflare, Storage, Serverless]
sources: []
last_updated: 2026-04-16
---
## Definition
Cloudflare R2 是 Cloudflare 提供的无服务器对象存储服务S3 兼容 API。
## Core Features
- 无服务器,按请求计费
- S3 兼容 API
- 与 Cloudflare Workers 原生集成
- 无带宽费用(与 S3 的主要区别)
- 支持大文件存储
## Use Cases
- 存储静态资源(图片、视频)
- 作为应用附件存储
- 作为 NodeWarden 的附件存储后端
## Connections
- [[Cloudflare Workers]] ← integrates_with ← [[Cloudflare R2]]
- [[Serverless-Computing]] ← uses ← [[Cloudflare R2]]
- [[MinIO]] ← similar_to ← [[Cloudflare R2]]

View File

@@ -0,0 +1,20 @@
---
title: "Composer模型"
type: concept
tags: [ai, cursor, model]
date: 2026-04-17
---
## Definition
Cursor 自研 AI 模型,主打生成速度优势,官方声称比同类模型快 4 倍。
## Context
- Cursor 2.0 使用的 AI 模型
## Features
- 专为代码生成优化
- 比类似模型快 4 倍
- 支持多代理并行操作
## Related Entities
- [[Cursor]]

View File

@@ -0,0 +1,22 @@
---
title: "DRY 原则"
type: concept
tags: []
---
## Definition
DRYDon't Repeat Yourself原则意为"不要重复自己"。它是软件工程的核心原则之一,旨在减少代码中的重复。
## Key Points
- 避免重复代码,提炼公共逻辑
- 单一信息源Single Source of Truth
- 模块化、函数化,提高复用价值
- 便于维护和修改
## Source
- [[kai-fa-jing-yan-yu-xiang-mu-gui-fan-zheng-li-wen-dang]]
## Related Concepts
- [[单一职责]]
- [[模块化]]
- [[代码可读性]]

View File

@@ -0,0 +1,24 @@
---
title: "Diff文件"
type: concept
tags: [cursor, diff, code-review]
date: 2026-04-17
---
## Definition
Diff 文件是显示代码改动对比的视图,帮助开发者快速审查 AI 修改的内容。
## Context
- Cursor 代码审查功能
## Usage
1. 代码生成后进入"待审查"状态
2. 使用 Diff 功能查看具体改动
3. 支持文件逐个审查或整体接收
4. 点击"撤销"按钮可撤销改动
## Important Note
代码改动一旦生成即写入文件,未点击"撤销"按钮前持续保留,需确保先测试代码再确认保存。
## Related Entities
- [[Cursor]]

View File

@@ -0,0 +1,24 @@
---
title: "Django Admin"
type: concept
tags: [django, web, admin]
---
## Definition
Django Admin 是 Django 框架内置的管理后台模块,基于模型自动生成管理界面,支持 CRUD 操作、搜索、过滤等功能。
## Core Features
- 自动生成管理界面
- 支持自定义模型注册
- 搜索和过滤功能
- 内联关联模型
- 富文本编辑器集成
## Use Cases
- 内容管理系统后台
- 数据管理工具
- 内部管理系统
## Related Concepts
- [[Django]]Django Admin 是 Django 框架的一部分
- [[TinyMCE]]Django Admin 常用的富文本编辑器

View File

@@ -0,0 +1,25 @@
---
title: "Django REST Framework"
type: concept
tags: [django, api, rest]
---
## Definition
Django REST FrameworkDRF是一个强大且灵活的工具包用于构建 RESTful API基于 Django 框架。
## Core Features
- RESTful API 构建
- 序列化器Serializer
- ViewSet 和 Router
- 认证和权限系统
- 自动 API 文档生成
## Use Cases
- 移动应用后端 API
- 单页应用SPAAPI
- 第三方集成 API
- n8n 自动化调用接口
## Related Concepts
- [[Django]]Django REST Framework 基于 Django 框架
- [[n8n]]:可通过 API 调用实现工作流自动化

30
wiki/concepts/Django.md Normal file
View File

@@ -0,0 +1,30 @@
---
title: "Django"
type: concept
tags: [python, web, framework]
---
## Definition
Django 是一个高级 Python Web 框架,鼓励快速开发和简洁实用的设计原则。由 Python 编写,强调代码复用和模块化。
## Core Features
- ORM对象关系映射系统
- 自动管理后台Django Admin
- 表单处理
- 用户认证系统
- RSS 聚合框架
## Use Cases
- Web 应用开发
- RESTful API 构建
- 内容管理系统
- 数据分析平台
## Aliases
- Django Web Framework
- Django Framework
## Related Concepts
- [[Django-Admin]]
- [[Django-REST-Framework]]
- [[Python]]

View File

@@ -0,0 +1,36 @@
---
title: "Docker Daemon 代理"
type: concept
tags: [docker, proxy]
last_updated: 2026-04-17
---
## Definition
Docker Daemon 代理是指为 Docker 守护进程dockerd配置 HTTP/HTTPS 代理,使 `docker pull``docker push` 等操作能够通过代理服务器访问外部网络。
## Problem
Docker 守护进程由 systemd 启动,不读取普通用户的 shell 环境变量(如 HTTP_PROXY、HTTPS_PROXY因此即使系统级配置了代理Docker 操作仍可能失败。
## Solution
通过 systemd drop-in 配置文件为 Docker Daemon 设置环境变量:
1. 创建配置目录:`sudo mkdir -p /etc/systemd/system/docker.service.d`
2. 创建代理配置文件:`sudo nano /etc/systemd/system/docker.service.d/http-proxy.conf`
3. 添加内容:
```
[Service]
Environment="HTTP_PROXY=http://127.0.0.1:10808/"
Environment="HTTPS_PROXY=http://127.0.0.1:10808/"
Environment="NO_PROXY=localhost,127.0.0.1"
```
4. 重载并重启:`sudo systemctl daemon-reload && sudo systemctl restart docker`
## Verification
```bash
docker info | grep -i proxy
```
## Related Concepts
- [[SOCKS5代理]]SOCKS5 代理协议
- [[透明代理]]:另一种强制流量走代理的机制
- [[科学上网]]:通过代理服务器绕过网络限制访问被封锁网站的技术

View File

@@ -0,0 +1,33 @@
---
title: "Docker Image"
type: concept
tags: [docker, container, image]
sources: [docker-images-transfer-guide]
last_updated: 2026-04-17
---
## Summary
Docker ImageDocker 镜像)是容器化平台的核心概念,是一个只读模板,包含应用程序及其运行时所需的全部依赖(代码、运行时、库、环境变量、配置文件等)。
## Definition
用于创建 Docker 容器的只读模板,通过分层存储实现高效复用和传输。
## Key Attributes
- **格式**:分层文件系统
- **存储方式**:可导出为 tar 归档文件
- **复用机制**:分层存储,多个镜像可共享基础层
## Use Cases
- 应用程序打包和分发
- 跨环境部署(开发、测试、生产)
- 离线环境镜像迁移
## Related Concepts
- [[Docker]]:容器化平台
- [[Docker-Save]]:镜像导出命令
- [[Docker-Load]]:镜像导入命令
## Connections
- [[Docker]] ← 包含 ← [[Docker-Image]]
- [[Docker-Image]] ← 可导出为 ← [[Docker-Save]]
- [[Docker-Image]] ← 可导入为 ← [[Docker-Load]]

View File

@@ -0,0 +1,42 @@
---
title: "Docker Load"
type: concept
tags: [docker, image, import]
sources: [docker-images-transfer-guide]
last_updated: 2026-04-17
---
## Summary
Docker Load 是 Docker 命令行工具的导入命令,用于从 tar 归档文件还原 Docker 镜像。
## Definition
从 tar 格式归档文件导入并还原 Docker 镜像的命令。
## Command Syntax
```bash
docker load < <input_file.tar>
# 或
docker load -i <input_file.tar>
```
## Examples
```bash
# 从 tar 文件导入镜像
docker load < xiaoya.tar
# 使用 -i 参数
docker load -i xiaoya.tar
```
## Use Cases
- 离线环境镜像导入
- 镜像备份恢复
- 跨主机镜像迁移
## Related Concepts
- [[Docker-Image]]:被导入的镜像对象
- [[Docker-Save]]:对应的导出命令
## Connections
- [[Docker-Image]] ← 导入为 ← [[Docker-Load]]
- [[Docker-Load]] ← 依赖 ← [[Docker-Save]]

View File

@@ -0,0 +1,31 @@
---
title: "Docker Network"
type: concept
tags: [docker, network, isolation]
last_updated: 2026-04-17
---
## Definition
Docker NetworkDocker 网络)是 Docker 容器网络隔离和通信机制。
## Network Types
- **bridge**:默认网络,容器间通信
- **host**:使用主机网络
- **overlay**跨主机网络Swarm
- **none**:无网络
## Commands
```bash
# 查看网络
docker network ls
# 创建网络
docker network create <network_name>
# 删除网络
docker network rm <network_name>
```
## Connections
- [[Portainer]] ← uses ← [[Docker Network]]
- [[Docker]] ← manages ← [[Docker Network]]

View File

@@ -0,0 +1,39 @@
---
title: "Docker Save"
type: concept
tags: [docker, image, export]
sources: [docker-images-transfer-guide]
last_updated: 2026-04-17
---
## Summary
Docker Save 是 Docker 命令行工具的导出命令,用于将一个或多个镜像打包成 tar 归档文件,便于离线传输和备份。
## Definition
将 Docker 镜像导出为 tar 格式归档文件的命令。
## Command Syntax
```bash
docker save -o <output_file.tar> <image_name>[:<tag>]
```
## Examples
```bash
# 导出单个镜像
docker save -o xiaoya.tar xiaoyaliu/alist
# 导出多个镜像
docker save -o images.tar image1:image2
```
## Use Cases
- 离线环境镜像迁移
- 镜像备份和归档
- 跨网络隔离环境传输
## Related Concepts
- [[Docker-Image]]:被导出的镜像对象
- [[Docker-Load]]:对应的导入命令
## Connections
- [[Docker-Image]] ← 导出为 ← [[Docker-Save]]

View File

@@ -0,0 +1,30 @@
---
title: "Docker Volume"
type: concept
tags: [docker, volume, storage, persistence]
last_updated: 2026-04-17
---
## Definition
Docker Volume数据卷是 Docker 容器持久化数据的机制,允许容器在重启后保留数据。
## Use Cases
- 数据库数据持久化
- 应用配置存储
- 日志存储
## Commands
```bash
# 查看卷
docker volume ls
# 删除卷
docker volume rm <volume_name>
# 删除未使用的卷
docker volume prune
```
## Connections
- [[Docker Volume]] ← used_by ← [[Portainer]]
- [[Docker]] ← manages ← [[Docker Volume]]

29
wiki/concepts/ELF.md Normal file
View File

@@ -0,0 +1,29 @@
---
title: "ELF"
type: concept
tags: [linux, 可执行文件, 格式]
date: 2026-04-16
---
## Definition
ELFExecutable and Linkable Format可执行和链接格式是 Linux 和 Unix 系统的标准可执行文件格式。
## Full Name
Executable and Linkable Format
## Key Characteristics
- 跨平台Linux、FreeBSD、Solaris 等多种系统使用
- 支持多种文件类型:可执行文件(.exe、共享对象.so、核心转储文件core
- 包含元数据:程序入口、段表、符号表等
## Usage
检测可执行文件架构:
```bash
file /bin/bash
# 输出示例ELF 64-bit LSB executable, x86-64
# 或ELF 64-bit LSB executable, ARM aarch64
```
## Related Concepts
- [[x86_64]]64 位 x86 架构可执行文件
- [[ARM64]]64 位 ARM 架构可执行文件

42
wiki/concepts/FRP.md Normal file
View File

@@ -0,0 +1,42 @@
---
title: FRP
type: concept
tags: [frp, 内网穿透, 穿透]
date: 2025-04-16
---
## Aliases
- Fast Reverse Proxy
- frp
## Definition
FRPFast Reverse Proxy是一款高性能的反向代理工具用于内网穿透。它允许用户将内网服务通过公网服务器暴露给外部访问。
## Key Characteristics
- 开源GitHubfatedier/frp
- 支持多种协议TCP、UDP、HTTP、HTTPS
- 配置简单
- 支持多种认证方式token、oidc
- 客户端/服务端架构
## Use Cases
- 将内网 HTTP 服务暴露到公网
- 远程访问内网 SSH
- 端口映射
- 负载均衡
## Architecture
- **frps**FRP 服务端,运行在有公网 IP 的 VPS 上
- **frpc**FRP 客户端,运行在内网机器上
- 客户端连接服务端,建立长连接
- 服务端接收外部请求,转发给客户端
## Versions
- 0.65.0(当前版本)
- 0.65.0 for x86_64linux_amd64
- 0.65.0 for ARM64darwin_arm64
## Connections
- [[FRP]] ← implements ← [[内网穿透]]
- [[FRPServer]] ← runs_on ← [[VPS2]]
- [[FRP客户端]] ← runs_on ← [[Mac Mini]]

29
wiki/concepts/GPT.md Normal file
View File

@@ -0,0 +1,29 @@
---
title: "GPT"
type: concept
tags: [partition-table, uefi, storage]
date: 2026-04-16
---
## Aliases
- GPT
- GUID Partition Table
- GUID 分区表
## Definition
GPTGUID Partition Table是一种现代硬盘分区表标准作为 MBR 的替代方案,支持 2TB 以上大容量硬盘,与 UEFI 引导完美兼容。
## Key Properties
- 最大支持容量:理论上无限(实际受操作系统限制)
- 分区数量:理论上最多 128 个主分区
- 唯一标识:每个分区有唯一的 GUID 标识符
- 冗余GPT 头部信息在磁盘末尾有备份
## Use Cases
- UEFI 系统安装(如 Ubuntu 24.04 在 HP ZBook
- 大容量硬盘分区(>2TB
- 现代工作站和服务器
## Connections
- [[GPT]] ← works_with ← [[UEFI]]
- [[GPT]] ← used_by ← [[Bootable USB]]

33
wiki/concepts/Grafana.md Normal file
View File

@@ -0,0 +1,33 @@
---
title: "Grafana"
type: concept
tags: [visualization, monitoring, dashboard, devops]
sources: [家庭监控方案-prometheus-grafana-node-exporter-cadvisor-blackbox]
last_updated: 2026-04-16
---
## Definition
Grafana 是开源的可视化平台支持多数据源Prometheus、Elasticsearch、Loki、InfluxDB 等)的仪表盘创建和告警通知。
## Key Features
- **多数据源支持**Prometheus、Elasticsearch、Loki、InfluxDB、MySQL 等
- **仪表盘模板**:社区共享大量预置仪表盘
- **告警规则**:支持阈值、条件告警和多通道通知
- **变量和模板**:支持动态仪表盘
- **用户和权限**:支持团队和角色管理
## Common Dashboard IDs
- Node Exporter Full: `1860`
- cAdvisor Container Metrics: `14282`
- Blackbox Exporter Probe: `7587`
## Use Cases
- 基础设施监控仪表盘
- 应用性能监控
- 日志聚合可视化
- 业务指标展示
## Connections
- [[Grafana]] ← data_source ← [[Prometheus]]
- [[Grafana]] ← data_source ← [[Loki]]
- [[Grafana]] ← core_tool ← [[监控可观测性]]

View File

@@ -0,0 +1,28 @@
---
title: "HandleLidSwitch"
type: concept
tags: [systemd, power-management]
date: 2026-04-17
---
## Definition
systemd-logind 的电源管理配置项,用于控制笔记本合盖时的系统行为。
## Configuration Options
- `ignore`:不执行任何操作,系统继续运行
- `suspend`:进入待机状态
- `hibernate`:进入休眠状态
- `poweroff`:关机
- `lock`:锁定屏幕
## Related Config Items
- `HandleLidSwitch`:合盖时的动作(电池模式下)
- `HandleLidSwitchExternalPower`:连接外接电源合盖时的动作
- `HandleLidSwitchDocked`:连接扩展坞合盖时的动作
## Use Cases
- 服务器场景:设置 ignore 防止合盖后系统休眠
- 笔记本场景:合盖自动锁定或待机
## Connections
- controlled_by → [[systemd-logind]]

View File

@@ -0,0 +1,39 @@
---
title: IP纯净度
type: concept
tags: [IP, 网络安全, 风险评估]
---
## Definition
IP 纯净度IP Reputation / IP Cleanliness是评定某个 IP 地址是否安全可靠的风险等级指标。纯净度高的 IP低风险代表该 IP 具有良好的信誉,较少被用于垃圾邮件、恶意行为或被平台标记;纯净度低的 IP高风险可能被封禁或导致账号被关联。
## Evaluation Criteria
- **低风险(推荐)**IP 信誉良好,未被标记,可安全使用
- **中等风险(不推荐)**:存在一定风险,可能被平台关注
- **高风险(禁用)**IP 已被标记或污染,使用会导致封号
## Detection Methods
通过多个 IP 检测网站交叉验证:
- 国内 IP 检测点
- 国外 IP 检测点
- 谷歌 IP 检测点
三处必须高度一致,否则可能被判定为代理异常
## Common Tools
- ip111.cn
- ipinfo.io
- scamalytics.com
- whatismyipaddress.com
## Importance
- **账号安全**:低纯净度 IP 是导致账号被封的主要因素之一
- **一致性**:代理 IP 在不同检测网站的结果必须一致
- **稳定性**:建议使用静态住宅 IP避免频繁切换
## Related Entities
- [[SOCKS5代理]]
## Related Concepts
- [[代理配置]]
- [[静态IP]]
- [[住宅IP]]

View File

@@ -0,0 +1,29 @@
---
title: "MCP服务器"
type: concept
tags: [ai, mcp, protocol]
date: 2026-04-17
---
## Definition
MCPModel Context Protocol模型上下文协议是一种支持将外部工具和服务集成到 AI 代理的协议平台,赋予 AI 代理更丰富的执行能力。
## Full Name
Model Context Protocol
## Context
- Cursor 的扩展功能
## Features
- 集成外部 API 和工具
- 扩展 AI 代理功能范围
- 支持添加和切换多个 MCP 服务器
## Usage
在 Cursor 中添加 MCP 服务器:
1. 打开设置面板
2. 找到 MCP 服务器配置
3. 添加或切换 MCP 服务器
## Related Entities
- [[Cursor]]

31
wiki/concepts/Node-js.md Normal file
View File

@@ -0,0 +1,31 @@
---
title: "Node.js"
type: concept
tags: [javascript, runtime, server-side]
last_updated: 2026-04-17
---
## 定义
Node.js 是基于 Chrome V8 引擎的 JavaScript 运行时,用于构建快速、可扩展的网络应用和服务端代码。
## 核心特性
- 事件驱动、非阻塞 I/O 模型
- 跨平台Windows、Linux、macOS
- 前后端统一 JavaScript 语言
- 丰富的 npm 生态系统
## 常用版本管理工具
- [[nvm]]Node 版本管理器,推荐用于多版本环境
- nNode 版本管理工具
## 常用包管理工具
- [[npm]]Node 包管理器
- [[npx]]Node 包执行工具
## 常用进程管理工具
- [[pm2]]Node 进程管理器
## 关联
- 基于V8 引擎
- 框架Express、FastAPIPython、NestJS
- 场景服务端开发、CLI 工具、AI Agent

View File

@@ -0,0 +1,51 @@
---
title: "Obsidian 插件组合"
type: concept
tags: [Obsidian, 插件, 知识管理]
---
## Description
Obsidian 插件组合是指根据不同使用场景和需求,将 10 款核心插件进行合理搭配以发挥最大效率的策略。
## 组合类型
### 知识管理流
- **组合**Dataview + Templater + Calendar
- **用途**:自动化记录与检索
- **场景**:适合需要大量笔记管理和检索的用户
### 任务管理流
- **组合**Kanban + Projects + Outliner
- **用途**:复杂任务拆解与执行
- **场景**:适合项目管理和多任务处理
### 学习研究流
- **组合**Spaced Repetition + DB Folder
- **用途**:知识记忆与结构化存储
- **场景**:适合学习和研究场景
## 插件分类
### 核心生产力插件(强烈推荐安装)
- [[Templater]]:动态模板插件
- [[Dataview]]SQL 查询插件
- [[Spaced Repetition]]:间隔重复学习插件
- [[QuickAdd]]:快速添加插件,支持快捷键快速创建笔记
### 效率增强插件(推荐按需选择)
- [[Kanban]]:看板视图插件
- [[Projects]]:项目管理插件
- [[Outliner]]:大纲视图插件
### 信息可视化插件(辅助型插件)
- [[Calendar]]:日历视图插件
- [[DB Folder]]:数据库文件夹插件
### 便利性插件(可选安装)
- [[Homepage]]:主页插件
- [[File Explorer Note Count]]:文件管理器笔记计数插件
## Connections
- [[Obsidian]] → 使用 → [[Obsidian 插件组合]]
- [[Dataview]] ← 替代方案 → [[DB Folder]]
- [[Kanban]] ← 配合使用 → [[Projects]]

View File

@@ -1,21 +0,0 @@
---
title: "Ollama"
type: concept
tags: [AI, 本地模型, Ollama]
date: 2025-11-11
---
## Definition
Ollama 是一个本地大语言模型运行环境,支持在本地运行 Llama、Mistral 等开源模型,无需外部 API。
## Key Features
- 本地运行、保护隐私
- 支持多种开源模型
- 可通过 HTTP API 调用
## Role
在电商数据采集系统中Ollama 用于本地 AI 处理(摘要、分类、特征提取),替代外部 OpenAI API 实现离线处理。
## Connections
- [[n8n]] ← calls [[Ollama]]
- [[Ollama]] ← runs_in [[Docker]]

View File

@@ -0,0 +1,22 @@
---
title: "Plan Mode"
type: concept
tags: [ai-coding, workflow]
---
## 定义
OpenCode 的方案预览模式,禁用代码修改功能,仅展示 AI 实现的计划。
## 使用方式
在 OpenCode TUI 中按 Tab 键切换到 Plan 模式。
## 作用
- 预览 AI 生成的实现方案
- 在实际修改前审查计划
- 可添加更多细节或调整需求
- 确认后再切换到 Build 模式执行
## 关联
- [[Build Mode]]
- [[Vibe Coding]]
- [[OpenCode]]

View File

@@ -0,0 +1,37 @@
---
title: "Prometheus"
type: concept
tags: [monitoring, prometheus, time-series, devops]
sources: [家庭监控方案-prometheus-grafana-node-exporter-cadvisor-blackbox]
last_updated: 2026-04-16
---
## Definition
Prometheus 是开源的时序数据库和监控系统采用拉取Pull模式采集指标支持 PromQL 查询语言和告警规则引擎。
## Key Features
- **拉取模式**:主动从 exporters 拉取指标数据
- **PromQL**:强大的时序数据查询语言
- **告警规则**:支持定义告警条件和阈值
- **多数据源**:可对接多种 exportersnode_exporter、cAdvisor、blackbox_exporter
- **服务发现**支持动态服务发现Kubernetes、Consul 等)
## Architecture
- **Prometheus Server**:采集、存储时序数据
- **Exporters**指标采集器node_exporter、cAdvisor、blackbox_exporter
- **Alertmanager**:告警分发和处理
- **Pushgateway**:支持推送模式的网关(用于短期任务)
## Common Metrics Types
- Counter递增计数器
- Gauge当前值可增可减
- Histogram直方图分布
- Summary分位数统计
## Connections
- [[Prometheus]] → scrapes → [[node_exporter]]
- [[Prometheus]] → scrapes → [[cAdvisor]]
- [[Prometheus]] → scrapes → [[Blackbox_exporter]]
- [[Prometheus]] → sends_alerts → [[Alertmanager]]
- [[Prometheus]] ← visualized_by → [[Grafana]]
- [[Prometheus]] ← core_component → [[监控可观测性]]

View File

@@ -0,0 +1,31 @@
---
title: "Qwen2.5-Coder"
type: concept
tags: [ai, llm, code-generation, qwen]
---
## Description
阿里通义千问Qwen系列的代码生成模型2.5 版本。7B 参数版本大小约 4.5GB,适合本地运行。
## Key Capabilities
- 代码生成Python、Shell、SQL 等)
- 代码理解与分析
- Repo 级代码理解
- 强大的 Tool usage 能力
- 适合工程任务DevOps 自动化、SQL Agent、Kubernetes 故障排查)
## Model Variants
| 型号 | 参数 | 大小 | 推荐配置 |
|-----|------|------|----------|
| qwen2.5-coder:3b | 3B | ~2GB | 8GB RAM |
| qwen2.5-coder:7b | 7B | ~4.5GB | 16GB RAM |
## Compared to Qwen2.5
Qwen2.5-Coder 在工程任务上优于普通 Qwen2.5,特别适合:
- Tool usage
- Shell/Python/SQL 理解
- 代码理解和生成
## Connections
- [[Ollama]] ← hosts ← [[Qwen2.5-Coder]]
- [[OpenClaw]] ← uses ← [[Qwen2.5-Coder]]

View File

@@ -0,0 +1,40 @@
---
title: "Remote-SSH"
type: concept
tags: [remote-development, vscode-plugin]
---
## 定义
Remote-SSH 是 VS Code/Trae 的远程开发插件,允许开发者通过 SSH 协议连接到远程服务器,在远程主机上直接进行开发、调试和运行代码。
## 工作原理
1. 本地运行 Trae/VS Code 客户端
2. 通过 SSH 连接到远程服务器
3. 在远程服务器上安装 VS Code ServerTrae Server
4. 所有代码操作在远程服务器执行,本地仅显示 UI
## 核心功能
- 远程文件夹浏览和编辑
- 远程终端访问
- 远程调试功能
- 插件安装在远程服务器
## 应用场景
- 服务器端开发
- 跨平台开发(本地 Windows远程 Linux
- 容器内开发(通过 Remote-Containers
- 高性能开发(利用远程服务器算力)
## 优点
- 无需在本地配置复杂开发环境
- 利用远程服务器资源进行编译和测试
- 代码始终保存在远程服务器,安全性高
## 关联工具
- [[Trae]]:支持 Remote-SSH 的 AI 增强编辑器
- [[Docker]]:远程服务器上的容器化环境
- [[SSH]]:远程连接协议
## 连接关系
- [[Remote-SSH]] ← connects_to ← [[SSH]]
- [[Remote-SSH]] ← runs_on ← [[Ubuntu]]

View File

@@ -0,0 +1,36 @@
---
title: SOCKS5代理
type: concept
tags: [网络代理, 协议, 隐私]
---
## Definition
SOCKS5 是一种网络代理协议,属于 SOCKS 协议的第五版。它支持 TCP 和 UDP 连接,提供认证功能,能够在客户端和服务器之间建立传输隧道,隐匿用户的真实 IP 地址和地理位置。
## Key Features
- 支持 TCP 和 UDP 协议
- 支持用户认证
- 可隐匿真实 IP
- 支持多种应用层协议
- 比 HTTP 代理更底层,兼容性更好
## Use Cases
- 指纹浏览器配合代理配置
- 网络隐私保护
- 跨境访问海外服务
- 账号防封(通过切换 IP
## Configuration in Fingerprint Browser
1. 在系统网络设置中配置本机代理
2. 获取代理的主机地址和端口
3. 在指纹浏览器中选择 SOCKS5 代理类型
4. 填入主机和端口,验证连接
## Related Entities
- [[AdsPower]]
- [[IP纯净度]]
## Related Concepts
- [[代理配置]]
- [[HTTP代理]]
- [[VPN]]

View File

@@ -0,0 +1,32 @@
---
title: "Secure Boot"
type: concept
tags: [security, boot, uefi, firmware]
date: 2026-04-16
---
## Aliases
- Secure Boot
- 安全启动
## Definition
Secure Boot 是 UEFI 标准的安全特性,通过数字签名验证引导加载程序,防止恶意软件在系统启动阶段注入。在安装 Ubuntu 等第三方操作系统时,通常需要关闭以避免驱动兼容性问题。
## Key Properties
- 功能:验证引导加载程序数字签名
- 保护阶段:操作系统启动前
- 可关闭:大多数 BIOS/UEFI 允许禁用
- 微软件签名:使用 PK/KEK/DB 数据库
## Use Cases
- Windows 安全启动(默认开启)
- 阻止 bootkit 攻击
- Ubuntu/NixOS 等 Linux 发行版安装(建议关闭)
## Recommendations
- HP ZBook 安装 Ubuntu建议关闭 Secure Boot 以避免第三方驱动兼容性问题
- 安装完成后可根据需要重新开启
## Connections
- [[Secure Boot]] ← part_of ← [[UEFI]]
- [[Secure Boot]] ← conflicts_with ← [[Ubuntu]]

View File

@@ -0,0 +1,39 @@
---
title: "Symbolic Link"
type: concept
tags: [filesystem, macos, linux]
last_updated: 2025-01-14
---
## Definition
符号链接Symbolic Link又称软链接是一种特殊类型的文件它包含指向另一个文件或目录的路径引用。符号链接类似于 Windows 中的快捷方式或 macOS 中的替身Alias
## Technical Details
- 通过 `ln -s` 命令创建
- 符号链接文件大小仅为目标路径的字节数
- 删除符号链接不影响原始文件/目录
- 可以跨文件系统创建
## Use Cases
- 将隐藏目录映射为可见目录(如 OpenClaw 的 ~/.openclaw → ~/openclaw
- 在不同位置访问同一文件
- 创建项目结构的符号链接以方便访问
## Commands
```bash
# 创建符号链接
ln -s <target> <link_name>
# 验证符号链接
ls -l ~ | grep <link_name>
# 查看符号链接目标
readlink <link_name>
# 删除符号链接(仅删除链接,不删除目标)
rm <link_name>
```
## Related
- [[OpenClaw]] — 使用符号链接将隐藏目录映射为可见目录
- [[Obsidian]] — 通过符号链接访问非标准路径的文件

30
wiki/concepts/UEFI.md Normal file
View File

@@ -0,0 +1,30 @@
---
title: "UEFI"
type: concept
tags: [firmware, boot, bios, standards]
date: 2026-04-16
---
## Aliases
- UEFI
- Unified Extensible Firmware Interface
- 统一可扩展固件接口
## Definition
UEFI统一可扩展固件接口是替代传统 BIOS 的现代固件接口标准,提供更大的硬盘支持、更快的启动速度和更强的安全特性(如 Secure Boot
## Key Properties
- 发布时间2007 年
- 最大启动盘支持:理论上 16EB实际受操作系统限制
- 启动速度:比传统 BIOS 快
- 安全特性:支持 Secure Boot
- 驱动程序:可在固件中加载
## Use Cases
- 现代台式机和笔记本电脑启动(如 HP ZBook 安装 Ubuntu
- 服务器系统初始化
- 安全启动 Windows/Linux
## Connections
- [[UEFI]] ← works_with ← [[GPT]]
- [[UEFI]] ← requires ← [[Secure Boot]]

View File

@@ -0,0 +1,30 @@
---
title: "Vibe Coding"
type: concept
tags: [ai-coding, workflow]
---
## 定义
一种使用 AI 编程助手的开发方式开发者通过自然语言描述需求AI 负责具体的代码实现。
## 核心特征
- 自然语言驱动开发
- AI 辅助代码生成和修改
- Plan 模式预先审查实现方案
- AGENTS.md 记录项目代码模式
## 工作流程
1. 描述需求 → AI 生成实现计划Plan 模式)
2. 审查计划 → 调整需求或确认方案
3. 切换到 Build 模式 → AI 执行代码修改
4. 审查结果 → 可用 /undo 撤销
## 工具
- [[OpenCode]]
- [[Claude Code]]
- [[Ollama]](本地 LLM
## 关联概念
- [[Plan Mode]]
- [[Build Mode]]
- [[AGENTS.md]]

View File

@@ -0,0 +1,32 @@
---
title: "WOL (Wake on LAN)"
type: concept
tags: [network, power-management, lan]
date: 2026-04-17
---
## Definition
WOL (Wake on LAN网络唤醒) 是一种允许通过网络信号唤醒处于睡眠或关机状态计算机的技术。用户可以通过发送特殊的魔术数据包Magic Packet到目标设备的 MAC 地址,实现远程唤醒。
## Technical Details
- **魔术数据包**:包含目标设备 MAC 地址的特殊 UDP 数据包,发送到端口 9
- **MAC 地址格式**:如 `XX:XX:XX:XX:XX:XX`
- **默认端口**9UDP
## macOS Configuration
```bash
# 启用网络唤醒
sudo pmset -a womp 1
# 验证是否启用
pmset -g | grep womp
```
## Use Cases
- 远程唤醒家庭服务器(如 Mac Mini
- 远程桌面连接前先唤醒目标机器
- 节约能源,按需唤醒不在使用的机器
## Related Concepts
- [[pmset]]:电源管理工具,可启用 WOL
- [[caffeinate]]:临时保持唤醒的工具

19
wiki/concepts/Wayland.md Normal file
View File

@@ -0,0 +1,19 @@
---
title: "Wayland"
type: concept
tags: [display-protocol, linux, wayland]
last_updated: 2026-04-17
---
## Description
Linux 桌面环境的现代显示协议,作为 X11 的继任者设计,提供更好的安全性和性能。
## Key Characteristics
- 相比 X11 更加安全,限制客户端之间的隔离
- 默认用于 Ubuntu 24.04
- 出于安全设计,严格限制外部程序在用户未登录状态下获取屏幕控制权
## Relationship to Other Concepts
- 继任者:[[X11 (Xorg)]]
- 兼容:[[GDM3]](登录管理器)
- 远程桌面问题RustDesk 在 Wayland 下无法在登录界面正常工作

32
wiki/concepts/X11-Xorg.md Normal file
View File

@@ -0,0 +1,32 @@
---
title: "X11 (Xorg)"
type: concept
tags: [display-protocol, linux, x11]
last_updated: 2026-04-17
---
## Aliases
- X11
- Xorg
- X Window System
## Description
传统的 Linux 显示协议Ubuntu 早期版本默认使用,现在可作为 Wayland 的替代方案。
## Key Characteristics
- 兼容性更好,支持更多远程桌面软件
- 允许外部程序在登录界面获取屏幕控制权
- 通过 GDM3 配置可强制使用 X11 替代 Wayland
## Configuration
在 /etc/gdm3/custom.conf 中设置:
```
[daemon]
WaylandEnable=false
```
## Relationship to Other Concepts
- 前身:传统 X11
- 替代:[[Wayland]]
- 兼容:[[GDM3]]
- 远程桌面:支持 [[RustDesk]] 正常工作

42
wiki/concepts/cAdvisor.md Normal file
View File

@@ -0,0 +1,42 @@
---
title: "cAdvisor"
type: concept
tags: [container, monitoring, prometheus, docker]
sources: [家庭监控方案-prometheus-grafana-node-exporter-cadvisor-blackbox]
last_updated: 2026-04-16
---
## Definition
cAdvisorContainer Advisor是 Google 开发的容器指标采集器实时采集容器Docker的资源使用和性能数据提供容器级别的监控。
## Key Metrics
- **CPU**CPU 使用率、限制、throttling
- **内存**:使用量、限制、缓存
- **网络**:入站/出站流量、丢包
- **文件系统**:容器日志大小
- **容器元数据**:镜像、启动命令、标签
## Docker 部署
```yaml
cadvisor:
image: gcr.io/cadvisor/cadvisor:latest
ports:
- "8080:8080"
volumes:
- /:/rootfs:ro
- /var/run:/var/run:ro
- /sys:/sys:ro
- /var/lib/docker/:/var/lib/docker:ro
```
## Common Alert Rules
- 容器重启次数 > 01 小时内)
- 容器 CPU 限制超过 90%
- 容器内存限制超过 85%
## Default Port
- 8080
## Connections
- [[cAdvisor]] ← scrapes_by ← [[Prometheus]]
- [[cAdvisor]] ← container_monitoring ← [[监控可观测性]]

View File

@@ -0,0 +1,52 @@
---
title: "caffeinate"
type: concept
tags: [macos, power-management, command-line]
date: 2026-04-17
---
## Definition
caffeinate 是 macOS 内置工具,用于临时阻止系统进入睡眠状态。与 pmset 不同caffeinate 不修改系统设置,仅在运行时有效,按 Ctrl+C 停止后系统恢复默认睡眠行为。
## Installation
```bash
# macOS 内置,无需安装
```
## Usage
```bash
# 防止显示器睡眠
caffeinate -d
# 防止系统空闲时睡眠
caffeinate -i
# 防止系统睡眠
caffeinate -s
# 模拟用户活动(防止睡眠)
caffeinate -u
# 组合使用(常用)
caffeinate -d -i -s
# 保持唤醒(按 Ctrl+C 停止)
caffeinate -d -i -s
```
## Parameters
| 参数 | 作用 |
|------|------|
| `-d` | 防止显示器睡眠 |
| `-i` | 防止系统空闲时睡眠 |
| `-s` | 防止系统睡眠 |
| `-u` | 模拟用户活动(防止睡眠) |
## Use Cases
- 临时运行需要持续运行的任务(如大型下载、安装)
- 演示或展示时需要保持屏幕常亮
- 不希望修改系统电源设置时的临时方案
## Related Concepts
- [[pmset]]:永久修改系统电源设置的工具
- [[WOL (Wake on LAN)]]:网络唤醒功能

View File

@@ -0,0 +1,39 @@
---
title: "efibootmgr"
type: concept
tags: [boot, efi, linux, command-line]
date: 2026-04-16
---
## Aliases
- efibootmgr
## Definition
efibootmgr 是 Linux 下的命令行工具,用于管理 EFI 固件中的启动顺序和启动项。可以查看、创建、删除和调整 UEFI 启动顺序,解决 HP BIOS 等系统启动顺序被重置的问题。
## Key Properties
- 平台Linux
- 功能NVRAM 启动项管理
- 权限:需要 root 权限
- 常见用法:-o 设置启动顺序,-c 创建新启动项,-v 查看详细信息
## Use Cases
- 修复 Ubuntu 启动顺序问题
- 设置默认启动操作系统
- 处理 HP BIOS 启动顺序被重置
## Example Commands
```bash
# 查看当前启动顺序
sudo efibootmgr
# 将 Ubuntu (Boot0005) 设为首选
sudo efibootmgr -o 0005,0000,0001,0002,0003
# 创建新启动项
sudo efibootmgr -c -d /dev/nvme0n1 -p 1 -L "Ubuntu" -l "\\EFI\\ubuntu\\shimx64.efi"
```
## Connections
- [[efibootmgr]] ← manages ← [[UEFI]]
- [[efibootmgr]] ← fixes ← [[启动顺序]]

View File

@@ -0,0 +1,40 @@
---
title: "node_exporter"
type: concept
tags: [exporter, prometheus, monitoring, linux]
sources: [家庭监控方案-prometheus-grafana-node-exporter-cadvisor-blackbox]
last_updated: 2026-04-16
---
## Definition
node_exporter 是 Prometheus 官方的主机指标采集器,采集 Linux/Unix 主机的 CPU、内存、磁盘、网络、文件系统等系统指标。
## Key Metrics
- **CPU**:使用率、上下文切换、软中断
- **内存**:总量、可用、已用、缓存
- **磁盘**使用率、IO、inode
- **网络**:流量、丢包、错误
- **文件系统**:挂载点、容量、使用率
## Docker 部署
```yaml
node_exporter:
image: prom/node-exporter:latest
network_mode: "host"
volumes:
- /proc:/host/proc:ro
- /sys:/host/sys:ro
- /:/rootfs:ro
```
## Common Alert Rules
- CPU 使用率 > 85%
- 磁盘空间 < 10%
- 可用内存 < 15%
## Default Port
- 9100
## Connections
- [[node_exporter]] ← scrapes_by ← [[Prometheus]]
- [[node_exporter]] ← core_exporter ← [[监控可观测性]]

30
wiki/concepts/npm.md Normal file
View File

@@ -0,0 +1,30 @@
---
title: "npm"
type: concept
tags: [javascript, package-manager]
last_updated: 2026-04-17
---
## 定义
npmNode Package Manager是 Node.js 默认的包管理器,用于安装、管理和分享 JavaScript 代码包。
## 用途
- 安装全局或本地 Node 包
- 发布自己的 npm 包
- 管理项目依赖
- 运行 package.json 中的脚本
## 常用命令
```bash
npm install <package> # 安装本地包
npm install -g <package> # 全局安装
npm init # 初始化项目
npm run <script> # 运行脚本
npm list # 查看已安装包
npm update # 更新包
```
## 关联
- 随 [[Node-js]] 一起安装
- 配合工具:[[npx]](包执行器)
- 管理器:[[nvm]]Node 版本管理)

17
wiki/concepts/npx.md Normal file
View File

@@ -0,0 +1,17 @@
---
title: "npx"
type: concept
tags: []
date: 2026-04-17
---
## Definition
Node Package ExecutorNode.js 官方包执行工具,无需全局安装即可运行 npm 包。
## Use Cases
- 直接执行远程 npm 包
- 全局安装前的试用
## Related Concepts
- [[npm]]Node.js 包管理器
- [[Node.js]]JavaScript 运行时

33
wiki/concepts/nvm.md Normal file
View File

@@ -0,0 +1,33 @@
---
title: "nvm"
type: concept
tags: [node-js, version-manager]
last_updated: 2026-04-17
---
## 定义
nvmNode Version Manager是 Node.js 版本管理工具,允许在同一系统上安装和切换多个 Node.js 版本。
## 用途
- 安装指定版本的 Node.js
- 快速切换不同 Node 版本
- 避免全局 npm 包的版本冲突
- 使用非 root 用户安全安装 Node
## 安装方法
```bash
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
```
## 常用命令
```bash
nvm install 20 # 安装 Node 20
nvm use 20 # 切换到 Node 20
nvm alias default 20 # 设置默认版本
nvm list # 列出已安装版本
```
## 关联
- 基于:[[Shell]]
- 管理对象:[[Node-js]]
- 配合工具:[[npm]]、[[npx]]

38
wiki/concepts/pm2.md Normal file
View File

@@ -0,0 +1,38 @@
---
title: "pm2"
type: concept
tags: [node-js, process-manager, devops]
last_updated: 2026-04-17
---
## 定义
pm2 是 Node.js 进程管理器,提供进程守护、日志管理、负载均衡和开机自启等功能。
## 用途
- 守护 Node.js 进程,保持持续运行
- 管理系统日志
- 实现进程崩溃后自动重启
- 配置开机自启动
- 负载均衡cluster 模式)
## 安装方法
```bash
npm install -g pm2
```
## 常用命令
```bash
pm2 start <script> --name <name> # 启动进程
pm2 status # 查看状态
pm2 logs <name> # 查看日志
pm2 restart <name> # 重启进程
pm2 stop <name> # 停止进程
pm2 delete <name> # 删除进程
pm2 save # 保存当前进程列表
pm2 startup systemd # 生成自启动脚本
```
## 关联
- 配合工具:[[npm]]
- 管理对象:[[Node-js]]
- 替代工具forever、supervisor

48
wiki/concepts/pmset.md Normal file
View File

@@ -0,0 +1,48 @@
---
title: "pmset"
type: concept
tags: [macos, power-management, command-line]
date: 2026-04-17
---
## Definition
pmset 是 macOS 的电源管理命令行工具,用于查询和修改系统睡眠、显示器关闭、待机模式等电源相关设置。
## Usage
```bash
# 查看当前电源设置
pmset -g
# 禁止系统睡眠
sudo pmset -a sleep 0
# 禁止显示器关闭
sudo pmset -a displaysleep 0
# 禁止待机模式
sudo pmset -a standby 0
# 禁止休眠
sudo pmset -a hibernatemode 0
# 启用网络唤醒
sudo pmset -a womp 1
```
## Parameters
| 参数 | 作用 |
|------|------|
| `-a` | 应用于所有电源模式(电池和电源适配器) |
| `-b` | 仅电池模式 |
| `-c` | 仅电源适配器模式 |
| `sleep` | 系统睡眠时间分钟0 为禁止) |
| `displaysleep` | 显示器关闭时间分钟0 为禁止) |
| `standby` | 待机模式0 为禁止) |
| `hibernatemode` | 休眠模式0 为禁止) |
| `womp` | 网络唤醒1 为启用0 为禁用) |
## Related Concepts
- [[caffeinate]]:临时保持唤醒的工具
- [[WOL (Wake on LAN)]]:网络唤醒功能
- [[休眠 (Hibernate)]]:内存数据写入磁盘后完全断电
- [[待机 (Suspend)]]:内存保持供电的低功耗睡眠状态

View File

@@ -0,0 +1,22 @@
---
title: "双链Backlinks"
type: concept
tags: []
last_updated: 2025-03-13
---
## Definition
Obsidian 的核心功能,将当前笔记与其他笔记双向关联,使新旧笔记形成知识网络。
## Mechanism
- 当前笔记引用其他笔记时,被引用的笔记会自动显示"反向链接"Backlinks
- 点对点连接让零碎的笔记慢慢长成知识网络
- 解决碎片化记录导致的信息黑洞问题
## Relationships
- enabled_by → [[Obsidian]]
- enables → [[知识网络]]
## Aliases
- Backlinks
- 双向链接

View File

@@ -0,0 +1,30 @@
---
title: "systemd-logind"
type: concept
tags: [systemd, login-manager]
date: 2026-04-17
---
## Aliases
- systemd logind
## Definition
systemd 的登录管理器login manager负责处理用户登录会话和电源管理事件。在笔记本电脑合盖、按下电源键等事件发生时logind 根据配置决定系统行为(休眠、待机、关机等)。
## Key Properties
- 配置文件:/etc/systemd/logind.conf
- 服务名systemd-logind
- 控制合盖、电源按钮、外接电源、扩展坞连接等事件
## Related Concepts
- [[休眠 (Hibernate)]]:内存数据写入磁盘,系统完全断电
- [[待机 (Suspend)]]:内存保持供电,系统进入睡眠状态
- [[HandleLidSwitch]]:合盖电源行为配置项
## Use Cases
- 禁用笔记本合盖休眠
- 配置外接电源时的电源行为
- 配置连接扩展坞时的行为
## Connections
- part_of → [[systemd]]

27
wiki/concepts/x86_64.md Normal file
View File

@@ -0,0 +1,27 @@
---
title: "x86_64"
type: concept
tags: [linux, 架构, cpu]
date: 2026-04-16
---
## Definition
x86_64也称 x64是 64 位 x86 架构,是 Intel 和 AMD 处理器使用的指令集扩展。
## Aliases
- x64
- amd64
## Key Characteristics
- 64 位寻址能力,支持超过 4GB 内存
- 向后兼容 32 位 x86 指令
- 当前服务器和桌面主流架构
## Related Concepts
- [[ARM64]]:另一种 64 位架构,用于移动设备和部分服务器
- [[ELF]]Linux 可执行文件格式标准
## Usage
在 Linux 中可通过以下命令检测:
- `uname -m` 输出 x86_64
- `lscpu` Architecture 字段显示 x86_64

View File

@@ -0,0 +1,34 @@
---
title: "代理链 (ProxyChains)"
type: concept
tags: [proxy, network]
last_updated: 2026-04-17
---
## Definition
ProxyChains代理链是一个 Linux/Unix 工具,它可以强制任何终端命令通过 SOCKS5、HTTP 或 HTTPS 代理运行,使原本不支持代理的程序也能使用代理访问网络。
## Aliases
- proxychains
- proxychains4
## How It Works
ProxyChains 通过 LD_PRELOAD 机制劫持网络连接函数,将程序的网络请求重定向到指定的代理服务器。
## Configuration
配置文件通常位于 `/etc/proxychains4.conf`(旧版本为 `/etc/proxychains.conf`
```
[ProxyList]
socks5 127.0.0.1 10808
```
## Usage
```bash
proxychains4 curl https://www.google.com
proxychains4 git clone https://github.com/...
```
## Related Concepts
- [[SOCKS5代理]]ProxyChains 支持的代理类型之一
- [[透明代理]]:另一种强制流量走代理的机制

View File

@@ -0,0 +1,26 @@
---
title: "任务管理"
type: concept
tags: [效率, 工作流]
last_updated: 2025-03-13
---
## Aliases
- Task Management
## Definition
个人待办事项的组织、追踪和完成过程,通常涉及创建、分配优先级、设置截止日期和跟踪进度。
## Key Properties
- 目标:确保任务被完成,提高效率
- 常见工具Todoist、Notion、Obsidian Tasks
- 核心挑战:任务与上下文分离、工具切换成本
## Related Concepts
- [[深度工作]] — 专注无干扰的工作状态
- [[Markdown 语法]] — 任务创建的基础语法
## Related Entities
- [[Tasks 插件]] — Obsidian 的任务管理插件
- [[Todoist]] — 任务管理应用
- [[Notion]] — 一体化办公工具

View File

@@ -0,0 +1,29 @@
---
title: "休眠 (Hibernate)"
type: concept
tags: [systemd, power-management, linux]
date: 2026-04-17
---
## Aliases
- hibernate
## Definition
Linux 系统电源状态之一,将内存中的数据写入磁盘后完全断电,下次启动时从磁盘恢复数据。
## Key Properties
- 与 [[待机 (Suspend)]] 的区别:休眠完全断电,待机保持内存供电
- 系统完全停止运行,不耗电
- 唤醒时间较长(需要从磁盘加载数据)
## Related Commands
- `systemctl hibernate`:手动进入休眠
- `systemctl mask hibernate.target`:禁用休眠功能
## Use Cases
- 长时间不使用笔记本时
- 需要携带笔记本外出时
- 服务器场景:通常禁用休眠以保持服务运行
## Connections
- control_by → [[systemd-logind]]

View File

@@ -0,0 +1,27 @@
---
title: "伪代码"
type: concept
tags: [vibe-coding, documentation]
---
## 定义
在正式编码前,用类似编程语言的简洁语法描述具体逻辑的方法。
## 在 Vibe Coding 中的作用
- 将模糊的需求转化为明确的实现逻辑
- 减少 AI 对需求理解的歧义
- 相当于给 AI 提供"精确的施工图"
## 使用方法
1. 在设计文档中用伪代码描述 Service 层具体逻辑
2. 将伪代码交给 AI 生成实际代码
3. 用另一个 AI 进行 Code Review
4. 根据 Review 意见修改并运行测试
## 优势
- 需求 → 伪代码 → 代码的流程可显著提升 AI 代码生成质量
- AI 无需猜测实现细节,直接按图施工
## 关联概念
- [[Vibe-Coding]]
- [[AI-代理]]

View File

@@ -0,0 +1,26 @@
---
title: "信息黑洞"
type: concept
tags: []
last_updated: 2025-03-13
---
## Definition
只收集不使用的笔记困境,导致记了大量笔记但用时脑中空白。
## Problem
- 笔记存而不读、存而不用
- 微信收藏夹"稍后阅读"从未阅读
- 把笔记软件当成"炫酷的 Markdown 记事本"
## Solution
- [[双链Backlinks]]关联新旧笔记
- [[每日笔记]]串联想法
- [[定期复盘]]删除无用笔记
## Relationships
- problem_of → [[碎片化记录]]
- solved_by → [[双链Backlinks]] + [[每日笔记]] + [[地图笔记]] + [[定期复盘]]
## Aliases
- 笔记黑洞

View File

@@ -0,0 +1,22 @@
---
title: "单一职责"
type: concept
tags: []
---
## Definition
每个文件、每个类、每个函数应只负责一件事。这是软件设计的基本原则之一。
## Key Points
- 一个函数只处理一个任务
- 提炼公共逻辑避免重复代码DRY
- 模块化、函数化,提高复用价值
- 明确区分输入 → 处理 → 输出
## Source
- [[kai-fa-jing-yan-yu-xiang-mu-gui-fan-zheng-li-wen-dang]]
## Related Concepts
- [[DRY 原则]]
- [[模块化]]
- [[函数式编程]]

View File

@@ -0,0 +1,27 @@
---
title: "反向代理"
type: concept
tags: [networking, proxy, web-server]
date: 2026-04-17
---
## Definition
反向代理Reverse Proxy是一种服务器架构模式代理服务器接收外部客户端请求并根据配置将请求转发到一个或多个内部服务器然后将内部服务器的响应返回给客户端。
## Key Properties
- 位于客户端和真实服务器之间
- 隐藏真实服务器的真实 IP 和端口
- 可实现负载均衡、SSL 终止、缓存等功能
- 常见反向代理软件Nginx、Caddy、Traefik、Apache HTTP Server
## Use Cases
- 将外部请求转发到内网服务
- HTTPS/SSL 终止
- 负载均衡
- 静态资源缓存
- 统一入口管理多服务
## Connections
- [[反向代理]] ← implemented_by ← [[Caddy]]
- [[反向代理]] ← implemented_by ← Nginx
- [[反向代理]] → enables ← [[内网穿透]]

View File

@@ -0,0 +1,22 @@
---
title: "地图笔记"
type: concept
tags: []
last_updated: 2025-03-13
---
## Definition
整理核心主题的索引页,聚合相关笔记,方便快速导航。
## Practice
- 选几个关心的话题(比如"写作技巧"
- 创建索引页,聚合所有相关笔记
- 作为知识导航入口
## Relationships
- practice_of → [[知识管理]]
- aggregates → [[笔记网络]]
## Aliases
- Map Note
- 索引笔记

View File

@@ -0,0 +1,21 @@
---
title: "定期复盘"
type: concept
tags: []
last_updated: 2025-03-13
---
## Definition
定期翻看旧笔记,删除无意义内容或整理成更有逻辑的知识模块。
## Practice
- Obsidian 不等于"记了就有用"
- 定期检查,删除或合并无用笔记
- 让知识模块更有逻辑
## Relationships
- practice_of → [[知识管理]]
- maintains → [[知识网络]]
## Aliases
- 笔记复盘

View File

@@ -0,0 +1,17 @@
---
title: "容器化仪表板"
type: concept
tags: [docker, dashboard, homarr]
---
## Definition
通过 Docker 容器化技术部署的仪表板应用,作为家庭网络或服务器的统一服务入口。
## Related Concepts
- [[Docker Compose]]:部署容器化应用的工具
- [[Homarr]]:容器化仪表板的典型实现
## Use Cases
- 家庭网络服务统一入口
- 服务器状态监控面板
- 多服务快速访问

View File

@@ -0,0 +1,38 @@
---
title: "容器化媒体服务"
type: concept
tags: [docker, media-server]
---
## 定义
通过 Docker 容器化技术部署媒体应用的架构模式将媒体服务Xiaoya Alist、Plex、Navidrome 等)封装在独立容器中运行,实现环境隔离和快速部署。
## 背景
在 Synology NAS 等设备上,通过 Docker 部署媒体服务是主流方案。容器化提供了以下优势:
- 环境隔离:不同媒体服务运行在独立容器中,避免依赖冲突
- 快速部署:通过 Docker Image 快速启动服务
- 易于管理:统一使用 Container Manager 管理容器生命周期
## 核心组件
- [[Docker]]:容器化平台,提供容器运行时的基础设施
- [[Plex]]:媒体服务器,提供视频刮削和流媒体功能
- [[Xiaoya Alist]]:网络资源分享平台,聚合云盘资源
- [[CloudDrive2]]:云盘挂载工具,将阿里云盘映射为本地磁盘
## 应用场景
- 家庭媒体中心:整合多个云盘资源,统一管理
- 私有媒体库:通过 Plex 提供类似 Netflix 的私人流媒体服务
- 跨平台播放:支持智能电视、手机、平板等多种设备访问
## 与传统部署的区别
| 特性 | 容器化部署 | 传统部署 |
|------|------------|----------|
| 环境依赖 | 镜像内置依赖 | 需手动配置 |
| 部署速度 | 分钟级 | 小时级 |
| 迁移便利 | 导出/导入镜像 | 重新配置 |
| 资源占用 | 共享系统资源 | 独占环境 |
## 相关概念
- [[Docker]]:容器化平台
- [[Plex]]:媒体服务器
- [[CloudDrive2]]:云盘挂载

View File

@@ -0,0 +1,29 @@
---
title: "待机 (Suspend)"
type: concept
tags: [systemd, power-management, linux]
date: 2026-04-17
---
## Aliases
- suspend
## Definition
Linux 系统电源状态之一,系统进入低功耗睡眠模式,内存保持供电以维持数据。
## Key Properties
- 与 [[休眠 (Hibernate)]] 的区别:待机保持内存供电,休眠完全断电
- 系统进入睡眠状态,功耗降低
- 唤醒速度快(直接从内存恢复数据)
## Related Commands
- `systemctl suspend`:手动进入待机
- `systemctl mask suspend.target`:禁用待机功能
- `systemctl mask sleep.target`:禁用睡眠功能(包含待机、休眠、混合睡眠)
## Use Cases
- 短时间不使用笔记本时
- 保持工作状态,快速恢复
## Connections
- control_by → [[systemd-logind]]

View File

@@ -0,0 +1,22 @@
---
title: "微服务"
type: concept
tags: []
---
## Definition
微服务是一种架构模式,将系统拆解为多个独立开发、独立部署、独立扩容的服务。
## Key Points
- 每个服务处理一个业务边界Bounded Context
- 服务间通过 API 通信HTTP、RPC、MQ 等)
- 更灵活、更可扩展、容错更高
- 独立的数据存储和生命周期
## Source
- [[kai-fa-jing-yan-yu-xiang-mu-gui-fan-zheng-li-wen-dang]]
## Related Concepts
- [[消息队列]]
- [[容器化]]
- [[服务边界]]

View File

@@ -0,0 +1,31 @@
---
title: 指纹浏览器
type: concept
tags: [浏览器, 多账号管理, 环境隔离]
---
## Definition
指纹浏览器Fingerprint Browser是一种可模拟不同设备、网络环境的多账号浏览器。通过修改浏览器的指纹参数如 User-Agent、屏幕分辨率、时区、语言等创建多个独立的浏览器环境实现账号之间的隔离减少因指纹相似导致的账号关联和封号风险。
## Key Principles
- 环境隔离:每个浏览器环境独立,互不干扰
- 指纹模拟:模拟真实设备的浏览器指纹特征
- 代理支持:配合代理 IP 使用,隐藏真实网络环境
## Common Use Cases
- 多社交媒体账号管理
- 跨境电商多店铺运营
- 账号防封解决方案
- 自动化测试环境隔离
- 批量注册账号
## Related Tools
- [[AdsPower]]
- Multilogin
- Linken Sphere
- BitBrowser
## Related Concepts
- [[浏览器指纹]]
- [[代理配置]]
- [[IP纯净度]]

View File

@@ -0,0 +1,11 @@
---
title: "教育资源数字化"
type: concept
tags: []
---
## Description
将传统教育内容教材、课件等转化为数字格式的过程。ChinaTextbook 项目是将官方教材数字化的典型实践。
## Related Sources
- [[ChinaTextbook]]K12 及大学教材数字化项目

View File

@@ -0,0 +1,21 @@
---
title: "每日笔记"
type: concept
tags: []
last_updated: 2025-03-13
---
## Definition
每日记录并关联旧笔记的工作方式。
## Practice
- 每天写几行,总结当天学到的新东西
- 顺带看看有没有旧笔记可以连接
- 让笔记变成"活"的笔记
## Relationships
- practice_of → [[知识管理]]
- connected_to → [[双链Backlinks]]
## Aliases
- Daily Note

View File

@@ -0,0 +1,23 @@
---
title: "消息队列"
type: concept
tags: []
---
## Definition
消息队列Message Queue用于服务之间的"异步通信",是分布式系统中常见的中间件技术。
## Key Points
- 解耦:生产者和消费者无需直接依赖
- 削峰填谷:高峰期消息积压,低谷期慢慢处理
- 异步任务处理:提高系统响应速度
- 提高系统稳定性与吞吐
- 常见实现RabbitMQ、Kafka、Redis Stream、ActiveMQ
## Source
- [[kai-fa-jing-yan-yu-xiang-mu-gui-fan-zheng-li-wen-dang]]
## Related Concepts
- [[微服务]]
- [[异步处理]]
- [[削峰填谷]]

View File

@@ -0,0 +1,20 @@
---
title: "深度工作"
type: concept
tags: [效率, 专注]
last_updated: 2025-03-13
---
## Aliases
- Deep Work
## Definition
在无干扰状态下进行专注的职业活动,推动认知能力的极限,创造价值并提升技能。
## Key Properties
- 目标:最大化认知投入产出比
- 前提:消除分心源,将注意力集中在高价值任务上
- 关联:任务管理、信息整合
## Related Concepts
- [[任务管理]] — 深度工作的前提是知道要做什么

View File

@@ -0,0 +1,33 @@
---
title: "点-线-体迭代"
type: concept
tags: [vibe-coding, workflow]
---
## 定义
一种逐级迭代的开发方法,从单个任务(点)开始,逐步扩展到任务链(线),最终形成完整系统(体)。
## 在 Vibe Coding 中的作用
对应使用范围内的任务,先打磨好单个基础任务,然后基于此进行批量执行。
## 迭代层次
1. **点Point**:单个基础任务
- 最小可执行单元
- 验证基本功能正确性
2. **线Line**:任务链
- 多个相关任务串联
- 验证任务间协作
3. **体System**:完整系统
- 任务链组合形成系统
- 验证整体功能
## 应用场景
- 新功能开发:先实现最小功能,验证后再扩展
- AI 代理任务:先处理单个请求,处理稳定后再批量执行
- 系统集成:先验证点对点通信,再构建完整网络
## 关联概念
- [[Vibe-Coding]]
- [[伪代码]]

View File

@@ -0,0 +1,22 @@
---
title: "知识网络"
type: concept
tags: []
last_updated: 2025-03-13
---
## Definition
通过双链关联形成的笔记网络结构,使零散的笔记逐渐系统化。
## Formation
- 通过 [[双链Backlinks]] 点对点连接
- 零碎的笔记慢慢长成网络
- 用自己的方式消化知识,而非简单存档
## Relationships
- enabled_by → [[双链Backlinks]]
- composed_of → [[笔记]]
## Aliases
- 笔记网络
- Knowledge Network

View File

@@ -0,0 +1,17 @@
---
title: "硬件转码"
type: concept
tags: [video, encoding, hardware-acceleration]
sources: []
last_updated: 2025-04-17
---
## Definition
利用 GPU 硬件(如 Intel QuickSync、NVIDIA NVENC、AMD VCE加速视频编码/解码的过程,相比 CPU 软件编码能显著降低功耗和提高转码速度。
## Related Concepts
- [[Docker-Compose]]:容器化部署环境
- [[容器化媒体服务]]:媒体服务器容器化架构
## Application
在 Jellyfin 等媒体服务器中,通过挂载 `/dev/dri` 设备利用 Intel GPU 进行硬件转码,实现实时视频转码和流媒体播放。

View File

@@ -0,0 +1,12 @@
---
title: "笔记整理"
type: concept
tags: []
---
## Description
个人知识管理的基础,通过系统化的方法对笔记进行分类、标签和关联,提升信息检索和使用效率。
## Related Concepts
- [[Obsidian]]:笔记整理的常用工具
- [[Dataview]]Obsidian 插件,用于笔记数据的查询和可视化

View File

@@ -0,0 +1,28 @@
---
title: "系统 Prompt 优化"
type: concept
tags: [ai-coding, prompt-engineering]
---
## 定义
针对特定 AI 模型的系统提示词进行优化,以提升模型性能和任务完成质量。
## 优化方法
- 分析特定模型的行为特征
- 调整系统提示词的结构和指令
- 针对目标任务类型进行定制
## 优化效果
案例:针对 Gemini 3 Pro 的系统 Prompt 优化,使多个代理基准测试的性能提高了约 5%。
## 最佳实践
1. 明确模型角色和职责
2. 提供清晰的上下文信息
3. 设定具体的输出格式要求
4. 添加任务特定的约束条件
5. 迭代测试优化效果
## 关联概念
- [[Vibe-Coding]]
- [[AI-代理]]
- [[提示词工程]]

View File

@@ -0,0 +1,29 @@
---
title: "透明代理"
type: concept
tags: [proxy, networking, iptables]
sources: []
last_updated: 2026-04-17
---
## Aliases
- Transparent Proxy
- 透明代理
## Definition
透明代理Transparent Proxy是一种网络代理机制不需要在客户端显式配置代理设置而是通过 iptables/nftables 等防火墙规则强制将流量重定向到代理服务器。
## Mechanism
- 通过 iptables PREROUTING 或 OUTPUT 链修改目标地址
- 将匹配规则的流量重定向到本地代理端口
- 客户端无感知,所有流量自动走代理
## Use Cases
- NAS、路由器等设备全局代理
- 企业网络流量管控
- 家庭网络科学上网
## Related Concepts
- [[科学上网]]:通过代理访问被封锁内容
- [[SOCKS5代理]]SOCKS 协议代理
- [[Clash]]:基于规则分流的代理客户端