想风技术文档

出海手机卡 RedPocket 使用大全，从0到1 获取美国原生IP

Mon, 02 Nov 2026 00:00:00 GMT

大家好！今天聊下出海美国手机卡 RedPocket，这篇力争做到推特最细 RedPocket 教程。

做跨境出海、搞 AI 账号、办海外银行账户，或者运营海外自媒体（TikTok、X、Instagram）的朋友，迟早都会碰到一个令人抓狂的痛点：IP 污染与虚拟号码风控！

很多平台（比如 Claude、ChatGPT、美区 PayPal、Stripe、各大美股券商及银行）对 VoIP 虚拟网络号（如 Google Voice）查得越来越严，轻则无法注册，重则封号。

而在众多美国实体卡与流量卡中，RedPocket（国内推友常称“红袍卡”） 凭借超高性价比（年付约 30 美元，折合每月只要 2.5 美元）以及自带美国原生实体流量 IP，成了许多出海老鸟人手一张的秘密武器！

本文把所有实操踩坑记录彻底复盘，从怎么买、准备什么网络，到全程激活、扫码安装 eSIM，以及最容易被遗忘的“开漫游”步骤，带你一步到位。

一、什么是 RedPocket

RedPocket Mobile（红斑马/红袍卡）是美国老牌的知名 MVNO（移动虚拟网络运营商），成立于 2006 年。

简单来说，它就像国内租用三大运营商网络的虚商，但 RedPocket 极其强悍的地方在于它同时与美国三大电信巨头深度合作：

GSMA：运行在 AT&T 网络上（出海漫游最推荐，覆盖广、漫游支持好）。

GSMT：运行在 T-Mobile 网络上。

CDMA：运行在 Verizon 网络上。

对于国内出海用户，我们在 eBay 官方店购买的主要是年付 2.50/月）的 GSMA（AT&T）eSIM 版本，专为轻度收码、应急上网和养号打造。

二、为什么选它？核心优势拆解

维度	普通机场/代理节点	Google Voice 等虚拟号	RedPocket 红袍卡 (GSMA)
号码属性	无	VoIP 虚拟号（易被银行拒收）	美国实体蜂窝号码（Mobile）
IP 纯净度	机房 IP，滥用率高	无流量功能	AT&T 原生机房/移动蜂窝 IP
养号安全性	容易触发环境风控	很多主流银行/金融平台不认	完美过美区风控，支持 2FA 短信验证
持有成本	每月持续付费	相对便宜但容易封号	年付 30 美元（约 2.5 美元/月），性价比极高
漫游能力	无	依赖外网网络	在中国大陆直接漫游出信号，可收发短信与漫游上网

三、前置门槛与网络准备

很多新手兴冲冲买了卡，结果卡在第一步扫码或者加载上。在动手前，请务必核对以下准备清单：

一部支持 eSIM 的手机：

美版无锁 iPhone、日版/欧版/港版部分支持 eSIM 的 iPhone（国行 iPhone 不支持 eSIM，需使用海外版手机或支持 eSIM 的安卓机）。

纯净的网络环境（重中之重）：

激活网页与手机扫码下载 eSIM Profile 时，手机需要连接 Wi-Fi，且必须是纯净境外流量！

我实操用的是个人自建的纯净网络；推友鸟叔实测用英国电信手机流量卡做热点也非常稳。普通的万人骑公共机场节点极易被官网安全盾拦截或加载转圈卡死。

支付方式与辅助账号：

Google 账号：直接用于快捷登录 eBay 官网、RedPocket 官网，省去繁琐注册。

支付工具：eBay 下单支持国内双币/全币种信用卡（Visa / Mastercard）或国内绑卡的 PayPal，海外卡更佳。

美国免税/真实地址准备（eBay 下单与选区号必备）：

在 eBay 购买或在 RedPocket 激活生成号码时，需要填写一个美国地址与邮编（ZIP Code）。

推荐使用这个工具一键生成真实美国地址：美国地址工具。

实操建议：优先生成免税州（如俄勒冈 Oregon、特拉华 Delaware、蒙大拿 Montana、新罕布什尔 New Hampshire、阿拉斯加 Alaska）的地址，不仅能省下几块钱的美国州消费税，还能获取对应的标准 5 位 ZIP Code。

设备备用方案（无原生 eSIM 手机怎么办？）：

如果你和我一样暂时没有一部支持原生 eSIM 的手机，可以购买 9eSIM 实体卡转接板。

9eSIM 支持将 eSIM 卡信息写入与读取：安卓手机可通过配套 App 方便地写入、切换或删除 eSIM 配置。苹果手机也能直接插卡正常读取 SIM 信号，但是手机9esim APP 需要读卡器才能读取或者写入9eSIM 卡里的信息。

就是说安卓手机用9eSIM 可以不用读卡器，只有苹果手机需要买读卡器。多提一嘴：读卡器只能读取增加删除 sim 信息，无法让手机读取到sim信息，sim需要像普通sim实体卡一样插入到手机的卡槽才能读取使用。所以9esim 在苹果ios 上稍微麻烦些，可以选xesim 为苹果打造的。

四、怎么购买与获取激活码

目前官方最具性价比的购买渠道是 eBay 上的 RedPocket 官方旗舰店：

打开 eBay，搜索：Red Pocket $30 Annual Plan eSIM（或者找官方店铺 redpocketstore 的 $2.50/Mo RedPocket Prepaid Wireless Phone Plan）。

如图是手机版Ebay 显示商品图！

确认套餐详情：360 天有效期，每月包含 Unlimited Talk / Text + 200MB 高速流量（GSMA / eSIM）。最重要的是 eSIM Phone Kit

下单与收码：

下单支付成功后，eBay 有时候秒发邮件，我这次实测是 20 分钟后收到邮件。

邮件发件人为 RedPocket Mobile 。图见下一段

五、激活全流程图文详解

拿到邮件后，准备好电脑和要安装 eSIM 的手机，正式开始激活：

步骤一：提取邮件确认码（Confirmation Code）

打开收到的 eBay 购买确认邮件，找到你的核心凭据：

Your RedPocket line has successfully been activated!

步骤二：官网登录与选网（GSMA / AT&T）

浏览器打开 RedPocket 官方激活页：https://www.redpocket.com/activate（建议使用 Google 账号一键登录）。

在激活起始页（Start here），系统需要填入两项关键信息：邮箱确认码（Confirmation Code） 和你的 设备识别码（Device MEID/IMEI）：

💡

📱 核心关键：手机 Device MEID / IMEI 怎么查？很多新手在这里不知道填哪个，尤其是双卡或支持 eSIM 的手机会有多个 IMEI。请严格按照以下方法获取：

通用快捷法（最简单，两类手机通用）：

打开手机拨号键盘，输入代码：*#06#

屏幕会立即弹出一串条形码及对应的 IMEI / MEID / EID 数字，直接长按复制或记下即可。

苹果手机（iPhone）查询路径：

打开 「设置」 -> 「通用」 -> 「关于本机」。

往下滑动找到蜂窝网络部分：

如果你的 iPhone 支持双卡或物理卡 + eSIM，会看到 「主号 / 物理 SIM 卡」的 IMEI 以及 「可用的 SIM 卡 / 数码 SIM 卡（eSIM）」的 IMEI 2。

重点：如果你激活的是 eSIM，优先选择并填入「IMEI 2（数码 SIM 卡对应的那串 15 位数字）」！

安卓手机（Android）查询路径：

打开 「设置」 -> 「关于手机」或「系统信息」 -> 「状态信息」。

找到 「IMEI（插槽 1 / 插槽 2）」 或 「MEID」。

支持 eSIM 的机型（如 Pixel、三星 Galaxy 国际版等）会明确标注 「eSIM IMEI」 或在拨号 *#06# 时显示 EID / IMEI 2，复制该 15 位纯数字填入即可。

神器备用：在线一键生成（如果找不到/校验不通过）

如果你的手机暂时不在身边、使用的是 9eSIM 实体卡槽，或者本机 IMEI 验证遇到格式报错，可以使用这个在线工具直接生成一个合规的设备码：

🔗 IMEI 生成工具（选择常见主流机型如 iPhone 14/15/16 生成标准 15 位 IMEI 即可快速通过系统验证）。

实测 IMEI 目前来看，用手机的和网页生成的都是可以的，长期使用的话推荐用你手机的！

填完确认码和 IMEI 后，点击黑色的 VALIDATE 按钮完成设备与套餐匹配。

随后系统会要求你选择底层网络：

步骤三：获取新号码与填写邮编（Get a New Number）

接下来进入号码配置环节：

提交后，系统会弹窗提示正在处理激活（Loading / Activating...）：

步骤四：接收官方邮件与手机扫码安装 eSIM

号码分配完毕后，RedPocket 会立即给你的注册邮箱发送一封包含 eSIM 二维码的设置邮件：

同时网页端也会显示设备安装引导（以 iPhone 为例）：

六、最关键一步：开启漫游（好多教程这一步都丢了）

很多推友按照网上攻略装完 eSIM 后，发现手机右上角显示“无服务”或者一直搜不到信号，急得以为自己翻车了。

真相是：红袍卡默认关闭国际漫游！不主动在后台开启，在中国大陆境内将完全没有信号和流量！

请立刻按照以下 6 个步骤手动开启：

电脑或手机浏览器打开 Red Pocket 官网登录后台。

登录你激活红袍卡时注册的账户。

找到你的手机号（Lines），进入管理页面。

切换到左侧菜单栏的 【Roaming】（漫游） 选项。

在右侧 Ready To Roam? 下拉框中，输入或选择 【CHINA】。

点击确认，将其状态切换为 启用（Enable / Turn On）。

☝️

📌 漫游生效提示

激活后通常需要等待 10~15 分钟 后台数据同步。

手机端进入「设置」->「蜂窝网络」-> 找到 RedPocket 这张卡，务必勾选打开「数据漫游」 开关。

随后可以开关一次飞行模式或重启一次手机，你会惊喜地看到信号栏直接亮起，自动接入中国移动或中国联通的漫游网络！

七、激活后维护攻略与长久使用避坑

查余额与漫游额度：

在官网后台 Roaming 页面，可以看到漫游额度（Remaining Minutes 语音、Remaining Text 文本短信、Remaining 5G Data 流量）。

默认套餐包含一定的全球漫游收发额度，在大陆日常收短信验证码完全够用。

Wi-Fi Calling（通话增强利器）：

建议在 iPhone 设置中开启 Wi-Fi 通话（Wi-Fi Calling）。

在支持的网络环境下，通话和短信会直接走互联网传输，不仅延迟更低，而且信号质量极其稳定，就像在美国本土使用一样。

流量使用克制（切忌当主力刷视频）：

年付套餐每月赠送的漫游高速流量通常为 200MB 左右，主要用于紧急环境登录、获取原生美国蜂窝 IP 验证。

实际目前据说流量没有200MB了，我的显示100MB，如果不够用 5$ 买一G来使用！这张卡不用担心超额使用，流量超额自动断流量但有信号，需要更多流量自行购买，收听电话，接收短信免费！

日常千万不要开着它刷 YouTube 或刷 TikTok，200MB 几分钟就耗尽了。如需额外漫游额度，可在后台点击 Add Credit 充值充值金。

长久续费保号：

临近 360 天到期前，可以在 eBay 再次购买同款 Renewal 套餐充值码，或者在 RedPocket 官网绑定外币卡直接续订。

最后效果与建议

流量IP效果展示：注册一个海外平台或者更换一个平台手机号，验证是否能收到验证码，比如telegram 不开梯子打开谷歌页面 https://www.google.com/ ok 真是神奇的一次体验！

想风的诚恳建议

出海路漫漫，基础设施是地基：

如果你做的是一般的海外业务、主要用来收英国或欧洲平台的短信，那么 Giffgaff 零月租、低成本持有依然是极佳的选择；

但如果你深度依赖美区生态——需要注册美区 PayPal、开通美股券商、申请美卡、绑定 Stripe、或者订阅对 IP 纯净度要求极高的 AI 工具，RedPocket（红袍卡）绝对是目前性价比最高、最稳妥的原生美国实体号选择！

一年 30 美元，省去了因为虚拟号被拒、因为万人骑代理被连坐封号带来的无尽折磨。

本文基于鸟叔文章实操后所写，大家也可以参考下鸟叔这篇

如果文章对你有帮助，欢迎点赞、收藏、关注！

每天进步一点，我们终会到达目的地！

我是想风，@xaiwind，一个关注出海与 AI 的创作者。

Wise 入门到精通｜2026年10月亲测，个人可申请港户和美户

Thu, 29 Oct 2026 00:00:00 GMT

大家好，我是想风，今天来聊聊wise!

对于每一个玩出海、做跨境电商、接海外自由职业外包，或者想要订阅海外 AI 服务（ChatGPT Plus、Claude Pro 等）的朋友来说，Wise（前身 TransferWise） 绝对是绕不开的基础设施神器。

特别是对于玩 X（Twitter）的推友们，辛辛苦苦把账号做起来、达到了开通创作者广告收益分成的标准，却卡在 Stripe 结算绑定这一步——国内银行卡根本无法绑，眼睁睁看着美金打不过来。

自 2023-2024 年以来，Wise 对中国大陆居民新注册个人账户的政策逐步收紧，很多直接用大陆身份证注册的新号已经无法像以前一样直接获得 USD（美元）、HKD（港币）、EUR（欧元）等本地银行账号信息（Account Details），这让很多新手望而却步。

2026 年 10 月最新亲测： 如果你拥有一个已经验证通过的 Wise Business（企业/公司）账号，你可以直接在同一个体系下开设个人账户，并顺利申请并下发个人美元账户（美户）与港币账户（港户）！你无企业资质，纯个人大陆身份也是可行的！

本文将从 0 到 1 拆解 Wise 个人注册流程、开户条件、全套风控问卷填写避坑，实操图文记录，以及如何用 Wise 接收 X 创作者收益的全套保姆级指南！

一、什么是 Wise？为什么说它是出海第一神器

Wise（伦敦证券交易所代码：WISE）是一家英国上市的金融科技独角兽，受英国 FCA、美国 FinCEN、香港海关等全球数十个顶级金融监管机构严格监管。

简单来说，你可以把它理解为一个全球多币种电子钱包 + 跨国本地银行账户聚合器：

功能维度	传统电汇（Swift）	Wise 跨国转账
汇率机制	银行加价汇率（买入/卖出价差巨大）	独立中间市场汇率（实时公允汇率，无暗扣）
到账时效	1~3 个工作日，常遇中转行扣费	秒级到账或数小时内，无中间行隐形杂费
收款能力	只能提供主账户 Swift 电汇	提供独一无二的本地银行账号（美、港、英、欧等）
费用透明度	手续费高昂（常需 15~30 美元/笔起）	极低手续费（按百分比，透明公开）

核心亮点：

多币种本地银行账户（Account Details）：开通后，Wise 会分配给你真实的银行账户信息。例如美元账户拥有专属的 ACH Routing Number 和 Account Number；港币账户支持 FPS（转数快） 等。别人给你转账走的是本地清算网络，无需昂贵的跨国 Swift 电汇。

汇款回国极度丝滑：支持直接将外币兑换为人民币，秒级清算转入国内本人的支付宝、微信支付或国内银联储蓄卡，合规且汇率透明。

低成本货币兑换与资金中转：支持 40+ 种货币实时自由互换，无论是给海外平台付款、买云服务器，还是提现 Stripe、PayPal、Upwork、Shopify、App Store / Google Play 收入，都是核心枢纽。

二、2026 个人开通港户/美户的现状与核心突破口

很多朋友在网上搜索攻略，直接用大陆身份证和手机号去 Wise 官网注册个人账号，结果发现：

注册是成功了，但账户里只能“汇款（Send Money）”，没有“开通账户余额（Balance）”的入口，更无法获取个人美元、港币等本地银行收款账号。

为什么会出现这种情况？

由于合规与风险控制，Wise 对纯大陆个人新户关闭了直接分配多国本地账户的功能（除非你能提供英国、欧洲等海外真实地址证明和居住证明）。

本文实测突破口：公司账号（Business）联动个人账号（Personal）

如果你已经拥有（或注册验证了）一个 Wise 企业/公司账号（Wise Business）：

Wise 允许同一企业法定代表人/管理员在同一账号体系下，开启并绑定自己的个人账号（Personal Account）。

借由企业账号已有的商业信任背书，在开启个人账号并走完**税务申报（TIN）与首充入金（Deposit）**之后，个人美元账户（美户）与港币账户（港户）可以直接顺利申请并下发！

三、Wise 个人基础注册保姆级步骤（从零起步）

如果你还没有 Wise 账号，无论是先注册个人户还是后续联动，都需要先走完基础的个人注册流程。

1. 注册前准备材料

常用电子邮箱：推荐使用 Gmail、Outlook 等国际通用邮箱（不建议使用 QQ/163 邮箱，避免漏收系统安全邮件）。

手机号码：

支持绑定中国大陆手机号（+86），建议用你国内长期持有的手机。
如果平时经常折腾海外业务，有境外手机卡（如英国 Giffgaff 等）也完全可以使用。

证件原件：本人有效期内的大陆居民身份证或中国护照。

网络环境：尽量使用稳定干净的网络节点，不要频繁跳动 IP。

2. 注册全流程步骤

打开官网：访问 Wise 官网（wise.com）或在手机应用商店下载 Wise App。

点击注册（Register）：输入准备好的邮箱，点击继续。

选择账户类型：在账户类型界面，选择 「个人账户（Personal Account）」。

选择居住国家/地区：

居住国家如实选择 「中国（China）」（除非你拥有合法的海外常住签证和当地真实地址账单证明）。

绑定手机号并完成验证：输入手机号，接收 6 位短信验证码完成二次验证（2FA）。

设置登录密码：设置包含字母、数字及符号的强密码。

个人真实资料录入（关键细节）：

姓名拼音：名字（Given name）和姓氏（Last name）务必与你的身份证/护照以及银行卡上的拼音完全一致！千万不要颠倒，也不要有错别字。

出生日期：必须与证件严格一致。

居住地址：按照身份证或实际居住地址填写（建议填写拼音/英文，包含省、市、具体门牌号）。

完成上述步骤后，你的个人基础账号即注册成功。

四、实操全记录：公司账号开个人账号与入金验证（多图详解）

为什么通过「企业账号」开出来的个人账号下发美户和港户会快些吗？核心逻辑在于：Wise 已经在企业开户审核阶段，对公司主体及其法人进行了极为严格的底层资质核验（KYC/AML 商业穿透）。企业背书成立后，个人账户便继承了高信任度的合规画像，开户更容易些。

因此，从企业号切换进入个人账号开通之前，必须先确保你的 Wise Business（公司账号）顺利完成企业资质与账单认证。没有企业号的直接个人号注册就好了。

4.1 前置核心：公司资质文件与 3 个月账单 PDF（结合 Wise 官方要求）

根据 Wise 官方帮助中心（Wise Help Center）的商业账户验证指引，验证公司账户必须备齐以下两大核心模块的材料：

1. 公司基础资质文件（Company Registration Documents）

营业执照 / 注册证书（Certificate of Incorporation / Business License）：

证明企业的合法设立与主体资格，必须能清晰展示统一社会信用代码/企业注册编号（Registration Number）。

公司章程（Articles of Association / Memorandum）：

官方盖章或登记机关备案的完整章程，用于核实公司组织架构。

董事与股东名册（Register of Directors & Shareholders）：

Wise 严格遵守反洗钱法规定，必须准确穿透识别并登记所有直接或间接持股 25% 及以上的最终受益人（UBO - Ultimate Beneficial Owner），以及公司核心董事与日常管理员。

法人及管理员身份证明：

法人代表及账户操作人的居民身份证或护照高清扫描件。

业务真实性佐证（Business Activity）：

公司官方独立站网址、电商平台店铺链接，或清晰的产品/服务合同发票，证明公司处于正常实际运营状态。说这么多其实就两份文件：Certificate of Formation 和 EIN Confirmation Letter，一般注册好海外公司都会给你的。

2. 核心凭证：近 3 个月内的银行对账单 / 账单 PDF（Bank Statement within 3 months）

这是 Wise 官方审核中最关键、也是打回率最高的一项材料！租房、水电账单也可以的！

根据 Wise 官方指引，平台通常会索取近 3 个月内的银行对账单，用于两大核心审查：

营业地址核验（Proof of Trading Address）：

Wise 严格排查纯虚拟地址（PO Box、转信地址），要求对账单上清晰印有公司的实际经营地址（Trading Address），且出具日期必须在最近 3 个月以内。

资金来源与营收核查（Source of Funds / Revenue Verification）：

需要提供近 3 个月连续的银行流水对账单，以证明公司有真实的业务资金流动和合法收入来源。

☝️

📌 结合 Wise 官方文档：3 个月账单 PDF 的严格上传规范

文件格式必须合规：必须是从企业网银/实体银行直接导出的原生电子对账单 PDF，或者银行柜台打印加盖公章的高清彩色扫描件。严禁手机拍照电脑屏幕，严禁手机截屏！

绝对不可设置密码保护：许多银行导出的 PDF 默认带有开启密码，必须先移除密码保护后再上传，否则 Wise 系统会自动秒拒。

禁止遮挡与涂改：对账单的四个角必须完整露出，流水摘要、金额和表头绝对不能涂黑或遮挡。

四要素必须完整清晰：

银行官方名称及 Logo；

公司法定全称（与营业执照/Wise 填写完全一致，不可用缩写）；

完整的公司营业地址；

3 个月之内的明确出具日期（Issue Date）。

文件大小：单文件小于 10MB（多页合并为一个完整 PDF 上传）。

4.2 公司通过验证后，开通个人账号的实操全记录（多图详解）

当公司账号提交完上述资质文件与近 3 个月的官方账单 PDF 并审核通过后，企业后台就拥有了完全激活的商业信用。

此时在 Wise 后台左上角切换/新增「个人账户（Personal Account）」。Wise 会引导法人进入个人层面的税务申报与首充验证流程：

步骤一：确认税务居民身份与填写 TIN

在创建个人账户并点击充值加钱时，系统会弹出税务居民信息收集弹窗：

紧接着，进入税务识别号码确认界面：

步骤二：使用目的与资金转移规模（风控合规选择）

接下来 Wise 会进行简单的合规尽职调查（KYC / AML 问卷），这里的选项关系到后续账号的风控敏感度，请务必谨慎选择：

随后，系统会询问预计一年内的资金转移规模：

步骤三：入金激活与等待账户下发

填写完合规信息后，Wise 提示信息收集完成：

❗

🚨 致命坑点：银行转账千万别漏填附注（Reference）！看到截图右侧的「笔记」以及你在银行 App 操作转账时的界面了吗？很多朋友在转账这 170 元人民币/等值港币时，直接空着转过去，结果 Wise 页面一直显示「添加暂停」甚至直接入金失败被退款！ 原因： Wise 的收款账户是公户对公池，每天处理成千上万笔款项，如果银行转账附言留空，系统无法精准将入账与你的账户绑定。 正确操作： 在你银行 App 的**「转账附言 / 汇款附注 / Reference / Remarks」**一栏，务必填上英文附注：

(例如：Account top-up for personal Wise account. Activation deposit. Payer: ZHANG SAN) 同时把转账成功的流水截图保存好，如果出现延迟，直接点击右侧「上传文件」提交凭证，客服分分钟人工核实放行。

港卡实测必须附注，必须是你的同名账户汇款最佳。一旦此笔款项通过同名账户汇达，系统即会瞬间完成验证，并正式在你的个人账户后台亮起美元（USD）、港币（HKD）以及其他多币种的账户详情！

五、入金激活的最佳姿势

Wise 账户必须经过首笔资金激活才能解锁账户详情，这是很多新人卡住的地方。以下是目前最推荐的激活渠道：

境外同名银行卡（首选推荐）：

香港银行卡（如中银香港、汇丰、众安 ZA Bank、理慧 Livi 等）：通过 FPS（转数快）入金，零手续费且秒到账，体验丝滑。

新加坡/其他地区同名银行卡（如 OCBC 华侨银行）：使用 FAST 本地转账或借记卡入金。

英国IFAST

同名国际信用卡/借记卡（Visa / Mastercard）：

部分支持 3D 验证的双币/多币卡也可尝试直接扣款入金（需注意发卡行是否允许跨境准现金类交易）。

港卡转账附言（Reference）必须写对（超高频失败坑点）：

转账这笔 170 元人民币/等值外币时，千万不能留空附言！Wise 每天处理海量对公资金流水，如果转账附言没填，系统无法自动关联这笔待入账订单，极易导致“添加暂停”甚至入金失败原路退回。

银行汇款附言标准格式：

转账后记得保存好网银电子回单截图，如遇人工抽检，在订单详情右下角「依托」处直接上传凭证即可快速通过。

高危红线（绝对禁止）：

❌ 严禁找淘宝、闲鱼代充，严禁让朋友转账激活！

Wise 激活入金必须是 严格的同名转账（Sender Name 必须与 Wise 姓名完全一致）。一旦检测到非同名入金，款项会被原路退回，同时账号可能直接进入永久封禁状态。

六、下户后核心功能玩转

成功拿到属于自己的个人账户后，你将拥有以下强大能力：

1. 独享个人本地银行收款账号（Account Details）

美元账户（USD）：包含 Routing Number（ABA / ACH 路由号）及独一无二的 Account Number。支持接受美国本土公司与平台的免手续费 ACH 打款（如 Stripe 提现、Paypal 提现、Google AdSense、海外雇主发放薪资等）。

港币账户（HKD）：拥有香港本地结算账号，可与香港各大银行无缝 FPS 互转。

欧元/英镑等账户：提供独立 IBAN 和 Sort Code，畅收欧洲与英国本地款项。

2. 资金无损合规回国（结汇）

Wise 支持将账户内的 USD/HKD/EUR 等余额直接提现至国内个人银行账户：

支付宝结汇：绑定国内本人的支付宝账号，数秒内到账，直接变成人民币余额。

微信支付结汇：通过微汇款官方小程序，实时接收人民币入账到微信零钱/储蓄卡。

银联卡直连：直接转账到国内各大银行储蓄卡。 (注：每人每年仍享有国家外汇管理局 5 万美元的结汇额度便利)

3. 订阅全球 AI 服务与海淘

可直接用于绑定海外商家扣款；若后续拥有符合资格地区的 Wise 虚拟卡（Digital Card），更能畅快订阅 Claude Pro、ChatGPT Plus、Midjourney、Cursor 等开发与生产力工具。

七、实战探讨：X (Twitter) 创作者收益机制与 Wise 收款绑定解析

许多国内出海的小伙伴在 X（Twitter）上做技术分享、AI 内容或做独立产品推广，都会关注 X 的创作者变现功能。

但必须特别提醒：X 的收益规则在 2026 年下半年经历了重大改版，网络上大量旧教程里的门槛、申请入口与提现认知已经全面过时！ 此外，很多人为了绑定 Wise，在收款国家和税务表单上随意乱填，埋下了极大的封号风险。

这里结合官方最新计划说明、官方创作者条款以及想风的实际绑定经历，给大家客观拆解真实的玩法与合规边界。

1. 计划重大更替：旧版“广告分成”已停止，全面转向“原创内容奖励”

很多老教程教大家去点「广告收益分成（Ads Revenue Sharing）」，但官方政策已经正式变更：

旧计划终止：旧版 Creator Ads Revenue Sharing 在 2026 年 8 月 7 日 已停止接受新申请，并在 9 月 7 日 正式结束收益累计。

当前新计划：全面转向 Original Content Rewards（原创内容奖励）。

底层逻辑变化：官方不再单凭你在帖子回复区里挂广告被动分钱，而是重在鼓励高质量、非搬运的原生原创内容，收益根据真实认证用户的互动与消费权重综合计算。官方新计划说明可参见此处。

2. 2026 最新官方准入门槛（对比纠偏）

千万不要再对照旧版的“500 万曝光 + 500 个普通粉丝”去生搬硬套了，当前官方的硬性指标严苛得多：

对比维度	网传旧版规则（已作废）	2026 官方当前新规则（Original Content Rewards）
曝光指标	过去 3 个月累计 500 万次任意曝光	过去 90 天内，至少 50 万次来自认证用户（Verified Users）的「首页时间线」曝光（在别人帖子下评论回复产生的曝光不计入！）
粉丝门槛	拥有至少 500 名普通粉丝	拥有至少 500 名「认证粉丝」（Verified Followers，即蓝标/金标订阅用户）
开通机制	数据达标即可自动开通	达标仅代表获得申请资格，仍需官方人工/算法审核，不保证 100% 录取
起付门槛	累计满 10 美元打款	当前最低打款门槛提高至 30 美元
其他要求	订阅普通蓝标即可	必须处于符合资格的地区、持有指定订阅且持续稳定发布合规原创内容

3. 收款渠道与资料真实性（切忌盲目选“美国”）

大家最关心的问题是：我有了 Wise 美元账户，能不能在绑 Stripe 时直接选美国？

❗

🚨 真实性警示：不要为了绑定 Wise 而随意选择“美国”！

官方通道划分：目前官方严格区分收款模式，美国本土创作者正逐步通过 X Money 等渠道收款；非美国创作者则通过 Stripe 完成收款设置与身份核验。

收款账户所在地 ≠ 个人居住地/纳税身份：Wise 分配给你的是美国银行的 ACH 路由号和账号，但这并不代表你的法定居住地或企业纳税主体在美国！

封号风险：根据 X 创作者条款与资料真实性要求，必须提交真实有效的身份信息。如果在国家/地区一栏强行填写 United States，后续在触发二次 KYC 风控时，会被要求提供美国 SSN/ITIN 或当地居住地址证明（水电单、租房合同），一旦无法提供，不仅打款会被无限期冻结，整个 X 变现资格也会被永久吊销。

合规原则：居住地和国家必须如实申报，仅在填写底层结算银行卡号（Bank Details）时，依系统允许的币种填入对应的 Wise 本地账户信息。

4. 税务合规真相：W-8BEN 绝非“填了就自动免 30% 税”

很多自媒体宣称“只要在 Stripe 里填上国内身份证提交 W-8BEN，就能完全免去 30% 的美税秒到账”，这是一个极具误导性的说法。

根据 IRS 官方关于 W-8BEN 的指引说明：

W-8BEN 的真正用途：用于向美国国税局（IRS）及支付机构证明你的外国非美人士身份（Non-US Status），并在符合特定条件时申请税收协定待遇（Tax Treaty Benefits）。

能否减免因人因收入性质而异：是否能享受协定优惠税率（甚至 0% 税率），取决于你的实际税收居民身份、平台分配收益的具体定性（是劳务报酬、版权版税特许权使用费还是数字广告分成），以及中美双边税收协定中的对应条款。

不能做出绝对免税承诺：最终平台是否代扣、按什么税率预扣，必须以支付机构出具的年终税表（如 1042-S）和官方核算为准，切勿把合规申报简单等同于“免税通行证”。

5. 想风2026 年 10 月实操复盘与理性建议

在本次实测中，想风持大陆合规真实身份，在满足相应官方条件后，实地测试了使用 Wise 个人账户（获取的美元 ACH Routing/Checking 信息）与 Stripe 结算通道的对接流程：

操作实测：Wise 的本地账户信息在格式兼容性上非常顺畅，能正常被清算网络识别；在打款周期内，符合要求的款项到达 Wise 后，能正常使用 Wise 兑换回人民币秒级结汇至微信/支付宝。

但请大家保持理性，切记三点：

不要轻信“人人照做就能躺着赚美金”：现在 X 针对蓝标认证粉和原创内容抓得非常严，纯靠机器刷量或互关互转已经无法通过审核。

账户是水渠，内容才是活水：先把个人 Wise 账户的港户和美户准备好，这是出海必不可少的基础设施；但能否拿到收益，核心在于你持续输出的深度内容与真实影响力。

坚持合规为王：所有资料申报务必诚实真实，宁可慢一点，也不要冒着被封号连坐的风险去搞虚假伪装。

八、Wise 核心防封与避坑军规（血泪总结）

Wise 对风控审核极为严格，业内常戏称“且用且珍惜”。请务必把以下几条守则刻在心上：

⚠️

Wise 防封五大军规

严禁触碰虚拟货币（Crypto / P2P）：

绝对不要用 Wise 接收或转出任何加密货币交易所（如币安、欧易、OKX）的 P2P 个人法币买卖资金。Wise 对 Crypto C2C 是零容忍态度，一旦触发，基本立刻永久封停且无法申诉。

切忌“快进快出”（流水不过夜）：

刚收到一笔大额款项，5 分钟内立刻全额转出，会直接被反洗钱（AML）模型判定为洗钱或资金过桥行为。建议资金到账后保留一部分余额，正常沉淀一段时间或分批处理。

保持网络环境稳定干净：

尽量使用干净的网络节点登录，不要频繁一天之内在五六个国家代理之间来回切换，更不要使用多人滥用的免费公共代理。

保持真实的商业与个人使用场景：

收到 Wise 官方发来的资金来源调查（SOF）或发票问询时，千万不要置之不理。如实提供合同、Invoice、平台提现截图，通常 1~2 个工作日即可顺利解封。

坚持同名原则：

初期使用时，尽量多在自己的同名账户之间互转（如 Wise 个人户 ↔ 自己的港卡 / 新加坡卡），建立良好的账号信用画像后再开展第三方往来。

最后

想风诚恳建议：

如果你在做推特自媒体，正在做出海，可以优先把个人wise 账户拿下，现在港户和美户，都可以开！出海提前准备好护照、三个月内的信用卡账单地址证明，这个地址需要与你的填的地址对应，也可以房租水电账单地址证明！有时间有空去香港旅游的办个港卡，没时间的办英国IFAST!

先个人再企业，打开海外支付收款渠道，企业资质的推迟就好！我整企业是以为，有公司资质就好办了，其实不是现在审核很严，很难申请的，目前我企业号美户是未开通账号的。流水得先从个人积累，再切换到企业，当然你有钱，找财务代理帮你处理，或者注册港企或许更好解决一点!

如果你 wise 你走不通，也可以尝试万里汇和空中云汇、PayPal来解决海外收款问题！国内平台优先用国内企业的支付，海外平台优先用海外企业的支付！

我是想风@xaiwind，一个关注出海与 AI、AIGC 的创作者。

本文基于AI辅助与个人实践融合创作，如果文章对你有帮助，欢迎点赞、收藏、关注，

本人文章持续维护，欢迎联系或者评论区见，每天进步一点，我们终会到达目的地！

Giffgaff 购买激活使用大全，及账号被封如何退款？

Tue, 27 Oct 2026 00:00:00 GMT

大家好，我是想风！今天来看 Giffgaff !

出海搞业务、玩 AI、做跨境，第一道门槛往往不是代码，也不是外币卡，而是那该死的海外手机号！

OpenAI 注册要收码、Claude 验证要收码、Telegram 注册要收码、海外银行和 PayPal 也要收码。拿国内手机号去撞，轻则收不到短信，重则直接被系统风控判定为高风险。

在国内能低成本持有、零月租还免漫游费收短信的，Giffgaff 号称海外手机卡里最夯的存在！

本文把你当小白，从怎么搞到卡、怎么激活保号，再到如果不幸翻车被封号怎么把余额退回来，一次性讲透。

安全带系好，上车！

为什么它是最夯的存在

怎么搞到这张卡（政策变动与获取方式）

卡到手后如何激活

怎么长久保号

翻车实录：账号被封如何退款

想风的真诚建议

一、为什么它是最夯的存在

简单记忆版：

🇬🇧 Giffgaff → 英国老牌 O2 旗下虚拟运营商，信号接入移动/联通 💳 资费模式 → Pay As You Go（零月租，充多少用多少，不扣不花） 📩 国内收码 → 在国内漫游接收短信完全免费 ⏳ 保号成本 → 180 天有偿消费一次（发条短信约 £0.30），充 10 镑能用十几年 🚨 翻车自救 → 账号被封余额不打水漂，找官方 Agent 走退款

很多海外卡每个月都要交月租，一年下来几十甚至上百美金。Giffgaff 最大的优势就是没有固定月租。只要按时触发一次扣费，号就能一直活着用，对于只拿来收验证码的人来说，性价比极高。

二、怎么搞到这张卡

搞卡之前，先同步一个非常关键的重要信息：

注意注意：Giffgaff 官方已于 2025 年 11 月 3 日正式宣布暂停向中国大陆和香港地区寄送实体 SIM 卡。

也就是说，曾经广为流传的「官网直邮免费平邮寄国内」的路子，已经彻底行不通了！现在想要搞到这张卡，主要看下面两个途径：

途径一：国内平台直接买现卡（最省心、最推荐）

直接去淘宝、闲鱼、京东或者推特找推友买。

价格一般几块钱到二三十块不等。这种卡是商家或推友此前批量带回国内的未激活空白卡，发普通国内快递，两三天就能拿到手。

注意注意：一定要买未激活的空白卡！千万不要图省事买别人已经激活过的二手卡。自己的账号安全，必须自己从头绑定。

途径二：海外亲友转寄或转运地址代收

如果坚持想从官网 0 元下单申请，地址就不能直接填大陆或香港了。

可以寄给英国本地或海外其他支持寄送地区的朋友，由朋友代收后再挂号信转寄回国；或者找海外支持转运信件的转运仓代收转运。不过转运周期长、也有转运成本，折腾下来不如直接国内买张现卡划算。

三、卡到手后如何激活

拿到卡套后，背面会有一个 6 位的激活码（Activation Code）。

激活前准备：

一张支持外币支付的双币/全币种信用卡（Visa / Mastercard）或 PayPal

手机端或电脑端浏览器

激活步骤：

打开激活官网：https://www.giffgaff.com/activate

输入卡套上的 6 位激活码，点击继续。

输入你的邮箱并设置密码，创建 Giffgaff 账号。

这一步千万别选错：系统会推荐你选每月自动续费的套餐（Monthly rolling plans / Goodybags），直接跳过！全部不选！ 向下拉到底，选择 Pay As You Go credit（按量计费），充值 £10。

绑定你的外币信用卡完成支付。

支付完成后，页面会显示分配给你的英国手机号码（以 +44 开头）。把 SIM 卡抠下来插进手机，等待搜索网络信号。国内通常会自动接入中国移动或中国联通。如果长时间无信号，进手机蜂窝网络设置里手动选择一下运营商，或者重启一下手机。

四、怎么长久保号

激活充值完 10 镑后，别放着不管。

Giffgaff 的保号规则只有一条：每 180 天（约 6 个月）内，必须产生一次有偿使用记录。

只要这 180 天内余额被扣了一次，账号有效期就会自动往后顺延 180 天。

最低成本保号方法：

每隔 5 个月左右（设置一个日历提醒，比如 150 天），用这张卡给国内任意手机号发一条短信。

发一条国际短信资费大约是 £0.30（折合人民币不到 3 块钱）。发完后查一下账户余额，只要被扣了 £0.30，保号生命周期就再次刷新 180 天！

充值的 10 镑加上送的 5 镑共 15 镑，发一条扣 £0.30，够你稳稳当当保号十几年。

平日里国内漫游接收短信完全免费，只要手机开机有信号，收各种验证码一分钱不扣。

五、翻车实录：账号被封如何退款

海外卡虽然好用，但风控也是家常便饭。

懵逼！发现 Giffgaff 发不了短信，收不了短信。

于是查了下邮箱，发现账号被禁，如下图所示：

如果显示 not available 不可用，标明账号已经被封禁了：

https://www.giffgaff.com/profile/payment-details 这个地址可以看到手机号是否有绑卡：

封了就封了，也就不想用了，退款吧！

1. 提前准备好 5 样凭证材料：

Giffgaff App 或网页里的余额截图

历史充值与消费记录截图

当初付款绑定的银行卡号（末 4 位与卡面信息）

邮箱里收到的账号被封截图

Giffgaff 手机号与注册邮箱

提前准备好、尽量多的信息，我是以上信息和agent 聊天就退款成功的

2. 联系官方客服（Agent）：

去 Help 页面找到 Ask an Agent 提交工单，把账号被封的情况和准备好的材料直接发过去，说明账号不可用，请求将剩余余额（Balance refund）原路退回到付款卡。

3. 避坑实操建议：

时间选择：最好在英国当地的工作日和上班时间发起。

对话注意：需要先登录你的 Giffgaff 账号。如果是在线与 Agent 沟通，一定要明确看到对方回复**「我们会通过邮件回复你信息」（We will email you...）**之后，才可以关闭对话窗口。

提交完后耐心等待，过几天你的注册邮箱就会收到处理结果和退款确认邮件，款项会原路退回你的银行卡。

看到下面这封邮件就是基本成功，静待退款到账就好了！

六、想风的真诚建议

这张卡可以持有，成本极低，国内收验证码也很方便。

但千万要谨慎使用：

别拿它当唯一的命根子：海外虚拟运营商对大陆漫游 IP 的风控极严，有时候哪怕你什么都没干，也可能被批量误杀。核心资产和关键账号最好有备用方案，不要把所有鸡蛋放在这一个篮子里。

规范使用：不要用来频繁切换网络滥发信息，不要用来从事违规操作。

摆正心态：工具就是工具。能用就安安稳稳用，万一被封了，保留好凭证把钱退回来就是，不必为此焦虑。也可选择保留号码，换成其他英国运营商。

参考网站：

https://x.com/xaiwind/status/2069245546892837183

https://x.com/AI_Jasonyu/status/2065630185945243954

https://x.com/cuijason1/status/2081737574935359530

https://x.com/Z_ylog/status/2099748435448742171

https://my.feishu.cn/wiki/Diz5wOLPBiJ61vknn1lctFJunOh

我是想风 @xaiwind，一个关注出海与 AI、AIGC 的创作者。

本文基于AI辅助与个人实践融合创作，如果文章对你有帮助，欢迎点赞、收藏、关注，

本人文章持续维护，欢迎联系或者评论区见，每天进步一点，我们终会到达目的地！

Mac终端工具入门：原生、Iterm、Ghostty 一文讲透讲清楚

Fri, 23 Oct 2026 00:00:00 GMT

大家好，我是想风！

今天来看 Mac 上的三款终端：系统自带的 Terminal、iTerm2、Ghostty，本篇写给新手小白，新手也能学会！

终端是你每天待得最久的窗口。写代码、跑服务、连服务器、用 Claude Code，最后都落在这个窗口里。选哪一款，不影响命令能不能跑，影响的是每天顺不顺手。

是什么：终端、Shell、命令行

三款终端：定位和差异

下载和安装

界面认一遍

上手：一节一件事

进阶：Shell Integration 和 AI

坑集锦

速查表

最后

一、是什么：终端、Shell、命令行

这三个词经常被混着用。

终端（Terminal）是一个窗口。它负责显示文字、接收键盘、管理标签和分屏。

Shell 是窗口里跑的解释器。zsh、bash、fish 都是 Shell。它读你敲的命令，交给系统执行。

命令行是你敲命令这件事，不是某个软件。

一个类比：终端像显示器，Shell 像显示器里干活的人。换显示器不会换人，所以你换终端之后，git、npm、ssh 还是原来那套。

Terminal、iTerm2、Ghostty 都是终端模拟器。差别在于这扇窗口做得多细。

![[CleanShot 2026-10-21 at 15.59.15@2x.png]]

二、三款终端：定位和差异

先回答一个问题：为什么值得花时间挑？

终端每天都要开。标签怎么切、分屏怎么开、报错怎么搜、配置能不能带走，这些动作一天要重复几十次。顺手的终端省时间，不顺手的天天硌手。

三款的定位不一样。

ㅤ	Terminal	iTerm2	Ghostty
谁做的	Apple	开源社区	Mitchell Hashimoto 与社区
定位	系统自带，够用	功能最全的工作台	原生加 GPU 的新派终端
安装	不用装	要装	要装
配置	图形界面	图形界面加大量选项	纯文本配置文件
适合	偶尔用、连服务器	每天泡在终端里	要快、要原生手感

Terminal 是 macOS 自带的。零配置，开箱能用，系统集成最好。功能不多，但标签、分屏、搜索、描述文件、窗口组这些基础件都有。

iTerm2 是开源终端里的老牌选手。功能密度最高，Shell Integration、Triggers、Hotkey Window、Instant Replay、AI Chat 都在。3.7 版本还加了标签组、Workgroups、iOS 伴侣 App。

Ghostty 是新派终端。Zig 写核心，macOS 用 SwiftUI 加 Metal 渲染，Linux 用 GTK。主打原生手感、GPU 加速和文本配置。1.3.1 是当前稳定版。

三款都支持标签和分屏。真正的差别在功能密度、配置方式和细节手感。

三、下载和安装

Terminal：不用装

系统自带。打开「启动台」，进「其他」，点「终端」。或者按 Command + 空格，输入「终端」。

它跟着 macOS 更新，不用单独升级，也不用管依赖。

iTerm2

官网：https://iterm2.com/

用 Homebrew 装：

也可以从官网下载 DMG，拖进 Applications。

当前稳定版是 3.7.6，2026 年 10 月 15 日发布，要求 macOS 13 或更高。

装完在菜单栏 iTerm2 → About iTerm2 能看到版本号。

Ghostty

官网：https://ghostty.org/

用 Homebrew 装：

官网也提供通用 DMG，Apple Silicon 和 Intel 都能用，要求 macOS 13 或更高。

当前稳定版是 1.3.1。

装完先做三件事

第一件，换一个顺眼的等宽字体。

三款都支持自定义字体。编程字体优先选带连字的等宽字体，比如 JetBrains Mono、Maple Mono。中文环境下还要确认字体带中文，不然会出现方块。

第二件，定一套配色。

Terminal 在「设置」→「描述文件」里改。iTerm2 在「设置」→ Profiles → Colors 里改，也能导入现成的配色。Ghostty 在配置文件里写一行主题名。

第三件，决定要不要装 Shell Integration。

iTerm2 和 Ghostty 都有 Shell Integration。装上之后，终端才知道你当前在哪个目录、上一条命令成功没有。Terminal 没有这套东西，靠手动打标记。

四、界面认一遍

三款的骨架一样：窗口、标签栏、分屏。

Terminal。 窗口顶部是标题栏，开多个标签会出现标签栏。Command + I 打开检查器，能看当前进程、改标题和背景色。设置集中在「描述文件」里，一个描述文件管一套字体、颜色和启动命令。

iTerm2。 窗口顶部是标签栏，分屏之后每个 pane 是一个独立会话。底部可以开状态栏，显示当前目录、主机名、时间。设置项多，左上角有搜索框，直接搜关键词比翻菜单快。

Ghostty。 窗口用 macOS 原生标题栏和标签栏，分屏也是原生控件。没有设置面板，所有配置在一个文本文件里。改完按 Command + Shift + , 重新加载。

三款的快捷键大差不差：

动作	Terminal	iTerm2	Ghostty
新标签	`Command + T`	`Command + T`	`Command + T`
分屏	`Command + D`	`Command + D`	`Command + D`
关闭分屏	`Command + Shift + D`	`Command + W`	`Command + W`
搜索	`Command + F`	`Command + F`	`Command + F`
设置	`Command + ,`	`Command + ,`	改配置文件

具体方向各版本可能微调，记住「新标签、分屏、搜索、设置」这四件事就够。

五、上手：一节一件事

这一节先讲三款共用的操作。学会一套，换到哪一款都能用。真正不同的地方，单独标出来。

开标签和分屏

先分清标签和分屏。

标签是同一个窗口里并排的多个会话，适合放不同项目。分屏是同一个标签里切开的几块，适合边跑边看。

三款的新标签都是 Command + T。切换标签直接点标签栏，菜单里也有「下一个标签」之类的命令。

分屏三款都是 Command + D。iTerm2 和 Ghostty 的 Command + D 是左右分，Command + Shift + D 是上下分。Terminal 只有一种分屏方式，Command + D 切开，Command + Shift + D 关掉。

关闭当前分屏，Terminal 用 Command + Shift + D，iTerm2 和 Ghostty 用 Command + W。Command + W 在 Terminal 里关的是整个标签页，别按错。

一个常见场景：左边跑开发服务器，右边敲 git，第三个标签连着服务器。开发服务器要用分屏盯着，git 和 ssh 用标签分开。

分屏别超过四块。屏幕就那么大，切来切去比开一个标签还慢。

搜索和回滚

三款都用 Command + F 搜索当前终端缓冲区。回车跳到下一个匹配，Shift + 回车 跳上一个，Esc 关掉搜索框。

搜不到的时候，先确认输出还在不在缓冲区里。三款都能调回滚行数，默认不是无限。

共用的部分到这里。三款各有自己的回滚办法：

Terminal 用「标记」。在 Shell → Mark 里手动打一个标记，之后用「跳到下一个标记」在长输出里跳转。跑完一大段构建日志，用这个找起点很快。

iTerm2 的花样最多。除了搜索，还有 Copy Mode、Paste History、Instant Replay。Copy Mode 让你用键盘在输出里移动和选择，不用鼠标。Paste History 记着最近粘贴过的东西。Instant Replay 能把终端画面倒回去，误操作之后不用重跑。

Ghostty 的搜索够用。配合 Shell Integration，还能按提示符跳转，在几条命令之间快速定位。

配置字体和主题

三款都能改字体、字号、颜色、透明度和光标样式，入口不一样。

Terminal 在「设置」→「描述文件」里改。一个描述文件就是一套外观加启动命令，可以建多个，给不同场景用。

iTerm2 在「设置」→ Profiles → Colors 和 Text 里改。它支持导入现成的配色方案，网上能下到几千套。

Ghostty 走文本文件。配置文件默认在这里：

第一次用，先把目录和文件建出来：

一份可以直接用的配置：

语法就是 键 = 值，# 开头是注释。空值表示恢复默认：

配置文件可以拆。用 config-file 引入另一份：

改完不用重启，Command + Shift + , 重新加载。少部分设置只对新窗口生效。

文本配置的好处是能进 git。换电脑时把文件一拷，终端就跟着走。

保存常用会话

每天重复的那套窗口，三款都能存下来。

Terminal 用「窗口组」。把常用的一组窗口摆好，Window → Save Windows as Group，勾上启动时打开。下次开 Terminal，整套窗口按原样回来。

iTerm2 用 Profile 加 Hotkey Window。给不同项目配不同 Profile，打开时自动套用对应的字体、颜色和启动目录。最常用的一个再绑全局快捷键，随时呼出。

Ghostty 用 Quick Terminal。配一个全局快捷键，按一下从菜单栏下面滑下来一个临时终端。它不保存整套窗口，但胜在随叫随到。

六、进阶：Shell Integration 和 AI

Shell Integration：让终端知道你在哪

iTerm2 的安装入口有两个。

菜单：iTerm2 → Install Shell Integration，按提示走完，重开一个窗口。

如果中断一直转圈选命令行安装

命令行（macOS 自带 zsh）：

这条会下载集成脚本、安装 imgcat、it2copy 这些工具，并往 ~/.zshrc 里加一行 source。脚本会改你的 shell 配置，装之前先备份：

装完执行：

或者新开一个 iTerm2 窗口。它只在 iTerm2 里生效，Terminal 和 Ghostty 用不上。

装完之后，终端能拿到当前目录、上一条命令的退出码、命令开始和结束的位置。自动补全、目录跳转、命令状态这些功能才有基础。

Ghostty 默认会自动检测 bash、zsh、fish、elvish，并注入集成脚本。装好就有，不用手动点菜单。

Terminal 没有 Shell Integration。「当前目录」这类信息要靠自己写提示符或者用第三方工具。

iTerm2 的 AI Chat：让终端解释报错

3.7 版本的重点功能。Session → Open AI Chat 打开。

它可以链接当前会话，解释终端输出，也能生成命令。选中一段报错，用 Edit → Explain Output with AI，它会开一个新会话，把这段输出解释给你听。

权限分得很细：查看终端状态、运行命令、替你打字、看历史、看 manpage、写剪贴板、写文件、操作浏览器。每一项都能设成 never、ask、always。

默认建议全设成 ask。 尤其是「运行命令」和「写文件」，别一上来给 always。

iTerm2 支持 Ollama、OpenRouter、Qwen、MiniMax 这类 OpenAI 兼容接口，本地模型也能接。

Ghostty 的 Quick Terminal：随叫随到的下拉终端

Quick Terminal 是一个从菜单栏下面滑下来的临时终端。配一个全局快捷键，任何时候按一下就能用，再按一下收回去。

适合查一条命令、看一个日志、临时跑个脚本。不用切窗口，也不用在 Dock 里找。

它和 iTerm2 的 Hotkey Window 是一个思路。Ghostty 用的是原生动画，跟系统的手感更一致。

Terminal 的自动化：AppleScript 和窗口组

Terminal 的功能不多，但 AppleScript 支持一直在。想自动化开窗口、发命令、切描述文件，够用。

窗口组能把一组窗口存下来，下次按原样打开。连服务器、开项目、跑本地服务，一次配好，以后一键恢复。

AI 编程工具怎么摆：一屏三块

Claude Code、Codex 这类工具都跑在终端里。它们不占单独的窗口，就占你当前这个。

最顺的摆法是三块：

左边跑 AI，让它读代码、改文件。

右上跑命令，git status、npm run dev、测试。

右下看日志，出错直接往左一拖，或者复制过去。

屏幕小就换成三个标签，一个项目一个标签。iTerm2 的 Workgroups 能把这一套存下来；Ghostty 靠重启恢复窗口布局。

别把 AI 和它要改的项目分在两个终端应用里。 同一个应用里分屏，复制路径、看输出都少一步。

让终端替 AI 打下手

AI 时代，终端多了一个角色：给 AI 递材料、收结果。

第一，把报错完整地递过去。 终端里的报错经常几百行，鼠标拖不全。iTerm2 用 Copy Mode 键盘选，Ghostty 配合 Shell Integration 按提示符跳转，Terminal 用标记定位。选完直接粘进 AI 对话框。

第二，长任务别盯着。 AI 跑测试、构建、批量改文件，几分钟到几十分钟。iTerm2 的 Triggers 可以匹配输出里的关键字，弹通知；Terminal 可以开 bell。去干别的，响了再回来看。

第三，会话别丢。 AI 会话往往跑很久，终端一关，进程就没了。用 tmux 把会话挂在后台；iTerm2 的 Session Archives、Terminal 的窗口组、Ghostty 的重启恢复能保住布局和回滚，但保不住正在跑的进程。要保进程，还是 tmux。

第四，回滚调大。 AI 一次输出几百行，默认回滚不够用。iTerm2 可以设成 unlimited，Ghostty 改 scrollback-limit，Terminal 在描述文件里调。搜报错时不用翻半天。

第五，AI 给的命令，先看再跑。 终端是最后一道闸。rm -rf、git reset --hard、DROP TABLE 这类命令，AI 生成得再顺，也先在终端里看一眼。iTerm2 的 AI Chat 权限设成 ask，别给 always。

七、坑集锦

坑一、把终端当 Shell

换了终端，node 找不到、npm 没反应，第一反应是终端坏了。

不是。终端只负责显示和执行环境，命令是 Shell 跑的。这类问题多半出在 PATH、Shell 配置文件、Node 版本管理器上。

排查顺序：先看 echo $SHELL，再看 which node，最后看 .zshrc 里有没有改 PATH。

坑二、iTerm2 没装 Shell Integration

iTerm2 的很多功能依赖 Shell Integration。没装，当前目录、命令状态、自动补全都不完整。

菜单里点 iTerm2 → Install Shell Integration，按提示装完，重开窗口。

如果自定义了提示符，可能会和集成脚本打架。先装官方脚本，再改提示符。

坑三、Ghostty 配置写错位置

Ghostty 会按顺序找几个位置：

两个都写，后面的会覆盖前面的同名项。只改一个，别两边都放。

改完按 Command + Shift + , 重新加载。部分设置只对新窗口生效，不生效就新开一个。

坑四、字体和连字

不是所有等宽字体都带连字。字体里没有，终端开了连字也显示不出来。

中文字体也要确认。只带拉丁字符的编程字体，遇到中文会回退到系统字体，行高和字宽可能对不齐。

最稳的办法：选一个带中文的等宽字体，或者把英文字体和中文字体分开配。

坑五、AI 权限开太大

iTerm2 的 AI Chat 能看终端、跑命令、写文件、操作浏览器。权限给大了，等于把一个能执行命令的助手放进了生产环境。

刚开始全部设成 ask。确认它要做什么，再点同意。

「运行命令」和「写文件」这两项，不要设 always。

坑六、迁移配置别指望一键

Terminal 的描述文件能导入导出。iTerm2 的 Profiles 也能导入导出。Ghostty 直接拷配置文件。

但快捷键、Shell Integration、主题、字体要重新对一遍。换电脑前先导出一份，别等旧电脑还了才想起来。

坑七、macOS 版本门槛

iTerm2 3.7 和 Ghostty 1.3 都要求 macOS 13 或更高。

旧系统只能装旧版本，或者继续用 Terminal。装之前先看一眼「关于本机」。

八、速查表

需求	Terminal	iTerm2	Ghostty
新标签	`Command + T`	`Command + T`	`Command + T`
分屏	`Command + D`	`Command + D`	`Command + D`
搜索	`Command + F`	`Command + F`	`Command + F`
设置	`Command + ,`	`Command + ,`	改配置文件
Shell Integration	无	菜单安装	自动
全局呼出	无	Hotkey Window	Quick Terminal
AI 会话	无	AI Chat	无

安装命令：

选型就看三件事：

一周用不了几次：Terminal。

每天写代码、跑服务、连服务器：iTerm2。

想要原生手感和文本配置：Ghostty。

九、最后

三款终端，三条路。

Terminal 胜在不用管。iTerm2 胜在什么都有。Ghostty 胜在轻、快、原生。

先选一个顺手的用起来。等你真的被某个功能卡住，再换也不迟。个人感觉可以先用Ghostty：Terminal 过轻，iTerm2偏重，Ghostty刚刚好！

我是想风@xaiwind，一个关注出海与 AI、AIGC 的创作者。

本文基于AI辅助与个人实践融合创作，如果文章对你有帮助，欢迎点赞、收藏、关注，

本人文章持续维护欢迎联系或者评论区见，每天进步一点，我们终会到达目的地！

参考来源：

Apple Terminal 使用手册：https://support.apple.com/guide/terminal/

iTerm2 官网：https://iterm2.com/

iTerm2 功能列表：https://iterm2.com/features.html

iTerm2 AI Chat 文档：https://iterm2.com/documentation-ai-chat.html

Ghostty 官网：https://ghostty.org/

Ghostty 功能列表：https://ghostty.org/docs/features

Ghostty 配置文档：https://ghostty.org/docs/config

版本核对：Terminal 2.15、iTerm2 3.7.6、Ghostty 1.3.1（2026 年 10 月）

超简单 PI Agent ，入门到精通，个人智能体的王者

Thu, 22 Oct 2026 00:00:00 GMT

大家好，我是想风！

今天来看 Pi（Pi Coding Agent），一个极简、可以自己改自己的智能体框架，本篇写给新手小白，新手也能学会！

标题里写的 PI Agent，就是 Pi。它的 npm 包名是 @earendil-works/pi-coding-agent，命令只有两个字母：pi。

这是什么

下载和安装

界面认一遍

上手：一节一件事

坑集锦

它在生态里的位置

最后

一、这是什么：一盒能自己改自己的积木

Pi 是一个跑在终端里的 AI 编程智能体。你用自然语言下任务，它读文件、跑命令、改代码。和 Claude Code、Codex 干的是同一类活。

路线不一样。

官方把 Pi 叫作 minimal agent harness，最小智能体外壳。内核只保留最基本的工具循环，其他能力全部拆出去，交给扩展。

官网挂着一句原话：Adapt Pi to your workflows, not the other way around. 让 Pi 适应你的工作流，不是让你适应它。

这句不是标语，是产品设计。它默认连 plan mode、sub-agents 都不带，权限系统也不内置。想要，自己装。

对比项	Pi	Claude Code、Codex 这类成品
内核	最小，只留基本循环	大而全
开箱功能	少，计划模式、子智能体都要另外装	多，装完就能干活
扩展	技能、扩展、提示词模板、主题，都能打包分享	有官方扩展点，改不到最里面
权限	没有内置权限系统，靠容器隔离	自带审批流程
适合谁	想养一个自己的智能体	想马上把活干完

为什么值得花时间学它？

大多数智能体是成品家电。功能多，流程固定，你只能按它的方式用。

Pi 是一盒积木。技能、扩展、提示词模板、主题，四样东西都能自己写，打包成 Pi package，发到 npm 或 git，别人一条命令就能装。

它还是 MIT 协议。15 家以上模型商，几百个模型，Anthropic、OpenAI、Google、Bedrock、Ollama 都能接，不绑死一家。

它有四个使用模式：交互、打印/JSON、RPC、SDK。一个内核，终端能用，脚本能用，自己的程序里也能嵌。

会话存成树，不是一条线。聊到一半想试另一个方向，回到任意节点开分支，原路不丢。

标题说它是个人智能体的王者。王者不在功能表最长，在于装完之后，这东西是你的。你往里装什么，它就长成什么样。

二、下载和安装

前置条件只有一条：Node.js 22.19 或更高。

三条安装路，挑一条。

第一条，官方脚本。 macOS 和 Linux 用这行：

Windows 用 PowerShell：

第二条，npm。

第三条，Nix。

三条路的区别在依赖：官方脚本会锁定版本，npm 不锁传递依赖，Nix 从源码构建。想省心，用第一条。

装完验证：

装完先做三件事(或可选第三方登录)

第一件，连上一个模型。 直接敲 pi 进界面，再输入 /login，按提示选模型商。也可以用环境变量：

第二件，定默认模型。 配置文件在 ~/.pi/agent/settings.json：

不写也行，启动时用 --provider 和 --model 临时指定。

第三件，想清楚隔离。 Pi 没有内置权限系统，跑起来就是你自己的权限。拿它碰不熟的项目之前，先把容器方案想好。这条放在坑一里细讲。

三、界面认一遍

敲 pi 回车，进的是终端界面，不是网页。

终端界面的布局每个版本会微调，不用背。真正要记的是几个键：

按键	作用
Enter	任务跑着时也能插话，马上生效
Alt + Enter	排队，等当前这轮干完再发
Ctrl + L	切换模型
Ctrl + P	在收藏的几个模型之间轮换
`/`	打开斜杠命令

斜杠命令常用的有这几个：

界面不花哨。它的价值不在好看，在于你能一边看它干活，一边改它的方向。

四、上手：一节一件事

先登录，再选模型

第一次用，先确认模型通不通。

思考等级有七档：off、minimal、low、medium、high、xhigh、max。日常改代码用默认档就够，复杂重构再往上调。

模型没通，后面全是白搭。

第一个任务：先让它读，别让它写

进项目目录，开一个只读任务：

这一步是摸清它的脾气。它读文件、列目录、跑只读命令，你看它理解得对不对。

想更保险，直接把工具锁死成只读：

这里有个容易踩的点。内置工具里，read、bash、edit、write 默认开着，grep、find、ls 默认是关的。它想自己搜文件，得手动打开：

会话是一棵树

每次对话都会存成一个 session。默认放在 ~/.pi/agent/sessions，可以用 --session-dir 改地方。

常用的几条：

聊到一半想换方案，在界面里敲 /tree。回到任意一个节点，开新分支。原分支还在，随时能切回去。

这条比「重新开一个对话」省太多事。上下文不用重新喂。

边跑边改：Enter 和 Alt + Enter

Pi 干活的时候，输入框没锁。

发现它方向不对，直接按 Enter 打一句「别动数据库，只改前端接口」。这句话会立刻插进去，它当场调整。

手上还有下一件事，按 Alt + Enter。这句话排队，等当前这轮干完再发。

区别就一个：Enter 是现在说，Alt + Enter 是等会儿说。

教它新本事：技能、扩展、模板、主题

四样东西，分工不同：

技能（skills）：一份 Markdown 说明书，加可选的脚本和资料，告诉它某类任务怎么做。放在 ~/.pi/agent/skills，启动时自动发现。

扩展（extensions）：真正的代码。能加工具、加命令、加启动参数。

提示词模板（prompt templates）：Markdown 写的常用提示词，不用每次重打。

主题（themes）：终端配色。

这四样打包起来，就是 Pi package，可以发到 npm 或 git。

装包、看包、卸包：

只想临时用一个技能，不装进全局：

新手最容易忽略 pi config。装了一堆包，不是每个都想常开。这个面板能按项目开关，Tab 键切换范围。

自动化：脚本、事件流、RPC、SDK

交互界面只是四种用法里的一种。

-p 是打印模式，一问一答，干完走人。--mode json 把过程拆成一条条 JSON 事件，方便程序读。

再往上一层是 RPC 模式和 TypeScript SDK。RPC 用 --mode rpc，让另一个程序控制一个独立的 Pi 进程。SDK 直接把 Pi 嵌进自己的 TypeScript 应用。

想把 Pi 塞进自己的工作流，这三层够用了。

让它改自己

Pi 的扩展、主题、提示词，都是磁盘上的文件。

你可以直接让它改自己：

改完敲 /reload，不用重启，新代码立刻生效。

这是 Pi 和成品智能体最不一样的地方。成品你只能等厂商更新，Pi 可以当场长出新器官。

MCP 和 Codemode

MCP 是内置的。它是一个让 AI 连外部工具和数据的标准，第一次见可以理解成「给智能体装 USB 接口」。

Codemode 是另一层：让智能体把一串工具调用写成 JavaScript，在沙箱里一次跑完。

工具调用多的时候，省的是来回次数。适合流程固定、步骤多的活。

五、坑集锦（这部分值回票价）

坑一、它没有内置权限系统

这是最需要先知道的一条。

Pi 以启动它的用户权限运行。你能读的文件它能读，你能删的它能删，你能连的网络它能连。官方文档写得很直白：文件、进程、网络、凭据，都没有内置限制。

官方给的方案是上容器。Gondolin 微虚拟机扩展、普通 Docker、OpenShell，三种都可以。

别拿它直接跑在生产机上，也别在放着密钥的目录里裸跑。

坑二、默认没有 plan mode 和子智能体

这是故意的，不是缺功能。

官方文档写得很清楚：给零件，不给成品。计划模式、子智能体、权限检查，都留给扩展。

从 Claude Code 或 Codex 过来的人，第一次用会觉得「怎么什么都要自己装」。先接受这件事，再决定要不要装对应的包。

坑三、npm 安装不锁传递依赖

官方脚本会锁定依赖版本，npm 这条路不会。

供应链安全是 Pi 很在意的一件事。它的做法是锁直接依赖、强制 lockfile、安装时加 --ignore-scripts。

所以能用官方脚本，就别图省事走 npm。

坑四、grep、find、ls 默认是关的

第一次让它找文件，它可能绕一大圈。

内置工具里，read、bash、edit、write 默认开，grep、find、ls 默认关。想让它像别的智能体那样自己搜，启动时用 --tools 打开。

或者干脆让它用 bash 里的 grep。能用，但不如内置工具省 token。

坑五、项目里的资源要批准，批准不等于隔离

项目目录里如果带扩展、技能、配置，Pi 默认不会乱加载。

--approve 信任这个项目的本地文件，--no-approve 忽略它们。

但信任只解决「加载不加载」，不解决「跑起来安不安全」。官方安全文档专门写了这一句：项目信任控制的是加载哪些资源，不是给工具调用加沙箱。

批准之前，先看一眼项目里到底放了什么。

坑六、会话不命名，很快就找不到

Pi 把每次对话都存下来，这是好事。攒到几十上百条，-r 的列表就没法看了。

养成两个习惯：开长任务先 --name，重要节点用 /tree 分叉。

会话目录也能换。工作区和私人项目分开存，找起来快很多：

坑七、模型没配好，启动就卡住

Pi 的命令行默认 provider 是 google。机器上没有 Google 的 key，第一次启动就会卡在登录。

两条路：进去敲 /login，或者启动时直接指定：

模型名不用背。pi --list-models 会列出来，后面跟关键词还能模糊搜。

六、它在生态里的位置

Pi 不只是一个终端命令，它是一组 npm 包。

包	管什么
`pi-ai`	一个 API 接多家模型
`pi-agent-core`	工具调用和状态管理
`pi-coding-agent`	终端里那个 `pi`
`pi-tui`	终端界面库
`chord`	插件运行环境，支持热重载和 RPC
`pi-durable`	会话、任务、文档的存储
`pi-telemetry`	遥测数据的统一接口

想自己做一个智能体产品，可以只拿 pi-ai 加 pi-agent-core，界面自己写。想直接用，就装 pi-coding-agent。

它和 Claude Code、Codex 不是替代关系，是两条路线。要开箱即用，选成品。要一个能长成自己样子的，选 Pi。

最后

Pi 这篇真正要记住的，不是那几个命令，是它和成品智能体的分工。

三条记下来就够：

Pi 是积木，不是成品。 内核只留工具循环，技能、扩展、模板、主题、包，装什么长什么样。

它的强项是自由。 会话存成树，随时开分支；四种模式，终端、脚本、RPC、SDK 都能用；15 家以上模型商，不绑死一家。

它的弱项也要认。 没有内置权限系统，跑起来就是你的权限；plan mode 和子智能体默认没有，得自己装。

第一次用，按这个顺序走：

装完先 /login，把模型跑通。

第一个任务只给只读工具，先看它怎么读项目。

装一个技能或包，感受一下「扩展」是什么意思。

确认隔离方案，再放开写权限。

想开箱即用，Claude Code、Codex 更省事或者 Grok bot、Muse。想把定制智能体养成自己的样子，Pi 值得花时间。

标题说它是个人智能体的王者。王者不在功能表最长，在于装完之后，这东西是你的。

我是想风@xaiwind，一个关注出海与 AI、AIGC 的创作者。

本文基于AI辅助与个人实践融合创作，如果文章对你有帮助，欢迎点赞、收藏、关注，

本人文章持续维护，欢迎联系或者评论区见，每天进步一点，我们终会到达目的地！

参考来源：

官网：https://pi.dev/

GitHub：https://github.com/earendil-works/pi

命令行参数按本机 pi --version 0.87.1 的 pi --help 输出核对

从0到1 构建AI 知识工作流，Obsidian笔记进阶·高级玩法

Wed, 21 Oct 2026 00:00:00 GMT

大家好，我是想风！

今天来看 Obsidian 进阶玩法，本篇写给新手小白，新手也能学会！

上一篇讲的是从装软件到让 AI 接管整理。这一篇接着往上走。

块引用、Callout、属性搜索、Templater、Dataview、Canvas、MOC，还有批量维护和把库发成网站。

上一篇有句话：上手不难，难的是先想清楚拿它干什么。这一篇讲的是——想清楚之后，那些让库真正好用的玩法。

这篇不重复上一篇。 没看过的先补这一篇：[[从0到1 构建AI 知识工作流，Obsidian笔记入门]]

一、块引用：把笔记拆开，再拼到别处

上一篇讲了 [[双链]] 和 ![[图片]]。这一篇先补上第三个。

块引用是把一篇笔记里的某一段，单独拎出来引用或嵌入。

先给段落起一个名字

在任意一个段落的末尾，敲一个空格，加 ^ 和一个自己起的名字：

这个 ^rag-core 就是这段的坐标。它不显示在阅读视图里，只在编辑模式能看到。

命名规则：只能字母、数字、横杠，不能有空格和中文。

两种用法：链接和嵌入

链接（点一下跳过去）：

嵌入（把那一段直接显示在当前笔记里）：

链接和嵌入差一个感叹号，效果差别很大。链接是"去看那里"，嵌入是"把内容搬过来"。

嵌入的好处是：原文改一次，所有引用它的地方一起变。 一段结论被五篇文章引用，改一处，五处同步。

不只是块，整节也能嵌

不用给块起名，直接嵌一个小标题下面的全部内容：

这个用法适合"汇总页"：把散在各篇里的相关小节，嵌到同一页上，读起来是连贯的一段。

一个提醒： 别嵌得太深。A 嵌 B、B 嵌 C、C 又嵌回 A，Obsidian 会陷进去。嵌入保持一层就够。

二、Callout：让重点自己跳出来

Callout 是一段带类型、带颜色、能折叠的特殊引用块。

上一篇的名词表里提过 Callout，没展开。它其实很简单，就是普通引用前面加一个方括号。

最小语法

渲染出来是一个带图标的彩色块。[!note] 那个词叫类型，决定颜色和图标。

常用的几种类型

类型	长什么样	什么时候用
`note`	蓝，信息	补充说明
`tip`	绿，灯泡	小技巧
`warning`	黄，感叹	注意
`danger`	红，闪电	危险操作
`example`	紫，列表	举例
`quote`	灰，引号	引用原话
`question`	橙，问号	待解决的问题
`bug`	红，虫子	已知问题

warning 和 danger 是这两个最实用的。 写教程的时候，"这一步会清空数据"用 danger，读者一眼就知道要停一下。

折叠：默认收起

在类型后面加一个减号，这个块默认是收起来的，点一下才展开：

加号 + 则是默认展开、可以手动收起。

长文里折叠特别值钱。 一篇教程里塞了十几条坑，全文铺开会把人吓走；收起来，读者想看的自己点开。

一个容易忘的细节

Callout 里面的每一行，前面都要带 >。少一个，那一行就掉出块外面了。

三、搜索进阶：按属性搜、按路径搜

上一篇讲了 Cmd+Shift+F 全局搜索。这一篇讲三个更精确的搜法。

按位置搜：file 和 path

file: 和 content: 的区别，就是搜标题还是搜正文。

按属性搜：frontmatter 变现的地方

上一篇定了 frontmatter 五个字段。这一篇告诉你它们能用来干什么。

Obsidian 较新版本支持按属性搜索，写法是方括号：

这就是规范 frontmatter 的真正回报。 字段填得规范，库就变成了一个能按条件筛的小数据库。

搜"还没整理的"最有用：

出来一堆闪念笔记，扫一眼就知道该处理哪些。

组合起来

意思是：在个人知识文件夹里，找出打了 AI 标签、正文提到 RAG 的笔记。 条件叠得越多，结果越准。

把搜索存下来

在笔记里写一个 query 代码块，这段搜索结果会实时显示在这篇笔记里：

它是一张活的清单。 处理完一条，它自己就从列表里消失，不用手动维护。

四、Templater：让模板动起来

上一篇讲了核心的「模板」插件。它有个短板：只能插固定文字，不能算日期、不能取文件名。

Templater 补的就是这个。上一篇把它列在"想清楚再装"里，现在可以装了。

装和设

社区插件里搜 Templater，装上、启用。

设置里指定一个模板文件夹，比如 98 模板。之后插入模板的姿势和自带模板一样。

三个最常用的变量

tp.date.now() 是核心。 日记模板里写死 created: 2026-10-03，第二天用还是这个日期；写成变量，用哪天就是哪天。

一个日记模板的骨架：

新笔记一建出来，日期、标题全填好了，光标停在待办那一行。 比手打快，也不会漏字段。

和自带模板怎么分工

ㅤ	自带模板	Templater
插入固定文字	能	能
算日期	不能	能
取文件名	不能	能
跑脚本	不能	能

只用固定模板的话，自带的够。 一旦发现"每次都手动改日期"，就换 Templater。

再来一个例子：读书笔记

日记模板只用到日期。更日常的场景是"每本书一篇笔记"：

新建笔记时把书名当文件名，title 就自动填上了，不用再手打一遍。

规律是：变量填的地方，都是"每次不一样、又必须填"的那几个。 日期、标题、文件名，全都是这一类。

常用变量

三个之外，这几个也常用：

tp.date.now() 的第二个参数是天数偏移，填 7 就是一周后。

tp.system.prompt() 适合"每次都要换个名字"的字段，比如项目名、客户名。插入模板的那一刻弹一个小框，填完就进正文。

让它自己套模板

手动插模板，还是会忘。Templater 里有个文件夹模板：约定"某个文件夹下的新笔记，自动用某个模板"。

比如把 100 日记/ 绑到日记模板，把读书笔记那个文件夹绑到读书模板。

配好之后，在对应文件夹里新建笔记，模板自己就上去了。 这是 Templater 比自带模板强得最明显的一处。

想再强一点：写一行 JS

<% %> 是输出结果，<%* %> 是执行一段 JS 但不输出。

多了一个 *，就能干"改文件名""挪文件夹"这类动作：

这一层新手用不上，知道有这么个口子就够。等哪天发现"这个动作每天重复三遍"，再回来查。

五、Dataview：把库当数据库查

上一篇把 Dataview 列在"想清楚再装"里。它是 Obsidian 里最能改变用法的一个插件，但也最容易装完不会用。

Dataview 用一段查询，把散在各篇笔记里的属性，汇总成一张动态的表。

前提：frontmatter 得规范

Dataview 只认 frontmatter。 字段名写错一个字母，它就查不出来。

所以顺序是：先把上一篇那五个字段用起来，攒上一两百篇，再来装 Dataview。顺序反了，会觉得它没用。

三种查询：LIST、TABLE、TASK

LIST：列出一组笔记的链接

TABLE：把属性做成表格

TASK：把所有待办汇总出来

TASK 这个最实用。 日记里随手写的 - [ ]，散在几十篇里，这一条查询把它们全捞出来，汇成一张总待办。

语法就四块

会这四块，日常够用了。 剩下的嵌套、分组、计算，用到再查。

它和 Bases 的关系

Obsidian 后来出了原生的数据库功能（.base 文件），想法和 Dataview 类似，但不用装插件。

两者取舍： 想少装插件、跟官方走，可以试原生那个；想要更细的查询语法，用 Dataview。具体在你客户端里是哪个版本、长什么样，以你界面为准——这类新功能更新快，我不替你打包票。

六、Canvas：一块白板理清关系

Canvas 是一张无限大的白板，上面可以放笔记卡片，再用线连起来。

左上角新建时选 Canvas，就得到一块空白画布。

三种放法

双击空白 → 新建一张卡片

从左侧文件树拖一篇笔记进来 → 变成一张引用卡，编辑原笔记它跟着变

拖图片、拖 PDF 进来 → 也能放

两张卡片之间拖一条线连起来，还能在线上写个字说明关系。

三个真正好用的场景

一、主题地图。 一个主题下所有相关笔记，摊在一张画布上，谁和谁近、哪块是空白，一眼看清。这比图谱好用——图谱是自动生成的，画布是你亲手摆的，带判断。

二、项目规划。 左边放"要做的"，右边放"做完的"，用线标出依赖。比纯列表多一个空间维度。

三、梳理一篇文章的论证。 论点放中间，论据围一圈，连上"支持"或"反驳"。

两个要知道的

画布文件是 .canvas，内容是 JSON。 里面存的是笔记的路径引用，不是笔记本身。所以别随便改笔记的文件名，改了画布上的卡片会断开。

别用画布当仓库。 它适合理关系，不适合存内容。内容还是放笔记里，画布只放链接。

七、MOC：比入口笔记更进一步

上一篇的入口笔记是"把这一层列出来"。MOC 是它的升级版。

MOC 全称 Map of Content，内容地图。围绕一个主题，把相关笔记按逻辑排成一页。

和入口笔记差在哪

ㅤ	入口笔记	MOC
按什么排	文件夹层级	内容逻辑
谁生成的	可以让 AI 批量生成	得自己想
会不会变	结构稳定	随理解加深一直在改

入口笔记是目录，MOC 是文章。 目录告诉你有哪些东西，MOC 告诉你这些东西之间是什么关系。

一个 MOC 长什么样

最后那一块"还没想明白的"是关键。 它把"我卡在哪"也记下来了，下次接着想。

什么时候该建 MOC

一个主题攒到七八篇笔记的时候。 少于这个数，直接看标签就够了；多了，才需要一个地方把逻辑理出来。

MOC 不用一次写完。 先列条目，读到新的往里加，理解变了就调整顺序。它是一份一直在长的东西。

八、批量维护：Linter 和批量改属性

库用久了，会出现一堆不一致：有的笔记 frontmatter 少字段，有的标题前后空行不一样，有的标签写成 #AI 有的写成 #ai。

手工改几十上百篇不现实。这一节讲两个批量处理的办法。

Linter：一键统一格式

社区插件搜 Linter，装上。

它能做的事：统一 frontmatter 字段顺序、补上缺失的字段、统一标题层级、删掉多余空行、统一列表符号。

配置好规则，可以设置成"保存时自动整理"。 之后每篇笔记一存，格式自动对齐。

注意：第一次全库跑之前先 commit。 Linter 会动很多文件，改坏了要有退路。

批量改属性：交给 AI

格式之外的事——改内容、改分类、统一叫法——交给 AI：

三个细节：

先说"先给我看"，别让它直接动手。看一眼清单，确认没问题再让它执行。

一次只做一类改动。 同时改标签、补字段、改分类，出了问题分不清是哪一步。

先 commit，再跑。 这条和上一篇讲 Git 时是同一个道理。

九、同步的进阶：三种方案怎么选、冲突怎么办

上一篇提了三种同步方式。这一篇讲怎么选，和出了冲突怎么办。

三种方案对比

ㅤ	官方 Sync	Git	第三方同步（Syncthing 等）
费用	付费	免费	免费
版本历史	有	完整	看方案
上手难度	最低	要会命令行	中
适合谁	不想折腾的	想要历史的	想省钱又能折腾的

最省心的是官方 Sync，最省钱的是 Git。 两个都想省钱又省心，往往最后两个都没配好——先选一个跑起来。

冲突是怎么产生的

两台设备同时改了同一篇笔记，同步工具不知道该听谁的，就会生成一个副本：

根本原因是"两边都改"。 所以最省事的规矩是——同一时间只在一台设备上编辑。手机上只记不整理，就是这个道理。

出了冲突怎么办

别急着删副本。两个文件都打开，对比一遍，把要的内容并到主文件里，再删副本。

如果用了 Git，git diff 能直接看出两个版本差在哪，比人眼比快得多。

一条经验

同步目录别放在会实时双向同步的网盘里，这条上一篇的坑 1 讲过。真要放，用手动单向上传，不要双向。

Git 同步：怎么配

思路很简单：整库放进一个私有仓库，每台设备各克隆一份。配之前先定两件事。

一、.gitignore 先忽略工作区文件。 .obsidian/workspace.json 记的是"当前开着哪几个标签页"，开开关关就变，同步它只会攒一堆没意义的提交。

二、.obsidian/ 的其余部分，看需求。 这里面存的是插件列表、主题、快捷键。想让几台设备长得一模一样，就同步它；想各配各的，就一起忽略。

手机端怎么办

移动端跑不了命令行，Git 得靠第三方插件，出问题不好修。

能用电脑同步就用电脑。手机只当"查看 + 随手记"的终端——这跟前面"同一时间只在一台设备编辑"是一个思路。

接着上一条说：网盘同步的两个麻烦

iCloud、坚果云、Dropbox 直接指到库文件夹，是最省事的。两个麻烦绕不开：

一、.obsidian/ 被一起同步，两台设备的插件设置互相打架。 结果是每换一台设备，侧边栏和插件都变样。

二、文件一多，网盘会卡。 几千个小文件，增量同步经常转圈。

能排除 .obsidian/ 就排除；不能排除，就别指望它在几千篇的库上还顺畅。 判断标准只有一条：同步完，两台设备打开是同一个样子。

最后补一句：同步不等于备份

同步做的事，是把改动在设备之间传开——两边一起删，就是真的没了。

重要的库另外留一份离线快照：导出个压缩包，或者定期推到 Git 远端。同步管的是"多设备一致"，备份管的是"出事能回来"，是两件事。

十、把库变成网站

库是纯文本，所以它能直接变成一个网站。这一节讲两条路。

付费的：Obsidian Publish

官方出的发布服务，选几篇笔记，点一下就上线，还带搜索和关系图。

好处是零配置，把哪些笔记公开，勾一下就行。代价是付费，而且样式定制空间有限。

免费的：Quartz

Quartz 是一个开源项目，能把 Obsidian 库编译成一个静态网站。生成的站点可以直接放 GitHub Pages。

流程大致是：

它认 Obsidian 的语法，双链、Callout 都能正常渲染，双链点进去能跳转到对应页面。

免费的代价是要会一点命令行。 但配好之后，npx quartz sync 一条命令就更新。

发之前一定要想清楚的一件事

哪些笔记能公开。

库里往往混着日记、工作记录、还没定稿的想法。发布前必须过一遍：

日记要不要发？多半不要

99 归档/ 要不要发？多半不要

带别人名字、带客户信息的，一定要排除

做法： 发布工具的配置里写死"只发布哪些文件夹"，比"排除哪些文件夹"安全——默认不发，主动挑着发。

十一、大库维护：几千篇之后

库小的时候什么问题都没有。过了几千篇，会开始出现几个症状。

三个常见症状

一、图谱变成一团毛线。 节点太多，连线糊成一片，看不出东西。

二、出现一堆孤儿笔记。 没有任何链接指向它们，也从不被搜到。

三、同一个概念散在多篇里。 三篇笔记都在讲同一件事，互相不知道。

定期做一次体检

每隔一两个月，让 AI 扫一遍：

先让它报告，不动手。 看完报告，再决定哪些要合并、哪些要补链接、哪些直接归档。

归档，不要删

不用的笔记，移到 99 归档/，别删。

理由： 双链还在。删掉一篇，所有指向它的链接变成断链；归档，链接还通，只是内容不在主流里了。

性能上的三个开关

库变卡，八成是这三样：

症状	原因	处理
打开慢、搜索慢	附件太多太大	清 `04 附件/`，PDF、音频挪出库外
启动慢	插件太多	关掉三个月没打开的
图谱卡	节点过万	图谱本来就不常看，用到再开

这三条都不是"库不行了"，是可清理的地方堆多了。

十二、进阶坑集锦

七个坑，踩过才知道。

坑一：块 ID 手打错。 ^rag-core 写成 ^ragcore，引用就断了，而且不报错，只是嵌不出来。块 ID 尽量用复制，别手打。

坑二：frontmatter 不规范就上 Dataview。 字段名大小写不一致、有的有有的没有，Dataview 查出来是空的。以为插件坏了，其实是数据没规整。先规范，再查询。

坑三：Templater 覆盖了已有内容。 插入模板时不小心把整篇选中替换掉，原内容没了。插入模板前先光标归位，别全选。有 Git 的话，一条命令能救回来。

坑四：直接手改 .canvas 文件。 画布是 JSON，手改一个括号，整个画布打不开。要改就在画布里拖，别去动源文件。

坑五：发布网站时把自己日记带出去了。 发布配置写成"排除某些文件夹"，新加一个文件夹就漏了。反过来配：默认不发，主动挑要发的。

坑六：批量改属性之前没 commit。 AI 一口气改了三百篇，改完发现标签全错了，又没退路。动批量的活之前，先 commit 一次。

坑七：把画布当成仓库用。 往画布卡片里写长内容，越用越乱。画布只放链接和短结论，长内容留在笔记里。

十三、速查表（进阶）

一条总原则：进阶玩法的前提，是基础规范先做到。 frontmatter 填规范了，属性搜索和 Dataview 才有东西可查；笔记分好类了，MOC 和画布才理得清。先把基础用三个月，再来加这些。

最后

这一篇讲的东西，入门阶段可能不怎么用得上。但它们决定你的库是停在五百篇，还是能长到五千篇。

三条记下来就够：

块引用和 Callout 是给长文用的。 短笔记不用，长教程离不开。

属性搜索和 Dataview 的回报，来自 frontmatter 的规范。 规范是投入，查询是回报。

画布和 MOC 是"想"的工具，不是"存"的工具。 存内容还是靠笔记。

上一篇结尾说，难的是先想清楚拿它干什么。这一篇可以补一句：想清楚之后，规范先做到位，高级玩法才有价值。 顺序反了，装再多插件也是花架子。

篇幅有限，还有没讲到的——QuickAdd 快速捕获、间隔重复复习、CSS 片段改样式，以后单独开篇。

我是想风@xaiwind，一个关注出海与 AI、AIGC 的创作者。

本文基于AI辅助与个人实践融合创作，如果文章对你有帮助，欢迎点赞、收藏、关注，

本人文章持续修正欢迎联系或者评论区见，每天进步一点，我们终会到达目的地！