教程

OpenSpec 的使用教程 OpenSpec 是一个面向 AI 编程助手的规格驱动开发工具。它的核心思路不是一上来就让 AI 改代码，而是先把“要做什么、为什么做、怎么验收、分几步做”沉淀成文档，再让 AI 根据这些文档实施。 如果你经常让 AI 帮你改项目，应该遇到过这类问题： 一开始说的是 A，AI 改着改着变成了 B。 需求没写清楚，代码实现出来才发现方向不对。 一个会话里聊明白了，换一个新会话后上下文又丢了。 功能做完了，但没有把设计和决策沉淀下来。 OpenSpec 解决的是这个过程问题。它会把每次变更放到 openspec/changes/ 下面，用 proposal.md、design.md、specs/、tasks.md 这类文件记录上下文。这样你、AI、后续的新会话都能围绕同一套文档继续工作。 这篇文章用一个 Hugo 博客的小 demo 来讲 OpenSpec 的基本用法：假设我们想给博客新增一个“文章底部推荐阅读”功能。 1. 安装 OpenSpec OpenSpec 当前推荐使用 Node.js 环境安装。先确认本机 Node.js 版本： 1 node --version 官方文档要求 Node.js 20.19.0 或更高版本。如果版本太低，建议先通过 nvm、fnm、Homebrew 或系统包管理器升级 Node.js。 使用 npm 全局安装： 1 npm install -g @fission-ai/openspec@latest 也可以使用 pnpm、yarn 或 bun： 1 2 3 pnpm install -g @fission-ai/openspec@latest yarn global add @fission-ai/openspec@latest bun install -g @fission-ai/openspec@latest 安装完成后检查版本： ...

Claude Code 连接 DeepSeek 完整教程 Claude Code 默认走 Anthropic 的接口，如果想让它使用 DeepSeek 作为后端模型，可以在本机起一个 LiteLLM 代理： 1 Claude Code -> LiteLLM -> DeepSeek API 简单理解： Claude Code：我们平时在终端里用的 claude 命令。 LiteLLM：本地代理，把 Claude Code 发来的 Anthropic 格式请求转换成 DeepSeek 能理解的请求。 DeepSeek API：真正负责推理和生成结果的模型服务。 本文以 macOS 为例，Windows / Linux 的思路也一样，只是安装命令略有区别。 说明：DeepSeek 官方现在已经提供 Anthropic 兼容接口，简单场景可以直接连 https://api.deepseek.com/anthropic。本文仍然使用 LiteLLM，是因为 LiteLLM 更方便做模型别名、统一密钥、日志、后续切换其他模型服务。 1. 准备工作 你需要准备： 一台能正常访问 DeepSeek API 的电脑。 一个 DeepSeek 平台账号。 Python 3.10+，用于安装 LiteLLM。 Node.js 18+，用于安装 Claude Code。 一个终端工具，macOS 自带 Terminal 或 iTerm2 都可以。 先检查本机环境： ...

Terraria Server Docker 教程 教你学会如何把 Terraria Linux 服务端打成 Docker 镜像，并用 Docker Compose 在 x86_64 Linux 服务器运行。本教程从 Dockerfile、启动脚本到 docker-compose.yml，一步步解释原理与用法，并包含多实例部署方式。 首先在泰拉瑞亚服务端下载页面最下方点击PC Dedicated Server下载服务端 目录结构 Dockerfile：镜像构建文件（原生运行） entrypoint.sh：启动脚本，自动生成 serverconfig.txt docker-compose.yml：单实例编排 docker-compose.multi.yml：多实例编排（普通/专家/大师） data/ / data-normal / data-expert / data-master：持久化目录 一、Dockerfile：把服务端打进镜像 Dockerfile 的核心目标是： 选择基础Linux镜像（这里是 Debian） 安装必要运行库 把服务端文件复制进去 设置启动脚本 Dockerfile 示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 # 基础镜像：Debian 稳定版（包含 glibc，兼容性好） FROM debian:bookworm-slim # 入口脚本需要的默认环境变量 ENV TERRARIA_HOME=/opt/terraria \ TERRARIA_DATA=/data # 安装运行原生服务端所需的运行库 # --no-install-recommends：减少镜像体积 # 清理 apt 缓存以减少镜像大小 RUN apt-get update \ && apt-get install -y --no-install-recommends \ ca-certificates \ libstdc++6 \ libgcc-s1 \ && rm -rf /var/lib/apt/lists/* # 设置容器内工作目录 WORKDIR ${TERRARIA_HOME} # 复制服务端文件到镜像内 COPY . ${TERRARIA_HOME} # 确保二进制可执行 RUN chmod +x /opt/terraria/TerrariaServer.bin.x86_64 # 拷贝启动脚本 COPY entrypoint.sh /entrypoint.sh RUN chmod +x /entrypoint.sh # 元信息：声明服务端监听端口 EXPOSE 7777/tcp # 声明数据卷：世界/配置放在 /data VOLUME ["/data"] # 容器启动时执行入口脚本 ENTRYPOINT ["/entrypoint.sh"] 关键点 libstdc++6 / libgcc-s1：Terraria 原生二进制依赖的运行库 VOLUME ["/data"]：让世界文件与配置落在数据卷（容器可删除，数据仍在） ENTRYPOINT：容器启动时执行脚本 二、entrypoint.sh：启动脚本与自动配置 目标： ...

终端复用神器对决：Tmux vs. Screen 全方位指南 在 Linux 远程运维或开发中，我们经常会遇到这样的问题：正在运行一个耗时几小时的任务，结果网络波动导致 SSH 断开，任务被迫中断。终端复用器（Terminal Multiplexer） 正是为此而生。 本文将深度对比老牌劲旅 Screen 与现代标杆 Tmux，并提供详细的使用教程。 核心概念：什么是终端复用？ 终端复用器的核心功能可以概括为： 会话保护：断开连接后，后台任务继续运行，重新登录后可“恢复（Attach）”现场。 分屏操作：在同一个窗口内切分成多个小窗口（Panes）。 多会话管理：同时开启多个独立的任务环境。 一、 Tmux vs. Screen 深度对比 特性 Screen Tmux 诞生时间 1987年 (历史悠久) 2007年 (现代主流) 默认前缀键 Ctrl + a Ctrl + b 配置灵活性 配置文件较复杂 极其灵活，支持复杂脚本 状态栏 基本没有，需繁琐配置 默认开启，信息极丰富 分屏能力 垂直/水平分屏支持较晚 原生支持极佳，支持无限嵌套 资源占用 极低 低 (略高于 Screen) 总结建议： 如果你经常需要分屏开发、自定义高度美化的状态栏，请首选 Tmux。 如果你在极其古老、资源极其受限的系统上工作，或者习惯了 Ctrl+a 的手感，Screen 依然是可靠的选择。 二、 Tmux 详细用法 Tmux 采用三层结构：Session（会话） > Window（窗口） > Pane（面板）。 ...

0. 前言 Mac mini M4 拥有顶级的单核性能和极小的体积，尤其是经过补贴之后16+256GB配置只需要3000左右的价格就能买到手，我宣布这就是最适合用来开MC的服务器主机。 本人尝试拿它开启了homestead服务器，是一个包含400+mod的整合包，实测前中期10人的情况下稳定运行压力不大（视距6，模拟距离8），奈何被家里的烂网制裁，只能转去第三方租赁面板服。 B站博主也有测试过，在MC服务器领域，完全不输i9-14900K，视频参考： 最适合开MC服务器的电脑？是不到4000块的M4 Mac Mini？！ 注意： 服务器性能没问题不代表你家网没问题，你在拥有Mac mini之前应该考虑是否有稳定的网络和足够的上行带宽！！ 1. Mac 系统防休眠设置 Macmini不连显示器的情况下断开SSH连接之后，它就美滋滋的睡过去了，只监听22端口有人连接才能正常运行，所以如果是当作MC服务器，请不要让它休眠。 开启远程访问 激活Mac mini后，在「系统设置」->「通用」->「共享」中，打开 远程登录 (SSH)。这样你就可以在其他电脑甚至手机上通过 ssh 随时管理你的服务器。 开启持久模式 (caffeinate) 在配置好远程连接之后，请在终端使用 caffeinate 命令。 -i: 防止系统计算睡眠。 -s: 防止系统在接通电源时睡眠。 -m: 防止磁盘睡眠。 -d:防止显示器休眠。 1 caffeinate -ism 2. 环境搭建 安装适配 M4 的 JDK 一定要用 ARM64 原生版本，否则性能损失巨大。推荐使用 Homebrew 安装： 1 2 3 4 5 # 安装 Homebrew (如果还没装) /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # 安装 Java 21 (适配 1.20.5+) brew install openjdk@21 3. 创建与启动服务器 准备文件夹：mkdir ~/MCServer && cd ~/MCServer ...