1. 项目概述当AI助手成为你的认知行为疗法伙伴如果你和我一样对AI助手的印象还停留在写代码、改文档或者生成一些营销文案那么cbt-llm-kit这个项目可能会彻底改变你的看法。它本质上是一个“认知行为疗法工具包”但别被这个专业的心理学名词吓到。简单来说它是一套精心设计的指令和数据结构能让你的Claude、Cursor或者Gemini等AI助手变成一个引导你进行结构化情绪记录和思维分析的私人伙伴。想象一下当你感到焦虑、沮丧或者被某个负面想法困扰时不是去网上漫无目的地搜索也不是把情绪憋在心里而是打开一个你每天都在用的工具通过一系列有逻辑的问答帮你把一团乱麻的思绪理清楚——这就是cbt-llm-kit在做的事情。这个项目的核心价值在于“结构化”和“本地化”。它基于经典的贝克/伯恩斯认知模型将一次完整的认知行为疗法思维记录拆解成12个循序渐进的步骤。你的AI助手会严格遵循这个流程像一个受过训练的引导者一步一步问你“当时发生了什么”“你脑海里闪过的念头是什么”“这个想法背后有哪些证据支持又有哪些证据反驳”整个过程的数据包括你所有的回答和最终的分析都以JSON格式保存在你电脑的本地文件夹里没有任何数据会上传到云端。对于注重隐私的心理自助实践者来说这一点至关重要。它不是一个需要注册、付费的在线服务而是一个你可以完全掌控、随时取用的开源工具。2. 核心原理拆解CBT思维记录的自动化逻辑要理解cbt-llm-kit为何有效我们需要先抛开技术看看它背后的心理学原理——认知行为疗法。CBT的核心假设是我们的情绪和行为C - Consequences并非直接由外界事件A - Activating Event引发而是经由我们对事件的看法和信念B - Beliefs这个中间环节加工后产生的。很多时候让我们痛苦的并非事件本身而是我们自动化产生的、常常带有扭曲的“想法”。cbt-llm-kit所做的就是利用大语言模型强大的自然语言理解和上下文引导能力来系统化地干预这个“B”环节。2.1 结构化流程如何对抗思维混沌当我们被情绪淹没时思维往往是跳跃、模糊且自我强化的。比如一次工作汇报后老板皱了皱眉你可能瞬间产生“我搞砸了他肯定觉得我能力不行我可能要丢工作了”这一连串灾难化想法并伴随着强烈的焦虑感。传统上心理治疗师会引导你在一张“思维记录表”上逐项填写将模糊的感受固化为可审视的文字。cbt-llm-kit的schema.json和questions.json文件就是这张表格的数字化、可交互版本。它的12步流程设计极具逻辑性情境客观化步骤1首先锚定事实。“发生了什么时间、地点、人物”这迫使你从情绪中抽离先描述客观事实。思维显性化步骤23捕捉瞬间的“自动思维”和伴随的情绪强度。这是关键一步把那些一闪而过、却主导你感受的念头捉住。身心连接步骤45记录身体反应和实际行为。心慌、手抖还是回避了沟通这帮助你将心理状态与生理、行为表现联系起来。证据检验步骤67这是认知重构的核心。像侦探一样分别寻找支持和反对你自动思维的证据。AI在这里的作用不是评判而是促使你进行这项通常被我们忽略的“思维练习”。生成替代方案步骤8基于新的证据构建一个更平衡、更符合事实的想法。识别模式步骤9-11分析是否存在“安全行为”如回避、属于哪种“认知扭曲”并探索其背后可能存在的“核心信念”。这一步是从处理单一事件上升到理解个人思维模式。情绪再评估步骤12最后重新评估情绪强度。通常在经过上述理性审视后情绪强度会有所下降这本身就是一个积极的反馈。这个流程的强大之处在于它通过固定的步骤强制打断了情绪的恶性循环将内省过程从一种模糊的“胡思乱想”变成一项有章可循的“思维健身”。2.2 LLM如何扮演引导者角色你可能会问为什么是AI一个PDF表格不也能完成吗这里就体现了LLM的独特优势。一个静态表格需要你自行回忆所有步骤、对抗填写时的惰性、并且独自完成最困难的“证据检验”环节。而cbt-llm-kit中的AI通过读取预设的流程和问题库扮演了一个积极、中立、永不疲倦的引导者。上下文引导AI会严格按顺序抛出问题你只需要专注于回答当前这一个。它记住了你之前的所有回答并在后续问题中能进行有上下文关联的追问例如在询问“证据反对”时它可能会引用你前面提到的情境细节。提供即时参考当询问“认知扭曲”类型时AI能立刻调取schema.json中定义的13种扭曲及其例子供你参考帮助你更准确地识别自己的思维模式而不是面对一个陌生的术语列表发懵。自然语言交互你可以用最自然的口语描述你的感受和想法AI能理解并提取关键信息。这比在表格的方框里填字要顺畅得多也更接近真实的倾诉体验。注意必须清醒认识到这里的AI并非一个具有情感共鸣的治疗师。它不提供共情、安慰或个性化建议。它的核心价值是“结构化”和“流程化”确保你能够完整地、不自欺欺人地走完自我审视的每一步。它的“智能”体现在对流程的忠实执行和对信息的关联处理上而非情感支持。3. 从零开始部署与配置指南了解了原理我们来看看如何亲手把这个工具搭建起来。整个过程非常轻量不涉及复杂的服务部署核心就是准备数据文件和配置你的AI助手。3.1 环境准备与一键安装项目作者提供了极简的安装脚本这是最快上手的方式。打开你的终端Terminal, iTerm, PowerShell等进入你希望安装该工具包的目录。这个目录可以是你的个人笔记文件夹、一个专门的心理自助项目目录或者任何你方便访问的地方。运行以下命令curl -sL https://raw.githubusercontent.com/arktnld/cbt-llm-kit/main/install.sh | bash这个命令会从项目的GitHub仓库下载安装脚本并立即执行。安装过程详解与注意事项脚本执行脚本首先会检查必要的工具如git然后克隆cbt-llm-kit仓库到当前目录的一个临时位置。AI助手选择脚本会交互式地询问你主要使用哪个AI助手如Claude Code, Cursor, Gemini CLI。这一步非常关键因为它决定了后续配置文件的生成方式。目录结构创建脚本会在你的当前目录下创建以下结构your-current-directory/ ├── data/ # 核心数据文件schema.json, questions.json, cheat-sheet.md ├── records/ # 存放你所有思维记录JSON文件的地方 └── .cursorrules # 或 .clauderc 等取决于你选择的AI助手配置文件注入脚本会根据你选择的AI助手将对应的“斜杠命令”配置写入到AI助手能识别的配置文件中例如对于Cursor是.cursorrules文件对于Claude Code可能是.clauderc。这步操作使得你后续能在AI聊天界面直接使用/cbt:record这样的命令。实操心得我建议专门创建一个名为Mental-Wellness或CBT-Journal的目录来运行安装脚本。这样所有相关文件都集中在一个地方便于管理。此外在执行curl ... | bash这种远程脚本时从安全角度出发有经验的用户可以先用curl -O下载脚本审阅其内容后再本地执行。3.2 手动安装与多AI环境配置如果你对一键脚本不放心或者需要同时配置多个AI助手比如在Cursor和Claude Code中都想使用可以手动安装。步骤一克隆仓库git clone https://github.com/arktnld/cbt-llm-kit.git cd cbt-llm-kit步骤二理解核心文件手动安装的关键在于理解三个核心数据文件和一个配置动作data/schema.json: 定义了所有“选项”的数据结构如13种认知扭曲、情绪列表、身体感觉列表等。这是工具的“词汇表”。data/questions.json: 定义了/cbt:record和/cbt:checkin的完整对话流程。这是工具的“剧本”。data/cheat-sheet.md: 一份完整的CBT参考指南供你随时查阅概念。配置命令你需要让AI助手知道当用户输入特定命令如/cbt:record时去读取这些文件并按照既定流程执行。步骤三为你的AI助手配置命令这是手动安装的核心不同助手配置方式不同对于Cursor 在项目根目录创建或编辑.cursorrules文件添加如下内容{ //: CBT Thought Record Kit, commands: { cbt:record: { description: Start a guided CBT thought record session, prompt: Please follow the structured CBT thought record process defined in ./data/questions.json and ./data/schema.json. Guide the user step by step through all 12 steps. Save the final record to ./records/ with a timestamped filename. }, cbt:checkin: { description: Daily check-in to review recent thought records, prompt: Please conduct a daily check-in based on the process in ./data/questions.json. Review records from ./records/, summarize patterns, and guide the user through reflection. }, cbt:analyze: { description: Analyze all thought records for long-term patterns, prompt: Analyze all JSON records in ./records/ to identify trends in cognitive distortions, emotions, and core beliefs over time. } } }这样在Cursor的AI聊天框中输入/就会看到cbt:record等命令选项。对于Claude Code或Claude Desktop 配置通常放在claude_desktop_config.json或通过其设置界面添加。你需要添加一个自定义指令内容类似于当用户输入“/cbt:record”时请严格按照项目根目录下./data/questions.json和./data/schema.json定义的流程引导用户完成一次12步的认知行为疗法思维记录。每一步只问一个问题等待用户回答。最终将完整记录以JSON格式保存到./records/目录文件名包含时间戳。具体路径取决于Claude Code的版本和配置方式。对于Gemini CLI 通常需要在它的配置文件中注册新的命令别名。避坑指南手动配置最常见的失败原因是文件路径不正确。确保你在正确的项目目录下启动AI助手。AI助手的工作目录pwd必须包含data/和records/文件夹。一个检查方法是在AI聊天框里先让AI“列出当前目录文件”看是否能找到data文件夹。4. 核心工作流深度实操解析配置完成后我们就可以进入核心的使用环节了。cbt-llm-kit提供了三个核心命令对应三种不同深度的使用场景。4.1 完整思维记录流程/cbt:record实战这是最常用、最核心的功能。让我们模拟一次完整的对话看看AI是如何引导的以及我们该如何有效回应。启动与情境描述你在AI聊天框输入/cbt:record。AI会立刻进入角色AI: 我们来开始一次思维记录。第一步情境。发生了什么请描述具体的事件、时间、地点和涉及的人。你的回答应尽量客观、具体。避免一开始就掺杂情绪和评价。低效回答“我感觉很糟同事让我压力很大。”太模糊高效回答“今天下午3点的团队周会上当我正在汇报Q2项目进度时同事小明打断了我指出我图表中的一个数据来源可能不准确并当着经理的面提出了质疑。”捕捉自动思维与情绪AI接着问AI: 第二步自动思维。在那个瞬间你脑海里闪过的想法是什么可能不止一个。这是关键。你需要捕捉那些“一闪而过”的念头哪怕它听起来不合理。应捕捉的“‘我太不专业了这种错误都会犯’、‘经理肯定觉得我靠不住’、‘小明是不是故意针对我’”AI: 第三步情绪。在这些想法出现时你感受到了什么情绪请用1-2个词描述如焦虑、愤怒、羞愧并为每种情绪的强度打分0-100%。具体化“羞愧 - 强度85%焦虑 - 强度70%恼怒 - 强度40%。”身体与行为反应后续关于身体感觉“心跳加速、手心出汗”和行为“我语速加快地为自己辩解然后匆匆结束了汇报部分”的问题帮助你建立身心连接。核心环节证据检验与认知重构从第六步开始进入最具挑战也最有效的部分。AI: 第六步支持性证据。有哪些事实或经历支持你‘我太不专业了’这个想法强迫自己寻找证据即使这很痛苦“我确实引用了未最终确认的数据源这是一个事实错误。”AI: 第七步反对性证据。有哪些事实或经历与‘我太不专业了’这个想法矛盾这是扭转观念的关键。你需要像律师一样为自己辩护“1. 这个项目过去三个月的其他部分都完成得很好获得了肯定。2. 数据源本身是可靠的只是未标注‘待确认’。3. 经理在会议最后总结时仍然肯定了我整体的项目推进工作。4. 人都会犯错这不能定义我的整体专业性。”识别模式与生成替代思维基于新的证据平衡AI会引导你生成“替代思维”第八步“我这次在数据确认环节有疏忽这是一个需要改进的具体点但这不代表我整个工作是不专业的。同事的指正帮助避免了后续更大的问题我可以借此完善工作流程。” 接着识别“安全行为”第九步如“以后避免在公开场合汇报细节”和“认知扭曲”第十步如“以偏概全”、“灾难化”。最终回顾完成所有步骤后AI会生成一个结构化的JSON文件保存到records/目录下并以时间戳命名如record_20231027_143022.json。它会请你重新评估情绪强度第十二步通常你会发现最初的“羞愧85%”可能已经下降到“遗憾40%”。4.2 每日检查与模式分析/cbt:checkin/cbt:analyze单一记录是点每日检查连成线长期分析形成面。/cbt:checkin每日检查建议在一天结束时进行。AI会读取records/文件夹里最近例如当天的记录然后引导你进行回顾模式识别“今天记录的三件事里有两次都出现了‘以偏概全’的扭曲。”情绪波动“焦虑情绪在下午的会议后达到峰值。”安全行为提醒“你提到两次使用了‘回避深入讨论’作为安全行为。” 这个过程帮你从具体事件中抽离看到一天之中的思维和情绪模式。/cbt:analyze长期分析在积累了数周或数月的记录后使用。AI会分析所有JSON文件生成更宏观的洞察最常见扭曲“过去一个月出现频率最高的认知扭曲是‘灾难化’35%和‘读心术’25%。”情绪趋势“每周一的平均焦虑强度显著高于其他工作日。”核心信念浮现“多个记录指向一个潜在的核心信念‘我必须做到完美才能被接纳’。” 这些数据驱动的洞察是单纯靠自我反思难以清晰获得的能为你的自我成长提供非常明确的方向。实操心得不要追求每次记录都“完美”或“深刻”。即使是流水账式的记录其结构化的过程本身就有价值。关键在于形成习惯。我个人的做法是将其与每日日记结合每晚花10-15分钟挑选当天最困扰我的一件事情进行/cbt:record周末再进行一次/cbt:checkin。数据的价值在于长期积累后的回顾。5. 高级技巧、自定义与隐私安全考量当你熟悉基本流程后可以探索一些进阶用法并深入理解其隐私设计。5.1 自定义与扩展cbt-llm-kit的本地化文件结构意味着你可以按需修改让它更贴合你的个人需求。修改schema.json例如你觉得默认的“情绪列表”不够贴切可以添加或修改其中的词条。比如加入“倦怠”、“迷茫”等更符合你个人体验的情绪词汇。同样你也可以调整“身体感觉”或“认知扭曲”的例子使其更符合你的语言习惯。注意修改schema.json后需要确保questions.json中引用的字段名与之匹配。建议先备份原文件。调整questions.json你可以微调引导问题的措辞。比如将“What happened?”改为“请描述一下引发你情绪的具体事件”使其更符合中文语境下的提问方式。你甚至可以设计一套更简化的7步流程或针对特定场景如社交焦虑、工作压力创建专属的问题流。数据二次利用你保存在records/下的所有JSON文件都是结构化的数据宝库。你可以自己编写简单的Python脚本来可视化你的情绪强度变化曲线或者统计各类认知扭曲的出现频率。这完全取决于你的技术兴趣。5.2 隐私、安全与局限性探讨隐私是最大优势所有数据schema,questions,records100%存储在你的本地硬盘。与使用在线心理咨询平台或笔记应用不同你的内心记录没有离开过你的设备。你可以用加密磁盘如macOS的FileVault, Windows的BitLocker来额外保护这个文件夹。安全边界须知AI提供商的隐私政策虽然你的记录数据不离开本地但你与AI助手的对话内容仍需遵守你所用的AI助手如Claude, Gemini自身的隐私政策。通常主流提供商承诺不会将对话内容用于模型训练但为求绝对稳妥避免在记录中提及极度敏感的个人身份信息如身份证号、银行账户。本地文件安全请妥善保管好records/目录。如果你与他人共用电脑考虑将其放在加密压缩包或使用用户权限进行保护。明确认识局限性cbt-llm-kit是一个卓越的自助工具和辅助练习工具但它不能替代专业的心理健康治疗。它不提供诊断无法诊断抑郁症、焦虑症等心理疾病。它不处理危机如果你有自伤或伤人的念头请立即联系本地的危机干预热线或专业医生。它缺乏人际互动治疗关系中治疗师的共情、支持、挑战和反馈是AI无法提供的。它依赖用户的诚实工具的效果取决于你对自己思维的诚实剖析程度。AI无法判断你是否在“自我欺骗”。最适合的使用场景是作为心理健康日常维护的“思维健身器”作为正式治疗期间的课外练习工具或者作为对认知行为疗法感兴趣者的实践入门途径。6. 常见问题与故障排查实录在实际使用中你可能会遇到一些技术或操作上的问题。以下是我在长期使用中遇到的一些典型情况及解决方法。问题一输入/cbt:record命令后AI没有反应或回复“我不理解这个命令”。可能原因1配置文件未生效或路径错误。排查首先确认你是在安装cbt-llm-kit的项目目录下启动的AI助手。在AI聊天框里可以尝试输入“列出当前目录的文件”或“ls”查看输出中是否包含data/文件夹。解决如果不在项目目录使用终端cd命令导航到正确目录然后重新启动AI助手或重新加载项目。可能原因2AI助手的自定义命令配置未正确加载。排查以Cursor为例检查项目根目录下是否存在.cursorrules文件并确认其内容包含cbt:record等命令定义。解决可以尝试在Cursor中手动重新加载规则通常有“Reload .cursorrules”的选项或者重启Cursor应用。对于手动配置请仔细检查配置文件的语法和命令提示词prompt是否正确指向了本地的data/路径。可能原因3命令格式输入错误。解决确保输入的命令与配置完全一致包括冒号是英文冒号。例如是/cbt:record而不是/cbt-record或/cbt record。问题二AI在引导过程中“跳步”或没有严格按照12步流程走。可能原因1AI的上下文理解出现偏差。解决这是大语言模型固有的不可控性。当发现AI偏离流程时果断地打断它可以用明确的指令将其拉回正轨例如“请严格按照questions.json中的第X步来提问只问那个问题。” 或者直接说“我们回到思维记录的正规流程下一个问题应该是关于‘证据支持’的。”可能原因2data/目录下的文件被意外修改或损坏。排查检查questions.json文件是否完整。可以尝试从原始GitHub仓库重新下载该文件进行替换。解决确保data/目录中的文件是原版或你精心修改后的版本避免格式错误如JSON格式不对。问题三记录的JSON文件没有生成或者不知道存到哪里去了。可能原因AI没有执行保存指令或保存路径权限有问题。排查首先在AI对话结束时明确要求AI“请按照要求将本次记录保存为JSON文件。” 然后检查项目根目录下的records/文件夹。解决如果records/文件夹不存在手动创建一个。确保当前用户对该目录有写入权限。你也可以在命令配置的prompt中将保存路径写得更绝对一些例如/Users/YourName/Documents/CBT-Journal/records/。问题四使用/cbt:checkin或/cbt:analyze时AI说找不到记录或分析结果很空泛。可能原因records/目录下没有JSON文件或文件格式不正确。排查确认records/目录下存在之前成功生成的、格式正确的.json文件。解决/cbt:analyze功能依赖于AI对多个JSON文件内容的阅读理解。如果记录数量少比如少于3份分析出的“模式”自然会比较单薄。积累更多记录后再尝试。同时确保你的记录是通过/cbt:record命令正常生成的而不是手动创建的无效文件。问题五感觉流程太冗长每次坚持下来很困难。这不是故障而是使用习惯问题。解决不必强求完整性。即使只完成前5步情境、自动思维、情绪、身体感觉、行为也是一次有价值的情绪觉察练习。你可以自定义一个简化版的questions.json只保留你认为最核心的几步。关键在于定期练习而不是每次的完美无缺。甚至可以把“启动记录”本身作为一个行为目标哪怕只写一句话。最后我想分享一点个人体会。技术工具最大的意义是降低一项有益实践的门槛。cbt-llm-kit并没有创造新的心理学方法它只是将经典的、被验证有效的CBT思维记录法用现代人最触手可及的AI交互形式进行了封装和呈现。它解决的不是“缺乏知识”的问题而是“缺乏一个随时待命、结构清晰、且绝对私密的引导者”的问题。在使用它大半年后我发现自己对情绪的反应速度变快了往往在“自动思维”刚冒头时就能下意识地开始在心里进行“证据检验”。这种思维习惯的内化或许才是这个工具带来的最深层的价值。它像是一副始终放在你口袋里的思维眼镜当你觉得眼前的世界扭曲变形时可以随时戴上它帮你校准回真实的模样。