静轩之别苑

如何像 Elon Musk 一样思考？第一性原理的应用与实操指南

nicejade — Mon, 15 Sep 2025 12:27:41 GMT

第一性原理（First Principles Thinking） 是一种回溯事物本质、将复杂问题拆解为最基本要素，再从这些基本要素重组出解决方案的思维方式。它帮助我们跳出思维定式，找到更高效、更经济的解决之道。本文将通过 埃隆·马斯克（Elon Musk）的思维方式，结合 日常生活案例与实操练习，带你从“理解概念”到“学会应用”，真正掌握这一思维利器。

什么是第一性原理？

第一性原理（First Principles Thinking）源于古希腊哲学家亚里士多德的观点：“每个系统中存在一个最基本的命题，它不能被违背或删除。”

简而言之：👉 把问题拆到最基础的事实，再从这些事实重新出发，设计解决方案。

一个形象的比喻是：像玩乐高积木，先把成品拆掉，拿到最小的积木块，再用它们搭建全新的形状。

核心思维方法

分解 —— 拆解复杂问题，找到最基础的要素；
重构 —— 基于这些要素重新组合；
突破 —— 摆脱经验与类比，创造新方案。

实际应用步骤

明确目标 —— 我到底要解决什么问题？
深入拆解 —— 把问题层层剥离，找到基本要素；
检验假设 —— 不轻信惯性思维，逐一验证假设；
重新组合 —— 基于事实而非常识，提出方案；
持续迭代 —— 反复试验，不断优化。

实用性建议

培养好奇心：不轻易接受“这是常识”。
多问“为什么”：每个答案都追问下去。
关注基础规律：以客观事实为基石，而非人云亦云。
空杯心态：放下经验和偏见，重新审视问题。

Elon Musk 如何使用第一性原理？

特斯拉与电动汽车
- 不接受“电动车制造必然昂贵”的常识。
- 拆解成本，发现原材料价格远低于成品。
- 结论：如果自己造电池并优化工艺，成本可以大幅下降。
SpaceX 与可重复使用火箭
- 质疑“火箭必须一次性使用”的行业共识。
- 回到物理层面，探索重复利用的可行性。
- 结果：可回收火箭大幅降低了太空探索成本。
超级高铁 Hyperloop
- 不接受“高速铁路就是唯一解”的思路。
- 从物理规律和运输效率出发，提出新型方案。

总结：马斯克的思维秘诀是——质疑常识、拆解事实、重建逻辑。

如何应用于日常生活？

以“如何吃得健康又经济”为例：

明确问题
- 需求：身体健康 + 控制支出。
拆解要素
- 营养构成：蛋白质、碳水、脂肪、维生素、膳食纤维。
- 成本构成：原料、加工、运输、品牌溢价。
重建方案
- 买原料而非加工品；
- 当季本地食材，减少运输成本；
- 批量购买，自主烹饪。
验证效果
- 记录饮食支出，跟踪营养与健康状况，持续优化。

新手快速上手：实操指南

一句话记忆：拆掉常识 → 留住事实 → 重新组合

三步练习法

写下假设：把“理所当然”的观点列出来。
- 例：“学英语必须报班”。
追问为什么：逐层拆解，直到剩下不可否认的事实。
- 事实：学习语言=输入+输出。
重建方案：基于事实，想出新方法。
- 方案：用免费资源+AI 对话替代报班。

每日 5 分钟训练

每天一个问题：今天买的、做的、听到的，随便挑一个。
写练习卡片：假设 → 事实 → 新方案。
一周复盘：看看哪些方案最有价值。

常见误区

❌ 把“第一性原理”当成推翻一切。
✅ 正确做法：找到“硬事实”，不是否定一切经验。

❌ 只停留在空想。
✅ 正确做法：立即尝试小实验，验证方案可行性。

结语

第一性原理不是一个“高冷哲学”，而是一种人人可学的思维工具。

它能让你在 学习、工作、生活 中，迅速跳出思维定式。
它能帮助你找到 更本质、更高效 的解决方法。
它能让你在面对复杂问题时，有勇气从零开始。

AI Agent 工程化十二要素详解

nicejade — Tue, 22 Jul 2025 08:38:31 GMT

这个项目是 HumanLayer 团队提出的“12‑Factor Agents”，借鉴 Heroku 的 12‑Factor App 方法，总结出构建生产级 LLM Agent 的十二条工程原则，覆盖从 结构化工具调用、Prompt 管控、上下文管理、状态与控制流分离，到 人机协作、无状态设计、错误处理 等关键逻辑。其价值在于将不确定的 LLM 整合到“可靠、可扩展、易维护”的成熟软件架构中，帮助开发团队跨越常见的 70‑80% 可用性瓶颈，将 AI Agent 真正推向生产环境。

12‑Factor Agents 项目内容体系略显庞大，涵盖从工具调用到状态管理的十二个核心维度，对于初学者而言理解门槛较高。为降低学习成本，提升开发效率，特别借助 Claude Sonnet 4 的强大分析能力，对项目核心要点进行深度解读。通过 AI 辅助梳理，将复杂的工程原则转化为结构化的知识框架，让开发者能够快速把握每个要素的核心思想与实践意义。以下是经过系统整理的详细内容，帮助您在最短时间内掌握生产级 AI Agent 的构建精髓，从而加速从概念验证到生产部署的技术跨越。

Factor 1: 自然语言到工具调用 (Natural Language to Tool Calls)

核心思想： LLM 的核心功能应该是解析自然语言指令并将其转换为结构化的、可执行的工具调用

关键要点：

角色定位： 将 LLM 从简单的文本生成器提升为智能路由器；
桥接作用： 连接人类意图和程序化行动之间的桥梁；
确定性执行： 通过工具调用与确定性后端交互，确保可预测和可靠的任务执行；
结构化输出： 强调生成明确的、有类型的工具调用而非自由文本；

实践意义：

每个用户输入都应该被转换为明确的工具调用；
避免让 LLM 直接执行不可预测的操作；
建立清晰的输入-工具调用-执行链条；

Factor 2: 掌控你的提示词 (Own Your Prompts)

核心思想： 提示词是 LLM 交互的生命线，应该被视为关键的、版本控制的代码工件而非一次性输入

关键要点：

版本控制： 提示词应该在应用程序代码库中进行管理；
系统化测试： 提供系统化的测试、部署和回滚能力；
一致性保证： 确保行为的一致性和可重现性；
受控演进： 能够以受控的方式演进 Agent 的行为；

实践意义：

将提示词作为代码的一部分进行管理；
建立提示词的测试和部署流程；
根据模型变化调整 token 顺序和系统/用户角色；

Factor 3: 掌控你的上下文窗口 (Own Your Context Window)

核心思想： 上下文窗口是 LLM 对之前交互的有限记忆，需要主动和有意识的管理

关键要点：

相关性过滤： 确保上下文窗口只包含与当前任务直接相关的信息；
信息裁剪： 修剪不必要的数据以防止"上下文漂移"或信息过载；
性能优化： 提高 LLM 性能，减少 token 使用；
焦点增强： 增强模型专注于关键细节的能力；

实践意义：

主动管理上下文内容，避免无关信息干扰；
实现智能的上下文压缩和摘要；
建立上下文窗口的清理和优化机制；

Factor 4: 工具就是结构化输出 (Tools Are Just Structured Outputs)

核心思想： 工具被定义为 LLM 被训练或指示生成的特定结构化数据格式

关键要点：

关注点分离： LLM 专注于智能推理和生成，实际执行由可靠的确定性代码处理；
结构化数据： 工具调用是清晰、可解析的输出格式；
执行分离： 不依赖 LLM 直接执行操作，而是生成执行指令；
JSON 本质： 工具本质上是触发确定性代码操作的 JSON 输出；

实践意义：

设计清晰的工具调用 JSON schema；
建立工具调用的验证和执行机制；
确保工具调用的可解析性和可靠性；

Factor 5: 统一执行状态和业务状态 (Unify Execution State and Business State)

核心思想： 强调对 LLM 内部"执行状态"(LLM 认为正在发生的事情)和应用程序实际"业务状态"(实际情况)的清晰和一致理解

关键要点：

状态一致性： 防止 LLM 的认知状态与实际业务状态产生偏差；
准确信息： 确保 LLM 使用准确和最新的信息进行操作；
幻觉防护： 防止幻觉或无效操作的产生；
真实性保证： 维护业务逻辑的真实性和一致性；

实践意义：

建立状态同步机制；
实现状态验证和校正流程；
确保 LLM 始终基于准确的业务状态进行决策；

Factor 6: 通过简单 API 实现启动/暂停/恢复 (Launch/Pause/Resume with Simple APIs)

核心思想： LLM 代理应该设计为具有清晰的程序化接口，允许轻松的生命周期管理

关键要点：

生命周期管理： 提供启动新代理实例、暂停执行、从特定状态恢复的简单 API；
调试支持： 对调试、测试和管理长时间运行或复杂代理工作流至关重要；
状态检查： 使开发人员能够在任何时点介入和检查代理的行为；
可恢复性： 支持从中断点恢复执行；

实践意义：

设计清晰的 Agent 生命周期 API；
实现状态序列化和反序列化；
建立 Agent 的暂停和恢复机制；

Factor 7: 通过工具调用联系人类 (Contact Humans with Tool Calls)

核心思想： 总会有需要人类判断、专业知识或干预的情况，应该通过工具调用明确将"人类联系"构建到代理的能力中

关键要点：

人类干预： 当 LLM 遇到模糊性、不确定性或需要外部批准时，应该能够触发结构化的通知或升级给人类操作员；
自治边界： 确保在需要人类监督时，关键决策不会自主做出；
升级机制： 建立明确的人机协作流程；
工具化联系： 将人类联系作为标准工具调用实现；

实践意义：

设计人类介入的工具调用接口；
建立人机协作的工作流程；
实现智能的升级和通知机制；

Factor 8: 掌控你的控制流 (Own Your Control Flow)

核心思想： 尽管 LLM 具有"推理"能力，应用程序的总体控制流应该保持由确定性代码明确定义和管理

关键要点：

控制流所有权： LLM 应该指导通过控制流的路径，而不是成为控制流本身；
可预测性： 确保可预测性，启用强健的错误处理；
自治边界： 允许开发人员为 LLM 的自治建立明确的边界；
行为控制： 防止意外或不期望的行为；

实践意义：

设计明确的控制流图；
让 LLM 在预定义的路径中做选择；
建立错误处理和异常管理机制；

Factor 9: 将错误压缩到上下文窗口 (Compact Errors into Context Window)

核心思想： 当 LLM 驱动的应用程序发生错误时，为 LLM 提供简洁和相关的失败信息至关重要

关键要点：

结构化错误： 以结构化方式将错误详细信息压缩到 LLM 的上下文窗口中；
理解能力： 使 LLM 能够更好地理解问题并可能建议恢复策略或替代操作；
信息过滤： 避免向 LLM 提供原始的、冗长的错误日志，这可能会混淆它；
自愈能力： 让模型能够基于错误信息进行自我修复；

实践意义：

设计错误信息的摘要和压缩机制；
建立错误分类和处理流程；
实现基于错误的恢复策略；

Factor 10: 小而专注的代理 (Small, Focused Agents)

核心思想： 将复杂的 LLM 应用程序分解为更小、更专业的代理，每个代理负责一个不同的任务或领域

关键要点：

模块化方法： 减少任何单个 LLM 的认知负载；
精度提升： 通过缩小焦点提高其准确性；
可维护性： 使系统更容易开发、测试和维护；
优化友好： 较小的代理更适合特定的微调和优化；

实践意义：

按功能领域拆分 Agent；
建立 Agent 间的协作机制；
实现专业化的 Agent 设计；

Factor 11: 在任何地方触发，在用户所在之处相遇 (Trigger from Anywhere, Meet Users Where They Are)

核心思想： 可靠的 LLM 应用程序应该可以从多样的入口点和用户界面访问和触发

关键要点：

多渠道访问： 无论是通过 web 聊天、API 调用、移动应用还是内部仪表板，代理都应该能够无缝接收输入和交付响应；
集成灵活性： 确保代理可以集成到现有工作流程中；
用户体验： 在用户偏好的平台上与用户相遇，增强可用性和采用；
无处不在： 提供无处不在的访问能力；

实践意义：

设计多渠道的接入接口；
建立统一的 Agent 服务层；
实现跨平台的用户体验；

Factor 12: 让你的代理成为无状态的 Reducer (Make Your Agent a Stateless Reducer)

核心思想： 鼓励将 LLM 代理设计为无状态的，处理输入并产生输出，而不在交互之间维护内部的长期记忆

关键要点：

无状态设计： 代理不维护内部状态，所有必要的持久状态由外部数据存储管理；
可扩展性： 增强可扩展性、弹性和水平扩展能力；
实例无关性： 任何代理实例都可以处理任何请求；
容错性： 单个实例的失败不会导致数据丢失；

实践意义：

设计无状态的 Agent 架构；
实现外部状态存储和管理；
建立水平扩展的能力；

总体架构思想

这 12 个因子共同构建了一个完整的生产级 AI Agent 架构框架，强调：

确定性与可预测性 - 通过明确的控制流和工具调用；
可维护性与可扩展性 - 通过模块化和无状态设计；
人机协作 - 通过明确的人类介入机制；
状态管理 - 通过统一的状态管理和上下文控制；
错误处理 - 通过结构化的错误压缩和处理；
多渠道部署 - 通过灵活的触发和访问机制；

这些原则的核心目标是将 AI Agent 从"有时工作的演示"转变为"可靠的生产系统"。项目具有重要的行业价值，它准确识别并系统化解决了 AI Agent 从"演示级"跨越到"生产级"的关键瓶颈。项目最大亮点是提出"混合架构"理念——最佳 Agent 应以确定性代码为主体，在关键点融入 LLM，这一洞察挑战了主流框架的纯 AI 驱动思路。基于与 100 多个 SaaS 构建者的实践交流，该项目不仅提供了系统化的工程原则，更重要的是确立了从工程角度审视 Agent 开发的思维框架。虽然存在复杂性权衡和框架适用性等局限，但其对推动 AI Agent 标准化和提升行业工程质量具有里程碑意义，很可能成为该领域的重要参考标准，适合所有面临 Agent 生产化挑战的工程团队参考。

财富之道：哈里·布朗的 17 条财务安全黄金法则

nicejade — Thu, 10 Apr 2025 15:31:49 GMT

当你在新闻中读到一个你知道很富有的人陷入财务困境或宣布破产时，你很容易对管理自己的钱产生一种徒劳感。你开始想，如果这样一个有条件获得最佳财务建议的富人都会落到这种地步，我还有什么机会呢？

如果你深入了解他或她的故事，你会发现他之所以落到这种地步，是因为他违反了生活中的一些基本规则。哈里·布朗的财富安全黄金法则是财务成功的基本规则。它们简单明了，如果你遵守它们，你失去所有财富的可能性不到百万分之一。让我们来了解它们是什么。

你的职业

法则 1：你的职业提供你的财富

将你的财富建立在你的职业之上。你很可能从你的事业或职业中赚到的钱远远超过你的投资。只有极少数人能从投资中获得巨额财富。

你的投资可以使你的未来更有保障，退休生活更加富足。但它们不能让你从贫穷变为富有。所以不要冒险采用复杂的计划，希望快速增加你的资本。你的投资计划首先应该旨在保存你所拥有的——保护它免受投资损失、政府干预或管理不善。

大多数试图击败市场的兼职投资者会损失部分或全部他们辛苦积累的储蓄。

你能依靠一个具有适当资格的专家获得丰厚利润吗？你如何找到真正的专家？这个任务并不比选择正确的投资容易。如果你不像专业人士那样了解投资，你就不会知道如何检验那些寻求为你提供建议的人。而且你不能依赖顾问的业绩记录，即使它是诚实呈现的。业绩记录只告诉你顾问过去的表现如何——而不是他们明年会如何表现。

如果你认为投资可以成为你退休财富的唯一来源，或者你从工作中抽出时间来管理投资，或者你考虑放弃工作成为全职投资者，那么你就违反了第 1 条法则。

你的财富可能无法替代

法则 2：不要假设你可以替代你的财富。

你赚到了你所拥有的，并不意味着如果你失去了它，你还能再赚回来。市场和机会在变化，技术在变化，法律在变化。今天的条件可能与你建立现在的资产时的条件有很大不同。随着时间的推移，不断增加的监管使积累财富变得越来越困难。

所以把你所拥有的当作你永远无法再赚回来的东西。不要冒险用你的财富，假设你总能把它拿回来。

你赚到了你的财富，是因为你的才能和努力与你所处的环境和谐一致。但世界不会为你停止不前，也不会在你需要时重复自己。

所以假设你现在拥有的是不可替代的，你永远无法再赚回来——即使你怀疑你可以。

对任何要求你冒险失去它的提议说"不！"

投资与投机

法则 3：认识投资与投机的区别。

当你投资时，你接受市场给予投资者的一般回报。当你投机时，你试图通过敏锐的时机把握、预测或股票选择来击败这种回报——做得比其他投资者更好——并暗示你比大多数其他投资者更聪明。

当你做以下事情时，你就是在投机：

你选择个股、共同基金或股票市场板块，认为它们会比整体市场表现更好。
你根据你认为它们在不久的将来会表现如何，将你的资本进出市场。
你根据国家经济的当前前景进行投资。
你使用基本面分析、技术分析、周期分析或任何其他形式的分析或系统来告诉你何时买入和卖出。

投机本身没有错——只要你用的是你能承受损失的钱。但对你来说珍贵的钱不应该冒险押注在你能够超越其他投资者的赌注上。

预测未来

法则 4：没有人能预测未来。

警惕算命先生。投资市场中的事件源于数百万不同人的决定。投资顾问预测人类未来行为的能力并不比算命先生和占卜师强。所以事情的发展从来不像我们确信的那样。

是的，有些预测成真了。但我们注意到它们的唯一原因是，即使有一个预测成真也是如此特殊。我们忘记了所有失败的预测，因为它们太普遍了。

没有人能可靠地告诉你明年股票会怎样，我们是否会有更多的通货膨胀，或者经济将如何表现。

与你生活的其他方面一样，安全不是来自试图洞察未来以消除不确定性。安全来自设计现实的方法来应对不确定性。

我们生活在一个不确定的世界中——没有人能为你消除这种不确定性。

寻找方法确保不确定的未来不会伤害你——无论它最终会变成什么样。

投资建议

法则 5：没有人能够始终如一地以精确和有利可图的时机让你进出投资。

不要期望任何人让你致富。你会听说许多华尔街奇才，但一旦你开始按照他的建议行事，迄今为止记录完美的投资顾问很可能会失去他的触觉。

投资顾问可以非常有价值。一个好的顾问可以帮助你理解如何做你知道需要做的事情。他可以帮助你注意你可能忽视的风险。他可以让你了解新的选择。

助手（会计师等）值得倾听。他或她可以让你了解你不知道的投资选择，这些选择可能适合你。他可以教你在投资世界中完成事情的机制和程序。他可以提出你需要回答的问题，以便设计适合你需求的投资组合。他可以帮助你减少投资利润的税单。

你不会按照你从未听说过的人的建议行事。而你听说他只是在——并且因为——他连续做出了几个有利可图的建议之后。

迄今为止记录完美的投资专家一旦你开始按照他的建议行事，就会失去他的触觉。

但没有人能保证让你总是在正确的时间出现在正确的地方。更糟糕的是，尝试这样做有时会对你的投资组合造成致命影响。

交易系统

法则 6：没有交易系统在未来的表现会像过去那样好。

你会遇到许多交易系统或指标，它们似乎总是正确地指示你的钱应该在哪里，但不知何故，当你的钱处于危险中时，这些系统从来没有奏效。

交易系统通常来自两个来源之一。

第一个来源是对人类行为的常识性观察——然后有人试图将其转化为可量化的机械系统。

例如，相反意见是一种理论，它说，除其他外，当每个人似乎都知道其前景有多好时，投资可能接近其峰值。

这个想法有一定道理。如果每个人都已经知道某物是一项好的投资，那么可能购买它的大多数人可能已经这样做了——留下很少的投资者购买它并推高其价格。

在这种情况下，你应该对其作为投机的前景持怀疑态度。

但这并不意味着我们确切知道投资何时或以什么价格达到峰值。你只知道价格似乎没有太多上涨的空间。

但设计交易系统的人对如此不确定的东西不满意。他们设计指标来衡量围绕特定投资的看涨和看跌程度——然后构建提供买卖具体信号的公式。

这类似于采用一个明显的事实——例如在雨天参加体育赛事的人通常比在晴天少——并构建一个公式，据说可以将降雨量转化为对出席人数的精确预测。

第二个来源可能是找到过去有效的东西并假设它在未来也会有效。交易系统基于世界不变的未说明假设。但世界在不断变化——随着欲望的变化，需求的变化和供应的变化。

以现金为基础运作

法则 7：不要使用杠杆。

当有人完全破产时，几乎总是因为他使用了借来的钱。在许多情况下，个人已经相当富有，但他想用借来的钱来金字塔式地增加他的财富。

使用保证金账户或抵押贷款（除了你的房子）会使你面临损失超过原始投资的风险。如果你以现金为基础处理所有投资，几乎不可能失去一切——无论世界上发生什么——特别是如果你遵循这里给出的其他规则。

自己做决定

法则 8：不要让任何人做你的决定。

许多人失去了他们的财富，因为他们给了某人（财务顾问或律师）做决定和处理他们的钱的权力。顾问可能冒了太多的风险，不诚实，或者简单地不称职。但最重要的是，没有顾问能被期望像你一样尊重你的钱。

你不需要资金管理人。投资只有在你试图击败市场时才复杂且难以理解。你只需最低限度地了解投资，就可以保存你所拥有的。你可以在一天内为自己设置一个无忧的投资组合——然后你每年只需要一天来监控它。让世界上最聪明的人为你做决定，远不如为自己设置一个安全的投资组合安全。

最重要的是，永远不要给任何人对你珍贵的钱的签名权。如果你应该把钱放入一个账户让别人管理，那必须是你能承受损失的钱。

了解你所做的事

法则 9：永远不要做你不理解的事情。

不要进行任何你不理解的投资、投机或投资计划。如果你这样做，你可能后来会发现你不知道的风险。或者你的损失可能比你投资的金额更大。

把你的钱放在国库券中比冒险投资你不完全理解的投资要好。你的姐夫、你最好的朋友或你最喜欢的投资顾问理解某种赚钱计划并不重要。不是他的钱在冒险。如果你不理解，就不要做。

多元化

法则 10：不要依赖任何一种投资、机构或个人来保证你的安全。

每种投资都有其辉煌时刻——也有其羞耻时刻。在 20 世纪 70 年代，贵金属统治着市场，而股票和债券则处于失宠( disgrace)。但随后黄金和白银成为 20 世纪 80 年代和 90 年代的输家，而股票和债券则增值了多倍。没有一种投资适合所有时期。即使是国库券在通货膨胀时期也会失去实际价值。

你也不能依靠任何单一机构来保护你的财富。老牌银行已经倒闭，养老基金已经倒闭。你认为会保管你财富安全的公司可能在你准备提取你的毕生积蓄时不在那里。

我们生活在一个不确定的世界中，惊喜是常态。你不应该冒险让单一的惊喜摧毁你持有的大部分财产。

在投资和机构之间多元化——并保持足够简单以便自己管理——你可以放松，知道没有一个事件可以击垮你。

平衡的投资组合

法则 11：创建一个防弹投资组合以获得保护。

对于你需要照顾你余生的钱，建立一个简单、平衡、多元化的投资组合。我称之为"永久投资组合"，因为一旦你建立它，你就不需要重新安排投资组合——即使你对未来的展望发生变化。

投资组合应该确保你的财富能够在任何事件中生存下来——包括对投资组合中任何单个元素具有破坏性的事件。换句话说，这个投资组合应该保护你，无论未来会带来什么。

拥有如此安全的投资组合并不困难或复杂。你可以用一个令人惊讶的简单投资组合实现很大程度的多元化。

投资组合应该确保你的财富能够在任何事件中生存下来——包括对任何一种投资具有破坏性的事件。这样一个投资组合的三个绝对要求是：

安全性：它应该保护你免受每一种可能的经济未来的影响。你应该在正常繁荣时期获利，但你也应该在不好的时期——通货膨胀、衰退甚至萧条——中安全（甚至可能获利）。
稳定性：无论经济气候如何，投资组合的表现应该如此稳定，以至于你不会怀疑投资组合是否需要改变。即使在最糟糕的情况下，投资组合的价值也应该只略微下降——这样你就不会恐慌并放弃它。这种稳定性还允许你将注意力从投资中转移，相信你的投资组合会在任何情况下保护你。
简单性：投资组合应该如此容易维护，并且需要你很少的时间，以至于你永远不会被诱惑去寻找看起来更简单但不那么安全的东西。

你让它保持不变——永久持有相同的投资，按相同的比例。你不会随着你、你的朋友或投资大师对未来的看法改变而改变比例。

你的投资组合只需要对那些广泛的变动做出良好反应。它们分为四个一般类别：

繁荣：一个生活水平上升、经济增长、商业繁荣、利率通常下降、失业率下降的时期。
通货膨胀：一个消费者价格普遍上涨的时期。它们可能适度上涨（通货膨胀率约为 6%），快速上涨（约为 10%至 20%，如 20 世纪 70 年代末），或以失控的速度上涨（25%或更多）。
紧缩货币或衰退：**流通中的货币供应增长放缓的时期。这使人们拥有的现金少于他们预期的，通常导致衰退——一个经济条件不佳的时期。
通货紧缩：通货膨胀的反面。消费者价格下降，货币的购买力价值增长。在过去，通货紧缩有时会引发萧条——一个经济条件非常糟糕的长期时期，如 20 世纪 30 年代。

投资价格可能受到金融系统外部发生的事情的影响——战争、政府政策变化、新税收规则、内乱和其他事项。但这些事件只有在将经济从我刚才描述的四种环境之一推向另一种环境时，才会对投资产生持久影响。这四个经济类别是全面的。在任何时候，其中一个将占主导地位。所以如果你在这四种情况下受到保护，你就在所有情况下受到保护。

因此，四种投资为所有四种经济环境提供了覆盖：

股票利用繁荣。它们在通货膨胀、通货紧缩和紧缩货币时期表现不佳，但随着时间的推移，这些时期不会抵消股票在繁荣时期取得的收益。

债券也利用繁荣。此外，当通货紧缩期间利率崩溃时，它们会获利。你应该预期债券在通货膨胀和紧缩货币时期表现不佳。

黄金不仅在剧烈通货膨胀时期表现良好，而且表现非常好。在 20 世纪 70 年代，随着通货膨胀率在 1980 年达到 15% 的峰值，黄金上涨了二十倍。黄金在繁荣、紧缩货币和通货紧缩时期通常表现不佳。

现金在紧缩货币时期最有利可图。它不仅是一种流动资产，可以在你的收入和投资可能不佳时给你购买力，而且利率的上升增加了你的美元回报。在通货紧缩期间，随着价格下跌，现金也变得更有价值。在繁荣时期，现金基本上是中性的，而在通货膨胀时期，它是输家。

任何试图在分配投资份额时变得聪明的尝试可能会弊大于利。我更喜欢简单地将 25%分配给四种投资中的每一种。

唯一需要的维护是每年检查一次投资组合的构成。

如果四种投资中的任何一种变得低于投资组合总价值的 15%或高于 35%，你需要恢复原始百分比。

当你每年一次检查投资组合的价值时，如果所有四种投资都在 15-35%的范围内，则不需要重新平衡。在一年中，如果你碰巧注意到投资价格有很大变化，你可能想检查投资的价值。同样，如果任何投资超出了 15-35%的范围，继续重新平衡整个投资组合。

永久投资组合的测试是它是否提供内心的平静。永久投资组合应该让你完全平静地观看晚间新闻或阅读投资出版物。没有实际或威胁的事件应该困扰你，因为你会知道你的投资组合能够抵御它。

如果有人警告当前十年与 20 世纪 20 年代之间的"惊人相似之处"，你不应该怀疑是否需要卖掉所有股票。你会知道你的永久投资组合会照顾你——即使明年变成了 1929 年重演。可能摧毁股票的通货紧缩会推动利率下行，为你的债券带来巨大利润。

当有人声称通货膨胀率正在回到 15%，你不应该怀疑是否要抛售所有债券。你会知道你的永久投资组合中黄金的增值将远远超过债券的任何损失。

当有人宣布新的债务危机即将到来，或者股票、债券或黄金即将开始牛市，你不会感到压力去决定他是否正确。你会知道永久投资组合将对任何可能性做出有利的反应。

我不能列出每一个潜在的事件。所以如果你对任何可能性感到担忧，重读本章，你应该放心，如果最坏的情况发生，你的永久投资组合中有一项投资会照顾你。无论潜在的危机或机会是什么，你的永久投资组合应该已经在照顾你。

投资组合不能保证每年都有利润；没有投资组合能做到这一点。它不会在他最好的一年超过热门顾问。它也不会超过年度最佳投资。但它可以给你信心，没有危机会摧毁你，确保你的储蓄在所有情况下都是安全和增长的，并且知道你不再容易受到你或最好的顾问可能轻易犯的判断错误的影响。

投机

法则 12：只用你能承受损失的钱进行投机。

如果你想尝试击败市场，建立第二个——独立的——投资组合，你可以尽情投机。但确保这个投资组合包含的财富不超过你能承受损失的范围。

我称这第二笔资金为"可变投资组合"，因为随着你对未来的展望变化，其投资也会变化。它可能全部或部分投资于股票或黄金或其他东西——无论在任何时候看起来都不错——或者只是现金。你可以冒险使用可变投资组合，因为你知道，无论发生什么，没有损失会是毁灭性的。你只能损失你已经决定对你不珍贵的钱。

国际多元化

法则 13：在你居住的国家之外保留一些资产。

不要让你拥有的一切都在你的政府可以触及的地方。通过在政府无法触及的地方拥有一些东西，你将不那么脆弱——你也会感到不那么脆弱。你不再需要那么担心政府下一步会做什么。

例如，维护一个外国银行账户非常简单；它与拥有一个美国银行或经纪人的邮件或互联网账户没有太大区别。

在国外保留一些投资提供了对可能在任何地方发生的意外的安全和简单保护——政府没收黄金持有量、外汇管制、内乱，甚至战争。

没有人知道在未来几年当选的人将如何选择解决国家将面临的经济问题。他们可能会认为快速简单的解决方案是拿走你的财产——正如已经发生过很多次的那样。即使在你自己的国家发生战争、内乱、执法减弱或物理灾难而扰乱记录保存，你的资产也将是安全的。

你的整个资产将不再容易受到你自己国家的经济、政治或法律挫折的影响。

地理多元化是确保永久投资组合能够处理任何危险的必要部分。

避税计划

法则 14：警惕避税计划。

美国的税率仍然足够低，以至于你可能从构建复杂的避税计划的风险和努力中获益很少。而且很多钱已经被希望击败税收系统的人损失了。损失来自提供特殊税收优势但在经济上没有意义的投资，以及被美国国税局不允许的避税计划——在负债之上还有罚款和利息。

有许多简单的方法可以最小化税收——通过诸如 IRA 和 401(k)计划之类的东西。利用这些减税计划。这些计划是有效的，但不具有争议性。它们不会回来困扰你。税收递延是减轻投资计划税收负担的基本方法。通过税收递延，你今天不支付的税款可以每年工作产生更多收益，直到你最终不得不支付税款。

问题

法则 15：问正确的问题

在什么经济情况下投资的价格可能会下跌？

你投资组合中的其他投资是否可能在这些相同情况下弥补不足？

在什么情况下我可能会损失相当大的份额——20%或更多——的投资？

在什么情况下我的全部投资可能会损失？

我是否有任何剩余责任——也就是说，我是否可能损失比我投资的现金更多？

利率通常反映投资的风险。更高的利率意味着资本可能通过违约或通货膨胀而损失的可能性更大。

在什么情况下（如果有的话）投资可能会升值？

在什么情况下（如果有的话）投资可能会贬值？

在对投资有利的情况下，整体回报——收益率加上资本增值——是否会帮助你的投资组合克服其他投资的损失？

如果投资是共同基金，你想要收益率最低的基金——其他条件相同。共同基金支付的任何股息只会降低你的股票价格

"这家公司是潜在的收购候选人吗？"

人群并不总是错的，但你不能通过与它打赌赚很多钱——因为你将以已经很高的价格购买。通过逆势而行，你在投资不受欢迎且便宜时买入；如果它确实成功，它有很长的上涨空间。所以投机中最重要的因素是你是否期望大多数人不期望的事情。例如，考虑投机性购买通货膨胀对冲的时机是当大多数人认为通货膨胀受到控制时。考虑购买特定公司的时机是当每个人都知道它是一只狗的时候——而不是当每个人都谈论它的伟大前景时。不受欢迎并不保证利润，但你永远不会通过受欢迎的投资赚大钱。

"技术因素现在是否有利于投资？"

你必须有一个投资计划。没有计划，你将被你读到和听到的所有相互矛盾的想法所摇摆——你永远不会问正确的问题。有了计划，你将有一个评估你所听到的基础。你会知道问那些帮助你确定投资是否促进你的计划的问题。

享受

法则 16：用一个享乐预算来享受自己。

如果你不能享受你的财富，它就没有价值。但在钱流入时很容易花费太多。要享受你的财富，建立一个预算，你可以每年无忧无虑地花费。如果你保持在那个金额内，你可以自由地把钱花在汽车、旅行、任何你想要的东西上——知道你不会浪费你的未来。

如有疑问...

法则 17：每当你对行动方案有疑问时，在安全方面犯错总是更好的。

如果你错过了一个增值财富的机会，很快就会有另一个机会出现。但如果你只损失了一次积蓄，你可能永远都没有机会弥补。

如果你最终失去了一些东西，那就让它只是失去一个机会，而不是宝贵的资本。人们很少会因为谨慎行事而破产。但许多人破产是因为冒了很大的风险，或者做了一些自己不太了解的投资。

如果你犹豫不决，那是因为你对投资或问题还不够了解，无法做出自信的决定。这意味着在你了解更多信息并确定自己理解所有后果之前，你不应该冒险。

投机的前提是你比大多数其他投资者更精明——你更了解市场，你掌握着其他投资者无法获得的信息，你可以做出更好的决策，或者你对现有信息的解读尤其敏锐。投机的要素包括时机、预测、交易系统和选择。任何时候你使用这些策略，你都在进行投机。

投资预测可能会令人兴奋不已。但在生活的其他领域，我们把算命先生当成娱乐家。

预测并非完全无用。别人的预测可以帮助你认识到，你对未来的预期并非唯一可能的结果。这可以帮助你保持谦逊和谨慎。

如果你觉得某个事件很有可能发生，但大多数人并不认同你的观点，那么如果你押注该事件并最终证明你是正确的，市场很可能会给你带来丰厚的回报。所以，如果你喜欢密切关注投资市场，并且看到了大多数人忽视的潜在未来，不妨用你能承受损失的资金进行小额投机。

一个肯定会让你损失积蓄的方法是，把你宝贵的资金押注于某些事件不可避免的想法上。

1970 年，瑞士最大银行的首席黄金交易员告诉我的一位朋友，金价永远不会超过 40 美元。当被问及他如何如此肯定时，这位交易员回答说：“因为我们控制着市场。” “内部人士”的帮助，和算命先生或高价专业人士没什么两样。

你可以利用多家机构来保护自己，免受机构危机的影响。你可以只依靠自己，免受个人失误的影响。你也可以通过跨投资市场进行多元化投资，避免投资过山车般的波动。将 25%的股票市场部分投资于三只共同基金。
对于债券部分，你不需要监控信用风险，所以只购买美国国债。只要美国政府有能力向民众征税或印钞来支付账单，就几乎不存在信用风险。

将 25%的资金投入目前期限最长的美国国债，即接近 30 年到期的国债。十年后，该债券的到期期限将只有 20 年；届时，可以用新的 30 年期债券替代它。

购买金币——这些金币的唯一价值在于其所含的金条。它们每盎司的售价比金条高出约 3-5%。这意味着，如果黄金价格为每盎司 300 美元，一盎司金币的售价约为 310-315 美元。

现金部分应存放在仅投资短期美国国债的货币市场基金中，这样您就无需评估信用风险。这些证券比银行账户和其他债务工具更安全。如果您的现金预算足够大，请将您的持股分散到两到三个基金中，以进一步防范不可想象的意外情况。您投资组合中的房地产价值是不可分割的，其他所有资产都必须与其相符。就像客厅里摆放一架 15 英尺高的钢琴一样，其他家具也必须围绕它摆放。

你的房子是消费品——你居住和享受生活的地方。

不要玩弄你的永久投资组合。不要等到任何投资价格下跌才买入。也不要过度投资于目前表现良好的项目。只需在这四个类别中各投入 25% 即可。

无论你对近期的预期有多强烈，你都很容易犯错。永久投资组合的意义在于忽略你自己的预期，让投资组合无论发生什么都为你保驾护航。

用四项投资的等量份额投资它，不必担心哪项投资会表现最佳。它是一个投资组合，为你提供所需的安全保障。拆散这个投资组合，也就拆散了安全保障。

你知道的越少——你越诚实地认识到自己知识的局限性——你的投资计划就越有可能成功。谦逊就是承认你并非无所不知，甚至并非对任何特定主题都了如指掌，这是投资者最重要的资产。傲慢最终会毁掉任何投资者。

生活规则

安全投资的规则与生活规则并无二致：认识到你生活在一个充满不确定性的世界，不要期待不可能的事情，也不要轻信陌生人。如果你能将创造你现在财富的现实态度运用到投资中，你就不必担心破产。

《纳瓦尔宝典》读书笔记：致富和幸福的良言

nicejade — Tue, 11 Mar 2025 05:15:39 GMT

《纳瓦尔宝典》（副标题：财富与幸福指南），作者：埃里克·乔根森。致富不仅仅靠运气，幸福也不是从天而降的。积累财富和幸福生活都是人们可以且需要学习的技能。那么指导我们学习的原则和方法是什么？《纳瓦尔宝典》一书提供了原则和方法。这本书收集整理了硅谷知名天使投资人纳瓦尔的智慧箴言录，尤其是关于财富积累和幸福人生的原则与方法。

自今年二月（2023 年）接触，有利用碎片时间阅读，感触颇深；如果能做到「知行合一」，相信在读完这本书之后，势必能促使你我做出改变，从而拥有更精彩的人生。以下是摘录纳瓦尔的部分观点：

赚钱跟工作的努力程度没什么必然联系。即使每周在餐厅拼命工作 80 个小时，也不可能发财。要想获得财富，你就必须知道做什么、和谁一起做、什么时候做。与埋头苦干相比，更重要的是理解和思考。当然，努力非常重要，不能吝啬自己的努力，但必须选择正确方式。
如何致富（不靠运气）：追求财富，而不是金钱或地位。财富是指在你睡觉时仍能为你赚钱的资产。金钱是我们转换时间和财富的方式。地位是你在社会等级体系中所处的位置。
获得财富的一个途径，就是为社会提供给其有需求但无从获得的东西，并实现规模化。
选择一个有长期发展前景的行业，找到可以长期合作的人。
互联网极大地拓展了职业空间，但大多数人还没有清晰地认识到这一点。
培养迭代思维。生活中所有的回报，无论是财富、人际关系，还是知识，都来自复利。
选择聪明过人、精力充沛的商业伙伴，但更重要的是，他们要正直诚信。
不要跟愤世嫉俗和消极悲观的人合作。他们的预言会自我实现。
学会销售，学会构建，两技傍身，势不可当。
用专长、责任感和杠杆效应武装自己。
专长指的是无法通过培训获得的知识。如果社会可以培训你，那么社会也可以培训他人来取代你。
要想有所专长，就要追求真正的兴趣和热爱，而不是盲目追逐热点。累积专长的过程，对你而言就像玩耍，对他人来说则很吃力。
专长的传授需要通过师傅带徒弟的方式完成，而无法通过学校教育完成。专长往往具有高度的技术性或创造性，不能被外包或自动化。
要想获得财富，就必须充分利用杠杆效应。商业杠杆来自资本、劳动力和复制边际成本为零的产品（代码和媒体）。代码和媒体是不需要许可就能使用的杠杆。这两个杠杆是新富阶层背后的杠杆。你可以创建软件和媒体，让它们在你睡觉时为你工作。
如果不会写代码，那就出书、写博客、做视频、录播客。
学习微观经济学、博弈论、心理学、说服术、伦理学、数学和计算机。
工作是要拼尽全力，毫无保留。不过，共事的人和工作的内容比努力程度更重要。
只有独辟蹊径，才能避开竞争。从本质上看，竞争就是模仿，与他人竞争，是因为你跟别人在做一样的事情。但是，每个人都是独一无二的，不要模仿他人。
你应该在经过深思熟虑后，清醒地认识到自己需要从大多数事情（人际关系、工作、学习）中找到可以尽全力去付出的那部分，以充分获取复利效应。
没有股权，就没有通往财务自由的路径。靠出租自己的时间是永远无法致富的。
无论处于人生哪个阶段，努力的目标都是不断提高自己的独立性，而不是升职加薪。拥有独立性、为自己独特的产出成果负责（而不是像打工一样为投入的时间负责），这才是最理想的状态。
作为一名劳动者，只有最大化地发挥杠杆（资本、合作、科技、生产力等各种手段）效应，才能利用有限的时间和体力产生巨大的影响力。
与一个没有利用杠杆的劳动者相比，利用了杠杆的劳动者的产出会增加成千上万倍。对利用杠杆的劳动者而言，判断力的重要性远超投入时间的长短和工作的努力程度。
人生的一大目标应该是掌控自己的时间。理想的工作是利用杠杆效应的工作。在这种工作模式下，你可以掌控自己的时间，并能对自己的产出成果负责。如果你能通过提供绝佳的解决方案给企业带来了神奇的转机，那么你必将得到金钱的回报。特别是，如果别人根本不知道你是如何做到的，他们就必须不断地付钱给你，让你继续提供这种产品或服务。而你之所以能够做到这一点，就是因为你的痴迷、技能或天赋。
不要做可能会让你全盘皆输的事情。不要孤注一掷、铤而走险。相反，要把赌注压在那些胜算较大、能带来巨大利益的事情上。
要获得更多的自由时间，就要对选择的专业领域、工作性质、职业路径以及与雇主达成的交易类型做出审慎的判断。
我认为每个人都应该理智掌握某些领域的专业知识，并以此赚取经济回报。如果能够在实际工作中最大化地利用杠杆，无论是机器人、计算机，还是其他任何人或技术，那么我们都可以成为自己时间的主人，因为没有人会考核我们在工作中投入了多少时间，我们只需要对自己的产出负责。
普通人把时间浪费在短期思考上，浪费在毫无价值的繁重工作上。而巴菲特会用一年斟酌判断，然后用一天采取行动。他一天的行动可以影响未来几十年。
只要在优秀的基础上稍微提高一点儿，做到卓越（比如把完成 1/4 英里的短跑成绩提高零点几秒），经济回报就会呈数量级增加。而杠杆效应进一步放大了经济回报的差异。在杠杆时代，在自己的领域做到极致非常重要。
给自己的时间设定价格，用时薪计算时间价值。如果用花钱的方式节省的时间价值更高，那就花钱，不要犹豫。要想真的赚到钱，先要相信你自己很值钱。
大胆地为自己设定一个很高的时薪，并坚持执行。一个理想的时薪应该高到近乎离谱的程度，如果不是这样，那就还不够高。无论你选择的时薪是多少，我都建议你进一步提高。
保持乐观，积极向上，这种态度非常重要。从长远看，乐观主义者往往会取得更好的发展。
在商业世界里，大多数人在玩零和游戏，少数人在玩正和游戏，他们在人群中寻找志同道合者。
在人类进化史上，财富创造是近代才出现的活动，是一个正和游戏。而地位之争自古有之，是一个零和游戏。那些攻击财富创造的人往往只是为了追求地位。
对初出茅庐的年轻人来说，最重要的事情是什么？最重要的是，要在重大决定上花更多时间。人生早期有三个重大决定：在哪里生活，和谁在一起，从事什么职业。
想要做到与成功人士为伍，你认为最重要的一件或两件事是什么？找到自己擅长的领域，然后用自己的技能去帮助他人：提供免费的产品或服务，主动向世界传递善意。好人终有好报。只要始终如一，假以时日，付出就一定能获得相应的回报。但不要计较自己付出了多少——一旦开始计较，耐心就会被消耗殆尽。
任何终极目标被实现后，都会有新的目标出现，这个新的目标又会带来下一个新的目标。生活就是由一个又一个的游戏组成的。一个人不断成长，从小到大玩上学游戏，玩社交游戏，玩赚钱游戏，玩地位游戏。至少对我而言，这些都是某种意义上的游戏，只是游戏的影响愈加深远。既然看透了游戏这一本质，结果就不那么重要了。
你对退休的定义是什么？ 退休：就是不再为了想象中的明天而牺牲今天。当你能活在当下，内心充盈地度过每一天时，你就达到了退休的状态。
如何达到退休状态？第一种方法是存钱。只要存款够多，被动收入（不用动一根手指）就能满足开销。第二种方法是把开销降为零——出家修行。第三种方法是做自己热爱的事情，完全乐在其中，有钱没钱无所谓。所以，实现退休状态有很多种方法。
避开竞争陷阱的方法就是做独一无二的自己，找到自己能做到独步天下的事情。做到最好，只因热爱。如果你真的热爱一个事物，那就追随本心，努力找到利用它满足社会真实需求的切入点，利用杠杆效应扩大规模，以个人名义担起责任。这样，在承担风险的同时，你也将获得相应的回报，拥有自己所提供产品或服务的所有权或股权，然后持续精进。
无论在商业、科学还是政治领域，青史留名的总是那些艺术家。艺术就是创造。艺术的目的和关注点在于创作本身，是因为喜好、喜欢而创作，是为了自娱、自赏而创作。试想一下，生活中有哪些事情能像与艺术创作那样只是以其本身为目的，而没有任何其他目的？我可以想到三个例子：毫无保留地爱，随心所欲地创造，无忧无虑地玩耍。对我来说，创业就是玩耍。我创业是因为创业本身很有趣，是因为我喜欢某个产品。
找到像玩耍一样的工作并不是一个非此即彼的选项，我们可以且行且思，逐步向目标靠近。
对刚刚开启职业生涯的人来说（甚至稍晚阶段的人也一样），最重要的资源是公司能给你带来的人脉资源。要思考一下自己会跟什么样的人共事，他们将来会如何发展。
获得好运的方法：希望好运不期而至。 不停地折腾，直到撞上大运。做好心理准备，对别人错过的机会保持敏感。把你所做的事情做到极致。精益求精，直到名副其实。让机会自动找到你，让运气成为必然。
人品和声誉是可以自己建立的。一旦有了人品和声誉，你就会有很多机会。别人认为你是运气好，但你知道那不是运气，而是人品。我的联合创始人尼维说过：“在一个长线游戏中，似乎每个人都在让彼此变得富有。而在一个短线游戏中，似乎每个人都在让自己变得富有。” 我觉得这个说法非常精准。长线游戏是正和游戏，我们在一起做蛋糕，把蛋糕越做越大。而短线游戏只是在分蛋糕。
我的人生哲学会让人觉得更舒适：“做一个创造者，创造出人们想要的有趣的东西。展示你的技能，练习你的技能，最终会有合适的人找到你。”
江山易改，本性难移。所谓“性格决定命运”，就是一个人不断重复自己的行为模式，好的坏的、优点缺点，最终会得到与自己的行为相对应的结果。始终主动付出、不断奉献，不要斤斤计较、患得患失。
人生真正的履历，其实就是一生所承受痛苦的集合。如果临终前要直面真正的自我，回顾这一生做过哪些有意义的事，那么你能想起来的一定都是你所做出的牺牲和迎接过的挑战。
你从这个世界得到的任何东西都不过是身外之物，生不带来死不带去，于你而言并不重要。一个人有健全的四肢，有聪明的大脑，这些受之于父母的东西才是真正属于你的。无论如何，我们都要迎难而上，在这个过程中创造生命的意义。其中，创造财富可以说是人生的一个目标。不懈奋斗吧。
在杠杆时代，一个正确的决策可以帮你赢得一切。不付出努力，就无法培养判断力，也不会获得任何杠杆。
时间的投入是必需的，但判断力更重要。在前进的过程中，方向比速度更重要，特别是运用了杠杆以后。在每个岔路口选对方向，其重要程度要远远超过前进的努力程度。人生就是选择正确的方向，然后朝这个方向奋力前行。
要直面现实，就要放下自我，消除自我意识，忘记自我判断，平复自我情绪。人虽然是高级动物，但情绪化的自我意识的存在会带来反刍式思维，让一些欲望蒙蔽我们的双眼，让我们看不清现实，从而让我们对“世界应该怎样”妄下判断。这种情况经常发生，尤其是在把政治诉求和商业问题搅在一起时。
悠闲的大脑才能产生伟大的创意。一个倍感压力、案牍劳形、四处奔波、焦头烂额的人，是没有办法思考的。所以，一定要为思考挤出时间。
脸书不断重新设计，推特也不断重新设计。个性、职业和团队也需要重新设计、推陈出新。在一个动态的系统中，没有一劳永逸的解决方案。
传统美德对我们的决策具有很大的启发意义：要选择从长期来看让我们受益最大的作法，而不是只顾眼前得失。
几乎所有的偏见都是为了帮助人们在信息不完整的情况下迅速做出判断。对于重要的决策，要抛开记忆和身份，专注于问题本身。
可以说，幸福与基因无关，甚至与选择无关，它是一种与个体密切相关、可以后天习得的技能，就像通过锻炼强健体魄、通过吃饭摄取营养一样。甲之真理，乙之谬论，反之亦然。我所理解的幸福与你所理解的幸福可能大相径庭。我认为，探索自己对幸福的定义非常重要。我从不考虑“我喜欢或不喜欢”这样的问题。我只关注时事，我思考问题的角度是“事实就是这样”，或者“事实不是这样”。
具体地表扬，泛泛地批评。如果要提出批评意见，不要批评某个人，可以批评工作方法，或者批评某一类行为。如果要表扬，那就找到一个榜样，表扬这个特定的人。这样有助于维护你身边人的自尊心和身份感，获得他们的支持，让他们为你所用，而不是与你作对。
人生的很多问题都可以从进化论、热力学、信息论和复杂性理论中找到解释和预测。
我认为自己并没有能力找到“正确方法”。相反，我努力的方向是逐一排除不奏效的方法。我认为成功就是不犯错。成功的关键并不在于做出正确判断，而在于避免做出错误判断。
对那些声称“科学”站在自己一边的人来说，最重要的原则，同时也是他们理解的最不透彻的原则，就是可证伪性。如果不能做出可证伪的预测，那就不是科学。要让人们相信某个理论是真理，这个理论就应该具有预测能力，而且必须是可证伪的。
如果难以抉择，那答案就是否定的。原因是，现代社会充满了选择，有成千上万个选择。我们生活在一个有 70 亿人口的星球上，我们和互联网上的每个人都相互连接，世界上有成千上万的职业供我们选择。大千世界，芸芸众生，选择永远不缺。
一条简单的人生经验：如果在一个艰难的决定上意见不统一，你就应该选择短期内更痛苦的道路。
建立新的心智模型最有效的方法是什么？ 海量阅读，多多益善。每天花一小时阅读 科学、数学 和 哲学 类书籍，7 年内，你就可能跻身少数的成功人士之列。不要比谁读书更快。书越好，你越要慢慢阅读、慢慢吸收。
对阅读中获得的信息你如何消化吸收并融会贯通？向别人讲解你学到的东西。教学相长。
人与人的区别不是“受过教育”和“没受过教育”，而是“喜欢阅读”和“不喜欢阅读”。
学习逻辑和数学。一旦掌握了逻辑和数学，无论读什么书你都不会发怵了。
要想思路清晰，就要了解基础知识。如果只是死记复杂概念，却无法融会贯通、学以致用，那么记得再多也是一窍不通、无济于事。
你的脑海中是不是会偶尔出现一首歌曲的旋律，它总是挥之不去？这就是记忆痕迹。其实所有思想的形成莫不是痕迹效应的结果。所以要慎重选择阅读内容。
一颗平静的心，一个健康的身体，一个充满爱的家。这些东西是金钱买不到的，必须通过努力才能获得。
人生的三大要素是财富、健康和幸福。我们依次追求财富、健康和幸福，但按重要性排序，则是反过来的。
可以说，幸福与基因无关，甚至与选择无关，它是一种与个体密切相关、可以后天习得的技能，就像通过锻炼强健体魄、通过吃饭摄取营养一样。 甲之真理，乙之谬论，反之亦然。我所理解的幸福与你所理解的幸福可能大相径庭。我认为，探索自己对幸福的定义非常重要。
人类是具有高度主观意识的生存和繁殖机器，会一刻不停地对周围的一切做出评判。我们不断地接受和判断周围的信息，想着“我需要这个”或者“我需要那个”，深陷欲望之网，难以自拔。而幸福就是一种毫无缺憾感的充盈状态。当感到生命中并不缺少什么时，大脑就会处于休眠状态，不再追忆昨天，也不再畅想明天，不会悔不当初，也不会谋求未来。在没有缺憾感的短暂时间里，你的内心会一片宁静。当内心宁静时，你是满足的，是快乐的。当然，你完全可以不同意我的观点。但我还是要再说一次，每个人的情况都不一样，每个人对幸福的理解也不一样。
人们往往误将积极乐观的想法和行为等同于幸福。随着阅读量、知识面和阅历的增加（阅历很重要，因为实践出真知），我发现每个积极的想法其实都包含一个消极的想法。积极和消极是如影随形的相对概念。《道德经》对此进行了全面深刻的阐述，我的分析当然不能与其相提并论，但归根到底，万物皆有二元性和极性。如果我说现在我很开心，那就意味着在某个时刻我很伤心。如果我说一个人有魅力，意思就是其他人没有魅力。每一个积极想法都有一个消极想法的种子蕴含其中，反之亦然，这就是为什么生命的伟大在很大程度上源于苦难。人必须先看到消极的一面，才能去憧憬和欣赏积极的一面。
对我来说，幸福不等同于积极的心态，也不等同于没有消极的想法。幸福是一种无欲无求的状态，特别是对外界事物的欲望。欲望越少，越能接受事物的当前状态，头脑越平静。所谓“万般烦恼皆因心动”，就是头脑在一刻不停地设计未来或追忆过去。我越是活在当下，越能感受到快乐，感受到满足。而如果我试图抓住当下快乐的感受，想要一直保持快乐的状态，快乐就不会持久。因为，这时我的心在动，欲念在动，希望依附于一个外部事物，欲将一个短暂的情境变成永恒。
对我来说，幸福的含义主要是没有痛苦，没有欲望，不沉溺于对未来或过去的思考，真正拥抱当下，拥抱现状，拥抱现实的一切。
如果想获得内心的平和，你就必须超越对万事万物的善恶评判。
大自然没有幸福或不幸福的概念。从宇宙大爆炸到现在，自然的发展遵循完备的数学定律和一系列因果关系。大自然的一切都浑然天成。幸福或不幸福只存在于我们的大脑，因为我们有欲望，所以给事物贴上了“完美”或“不完美”的标签。世界只是折射个人感受的一面镜子。现实是中性的，现实不做评判。一棵树没有对与错、好与坏的概念。人生在世，我们从大千世界中获得各种各样的感官体验和刺激，耳得之而为声，目遇之而成色。至于如何思考、判断和对待你所感知的一切，全由你自己决定——选择权在你手上。
随着时间的流逝，我也开始相信，个体是渺小的，如沧海一粟，微不足道。这样的认知对我获得幸福感很有裨益。假如你自认为是全宇宙最重要的人，你就会有让整个世界屈从你的意志——既然你是最重要的，那么宇宙怎么可以不符合你的心意呢？如果宇宙不按照你的意志来运转，你就会觉得不对劲儿。但如果你把自己看成一个细菌或变形虫，把自己毕生的努力都看成在水上写字、在沙滩上建城堡，你就不会对生活“本来该有”的模样抱有期待。生活就是这样，现实就是如此。接受了这一点，就无所谓幸不幸福。“幸福”并不是一种客观存在，而是一种主观感受。
人生转瞬即逝，如黑夜中的萤火虫。尘世光阴等刹那，白驹过隙一瞬间。活着就是要充分利用每一分钟。“充分利用”不是说要穷尽所有时间去追逐一些愚蠢的欲望，而是要认识到自己在这个星球上的每一分每一秒都是非常宝贵的。生而为人，就有责任确保自己的幸福，确保用最好的方式诠释万事万物。
理性很强的人可以通过训练自己的无感反应获得平和，即学会漠视自己无法控制的事物。
关于“开悟”，我读到过一个很好的定义：“思考的间隙即开悟。”意思是说，开悟不需要在山顶修行 30 年，而是一个时时刻刻都可以达到的境界。你每天都可以提高自己的开悟水平。
在任何时候（比如走路的时候），大脑都只有很小一部分是关注当下的。大脑把主要精力用于规划未来或悔恨过去。这样的运行机制让人无法获得绝妙的体验，无法欣赏周遭一切事物的美妙之处，无法因为现状常怀感恩之心。如果每天都沉浸在对未来的规划和幻想中，那就是在亲手扼杀自己的幸福。
我应对焦虑的方法就是不与之对抗，让自己意识到这种焦虑感源于脑海中此起彼伏的想法。然后，我会问自己：“我是想一直执着于这些想法，还是想重获内心的平静？”如果大脑中一直存在各种各样的想法，我就无法获得平静，所以，答案是显而易见的。
幸福的人并不是时时刻刻都快乐的人。幸福的人是可以轻松地以特定的方式诠释事件、保持内心平和的人。
我们的根本错觉是：总有一样东西会让我一直满足、永远快乐。
欲望就是你跟自己的约定，约定的内容是：不得到我想要的东西，我是不会快乐的。最近我明白了一个道理：相较于做一些不是自己百分之百想要做的事情，努力调整欲望更重要。
幸福就是满足现状。而成功源于对现状的不满，是对现状的改造。两者只能选一个。
如果不想跟一个人共事一生，那就一天都不要和他共事。
对周遭评判得越多，自我就越膨胀。在某个瞬间，你状态极佳，因为此时你自我感觉良好，觉得自己比别人强。过了一会儿，你就会被孤独感吞噬，目之所及都是烦恼。这个世界是一面镜子，会把你的感受反射给你。
看屏幕的时间越长，幸福感越低；看屏幕的时间越短，幸福感越高。
如何改变习惯？ 选择一件事情，许下一个愿望，并使其具象化。规划一条可持续的路径。确定需求、诱因和替代品。把自己的规划告诉朋友。一丝不苟地稳步前行。自律是通向新的自我形象的桥梁。全面接受新的自我形象，这就是现在的你。
这就是改变习惯的步骤：首先，知道自己要做什么；其次，知道该怎么做；再次，把规划告诉朋友，让一致性偏见发挥作用；最后，严格自律，知行合一，进行自我重塑，直至蜕变成全新的自己。
在生活中，无论面对何种状况，你都有三种选择：改变现状，接受现状，逃避现状。
试图改变现状是一种欲望。在成功改变现状之前，欲望会让人感到痛苦。所以不要总想着去改变外部环境。在任何特定的时间段，只选择一个最有价值的欲望，作为自己的奋斗目标和动力之源。
你所谓的“接受”是什么样子的？所谓接受，就是无论结果如何，都可以泰然处之；就是保持心态平衡，大脑专注；就是退一步海阔天空；就是观大势，顾全局，谋长远。
人生不如意事十之八九。但是，该来的终归要来，有时，正在发生的也许就是最好的。我们越早接受现实，就能越早适应现实。
如何学会接受无法改变的事情？从根本上说，就是学会坦然面对死亡。死亡是人的一生中最重大的事情。人终有一死，选择正视、承认死亡而不是逃避死亡，将赋予人生巨大的意义。我们在一生中会花费大量时间试图逃避死亡。我们的很多奋斗目标都可以归结为对永生的追求。
相对于宇宙，你就像一只在夜空中闪烁的萤火虫，你的生命转瞬即逝。如果能彻底认识到你所做的一切不过是徒劳，你就能获得巨大的幸福感和平和感，因为你会意识到，生命不过是一场游戏。但生命是一场有趣的游戏。在这场游戏中，唯一重要的事情就是随着生命的展开，你要不断的体验现实。既然如此，你为什么不以最积极的方式去诠释自己经历的一切呢？
你那些不开心的时刻、没有享受人生的时刻，不会给任何人带来任何好处。宇宙的幸福值并不是恒定的，别人不会因为你不幸福而变得更加幸福。你在地球上所拥有的时间稍纵即逝，无比宝贵，你一定要好好珍惜。**你要把直面和正视死亡放在第一位。**人的一生，不否认、不回避死亡是极其重要的，因为这是你学会坦然接受无法改变的事情、活在当下的本原。
人固有一死，死后万事皆空。所以，好好享受生命吧。对社会做一些积极的贡献。向世界主动释放和传播爱。给他人带来快乐和幸福。让生活多一些笑声。珍视眼前的每个瞬间。承担使命，尽职尽责，不枉此生。
医生不能让你健康。营养学家不能让你苗条。老师不能让你变聪明。禅师不能让你冷静。智者不能让你富有。教练不能让你健壮。最终，你必须自己负起责任。 救赎靠自己。
在“做自己”这件事情上，没有人能与你竞争。你永远不会像我一样擅长做我自己，我也永远不会像你一样擅长做你自己。当然，做人要虚心聆听，博采众长，但不要盲目模仿。模仿他人纯属徒劳。相反，每个人都有独一无二的资质技能、专业知识、能力才干、个人欲望，这些是世界上其他人所没有的，是先天基因和后天经验共同作用的结果。
你的人生目标是找到最需要你的人、事业、项目或艺术。大千世界，芸芸众生，总有一些人和事会与你完美契合。不要基于别人正在做的事为你自己列清单、做决策。你永远不会成为他们，你永远都不擅长做另一个人。
要做出原创性贡献，必须非理性地痴迷。
世界上最简单的饮食原则：食物加工程度越深，就应该越少摄入。
选择简单模式，人生会越来越困难；选择困难模式，人生会越来越简单。
拿出时间独处，用来专注地自省、写日记、冥想，这可以解决那些没有解决的问题，让超负荷的精神变得清明疏朗。
如果你要给子女传授一两条人生原则，这些原则会是什么？第一条原则是阅读，广泛地阅读。阅读面要广，不要局限与社会认可的书，更不要局限于我推荐的书。要为了阅读而阅读，培养对阅读的热爱。即使喜欢读言情小说、侦探书或漫画书也没关系，不存在所谓的垃圾。开卷有益，尽管读吧。假以时日，你会找到那些你应该读和喜欢读的东西。第二条原则是，**掌握与阅读技巧相关的数学和说服技能。**这两种技能有助于你在现实世界里活得游刃有余、畅行无阻。
拥有说服技能很重要，因为如果能影响自己的同胞，你就可以做成很多事情。我认为，说服力是一项实实在在的技能，而且是可以学会的，并没有那么难。
数学有助于解决生活中所有复杂的难题。如果想赚钱，如果想研究科学，如果想了解博弈论、政治、经济、投资或计算机，你就需要学好数学，因为所有这些都以数学为核心。数学是自然界最基本的语言。
给年轻时的自己一个建议：“做最真实的自己。” 伪装意味着要年复一年地（而不是几分钟）让自己身处烦心伤脑的关系和工作中。
勇气不是在枪林弹雨中冲锋陷阵，而是不在乎别人怎么想。
**珍惜自己的时间。**你唯一真正拥有的就是时间。时间比金钱更重要，比朋友更重要，比什么都重要。你的时间就是你的一切。不要浪费自己的时间。
不要花自己的时间去取悦别人。别人快不快乐是他们的问题，不是你的问题。你快乐了，别人也会快乐。你快乐了，别人会问你是如何快乐起来的，他们会从中学到点什么，但是你没有责任让别人快乐。
什么是愤怒？愤怒是一种强烈的情绪表达，使一个人尽可能向对方表明自己有能力使用暴力的情绪表达。愤怒是暴力的前兆。 **观察自己愤怒时的样子。**愤怒就是对情况失去控制时的表现。愤怒是跟自己的契约，你同意让自己陷入身体、精神和情感的混乱，直到现实发生改变。
若要找到一位优秀的伴侣，你先要成为一位优秀的伴侣。
我们唯一拥有的是当下；除了当下，一切都是不存在的。没有人能够回到过去，也没有人能够以任何有意义的方式成功地预测未来。唯一存在的就是此时此地，就是你恰好存在的这个时刻和在宇宙空间里的这个位置。就像所有伟大而深刻的真理一样，这些都是悖论。任何两个点都是无限不同的。任何时刻都是独一无二的。每一刻都转瞬即逝，时光是抓不住的。
最难的不是做自己想做的事，而是知道自己想要什么。要注意，这个世界上根本没有什么“成年人”，假装成熟的人多了，也就有了成年人。你必须找到属于自己的路，按照自己的方式去挑选、抉择、取舍。先想清楚自己想要的是什么，然后付诸行动。
如果有什么事情是你以后想做的，现在就去做，人生没有“以后”。
市场接受一个产品需要经历很长时间。商业上的合作、职场上的配合都需要一定的磨合期。要想做出优秀的产品是需要时间的，因为你需要不断地、一遍又一遍地打磨它。一旦采取行动，就要速战速决，但等待结果要从容沉着。正如尼维所说，灵感易逝。当灵感乍现时，要马上行动起来。
我觉得设定具体目标的做法并不科学。史考特·亚当斯有句名言：“要建立系统，而不是设定目标。”运用你的判断力确定什么样的环境有助于你茁壮成长，然后在周围创造一个这样的环境，由此增加成功的概率。
当前的环境会塑造大脑，但是聪明的大脑也可以选择和塑造未来的环境。
最了不起的超能力就是改变自我的能力。
如果真的想做一件事，有一个方法就是广而告之，让身边的人都知道。比如，你想戒烟，你可以对你认识的每一个人说：“我戒烟了，我做到了。我向你保证。”
有想法就直接采取行动，就是这么简单。但大多数人都会说自己还没准备好，所以也就不会对朋友广而告之了。如果是这样，你就应该对自己诚实一点儿，直接承认：“我还没有准备好戒烟。我太喜欢抽烟了，要戒掉太难了。”
而如果真的想戒烟，你可以这样想：“我会为自己设定一个更合理的目标，先降到这个数量。我可以让身边的人监督我。我会先坚持三到六个月。达成这个目标后，我会设定下一个目标。我会采取力所能及的实际行动，而不是什么都不做，陷入自我责备。”
**当真的想做出改变时，你就会直接去做。**然而，大多数人并不是真的想改变，暂时也不想承受其中的痛苦。但至少我们可以承认这一点，对自己的感受和想法保持觉知，这样，我们就可以给自己设定切实可行的小目标，让自己真正行动起来。
我的最低目标是，不让自我意识随着年龄的增长继续发展并被强化。我希望自我意识减弱、变柔和，这样我就可以更好地融入当下的现实生活，接受大自然和这个世界的本来面目，像孩子一样随心所欲、天真烂漫地欣赏一切。

2025 年 03 月 05 日写于〔深圳福田〕

通俗易懂解读 AI、Transformer、RAG、Agent 等核心概念

nicejade — Sun, 16 Feb 2025 06:20:40 GMT

在人工智能快速发展的今天，AI、Transformer、RAG、Agent 等术语频繁出现在我们的视野中。这些概念不仅影响着技术发展方向，更与我们的日常生活息息相关。然而，大多数解释要么过于技术性难以理解，要么过于简单无法真正掌握其精髓。

本文旨在用通俗易懂的语言，为读者梳理这些核心概念的来龙去脉。从 1956 年人工智能概念的提出，到当下 ChatGPT 等大语言模型的蓬勃发展，我们将沿着技术演进的时间线，帮助读者建立起对 AI 技术体系的整体认知框架，让这些看似深奥的概念变得触手可及。

什么是人工智能?

1956 年夏天，计算机科学家约翰·麦卡锡（John McCarthy）首次提出"人工智能"（AI）这个概念。

人工智能（AI）指的是：通过软件和硬件，来完成通常需要人类智能才能完成的任务。它的研究对象，就是在机器上模拟人类智能。

什么是机器学习？

早期，人工智能研究分成两个阵营。

第一个阵营是规则式（rule-based）方法，又称专家系统（expert systems），指的是人类写好一系列逻辑规则，来教导计算机如何思考。

可想而知，对于复杂的、大规模的现实问题，很难写出完备的、明确的规则。所以，这种方法的进展一直很有限。

第二个阵营就是机器学习（machine learning），指的是没有预置的规则，只是把材料提供给计算机，让机器通过自我学习，自己发现规则，给出结果。

什么是神经网络？

神经网络（neural network）是机器学习的一种主要形式。

神经网络就是在机器上模拟人脑的结构，构建类似生物神经元的计算网络来处理信息。

一个计算节点就是一个神经元，大量的计算节点组成网络，进行协同计算。

神经网络需要极大的算力，以及海量的训练材料。以前，这是难以做到的，所以 20 世纪 70 年代开始，就陷入了停滞，长期没有进展。

什么是深度学习？

深度学习（deep learning）是神经网络的一种实现方法，在 20 世纪 80 年代由杰弗里·辛顿提出。它让神经网络研究重新复活。

深度学习是一种让多层神经元可以进行有效计算的方法，大大提高了神经网络的性能。"深度学习"这个名字，就是比喻多层神经元的自主学习过程。

多层神经元包括一个输入层和一个输出层，它们之间有很多中间层（又称隐藏层）。以前，计算机算力有限，只能支撑一两个中间层，深度学习使得我们可以构建成千上万个中间层的网络，具有极大的"深度"。

Transformer 是什么？

早些年，深度学习用到的方法是卷积神经网络（CNN）和循环神经网络（RNN）。

2017 年，谷歌的研究人员发明了一种新的深度学习处理方法，叫做 Transformer（转换器）。

Transformer 不同于以前的方法，不再一个个处理输入的单词，而是一次性处理整个输入，对每个词分配不同的权重。

这种方法直接导致了 2022 年 ChatGPT 和后来无数生成式 AI 模型的诞生，是神经网络和深度学习目前的主流方法。

由于基于 Transformer 的模型需要一次性处理整个输入，所以都有"上下文大小"这个指标，指的是一次可以处理的最大输入。

比如，GPT-4 Turbo 的上下文是 128k 个 Token，相当于一次性读取超过 300 页的文本。上下文越大，模型能够考虑的信息就越多，生成的回答也就越相关和连贯，相应地，所需要的算力也就越多。

什么是 RAG？

RAG（Retrieval Augmented Generation检索增强生成）是一种让 AI 模型变得更"博学"的方法。想象你在写一篇论文，除了用自己的知识，还会去查阅参考资料。RAG 就是给 AI 配备了一个"资料库"和"检索系统"。

当 AI 需要回答问题时，会先从资料库中检索相关信息，再结合这些信息来生成答案。这样做有几个好处：

可以获取最新信息，克服模型训练数据落后的问题；
能提供更准确的回答，因为有具体的参考依据；
可以处理特定领域的专业问题，比如公司内部知识；

什么是 AI Agent？

AI Agent（智能代理）可以理解为一个能自主完成任务的 AI 助手。它不只是简单地回答问题，而是能够：

理解用户的长期目标；
制定实现目标的计划；
自主选择合适的工具；
执行必要的操作；
根据执行结果调整计划；

打个比方：

普通的 AI 模型就像一个知识渊博的顾问，你问什么答什么
AI Agent 则像一个能干的助理，你交代一个目标，它就能规划步骤并付诸行动
比如你说"帮我订一张下周去北京的机票"，它会自动查询航班信息、比较价格、考虑你的日程安排，最后完成订票。

这两项技术代表了 AI 发展的重要方向：

RAG 让 AI 变得更懂更准；
Agent 让 AI 变得更能干更自主；

这些技术正在快速发展，未来可能会让 AI 助手变得更像我们的"得力助手"，而不仅仅是一个问答工具。

什么是模型微调？

模型微调（Fine-tuning） 是一种常用的迁移学习（Transfer Learning）技术，用于在已有预训练模型的基础上，针对特定任务进行少量的训练，以适应新的数据集或任务。通过微调，模型能够在保留大部分从预训练中学到的知识的同时，快速适应新的任务需求。

基本思想：模型微调的核心思想是利用在大规模数据集（如 ImageNet、COCO、BERT 等）上预训练的模型，并在新任务中对其进行再训练（即“微调”），使其在特定任务上达到最佳性能。这种方法通常不需要从零开始训练模型，可以显著减少计算资源的需求，并且由于预训练模型已经学习到很多通用的特征，它能在新任务上迅速收敛。

用学习钢琴的例子来解释模型微调：想象你已经学会了弹钢琴的基本功（这就像预训练模型），会看谱、懂节奏、熟悉键盘。现在你想学一首新歌：

基本功（预训练）：

你已经掌握了音阶、和弦；
手指动作很熟练；
节奏感也很好；

学新歌（微调）：

你不需要重新学习基本功；
只需要练习新歌的特殊技巧；
调整你已有的演奏方式；

这就是模型微调：

不是从零开始学习；
而是在已有知识基础上；
针对特定任务进行调整；

比如：让一个通用 AI 模型专门学习医学知识，就像让会弹古典乐的钢琴家去学习爵士乐，只需要调整已有技巧，不用重新学习基础。

模型微调（Fine-tuning）是一种高效的迁移学习方法，通过在已有的预训练模型基础上进行适度训练，使其适应新的任务或数据集。它能够显著减少训练时间、节省计算资源，并且在数据量较小的情况下，帮助模型更快地收敛和提高性能。微调在许多领域，如计算机视觉、自然语言处理等，得到了广泛应用。

什么是注意力机制？

注意力机制（Attention Mechanism）是人工智能领域，特别是在自然语言处理（NLP）和计算机视觉等领域中，一个非常重要的概念。它的核心思想是让模型在处理数据时能够专注于最相关的部分，而不是平等地对待所有输入。这类似于人类在阅读或听取信息时，会更关注某些关键点或词语。用一个简单的例子来解释注意力机制：

想象你在看一幅热闹的校园照片。这张照片里有操场上打篮球的同学、教学楼前走动的老师、花园里的花朵，还有天空中的白云。当我问你"照片里的篮球是什么颜色的？"时，你的大脑会自动把注意力集中在打篮球的那部分画面上，而暂时"忽略"其他部分。这就是人类的注意力机制。

AI 的注意力机制也是类似的原理：

就像你的眼睛会自动聚焦在重要的地方，AI 在处理信息时也会"聚焦"在最相关的部分。
举个例子：
- 当 AI 翻译"I love my mother"这句话时
- 翻译"love"这个词的时候，AI 会特别"关注"前后的"I"和"mother"
- 因为知道"我"和"妈妈"是主语和宾语，所以能准确翻译成"我爱我的妈妈"
- 而不会错误地翻译成"我喜欢我的妈妈"或"我疼爱我的妈妈"
再比如：
- 当你问 AI "北京的天气怎么样？"
- AI 会特别"注意"关键词"北京"和"天气"
- 而不会被其他无关的信息干扰

简单来说，注意力机制就是帮助 AI "抓重点"的能力，让它能够像人类一样，在处理信息时把注意力集中在最重要的部分。这样 AI 就能更好地理解和处理信息，给出更准确的回答。注意力机制极大地增强了模型处理长距离依赖关系的能力，提升了在各种任务中的表现。它的发展也推动了诸如 BERT、GPT 等模型的成功应用。

什么是强化学习？

强化学习（Reinforcement Learning, RL） 是一种机器学习方法，它使智能体（agent）通过与环境交互并根据反馈调整其行为，以最大化累积的奖励。这种学习方式模仿了生物体在复杂环境中学习和适应的过程，通过试错和奖励机制来学习最优的决策策略。

强化学习的过程可以用以下的循环来描述：

初始化：智能体初始化其策略或价值函数，并开始在环境中执行操作。
与环境交互：智能体在环境中选择一个动作，并根据当前的状态执行该动作。
获取反馈：环境会根据智能体的动作返回一个奖励（或惩罚）以及新的状态。
更新策略：智能体通过调整其策略或价值函数，学习如何选择能带来更多奖励的动作。
重复：智能体继续在环境中探索，不断优化其行为，直到它学习到一个有效的策略。

举例说明：想象一下训练一只小狗，你想教小狗学会坐下。你会怎么做呢？

发出指令：你说“坐下”。
观察小狗：小狗可能会站着不动，或者做其他动作。
给予反馈：
- 如果小狗坐下了，你就给它一块骨头（奖励）。
- 如果小狗没有坐下，你就什么也不做，或者轻轻纠正它（没有奖励或轻微惩罚）。

通过不断的重复这个过程，小狗就会逐渐明白，“坐下”的指令和“得到骨头”之间是有联系的。它会为了得到骨头（奖励）而学会坐下。

强化学习就像这样！它是一种让计算机（人们称之为“智能体”）通过与环境互动来学习的机器学习方法。就像训练小狗一样，智能体通过尝试不同的“动作”，并根据环境的“反馈”（奖励或惩罚）来学习如何做出最佳的“决策”。

强化学习的几个关键概念：

智能体（Agent）： 就是学习的主体，比如上面例子中的小狗，或者是一个游戏中的角色，甚至是一个控制机器人的程序。
环境（Environment）： 智能体所处的世界，比如小狗生活的房间，或者是一个游戏的虚拟世界。
动作（Action）： 智能体可以做的事情，比如小狗可以坐下、站立、跑动，或者游戏角色可以跳跃、攻击、移动。
状态（State）： 环境当前的情况，比如小狗是站着还是坐着，或者游戏角色在地图上的位置。
奖励（Reward）： 智能体完成某个动作后，环境给出的反馈。好的动作会得到正向奖励（比如骨头、得分），不好的动作可能会得到负向奖励（比如惩罚、损失）。

强化学习在很多领域都有应用，比如：

游戏： 像 AlphaGo 这样的人工智能程序，通过强化学习战胜了围棋世界冠军。
机器人控制： 让机器人学习如何行走、抓取物体等。
自动驾驶： 训练汽车在复杂的道路环境中安全行驶。
推荐系统： 根据用户的喜好推荐商品或内容。

总之，强化学习（RL）是一种通过与环境互动、根据奖励进行学习的机器学习方法。它的目标是让智能体能够在复杂和动态的环境中自主学习最优策略。强化学习已广泛应用于游戏、机器人、自动驾驶、金融等多个领域，并且随着技术的不断进步，未来在实际应用中的潜力仍然非常巨大。

什么是迁移学习 (Transfer Learning) ？

迁移学习 （Transfer Learning）是一种机器学习方法，旨在将一个领域或任务上学到的知识应用到另一个相关但不同的领域或任务中。与传统机器学习方法通常依赖于从零开始训练一个模型不同，迁移学习通过利用源领域（source domain）上学到的知识，帮助模型在目标领域（target domain）中进行更快速和高效的学习。

迁移学习核心思想：迁移学习的核心思想是知识的迁移，即利用已学到的知识来加速在新任务上的学习，尤其是在目标任务数据不足时。具体来说，如果我们能从一个任务中学到一些有用的知识，这些知识可能对与之相关的其他任务有帮助，迁移学习就是试图通过这种方式减少从零开始学习的成本。

**先想想我们自己是怎么学习的：**你学会了骑自行车，后来再学骑摩托车是不是就比较容易了？因为你已经掌握了平衡、控制方向等基本技巧。这就是一种“迁移”——把已有的知识应用到新的学习中。

迁移学习就像这样！迁移学习是机器学习中的一种方法，它把在一个任务中学到的知识“迁移”到另一个相关的任务上，从而更快、更好地完成新任务。

举例说明：假设你教一台电脑识别猫和狗的照片。你用大量的猫和狗的照片训练它，让它学会了区分猫和狗。

现在，你想让这台电脑识别老虎和狮子的照片。如果从头开始训练，你需要收集大量的老虎和狮子的照片，这很费时费力。

但是，如果你使用迁移学习，就可以利用之前学习猫和狗的知识。因为老虎和狮子都属于猫科动物，它们和猫有很多相似之处，比如都有相似的身体结构、面部特征等等。

通过迁移学习，你只需要用少量的老虎和狮子照片“微调”一下之前训练好的模型，就能让电脑很快学会识别老虎和狮子。

迁移学习的关键点：

源任务（Source Task）： 已经学会的任务，比如识别猫和狗。
目标任务（Target Task）： 需要学习的新任务，比如识别老虎和狮子。
迁移： 把源任务中学到的知识应用到目标任务上。

迁移学习的优势：

节省时间和资源： 不需要从头开始训练模型，大大减少了训练所需的数据量和计算资源。
提高学习效率： 可以更快地达到较高的准确率。
解决数据不足的问题： 当目标任务的数据量很少时，迁移学习尤其有用。

再举几个生活中“迁移学习”的例子：

你学会了弹钢琴，再去学电子琴就比较容易上手。
你学会了打羽毛球，再去学网球也更容易掌握一些基本技巧。
你学会了说中文，再去学习其他语言，比如日语或韩语，也会更容易一些。

总之，迁移学习就是把已有的知识应用到新的学习中，就像我们人类学习新事物一样。在机器学习中，它是一种非常有效的方法，可以帮助我们更快、更好地解决问题。

什么是元学习？

元学习（Meta Learning），又称为“学习如何学习”，是一种旨在让模型能够从过去的经验中快速学习并适应新任务的学习方法。其核心思想是通过在多种任务上训练模型，使其具备良好的泛化能力，从而能够在面对新的、少量样本的数据时快速学习并做出决策。

元学习的基本思想：传统的机器学习方法通常需要大量的标注数据和多次训练才能完成任务。然而，在实际应用中，数据可能非常有限或者任务变化较大，这时传统的机器学习方法往往无法有效应对。元学习的目标是让模型在遇到新任务时，能够迅速适应，甚至在只给定少量的训练样本后就做出合理的决策。

元学习不仅仅关注如何通过给定的训练数据学习，而是关注如何通过多个任务的训练经验，设计一个能够有效“迁移学习”的模型，使其能够在新的任务上快速学习。用学习语言的例子来解释元学习：

想象你已经学会了英语和法语。当你开始学习西班牙语时，你会发现：

你已经知道"怎么学习一门语言"；
你知道该先学习基本单词；
知道该怎么记忆语法规则；
知道该怎么练习口语；

这就是元学习：

不是学习具体的知识；
而是学习"如何更好地学习"；
掌握学习的方法和技巧；

就像一个"学习高手"：

面对新知识，知道最有效的学习方式；
能快速找到学习重点；
知道如何避免常见错误；

对 AI 来说，元学习就是：

训练它掌握学习新任务的方法；
让它能更快地适应新情况；
用更少的数据学会新技能；

总之，元学习是一种旨在让模型通过训练多个任务获得“学习如何学习”的能力，能够在面对新任务时快速适应。它在少样本学习、快速任务迁移和强化学习等领域具有广泛应用。随着元学习技术的发展，越来越多的实际问题可以通过这种方法进行高效解决。

什么是对抗生成网络？

对抗生成网络（Generative Adversarial Networks, GANs） 是一种深度学习模型，用于生成逼真的数据样本。它由两个神经网络组成：生成器（Generator） 和 判别器（Discriminator），这两个网络通过对抗训练相互博弈，最终使生成器能够生成极为逼真的数据，能够“欺骗”判别器，使其无法分辨真实数据和生成数据之间的差异。

GANs 的核心思想：通过“对抗”的方式训练两个网络，一个负责生成数据（生成器），另一个负责判断数据是否真实（判别器）。生成器和判别器的目标是互相对抗，生成器力求产生足够逼真的数据以骗过判别器，而判别器则不断学习如何区分真实数据和生成数据。

举例说明：想象一下，你是一个画家，你想画一幅逼真的风景画。你努力地画，然后请一位美术老师来评价。

如果你画得不够好，老师会指出你的不足之处，比如“树画得不够立体”、“颜色用得不对”等等。
你会根据老师的建议修改画作，然后再请老师评价。

通过不断地练习和老师的指导，你的画技会越来越好，最终画出非常逼真的风景画。

生成对抗网络（GANs）就像这样！GANs 由两个神经网络组成，它们就像画家和美术老师一样进行“对抗”：

生成器（Generator）： 就像画家一样，负责“生成”新的数据，比如图像、音乐、文章等等。它试图创造出尽可能逼真的“假”数据。
判别器（Discriminator）： 就像美术老师一样，负责“判别”输入的数据是“真”的（来自真实数据集）还是“假”的（由生成器生成）。

它们是如何“对抗”的呢？

生成器生成“假”数据： 生成器接收一些随机的“噪声”作为输入，然后将其转换成看似真实的数据，比如一张人脸照片。
判别器进行判别： 判别器同时接收“真”数据（来自真实人脸照片数据集）和生成器生成的“假”数据，然后判断哪个是“真”的，哪个是“假”的。
反馈和改进： 判别器会将判别结果反馈给生成器，告诉生成器它生成的“假”数据哪里不够逼真。生成器根据反馈进行调整，试图生成更逼真的数据。

这个过程不断重复进行，生成器越来越擅长生成逼真的“假”数据，而判别器也越来越擅长分辨真假。最终，当判别器无法分辨出数据是“真”的还是“假”的时，就说明生成器已经非常成功了。

GANs 的应用：

GANs 在很多领域都有应用，比如：

图像生成： 生成逼真的人脸照片、风景画、动漫人物等等。
图像编辑： 修改照片，比如换脸、修复老照片、图像超分辨率等等。
音乐生成： 生成新的音乐作品。

总之，GANs 通过两个神经网络的“对抗”学习，使生成器能够生成逼真的数据。它是一种非常强大的深度学习模型，在很多领域都有广泛的应用前景。

什么是知识蒸馏？

知识蒸馏 （Knowledge Distillation）是一种在深度学习领域中，旨在将一个复杂的模型（通常称为“教师模型”）的知识转移到一个较小、更简洁的模型（通常称为“学生模型”）中的技术。通过这种方法，学生模型能够在不需要与教师模型一样庞大的参数量的情况下，达到类似的性能表现。

基本思想：在传统的深度学习训练中，我们通常使用大型模型（如深度神经网络）进行训练，这些模型拥有非常多的参数和计算量，导致训练和推理过程非常耗时且资源消耗大。知识蒸馏通过将一个已经训练好的大型模型（教师模型）的知识压缩到一个更小的模型（学生模型）中，目的是让学生模型尽可能模拟教师模型的行为，尤其是在输出概率分布和决策上，从而在不牺牲精度的情况下，提升推理效率。

举例说明：想象有一位大厨（大模型）和一位学徒（小模型）。大厨做菜非常美味，但需要昂贵的食材和复杂的设备。我们想让学徒也能做出相似的美味菜品，但用更简单的方法。知识蒸馏就是：

让大厨展示做菜的全过程；
学徒观察并学习最关键的步骤；
用更简单的方法复现相似的味道；

就像把一道复杂的米其林菜谱，简化成家常版本。虽然不是完全一样，但用更少的资源就能做出八分相似的味道。

总体来说，知识蒸馏是一种高效的模型压缩技术，可以在保留高精度的同时，显著提高模型的计算效率，广泛应用于各种实际场景中。

什么是提示工程？

提示工程（Prompt Engineering） 是指在使用语言模型（如 GPT-4、GPT-4o 等）时，通过精心设计输入提示（即“prompt”），使得模型能够产生更准确、相关和高质量的输出的过程。随着大规模语言模型（LLM）在各个领域的广泛应用，提示工程成为了利用这些模型的关键技能之一。通过调整提示的结构、内容、语气或上下文，用户可以引导模型产生不同类型的回答，优化任务的完成效果。

提示工程的核心思想

语言模型是基于大量数据和上下文进行训练的，它们在生成文本时依赖于输入的提示内容。简单来说，提示工程就是设计和优化输入的提示，以使得模型能够生成预期的、高质量的输出。

例如，如果你希望模型提供某个特定领域的详细解释，如何组织提示能有效地引导模型理解任务并生成准确的信息，就是提示工程的工作之一。

举例说明

**想想你平时怎么用搜索引擎：**你想在网上查找“如何制作美味的蛋糕”，你会怎么输入搜索词？

输入“蛋糕”？
输入“制作蛋糕”？
输入“如何制作美味的巧克力蛋糕”？

显然，第三种输入方式更能准确地找到你想要的信息。这就是一个简单的“提示”——你给搜索引擎的指令。

提示工程就像这样！提示工程是针对大型语言模型（LLMs），比如 ChatGPT、Claude 等，通过设计、实验和优化“提示词”来引导模型生成高质量、准确和有针对性的输出的技术。

为什么提示工程很重要？

模型能力的利用：大型语言模型具有强大的理解和生成能力，但它们并不会自动理解你需要的任务类型。通过设计合适的提示，可以更好地发挥模型的能力。
精确控制输出：根据提示的不同，模型可能生成完全不同风格和内容的回答。通过优化提示，你可以获得更具体、更符合需求的输出。
降低计算成本：对于一些复杂的任务，好的提示设计可以减少模型需要的推理步骤和计算量，从而提高效率。
提高响应质量：良好的提示设计可以减少不相关的信息，减少误解，提升模型输出的准确性和相关性。

提示工程的常见策略

明确任务描述：
- 明确告诉模型你希望它做什么。例如，直接向模型提出任务：“请列出五个关于机器学习的常见算法。”
- 可以提供额外的上下文，明确任务要求，如限制输出格式：“请用表格列出五个机器学习算法及其优缺点。”
指定输出格式：
- 有时，设计一个合适的格式可以使输出更清晰、结构化。例如，指定输出为一个段落、列表、代码块等，帮助模型理解你想要的结果格式。
- 示例：“用代码块输出一个 Python 实现二分查找的函数。”
上下文和背景信息：
- 在提示中提供相关的背景信息或上下文，能够帮助模型更好地理解你的需求。比如，提供一些先前的对话内容或简短的上下文信息，使得模型能够基于这些信息做出更合适的回答。
- 示例：“根据以下产品描述，写一段市场推广文案。”
使用示例引导：
- 提供一个示例或者模板，让模型跟随示例进行生成。这种方式对于复杂或多样化的任务特别有效。
- 示例：“下面是一个好的商务邮件模板，请按照这个格式编写一封邮件邀请客户。”
开放性问题与限定性问题：
- 对于需要详细解释或创造性输出的任务，提出开放性问题可能更合适。例如，“解释什么是量子计算？”。
- 如果需要一个简洁的答案，使用限定性问题，例如**“量子计算的定义是什么？”**。
多轮对话提示：
- 对话型任务通常涉及多轮交互，因此每轮交互的提示设计都应基于前一轮的结果。可以在每次提问时，引用之前的回答来引导模型继续生成。
- 示例：“根据上面提到的三个优势，列出它们可能的缺点。”
避免歧义：
- 尽量避免使用模糊或多义性强的语言，因为这可能导致模型生成不相关或错误的答案。明确的提示往往能更好地控制输出。

提示工程的应用场景

提示工程广泛应用于许多实际任务中，包括但不限于：

文本生成：
- 写作和内容创作：提示工程在自动生成文章、博客、广告文案等创意写作中至关重要。通过合理的提示，可以让模型生成有针对性的、符合风格要求的内容。
代码生成：
- 程序员助手：通过适当的提示，用户可以让语言模型生成特定的代码片段，甚至帮助解决编程问题。例如，要求模型写一个特定功能的 Python 函数。
翻译：
- 语言翻译：通过适当的提示，用户可以使模型在特定上下文中提供准确的翻译。例如，指定翻译风格或用词，如正式或口语化的翻译。
对话系统：
- 虚拟助手与聊天机器人：在与模型进行对话时，如何设置问题和回答的提示，决定了模型的响应质量。比如，明确要求模型回答具体问题或提供详细信息。
信息检索和问答系统：
- 通过精心设计提示，可以让模型从大量文档或数据库中提取相关信息，快速生成高质量的问答对。例如，提出一个问题时，明确要求返回的答案应包含具体数据或案例。
教育和培训：
- 通过提示工程，模型可以帮助生成题库、解释概念、或引导学生完成作业。这种技术在自动化教学和辅导中越来越被采用。
情感分析与社会情感智能：
- 通过设计合适的提示，帮助模型判断文本的情感倾向，提供关于某个话题的情感反馈。

提示工程的挑战与未来

多样性与复杂性：
- 由于语言模型的输出受到提示的影响，设计有效提示需要考虑多种可能性和多样性。不同的提示可能导致完全不同的输出结果，因此设计高效、准确的提示成为一项挑战。
理解模型的局限性：
- 虽然语言模型在许多任务中表现优秀，但它们并不总是能理解复杂的任务背景或常识。因此，提示设计时要意识到模型的局限性，尽量避免过于复杂或超出模型能力范围的提示。
标准化与自动化：
- 随着提示工程的普及，可能会发展出一些标准化的提示模板和方法，帮助用户快速生成有效的提示。此外，自动化生成或优化提示的工具也有可能成为未来的发展方向。

总结

提示工程 是在使用大型语言模型时，精心设计输入提示来优化模型输出的过程。它涉及任务的明确描述、上下文信息的提供、输出格式的要求等，目的是帮助模型理解用户需求并产生更符合要求的输出。随着 AI 和自然语言处理技术的发展，提示工程在各个行业中都越来越重要，并且有着广泛的应用场景。

什么是 Model Context Protocol (MCP)？

关键点：Model Context Protocol (MCP) 是一个开放标准，连接 AI 模型与外部数据和工具，让 AI 能执行更多实际任务。

MCP 是一个协议，帮助大型语言模型 (LLMs) 连接到外部数据源和工具，比如数据库、网页服务或项目管理工具。它就像一个“万能接口”，让 AI 不仅能理解和生成文字，还能执行具体操作，例如自动生成报告、更新任务或查询天气数据。

它能为用户带来什么？

更强大的功能： 用户可以让 AI 自动完成各种任务，比如监控 GitHub 问题、生成销售报告或创建项目文档，极大提升工作效率。
简单集成： MCP 消除了为每个数据源单独开发的麻烦，提供统一标准，方便开发者构建智能应用。
安全可靠： 数据访问需要用户明确批准，确保敏感信息安全。
灵活性： 支持多种 AI 模型（如 Claude 或 Gemini），还能组合多个 MCP 服务器完成复杂任务，例如同时使用 GitHub 获取数据，再用 Notion 生成报告。

令人惊讶的细节： MCP 是由 Anthropic 开发的一个开源项目，社区可以参与贡献，未来可能覆盖更多工具和数据源。

如何开始使用？
用户可以从 GitHub 仓库 (Model Context Protocol GitHub) 下载现成的 MCP 服务器，安装后通过平台如 Cline 配置使用，甚至可以自定义服务器满足特定需求。

以下是关于 MCP 的详细报告：

Model Context Protocol (MCP) 是一个由 Anthropic 开发并开源的协议，旨在解决 AI 模型与外部数据源和工具集成中的挑战。通过提供一个标准化框架，MCP 使大型语言模型 (LLMs) 能够无缝连接到各种系统，从而扩展其功能，适用于更广泛的实际场景。本报告将详细探讨 MCP 的定义、工作原理、用户价值以及使用案例，并提供实施指导。

MCP 的定义与背景

MCP 是一个开放协议，专门为 LLM 应用与外部数据源和工具的集成设计。它解决了传统 AI 模型因数据孤岛而受限的问题，即每个新数据源都需要定制集成，导致扩展困难。MCP 通过提供一个通用的标准接口，简化了这一过程，使开发者能够更高效地构建智能应用。

根据 Anthropic 的介绍，MCP 的目标是帮助前沿模型生成更相关、更高质量的响应，特别是在内容仓库、业务工具和开发环境等场景中。它的开源性质（由 Anthropic, PBC 运营）鼓励社区参与，欢迎开发者贡献代码、改进文档或提出新功能，详情可见 Model Context Protocol GitHub。

MCP 的工作原理

MCP 采用客户端-服务器架构，具体如下：

组件	描述
MCP 服务器	轻量级程序，通过标准化协议暴露特定功能，例如访问 Google Drive、GitHub 或数据库。服务器提供工具、提示和资源，供 AI 使用。
MCP 客户端	AI 应用（如 Claude Desktop 或 IDE 插件），与服务器建立 1:1 连接，获取所需数据或执行操作。
MCP 主机	希望通过 MCP 访问数据的程序，例如 AI 工具或桌面应用，充当客户端与服务器之间的桥梁。

工作流程包括：

MCP 主机发现连接服务器的能力，并加载其工具、提示和资源。
资源提供只读数据访问，类似于文件路径或数据库查询。
工具是 LLM 可执行的函数，例如发送推文或生成报告。
安全机制隔离凭据和敏感数据，所有交互需用户明确批准。

这一架构确保了数据访问的效率和安全性，详见 MCP 规范。

用户价值与用例

MCP 的核心价值在于增强 AI 的实用性，使其不仅限于文本生成，还能执行实际操作。以下是具体优势：

无缝集成： 传统上，每个数据源都需要定制集成，MCP 通过统一标准消除了这一障碍。根据 Medium 文章，它打破了信息孤岛，使 AI 系统更具可扩展性。
增强功能： 用户可以利用 AI 完成多种任务，例如：
- Web 服务/API 集成： 监控 GitHub 问题、发布 X 更新、获取天气数据。
- 浏览器自动化： 自动化网页测试、刮取电商价格、生成网站截图。
- 数据库查询： 生成销售报告、分析客户行为、创建实时仪表盘。
- 项目/任务管理： 自动创建 Jira 工单、生成进度报告、设置任务依赖。
- 代码库文档： 生成 API 文档、创建架构图、维护 README 文件。
安全与控制： MCP 服务器隔离凭据，交互需用户批准，确保数据安全，特别适合处理敏感信息。
灵活性与兼容性： 不依赖特定 LLM，可与 Claude、Gemini 等模型配合使用。用户还能组合多个 MCP 服务器完成复杂任务，例如使用 GitHub 服务器获取数据，再用 Notion 服务器生成格式化报告（见 X post by @MarshalXuan）。

使用案例与实施指导

为了帮助用户快速上手，以下是具体步骤：

使用现有服务器： 从 GitHub 仓库（如 Model Context Protocol 服务器）克隆预构建的 MCP 服务器。
安装与构建： 安装依赖（如使用 pnpm i && pnpm run build），根据 README 配置（如 cline_mcp_settings.json）。
集成与使用： 通过平台如 Cline 使用自然语言驱动 AI 执行任务，若未设置自动批准，需手动批准交互。
定制或自建： 根据需求修改现有服务器，或使用 Anthropic 的 Python 和 TypeScript SDK 自建服务器，详见 MCP 介绍。

例如，Cline 结合 MCP 的体验被用户高度评价（见 X post by @MarshalXuan），支持 Markdown 转换（如 PDF 到 Markdown）、YouTube 视频摘要等，具体见 Cline 的 MCP 文档。

安全考虑

MCP 注重安全，建议用户：

使用安全认证机制。
将敏感数据存储在环境变量中。
限制访问权限，仅授权用户可访问。
验证输入，防止注入攻击。
实现安全日志记录，避免暴露数据。

这些措施确保了 MCP 在企业级应用中的可信度。

社区与未来发展

作为开源项目，MCP 由社区驱动，开发者可通过 GitHub 提交问题、参与讨论或贡献代码。当前版本（如 2024-11-05）仍在发展中，未来可能覆盖更多数据源和工具，详见 MCP 规范修订。

总结

MCP 是一个革命性的协议，将 AI 模型与现实世界连接起来，赋予用户构建更智能、更实用的 AI 应用的能力。通过标准化接口，它简化了数据集成，扩展了 AI 的功能，适用于从个人生产力到企业级解决方案的各种场景。无论是开发者还是普通用户，MCP 都提供了强大的工具来释放 AI 的潜力。

Rust 编程中宏与函数的深入解析与应用

nicejade — Thu, 26 Dec 2024 11:23:32 GMT

Rust 语言以其陡峭的学习曲线而闻名，即便对有着 C++、Java 等编程经验的开发者来说，其独特的所有权系统、生命周期和借用检查等核心概念也常常令人困惑。但别担心，在向 AI 助手提问时，只要在问题后面加上类似'请用通俗易懂的方式解释，就像在向一个 15 岁的初学者讲解'这样的提示语，AI 就能调整解释的深度和方式，用更生动、形象的比喻和例子来阐述复杂概念。这种学习方法不仅能帮你更快理解 Rust 的精髓，还能让抽象的编程概念变得具体可感。

请谈谈 Rust 语言中，宏和函数的区别，最好深入浅出，使得我 15 岁的外甥女可以听懂。

好的，我会尽量用简单易懂的方式来解释 Rust 中宏（macros）和函数（functions）之间的区别。

1. 基本概念：什么是函数？

首先，我们先回顾一下什么是函数。函数就是一段可以重复使用的代码，它能接收输入（叫做“参数”），然后做一些事情，最后返回一个结果。

举个例子：

fn 加法(a: i32, b: i32) -> i32 {
    a + b
}

这就是一个简单的函数。它接收两个整数 a 和 b，然后返回它们的和。你可以多次调用这个函数，只需要给它不同的输入。

使用这个函数：

let 结果 = 加法(5, 10);
println!("结果是: {}", 结果);

2. 什么是宏？

宏就有点像一个能生成代码的“代码工厂”。它不像函数那样直接运行，它在编译时（也就是程序编译之前）生成代码。宏可以接受的输入非常灵活，可以自动生成很多重复的代码，帮助我们避免手动写重复的内容。

宏的特点：

宏不只是一个单纯的“做事”的代码块，它可以生成代码。
宏的输入不局限于简单的参数，它可以是代码块、表达式，甚至是另一段代码。
宏的工作发生在编译时，而不是运行时。

举个宏的例子：

macro_rules! 打印 {
    ($x:expr) => {
        println!("你传入的值是: {}", $x);
    };
}

这段代码定义了一个叫 打印 的宏。$x:expr 是一个参数，表示它可以接受任何表达式。println! 会把你传入的值打印出来。

使用宏：

打印!(10);  // 打印: 你传入的值是: 10
打印!("Hello, World!");  // 打印: 你传入的值是: Hello, World!

3. 宏和函数的区别

那么，宏和函数到底有什么区别呢？

(1) 代码执行的时机不同：

函数：代码是“运行时”执行的，也就是说你在程序运行时调用它，代码才会被执行。
宏：代码是“编译时”执行的。宏不会直接在你调用的时候执行，而是在编译阶段，由编译器生成对应的代码。

(2) 参数的处理方式不同：

函数：函数的参数是固定的，它们只是一些值（比如整数、字符串等），每次调用函数时，传入的值必须是已经明确的。
宏：宏的参数可以非常灵活，它不仅可以接受值，还能接受复杂的代码结构（比如整个代码块）。而且，宏能“理解”并“改写”这些代码。

(3) 能做的事情不同：

函数：函数的功能是固定的，它只能做你在函数内部写的事情。它更简单，更直接。
宏：宏的功能非常强大，可以根据传入的内容生成不同的代码。宏能动态地生成重复的代码，甚至能改变程序结构。

4. 简单对比：

特性	函数	宏
执行时机	运行时	编译时
参数类型	一般是值	可以是值、代码块，甚至是表达式
灵活性	固定的功能，代码简洁	灵活多变，可以生成重复的代码，甚至改变代码结构
性能	通常有运行时开销	没有运行时开销（生成的代码直接在编译时展开）

5. 例子：宏如何生成代码

假设你有一个场景，你需要打印很多东西，比如：

println!("第一行");
println!("第二行");
println!("第三行");

你可以使用宏来避免重复写 println!：

macro_rules! 打印多行 {
    ($($x:expr),*) => {
        $(
            println!("{}", $x);
        )*
    };
}

使用这个宏：

打印多行!("第一行", "第二行", "第三行");

这里，宏会自动生成类似下面的代码：

println!("第一行");
println!("第二行");
println!("第三行");

通过这个宏，你只需要写一次宏的调用，就能生成重复的代码。

总结：

函数是一段固定的代码，可以接收一些参数并返回结果。
宏是一个可以生成代码的工具，它在编译时运行，可以灵活地接受代码作为输入并产生不同的输出。

希望这些解释能帮助你理解宏和函数的区别！

请谈谈 Rust 语言中，方法和函数的区别，请用通俗易懂的方式解释，就像在向一个 15 岁的初学者讲解

好的，我会尽量用通俗易懂的方式来解释 Rust 中方法和函数的区别，就像向一个 15 岁的初学者讲解一样。

1. 函数（Function）是什么？

函数是一个独立的代码块，可以接受一些输入（我们叫它参数），然后做一些工作，最后返回一个结果。

你可以把函数想象成一个“工具”，你可以多次使用它，只需要给它不同的输入，它就能返回你想要的结果。

举个例子：

fn 加法(a: i32, b: i32) -> i32 {
    a + b
}

这个 加法 函数接收两个数字 a 和 b，然后返回它们的和。你可以通过调用 加法(3, 5) 来得到 8。

使用这个函数：

let 结果 = 加法(3, 5);
println!("结果是: {}", 结果);  // 输出：结果是: 8

2. 方法（Method）是什么？

方法其实是一个特定的函数，它跟某个“对象”或者“类型”紧密相关。简单来说，方法是 附属于某个类型（通常是结构体、枚举或者其他类型）的一种函数。你可以把它理解为“对象”或“类型”的一种能力。

在 Rust 中，方法定义时需要使用 impl 关键字，表示该方法是某个类型的“实现”。方法的一个特别之处是，它的第一个参数是 self，代表方法所作用的那个对象。

举个例子：

struct 车 {
    品牌: String,
    颜色: String,
}

impl 车 {
    fn 启动(&self) {
        println!("{} 启动了！", self.品牌);
    }
}

这里我们定义了一个 车 结构体，它有 品牌 和 颜色。然后，我们定义了一个方法 启动，它会输出“车启动了”的消息。

使用这个方法：

let 我的车 = 车 {
    品牌: String::from("特斯拉"),
    颜色: String::from("红色"),
};

我的车.启动();  // 输出：特斯拉 启动了！

在这个例子中，启动 方法是附属于 车 类型的，所以它在调用时需要通过 我的车.启动() 来使用。

3. 方法和函数的区别

(1) 定义的位置不同：

函数是独立存在的，通常是在代码的顶层定义的。
方法必须在一个类型的 impl（实现）块中定义，它是属于某个类型的。

(2) 第一个参数不同：

函数的参数可以是任意的，不需要特殊要求。
方法必须至少有一个特殊的参数 self，它代表了方法所作用的那个对象。

(3) 调用方式不同：

函数是通过名字直接调用的，不需要指定一个对象。
方法是通过某个对象或实例调用的，需要在对象后加上一个点（.）运算符。

(4) 作用域不同：

函数可以独立于类型存在，适用于任何地方。
方法只能用于它所属的类型，通常与结构体、枚举等类型紧密结合。

4. 总结：

特性	函数	方法
定义位置	独立的，可以在任何地方定义	必须在某个类型的 `impl` 中定义
第一个参数	没有特殊要求	必须有一个 `self` 参数，表示方法作用的对象
调用方式	直接调用，比如 `函数名()`	需要通过对象调用，比如 `对象.方法()`
作用范围	可以用于任何地方	只能作用于某个类型的实例

5. 简单类比：

函数就像是一个工具箱，你可以随时取出你需要的工具，按需求使用。
方法就像是某个设备（比如手机或汽车）内置的一项功能。你不能单独使用它，必须在设备上操作才能激活这个功能。

6. 再举个例子：

假设你有一个 学生 类型，它包含名字和年龄。你可以定义一个方法来打印学生的信息，同时定义一个函数来进行学生成绩的加法。

struct 学生 {
    姓名: String,
    年龄: i32,
}

impl 学生 {
    fn 打印信息(&self) {
        println!("学生姓名：{}，年龄：{}", self.姓名, self.年龄);
    }
}

fn 计算成绩(成绩1: i32, 成绩2: i32) -> i32 {
    成绩1 + 成绩2
}

这里，打印信息 是 学生 类型的方法，它通过 self 引用学生对象；而 计算成绩 是一个普通的函数，它不属于任何类型，只是简单的接收两个成绩并返回它们的总和。

最后总结：

函数是一种独立的代码块，可以接收参数并返回结果。
方法是附属于某个类型（比如结构体或枚举）的函数，它需要通过该类型的对象来调用。

希望这个解释让你更清楚方法和函数的区别！

如何像 Elon Musk 一样思考？——第一性原理的应用

nicejade — Fri, 15 Nov 2024 11:17:23 GMT

“第一性原理”是一种思考方式，指的是回溯事物的本质，将其拆分成各要素进行解构分析，并从这些基本要素中找到实现目标最优路径的方法。这种思维方式可以帮助我们更好地解决问题，摆脱思维定式，找到更经济、更高效的解决方案。本文将通过分析埃隆·马斯克（Elon Musk）的思考方式，来展示如何应用第一性原理于日常生活中。我们将从日常问题的分析入手，通过拆解基本要素，找到更经济且有效的解决方案，并总结出一些实用性建议。

什么是第一性原理？

第一性原理（First Principles Thinking）指的是，回归事物最基本的条件，将其拆分成各要素进行解构分析，从而找到实现目标最优路径的方法。该原理源于古希腊哲学家亚里士多德提出的一个哲学观点：“每个系统中存在一个最基本的命题，它不能被违背或删除”，后被 Elon Musk 发扬光大，传播四海。以下是关键要点:

核心思维方法

分解 - 将复杂问题拆分为最基础的真理和要素；
重构 - 基于这些基本要素重新构建解决方案；
突破 - 跳出经验主义和类比推理的局限；

实际应用步骤

明确目标 - 清晰定义要解决的问题；
深入拆解 - 识别问题的基本组成部分；
检验假设 - 质疑既有认知，消除偏见；
重新组合 - 用新视角重组基本要素；
持续迭代 - 不断优化方案；

实用性建议

培养好奇心，不轻易接受既有答案；
多问"为什么"，挖掘根本原因；
突破思维定式，允许创新观点；
关注基础规律，建立系统认知；

如何运用第一性原理

第一，以最本质最基础的无法改变的条件作为出发点。

如果不是从事物最基本的条件出发，那么拆分出的要素很可能发挥不了作用。同样是为了解决电动车锂电池组成本过高的问题，如果马斯克把作为出发点的基础条件放在供应商身上，试图说服供应商降价，不仅可能吃闭门羹，甚至可能让双方的关系紧张。更可行的思路是解决电池的原料问题，因为电池的原材料是相对固定的，这才是最基础的出发点。

第二，推演过程需要有严密的逻辑关系，尽量少引入估计。

之所以说运用第一性原理会消耗更高的认知能量，正是因为整个推演分析的过程必须保证合理可靠，否则就可能失之毫厘，谬以千里。整个过程就变成了做无用功。当然，这需要丰富的知识储备、生活经验和思维训练作为支撑。

第三，不可随意参照同类方案或现有经验，尊重客观推演结果。

要做好“找准出发点”和“保证逻辑关系”这两点，最重要的就是学会保持“空杯心态”，在推演分析时屏蔽现有的、已知的各种因素的干扰。没有了参照，有时可能会产生看似天马行空的想法。如果出发点和逻辑关系都没有问题，那么就应该尊重客观推演的结果，也许这就是一个蕴含着巨大价值的天才想法。

Elon Musk 如何使用第一性原理?

“我们运用第一性原理，而不是比较思维去思考问题是非常重要的。我们在生活中总是倾向于比较，对别人已经做过或者正在做的事情我们也都去做，这样发展的结果只能产生细小的迭代发展。第一性原理的思想方式是用物理学的角度看待世界，也就是说一层层拨开事物表象，看到里面的本质，再从本质一层层往上走。”这是他眼中的“第一性原理思维模型”——回溯事物的本质，重新思考怎么做。

Tesla and Electric Vehicles: Instead of improving traditional car manufacturing incrementally, Musk questioned why cars had to be built expensively. He looked at the fundamental costs of materials like steel and aluminum, realizing that if you start from a basic level, electric cars could be made more affordably than traditionally thought. This led to innovations in battery technology and vehicle design.
特斯拉和电动汽车：马斯克没有逐步改进传统汽车制造，而是质疑为什么汽车必须制造成本高昂。他研究了钢和铝等材料的基本成本，意识到如果你从基本层面开始，电动汽车的制造成本可能比传统认为的要便宜。这导致了电池技术和车辆设计的创新。
SpaceX and Reusable Rockets: The aerospace industry had long accepted that rockets were disposable. Musk questioned this paradigm, focusing on the physics of why rockets couldn't be reused. By breaking down the problem to its fundamentals, SpaceX developed reusable rocket technology, dramatically reducing the cost of space travel.
SpaceX 和可重复使用的火箭：航空航天业长期以来一直接受火箭是一次性的。马斯克对这种范式提出了质疑，他专注于火箭为什么不能重复使用的物理学。通过将问题分解到根本，SpaceX 开发了可重复使用的火箭技术，大大降低了太空旅行的成本。
Hyperloop: When considering high-speed transport, instead of improving existing rail systems, Musk proposed a new transport system based on first principles, leading to the concept of the Hyperloop, which aims to move passengers at airline speeds for a fraction of the cost.
超级高铁：在考虑高速运输时，马斯克没有改进现有的铁路系统，而是提出了一种基于第一性原理的新运输系统，从而产生了超级高铁的概念，该概念旨在以航空公司的速度运送乘客，而成本只是其中的一小部分。

Additional Insights:
其他见解：

Constant Learning: Musk emphasizes the need for continuous learning. Understanding the fundamentals in various fields (physics, engineering, economics) allows him to apply first principles across different industries.
不断学习：马斯克强调持续学习的必要性。了解各个领域（物理、工程、经济学）的基础知识使他能够将第一性原理应用于不同的行业。
Ignoring Popular Opinions: Often, first principles thinking leads to ideas that seem outlandish or at odds with industry norms. Musk's success with Tesla and SpaceX came from ignoring what was "impossible" according to prevailing views.
忽略流行观点：通常，第一性原理思维会导致看起来古怪或与行业规范不一致的想法。马斯克在特斯拉和 SpaceX 的成功来自于忽视了根据普遍观点“不可能”的事情。
Risk and Failure: This approach often involves high risk and can lead to failure, but Musk views these as learning opportunities. The focus is on moving forward from a place of deep understanding rather than fear of failure.
风险与失败：这种方法通常涉及高风险并可能导致失败，但马斯克将这些视为学习机会。重点是从深刻理解而不是害怕失败的地方向前迈进。
Vision Over Immediate Profit: First principles might not lead to immediate financial gains but are geared towards long-term revolutionary changes. Musk's ventures often prioritize impact and innovation over short-term profitability.
愿景胜于眼前利润：首要原则可能不会带来立竿见影的经济收益，但会带来长期的革命性变化。马斯克的企业通常优先考虑影响和创新，而不是短期盈利能力。
Collaboration: While first principles thinking can start as a solitary exercise, executing these ideas requires collaboration. Musk's companies attract talent who also think in fundamentals, fostering an environment where these ideas can thrive.
合作：虽然第一性原理思考可以从一项单独的练习开始，但执行这些想法需要协作。马斯克的公司吸引了同样从根本面思考的人才，营造了一个让这些想法能够蓬勃发展的环境。

In essence, Elon Musk's application of first principles thinking demonstrates a method of not just questioning the status quo but fundamentally reimagining how things can be done. It's a blend of curiosity, audacity, and rigorous logic that has allowed him to make significant strides in technology, transportation, and space exploration.

从本质上讲，埃隆·马斯克（Elon Musk）对第一性原理思维的应用展示了一种方法，该方法不仅质疑现状，而且从根本上重新构想如何做事。正是好奇心、大胆和严谨的逻辑的结合，使他在技术、运输和太空探索方面取得了重大进步。

如何应用第一性原理于日常生活？

让我用"如何吃得健康且经济"这个日常问题来演示第一性原理的分析过程：

1. 明确问题本质

核心需求：维持身体健康 + 控制支出；
剔除表象：不是追求特定食物或品牌；

2. 拆解基本要素

营养需求：

蛋白质：肌肉修复、免疫系统；
碳水化合物：能量来源；
脂肪：激素分泌、细胞构建；
维生素矿物质：身体机能调节；
膳食纤维：肠道健康；

成本构成：

原材料成本；
加工成本；
运输成本；
品牌溢价；
销售环节加价；

3. 重新思考解决方案

营养获取途径：

直接购买原料食材而非加工品；
选择当季本地食材减少运输成本；
批量购买和储存；
自主烹饪替代外出就餐；

具体执行方案：

以豆类、鸡蛋替代部分肉类蛋白；
购买散装而非包装食品；
学习基础烹饪技能；
规划膳食减少浪费；
选择农贸市场而非品牌超市；

4. 验证效果

记录营养摄入；
追踪支出变化；
观察身体状况；
持续优化调整；

这样的分析避免了常见误区：

盲目追求某些"健康食品"；
迷信高价等于高营养；
过度依赖加工食品；
忽视烹饪技能的重要性；

通过第一性原理，我们从本质需求出发，找到了更经济且有效的解决方案。这种思维方式可以应用于大多数日常问题的分析。

解决 Ghost 博客导入大文件的设置

nicejade — Wed, 16 Oct 2024 16:43:08 GMT

Ghost 博客，导入 json（4.6M），报错：Request is larger than the maximum file size the server allows 如何解决？

如何解决 Ghost 博客导入 JSON 文件时的文件大小限制问题

当您在 Ghost 博客导入大于服务器允许的最大文件大小的 JSON 文件时，出现错误提示“Request is larger than the maximum file size the server allows”，可以按照以下步骤进行解决：

检查 Ghost 配置：
在您的 Ghost 安装目录中，找到 config.production.json 文件，添加或修改以下配置项：
```
{
    "server": {
        "maxBodySize": "10mb"
    }
}
```
这将把最大请求体大小设置为 10MB（可以根据需要调整）。
重启 Ghost 服务：
修改配置文件后，需要重启 Ghost 服务以使更改生效。可以使用以下命令：
```
ghost restart
```
检查 Nginx 或 Apache 配置（如适用）：
如果您使用 Nginx 或 Apache 作为反向代理，确保在相应的配置中设置了文件大小限制。
- 对于 Nginx，在您的 server 块中添加或修改以下行：
```
client_max_body_size 10M;
```
- 对于 Apache，在您的虚拟主机配置中添加或修改以下行：
```
LimitRequestBody 10485760
```
重启 Web 服务器：
修改完成后，需要重启 Nginx 或 Apache 服务：
- Nginx：
```
sudo systemctl restart nginx
```
- Apache：
```
sudo systemctl restart apache2
```
尝试重新导入：
完成上述步骤后，再次尝试导入 JSON 文件。

通过这些步骤，您应该能够解决 Ghost 博客导入大文件时的大小限制问题。

client_max_body_size 10M; nginx 这个配置，请给写一个示例

Nginx 配置示例

以下是一个完整的 Nginx 配置示例，包含 client_max_body_size 10M; 设置。假设您正在为 Ghost 博客配置 Nginx，并且您的配置文件名为 ghost.conf。

server {
    listen 80;
    server_name yourdomain.com;  # 替换为您的域名

    # 设置最大请求体大小
    client_max_body_size 10M;

    location / {
        proxy_pass http://127.0.0.1:2368;  # Ghost 的默认端口
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }

    # 静态文件配置（可选）
    location ~ ^/(assets|favicon\.ico|robots\.txt) {
        access_log off;
        expires 1y;
        add_header Cache-Control "public, no-transform";
    }
}

配置说明

server_name: 替换为您自己的域名。
client_max_body_size 10M: 设置允许的最大请求体大小为 10MB。
proxy_pass: 代理请求到 Ghost 服务的地址和端口（通常为 2368）。
location 配置可以根据需要进行调整，以支持静态文件或其他特定路径的处理。

应用配置

将以上内容添加到您的 Nginx 配置文件中（如 /etc/nginx/sites-available/ghost.conf）。

创建符号链接到 sites-enabled（如果尚未链接）：

sudo ln -s /etc/nginx/sites-available/ghost.conf /etc/nginx/sites-enabled/

测试 Nginx 配置：
```
sudo nginx -t
```
重启 Nginx 服务以应用更改：
```
sudo systemctl restart nginx
```

完成后，您就可以尝试重新导入大于默认限制的 JSON 文件了。

2024 年 10 月 17 日写于〔深圳福田〕

BlueOS 应用开发，如何借助 ESlint 提升效率？

nicejade — Sat, 17 Aug 2024 07:39:59 GMT

ESLint 是一个用于识别和报告 JavaScript 代码中的模式和问题的工具，本文旨在介绍：BlueOS 应用开发，借助 eslint 提前发现代码可能存在的问题，从而提升效率。它被广泛用于：

代码质量：检测代码中的语法错误和潜在问题。
一致性：确保代码风格一致，方便团队协作。
最佳实践：帮助开发者遵循 JavaScript 的最佳实践。
可定制性：通过插件和配置文件自定义规则。

安装依赖

pnpm i eslint@7.32.0 eslint-plugin-json eslint-plugin-vue -D

配置 ESLint

在项目根目录新建 .eslintrc 文件，其中包含 ESLint 的配置。你可以根据需要修改它：

{
  "env": {
    "commonjs": true,
    "node": true,
    "es6": true
  },
  "plugins": ["json"],
  "extends": ["eslint:recommended", "plugin:vue/base"],
  "globals": {
    "requireModule": false,
    "requireM": false,
    "console": true,
    "setTimeout": false,
    "clearTimeout": false,
    "setInterval": false,
    "clearInterval": false
  },
  "rules": {
    "vue/html-end-tags": "warn",
    "vue/html-quotes": "warn",
    "vue/comment-directive": "off",
    "no-unused-vars": [
      "warn",
      {
        "varsIgnorePattern": "prompt",
        "args": "after-used"
      }
    ],
    "quotes": [
      "warn",
      "single",
      {
        "avoidEscape": true,
        "allowTemplateLiterals": true
      }
    ],
    "no-console": "error",
    "semi": [1, "never"]
  }
}

设置忽视

.eslintignore 文件用于指定 ESLint 在运行时应忽略的文件和目录。其作用包括：

排除特定文件：防止 ESLint 检查不需要 lint 的文件，如打包后的文件、第三方库等。
提高性能：通过忽略不相关的文件，可以加快 lint 的速度。
简化配置：保持 .eslintrc 配置文件的简洁，将忽略规则放在 .eslintignore 中。

在项目根目录下创建 .eslintignore 文件，并添加需要忽略的路径：

node_modules/ 
dist/ 
build/ 
*.min.js

配置命令

在 package.json 中增加 lint 命令，从而快速运行 ESLint。

"scripts": {
  "lint": "eslint --ext .ux,.js src/"
}

运行命令

使用以下命令检查项目中的 JavaScript、ux 等文件：

npm run lint

自动修复问题

ESLint 可以自动修复一些简单的问题。使用 --fix 选项：

npx eslint . --fix

集成到开发环境

编辑器集成：大多数现代编辑器（如 BlueOS Studio、VSCode）都支持 ESLint 插件，可以实时显示和修复问题。
CI/CD 集成：在持续集成中运行 ESLint，确保代码提交符合标准。

注意事项

截止 2024 年 08 月 17 日， ESLint 已更新至 9.9.0，它部分功能用法没有向前兼容；上面提及的使用方式适用于 7.32.0版本；如果使用最新版本，需要自行研究下，望知悉。

通过 ESLint，你可以有效地提高代码质量，保持代码的一致性和可维护性。如果您不习惯使用 ESLint，可以考虑使用 Prettier 来美化代码，它也能帮助发现部分代码问题，详情可参见代码美化 | BlueOS Studio ；如果您愿意，也可以将二者结合起来使用。

2024 年 08 月 17 日写于〔深圳福田〕

BlueOS （中文名“蓝河操作系统”）是 vivo 自主研发的一款面向通用人工智能时代的智慧操作系统。它以智慧特性、性能优化、安全性、系统架构、AI 服务引擎、兼容性、流畅体验、开放智联等为核心特点，代表了 vivo 在操作系统领域的创新能力和研发实力。BlueOS 的目标是为用户提供一个更加智能、流畅且安全的使用体验。 BlueOS 支持快应用标准，推荐使用 BlueOS Studio 进行应用开发。

BlueOS Studio 是针对蓝河操作系统（BlueOS）应用开发的官方集成开发环境（IDE），它基于强大的代码编辑器 Visual Studio Code 构建，因此具备 VS Code 的全部功能，包括代码编辑、插件集成、主题定制及个性化设置等。除了继承 VS Code 的特性外，BlueOS Studio 专为 BlueOS 应用开发引入了一系列增强功能，比如智能编码补全、实时编译预览、全方位应用调试以及 UI 自动化测试等。

为了支持蓝河应用的开发，BlueOS Studio 还提供了项目管理的便捷性，如推荐的项目结构指引、依赖管理工具以及代码构建系统 BlueOS Toolkit，该工具可将源代码打包为 .rpk 格式的应用程序文件。此外，BlueOS Studio 也整合了 DevTools 模拟调试工具，类似于 Chrome DevTools，提供了丰富的调试面板以助于代码调试和性能优化。

在蓝河应用开发上， BlueOS Studio 适用于开发包括手机、手表、Pad 在内的多种应用形态，并为开发者提供丰富的开发、调试、测试和打包工具，以及项目开发的指导和文档支持，以确保开发者可以高效且方便地进行蓝河应用的开发工作。发布完成后的应用则可以供蓝河操作系统的用户使用。

您可能感兴趣的文章

生财有迹 | 您专属的资产跟踪与分析工具

nicejade — Thu, 18 Jul 2024 15:56:48 GMT

生财有迹（Wealth Tracker）是一款专注于个人资产分析的应用程序。其核心功能是：全面记录并展示用户的资产状况，帮助用户清晰地了解财务现状；结合每种资产的特性和当前经济环境，利用 AI 技术进行分析，并提供适宜的财务建议。

项目愿景

在当今多元化的经济环境中，个人资产管理变得日益重要。它往往分散于各类金融账户和服务中，例如银行存款与理财产品、移动支付平台（如微信支付、支付宝）、公积金、医保账户、货币基金（例如余额宝）、债券、各种股票及基金产品、房地产、贵金属、外部借款（尽量不做此配置🤫）以及其他投资等等（对于部分朋友，或许还有贷款、欠款等负债）。这些账户中的数额在不断变动，使得快速准确地了解个人总资产状况成为一项挑战。

本项目旨在提供一个高效、直观的解决方案，以应对个人资产管理中的分散性和复杂性。生财有迹专注于账户余额及整体数额，避免深陷于单笔收支的琐碎细节。其目标是通过简化操作流程，帮助用户揭示个人资产的整体变化趋势，并通过友好的用户界面，使用户能够轻松记录和洞悉自己的财务信息。如欲了解更多，可移步至博文：生财有迹 | 您专属的资产跟踪与分析工具。

核心特性

简洁易用的操作界面：用户可以通过几个简单的步骤快速上手，无需任何复杂的财务知识。
丰富的数据可视化：通过图表和图形，直观展示资产变化，帮助用户轻松掌握财务状况。
本地部署的灵活性：部署在哪里由用户决定，确保数据的私密性、安全性，以及可扩展性。
开源的代码架构：项目的源代码完全开放，欢迎参与贡献，以不断改进和完善工具的功能。

通过这些特性，希望建立一个用户友好、透明且可信赖的个人财分析工具，帮助用户更全面地掌握自己的财务状况。

在线体验

为了让您更直观地了解生财有迹的功能和特性，已在服务器上使用 pm2 部署了一个演示版本。该演示环境填充了模拟数据，方便您全面体验各项功能。无论您是想评估工具的实用性，还是出于好奇想一探究竟，欢迎访问以下链接进行体验：

https://fund.lovejade.cn/

请注意，这是一个公共演示环境，因此请勿在其中输入任何真实的个人财务信息。建议您在体验后，考虑按照本文档的指导，在自己的环境中部署和使用"生财有迹"，以确保您的财务数据的隐私和安全。

如果您在使用过程中遇到任何问题或有反馈意见，欢迎通过项目的 GitHub 页面与我们联系。您的宝贵意见将帮助我们不断改进这一工具，以更好地满足用户的需求。

如何使用？

使用 Docker

使用 docker compose：

version: '3.8'

services:
  wealth-tracker:
    image: nicejade/wealth-tracker
    container_name: wealth-tracker
    ports:
      - '8888:8888'
    volumes:
      - ./data:/app/data
    restart: unless-stopped

volumes:
  data:

这将在后台启动服务，并且效果与下面的 docker run 命令相同。使用 Docker Compose 可以更方便地管理多个容器，并且配置更易读和维护。

或者 docker run：

docker run -d -p 8888:8888 -v "$(pwd)/data:/app/data" nicejade/wealth-tracker

如果您在本地部署，只需打开网址——http://localhost:8888 即可访问。如果在服务器运行，可通过 http://[Server-IP]:8888 来访问，您也可以指定其他端口。

采用 pm2 部署

PM2 是一个强大的生产环境进程管理器，它不仅支持通过命令行启动应用，还可以使用配置文件（通常名为 ecosystem.config.js）来管理复杂的部署场景。为了简化部署流程并确保一致性，本项目已将所有必要的 PM2 配置和启动命令封装到了 npm 脚本中：

# clone project
git clone https://github.com/nicejade/wealth-tracker.git

cd wealth-tracker

# globally install pm2 pnpm & lerna
npm i pm2 pnpm lerna  -g

# install dependencies(client & server)
pnpm i

# start your service
npm run build
npm run start

项目除了提供 start 命令外，还包含其他与 pm2 相关的命令：

npm run start: 使用 PM2 启动应用；
npm run stop: 停止 PM2 管理的应用；
npm run restart: 重启应用；
npm run logs: 查看应用日志；

如何开发？

说明用户在安装和使用前，需要准备的一些先决条件，譬如：您需要安装或升级 Node.js（>= 16.*），推荐使用 Pnpm 或 Yarn 作为首选包管理工具。本项目采用 pnpm（利用其 workspace 功能）结合 Lerna@8.1 来管理项目依赖，以实现更高效的包管理和工作流程。为确保您的开发环境与项目要求一致，建议您全局安装这两个工具：

# clone project
git clone https://github.com/nicejade/wealth-tracker.git

cd wealth-tracker

# globally install pm2 pnpm & lerna
npm i pm2 pnpm lerna  -g

# install dependencies(client & server)
pnpm i

# install & run for client
cd client && pnpm start

# install & run for srever
cd server && pnpm start

本项目客户端采用 Svelte 框架，基于 Vite 所构建，默认 5173 端口，只需打开网址—— http://localhost:5173 即可访问。

命名由来

在项目开发初期，有为应用取中文名为："财富追踪器"（英文名：Wealth Tracker）。这个名称初看简洁明了，似乎完美契合产品理念。然而，随着开发深入，逐渐显现出其局限性：

概念范畴过广："财富"一词涵盖范围极广，不仅包括金钱资产，还可能指代时间、知识、经历，甚至是绝美容颜等无形价值。
功能定位不够精准：该应用实际上专注于能被精确计算和记录、且已经形成的有形资产，而非泛泛追踪所有形式的"财富"。

这种认知更新促使重新思考产品定位和命名。偶然想到了两个颇具启发性的成语："生财有道"和"生财有术"；而应用的核心功能恰恰是记录资产增长的轨迹。基于这一灵感，最终确定将应用命名为"生财有迹"。这个名字巧妙地结合了几个要素：

"迹"与"记"同音，暗示了记录的功能。
"生"与"升"同音，象征着资产的增长。
整体保留了"生财"的概念，与原有的资产主题保持一致。

"生财有迹"这个新名称不仅准确反映出产品功能定位，传达了产品理念，还蕴含了对用户资产增长的美好祝愿，希望您也会喜欢。

给予支持

生财有迹项目开源且免费，然而设计与编码需耗费时间和精力。如若您对其使用感到满意，请考虑通过以下方式进行小额捐赠：

微信扫码赞助

路线图

"生财有迹"项目正处于积极的设计和研发阶段，致力于在功能丰富与易用性之间寻求平衡，以满足用户日益增长的个人财务管理需求。未来开发重点包括增强数据可视化能力、加强数据安全性、以及提升 AI 辅助分析功能等。

[x] 更新资产数据记录；
[x] 资产数据分布可视化；
[x] 账户变化趋势可视化；
[x] 资产变化趋势可视化；
[x] 查阅数据记录详情；
[x] 修改或销毁记录；
[x] 内置多语言支持；
[x] 借助 AI 辅助分析；
[x] 支持多种主流货币；
[ ] 设置阶段性目标；
[ ] 资产数据安全性；

常见问题

为何开启这个项目？

知人者智，自知者明：清晰了解自身的资产状况，才能更好地规划未来。面对日益复杂、多元化的资产管理需求，提供一个高效的解决方案尤为关键。本项目旨在为用户提供全面的支持，帮助他们实现更精准的财务规划和明智决策，从而有效促进个人财富的持续增长。

跟记账应用有何区别？

传统记账应用主要关注日常收支明细，适合学生等收入有限人群；而「生财有迹」专注于已形成的资产存量，帮助用户了解"现在拥有什么"（现状与未来），而非过往的支出记录（历史）。这种设计更符合在职人士的理财需求，让用户把精力集中在资产的整体规划和增长上。

如何获取汇率 API KEY？

为了获取实时汇率数据，本项目接入了 ExchangeRate-API 服务。您可以：

访问 ExchangeRate-API 官网注册免费账号；
获取 API KEY 并在服务的「设置」中填写；

ExchangeRate-API 支持免费使用，其版特点是：

汇率数据每日更新一次；
每月可调用 1500 次 API；
支持主流货币转换；

注：若未设置 API KEY，系统将使用 2025 年 2 月 15 日的默认汇率数据。

未来有哪些规划？

生财有迹不仅仅是一个资产追踪工具，更期望成为用户的智能财富助手。未来的发展规划主要包括：

知识沉淀：支持用户记录个人的理财心得、投资感悟，形成专属的财富知识库；
AI 赋能：
- 结合 RAG (检索增强生成) 技术，让 AI 基于用户的历史记录和知识提供更精准的建议；
- 引入智能 Agent 及信息过滤体系，为用户提供更匹配的个性化财务规划和投资建议；
- 持续更新，使得用户可以选择合适的大语言模型，提升 AI 助手的能力；
安全与隐私：确保用户数据的绝对安全性，打造一个自由且私密的财富管理环境；
持续进化：根据用户反馈不断优化功能，让系统随着用户的使用逐步成长，提供越来越智能的服务；

如何快速安装依赖？

推荐使用 pnpm 来安装依赖，执行命令 pnpm i。如遇到网络问题，可使用国内镜像加速（如阿里云 npmmirror 镜像站），以确保快速顺利完成安装，具体命令如下：

pnpm i --registry=https://registry.npmmirror.com

为何采用 SQLite3 存储数据？

SQLite3 是一款轻量级数据库，无需额外配置，简单易用且高效。由于本项目不需要存储大量数据，SQLite3 非常适合。此外，它支持快速的数据同步和迁移，能够满足项目的灵活性和性能需求。

特别鸣谢

本项目的开发过程中，依赖并受益于以下优秀的开源技术和工具（未包含全部）。它们不仅提供了强大的功能，还促进了项目的高效开发和稳定运行。

Svelte: 作为一种新兴的前端框架，Svelte 通过其创新的编译时技术，让我们的 Web 应用更加轻量和高效。它减少了我们需要编写的样板代码，同时提高了运行时的性能。
TailwindCSS: 通过提供实用主义的 CSS 类，TailwindCSS 极大地简化了样式设计的过程。它使得我们能够快速构建美观且响应式的用户界面，同时保持代码的清晰和维护性。
Vite: 作为一个现代化的前端构建工具，Vite 通过其快速的冷启动和即时的模块热更新，极大地提高了我们的开发效率。它利用了原生 ES 模块特性，使得项目构建更加高效。
Flowbite: 提供了一系列预构建的组件和模板，Flowbite 极大地加快了我们的开发流程。它帮助我们快速实现了复杂的用户界面元素，同时保持了代码的可定制性和可维护性。
Axios: 作为一个基于 Promise 的 HTTP 客户端，Axios 简化了我们的 Web 应用中与 API 的交互。它的易用性和广泛的功能集使得我们能够轻松处理 HTTP 请求和响应。
Day.js: 作为一个轻量级的 JavaScript 日期库，Day.js 提供了直观的 API 来处理日期和时间。它使得我们在应用中处理复杂的日期计算变得简单且可靠。
Node.js: 作为一个高效的 JavaScript 运行环境，Node.js 使得服务器端开发变得前所未有的简单和快速。它的事件驱动和非阻塞 I/O 模型极大地提高了我们的应用性能和响应速度。
Fastify: 这个高性能的 Node.js Web 框架为我们提供了一个简单且强大的接口来构建 RESTful API。它的低开销和高度可扩展性使得我们的后端服务既快速又稳定。
SQLite3: 作为一个轻量级的数据库引擎，SQLite3 为我们提供了一个无需配置的本地存储解决方案。它的简单性和高效性使得开发者在本地部署应用时能够轻松管理数据。
Sequelize: 作为一个强大的 ORM 框架，Sequelize 为我们提供了一种简单且直观的方式来管理数据库关系。它的灵活性和功能丰富性使得我们能够轻松实现复杂的数据操作和查询。

在此，对上述技术和工具的开发者和社区，致以崇高的敬意和衷心的感谢❤️。正是得益于他们的卓越贡献，生财有迹才能得以成功构建并持续优化。同时，也要感谢如 Codeium Windsurf、Cursor、ChatGPT、Github Copilot、Poe、Kimi 等 AI 工具在开发过程中提供的宝贵支持，它们显著提高了工作效率和体验。

BlueOS 应用开发，如何使用全局变量？

nicejade — Mon, 01 Jul 2024 09:32:26 GMT

全局变量在不同的应用环境中有着重要的作用，它们提供了一种在整个应用程序中共享数据和状态的机制。本文旨在探讨：BlueOS 应用开发，有哪些使用全局变量的方式，及优缺点。

公共对象 `$app`

$app 是一个全局对象（应用对象），用于获取当前应用的信息和状态。它的作用主要包括以下几个方面：

获取应用实例：使用 $app 可以获取当前应用的实例对象，通过这个实例对象可以访问应用的各种属性和方法。
应用信息： $app 对象包含了一些关于当前应用的基本信息，如应用的名称、版本号、包名等。
事件处理： $app 可以用来注册和处理应用级别的事件，例如应用的启动事件、退出事件（$app.exit()）等。
全局变量和状态管理：在 $app 对象中可以定义和管理一些全局变量，这些变量可以在整个应用中共享和使用。
应用生命周期管理： $app 对象允许开发者监听和响应应用的生命周期事件，如应用启动、前台进入、后台切换等。

具体来说，如果需要在快应用中获取应用的全局信息、管理应用的状态或监听应用的生命周期事件，可以通过 $app 对象来实现。这使得开发者可以更方便地操作和管理整个应用的行为和状态。具体使用示例如下：

在 app.ux 导出 sleep 方法：

// app.ux

在 BlueOS 页面或组件生命周期内容，通过 $app 调用全局 sleep 方法：

您也可以通过 $app.$def 对象来调用暴露至全局的 sleep 函数，对比来看，无论从编写效率、运行性能等角度，显然都没有必要；但通过上述示例会发现，$app 无法直接获取函数以外的对象，$app.$def 可以获取。BlueOS 对于这一设计，颇感奇怪。

基于 $app 来使用全局变量优缺点：

优点：暴露、使用全局变量，比较简单，无需其他额外处理；
缺点：$app 和 $app.$def 这个功能设计，令人颇感意外；为何不将暴露至全局的所有内容，都挂载在 $app 之下（同名覆盖），舍弃 $app.$def 这一层。

全局对象 `global`

BlueOS 提供全局对象 global，它类似浏览器环境中的 window 对象，或者 Node.js 环境中 global 对象。它的使用非常简单，直接挂载即可使用，如：

import prompt from '@blueos.window.prompt'
global.router = router

在页面或组件中，您可以通过 global.router 或 router 来调用 BlueOS 路由相关 API：

global.router.back()
# OR
router.back()

注意事项

BlueOS Studio 内置应用模版，增加了 tsconfig.json 配置，以启用或禁用各种类型检查和语法检查，帮助开发者提早发现潜在的类型错误和代码质量问题；推荐使用。

{
  "compilerOptions": {
    "noImplicitAny": false,
    "strict": true,
    "noUnusedLocals": true,
    "noImplicitThis": true,
    "noUnusedParameters": true,
    "allowSyntheticDefaultImports": true,
    "forceConsistentCasingInFileNames": true,
    "esModuleInterop": true,
    "resolveJsonModule": true,
    "skipLibCheck": true,
    "checkJs": true,
    "lib": ["ES2022"],
    "outDir": "./build"
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

这份配置导致一个副作用，当直接调用全局变量（global 或 router），因为没有对应声明，虽然不影响编译运行，但编辑器则会报警告提示；您可以在 src 目录新建声明文件（如：app.d.ts），填充必要声明，以解决 Studio 警告提示，示例如下：

/// 
type Router = typeof import('@blueos.app.appmanager.router');
type Prompt = typeof import('@blueos.window.prompt');

declare const global: {
  router: Router;
  prompt: Prompt;
}

declare const router: Router

declare const Promise: typeof Promise

基于 global 来使用全局变量优缺点：

优点：相比 $app 这种方案，暴露与使用全局变量都更加简单；
缺点：项目如果配备了 tsconfig.json ，则额外需要声明，以消除警告提醒；

本文详细探讨了在 BlueOS 应用开发中使用全局变量的两种主要途径：通过 $app 对象和 global 对象。每种方法都有其独特的优势和局限性。对于简单的全局数据共享，$app 提供了一种直接且便捷的方式。然而，由于 BlueOS 的设计限制，某些情况下需要通过 $app.$def 才能访问到特定的全局变量。而使用 global 对象则提供了更接近传统 Web 开发的体验，但对于配置了 tsconfig.json 项目，需要额外的类型声明。

无论选择哪种方法，理解和合理运用全局变量可以有效提升应用的开发效率和代码管理水平。希望本文的介绍能为您在 BlueOS 开发中提供实用的参考和帮助。

您可能感兴趣的文章

BlueOS 应用开发，如何使用 npm 第三方工具库？

nicejade — Mon, 01 Jul 2024 05:44:09 GMT

在 BlueOS 应用开发中，使用 npm 第三方工具库是一种常见且有效的方式，可以帮助开发者快速引入各类功能模块和工具，从而加速应用开发进程并提升用户体验。通过 npm，开发者能够轻松地安装、管理和更新依赖包，无需重复造轮子，直接利用社区优秀的解决方案。本文将详细探讨如何在 BlueOS 应用中利用 npm 第三方工具库，以及如何正确配置和集成这些工具，从而实现更高效、更强大的应用功能。

npm 及平台简介

npm （Node Package Manager）是 Node.js 生态系统中的包管理工具，用于下载、安装和管理 JavaScript 包和模块。npm 上托管了数以百万计的开源包，涵盖了各种功能和工具，可以极大地提升开发效率和代码质量。每个 npm 包都包含了 JavaScript 代码、依赖关系信息、文档和其他必要的资源，开发者可以通过 npm 轻松地将这些包集成到自己的项目中。

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时环境，它包含了 npm（Node Package Manager），作为其默认的包管理工具之一。因此，当你安装 Node.js 后，npm 命令也会随之安装并可在命令行中使用。

BlueOS 为何能使用 npm 包？

BlueOS，是 vivo 自主研发的一款面向通用人工智能时代的智慧操作系统；其应用层开发，采用了类似于 Web 的技术栈（HTML、CSS、JavaScript），并且支持使用 npm 包。这种支持主要基于以下几点原因：

基于前端技术栈：BlueOS 应用的开发基础是 HTML、CSS 和 JavaScript，类似于传统的 Web 开发，因此可以直接利用 npm 上众多的 JavaScript 包和工具来扩展其功能。
构建工具支持：BlueOS 编译工具基于 Vite（旧版基于 Webpack）开发的代码编译工具。BlueOS 编译工具能自动编译项目中的代码和依赖关系，能将蓝河应用源码和应用依赖的 npm 包编译打包到最终的 BlueOS 应用项目中。BlueOS 构建工具本身也可通过 npm 安装到本地，可通过命令行调用。
开发者生态兼容性：为了提高开发者的生产力和项目的可维护性，BlueOS 应用支持使用 npm 包，使得开发者可以直接使用他们熟悉且信任的第三方库，而无需另行适配或重写功能。
生态系统互通性：npm 生态系统中的许多包已经经过广泛测试和优化，可以为 BlueOS 应用开发提供成熟和可靠的解决方案，从而加速应用程序的开发和部署过程。

总之，BlueOS 应用之所以能够使用 npm 包，主要是为了借助 npm 生态系统丰富的资源，帮助开发者快速构建高质量的应用，同时提升整体的开发效率和体验。

BlueOS 如何使用 npm 包？

在 BlueOS 应用开发中，使用 npm 第三方工具库需要遵循以下步骤：

安装 npm 包

使用命令行工具，在你的 BlueOS 应用项目目录下运行 npm install 包名 来安装需要的第三方工具库。例如：

npm install lodash
# Or use pnpm
pnpm install lodash

这将会在你的项目中安装 lodash 这个 npm 包。

引入和使用

在你的代码中引入安装的 npm 包，可以使用 ES6 的 import 语法来导入模块。例如：

import { map, tail, times, uniq } from 'lodash';

注意事项

兼容性：确保所使用的 npm 包在 BlueOS 应用环境中能够正常工作，避免使用依赖于浏览器环境（如使用 window、document）、Node.js 环境或其他编码语言（如 python）等特有的功能的包。
引入方式：在新版 BlueOS Studio，必须使用 ES Module 语法编写 JavaScript，并在根目录的 package.json 中设置 "type": "module"。不支持 CommonJs 语法（导入包，请基于 import 而不要使用 require）。
体积优化：考虑到 BlueOS 应用的体积限制，尽量选择体积较小的 npm 包，并且按需引入，避免不必要的代码依赖。

总结来说，BlueOS 应用开发中使用 npm 第三方工具库与普通的 Node.js 项目类似，但需特别关注 BlueOS 应用环境的限制和需求，确保所使用的库能够在 BlueOS 应用中正常工作和优化体积。

您可能感兴趣的文章

BlueOS 应用开发，如何使用 Zustand 进行状态管理？

nicejade — Thu, 27 Jun 2024 09:30:24 GMT

BlueOS （中文名“蓝河操作系统”）是 vivo 自主研发的一款面向通用人工智能时代的智慧操作系统。其目标是为用户提供一个更加智能、流畅且安全的使用体验。状态管理是组件间通信、数据流向、以及数据的持久化这些方面的核心；因此，它在应用扮演着重要角色；本教程将探讨如何使用 Zustand —— 一种轻量级状态管理库 —— 来简化 BlueOS 应用中的状态管理。

什么是 Zustand？

Zustand 介绍

Zustand 是一个轻量级且简单的状态管理库，用于在 React 应用中管理状态。与 Redux 或 MobX 等更复杂的状态管理解决方案相比，Zustand 提供了一个更为简洁和直观的 API，减少了模板代码并且易于上手。

Zustand 理念

Zustand 的核心理念是创建一个存储全局状态的 store，不同组件可以直接订阅该 store 中的部分状态，并在状态变化时得到通知，进而引发组件的重新渲染。Zustand 并不强制使用 Redux 那样的 actions 和 reducers 模式，而是允许你直接在 store 中修改状态。

Zustand 特点

简单易用: API 简单清晰，不需要配置多个文件或遵循复杂的约定。
钩子友好: 使用钩子 (useStore) 来访问状态，在组件之间共享状态时非常直观高效。
不可变更新: Zustand 内部使用浅比较来检查状态的变更，确保性能优化。
无需提供者: 不需要像 Context API 那样在应用的最顶层包裹 Provider。
中间件支持: 支持添加中间件来增强 store，例如添加持久化、记录日志等功能。
TypeScript 支持: Zustand 是用 TypeScript 编写的，可以提供良好的类型支持。

如何使用 Zustand？

安装 Zustand

pnpm add zustand  # 或者 yarn add zustand 或者 npm install zustand

以下是 Zustand 的一个简单示例，展示了如何创建一个 store 以及如何在页面中使用该 store 的状态：

创建一个 Zustand Store

// src/stores/counter.js
import { createStore } from 'zustand/vanilla'

export const useCounter = createStore((set) => ({
	count: 0,
	increment: () => set((state) => ({ count: state.count + 1 })),
	decrement: () => set((state) => ({ count: state.count - 1 })),
}))

绑定到页面或组件

在这个例子中，createStore 函数用于初始化 store，传递给它的回调函数包含初始状态和改变状态的动作。页面中使用 useCounter 钩子来访问需要的状态片段，并可以调用定义好的方法来更新状态。

订阅状态变化来更新界面

上述例子只是为方便如何介绍使用 Zustand，在真实应用开发中，只需通过手动更新成员变量的值即可。将操作 counter 这段逻辑提取到一个组件，通过 Zustand 而不依赖 props 即可完成跨组件共享数据状态，如下代码示例：

由此可见，在 BlueOS 集成 Zustand 非常简单，只需页面或组件的 onShow 或 onInit 的生命周期钩子中引入 store，并订阅状态变更。不过随着页面跳转，原有状态不会得到保存；解决之道也简单，初始化、更新数据状态时，与全局变量关联起来即可：

import { createStore } from 'zustand/vanilla'

export const useCounter = createStore((set) => ({
	count: global.count || 0,
	increment: () =>
		set((state) => {
			global.count = state.count + 1
			return { count: state.count + 1 }
		}),
	decrement: () =>
		set((state) => {
			global.count = state.count - 1
			return { count: state.count - 1 }
		}),
}))

如果想数据持久化存储，即便应用重启，也不影响数据状态，将全局变量替换为 storage（数据存储）即可：

import { createStore } from 'zustand/vanilla'
import storage from '@blueos.storage.storage'

const updateStorage = (key, value) => {
	storage.set({
		key,
		value,
	})
}

export const COUNTER_KEY = 'COUNT'

export const useCounter = createStore((set) => ({
	// count: storage.getSync({ key: 'COUNT' }) || 0,
	count: 0,
	increment: () =>
		set((state) => {
			updateStorage(COUNTER_KEY, state.count + 1)
			return { count: state.count + 1 }
		}),
	decrement: () =>
		set((state) => {
			updateStorage(COUNTER_KEY, state.count - 1)
			return { count: state.count - 1 }
		}),
}))

需要指出的是，BlueOS Toolkit 在编译过程中会实施页面预渲染。这一步骤包括提取 data 中的初始数据，并基于这些数据把 style 预应用到模板（template）上，从而缩短页面加载的首屏时间。

在此过程中，代码会在 Node.js 环境下执行，而此刻 BlueOS Feature API（例如 storage.getSync）并不可用。因此，若代码尝试调用这些 API，编译将无法成功完成。此情况与前端框架如 SSG（静态站点生成器）和 SSR（服务器端渲染）在类似阶段遇到的错误消息一脉相承：

ReferenceError: window is not defined

可选解决方案 ── 在 BlueOS 生命周期 onInit 或 onShow 回调内，获取 storage 数据，更新状态，以弥补编译预渲染限制，参考代码如下：

理解 Zustand 提供的 API

Zustand 提供了一个易于理解和使用的 API，主要包括以下几个核心方法和概念：

create

这是 Zustand 的主要入口点。create 函数用于创建一个新的 store。你需要提供一个设置函数(setter)和状态配置（通常是一个箭头函数），这个设置函数包含三个参数：set、get 和 api。

import create from 'zustand'

const useStore = create((set, get, api) => ({
	// 初始化状态
	count: 0,

	// 定义改变状态的动作
	increment: () => set((state) => ({ count: state.count + 1 })),
	decrement: () => set((state) => ({ count: state.count - 1 })),
	// 其他业务逻辑...
	updateCount: (newCount) => set({ count: newCount }),
	resetCount: () => set({ count: 0 }),
}))

set

set 函数用于更新 store 中的状态。它可以接受一个新的状态对象或者一个接受旧状态并返回新状态的更新器函数。这个函数通常在 store 的 action 中被调用来更新状态。

set({ count: 1 }) // 设置 `count` 状态为 1
set((state) => ({ count: state.count + 1 })) // 将 `count` 状态增加 1

get

get 函数允许你获取 store 的当前状态。它通常在 action 中使用，当你需要访问当前状态来决定如何更新它时。

const count = get().count // 获取当前的 `count` 状态

api

api 参数提供了对 store 的控制方法，例如，你可以通过它访问到 dispatch 或 store 的内部状态。

useStore (钩子)

当你创建了一个 store 之后，Zustand 会为你返回一个用于订阅状态变化的钩子，这可以用来从组件中访问状态。

const count = useStore((state) => state.count)

getState

getState 是一个方法，返回 store 的当前状态。这在需要直接访问 store 状态时非常有用，尤其是在非 React 环境中。

setState

setState 是一个方法，用于更新 store 的状态。它接受一个函数，该函数接收当前状态作为参数，并返回新的状态。

subscribe 方法允许你监听状态的改变。你可以指定一个监听器函数，当状态发生改变时，这个监听器就会被调用。

const unsubscribe = store.subscribe(console.log)
// 稍后，如果您想取消订阅 store 更新
unsubscribe()

destroy

如果需要的话，你可以调用 destroy 方法来清理 store。这在测试或其他需要完全重置状态的场景中特别有用。

createStore

通过 createStore API，使用 Zustand 在非 React 环境中管理状态。createStore 允许你创建一个不依赖于 React 的 store。这个 store 可以在任何 JavaScript 环境中使用，包括服务端渲染、测试或其他框架。它不仅在 BlueOS 应用能够正常工作，而且相比 create，体积能从原来的 80KB+ 缩减至 3KB。强烈建议您使用 createStore API：

import { createStore } from 'zustand/vanilla'

const useStore = createStore((set) => ...)
// const { getState, setState, subscribe, getInitialState, destroy } = useStore;
export default useStore

高级用法和最佳实践

拆分状态管理

应用变得复杂时，拆分和组合 state 是非常重要的。通过创建多个 store 和将它们组合起来，可以更好地管理和维护状态。

性能优化

Zustand 允许使用选择器（subscribeWithSelector）和部分订阅来避免不必要的渲染。对于性能至关重要的快应用，这样的特性尤为有用。

结语：为何推崇 Zustand

Zustand 是针对现代 JavaScript 应用程序的一个轻量级状态管理解决方案，它展现出了显著的优势。用户可以享受到一个既简洁又充满弹性的方式来统一管理应用状态。

在众多的状态管理方案中，例如 RxJS、Vuex、Pinia、Redux 和 MobX，Zustand 的设计宗旨是缩减繁冗的 API 和减少模板代码的使用。这一点体现在它如何允许开发者创建一个全局状态库，并在应用的任何位置流畅地访问与修改状态，这一点无需借助 Redux 那样复杂的 action 创建器和 reducers 结构。

随着对 Zustand 深入了解，你将会明白它如何在项目中发挥极致效率。虽然 Vuex、RxJS 或自定义的发布-订阅模式同样可以胜任 BlueOS 应用的状态管理工作，但如果您追求一种更轻量级、简便明了的状态管理方式，Zustand 无疑是一把锋利的工具，值得您优先考虑。

您可能感兴趣的文章

BlueOS 应用开发，如何通过 Tailwind CSS 适配多屏幕？

nicejade — Mon, 24 Jun 2024 09:30:01 GMT

BlueOS 提供了对媒体查询的支持，使得开发者能够轻松实现多屏幕适配。同样，Tailwind CSS ── 这个以实用性为核心的 CSS 框架，也是借助媒体查询来定制不同屏幕尺寸下的用户界面。本文旨在探讨 BlueOS CSS 与标准 CSS 在处理媒体查询方面的异同，并指导如何通过调整 Tailwind CSS 的配置来实现对 BlueOS 的兼容。这样不仅能够进一步提高开发效率，还能为最终用户带来更加流畅和适应各种屏幕需求的界面体验。

媒体查询（Media Query）非常实用，应用十分广泛；开发者经常需要根据设备的大致类型或者特定的特征和设备参数（例如屏幕分辨率）来修改应用的样式。为此媒体查询提供了如下功能：

针对设备和应用的属性信息，可以设计出相匹配的布局样式。
当屏幕发生动态改变时（比如分屏、横竖屏切换），应用页面布局同步更新。

BlueOS CSS 语法规则

使用 @media 来引入查询语句，具体规则如下：

@media [media-type] [and|not|only] [(media-feature)] {
  CSS-Code;
}

使用示例：

/* 表示：宽度小于 30dp 时生效 */
@media (max-width: 30) {  .box {
    background-color: red;
  }
}
/* 表示：宽度小于30dp时生效 */
@media (width <= 30) {  .box {
    background-color: red;
  }
}

/* 表示：宽度大于 400dp 且小于 700dp 时生效 */
@media screen and (min-width: 400) and (max-width: 700) {  
  .box {
    background-color: red;
  }
}
/* 表示：宽度大于 400dp 且小于 700dp 时生效  */
@media (400 <= width <= 700) {  
  .box {
    background-color: red;
  }
}

/* 多条件写法，表示：方表和手机上生效 */
@media screen and (device: watch-square) or screen and (device: phone) {  .box {
    background-color: red;
  }
}

注意📢：BlueOS CSS 屏幕分割断点使用的单位是 dp，而不是 px。

Tailwind CSS 自定义屏幕

Tailwind CSS 自定义屏幕章节中，详细说明如何对屏幕进行“分类”配置；您可以随意拥有任意数量的屏幕，并以您喜欢的项目方式命名它们。下面是其默认配置：

/** @type {import('tailwindcss').Config} */
module.exports = {
  theme: {
    screens: {
      'sm': '640px',
      // => @media (min-width: 640px) { ... }

      'md': '768px',
      // => @media (min-width: 768px) { ... }

      'lg': '1024px',
      // => @media (min-width: 1024px) { ... }

      'xl': '1280px',
      // => @media (min-width: 1280px) { ... }
  }
}

如果您想实现在小屏幕用小字体，大屏幕用大字体，即可像这样写：

Tailwind CSS

如上 class 会被 Tailwind CSS 翻译成如下内容：

.text-sm {
    font-size: 0.875rem;
    line-height: 1.25rem;
}

@media (min-width: 768px) {
    .md\:text-base {
        font-size: 1rem;
        line-height: 1.5rem;
    }
}

@media (min-width: 1024px) {
    .lg\:text-lg {
        font-size: 1.125rem;
        line-height: 1.75rem;
    }
}

可以看到，本质上也是用媒体查询。只不过与 BlueOS 不同，Tailwind CSS 屏幕分割断点使用的单位，更加灵活，可以是 px、em 等；而且相对能创建更加复杂查询。因此，Tailwind CSS 兼容 BlueOS 非常简单，只需在配置屏幕分割断点注意下即可；下面是 tailwind.config.js 配置参考：

export default {
  theme: {
    screens: {
      // 宽度大于 120 dp => @media (min-width: 120) { ... }
      sm: '120',
      // 宽度大于 166 dp => @media (min-width: 120) { ... }
      md: '166',
      // 宽度大于 640 dp => @media (min-width: 640) { ... }
      lg: '640',
    },
  }
}

在 BlueOS 官方文档中写到：px 会使布局产生等比缩放效果，而 dp 为绝对的屏幕尺寸。以宽度为示例，设备 dp 的计算方法如下：

屏幕宽度 dp 值 = 设备屏幕分辨率的宽度 / DPR

在设备屏幕分辨率的宽度为 360 的设备，通过 device.getInfo 接口获得 screenDensity（设备的屏幕密度，DPR）为 3；即可得到屏幕宽度 dp 值为 120（sm 分段断点值的由来），其他几个依次类推；在 HTML 中，具体使用方式如下：

响应修饰符配合预设类，就可以达成，根据不同设备屏幕分辨率的宽度，得到不同渲染表现；如上代码，预期效果是：

screenWidth <= 360px：黑色背景，白色文字；
360px< screenWidth <= 499px：灰色背景，红色文字；
499px< screenWidth <= 1920px：白色背景、黑色文字。

您可能感兴趣的文章

BlueOS 应用开发，如何通过 $watch 监听数据？

nicejade — Tue, 18 Jun 2024 07:17:22 GMT

`$watch` 使用示例

在 BlueOS（蓝河操作系统）的应用开发中，$watch 是一种用来监控数据变化的方法。当你需要在数据发生变化时执行某些操作，就可以使用 $watch 来实现。下面是如何在 BlueOS 的应用中使用 $watch 的基础步骤：

在你的 .ux 文件的
在这个示例中，创建了一个名为 count 的数据属性，并在 onInit 生命周期钩子中设置了一个 $watch 监控器。每当 count 的值发生变化时，就会打印出一条包含新旧值的信息。

$watch 方法说明

参数
- key（String 格式）：需要侦听对象的属性名称，除了一个根级属性，键名也可以是一个简单的由点分隔的路径，例如 a.b.c。不支持数组索引。
- handler：（String 或 Function 格式）事件句柄函数（函数名），函数的第一个参数为新的属性值，第二个参数为旧的属性值；
  第二个参数 handler 可以接收字符串或匿名函数，因此上述示例可以改成如下写法：
描述

用于声明在数据更改时调用的侦听回调，当属性值发生变化时事件才被触发用法；类似于 Vue 框架中的侦听器（watch）；不同的是，BlueOS 中的 $watch 尚不支持深层侦听、一次性侦听、同步侦听器、停止侦听器。

$watch 注意事项
- 需要侦听的属性，须在 data 或 props 中定义；
- $watch 不支持深层侦听整个数组或对象；
BlueOS （中文名“蓝河操作系统”）是 vivo 自主研发的一款面向通用人工智能时代的智慧操作系统。它以智慧特性、性能优化、安全性、系统架构、AI 服务引擎、兼容性、流畅体验、开放智联等为核心特点，代表了 vivo 在操作系统领域的创新能力和研发实力。BlueOS 的目标是为用户提供一个更加智能、流畅且安全的使用体验。 BlueOS 支持快应用标准，推荐使用 BlueOS Studio 进行应用开发。

BlueOS Studio 是针对蓝河操作系统（BlueOS）应用开发的官方集成开发环境（IDE），它基于强大的代码编辑器 Visual Studio Code 构建，因此具备 VS Code 的全部功能，包括代码编辑、插件集成、主题定制及个性化设置等。除了继承 VS Code 的特性外，BlueOS Studio 专为 BlueOS 应用开发引入了一系列增强功能，比如智能编码补全、实时编译预览、全方位应用调试以及 UI 自动化测试等。

为了支持蓝河应用的开发，BlueOS Studio 还提供了项目管理的便捷性，如推荐的项目结构指引、依赖管理工具以及代码构建系统 BlueOS Toolkit，该工具可将源代码打包为 .rpk 格式的应用程序文件。此外，BlueOS Studio 也整合了 DevTools 模拟调试工具，类似于 Chrome DevTools，提供了丰富的调试面板以助于代码调试和性能优化。

在蓝河应用开发上， BlueOS Studio 适用于开发包括手机、手表、Pad 在内的多种应用形态，并为开发者提供丰富的开发、调试、测试和打包工具，以及项目开发的指导和文档支持，以确保开发者可以高效且方便地进行蓝河应用的开发工作。发布完成后的应用则可以供蓝河操作系统的用户使用。

您可能感兴趣的文章
- BlueOS 应用开发，定时器需要注意些什么？

静轩之别苑

如何像 Elon Musk 一样思考？第一性原理的应用与实操指南

什么是第一性原理？

核心思维方法

实际应用步骤

实用性建议

Elon Musk 如何使用第一性原理？

如何应用于日常生活？

新手快速上手：实操指南

三步练习法

每日 5 分钟训练

常见误区

更多应用场景

结语

AI Agent 工程化十二要素详解

Factor 1: 自然语言到工具调用 (Natural Language to Tool Calls)

关键要点：

实践意义：

Factor 2: 掌控你的提示词 (Own Your Prompts)

关键要点：

实践意义：

Factor 3: 掌控你的上下文窗口 (Own Your Context Window)

关键要点：

实践意义：

Factor 4: 工具就是结构化输出 (Tools Are Just Structured Outputs)

关键要点：

实践意义：

Factor 5: 统一执行状态和业务状态 (Unify Execution State and Business State)

关键要点：

实践意义：

Factor 6: 通过简单 API 实现启动/暂停/恢复 (Launch/Pause/Resume with Simple APIs)

关键要点：

实践意义：

Factor 7: 通过工具调用联系人类 (Contact Humans with Tool Calls)

关键要点：

实践意义：

Factor 8: 掌控你的控制流 (Own Your Control Flow)

关键要点：

实践意义：

Factor 9: 将错误压缩到上下文窗口 (Compact Errors into Context Window)

关键要点：

实践意义：

Factor 10: 小而专注的代理 (Small, Focused Agents)

关键要点：

实践意义：

Factor 11: 在任何地方触发，在用户所在之处相遇 (Trigger from Anywhere, Meet Users Where They Are)

关键要点：

实践意义：

Factor 12: 让你的代理成为无状态的 Reducer (Make Your Agent a Stateless Reducer)

关键要点：

实践意义：

总体架构思想

财富之道：哈里·布朗的 17 条财务安全黄金法则

你的职业

你的财富可能无法替代

投资与投机

预测未来

投资建议

交易系统

以现金为基础运作

自己做决定

了解你所做的事

多元化

平衡的投资组合

投机

国际多元化

避税计划

问题

享受

如有疑问...

生活规则

《纳瓦尔宝典》读书笔记：致富和幸福的良言

通俗易懂解读 AI、Transformer、RAG、Agent 等核心概念

什么是人工智能?

什么是机器学习？

什么是神经网络？

什么是深度学习？

Transformer 是什么？

什么是 RAG？

什么是 AI Agent？