文章
记录技术实践、产品思考、读书笔记与项目复盘
共 286 篇文章 · 26 个分类
Pi Agent 使用指南：从安装到配置本地模型的完整教程
Pi 是轻量级终端 Coding Agent，支持多种大模型 provider。本文详细介绍了两种安装方式（官方脚本和 npm），以及通过 models.json、settings.json、auth.json 配置本地模型的方法，重点解决常见的 401 鉴权问题，并提供了可一键完成安装与配置的 shell 脚本，适合快速接入 OpenAI 兼容服务。
Git多远程仓库同步实战指南
同时使用多个远程仓库时，执行 git pull 后本地分支没有变化？本文将深入剖析问题根源——git pull 仅拉取到远程跟踪分支，不会自动合并。通过完整的测试流程（正常合并、冲突处理、dev分支同步）和详细步骤，帮助你掌握从拉取到推送的核心技巧，并附常见问题排查与最佳实践建议。
Ubuntu桌面一键代理脚本
在Ubuntu桌面环境下，临时使用代理却不影响全局设置？本文介绍两种仅当前终端生效的代理开启脚本：双击弹窗版和终端激活版，附带桌面快捷方式创建与验证方法。轻量无侵入，适合开发与日常使用。
Docker部署Code-server的两种方案
本文详细介绍两种在Docker中部署Code-server并打通Docker环境的方案：官方镜像手动安装Docker CLI与社区增强镜像自动集成Docker。通过docker-compose配置、环境变量设置、权限处理等步骤，帮助你快速搭建浏览器中的云端IDE，实现远程开发与容器管理。两种方案各有优劣，可根据需求选择。
Ubuntu Server 原生部署 KasmVNC 中文桌面指南
本文详细介绍了在 Ubuntu Server（无 GUI）上原生安装 KasmVNC 并配置 XFCE 桌面和中文环境的完整步骤，全程不使用 Docker。包含中文界面汉化、输入法安装、开机自启两种方式以及常见问题排查，助你通过浏览器轻松获得高性能远程桌面。
Claude Code权限配置全攻略
每次使用Claude Code都被权限弹窗打断？本文详解settings.json白名单/黑名单配置、--allowedTools参数、持久化设置及安全alias，三步实现免确认全自动开发，同时规避高危操作风险。
三条测试流式curl命令（OpenAI / Anthropic，分别对应 /chat、/responses、/message 流式接口）
本文提供了OpenAI和Anthropic三家主流AI接口的流式curl调用示例。涵盖OpenAI的/chat和/new Responses接口，以及Anthropic的/message接口。详细展示了SSE流式请求的关键参数、头部设置及JSON体结构，并补充了调试技巧如-N参数和无缓冲输出，帮助开发者快速实现流式响应对接。
Claude Code与Codex安装配置指南
本文详解如何在本地安装并配置 Claude Code 和 Codex CLI 工具，通过环境变量和配置文件将 API 请求路由至阿里云百炼等第三方服务商。涵盖从 Node.js 环境准备、npm 全局安装到 settings.json 及 config.toml 的具体参数设置，助你灵活调用多种大模型，提升开发效率。
WSL2 Docker 局域网无法访问？终极解法
WSL2 环境下 Docker 容器常因 NAT 网络机制导致局域网无法访问。本文深入解析根本原因，提供三种解决方案：临时端口转发、自动化修复脚本以及 Win11 专属的 Mirrored 网络模式。通过详细步骤和代码示例，助你彻底解决跨设备调试难题，实现高效开发。
WSL2 Docker 完美排障指南
解决 WSL2 中 Docker 常见的 systemd 缺失与 iptables 报错问题。本文提供从启用 systemd、切换 iptables 到一键修复脚本的完整流程，助你打造稳定高效的本地开发环境。
WSL2 从零直接安装到 F 盘（全程不占 C 盘，旧版 Windows 兼容）
本文详解如何在Win10/11上将WSL2直接安装至非C盘（如F盘），解决默认强制占用C盘空间问题。通过离线导入Ubuntu镜像、手动安装内核及使用清华源，提供完整PowerShell命令，适配旧版Windows，实现全程不占C盘且兼容性好。
OSS对象存储Docker部署完整教程
本文对比MinIO、RustFS等四款开源对象存储，重点演示RustFS的Docker Compose部署及完整S3兼容配置流程。涵盖创建Bucket、配置IAM权限策略、生成Service Account密钥及设置公开访问策略，并提供Python SDK测试代码，适用于中小型业务私有OSS搭建。