首页 on 撷时录

撷时录

Fri, 02 Oct 2026 00:00:00 +0800

「撷时录」是笔记沉淀与作品展示合一的静态站点：主题 Hugo Solitude，内容仓与站点仓分离，产物发布到 GitHub Pages（gh-pages）。笔记走分类与标签；项目走独立卡片与详情页，本页即其中一篇。

权威源在内容仓。本地 push.sh 把 Notes / Projects 同步到站点仓分支 sync/content（先跑 Hugo 校验），站点 Actions 再合并进 main 并部署到 Pages。

项目集

同一展厅收录桌面工具、隔离执行、OJ、DDD 脚手架与轻量前端。卡片按 weight 排列；详情页写定位、特性与示意，不堆安装手册。

flowchart TB hub["撷时录 · 项目展厅"] desk["桌面"] infra["评测与隔离"] scaf["脚手架"] web["轻量 Web"] hub --> desk hub --> infra hub --> scaf hub --> web desk --> xuanjian["玄鉴"] desk --> m3u8["M3U8 Downloader"] desk --> resume["ResumeFloat"] infra --> acoj["ACOJ"] infra --> spark["SparkSandbox"] scaf --> voxel["Voxel 系列"] web --> startpage["Startpage"]

特性

笔记与实践：运维、框架、工具链、嵌入式与工程实践，分类 + 标签归档
项目展厅：独立 Markdown；仓库入口、演示地址、GitHub 仓库卡片
内容同步：push.sh → sync/content → merge → deploy；拷贝脚本为 sync_notes.py / sync_projects.py
主题定制：Solitude 上调整布局、项目网格与样式，保留主题升级路径
外链入口：简历等独立站点走导航与项目卡，不挤占笔记信息架构

技术栈

静态生成：Hugo
主题：Solitude
发布：sync/content 合并进 main → Actions → gh-pages
内容仓：jiangbyte/jiangbyte

M3U8 Downloader

Fri, 18 Sep 2026 00:00:00 +0800

M3U8 Downloader 是面向 HLS 的跨平台桌面下载器：解析 master / media playlist，并发拉取 TS 分片，ffmpeg -c copy remux 为 MP4。引擎在 Rust，界面 React，壳层 Tauri 2，覆盖 Windows、macOS、Linux。当前版本 0.1.1，MIT。

相对「脚本拼接分片」，清晰度选择、AES-128、代理与自定义请求、任务/分片控制、断点续传和边下边播放进同一任务模型。安装包见 Releases。

flowchart LR url["m3u8 URL"] parse["解析 playlist"] variant["选择变体"] pool["并发分片"] dec["AES-128"] hls["边下边播 HLS"] mp4["ffmpeg remux MP4"] url --> parse --> variant --> pool pool --> dec --> mp4 pool --> hls

特性

清单与变体：master playlist，下载前选择清晰度
加密分片：明文 HLS 与 #EXT-X-KEY AES-128-CBC
传输控制：Headers、Cookie、Referer、HTTP(S) 代理、并发度、输出路径
任务队列：暂停 / 继续 / 取消 / 删除；按已落盘分片续传
分片粒度：详情内单独开始、停止、重试；任务级操作中断在途请求
边下边播：本地 HLS 播放已连续分片；完成后打开 MP4
封装输出：ffmpeg remux；可选清理临时分片

技术栈

桌面壳：Tauri 2
下载引擎：Rust · Tokio · reqwest
界面：React 19 · TypeScript · Vite · Ant Design
封装：ffmpeg（打包 binaries）

SparkSandbox

Mon, 31 Aug 2026 00:00:00 +0800

SparkSandbox 是 Linux 上的隔离执行 HTTP 服务，不是对外 SDK。任意语言发 HTTP 完成编译与运行，HMAC 验签由调用方实现。响应含 stdout、stderr、资源用量与执行状态；支持多测例、checker、interactive pipeline、文件仓与 SSE。仓内 Python 仅供本仓测试。当前版本 0.1.1，MIT。

OJ、在线 IDE、作业评测把「跑用户代码」交给本服务；AC / WA 留在业务侧。ACOJ 判题执行即对接此服务。

flowchart TB client["OJ / IDE / 作业系统"] http["HTTP + HMAC"] orch["FastAPI 编排"] engine["C++20 sparksandbox"] iso["namespace / cgroup / seccomp"] client --> http --> orch --> engine --> iso

特性

双层实现：引擎负责隔离与状态分类；编排负责语言表、worker 池、CompileCache、FileStore、多测例并行
执行状态：succeeded、compile_failed、runtime_error、time_limit_exceeded、memory_limit_exceeded、output_limit_exceeded、security_violation、internal_error；stage 区分 compile / run
语言表：默认 C11、C++17、Python 3、Java 17、Go、Node.js；镜像另开 Rust 与 SQLite；YAML 可声明 SQL 客户端语言
评测形态：多测例、checker、interactive、文件仓、SSE
容器：toolchain base 与 server 分层；--privileged --cgroupns=host

flowchart LR compile["compile"] run["run"] ok["succeeded"] fail["compile_failed / runtime_error"] limit["TLE / MLE / OLE"] sec["security_violation"] compile --> run compile --> fail run --> ok run --> fail run --> limit run --> sec

技术栈

引擎：C++20 · namespaces · cgroup · seccomp
编排：Python 3.10+ · FastAPI
交付：Docker 双层镜像

Startpage

Sun, 06 Sep 2026 00:00:00 +0800

Startpage 是静态托管的个人书签导航起始页：无后端、无数据库，书签写在源码。url 必填，title / description 可手写覆盖；未手写则 Microlink 拉元数据，失败回退 hostname。在线：jiangbyte.github.io/startpage。

浏览器默认页 + 分类书签 + 多搜索引擎，不引入账号或同步服务。main 推送后 Actions 构建 dist/ 部署 Pages。

flowchart TB data["bookmarks.ts"] page["起始页"] meta["Microlink 元数据"] ico["站点 favicon"] cache["localStorage 缓存"] search["searchEngines Tab"] data --> page page --> meta --> cache page --> ico --> cache page --> search

特性

数据即代码：分类与条目在 src/data/bookmarks.ts；字符串简写等价于只填 url
元数据：双写 title / description 则不请求外部接口；缓存 2 小时硬过期，超过 1 小时后台刷新
图标：解析站点自身 favicon；失败用字母头像
搜索：searchEngines 切换后回车，新标签打开，查询词 %s 占位
发布：GitHub Actions → GitHub Pages

技术栈

构建：Vite
界面：React · TypeScript
托管：GitHub Pages

玄鉴

Wed, 02 Sep 2026 00:00:00 +0800

玄鉴（Xuanjian） 是面向运维与现场排查的 AI 桌面工作台：主机清单、本地 / SSH / WSL 终端、SFTP、脚本与笔记、会话录制、本机网络工具与 Docker 侧栏，并内置 玄鉴 Agent。LangGraph 本地编排，在独立下栏终端可观测执行，按 ReAct 完成排查与运维。数据落 SQLite，跨 Windows / macOS / Linux。当前版本 1.3.7，MIT，io.github.jiangbyte.xuanjian。

相对「终端 + 散落脚本」，机群、会话、文件、自动化与 Agent 收进同一应用；相对纯云端 Copilot，命令走本机 PTY / SSH，轨迹可回放。

flowchart TB hosts["主机操作台"] term["终端工作区"] agent["玄鉴 Agent"] pty["下栏 PTY"] hosts --> term term --> agent agent --> pty term --> sftp["SFTP"] term --> docker["Docker"] term --> scripts["脚本"] term --> net["网络工具"]

特性

主机操作台：分组、标签、排序；口令 AES；一键 SSH 或粘贴 user@host
终端工作区：本地 Shell 与 SSH（xterm）；多标签 keep-alive；左侧文件 / 脚本 / 历史 / 概览 / 进程 / 端口 / Docker；右侧 Agent 与笔记
玄鉴 Agent：Orchestrator + SubAgent（巡检 / 终端 / 部署 / 分析）；计划 / 确认 / 完全权限；MCP 动态合并；上下文压缩与用量计量
下栏终端：与主终端分离的独立 PTY；terminal_run / session_exec 输出可见
模型：自定义供应商；OpenAI 兼容与 Anthropic Messages；思考强度与上下文窗口可配
SFTP：双栏浏览、上传下载、冲突处理、内联编辑
Docker：容器、镜像、网络与卷；实时日志；Agent docker_* 工具
脚本与笔记：脚本包、变量占位、多目标执行；Markdown 分类自动保存
会话日志：I/O 录制、筛选、回放、导出
网络工具：Ping / 路由 / DNS、IP 计算、端口、HTTP / TLS、测速、连接与流量
自动化：批量脚本、Cron、告警、机群概览、审计控制台
数据安全：SQLite；工作空间同步与 deploy 配方；备份导出（可选 AES）

flowchart LR user["运维输入"] lg["LangGraph"] llm["OpenAI / Anthropic"] tools["MCP / 本机工具"] host["PTY / SSH"] user --> lg lg --> llm lg --> tools --> host

技术栈

桌面壳：Tauri 2 · SQLite / Dialog / Clipboard
界面：React 19 · TypeScript · Vite · Tailwind CSS · shadcn/ui · Zustand
终端与编辑：xterm.js · Monaco · Markdown · XYFlow · Recharts / ECharts
Agent：LangGraph（agent-core）· Tauri 适配层（agent-adapters）· MCP
会话与网络：Rust · Tokio · russh / russh-sftp · portable-pty · aes-gcm

ResumeFloat

Fri, 18 Sep 2026 00:00:00 +0800

ResumeFloat 是跨平台置顶悬浮简历速拷工具：默认 Compact 为「标签 + 一键复制」，可切入编辑。条目由可组合块构成（纯文本 / Markdown / 富文本 / 图片），数据落 SQLite，支持整库导出导入。当前版本 0.1.1，MIT。

面试、网申、即时通讯反复粘贴自我介绍、项目要点、联系方式时，置顶窗口减少在文档与聊天之间切换。v* 标签触发 Actions 构建三端安装包，见 Releases。

flowchart LR db["SQLite items / blocks"] compact["Compact 列表"] clip["剪贴板"] edit["块编辑"] db --> compact --> clip db --> edit --> db

特性

置顶悬浮：无边框 always-on-top，标题栏拖拽；钉住与下拉菜单
Compact 速拷：标签 + 预览（超长省略）；按块顺序拼装剪贴板
主题：深色 / 浅色，本地记住
块编辑：增删条目；块类型动态添加、排序、删除
内容类型：纯文本 · Markdown（编辑 / 预览）· 富文本（TipTap）· 图片
持久化：items / blocks；图片在配置目录 assets/
导出 / 导入：resume.db + assets/；导入前确认覆盖

flowchart TB item["简历条目"] t["纯文本"] md["Markdown"] rich["富文本"] img["图片"] item --> t item --> md item --> rich item --> img

技术栈

桌面壳：Tauri 2
界面：React 19 · TypeScript · Vite · Ant Design
内容：TipTap · react-markdown · marked
存储：@tauri-apps/plugin-sql · clipboard-manager · dialog · fs

Voxel

Thu, 01 Oct 2026 00:00:00 +0800

Voxel 是一组按同一领域分层重建的全栈脚手架系列：Portal 与 Admin 独立后端、独立前端，目录、坐标与包名统一为 voxel-* / io.github.jiangbyte.voxel。后端对齐 Java（Spring Boot）、Python（FastAPI）、Go（Gin）；前端对齐 Vue 3 管理端、React 门户与 uni-app。另有七层纯骨架与带账户竖切的充实模板，供对照学习，不作业务拷贝范本。协议 Apache License 2.0。

相对「一份单体里切 admin/portal」，端隔离：Admin 只挂管理 API，Portal 只挂门户 API，前端互不引用对方源码。相对单语言脚手架，同一七层在三种运行时对齐。

flowchart TB subgraph fronts ["前端"] vue["voxel-admin Vue3"] react["voxel-portal React"] uniA["admin-uniapp"] uniP["portal-uniapp"] end subgraph backends ["后端 · Admin / Portal"] ja["Java 8000 / 8001"] py["FastAPI 8100 / 8101"] go["Gin 8200 / 8201"] end subgraph tpls ["模板"] skel["ddd-lite-strcut"] lite["ddd-lite"] end vue --> ja react --> ja uniA --> ja uniP --> ja vue --> py react --> py vue --> go react --> go lite -.-> ja skel -.-> lite

特性

端分离：Admin / Portal 各仓各端口
DDD 七层：types · api · domain · infrastructure · case/cases · trigger · app
依赖方向：Trigger → API → Case → Domain ← Infrastructure
Java：Maven 多模块 {project}-types … -app
FastAPI：仓库根扁平包，无 src/ 包装层
Gin：internal/{types,api,domain,infrastructure,cases,trigger} + cmd/app
Web / 移动：Vue 3、React 19、uni-app 双端
模板仓：骨架默认注释中间件；充实模板含账户竖切，S3 / Milvus / Spring AI / MCP 注释接入（原 voxel-ddd-ai-lite 已合并）

flowchart TB trigger["trigger"] api["api"] cases["case"] domain["domain"] infra["infrastructure"] types["types"] app["app"] trigger --> api --> cases --> domain infra --> domain app --> trigger app --> infra types -.-> trigger

技术栈

后端：JDK 21 · Python 3.11+ · Go 1.25+
前端：Vue 3 · React 19 · uni-app
协议：OpenAPI / Apifox（docs/api/openapi）

系列仓库

后端

ACOJ

Mon, 31 Aug 2026 00:00:00 +0800

ACOJ 是在线评测（OJ）monorepo：在 HEI 脚手架上扩展题库、提交判题与多执行机调度，提供 Admin（Vue 3）、Portal（React 19）与统一 Spring Boot API。判题执行依赖 SparkSandbox：沙箱只编译与限资源运行，AC / WA 在 ACOJ 裁决。Apache License 2.0。

相对「沙箱内直接出最终结果」的一体化 OJ，隔离执行与题目语义拆开：执行机加权调度、熔断、排水、租约换机；平台保留测例版本、标签、发布校验与做题统计。modules/oj 叠在脚手架之上，而不是从零拼一套账号与存储。

flowchart LR portal["Portal"] admin["Admin"] api["Spring Boot API"] mq["RabbitMQ"] sched["调度 / 熔断 / 换机"] spark["SparkSandbox"] portal --> api admin --> api api --> mq --> sched --> spark spark -->|"stdout / 状态"| api api -->|"AC / WA"| portal

特性

双端账号：ADMIN / PORTAL 独立会话（Sa-Token）；密码 RSA、验证码、失败锁定与限流；JustAuth（可配置）
RBAC：账号 / 角色 / 部门 / 用户组 / 岗位；菜单、按钮与 API 授权；会话踢出
系统管理：字典、动态配置（敏感项加密）、Banner、公告、反馈、弱口令库
对象存储：S3 兼容（MinIO / RustFS / OSS），直链或预签名
运维：审计与告警、登录日志、运营工作台、sys_job / Lock4j
题库：CRUD、测例 INLINE / OBJECT、标签、参考答案、试跑与发布校验
提交与判题：多语言入队；RabbitMQ；加权调度、熔断 / 排水 / 租约换机；业务侧裁决
判题节点：oj_judge_node 登记沙箱；心跳探活；oj_judge_dispatch 派发审计
个人中心：公开资料、安全设置、实名认证；做题统计

API 前缀 /api/v1/admin/* 与 /api/v1/portal/*。子工程：admin · portal · server。

Debian 13 友基 XP-Pen 数位板官方驱动与内核冲突排查固化

Wed, 07 Oct 2026 00:00:00 +0800

环境

采集时间：2026-10-07。主机名 dev。

项	值	依据
系统	Debian GNU/Linux 13 (trixie)，`DEBIAN_VERSION_FULL=13.7`	`/etc/os-release`
内核	`6.12.111+deb13-amd64`	`uname -r`
机型	HP ProBook 450 15.6 inch G9 Notebook PC	`/sys/class/dmi/id/product_name`
会话	`XDG_SESSION_TYPE=x11`，`DISPLAY=:0`，`XDG_CURRENT_DESKTOP=GNOME`，`GDMSESSION=gnome-xorg`	环境变量
数位板 USB	`Bus 003 Device 022: ID 28bd:0905 XP-Pen 10 inch PenTablet`	`lsusb`
sysfs	`/sys/bus/usb/devices/3-4`，`manufacturer=UGTABLET`，`product=10 inch PenTablet`	sysfs
驱动包	`ugeetablet 4.3`（`Maintainer: tech@xp-pen.com`）	`dpkg -l` / `apt-cache show`
安装包文件	`/home/charlie/Downloads/ugeeTablet4.3.5-241031.deb`（约 22MB，mtime 2026-10-07 19:36）	`ls`
驱动路径	`/usr/lib/ugeeTablet/{ugeeTabletDriver,ugeeTablet,ugeeTabletDriver.sh}`	文件系统
驱动配置目录	`~/.config/Hanvon Ugee/ugee.conf`（仅 LocalSocket 时间戳）	文件系统
相关已装包	`xserver-xorg-input-wacom 1.2.3-1`，`libwacom9`，`libwacom-common`	`dpkg -l`
其它输入设备（配置未改）	内置键盘 `AT Translated Set 2 keyboard`；`Newmen ... 2.4G Keyboard Mouse`；`SEMICO USB Gaming Keyboard`；触控板 `SYNA30E5:00 06CB:CEAC`	`/sys/class/input/*/name`

驱动 journal（2026-10-07 19:39:11）中的设备标识：

ACOJ在线评测平台-架构风格论文

Tue, 06 Oct 2026 00:00:00 +0800

摘要

2025 年 6 月至 2026 年 6 月，我参与了校园在线评测平台的研发。该项目的目标是建立一个面向教学与竞赛的在线训练系统，该平台旨在完成题目发布、程序提交与自动评测，为学生和教师提供练习、批改与运营管理等服务。我在该项目中担任系统架构师，全程参与了系统的分析规划和设计工作。本文以该项目为例，详细探讨软件架构风格在软件系统架构中的应用及其实现。

在构建该评测平台时，我们采用了分层组合的架构模式，执行层能够解释并运行用户程序，确保多种语言在统一规则下安全评测；而消息层则对评测任务进行异步分发，提供了低耦合的构件协作能力。这两层结构相互补充，使得平台既能满足高峰提交，又能进行在线维护与扩展。通过解释器对评测协议进行适配，结合消息中间件进行任务调度，我们成功打造了一个稳定可用的在线评测系统。通过这一实践，我们进一步验证了软件架构风格在现代软件系统架构中的重要性和实用性。

在我的带领下，项目实施的非常顺利，于 2026 年 6 月成功上线运行，并获得业主单位的一致好评。

正文

随着程序设计教学规模扩大和集中训练日益频繁，原有手工收作业、本机批改的方式已难以支撑并发提交和安全隔离。公司自 2025 年 3 月起开展需求调研，规划建设一套可扩展的在线评测平台。

2025 年 6 月我司受托建设本项目。本项目面向校园内网部署，我在项目中担任系统架构师职务，主要负责系统整体架构设计，该系统主要完成题目管理、程序提交、自动评测和运营维护，主要功能模块包括账号权限、题库管理、提交评测、执行调度、文件存储以及通知公告等。

在架构工作开始阶段，我们便意识到，架构风格是一组设计原则，是能够提供抽象框架模式，可以为我们的项目提供通用解决方案的，这种能够极大提高软件设计的重用的方法加快我们的建设进程，因此在我司总工程师的建议下，我们使用了解释器风格、独立构件隐式调用风格以及 B/S 风格这三种较常用风格。虚拟机风格中的解释器能够把多样的程序执行过程抽象为统一语义，这类风格非常适用于输入形式多、评测规则相对稳定的场景。独立构件风格包括显式调用与隐式调用，我们为了降低提交入口与评测执行之间的耦合采用了隐式调用，通过消息中间件控制系统间信息交互，不仅能削峰填谷，而且还提高了执行节点扩容和故障隔离的能力。B/S 是基于浏览器与服务器的软件架构，它主要使用超文本传输协议进行通信和交互，简化客户端分发的工作，最终减低了机房批量升级的难度，以下正文将重点描述架构风格的实施过程和效果。

底层架构我们使用解释器风格来满足多语言安全评测需求。解释器风格是虚拟机风格中的一种，具备良好的灵活性，在本项目中我们的架构设计需要兼容多种程序设计语言，一般来说这种软件编写难度非常高，代码维护难度压力也很大，因此这个解释器的设计任务便很明确了，软件设计需要高度抽象、协议的适配由配置文件来承担。具体的做法如下，我们对一次评测过程进行了高度抽象，由于一次评测由很多测试用例组成，每个测试用例容量固定并且标识和数据有明确规定，因此我们将题目中的语言限额和测试用例进行关系建模，将整体题目作为一个根节点，以测试用例作为根节点下的叶子节点，使用结构化配置映射成了题目、限额、用例这三层的数据结构，核心的代码采用模板解析与动态装载生成可执行对象，搭建一套可以基于可变模板的解释器，协议模板的产生可以由语言运行时说明和题目配置进行转换得到，解释器支持协议模板热部署，这种可以将用户程序和测试数据映射成统一的评测对象，将语言差异和数据协议的复杂度简化，后期评测规则更改不会对软件产生影响，仅仅更改协议模板文件即可，最终我们使用了若干份协议描述文件便兼容了这些复杂的语言与用例组合，规避了在业务系统中直接执行用户程序带来的技术风险。

中间层我们使用独立构件风格中的隐式调用来简化构件间的交互复杂度，降低系统耦合度。主要的实现手段是，我们采用了一个开源的消息中间件作为连接构件，这个构件是成熟的消息服务器，其性能和稳定性久经考验。由上文提到的解释器所需的对象化任务经过消息总线分发到各个订阅此消息的应用系统，这些应用系统包括提交服务、评测服务、重试服务等，这种多 web 应用的情况非常适合采用消息发布与消息订阅的机制，能够有效解决耦合问题，我们在编码的过程中发现只要采用这种风格的 web 应用，整个迭代过程效率极高，错误率降低，而且我们使用的配置化消息框架，消息队列的管理完全基于配置，清晰简单，维护性良好，例如评测任务主题、延迟重试主题、异常死信主题等消息队列分类清晰，可以随时修改其结构也能够随时增加其他主题的消息队列，不同的 web 系统监听的队列也可以随时变换组合，基于消息中间件的架构设计能够让系统的构件化思路得到良好实施，总体来说这种架构风格带来了非常清晰的数据流转架构，简化了编码难度，减低本项目的二次开发的难度。

应用系统层我们主要采用 B/S 的架构风格，主要用于解决终端分散、难以统一升级的问题。校园应用有一个明显的特点，机房、办公室和竞赛场地分布在不同楼宇，路途很远，且都是内网通讯，部分场所也是走的受控网络，一般是无法远程支持的，这给我们的系统推广以及后期维护带来了很大难题，我们可以想象如果使用 C/S 架构，更新客户端一旦遇到问题很可能需要运维把各机房跑一遍。这让我们在系统推广和维护方面面临较大压力。我们采用的 B/S 架构风格能够解决这个难题，并充分考量了现在相关技术的成熟度，例如现在的浏览器完全能够实现以前客户端的功能，项目中我们使用了大量的动态页面与脚本技术，能够满足在线编辑、结果查询和后台管理等需求。这种风格中页面和逻辑处理存储在 web 服务器上，维护和软件升级只要更新服务器端即可，及时生效，用户体验较好，例如界面上需要优化，改一下页面或者样式文件就可以马上看到效果了。

项目于 2026 年 6 月完成验收，这半年内共经历了三次大批量集中提交，这几次接入过程平稳顺利，其中协议解释器软件性能没有出现过问题，消息中间件的性能经过多次调优吞吐量也接近了磁盘与网络的承载上限，满足当前的消息交互总量，另外由于我们的项目多次在紧急状态下能够快速适应评测规则变动，得到过业主的邮件表扬。除了业主机房几次突发性的网络故障外，项目至今还未有重大的生产事故，项目组现在留 2 个开发人员和 1 个售后在维护，系统的维护量是可控的，系统运行也比较稳定。

不足之处有两个方面，第一在架构设计的过程中我们忽略了部分机房终端的兼容性，个别终端因为需要兼容老的应用软件不允许系统升级，这些终端系统老旧，其浏览器不支持现有页面技术，导致了系统推广障碍。第二在高可用方面还有待改善。针对第一种问题，我们通过沟通协商说服业主新购 PC，采用两台机器同时使用方式解决。针对第二种问题我方采用了多节点互备和服务接管等策略，在一台服务暂停的情况下，另外一台服务接管，以增加可用性。

第二章计算机系统基础知识

Tue, 06 Oct 2026 00:00:00 +0800

计算机系统概述

计算机系统 = 硬件 + 软件

graph TD Root["计算机系统"] %% 硬件分支 Root --> HW["硬件"] HW --> CPU["中央处理器"] CPU --> ALU["运算单元"] CPU --> CU["控制单元"] HW --> Mem["存储器"] Mem --> MainMem["主存(内存)"] Mem --> ExtMem["外存"] HW --> InDev["输入设备"] InDev --> Keyboard["键盘"] InDev --> Mouse["鼠标"] InDev --> InOther["..."] HW --> OutDev["输出设备"] OutDev --> Monitor["显示器"] OutDev --> OutOther["..."] %% 软件分支 Root --> SW["软件"] SW --> SysSW["系统软件"] SysSW --> OS["操作系统"] SysSW --> Compiler["编译工具"] SysSW --> SysOther["..."] SW --> AppSW["应用软件"] AppSW --> Office["办公软件"] AppSW --> Entertainment["娱乐软件"] AppSW --> AppOther["..."]

系统分类维度：

第三章信息系统基础知识

Tue, 06 Oct 2026 00:00:00 +0800

待定

论文

Tue, 06 Oct 2026 00:00:00 +0800

用法：先定题目方向（架构风格、高可用、安全、性能、质量属性等），再填入同一项目。摘要三段、正文“背景—职责—总述三点—分点展开—验收—不足”，三点之间换方向只换论点，不换结构。【】内为必填，不要写具体表名、接口路径、框架版本。

摘要

【项目起止时间】，我参与了【项目名称】的研发。该项目的目标是建立一个【系统定位】，该平台旨在【核心功能】，为【业务对象】提供【业务目标】等服务。我在该项目中担任【角色】，全程参与了系统的分析规划和设计工作。本文以该项目为例，详细探讨【论文主题，如软件架构风格 / 高可用性设计 / 信息安全体系】在软件系统架构中的应用及其实现。

在构建【系统名称】时，我们采用了【总体方案，如分层组合 / 主备加集群 / 纵深防御】，【要点A】能够【作用A】，确保【价值A】；而【要点B】则对【对象B】进行【作用B】，提供了【价值B】。这两层结构相互补充，使得平台既能满足【需求A】，又能进行【需求B】。通过【手段A】进行【处理A】，结合【手段B】进行【处理B】，我们成功打造了一个【系统特性】的【系统类型】。通过这一实践，我们进一步验证了【论文主题】在现代软件系统架构中的重要性和实用性。

在我的带领下，项目实施的非常顺利，于【上线时间】成功上线运行，并获得【评价主体】的一致好评。

正文

随着【行业趋势或业务矛盾】，原有【旧做法】已难以支撑【新约束，如并发、安全、扩展】。公司自【年】年【月】月起【调研 / 立项准备】，规划【建设目标】。

【年】年【月】月我司受托建设本项目。本项目【部署与范围一句话】，我在项目中担任系统架构师职务，主要负责系统整体架构设计，该系统主要完成【业务能力】，主要功能模块包括【模块一】、【模块二】、【模块三】、【模块四】以及【模块五】等。

在架构工作开始阶段，我们便意识到，【论文主题对应的方法，如架构风格 / 质量属性策略】是一组设计原则，是能够提供抽象框架模式，可以为我们的项目提供通用解决方案的，这种能够极大提高软件设计的重用的方法加快我们的建设进程，因此在我司总工程师的建议下，我们使用了【论点一】、【论点二】以及【论点三】这三种较常用【风格 / 策略 / 措施】。【类别一】中的【论点一】能够【能力一】，这类方法非常适用于【适用场景】。【类别二】包括【子类A】与【子类B】，我们为了【设计目标】采用了【论点二】，通过【关键机制】控制系统间信息交互，不仅能【收益一】，而且还提高【收益二】。【论点三】是基于【基本形态】的软件架构，它主要使用【通信方式】进行通信和交互，简化【被简化的工作】，最终减低了【被降低的难度】，以下正文将重点描述【论文主题】的实施过程和效果。

底层（或第一方面）我们使用【论点一】来满足【需求一】。【论点一】是【所属类别】中的一种，具备【主要优点】，在本项目中我们的架构设计需要兼容【多变部分】，一般来说这种软件编写难度非常高，代码维护难度压力也很大，因此这个设计任务便很明确了，软件设计需要高度抽象、【变化点】的适配由配置来承担。具体的做法如下，我们对【核心对象】进行了高度抽象，由于【核心对象】由很多【组成单元】组成，每个【组成单元】容量固定并且标识和数据有明确规定，因此我们将【主体】中的【属性甲】和【属性乙】进行关系建模，将整体【主体】作为一个根节点，以【组成单元】作为根节点下的叶子节点，使用结构化配置映射成了【层次名称】这【层数】层的数据结构，核心的处理采用【解析 / 装载 / 调度】生成统一对象，搭建一套可以基于可变模板（或策略）的实现，模板或策略可由【来源】转换得到，并支持热更新。这种可以将【复杂输入】映射成统一对象的做法，将【差异点】的复杂度简化，后期规则更改不会对软件产生影响，仅仅更改配置即可，最终我们使用了若干份描述文件便兼容了这些复杂的【差异组合】，规避了【直接硬编码或危险做法】带来的技术风险。

中间层（或第二方面）我们使用【论点二】来简化【协作对象】间的交互复杂度，降低系统耦合度（或提升【目标质量属性】）。主要的实现手段是，我们采用了【中间件或机制】作为连接构件，这个构件【一句话定位】，其性能和稳定性久经考验。由上文处理得到的对象化数据经过【通道】分发到各个【订阅方 / 协作方】，这些应用系统包括【系统甲】、【系统乙】、【系统丙】等，这种多应用协作的情况非常适合采用【发布订阅 / 异步解耦 / 其他机制】，能够有效解决耦合问题，我们在编码的过程中发现只要采用这种方法，整个迭代过程效率极高，错误率降低，而且我们使用的配置化方式，管理完全基于配置，清晰简单，维护性良好，例如【通道甲】、【通道乙】、【通道丙】等分类清晰，可以随时修改其结构也能够随时增加其他通道，不同系统监听的范围也可以随时变换组合。总体来说这种方法带来了非常清晰的数据流转架构，简化了编码难度，减低本项目的二次开发的难度。

应用系统层（或第三方面）我们主要采用【论点三】，主要用于解决【推广或使用上的难题】。【业务场景】有一个明显的特点，【使用方】分布在【地理或组织范围】，路途很远，且都是【网络条件】，【部分场所】也是走的【受控网络】，一般是无法远程支持的，这给我们的系统推广以及后期维护带来了很大难题，我们可以想象如果使用【被否定的方案】，更新一旦遇到问题很可能需要【运维代价】。这让我们在系统推广和维护方面面临较大压力。我们采用的【论点三】能够解决这个难题，并充分考量了现在相关技术的成熟度，例如现在的【成熟技术】完全能够实现以前【旧方案】的功能，项目中我们使用了大量的【技术甲】与【技术乙】，能够满足【交互需求】等需求。这种做法中【变更集中位置】在服务器侧，维护和软件升级只要更新服务器端即可，及时生效，用户体验较好，例如界面或规则上需要优化，改一下【页面 / 配置 / 策略】就可以马上看到效果了。

项目于【年】年【月】月完成验收，这【时长】内共经历了【若干次业务高峰或变更】，这几次过程平稳顺利，其中【论点一对应部件】性能没有出现过问题，【论点二对应部件】经过多次调优也满足当前的交互总量，另外由于我们的项目多次在紧急状态下能够快速适应【规则或接口变动】，得到过业主的邮件表扬。除了业主侧几次突发性的网络故障外，项目至今还未有重大的生产事故，项目组现在留【n】个开发人员和【m】个售后在维护，系统的维护量是可控的，系统运行也比较稳定。

不足之处有两个方面，第一在架构设计的过程中我们忽略了【兼容性或范围遗漏】，个别【终端 / 子系统】因为需要兼容老的应用软件不允许系统升级，这些【对象】系统老旧，其【运行环境】不支持【新能力】，导致了系统推广障碍。第二在【高可用 / 性能 / 安全等另一质量属性】方面还有待改善。针对第一种问题，我们通过沟通协商说服业主【更换或隔离旧环境】，采用【过渡方案，如两套环境并存】方式解决。针对第二种问题我方采用了【措施甲】和【措施乙】等策略，在一台服务暂停的情况下，另外一台服务接管，以增加可用性。

第一章绪论

Mon, 05 Oct 2026 00:00:00 +0800

系统架构概述

诺依曼系统计算机

计算机硬件
计算机软件

系统架构定义

定义：IEEE 1471-2000 标准

架构是体现在组件中的一个系统的基本组织、它们彼此的关系与环境的关系及指导它的设计和发展的原则。

架构设计的作用：

解决相对复杂的需求分析问题
解决非功能属性在系统中占据重要位置的设计问题
解决生命周期长、扩展性需求高的系统整体结构问题
解决系统基于组件需要的集成问题
解决业务流程再造难的问题

软件架构发展历程

timeline title 软件架构发展历程 1968 : NATO 会议提出“软件架构” 1991 : Windton W.Royce、Waiker Royce 首次定义软件架构 1992 : Perry & Wolf 创造性阐述 {elements, forms, rationale} = software 1996 : 理论体系完善与发展阶段开始 1999 : 第一届 IFIP 软件架构会议 2000 : IEEE 1471-2000 标准发布，标志首次形式化定义

timeline title 软件架构发展 1968—1994 基础研究 : NATO 会议提出术语 : 模块化六大原则出现 : MIS 系统分层思想 1996—2000 概念体系和核心技术形成阶段 : 首次定义软件架构 : SAAM 实践方法体系 : IEEE 1471-2000 标准发布 1996—至今理论体系完善与发展阶段开始 : 软件架构描述语言（C2SADL, Wright, ACME, UniCon, Rapide） : 分析方法（SAAM, ATAM, CBAM, SBAR, ALPSM, SAEM） 2000—至今普及应用 : 软件架构描述语言 ADML（XML） : IFIP 会议、IFIP 工作组成立

模块化开发六大原则

最高模块内聚。也就是在一个模块内部的元素最大限度地关联，只实现一种功能的模块是高内聚的，具有三种以上功能的模块则是低内聚的。
最低耦合。也就是不同模块之间的关系尽可能弱，以利于软件的升级和扩展。
模块大小适度。颗粒过大会造成模块内部维护困难，而颗粒过小又会导致模块间的耦合增加。
模块调用链的深度（嵌套层次）不可过多。
接口简单、精炼（扇入扇出数不宜太大），具有信息隐蔽能力。
尽可能地复用已有模块

软件架构常用分类

分层架构

四层结构：表现层、业务层、持久层、数据库层
最常见的软件架构，事实标准架构；用户的请求将依次通过这四层的处理，不能跳过其中任何一层

Typora 自定义 github-cus 主题：掘金行内代码与标题自动编号

Sun, 04 Oct 2026 00:00:00 +0800

Typora 自带主题升级会覆盖，直接改 github.css 不稳妥。做法是复制一份自定义主题 github-cus，在上面改行内代码颜色，以及正文 / 大纲的标题自动编号。

本文环境：Linux，主题目录 ~/.config/Typora/themes/（Windows 一般在 %APPDATA%\Typora\themes\，macOS 在 ~/Library/Application Support/abnerworks.Typora/themes/）。

为什么要复制一份主题

主题目录里的 Readme.md 写得很清楚：内置 CSS 更新或重装后会被替换，不要直接改内置主题。

正确姿势见官方文档：

目标文件结构：

1~/.config/Typora/themes/
2├── github.css              ← 内置，不动
3├── github/                 ← 内置字体，不动
4├── github-cus.css          ← 自定义主题入口
5└── github-cus/             ← 字体资源（从 github/ 复制）

~/.config/Typora/themes/
├── github.css              ← 内置，不动
├── github/                 ← 内置字体，不动
├── github-cus.css          ← 自定义主题入口
└── github-cus/             ← 字体资源（从 github/ 复制）

Typora 主题名取自 CSS 文件名：github-cus.css → 主题选择器里一般显示为 Github Cus。

Docker 本机基础设施执行命令

Sat, 03 Oct 2026 00:00:00 +0800

拉取镜像

 1# ===== MySQL 9.7.2 =====
 2docker pull docker.xuanyuan.run/library/mysql:9.7.2; docker tag docker.xuanyuan.run/library/mysql:9.7.2 library/mysql:9.7.2; docker rmi docker.xuanyuan.run/library/mysql:9.7.2
 3
 4# ===== Redis 8.8.2 =====
 5docker pull docker.xuanyuan.run/library/redis:8.8.2; docker tag docker.xuanyuan.run/library/redis:8.8.2 library/redis:8.8.2; docker rmi docker.xuanyuan.run/library/redis:8.8.2
 6
 7# ===== Silo (MinIO 变体) =====
 8docker pull docker.xuanyuan.run/pgsty/silo:RELEASE.2026-08-06T00-00-00Z; docker tag docker.xuanyuan.run/pgsty/silo:RELEASE.2026-08-06T00-00-00Z pgsty/silo:RELEASE.2026-08-06T00-00-00Z; docker rmi docker.xuanyuan.run/pgsty/silo:RELEASE.2026-08-06T00-00-00Z
 9
10# ===== RabbitMQ 4.2.9-management =====
11docker pull docker.xuanyuan.run/library/rabbitmq:4.2.9-management; docker tag docker.xuanyuan.run/library/rabbitmq:4.2.9-management library/rabbitmq:4.2.9-management; docker rmi docker.xuanyuan.run/library/rabbitmq:4.2.9-management
12
13# ===== Ollama 0.33.1 =====
14docker pull docker.xuanyuan.run/ollama/ollama:0.33.1; docker tag docker.xuanyuan.run/ollama/ollama:0.33.1 ollama/ollama:0.33.1; docker rmi docker.xuanyuan.run/ollama/ollama:0.33.1
15
16
17docker pull pgexh7a70kca8kgghn-quay.xuanyuan.run/coreos/etcd:v3.6.12; docker tag pgexh7a70kca8kgghn-quay.xuanyuan.run/coreos/etcd:v3.6.12 quay.io/coreos/etcd:v3.6.12; docker rmi pgexh7a70kca8kgghn-quay.xuanyuan.run/coreos/etcd:v3.6.12
18
19
20docker pull docker.xuanyuan.run/zilliz/attu:v3.0.0; docker tag docker.xuanyuan.run/zilliz/attu:v3.0.0 zilliz/attu:v3.0.0; docker rmi docker.xuanyuan.run/zilliz/attu:v3.0.0

# ===== MySQL 9.7.2 =====
docker pull docker.xuanyuan.run/library/mysql:9.7.2; docker tag docker.xuanyuan.run/library/mysql:9.7.2 library/mysql:9.7.2; docker rmi docker.xuanyuan.run/library/mysql:9.7.2

# ===== Redis 8.8.2 =====
docker pull docker.xuanyuan.run/library/redis:8.8.2; docker tag docker.xuanyuan.run/library/redis:8.8.2 library/redis:8.8.2; docker rmi docker.xuanyuan.run/library/redis:8.8.2

# ===== Silo (MinIO 变体) =====
docker pull docker.xuanyuan.run/pgsty/silo:RELEASE.2026-08-06T00-00-00Z; docker tag docker.xuanyuan.run/pgsty/silo:RELEASE.2026-08-06T00-00-00Z pgsty/silo:RELEASE.2026-08-06T00-00-00Z; docker rmi docker.xuanyuan.run/pgsty/silo:RELEASE.2026-08-06T00-00-00Z

# ===== RabbitMQ 4.2.9-management =====
docker pull docker.xuanyuan.run/library/rabbitmq:4.2.9-management; docker tag docker.xuanyuan.run/library/rabbitmq:4.2.9-management library/rabbitmq:4.2.9-management; docker rmi docker.xuanyuan.run/library/rabbitmq:4.2.9-management

# ===== Ollama 0.33.1 =====
docker pull docker.xuanyuan.run/ollama/ollama:0.33.1; docker tag docker.xuanyuan.run/ollama/ollama:0.33.1 ollama/ollama:0.33.1; docker rmi docker.xuanyuan.run/ollama/ollama:0.33.1


docker pull pgexh7a70kca8kgghn-quay.xuanyuan.run/coreos/etcd:v3.6.12; docker tag pgexh7a70kca8kgghn-quay.xuanyuan.run/coreos/etcd:v3.6.12 quay.io/coreos/etcd:v3.6.12; docker rmi pgexh7a70kca8kgghn-quay.xuanyuan.run/coreos/etcd:v3.6.12


docker pull docker.xuanyuan.run/zilliz/attu:v3.0.0; docker tag docker.xuanyuan.run/zilliz/attu:v3.0.0 zilliz/attu:v3.0.0; docker rmi docker.xuanyuan.run/zilliz/attu:v3.0.0

运行命令

  1# ===== MySQL 9.7.2（开机自启）=====
  2docker run -d --name mysql \
  3  -p 3306:3306 \
  4  -e MYSQL_ROOT_PASSWORD='infra123!' \
  5  -v /home/charlie/Workspace/datas/mysql:/var/lib/mysql \
  6  --restart unless-stopped \
  7  mysql:9.7.2
  8
  9# ===== Redis 8.8.2（开机自启 + AOF）=====
 10docker run -d --name redis \
 11  -p 6379:6379 \
 12  -e REDIS_PASSWORD='infra123!' \
 13  -v /home/charlie/Workspace/datas/redis:/data \
 14  --restart unless-stopped \
 15  redis:8.8.2 \
 16  --requirepass "infra123!" --appendonly yes
 17
 18
 19# ===== MySQL 9.7.2（开机不自启）=====
 20docker run -d --name mysql \
 21  -p 3306:3306 \
 22  -e MYSQL_ROOT_PASSWORD='infra123!' \
 23  -v /home/charlie/Workspace/datas/mysql:/var/lib/mysql \
 24  --restart no \
 25  mysql:9.7.2
 26
 27# ===== Redis 8.8.2（开机不自启 + AOF）=====
 28docker run -d --name redis \
 29  -p 6379:6379 \
 30  -e REDIS_PASSWORD='infra123!' \
 31  -v /home/charlie/Workspace/datas/redis:/data \
 32  --restart no \
 33  redis:8.8.2 \
 34  --requirepass "infra123!" --appendonly yes
 35
 36
 37# ===== Silo (MinIO 变体) =====
 38docker run -d --name silo \
 39  -p 9000:9000 -p 9001:9001 \
 40  -e MINIO_ROOT_USER=admin \
 41  -e MINIO_ROOT_PASSWORD='infra123!' \
 42  -v silo_data:/data \
 43  --restart unless-stopped \
 44  pgsty/silo:RELEASE.2026-08-06T00-00-00Z \
 45  server /data --console-address ":9001"
 46  
 47  
 48# ===== Silo（默认不自启）=====
 49docker run -d --name silo \
 50  -p 9000:9000 -p 9001:9001 \
 51  -e MINIO_ROOT_USER=admin \
 52  -e MINIO_ROOT_PASSWORD='infra123!' \
 53  -v /home/charlie/Workspace/datas/silo:/data \
 54  --restart no \
 55  pgsty/silo:RELEASE.2026-08-06T00-00-00Z \
 56  server /data --console-address ":9001"
 57
 58# ===== RabbitMQ 4.2.9-management =====
 59docker run -d --name rabbitmq \
 60  -p 5672:5672 \
 61  -p 15672:15672 \
 62  -e RABBITMQ_DEFAULT_USER=admin \
 63  -e RABBITMQ_DEFAULT_PASS='infra123!' \
 64  -v rabbitmq_data:/var/lib/rabbitmq \
 65  --restart no \
 66  rabbitmq:4.2.9-management
 67
 68# ===== Ollama 0.33.1 =====
 69docker run -d --name ollama \
 70  -p 11434:11434 \
 71  -v ollama_data:/root/.ollama \
 72  --restart unless-stopped \
 73  ollama/ollama:0.33.1
 74
 75# ===== Ollama 0.33.1 =====
 76docker run -d --name ollama \
 77  -p 11434:11434 \
 78  -v ollama_data:/root/.ollama \
 79  --restart no \
 80  ollama/ollama:0.33.1
 81  
 82# ===== Draw.io 31.4.1 =====
 83docker run -d --name draw \
 84  -p 18080:8080 \
 85  --restart unless-stopped \
 86  jgraph/drawio:31.4.1
 87  
 88docker run -d --name drawio \
 89  -p 18080:8080 \
 90  --restart no \
 91  jgraph/drawio:31.4.2
 92  
 93# ===== Nacos 2.5.0 =====
 94docker run -d --name nacos \
 95  -p 8848:8848 \
 96  -p 9848:9848 \
 97  --restart unless-stopped \
 98  -e MODE=standalone \
 99  nacos/nacos-server:v2.5.0
100  
101  
102  
103docker run -d --name nginx \
104  -p 8080:80 \
105  -v /home/charlie/Workspace/datas/ngnix/conf/nginx.conf:/etc/nginx/nginx.conf:ro \
106  -v /home/charlie/Workspace/datas/ngnix/conf/conf.d:/etc/nginx/conf.d:ro \
107  -v /home/charlie/Workspace/datas/ngnix/html:/usr/share/nginx/html:ro \
108  -v /home/charlie/Workspace/datas/ngnix/logs:/var/log/nginx \
109  -v /home/charlie/Workspace/datas/ngnix/ssl:/etc/nginx/ssl:ro \
110  --restart no \
111  nginx:stable-alpine3.24

# ===== MySQL 9.7.2（开机自启）=====
docker run -d --name mysql \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD='infra123!' \
  -v /home/charlie/Workspace/datas/mysql:/var/lib/mysql \
  --restart unless-stopped \
  mysql:9.7.2

# ===== Redis 8.8.2（开机自启 + AOF）=====
docker run -d --name redis \
  -p 6379:6379 \
  -e REDIS_PASSWORD='infra123!' \
  -v /home/charlie/Workspace/datas/redis:/data \
  --restart unless-stopped \
  redis:8.8.2 \
  --requirepass "infra123!" --appendonly yes


# ===== MySQL 9.7.2（开机不自启）=====
docker run -d --name mysql \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD='infra123!' \
  -v /home/charlie/Workspace/datas/mysql:/var/lib/mysql \
  --restart no \
  mysql:9.7.2

# ===== Redis 8.8.2（开机不自启 + AOF）=====
docker run -d --name redis \
  -p 6379:6379 \
  -e REDIS_PASSWORD='infra123!' \
  -v /home/charlie/Workspace/datas/redis:/data \
  --restart no \
  redis:8.8.2 \
  --requirepass "infra123!" --appendonly yes


# ===== Silo (MinIO 变体) =====
docker run -d --name silo \
  -p 9000:9000 -p 9001:9001 \
  -e MINIO_ROOT_USER=admin \
  -e MINIO_ROOT_PASSWORD='infra123!' \
  -v silo_data:/data \
  --restart unless-stopped \
  pgsty/silo:RELEASE.2026-08-06T00-00-00Z \
  server /data --console-address ":9001"
  
  
# ===== Silo（默认不自启）=====
docker run -d --name silo \
  -p 9000:9000 -p 9001:9001 \
  -e MINIO_ROOT_USER=admin \
  -e MINIO_ROOT_PASSWORD='infra123!' \
  -v /home/charlie/Workspace/datas/silo:/data \
  --restart no \
  pgsty/silo:RELEASE.2026-08-06T00-00-00Z \
  server /data --console-address ":9001"

# ===== RabbitMQ 4.2.9-management =====
docker run -d --name rabbitmq \
  -p 5672:5672 \
  -p 15672:15672 \
  -e RABBITMQ_DEFAULT_USER=admin \
  -e RABBITMQ_DEFAULT_PASS='infra123!' \
  -v rabbitmq_data:/var/lib/rabbitmq \
  --restart no \
  rabbitmq:4.2.9-management

# ===== Ollama 0.33.1 =====
docker run -d --name ollama \
  -p 11434:11434 \
  -v ollama_data:/root/.ollama \
  --restart unless-stopped \
  ollama/ollama:0.33.1

# ===== Ollama 0.33.1 =====
docker run -d --name ollama \
  -p 11434:11434 \
  -v ollama_data:/root/.ollama \
  --restart no \
  ollama/ollama:0.33.1
  
# ===== Draw.io 31.4.1 =====
docker run -d --name draw \
  -p 18080:8080 \
  --restart unless-stopped \
  jgraph/drawio:31.4.1
  
docker run -d --name drawio \
  -p 18080:8080 \
  --restart no \
  jgraph/drawio:31.4.2
  
# ===== Nacos 2.5.0 =====
docker run -d --name nacos \
  -p 8848:8848 \
  -p 9848:9848 \
  --restart unless-stopped \
  -e MODE=standalone \
  nacos/nacos-server:v2.5.0
  
  
  
docker run -d --name nginx \
  -p 8080:80 \
  -v /home/charlie/Workspace/datas/ngnix/conf/nginx.conf:/etc/nginx/nginx.conf:ro \
  -v /home/charlie/Workspace/datas/ngnix/conf/conf.d:/etc/nginx/conf.d:ro \
  -v /home/charlie/Workspace/datas/ngnix/html:/usr/share/nginx/html:ro \
  -v /home/charlie/Workspace/datas/ngnix/logs:/var/log/nginx \
  -v /home/charlie/Workspace/datas/ngnix/ssl:/etc/nginx/ssl:ro \
  --restart no \
  nginx:stable-alpine3.24

运行命令

  1# ===== MySQL 9.7.2（开机不自启）=====
  2docker run -d --name mysql \
  3  -p 3306:3306 \
  4  -e MYSQL_ROOT_PASSWORD='infra123!' \
  5  -v mysql_data:/var/lib/mysql \
  6  --restart no \
  7  mysql:9.7.2
  8
  9# ===== Redis 8.8.2（开机不自启 + AOF）=====
 10docker run -d --name redis \
 11  -p 6379:6379 \
 12  -e REDIS_PASSWORD='infra123!' \
 13  -v redis_data:/data \
 14  --restart no \
 15  redis:8.8.2 \
 16  --requirepass "infra123!" --appendonly yes
 17
 18# ===== Silo（默认不自启）=====
 19docker run -d --name silo \
 20  -p 9000:9000 -p 9001:9001 \
 21  -e MINIO_ROOT_USER=admin \
 22  -e MINIO_ROOT_PASSWORD='infra123!' \
 23  -v silo_data:/data \
 24  --restart no \
 25  pgsty/silo:RELEASE.2026-08-06T00-00-00Z \
 26  server /data --console-address ":9001"
 27
 28# ===== RabbitMQ 4.2.9-management =====
 29docker run -d --name rabbitmq \
 30  -p 5672:5672 \
 31  -p 15672:15672 \
 32  -e RABBITMQ_DEFAULT_USER=admin \
 33  -e RABBITMQ_DEFAULT_PASS='infra123!' \
 34  -v rabbitmq_data:/var/lib/rabbitmq \
 35  --restart no \
 36  rabbitmq:4.2.9-management
 37
 38# ===== Ollama 0.33.1 =====
 39docker run -d --name ollama \
 40  -p 11434:11434 \
 41  -v ollama_data:/root/.ollama \
 42  --restart no \
 43  ollama/ollama:0.33.1
 44
 45docker run -d --name drawio \
 46  -p 18080:8080 \
 47  --restart no \
 48  jgraph/drawio:31.4.6
 49  
 50# ===== Nacos 2.5.0 =====
 51docker run -d --name nacos \
 52  -p 8848:8848 \
 53  -p 9848:9848 \
 54  --restart unless-stopped \
 55  -e MODE=standalone \
 56  nacos/nacos-server:v2.5.0
 57  
 58  
 59# ===== Milvus 前置：命名卷写入 etcd 配置 =====
 60docker volume create milvus_data
 61docker run --rm -v milvus_data:/var/lib/milvus alpine sh -c 'cat > /var/lib/milvus/embedEtcd.yaml << EOF
 62listen-client-urls: http://0.0.0.0:2379
 63advertise-client-urls: http://0.0.0.0:2379
 64quota-backend-bytes: 4294967296
 65auto-compaction-mode: revision
 66auto-compaction-retention: '\''1000'\''
 67EOF'
 68# ===== Milvus（开机不自启）=====
 69docker run -d --name milvus \
 70  --pull=never \
 71  --security-opt seccomp:unconfined \
 72  -e ETCD_USE_EMBED=true \
 73  -e ETCD_DATA_DIR=/var/lib/milvus/etcd \
 74  -e ETCD_CONFIG_PATH=/var/lib/milvus/embedEtcd.yaml \
 75  -e COMMON_STORAGETYPE=local \
 76  -e DEPLOY_MODE=STANDALONE \
 77  -v milvus_data:/var/lib/milvus \
 78  -p 19530:19530 \
 79  -p 9091:9091 \
 80  -p 2379:2379 \
 81  --health-cmd="curl -f http://localhost:9091/healthz" \
 82  --health-interval=30s \
 83  --health-start-period=90s \
 84  --health-timeout=20s \
 85  --health-retries=3 \
 86  --restart no \
 87  milvusdb/milvus:v3.0.1 \
 88  milvus run standalone
 89# ===== 开启鉴权，并把 root 密码改为 infra123! =====
 90docker exec milvus sh -c 'cat > /milvus/configs/user.yaml << EOF
 91common:
 92  security:
 93    authorizationEnabled: true
 94EOF'
 95docker restart milvus
 96# 等 healthy 后执行
 97curl -sS -X POST "http://127.0.0.1:19530/v2/vectordb/users/update_password" \
 98  -H "Authorization: Bearer root:Milvus" \
 99  -H "Content-Type: application/json" \
100  -d '{"userName":"root","password":"Milvus","newPassword":"infra123!"}'
101# ===== Attu（开机不自启）=====
102docker run -d --name attu \
103  --pull=never \
104  -p 8000:3000 \
105  -e MILVUS_URL=http://host.docker.internal:19530 \
106  -e ATTU_ADMIN_USER=admin \
107  -e ATTU_ADMIN_PASSWORD='infra123!' \
108  -v attu_data:/data \
109  --add-host=host.docker.internal:host-gateway \
110  --restart no \
111  zilliz/attu:v3.0.0

# ===== MySQL 9.7.2（开机不自启）=====
docker run -d --name mysql \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD='infra123!' \
  -v mysql_data:/var/lib/mysql \
  --restart no \
  mysql:9.7.2

# ===== Redis 8.8.2（开机不自启 + AOF）=====
docker run -d --name redis \
  -p 6379:6379 \
  -e REDIS_PASSWORD='infra123!' \
  -v redis_data:/data \
  --restart no \
  redis:8.8.2 \
  --requirepass "infra123!" --appendonly yes

# ===== Silo（默认不自启）=====
docker run -d --name silo \
  -p 9000:9000 -p 9001:9001 \
  -e MINIO_ROOT_USER=admin \
  -e MINIO_ROOT_PASSWORD='infra123!' \
  -v silo_data:/data \
  --restart no \
  pgsty/silo:RELEASE.2026-08-06T00-00-00Z \
  server /data --console-address ":9001"

# ===== RabbitMQ 4.2.9-management =====
docker run -d --name rabbitmq \
  -p 5672:5672 \
  -p 15672:15672 \
  -e RABBITMQ_DEFAULT_USER=admin \
  -e RABBITMQ_DEFAULT_PASS='infra123!' \
  -v rabbitmq_data:/var/lib/rabbitmq \
  --restart no \
  rabbitmq:4.2.9-management

# ===== Ollama 0.33.1 =====
docker run -d --name ollama \
  -p 11434:11434 \
  -v ollama_data:/root/.ollama \
  --restart no \
  ollama/ollama:0.33.1

docker run -d --name drawio \
  -p 18080:8080 \
  --restart no \
  jgraph/drawio:31.4.6
  
# ===== Nacos 2.5.0 =====
docker run -d --name nacos \
  -p 8848:8848 \
  -p 9848:9848 \
  --restart unless-stopped \
  -e MODE=standalone \
  nacos/nacos-server:v2.5.0
  
  
# ===== Milvus 前置：命名卷写入 etcd 配置 =====
docker volume create milvus_data
docker run --rm -v milvus_data:/var/lib/milvus alpine sh -c 'cat > /var/lib/milvus/embedEtcd.yaml << EOF
listen-client-urls: http://0.0.0.0:2379
advertise-client-urls: http://0.0.0.0:2379
quota-backend-bytes: 4294967296
auto-compaction-mode: revision
auto-compaction-retention: '\''1000'\''
EOF'
# ===== Milvus（开机不自启）=====
docker run -d --name milvus \
  --pull=never \
  --security-opt seccomp:unconfined \
  -e ETCD_USE_EMBED=true \
  -e ETCD_DATA_DIR=/var/lib/milvus/etcd \
  -e ETCD_CONFIG_PATH=/var/lib/milvus/embedEtcd.yaml \
  -e COMMON_STORAGETYPE=local \
  -e DEPLOY_MODE=STANDALONE \
  -v milvus_data:/var/lib/milvus \
  -p 19530:19530 \
  -p 9091:9091 \
  -p 2379:2379 \
  --health-cmd="curl -f http://localhost:9091/healthz" \
  --health-interval=30s \
  --health-start-period=90s \
  --health-timeout=20s \
  --health-retries=3 \
  --restart no \
  milvusdb/milvus:v3.0.1 \
  milvus run standalone
# ===== 开启鉴权，并把 root 密码改为 infra123! =====
docker exec milvus sh -c 'cat > /milvus/configs/user.yaml << EOF
common:
  security:
    authorizationEnabled: true
EOF'
docker restart milvus
# 等 healthy 后执行
curl -sS -X POST "http://127.0.0.1:19530/v2/vectordb/users/update_password" \
  -H "Authorization: Bearer root:Milvus" \
  -H "Content-Type: application/json" \
  -d '{"userName":"root","password":"Milvus","newPassword":"infra123!"}'
# ===== Attu（开机不自启）=====
docker run -d --name attu \
  --pull=never \
  -p 8000:3000 \
  -e MILVUS_URL=http://host.docker.internal:19530 \
  -e ATTU_ADMIN_USER=admin \
  -e ATTU_ADMIN_PASSWORD='infra123!' \
  -v attu_data:/data \
  --add-host=host.docker.internal:host-gateway \
  --restart no \
  zilliz/attu:v3.0.0

01-Markdown特性完整测试

Fri, 02 Oct 2026 00:00:00 +0800

本文用于一次性冒烟：标准 Markdown、GFM 扩展、代码块（含高亮行）、Mermaid fence、数学公式，以及本站常用的 Solitude shortcode。改主题或自定义 CSS 后，打开本页扫一眼即可。

1. 标题层级

下面从 ## 到 ######（页面标题已占用 h1）。

1.1 三级标题 H3

1.1.1 四级标题 H4

五级标题 H5

六级标题 H6

2. 段落与行内强调

普通段落。同一段内可以混排粗体、斜体、粗斜体、~~删除线~~，以及 行内代码。

还可以组合：** 里不该再套代码；正确写法是 bold with code 或 italic with code。

硬换行（行尾两个空格）会变成
下一行（同一段落内的强制换行）。

软换行（单个换行）在 Markdown 里通常仍并成同一段。

3. 链接与图片

3.1 链接

行内链接：撷时录首页
带标题的链接：Hugo
自动链接：https://jiangbyte.github.io/
参考式链接：Solitude 主题

站内锚点：跳到表格 · 跳到 Mermaid

centos安装mysql

Thu, 01 Oct 2026 00:00:00 +0800

先说背景

CentOS 7 自带的包管理是 Yum 不是 Dnf，而且官方源里没有 MySQL，得自己加仓库。这篇文章就是我在 CentOS 7 上装 MySQL 的完整记录，包括几种不同的安装方式，方便下次忘了回来看。

先看看系统版本

1cat /etc/redhat-release
2hostnamectl

cat /etc/redhat-release
hostnamectl

输出是 CentOS Linux release 7.x 就没问题。如果是 8 或 9 那包管理就变成 Dnf 了，步骤不太一样。

安装前要确认的事

你有 sudo 权限
机器能联网（离线场景下面有单独的方法）
防火墙要不要开 3306 端口看你自己需求

方法一：用 Yum 装（最省事）

先把仓库加上

Oracle 官方准备好了 RPM 包，一行命令搞定：

1sudo yum install -y https://dev.mysql.com/get/mysql80-community-release-el7-11.noarch.rpm

sudo yum install -y https://dev.mysql.com/get/mysql80-community-release-el7-11.noarch.rpm

装完之后系统里会多一个 /etc/yum.repos.d/mysql-community.repo，里面有好几个子仓库，默认启用的是 MySQL 8.0。

centos安装redis

Thu, 01 Oct 2026 00:00:00 +0800

先说背景

CentOS 7 默认源里没有 Redis，得自己想办法。这篇整理了几种装法，从最省事的 Yum 到手动编译，看情况选就行。

方法一：Yum 装（最省事）

先加 EPEL 仓库

Redis 在 EPEL（Extra Packages for Enterprise Linux）里：

1sudo yum install epel-release

sudo yum install epel-release

然后直接装

1sudo yum install redis

sudo yum install redis

启动服务

1sudo systemctl start redis
2sudo systemctl enable redis
3sudo systemctl status redis

sudo systemctl start redis
sudo systemctl enable redis
sudo systemctl status redis

方法二：编译安装（想要最新版本）

Yum 里的 Redis 版本一般比较老，想尝鲜就自己编译。

Claude、Codex 全自动模式

Thu, 01 Oct 2026 00:00:00 +0800

“YOLO 模式”（或叫"全自动模式"）是为了让 AI 编程助手在不经你逐次确认的情况下，全自动执行指令。Codex 和 Claude Code 都有各自的开启方式，但核心逻辑和风险是一样的。

YOLO 模式主要通过两种方式开启：命令行参数和配置文件。

开启 YOLO 模式意味着将 AI 的操作权限完全放开，这虽然能极大提升效率，但也存在不小的风险。

速览

工具	对应的 YOLO 标志	说明
Codex CLI (OpenAI)	`--yolo` 或 `--dangerously-bypass-approvals-and-sandbox`	后者是其完整标志，`--yolo` 是别名。
Claude Code (Anthropic)	`--dangerously-skip-permissions`	Claude Code 使用的官方标志。

如何开启 YOLO 模式

命令行启动

对于 Codex：在启动命令后直接加上 --yolo 或完整标志。

1codex --yolo "需求描述"
2# 或者
3codex --dangerously-bypass-approvals-and-sandbox "需求描述"

codex --yolo "需求描述"
# 或者
codex --dangerously-bypass-approvals-and-sandbox "需求描述"

对于 Claude Code：启动时加上 --dangerously-skip-permissions。

1claude --dangerously-skip-permissions "需求描述"

claude --dangerously-skip-permissions "需求描述"

Cursor WSL 连接失败？手动安装 cursor-server 的完整方案

Thu, 01 Oct 2026 00:00:00 +0800

先说问题

在 Windows 上用 Cursor 打开 WSL 项目时，左下角一直转圈，等待比较久……好像也没有安装好，检查 ~/.cursor-server/bin/ 目录，发现 commit id 的目录是空的，说明自动下载失败了。这在国内网络环境下应该常见，因为服务器文件有 125MB，可能下载中途断掉了。

为什么会有这个问题

Cursor 连接 WSL（或远程 SSH）时，需要在 WSL 内安装一个服务端组件 cursor-server，它本质上是 VSCode Remote 的定制版。自动下载流程大致是：

Cursor Windows 端发起 WSL 连接
WSL 端根据 commit ID 下载对应的 vscode-reh-linux-x64.tar.gz
解压到 ~/.cursor-server/bin/<commit-id>/
启动 server，建立通信

第二步在国内网络环境下经常超时或中断，下载失败后 bin/<commit-id>/ 目录是空的，但 .installation_lock 文件被写入了，导致 Cursor 以为"正在安装中"，不会重试。

手动安装步骤

找到当前 Cursor 版本的 commit ID

Commit ID 在 Cursor 的版本里，命令：

1cursor --version

cursor --version

输出：

Debian 13 XFCE 开发机整理：熄屏、软件源、全局菜单与防火墙

Thu, 01 Oct 2026 00:00:00 +0800

先说场景

机器是一台日常开发本：Debian GNU/Linux 13 (trixie) + XFCE，硬件是 HP ProBook，双 NVMe，本机还跑着 Docker（MySQL / Redis / Portainer 等）。

一次顺手整理，把几件容易踩坑的事一起做完：

关掉自动熄屏 / 挂起（插电、电池都关）
看清「要不要更新」，以及为什么 apt 会甩出一千多个可升级包
注释掉 sid / bullseye 混源，只做安全范围内的升级
弄清 XApp / AppMenu，装上全局菜单并让它对齐、能导出菜单
看资源占用，给开发机开防火墙（默认不让别的设备访问）

下面按实际操作顺序写，命令可直接复用。

XFCE：关掉自动熄屏和挂起

电源管理 GUI

打开：

1xfce4-power-manager-settings

xfce4-power-manager-settings

重点看两个标签，且 On battery / Plugged in 都要改：

System：When inactive for → Never
Display：Put to sleep after / Switch off after → Never
更干净的做法：直接关掉 Display power management 总开关

Devices 标签只显示电池信息，没有熄屏相关选项。

Debian XFCE 换 GDM 登录页与用户头像

Thu, 01 Oct 2026 00:00:00 +0800

目标与边界

机器：Debian 13（trixie）+ XFCE，原先用 LightDM + lightdm-gtk-greeter。

要做的事：

登录界面换成 GDM3（只要登录页，不换 GNOME 桌面）
登录后仍进 Xfce Session
能用图形工具调登录页外观（壁纸等）
搞清楚 登录头像 改哪里、为什么 Mugshot / 只改 ~/.face 不生效

明确不做（本文范围外）：

不装 WhiteSur / macOS 风 GDM 主题（可以后再加）
不卸载 LightDM 包（方便回退）

桌面侧其它整理可对照：Debian 13 XFCE 开发机整理：熄屏、软件源、全局菜单与防火墙。

先备份

1sudo cp -a /etc/X11/default-display-manager \
2  /etc/X11/default-display-manager.bak.$(date +%Y%m%d%H%M%S)
3sudo cp -a /etc/lightdm/lightdm.conf \
4  /etc/lightdm/lightdm.conf.bak.$(date +%Y%m%d%H%M%S)

sudo cp -a /etc/X11/default-display-manager \
  /etc/X11/default-display-manager.bak.$(date +%Y%m%d%H%M%S)
sudo cp -a /etc/lightdm/lightdm.conf \
  /etc/lightdm/lightdm.conf.bak.$(date +%Y%m%d%H%M%S)

确认当前 DM 与 XFCE 会话文件存在：

Debian安装Redis和MySQL

Thu, 01 Oct 2026 00:00:00 +0800

说明

本文要装的是 Oracle MySQL 和 Redis，不是 MariaDB。

Debian 自带仓库里的 default-mysql-server 实际会装成 MariaDB，不要用那个包。本机用 apt 装 MySQL 时，走 MySQL 官方 APT 源。

方式	Redis	MySQL
A. 软件源	Debian 源 `redis-server`	MySQL 官方 APT → `mysql-community-server`
B. Docker	`redis:8.8.2`	`mysql:9.7.2`

密码示例：infra123!（请改成自己的）。

不要两套同时占 3306 / 6379。

前置：

方式 A：软件源安装（含密码配置）

先清掉可能装过的 MariaDB（如有）

若以前误装过 default-mysql-server / mariadb-*，先卸干净，避免抢端口和混淆：

1sudo systemctl stop mariadb mysql 2>/dev/null || true
2sudo apt purge -y 'mariadb-*' 'default-mysql-*' 2>/dev/null || true
3sudo apt autoremove -y
4# 确认没有残留服务占 3306
5sudo ss -tlnp | grep 3306 || echo '3306 free'

sudo systemctl stop mariadb mysql 2>/dev/null || true
sudo apt purge -y 'mariadb-*' 'default-mysql-*' 2>/dev/null || true
sudo apt autoremove -y
# 确认没有残留服务占 3306
sudo ss -tlnp | grep 3306 || echo '3306 free'

安装 Redis（Debian 源）

1sudo apt update
2sudo apt install -y redis-server
3sudo systemctl enable --now redis-server
4sudo systemctl status redis-server --no-pager

sudo apt update
sudo apt install -y redis-server
sudo systemctl enable --now redis-server
sudo systemctl status redis-server --no-pager

未设密码时：

Debian中国源安装Docker

Thu, 01 Oct 2026 00:00:00 +0800

前置

已配好 Debian 软件源（见配置 Debian 软件源）
确认代号：

1. /etc/os-release && echo "$VERSION_CODENAME"
2# 本文按 trixie 写；bookworm 等把下面 URL 里的代号一并改掉

. /etc/os-release && echo "$VERSION_CODENAME"
# 本文按 trixie 写；bookworm 等把下面 URL 里的代号一并改掉

不要用发行版仓库里过时的 docker.io 凑合（可以跑，但版本和管理源往往不如官方 CE 清晰）。开发机推荐 Docker CE + 国内镜像。

依赖与 GPG 密钥

1sudo apt update
2sudo apt install -y ca-certificates curl
3
4sudo install -m 0755 -d /etc/apt/keyrings
5sudo curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/debian/gpg \
6  -o /etc/apt/keyrings/docker.asc
7sudo chmod a+r /etc/apt/keyrings/docker.asc

sudo apt update
sudo apt install -y ca-certificates curl

sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/debian/gpg \
  -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

若阿里云 GPG 地址异常，可用 Docker 官方密钥再继续用阿里云软件源（密钥与仓库可分开）。

Hugo相对路径图片显示问题的分析与解决

Thu, 01 Oct 2026 00:00:00 +0800

先说问题

写博客的时候用 Obsidian 插了张图：

1![img](assets/example.jpg)

![img](assets/example.jpg)

编辑器里看着好好的，一跑 hugo 部署上去，图裂了。打开浏览器开发者工具一看，图片请求的路径根本就不对。

检查了一圈，发现这个问题只出现在 非 bundle 的 md 文件 上，用目录包起来的 index.md 反倒没事。

为什么会有这个问题

Hugo 的两种页面

Hugo 里写文章有两种姿势：

Page Bundle — 建个文件夹，里面放 index.md，图片丢同目录下

content/posts/my-post/
├── index.md
└── some-image.jpg

content/posts/my-post/
├── index.md
└── some-image.jpg

Leaf Page — 直接一个 .md 文件

content/posts/my-post.md

content/posts/my-post.md

我这边的目录结构是这样的：

content/posts/
├── _index.md
├── assets/
│   └── example.jpg
├── my-post.md              ← 出问题的
└── my-bundle-post/
    └── index.md            ← 没问题的

content/posts/
├── _index.md
├── assets/
│   └── example.jpg
├── my-post.md              ← 出问题的
└── my-bundle-post/
    └── index.md            ← 没问题的

Blowfish 主题自带的图片渲染逻辑，会先用 $.Page.Resources.GetMatch 去捞图片。Bundle 页面自然能捞到，但 leaf page 压根没有 page resources，捞了个空。最后 fallback 到直接把原始相对路径当 src 输出——这就是问题的起点。

Integer 缓存机制（JDK 17 源码）

Thu, 01 Oct 2026 00:00:00 +0800

Integer 的缓存不是业务层优化，而是 JLS 对自动装箱对象同一性 的硬要求：一定范围内的 int 装箱后必须是同一个 Integer 实例。实现落在私有静态内部类 Integer.IntegerCache，对外入口是 Integer.valueOf(int)。下文依据 JDK 17 的 java.lang.Integer 源码展开。

类上的 ValueBased

JDK 17 的 Integer 声明为：

1@jdk.internal.ValueBased
2public final class Integer extends Number
3        implements Comparable<Integer>, Constable, ConstantDesc {

@jdk.internal.ValueBased
public final class Integer extends Number
        implements Comparable<Integer>, Constable, ConstantDesc {

@ValueBased 提醒：这类对象更宜按值使用。缓存让小整数在引用层面也「碰巧」同一，但业务比较仍应以 equals / 拆箱后的 int 为准，不要把 == 当成通用相等判断。

自动装箱实际调用 valueOf

编译器对 Integer a = 10; 这类赋值会插入 Integer.valueOf(10)，不会走已废弃的构造器。完整验证如下（覆盖缓存边界、new、equals、抬高上界）：

Keil5 下载、安装、激活和使用记录

Thu, 01 Oct 2026 00:00:00 +0800

下载 Keil5

安装包下载地址：
https://pan.quark.cn/s/6a455cd4bce2

下载内容包括：Keil5 安装包（MDK540.exe）及注册机（keygen.exe）

安装 Keil5

正常安装

参考文献

https://segmentfault.com/a/1190000047918396

linux初始机

Thu, 01 Oct 2026 00:00:00 +0800

目标

新装或刚到手的 Debian 开发机，先把「能正常干活」的底子铺好，再去改软件源、装 Docker、跑 MySQL / Redis。

本文以 Debian 13 (trixie) + 图形桌面（如 XFCE） 为例，命令对服务器版同样适用（跳过桌面相关即可）。

建议阅读顺序：

确认系统

1cat /etc/os-release
2uname -r
3hostnamectl

cat /etc/os-release
uname -r
hostnamectl

关注：

VERSION_CODENAME（如 trixie）——后面写源、装 Docker 都要用
架构一般为 x86-64 / amd64

用户与 sudo

安装时若已创建普通用户并勾选 sudo，可跳过。否则：

1su -
2apt update
3apt install -y sudo
4usermod -aG sudo 你的用户名

su -
apt update
apt install -y sudo
usermod -aG sudo 你的用户名

注销重登后验证：

Object 源码解析（Oracle JDK 17）

Thu, 01 Oct 2026 00:00:00 +0800

java.lang.Object 是 Java 类型体系的根：除它自身外，每个类（含数组类型）最终都继承它，因而它定义的方法构成「所有对象共有的最小行为集」¹。下文依据本机 Oracle JDK 17.0.20.1（$JAVA_HOME=/home/charlie/workspace/sdks/jdk-17）自带源码包中的 Object.java，按成员出现顺序解析——侧重为何存在、契约与 HotSpot 如何支撑、工程上如何用；源码与本机实测用来锚定结论，而不是逐行注释。

源码路径：$JAVA_HOME/lib/src.zip → java.base/java/lang/Object.java¹。

运行与验证：同一套 Oracle JDK；工程 learning-lab/java/java17-sources 中的 ObjectLayoutVerify / ObjectMethodsVerify / ObjectMonitorVerify²。

类注释：根类型意味着什么

1/**
2 * Class {@code Object} is the root of the class hierarchy.
3 * Every class has {@code Object} as a superclass. All objects,
4 * including arrays, implement the methods of this class.
5 *
6 * @see     java.lang.Class
7 * @since   1.0
8 */
9public class Object {

/**
 * Class {@code Object} is the root of the class hierarchy.
 * Every class has {@code Object} as a superclass. All objects,
 * including arrays, implement the methods of this class.
 *
 * @see     java.lang.Class
 * @since   1.0
 */
public class Object {

把「万物皆对象」落成语言规则，有三层后果：

ubuntu安装mysql

Thu, 01 Oct 2026 00:00:00 +0800

先说背景

Ubuntu 的 APT 源里自带 MySQL，装起来比 CentOS 省心不少。不过默认版本可能不是最新的，想指定版本或者用官方最新版也有办法。

方法一：APT 直接装（最省事）

1sudo apt update
2sudo apt install mysql-server

sudo apt update
sudo apt install mysql-server

装完启动：

1sudo systemctl start mysql
2sudo systemctl enable mysql

sudo systemctl start mysql
sudo systemctl enable mysql

然后跑一下安全配置脚本：

1sudo mysql_secure_installation

sudo mysql_secure_installation

这个脚本会一步步引导你改 root 密码、删匿名用户、禁止 root 远程登录、删测试数据库。别跳过。

ubuntu安装redis

Thu, 01 Oct 2026 00:00:00 +0800

先说背景

Ubuntu 比 CentOS 省心点，APT 源里直接有 Redis，不用额外加仓库。不过版本可能不是最新的，想尝鲜还是得自己编译。

方法一：APT 装（最省事）

更新源然后直接装

1sudo apt update
2sudo apt install redis-server

sudo apt update
sudo apt install redis-server

启动服务

1sudo systemctl start redis-server
2sudo systemctl enable redis-server
3sudo systemctl status redis-server

sudo systemctl start redis-server
sudo systemctl enable redis-server
sudo systemctl status redis-server

方法二：编译安装（想要最新版本）

APT 里的版本一般落后一两个大版本，想用最新的就自己编译。

装编译工具

1sudo apt update
2sudo apt install build-essential tcl

sudo apt update
sudo apt install build-essential tcl

下载源码编译

1cd /tmp
2wget https://download.redis.io/redis-stable.tar.gz
3tar -xzvf redis-stable.tar.gz
4cd redis-stable
5make
6sudo make install

cd /tmp
wget https://download.redis.io/redis-stable.tar.gz
tar -xzvf redis-stable.tar.gz
cd redis-stable
make
sudo make install

准备配置目录

1sudo mkdir /etc/redis
2sudo mkdir /var/redis
3sudo cp redis.conf /etc/redis/

sudo mkdir /etc/redis
sudo mkdir /var/redis
sudo cp redis.conf /etc/redis/

基本配置

测试连接

1redis-cli
2127.0.0.1:6379> ping
3PONG
4127.0.0.1:6379> set test "hello"
5OK
6127.0.0.1:6379> get test
7"hello"
8127.0.0.1:6379> exit

redis-cli
127.0.0.1:6379> ping
PONG
127.0.0.1:6379> set test "hello"
OK
127.0.0.1:6379> get test
"hello"
127.0.0.1:6379> exit

改配置

1sudo nano /etc/redis/redis.conf

sudo nano /etc/redis/redis.conf

几个常用的：

VMware Workstation Pro 26H1 安装

Thu, 01 Oct 2026 00:00:00 +0800

本文按 2026-06-19 时点可获取的 26H1 免费版 流程整理，主要记录 Windows 宿主机上的下载和安装步骤。

下载 VMware Workstation Pro 26H1

Broadcom 注册地址：https://profile.broadcom.com/web/registration Broadcom 登录地址：https://access.broadcom.com/default/ui/v1/signin/

下载入口：

1https://support.broadcom.com/group/ecx/productdownloads?subfamily=VMware%20Workstation%20Pro&freeDownloads=true

https://support.broadcom.com/group/ecx/productdownloads?subfamily=VMware%20Workstation%20Pro&freeDownloads=true

选择对应版本

I agree to the Terms and Conditions

I agree to the Terms and Conditions

这个按钮可能有时候点击不了，多试几次

可能需要填写一些信息：

开始安装

Webhook 与飞书机器人集成

Thu, 01 Oct 2026 00:00:00 +0800

审计告警功能需要把检测到的安全事件推送到飞书群。飞书提供了自定义机器人 Webhook 的接口，支持文本和富文本消息格式，也可以配置 HMAC-SHA256 签名验证。

实现上需要解决三个问题：签名怎么算、参数放哪里、消息怎么写。

签名算法

飞书官方文档给出的签名示例：

 1import hashlib
 2import base64
 3import hmac
 4
 5def gen_sign(timestamp, secret):
 6    string_to_sign = '{}\n{}'.format(timestamp, secret)
 7    hmac_code = hmac.new(
 8        string_to_sign.encode("utf-8"),
 9        digestmod=hashlib.sha256
10    ).digest()
11    sign = base64.b64encode(hmac_code).decode('utf-8')
12    return sign

import hashlib
import base64
import hmac

def gen_sign(timestamp, secret):
    string_to_sign = '{}\n{}'.format(timestamp, secret)
    hmac_code = hmac.new(
        string_to_sign.encode("utf-8"),
        digestmod=hashlib.sha256
    ).digest()
    sign = base64.b64encode(hmac_code).decode('utf-8')
    return sign

注意这里的 hmac.new 调用是 hmac.new(key, msg=None, digestmod=sha256)，key 是 timestamp\nsecret，msg 为空。和通常的 hmac.new(secret, data, digestmod) 写法不一样，如果习惯性地把 secret 放第一个参数、string_to_sign 放第二个，签名就对不上。

XFCE AppMenu 居中与 Expand 被写回

Thu, 01 Oct 2026 00:00:00 +0800

现象

顶栏装了 AppMenu Plugin 之后：

菜单标题（如 Cursor、Thunar）不靠左，像漂在面板中间
右键属性里把 Expand plugin on panel 关掉，看起来正常了
注销 / 重启 后，Expand 又被勾上，标题又居中

装全局菜单、环境变量、GTK module 等前置步骤见：Debian 13 XFCE 开发机整理：熄屏、软件源、全局菜单与防火墙。本文只挖 居中 / Expand 反复写回 这一块。

AppMenu 是什么（不是另一套更好的菜单）

面板里叫 AppMenu Plugin 的东西，包名是：

1apt-cache show xfce4-appmenu-plugin | grep -E '^(Package|Source|Description)'

apt-cache show xfce4-appmenu-plugin | grep -E '^(Package|Source|Description)'

实际就是 vala-panel-appmenu 的 XFCE 后端：把当前窗口的 File / Edit 等导出到面板。
没有「再装一个更强的 AppMenu」这种替代品——同一种插件，名字略容易混。

相关包通常还有：appmenu-gtk3-module、appmenu-registrar。

为什么会「居中」

面板插件有个开关：Expand plugin on panel（扩展以填满可用空间）。

配置Debian软件源

Thu, 01 Oct 2026 00:00:00 +0800

为什么要改源

默认 deb.debian.org 在国内经常慢或不稳。开发机建议：

软件包、更新、backports → 中科大镜像（也可换清华、北外、阿里云等）
安全更新 → 继续用官方 security.debian.org（更及时）

同时要避免把 sid（unstable）、旧版 bullseye 和当前稳定版写进同一套默认源，否则 apt list --upgradable 会刷出上千个包，一不小心就把桌面拖进滚动版。

备份

1sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak.$(date +%Y%m%d%H%M%S)

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak.$(date +%Y%m%d%H%M%S)

确认代号：

1. /etc/os-release && echo "$VERSION_CODENAME"
2# Debian 13 → trixie

. /etc/os-release && echo "$VERSION_CODENAME"
# Debian 13 → trixie

下文以 trixie 为例，其他版本替换代号即可。

使用 Docker 快速部署数据服务环境

Thu, 01 Oct 2026 00:00:00 +0800

前置准备

首先创建所有服务的数据持久化目录：

1# 创建统一的数据存储目录
2mkdir -p ~/docker-data/{postgres,redis,rabbitmq}

# 创建统一的数据存储目录
mkdir -p ~/docker-data/{postgres,redis,rabbitmq}

服务部署

PostgreSQL（支持向量扩展，端口5433）

 1# 拉取支持向量扩展的PostgreSQL镜像
 2docker pull pgvector/pgvector:pg17
 3
 4# 启动PostgreSQL容器
 5docker run -d \
 6  --name postgres \
 7  --restart unless-stopped \
 8  -m 512m \
 9  -e POSTGRES_PASSWORD=123456 \
10  -e POSTGRES_DB=myapp \
11  -v ~/docker-data/postgres:/var/lib/postgresql/data \
12  -p 5433:5432 \
13  pgvector/pgvector:pg17

# 拉取支持向量扩展的PostgreSQL镜像
docker pull pgvector/pgvector:pg17

# 启动PostgreSQL容器
docker run -d \
  --name postgres \
  --restart unless-stopped \
  -m 512m \
  -e POSTGRES_PASSWORD=123456 \
  -e POSTGRES_DB=myapp \
  -v ~/docker-data/postgres:/var/lib/postgresql/data \
  -p 5433:5432 \
  pgvector/pgvector:pg17

启用向量扩展（首次启动后执行）：

双远程工作流

Thu, 01 Oct 2026 00:00:00 +0800

场景

最近团队基于 Snowy 这个开源项目做二次开发，在它上面加了很多自己的业务功能。但 Snowy 也在持续更新——修 Bug、加新特性、升级依赖版本。

问题来了：自己的代码和上游代码混在一起，怎么才能既自由修改，又能定期拉取上游的最新更新？

这就是我写这篇文章要分享的。

思路

我的核心思路是双远程 + 上游镜像分支：

origin → 团队自己的远程仓库（日常开发用）
upstream → 开源项目的远程仓库（只读，仅用来拉取更新）
upstream-master 分支 → 上游代码的纯净镜像，绝不直接提交
main 分支 → 团队开发主分支，包含所有自定义代码

gitGraph commit id: "A" commit id: "B" branch upstream-master checkout upstream-master commit id: "C" commit id: "D" checkout main commit id: "E: 上游v3.6.5" branch feature/xxx checkout feature/xxx commit id: "F" checkout main merge feature/xxx

初始化仓库

进入项目目录

1cd /your/project

cd /your/project

初始化 Git

1git init

git init

配置两个远程仓库（以codeup和gitee为例）

1git remote add origin git@codeup.aliyun.com:your-team/your-project.git
2git remote add upstream git@gitee.com:xiaonuobase/snowy.git

git remote add origin git@codeup.aliyun.com:your-team/your-project.git
git remote add upstream git@gitee.com:xiaonuobase/snowy.git

origin 是团队日常用的仓库，upstream 是 Snowy 的仓库（只拉取，不推送）。

同时配置 Gitee 与 GitHub

Thu, 01 Oct 2026 00:00:00 +0800

开发机上经常要同时推 Gitee、GitHub，有时还要接阿里云 Codeup。默认只会用 ~/.ssh/id_rsa，多平台共用一把钥匙容易乱；更稳妥的做法是：每平台一把密钥，用 ~/.ssh/config 按 Host 分流。

全局 Git 身份

提交作者信息与 SSH 无关，但新环境一般先配好：

1git config --global user.name "jiangbyte"
2git config --global user.email "your@email.com"
3git config --global --list

git config --global user.name "jiangbyte"
git config --global user.email "your@email.com"
git config --global --list

确认输出里有 user.name / user.email。若某仓库要用不同邮箱，再在该仓库里用 git config user.email（不加 --global）覆盖即可。

为各平台分别生成 SSH 密钥

目录权限先保证：

1mkdir -p ~/.ssh
2chmod 700 ~/.ssh

mkdir -p ~/.ssh
chmod 700 ~/.ssh

分别生成三把密钥（文件名自定义，别互相覆盖）：

用 conda 固定默认环境 normal

Thu, 01 Oct 2026 00:00:00 +0800

先说目标

机器上同时有三套 Python 很容易搅在一起：

系统自带的 /usr/bin/python3
conda 的 base
自己建的业务 / 学习环境

想要的结果很简单：不管终端还是 Cursor，一律只用名为 normal 的 conda 环境，不要再落到 base 或系统 Python 上。

下面以 miniforge（路径 /home/charlie/miniforge3）为例，过程对 Anaconda / Miniconda 同样适用，改一下前缀即可。

创建 `normal` 环境

选用相对稳妥的 3.12：

1conda create -n normal python=3.12 -y

conda create -n normal python=3.12 -y

创建完成后确认：

1conda env list
2# base                     /home/charlie/miniforge3
3# normal                   /home/charlie/miniforge3/envs/normal

conda env list
# base                     /home/charlie/miniforge3
# normal                   /home/charlie/miniforge3/envs/normal

解释器路径固定为：

用 Spring AI 实现 RAG 知识库：对话记忆、向量检索与文档入库

Thu, 01 Oct 2026 00:00:00 +0800

最近用 Spring AI 做了一套 RAG 知识库对话：后台管理多知识库和文件上传，对话侧支持会话记忆、按知识库过滤检索，以及 SSE 流式输出。骨架还是原来的 DDD-lite Spring Boot 分层。

技术选型大致是：

能力	选型
框架	Java 21 / Spring Boot 4.1 / Spring AI 2.0
Chat	阿里云百炼等 OpenAI 兼容接口（`spring-ai-starter-model-openai`）
Embedding	本地 Ollama（如 `embeddinggemma`，768 维）
向量库	Milvus
对话记忆	Spring AI Redis Chat Memory（RediSearch）
原文存储	MinIO（可与 Milvus 栈共用）
文档解析	Tika + TokenTextSplitter
元数据	MySQL + MyBatis-Plus
前端	Vite + React + Ant Design，SSE 流式对话

下面按实现顺序写整条链路：模块怎么分、Spring AI 怎么接、文档如何切片入库、RAG 与记忆如何同时生效，以及默认 RAG 提示词会坑闲聊等问题。

目标与整体架构

先明确要做的行为：

邮件集成与密码重置

Thu, 01 Oct 2026 00:00:00 +0800

项目中邮件功能用于发送密码重置链接，但此前只搭好了架子，缺少实际测试验证。本文将记录邮件集成的全链路配置、本地测试、以及过程中遇到并解决的几个问题。

邮件发送引擎

项目在 app/platform/email/sender.py 中实现了 send_mail 函数，支持普通 SMTP 和 STARTTLS 两种模式：

 1async def send_mail(to_email: str, subject: str, body: str) -> None:
 2    mail = settings.mail
 3    if not mail.host or not mail.from_email:
 4        raise BusinessError("Mail service is not configured")
 5    message = EmailMessage()
 6    message["From"] = f"{mail.from_name} <{mail.from_email}>"
 7    message["To"] = to_email
 8    message["Subject"] = subject
 9    message.set_content(body)
10    await asyncio.to_thread(_send_sync, message)

async def send_mail(to_email: str, subject: str, body: str) -> None:
    mail = settings.mail
    if not mail.host or not mail.from_email:
        raise BusinessError("Mail service is not configured")
    message = EmailMessage()
    message["From"] = f"{mail.from_name} <{mail.from_email}>"
    message["To"] = to_email
    message["Subject"] = subject
    message.set_content(body)
    await asyncio.to_thread(_send_sync, message)

邮件配置通过 MailSettings 集中管理，包括 SMTP 地址、端口、账号密码、TLS 开关等。配置项可在管理后台运行时修改，启动时从 sys_config 表加载覆盖。

主从复制配置

Thu, 01 Oct 2026 00:00:00 +0800

先说背景

两台机器，主库 CentOS 7，从库 Ubuntu，配 MySQL 主从复制。这篇是实际操作记录，方便下次复用。

主库配置（CentOS）

改配置文件

1sudo vi /etc/my.cnf

sudo vi /etc/my.cnf

在 [mysqld] 段加这些：

[mysqld]
server-id = 1                         # 主库 id，随便填，唯一就行
log_bin = /var/log/mysql/mysql-bin.log
read-only = 0                         # 0 表示读写（主库）
binlog_expire_logs_seconds = 2592000  # 日志保留 30 天
max_binlog_size = 100M
# binlog_do_db = astro_code            # 只同步指定库
# binlog_ignore_db = mysql,sys         # 不同步的库

[mysqld]
server-id = 1                         # 主库 id，随便填，唯一就行
log_bin = /var/log/mysql/mysql-bin.log
read-only = 0                         # 0 表示读写（主库）
binlog_expire_logs_seconds = 2592000  # 日志保留 30 天
max_binlog_size = 100M
# binlog_do_db = astro_code            # 只同步指定库
# binlog_ignore_db = mysql,sys         # 不同步的库

创建日志目录

1sudo mkdir -p /var/log/mysql
2sudo chown mysql:mysql /var/log/mysql
3sudo chmod 755 /var/log/mysql

sudo mkdir -p /var/log/mysql
sudo chown mysql:mysql /var/log/mysql
sudo chmod 755 /var/log/mysql

重启主库

1sudo systemctl restart mysqld

sudo systemctl restart mysqld

创建复制专用用户

主库上创建个用户给从库用：

首页 on 撷时录

撷时录

项目集

特性

技术栈

M3U8 Downloader

特性

技术栈

SparkSandbox

特性

技术栈

Startpage

特性

技术栈

玄鉴

特性

技术栈

ResumeFloat

特性

技术栈

Voxel

特性

技术栈

系列仓库

ACOJ

特性

Debian 13 友基 XP-Pen 数位板官方驱动与内核冲突排查固化

环境

ACOJ在线评测平台-架构风格论文

摘要

正文

第二章 计算机系统基础知识

计算机系统概述

第三章 信息系统基础知识

论文

摘要

正文

第一章 绪论

系统架构概述

系统架构定义

软件架构发展历程

模块化开发六大原则

软件架构常用分类

分层架构

Typora 自定义 github-cus 主题：掘金行内代码与标题自动编号

为什么要复制一份主题

Docker 本机基础设施执行命令

拉取镜像

运行命令

运行命令

01-Markdown特性完整测试

1. 标题层级

1.1 三级标题 H3

1.1.1 四级标题 H4

五级标题 H5

六级标题 H6

2. 段落与行内强调

3. 链接与图片

3.1 链接

centos安装mysql

先说背景

先看看系统版本

安装前要确认的事

方法一：用 Yum 装（最省事）

先把仓库加上

centos安装redis

先说背景

方法一：Yum 装（最省事）

先加 EPEL 仓库

然后直接装

启动服务

方法二：编译安装（想要最新版本）

Claude、Codex 全自动模式

速览

如何开启 YOLO 模式

命令行启动

Cursor WSL 连接失败？手动安装 cursor-server 的完整方案

先说问题

为什么会有这个问题

手动安装步骤

第二章计算机系统基础知识

第三章信息系统基础知识

第一章绪论