从弄丢的杂志光盘到女儿的物理启蒙:网页版机关游戏 Contraption Lab 开发调测记
前言
2001 年前后,电脑杂志还流行附光盘,买杂志一半是为了那张盘。有一张盘里装了个小游戏,我到现在记得它的玩法:开局给你几颗球、几块木板、蜡烛、滑轮、传送带,把它们摆成一套连锁机关,按下启动,看球滚下坡、撞翻杠杆、点燃蜡烛、烧断绳子……最后一环正好把目标搞定。关卡设计得很「坏」,道具永远只给差一个,逼着你想「能不能用蜡烛延时替代传送带」。那阵子放学就蹲在电脑前摆机关,一关能琢磨一晚上。
……一位Java开发者,喜欢研究技术,同时也在学习Golang和Python中,对服务器、Linux使用比较熟悉。欢迎添加技术交流QQ群:655158296
2001 年前后,电脑杂志还流行附光盘,买杂志一半是为了那张盘。有一张盘里装了个小游戏,我到现在记得它的玩法:开局给你几颗球、几块木板、蜡烛、滑轮、传送带,把它们摆成一套连锁机关,按下启动,看球滚下坡、撞翻杠杆、点燃蜡烛、烧断绳子……最后一环正好把目标搞定。关卡设计得很「坏」,道具永远只给差一个,逼着你想「能不能用蜡烛延时替代传送带」。那阵子放学就蹲在电脑前摆机关,一关能琢磨一晚上。
……2017 年刚从电信行业转出来的时候,我在博客里写过四波 VCS(Veritas Cluster Server)笔记:第一波讲怎么用官方 Windows 模拟器跑 Demo,第二波整理 ha* 命令,第三波翻 HAD/LLT/GAB/Fencing 的模块原理,第四波逐行解读 main.cf。那会儿学 VCS 基本只有一条路——下载官方 Simulator,装 JRE,再装个 Java 版 Cluster Manager 控制台,一步一个截图地啃。
用 Claude Code 干公司项目一段时间后,最疼的问题不是它写不好代码,而是主会话上下文频繁压缩:调研时读一堆文件、排错时几十轮失败堆栈、全局 grep 的海量结果,全堆在主对话里,撑到压缩阈值就被截断摘要——决策细节一丢就返工,返工一次比不压缩还费时间。
后来我把整个开发流程里「过程脏活」拆给了 5 个自定义 subagent,主会话只留决策和编码。跑了一个多月,压缩频率明显下降,上面的漏改事故再没犯过。这篇把设计思路、5 个 agent 的配置和一线踩坑经验整理出来,配置样例可以直接抄走改。
……前后端融合的工程里,排查一个「页面保存失败」的问题要横跨好几层:前端控制台、网关、后端多个服务、中间件、数据库。以前的处理路径是:找前端看请求 → 找后端捞日志 → 对 traceId → 查库验证,几个人来回扯半天。现在把这些能力都接成 MCP 工具给 AI(ELK 日志查询 MCP + 数据库 CLI,数据库那篇见 agent-database-cli),一句话描述问题,AI 按固定工作流自己跑完全程。这篇整理这套工作流。
……让 AI 直接连数据库干活(查表结构、验证数据、排查问题),最大的顾虑是安全和连接管理:密码放哪、怎么防止 AI 手滑删库、十来个环境怎么统一管理。我为此写了一个本地 CLI 工具 agent-database-cli(Rust 实现,npm 发包),把 MySQL、PostgreSQL、Redis(单机/集群)、Oracle、MongoDB 的连接、查询、元信息读取统一封装,配合 Claude Code 的 Skill 机制使用。这篇记录安装、配置和接入 Claude Code 的完整过程。
……最近发现sdkman使用有点异常,执行sdk list的时候显示离线状态,无法查看支持的软件清单
如下是发现问题经过:
|
|
测试curl找需要联网才能访问的网页正常
……日常研究需要用到一些基础镜像,下载了一些轻量或者合集的镜像,方便手头立马使用,记录下这些搜集的镜像
| # | 镜像 | 镜像 ID | 磁盘占用 | 唯一占用 | 分类 |
|---|---|---|---|---|---|
| 1 | harbor-test.***.cn/library/golang:1.26-bookworm | 116d58cbd88c | 1.24GB | 10.53MB | WeKnora 项目 |
| 2 | harbor-test.***.cn/library/node:22-bookworm | 8a34c4ab3ea2 | 1.64GB | 16.19MB | WeKnora 项目 |
| 3 | harbor-test.***.cn/library/debian:12.12-slim | d5d3f9c23164 | 116MB | 2.362MB | WeKnora 项目 |
| 4 | harbor-test.***.cn/library/nginx:1.30.3-alpine | 0d3b80406a13 | 93.3MB | 890.3kB | WeKnora 项目 |
| 5 | harbor-test.***.cn/library/ubuntu:24.04 | 224a1869083a | 119MB | 1.941MB | WeKnora 项目 |
| 6 | harbor-test.***.cn/library/weknora-app-builder:latest | f6096ec30238 | 5.53GB | 4.308GB | WeKnora 项目 |
| 7 | harbor-test.***.cn/library/weknora-ui-builder:latest | 62228836b8ec | 2.65GB | 1.025GB | WeKnora 项目 |
| 8 | harbor-test.***.cn/library/weknora-app-runtime-base:latest | 28db2cbf471c | 2.04GB | 8.257kB | WeKnora 项目 |
| 9 | harbor-test.***.cn/library/weknora-ui-runtime-base:latest | 45c33e557ef6 | 92.4MB | 4.338kB | WeKnora 项目 |
| 10 | harbor-test.***.cn/library/weknora-app:v0.7.2-a40b4fb8 | 549319f486b6 | 2.39GB | 357.4MB | WeKnora 项目 |
| 11 | harbor-test.***.cn/library/weknora-ui:v0.7.2-a40b4fb8 | c76acfe248fb | 129MB | 36.41MB | WeKnora 项目 |
| 12 | harbor-test.***.cn/library/kkfileview-base:4.4.0 | 9f395205812d | 1.89GB | 6.515kB | WeKnora 项目 |
| 13 | harbor-test.***.cn/library/kkfileview:4.4.0 | 7abaef3beead | 2.54GB | 654.1MB | WeKnora 项目 |
| 14 | golang:1.26-alpine | 28d89ee9cc0f | 364MB | 351.2MB | 语言与运行时 |
| 15 | sirmark/golang:1.26-alpine-glibc2.44 | e01a877bd319 | 381MB | 300.5MB | 语言与运行时 |
| 16 | node:22-slim | 83f487e0a634 | 329MB | 329.2MB | 语言与运行时 |
| 17 | python:3.13-slim | 7ce4b6dfe35e | 178MB | 60.76MB | 语言与运行时 |
| 18 | eclipse-temurin:21-alpine | 6ea5548706b6 | 553MB | 540.1MB | 语言与运行时 |
| 19 | eclipse-temurin:8-alpine | 971ad985d2d2 | 274MB | 260.8MB | 语言与运行时 |
| 20 | debian:trixie-slim | d7e12182ce18 | 119MB | 1.979MB | 语言与运行时 |
| 21 | ghcr.io/graalvm/native-image-community:21 | faed0fd6809b | 1.41GB | 1.243GB | 语言与运行时 |
| 22 | ghcr.io/graalvm/graalvm-community:21 | 6e46c711c90b | 1.57GB | 1.4GB | 语言与运行时 |
| 23 | bellsoft/liberica-native-image-kit-container:jdk-21-nik-23-glibc | 4decf5167a21 | 1.13GB | 1.095GB | 语言与运行时 |
| 24 | bellsoft/liberica-runtime-container:jdk-21-glibc | 25a30e03fcc5 | 216MB | 183.8MB | 语言与运行时 |
| 25 | bellsoft/liberica-runtime-container:jdk-8-glibc | 79e03737491d | 239MB | 206.4MB | 语言与运行时 |
| 26 | rockylinux/rockylinux:9-minimal | e1d0a9f5ed99 | 235MB | 234.9MB | 语言与运行时 |
| 27 | centos:7 | be65f488b776 | 301MB | 301.3MB | 语言与运行时 |
| 28 | kouleen/mysql:8.0.38 | a5afd0f5940f | 784MB | 784.3MB | 数据库 |
| 29 | technoboggle/mysql-alpine:latest | ef31f6d1473b | 396MB | 396.4MB | 数据库 |
| 30 | postgres:17-alpine | 18cfe3ef5e68 | 424MB | 410.9MB | 数据库 |
| 31 | gvenzl/oracle-free:23 | e2763af84ecc | 4.13GB | 4.131GB | 数据库 |
| 32 | mongodb/mongodb-community-server:8.3-ubi8-slim | c7ad6700ee65 | 667MB | 666.5MB | 数据库 |
| 33 | redis:7-alpine | ff02b58f971e | 57.8MB | 57.83MB | 数据库 |
| 34 | neo4j:2026.07.1-trixie | dca31d0d938d | 1.08GB | 1.081GB | 数据库 |
| 35 | clickhouse/clickhouse-server:latest-alpine | 0a45b864c733 | 1.02GB | 1.007GB | 数据库 |
| 36 | influxdb:1.8-alpine | 2601e27d6b7e | 229MB | 228.6MB | 数据库 |
| 37 | rustfs/rustfs:latest | 41fe89380f41 | 314MB | 300.7MB | 数据库 |
| 38 | openeuler/milvus:2.6.0-oe2403sp2 | e761daa832cc | 4.71GB | 4.705GB | 数据库 |
| 39 | apache/kafka-native:4.3.1 | 2885898ba170 | 208MB | 195.2MB | 中间件 |
| 40 | hashicorp/consul:latest | 56a8d0fdbfcb | 312MB | 302.9MB | 中间件 |
| 41 | voxxit/consul:latest | 5c3c4fd69210 | 48.7MB | 48.73MB | 中间件 |
| 42 | alpine/minio:latest-release | cf23643a6cf9 | 233MB | 233.3MB | 中间件 |
| 43 | sourcemation/etcd:latest | 0a8b00f6aab2 | 208MB | 208.4MB | 中间件 |
| 44 | nginx:1.30.3-alpine-slim | d5b51cfc7d55 | 21MB | 514.3kB | Web 服务器 |
| 45 | grafana/grafana-enterprise:12.4.0 | 582fc54fb34a | 1.09GB | 1.09GB | 监控可观测 |
| 46 | prom/prometheus:v3.10.0-distroless | 4d2174874988 | 534MB | 534MB | 监控可观测 |
| 47 | prom/alertmanager:v0.33.0 | af26fbe4dd18 | 121MB | 121.5MB | 监控可观测 |
| 48 | clickhouse/clickstack-all-in-one:latest | 383610987863 | 2.63GB | 2.614GB | 监控可观测 |
| 49 | mdmahtabuddin/aamar-elk-stack:latest | 08c227b76827 | 5.9GB | 5.904GB | 监控可观测 |
| 50 | xuxueli/xxl-job-admin:3.4.2 | fa6ad9343f41 | 513MB | 513.2MB | 调度与工具 |
| 51 | whyour/qinglong:debian | fb2953a71260 | 881MB | 880.7MB | 调度与工具 |
| 52 | 99sono/99sono-public-repo:dev-environment-1.0.0-SNAPSHOT | a7cf7e38f0f3 | 5.64GB | 5.636GB | 调度与工具 |
| 53 | katorlys/workspace-all:latest | 4663edac9aef | 8.72GB | 8.724GB | 其他 |
| 54 | miguerubsk/factorio-headless:2.1.14 | ef508222a0e5 | 987MB | 986.6MB | 其他 |
| 55 | palemoky/chinese-poetry-api:latest | 0de9bf0fde3e | 64.4MB | 51.47MB | 其他 |
存放于 harbor-test.***.cn(DCE5 测试环境 Harbor 仓库),与当前 kbs-weknora 项目(检索增强知识库)的 CI/CD 构建链和运行时直接相关。
白嫖了差不多有10年出头的有道云笔记,最开始也为同步丢失烦恼过,因没有备份更换电脑丢失了就丢失了,好在有道云笔记后续稳定些了。但是随着AI的加持,有道云这种传统笔记有心无力,虽然有道云也在不停的迭代增加AI,但是没有个人整理的一些skill好用,2025年下半年就想迁移了,但是一直因为量大且没有很好的导出工具搁置,上半年发现github上有大佬开放了有道云笔记导出markdown格式的工具,于是便抱着试一试的心态,结合cc测试修复了一些细节问题,这次总算是完整的把笔记全部导出好了,记录下导出工具的用法
……用 Claude Code 做日常开发,四类可扩展资源(skill、agent、plugin、mcp)装多了之后经常要盘点「我到底装了什么」。这篇汇总最常用的查看命令和一个高频启动参数。
1. 查看已安装的 skill
|
|
2. 查看已安装的 agent
|
|
3. 查看已安装的 plugin
……本文档介绍 .claude/skills/ 目录下各个技能(skill)的功能和用途,以表格形式呈现,方便快速查阅。
| 技能名称 | 功能描述 | 用途场景 | 关键特性 |
|---|---|---|---|
| swagger-doc-generator | 为 Java Spring Boot 项目生成 OpenAPI/Swagger 文档 | 当需要生成 REST API 文档时触发 | 分析 Controller 代码、注解和 DTO,生成符合 OpenAPI 3.0 规范的 YAML/JSON 文件 |
| 技能名称 | 功能描述 | 用途场景 | 关键特性 |
|---|---|---|---|
| drawio | 创建 draw.io 图表(.drawio 文件) | 流程图、架构图、ER 图、序列图、类图、网络图、线框图 | 支持导出 PNG/SVG/PDF,生成 mxGraphModel XML 格式 |
| excalidraw-diagram | 生成 Excalidraw 图表 | 手绘风格图表、流程图、思维导图 | 支持 Obsidian/Standard/Animated 三种输出模式 |
| mermaid-visualizer | 将文本转换为 Mermaid 图表 | 流程图、系统架构、对比图、思维导图 | 支持 Process Flow、Circular Flow、Comparison、Mindmap、Sequence、State 等类型 |
| graphviz | 使用 DOT 语言创建有向/无向图 | 依赖树、调用图、包层级结构 | 使用 digraph 或 graph,自动布局 |
| canvas | 创建 JSON 格式的自由定位画布 | 概念图、知识图、规划板 | 支持节点(text/file/link/group)和边连接,Obsidian Canvas 兼容 |
| 技能名称 | 功能描述 | 用途场景 | 关键特性 |
|---|---|---|---|
| architecture | 创建分层系统架构图(HTML/CSS) | 技术栈、微服务拓扑、多层应用设计 | 12 种配色风格(Steel Blue、Ember Warm、Neon Dark 等)+ 12 种布局模式 |
| uml | 创建 UML 图表 | 类图、序列图、活动图、状态图、组件图等 | 使用 PlantUML 语法,支持 9500+ mxgraph stencil 图标 |
| cloud | 创建云架构图(AWS/Azure/GCP/阿里云) | 多云拓扑、迁移蓝图 | 支持 AWS、Azure、GCP、阿里云、IBM、Kubernetes、OpenStack |
| network | 创建网络拓扑图 | LAN/WAN、数据中心互联、物理/逻辑网络设计 | 支持 Cisco、Citrix 等网络设备图标 |
| security | 创建安全架构图 | IAM 流程、零信任模型、加密管道、威胁检测 | 包含身份访问、加密、网络安全、合规审计等图标 |
| data-analytics | 创建数据分析和 ETL 架构图 | 数据湖、实时流处理、数据仓库、BI 仪表盘 | 支持 AWS 分析服务(Athena、Glue、Kinesis、Redshift 等) |
| iot | 创建物联网架构图 | 智能家居、工业物联网、边缘计算、传感器网络 | 支持设备管理、边缘网关、数字孪生等 |
| archimate | 创建 ArchiMate 企业架构图 | TOGAF 视图、分层 EA 建模、业务/应用/技术层 | 支持业务、应用、技术、动机、实现层 |
| 技能名称 | 功能描述 | 用途场景 | 关键特性 |
|---|---|---|---|
| bpmn | 创建业务流程图(BPMN/EIP/精益映射) | 工作流自动化、审批链、消息集成模式、价值流映射 | 支持 BPMN 事件、网关、任务,EIP 消息模式 |
| mindmap | 创建层级思维导图 | 头脑风暴、主题分解、学习笔记、决策树 | 使用 PlantUML @startmindmap 语法,自动径向布局 |
| infographic | 创建基于模板的信息图 | KPI 仪表盘、时间线、路线图、SWOT 分析、漏斗图 | 使用简化的空格分隔语法,预置 40+ 模板 |
| 技能名称 | 功能描述 | 用途场景 | 关键特性 |
|---|---|---|---|
| infocard | 创建信息卡片(HTML/CSS 编辑风格) | 知识摘要、数据亮点、活动公告、杂志级排版 | 30+ 风格模板 + 30+ 布局骨架 |
| ppt-master | AI 驱动生成 PPT 演示文稿 | 从 PDF/DOCX/URL/Markdown 生成 PPTX | 多步骤串行流程:源处理 → 项目初始化 → 模板选择 → 策略设计 → SVG 生成 → 导出 |
| 技能名称 | 功能描述 | 用途场景 | 关键特性 |
|---|---|---|---|
| vega | 创建 Vega/Vega-Lite 图表 | 统计可视化:柱状图、折线图、散点图、热力图、雷达图 | 使用声明式 JSON 语法,90% 场景用 Vega-Lite |
| 技能名称 | 功能描述 | 用途场景 | 关键特性 |
|---|---|---|---|
| find-skills | 发现和安装代理技能 | 当用户询问"如何做 X"或寻找技能时使用 | 搜索 Skills CLI (npx skills) 和 Skillhub 生态系统的技能 |
| api-conventions | REST API 设计规范 | 定义 API 设计标准 | URL kebab-case、JSON camelCase、分页支持、API 版本化 |
| obsidian-canvas-creator | 创建 Obsidian Canvas 文件 | 交互式画布、心智图、空间化信息组织 | 支持 MindMap 和 Freeform 两种布局 |
| 技能 | 触发词 |
|---|---|
| swagger-doc-generator | Swagger、OpenAPI、API文档、生成接口文档 |
| drawio | draw、diagram、flowchart、architecture、.drawio 文件 |
| excalidraw-diagram | Excalidraw、画图、流程图、思维导图、可视化 |
| ppt-master | create PPT、make presentation、生成PPT、做PPT |
| infographic | KPI、timeline、roadmap、SWOT、funnel、comparison |
| 技能 | 代码 fence 标识符 |
|---|---|
| uml / cloud / network / security / bpmn / iot / data-analytics / archimate / mindmap | ```plantuml 或 ```puml |
| mermaid-visualizer | ```mermaid |
| graphviz | ```dot |
| vega | ```vega-lite 或 ```vega |
| canvas | ```canvas |
| infographic | ```infographic |
| 技能名称 | 功能描述 | 用途场景 | 关键特性 |
|---|---|---|---|
| swagger-doc-generator | 为 Java Spring Boot 项目生成 OpenAPI/Swagger 文档 | 当需要生成 REST API 文档时触发 | 分析 Controller 代码、注解和 DTO,生成符合 OpenAPI 3.0 规范的 YAML/JSON 文件 |
| 技能名称 | 功能描述 | 用途场景 | 关键特性 |
|---|---|---|---|
| drawio | 创建 draw.io 图表(.drawio 文件) | 流程图、架构图、ER 图、序列图、类图、网络图、线框图 | 支持导出 PNG/SVG/PDF,生成 mxGraphModel XML 格式 |
| excalidraw-diagram | 生成 Excalidraw 图表 | 手绘风格图表、流程图、思维导图 | 支持 Obsidian/Standard/Animated 三种输出模式 |
| mermaid-visualizer | 将文本转换为 Mermaid 图表 | 流程图、系统架构、对比图、思维导图 | 支持 Process Flow、Circular Flow、Comparison、Mindmap、Sequence、State 等类型 |
| graphviz | 使用 DOT 语言创建有向/无向图 | 依赖树、调用图、包层级结构 | 使用 digraph 或 graph,自动布局 |
| canvas | 创建 JSON 格式的自由定位画布 | 概念图、知识图、规划板 | 支持节点(text/file/link/group)和边连接,Obsidian Canvas 兼容 |
| 技能名称 | 功能描述 | 用途场景 | 关键特性 |
|---|---|---|---|
| architecture | 创建分层系统架构图(HTML/CSS) | 技术栈、微服务拓扑、多层应用设计 | 12 种配色风格 + 12 种布局模式 |
| uml | 创建 UML 图表 | 类图、序列图、活动图、状态图、组件图等 | 使用 PlantUML 语法,支持 9500+ mxgraph stencil 图标 |
| cloud | 创建云架构图(AWS/Azure/GCP/阿里云) | 多云拓扑、迁移蓝图 | 支持 AWS、Azure、GCP、阿里云、IBM、Kubernetes、OpenStack |
| network | 创建网络拓扑图 | LAN/WAN、数据中心互联、物理/逻辑网络设计 | 支持 Cisco、Citrix 等网络设备图标 |
| security | 创建安全架构图 | IAM 流程、零信任模型、加密管道、威胁检测 | 包含身份访问、加密、网络安全、合规审计等图标 |
| data-analytics | 创建数据分析和 ETL 架构图 | 数据湖、实时流处理、数据仓库、BI 仪表盘 | 支持 AWS 分析服务 |
| iot | 创建物联网架构图 | 智能家居、工业物联网、边缘计算、传感器网络 | 支持设备管理、边缘网关、数字孪生等 |
| archimate | 创建 ArchiMate 企业架构图 | TOGAF 视图、分层 EA 建模 | 支持业务、应用、技术、动机、实现层 |
| 技能名称 | 功能描述 | 用途场景 | 关键特性 |
|---|---|---|---|
| bpmn | 创建业务流程图(BPMN/EIP/精益映射) | 工作流自动化、审批链、消息集成模式 | 支持 BPMN 事件、网关、任务,EIP 消息模式 |
| mindmap | 创建层级思维导图 | 头脑风暴、主题分解、学习笔记、决策树 | 使用 PlantUML @startmindmap 语法,自动径向布局 |
| infographic | 创建基于模板的信息图 | KPI 仪表盘、时间线、路线图、SWOT 分析、漏斗图 | 使用简化的空格分隔语法,预置 40+ 模板 |
| 技能名称 | 功能描述 | 用途场景 | 关键特性 |
|---|---|---|---|
| infocard | 创建信息卡片(HTML/CSS 编辑风格) | 知识摘要、数据亮点、活动公告、杂志级排版 | 30+ 风格模板 + 30+ 布局骨架 |
| ppt-master | AI 驱动生成 PPT 演示文稿 | 从 PDF/DOCX/URL/Markdown 生成 PPTX | 多步骤串行流程 |
| 技能名称 | 功能描述 | 用途场景 | 关键特性 |
|---|---|---|---|
| vega | 创建 Vega/Vega-Lite 图表 | 统计可视化:柱状图、折线图、散点图、热力图、雷达图 | 使用声明式 JSON 语法 |
| 技能名称 | 功能描述 | 用途场景 | 关键特性 |
|---|---|---|---|
| find-skills | 发现和安装代理技能 | 当用户询问"如何做 X"或寻找技能时使用 | 搜索 Skills CLI 和 Skillhub 生态系统的技能 |
| api-conventions | REST API 设计规范 | 定义 API 设计标准 | URL kebab-case、JSON camelCase、分页支持、API 版本化 |
| obsidian-canvas-creator | 创建 Obsidian Canvas 文件 | 交互式画布、心智图、空间化信息组织 | 支持 MindMap 和 Freeform 两种布局 |
更多详细使用说明请参考各技能目录下的
……skill.md文件。