Update from Sync Service

2026-04-21 15:10:48 +08:00
parent 25667f6588
commit dd5f53e7d4
21 changed files with 1237 additions and 730 deletions
--- a/实践积累/工具技能/Docker
+++ b/实践积累/工具技能/Docker
@@ -1,7 +1,160 @@
-<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
-<html><head>
-<title>404 Not Found</title>
-</head><body>
-<h1>Not Found</h1>
-<p>The requested URL was not found on this server.</p>
-</body></html>
+---
+title: Docker一键部署Clash Meta (mihomo) + metacubexd面板教程
+date: 2026-01-13
+tags:
+  - Linux系统Docker
+  - Docker
+  - Clash
+  - mihomo
+  - metacubexd
+  - 代理
+  - 网络
+source: https://www.cloud-guest.top/archives/gS23mQ65
+---
+
+# Docker 一键部署 Clash Meta (mihomo) + metacubexd 面板教程（2026 年最新版）
+
+**目标：** 使用最新 MetaCubeX/mihomo 内核 + 官方 metacubexd Web 面板，实现稳定、高性能的代理服务
+
+**适用环境：** Linux 服务器 / NAS（推荐 Ubuntu/Debian），已安装 Docker + Docker Compose
+
+**核心特点：**
+- 使用 `network_mode: host`（TUN/透明代理最稳）
+- 容器别名统一为 `clash`（核心）+ `dashboard`（面板），操作更友好
+- 提前处理 Country.mmdb 避免经典报错
+
+## 1. 准备工作
+
+安装 Docker & Docker Compose（如果未安装，一键执行）：
+
+```bash
+# Ubuntu/Debian 推荐方式（2026 年最新）
+curl -fsSL https://get.docker.com | sudo sh
+sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
+sudo chmod +x /usr/local/bin/docker-compose
+sudo usermod -aG docker $USER
+```
+
+创建项目目录：
+
+```bash
+mkdir -p ~/mihomo && cd ~/mihomo
+```
+
+## 2. 提前下载 GeoIP 数据库（必须！避免 not a directory 错误）
+
+mihomo 需要 Country.mmdb（文件，不是文件夹）
+
+```bash
+mkdir -p config
+cd config
+
+# 轻量版 country-lite.mmdb（体积小 ≈1-2MB）
+curl -L https://github.com/MetaCubeX/meta-rules-dat/releases/latest/download/country-lite.mmdb \
+     -o Country.mmdb
+```
+
+**关键：** 启动前这个路径必须存在文件，否则 Docker 会自动创建成目录导致启动失败。
+
+## 3. docker-compose.yml（完整配置）
+
+```yaml
+version: '3.8'
+
+services:
+  clash:
+    container_name: clash
+    image: metacubex/mihomo:Alpha
+    restart: unless-stopped
+    network_mode: host
+    pid: host
+    ipc: host
+    cap_add:
+      - ALL
+    volumes:
+      - ./config:/root/.config/mihomo
+      - /dev/net/tun:/dev/net/tun
+      - /etc/localtime:/etc/localtime:ro
+
+  dashboard:
+    container_name: dashboard
+    image: ghcr.io/metacubex/metacubexd:latest
+    restart: unless-stopped
+    network_mode: host
+```
+
+## 4. 准备 mihomo 主配置文件 config.yaml
+
+```yaml
+# 基本端口与访问
+mixed-port: 7890
+allow-lan: true
+external-controller: 0.0.0.0:9090
+secret: ""
+
+mode: rule
+log-level: info
+geodata-mode: false
+geo-auto-update: true
+geo-update-interval: 24
+
+proxy-providers:
+  my-sub:
+    type: http
+    url: "https://你的机场订阅链接"
+    path: ./subscriptions/my-sub.yaml
+    interval: 86400
+    health-check:
+      enable: true
+      url: "https://www.gstatic.com/generate_204"
+      interval: 300
+
+proxy-groups:
+  - name: "自动选择"
+    type: url-test
+    include-all: true
+    url: "http://www.gstatic.com/generate_204"
+    interval: 300
+
+rules:
+  - MATCH,自动选择
+```
+
+## 5. 启动与常用命令
+
+```bash
+# 首次启动
+docker compose up -d
+
+# 查看核心日志
+docker compose logs -f clash
+
+# 重启核心
+docker compose restart clash
+
+# 更新镜像并重启
+docker compose pull && docker compose up -d
+
+# 停止+删除容器
+docker compose down
+```
+
+## 6. 访问方式
+
+- **Web 面板：** http://你的服务器IP（host模式默认80端口）
+- **连接后端：** http://127.0.0.1:9090
+- **代理端口：** HTTP/SOCKS5混合端口 7890
+
+## 7. 常见问题
+
+| 问题 | 解决方案 |
+|------|---------|
+| not a directory | Country.mmdb必须是文件，步骤2已解决 |
+| 面板连不上 | 确认external-controller是0.0.0.0:9090 |
+| TUN不工作 | 必须host模式 + /dev/net/tun挂载 |
+
+## 8. 推荐资源
+
+- mihomo仓库：https://github.com/MetaCubeX/mihomo
+- metacubexd面板：https://github.com/MetaCubeX/metacubexd
+- 官方文档：https://wiki.metacubex.one/
--- a/实践积累/工具技能/MeNav导航站.md
+++ b/实践积累/工具技能/MeNav导航站.md
@@ -1,7 +1,86 @@
-<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
-<html><head>
-<title>404 Not Found</title>
-</head><body>
-<h1>Not Found</h1>
-<p>The requested URL was not found on this server.</p>
-</body></html>
+---
+title: MeNav 个人导航站生成器
+tags:
+  - 开源
+  - 导航站
+  - 静态网站
+  - GitHubPages
+  - 书签管理
+created: 2026-04-21
+source: https://github.com/rbetree/menav
+stars: 256
+forks: 167
+language: JavaScript
+---
+
+# MeNav
+
+> 一键部署的个人导航站生成器，支持书签导入与自动构建
+
+## 概述
+
+轻量级、高度可定制的个人导航网站生成器，完全静态部署，无需数据库和后端服务。
+
+### 核心功能
+
+- 🔖 浏览器书签一键导入（HTML → YAML）
+- 🚀 GitHub Pages 一键部署（Fork + Actions）
+- 🔄 MarksVault 扩展集成，自动同步书签
+- 🎨 明亮 / 黑暗双主题，响应式布局
+- 🐳 Docker 部署支持
+- 📁 2-4 层多层级嵌套分类结构
+
+**预览**: https://rbetree.github.io/menav/
+
+## 技术栈
+
+- HTML5 + CSS3 + JavaScript（原生）
+- Handlebars 模板引擎
+- Google Favicon API + Font Awesome 图标
+
+## 安装使用
+
+```bash
+git clone https://github.com/rbetree/menav.git
+cd menav
+npm install
+npm run dev          # 本地预览
+npm run build        # 构建静态文件
+```
+
+## 书签导入
+
+```bash
+npm run import-bookmarks
+# 放入 HTML 格式书签 → 自动转换为 config/user/pages/bookmarks.yml
+```
+
+## 部署方式
+
+| 方式 | 说明 |
+|------|------|
+| **GitHub Pages（推荐）** | Fork → 启用 Actions → 提交配置 → 自动部署 |
+| **Vercel / Netlify / Cloudflare Pages** | Build: `npm run build` / Output: `dist/` |
+| **Docker** | `docker compose up -d` |
+| **自建服务器** | `npm run build` → 复制 `dist/` → nginx/Apache |
+
+## 定时更新
+
+- RSS 文章聚合自动刷新
+- GitHub Actions 默认每天 UTC 02:00 触发
+
+## 评分
+
+⭐⭐⭐⭐（4/5）
+
+**优点**：
+- 零成本部署（GitHub Pages）
+- 书签导入 + 自动同步，工作流完整
+- 主题美观，响应式设计
+- 模块化配置，易于定制
+
+**局限**：
+- 需要 GitHub 生态（书签同步依赖 Actions）
+- 书签导入格式有要求
+
+**适合场景**：个人主页、浏览器起始页、书签整理
--- a/实践积累/工具技能/code-reviewer技能.md
+++ b/实践积累/工具技能/code-reviewer技能.md
@@ -1,7 +1,242 @@
-<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
-<html><head>
-<title>404 Not Found</title>
-</head><body>
-<h1>Not Found</h1>
-<p>The requested URL was not found on this server.</p>
-</body></html>
+---
+title: Code Reviewer 代码审查专家技能
+tags:
+  - AI-Skill
+  - Code-Review
+  - TDD
+  - Java
+  - Security
+created: 2026-04-12
+source: 用户分享的SKILL文件
+---
+
+# Code Reviewer 代码审查专家
+
+> 经验丰富的代码审查者，遵循业界最佳实践，提供专业的代码评估和改进建议。
+
+## 审查重点
+
+| 维度       | 内容                     |
+| -------- | ---------------------- |
+| **代码质量** | 命名规范、代码复杂度、重复代码        |
+| **安全性**  | SQL 注入风险、XSS 漏洞、认证授权问题 |
+| **性能**   | 算法效率、资源使用、缓存策略         |
+| **可维护性** | 代码注释、模块化设计、测试覆盖        |
+
+## 审查流程
+
+1. 理解代码变更的目的
+2. 检查代码风格和规范
+3. 分析潜在的 Bug 和性能问题
+4. 验证安全性
+5. 提供建设性的改进建议
+
+---
+
+## 问题报告规范
+
+每个问题必须包含以下**精确位置信息**：
+
+| 字段 | 说明 | 示例 |
+|------|------|------|
+| 文件路径 | 相对于项目根目录的完整路径 | `com/example/UserServiceImpl.java` |
+| 行号范围 | 问题代码的起止行号 | `L45-L52` 或 `L45` |
+| 类名 | 问题所在的类名 | `UserServiceImpl` |
+| 方法名 | 问题所在的方法签名 | `getUserById(Long userId)` |
+| 代码片段 | 有问题的具体代码（前后各 2-3 行上下文） | 见示例 |
+
+### 问题输出格式
+
+```
+🔴 [严重] SQL注入风险
+📁 文件: com/example/UserServiceImpl.java
+📍 位置: L45-L48 | 类: UserServiceImpl | 方法: findByUsername(String)
+
+🔗 代码上下文:
+   44 |     public User findByUsername(String username) {
+   45 |         String sql = "SELECT * FROM user WHERE username = '" + username + "'";
+   46 |         return jdbcTemplate.queryForObject(sql, userMapper);
+   47 |     }
+
+💡 问题说明: 直接拼接用户输入到SQL语句中，存在SQL注入风险
+
+✅ 修复建议:
+   String sql = "SELECT * FROM user WHERE username = ?";
+   return jdbcTemplate.queryForObject(sql, userMapper, username);
+```
+
+### 严重程度分级
+
+| 级别 | 含义 |
+|------|------|
+| 🔴 严重 | 需要立即修复的问题 |
+| 🟡 中等 | 建议修复的问题 |
+| 🟢 轻微 | 可选的改进建议 |
+
+---
+
+## 输出格式
+
+### 文本报告
+
+```
+✅ 优点：列出做得好的地方
+
+⚠️ 问题：
+   [级别] 问题标题
+   📁 文件: 完整文件路径
+   📍 位置: L行号 | 类: 类名 | 方法: 方法签名
+   🔗 代码上下文: (带行号的代码片段)
+   💡 问题说明: 详细描述
+   ✅ 修复建议: 具体的修复方案或示例代码
+
+📊 总体评分：1-10 分
+```
+
+### HTML 报告（自动生成）
+
+当用户要求审查代码时，**自动生成 HTML 报告**：
+
+- 文件名格式：`code-review-report-{timestamp}.html`
+- 保存到工作区根目录
+- 包含评分圆环、四维评分卡片、问题详情卡片
+- 代码上下文：IDE 风格行号 + 问题行高亮
+
+---
+
+## 典型问题示例
+
+### 1. SQL 注入（🔴 严重）
+
+```
+📁 文件: UserServiceImpl.java
+📍 位置: L45-L48 | 类: UserServiceImpl | 方法: findByUsername(String)
+
+🔗 代码上下文:
+→ 45 |         String sql = "SELECT * FROM sys_user WHERE user_name = '" + username + "'";
+→ 46 |         return jdbcTemplate.queryForObject(sql, userMapper);
+
+✅ 修复建议: 使用参数化查询
+   String sql = "SELECT * FROM sys_user WHERE user_name = ?";
+   return jdbcTemplate.queryForObject(sql, userMapper, username);
+```
+
+### 2. 循环内重复查询（🟡 中等）
+
+```
+📍 位置: L112-L118 | 类: TaskServiceImpl | 方法: batchProcess(List<Task>)
+
+🔗 代码上下文:
+   110 |     public void batchProcess(List<Task> tasks) {
+   111 |         for (Task task : tasks) {
+→ 112 |             Device device = deviceMapper.selectById(task.getDeviceId());
+→ 113 |             task.setDeviceName(device.getName());
+   114 |             taskMapper.updateById(task);
+   115 |         }
+   116 |     }
+
+✅ 修复建议: 批量查询 + Map 缓存
+   Set<Long> deviceIds = tasks.stream().map(Task::getDeviceId).collect(toSet());
+   Map<Long, Device> deviceMap = deviceMapper.selectBatchIds(deviceIds)
+       .stream().collect(toMap(Device::getId, d -> d));
+   tasks.forEach(task -> task.setDeviceName(deviceMap.get(task.getDeviceId()).getName()));
+```
+
+### 3. 资源泄漏（🔴 严重）
+
+```
+📍 位置: L56-L62 | 类: DataHandler | 方法: processData(Connection)
+
+🔗 代码上下文:
+→ 56 |             Statement stmt = conn.createStatement();
+→ 57 |             ResultSet rs = stmt.executeQuery("SELECT * FROM data");
+   58 |             // 处理数据...
+   59 |         } catch (SQLException e) {
+   60 |             log.error("处理失败", e);
+   61 |         }
+
+✅ 修复建议: 使用 try-with-resources
+   try (Statement stmt = conn.createStatement();
+        ResultSet rs = stmt.executeQuery("SELECT * FROM data")) {
+       // 处理数据...
+   }
+```
+
+### 4. 空指针风险（🟡 中等）
+
+```
+📍 位置: L89-L92 | 类: DeviceServiceImpl | 方法: getDeviceStatus(Long)
+
+🔗 代码上下文:
+→ 89 |         return device.getStatus().getName();
+
+✅ 修复建议:
+   Device device = deviceMapper.selectById(deviceId);
+   if (device == null) throw new ServiceException("设备不存在: " + deviceId);
+   return Optional.ofNullable(device.getStatus()).map(Status::getName).orElse("未知状态");
+```
+
+### 5. 命名不规范（🟢 轻微）
+
+```
+📍 位置: L79 | 类: UserServiceImpl | 方法: f(UserQuery)
+
+🔗 代码上下文:
+→ 79 |     public List<User> f(UserQuery query) {
+
+✅ 修复建议: 重命名为 selectUserList 或 queryUserList
+```
+
+---
+
+## 评分标准
+
+### 总体评分（1-10 分）
+
+| 分数 | 评价 |
+|------|------|
+| 9-10 | 优秀，代码质量高，几乎没有问题 |
+| 7-8 | 良好，有少量改进空间 |
+| 5-6 | 中等，存在一些需要修复的问题 |
+| 3-4 | 较差，有较多问题需要解决 |
+| 1-2 | 很差，存在严重问题 |
+
+---
+
+## 使用方法
+
+当用户说"审查代码"或"review 这个文件"时：
+
+1. 仔细分析代码，记录每个问题的精确位置
+2. 使用 Read/Grep 工具确认代码位置和上下文
+3. 识别问题和优点，为每个问题收集：文件路径、行号范围、类名、方法签名、代码片段
+4. 生成详细的 HTML 报告
+5. 告知用户报告已生成并可以查看
+
+---
+
+## 代码位置识别指南
+
+### 行号标注规范
+
+| 类型 | 格式 | 示例 |
+|------|------|------|
+| 单行问题 | `L45` | `L45` |
+| 连续多行 | `L45-L52` | `L45-L52` |
+| 不连续多行 | `L45, L48, L52` | `L45, L48, L52` |
+
+### 代码上下文格式
+
+```
+   行号 | 代码内容
+   -----|----------------------------------------
+    43  |     @Override
+    44  |     public User getUserById(Long userId) {
+→   45  |         String sql = "SELECT * FROM user WHERE id = " + userId;
+    46  |         return jdbcTemplate.queryForObject(sql, userMapper);
+    47  |     }
+```
+
+- 使用 `→` 标记问题行
+- 保留前后 2-3 行上下文
+- 行号右对齐，保持整齐
--- a/实践积累/工具技能/fireworks-tech-graph.md
+++ b/实践积累/工具技能/fireworks-tech-graph.md
@@ -1,7 +1,114 @@
-<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
-<html><head>
-<title>404 Not Found</title>
-</head><body>
-<h1>Not Found</h1>
-<p>The requested URL was not found on this server.</p>
-</body></html>
+---
+title: fireworks-tech-graph 技术图生成工具
+tags:
+  - AI工具
+  - 技术图
+  - SVG
+  - ClaudeCode-Skill
+  - 开源
+created: 2026-04-21
+source: https://github.com/yizhiyanhua-ai/fireworks-tech-graph
+stars: 3862
+forks: 338
+language: Python
+---
+
+# fireworks-tech-graph
+
+> 不用手画图了。用中文描述你的系统，几秒钟得到可直接发布的 **SVG + PNG** 技术图。
+
+## 概述
+
+将自然语言描述转化为精美的 SVG 技术图，并通过 `rsvg-convert` 导出高分辨率 PNG。内置 **7 种视觉风格**，深度覆盖 AI/Agent 领域常见图类型，并完整支持全部 14 种 UML 图类型。
+
+## 7 种视觉风格
+
+| # | 名称 | 背景色 | 字体 | 适用场景 |
+|---|------|--------|------|----------|
+| 1 | 扁平图标风（默认） | `#ffffff` | Helvetica | 博客、幻灯片、技术文档 |
+| 2 | 暗黑极客风 | `#0f0f1a` | SF Mono / Fira Code | GitHub README、开发者文章 |
+| 3 | 工程蓝图风 | `#0a1628` | Courier New | 架构设计文档、工程规范 |
+| 4 | Notion 极简风 | `#ffffff` | system-ui | Notion、Confluence、内部 Wiki |
+| 5 | 玻璃态卡片风 | `#0d1117` 渐变 | Inter | 产品官网、演讲 Keynote |
+| 6 | Claude 官方风格 | `#f8f6f3` | system-ui | Anthropic 风格图表 |
+| 7 | OpenAI 官方风格 | `#ffffff` | system-ui | OpenAI 风格图表 |
+
+## 支持的图类型
+
+### AI/Agent 领域（内置 Pattern）
+
+| 类型 | 流程 |
+|------|------|
+| RAG Pipeline | Query → Embed → VectorSearch → Retrieve → LLM → Response |
+| Agentic RAG | RAG + Agent 循环 + 工具调用 |
+| Agentic Search | Query → Planner → [Search/Calc/Code] → Synthesizer |
+| Mem0 记忆层 | Input → Memory Manager → [VectorDB + GraphDB] → Context |
+| Multi-Agent | Orchestrator → [SubAgent×N] → Aggregator → Output |
+| Tool Call 流程 | LLM → Tool Selector → Execution → Parser → LLM（循环） |
+
+### UML 支持（14 种）
+
+类图、组件图、部署图、包图、复合结构图、对象图、用例图、活动图、状态机图、序列图、通信图、时序图、交互概览图、ER 图
+
+## 形状词汇表
+
+| 概念 | 形状 |
+|------|------|
+| 用户 / 人类 | 圆形 + 身体路径 |
+| LLM / 模型 | 圆角矩形，双边框，⚡ |
+| Agent / 编排器 | 六边形 |
+| 短期记忆 | 虚线边框圆角矩形 |
+| 长期记忆 | 实线圆柱体 |
+| Vector Store | 带内环圆柱 |
+| Graph DB | 三圆簇 |
+| 工具 / 函数 | 带 ⚙ 的矩形 |
+| API / 网关 | 六边形（单边框） |
+| 消息队列 / 流 | 横向管道 |
+| 决策节点 | 菱形 |
+
+## 箭头语义
+
+| 流类型 | 样式 | 含义 |
+|--------|------|------|
+| 主数据流 | 2px 实线 | 主要请求/响应路径 |
+| 控制 / 触发 | 1.5px 实线 | 系统 A 触发 B |
+| 记忆读取 | 1.5px 实线 | 从存储检索 |
+| 记忆写入 | 1.5px 虚线 `5,3` | 写入/存储操作 |
+| 异步 / 事件 | 1.5px 虚线 `4,2` | 非阻塞 |
+| 反馈 / 循环 | 1.5px 曲线 | 迭代推理 |
+
+## 安装
+
+```bash
+npx skills add yizhiyanhua-ai/fireworks-tech-graph
+
+# 依赖
+brew install librsvg  # macOS
+sudo apt install librsvg2-bin  # Ubuntu/Debian
+```
+
+## 使用方式
+
+触发词：`画图 / 帮我画 / 生成图 / 做个图 / 架构图 / 流程图`
+
+```text
+画一张 RAG 流程图
+生成一张 Agentic Search 架构图
+画一张微服务架构图，风格2（暗黑极客风）
+```
+
+## 评分
+
+⭐⭐⭐⭐⭐（5/5）
+
+**优点**：
+- 7 种风格覆盖所有场景
+- 内置 AI/Agent 领域知识，开箱即用
+- 语义形状 + 箭头系统，图示专业
+- 中文支持友好
+
+**局限**：
+- 需要 Claude Code 或兼容 Skill 运行时
+- 依赖 rsvg-convert 工具
+
+**适合场景**：技术博客配图、架构文档、PPT 素材、GitHub README