1. 项目概述你的AI首席运营官如果你是一位非技术背景的职场人士——产品经理、市场总监、销售负责人、设计师甚至是CXO——你可能已经体验过AI聊天机器人的便利但也一定感受过它的局限对话是零散的信息是孤立的承诺说完就忘项目进展难以追踪。你需要的不是一个更聪明的聊天窗口而是一个能真正理解你工作上下文、融入你工作流、并主动为你服务的“数字副手”。这就是Dex项目的核心价值。Dex由Dave Killeen构建本质上是一个基于Claude AI的个人操作系统。它不是一个独立的应用而是一套部署在你本地电脑上的、由AI驱动的“工作大脑”和“执行网络”。通过将Claude Code或Cursor与你本地的文件系统、日历、任务深度集成Dex将散落在各处的信息——会议纪要、待办事项、人际关系笔记、职业目标——编织成一个有生命的、持续进化的知识网络。最吸引人的是你无需编写任何代码只需按照引导完成一次约10分钟的配置就能获得一个完全根据你角色定制的智能工作台。想象一下每天早晨一个指令就能获得根据你当天会议密度自动调整的三大优先级每次会前自动弹出上次与对方的讨论要点和待办事项每完成一项任务它在所有相关文件会议记录、人物页、项目文件中同步标记为完成系统甚至会默默观察你的工作模式每周为你推荐尚未使用但可能极具价值的新功能。这不是未来幻想而是通过Dex即可实现的日常。下面我将带你从零开始彻底拆解这套系统的搭建、核心原理与实战应用分享我作为早期使用者踩过的坑和提炼出的效率倍增技巧。2. 核心架构与工具选型解析在深入实操前理解Dex的架构和不同工具的选择逻辑至关重要。这决定了你最终体验的流畅度与自动化能力的上限。2.1 核心组件AI引擎、MCP协议与本地仓库Dex不是一个“黑盒”SaaS产品其威力来源于三个核心组件的巧妙结合AI引擎Claude这是系统的大脑负责理解你的自然语言指令、处理信息、生成内容。Dex主要适配Anthropic的Claude模型因其在长上下文、复杂指令遵循和安全性方面的优势。模型上下文协议MCP这是连接AI大脑与外部世界你的本地数据的“神经系统”。MCP允许Claude安全、可控地访问你电脑上的特定工具服务器比如读取日历、同步任务、管理文件。Dex内置了多个MCP服务器如Work MCP用于任务同步这是实现“任务一处完成处处更新”魔法的基础。本地知识仓库Vault这是一个结构化的文件夹项目目录存放你所有的工作数据——目标、任务、会议记录、人物档案等。所有数据都保存在你的本地电脑上隐私和安全得到保障。AI通过MCP协议与这个仓库交互。2.2 客户端工具选型Cursor vs. Claude Code这是配置Dex时第一个关键决策点。两者都能运行Dex但能力和体验有显著差异。选项ACursor推荐起点是什么一个集成了AI辅助的现代代码编辑器内置了Claude模型。成本免费版可用专业版20美元/月提供更多AI调用次数和高级功能。核心优势开箱即用安装后即可使用无需额外Claude账号。友好界面拥有图形化界面GUI文件管理、终端、聊天窗同屏显示对新手极其友好。功能全面强大的代码编辑、搜索、版本控制Git集成。核心局限无确定性钩子HooksClaude在会话中加载上下文如你的季度目标、本周重点是概率性的并非100%触发。可能导致有时AI“忘记”你的工作背景。适合谁所有初学者以及偏好图形界面、希望快速上手的用户。选项BClaude Code桌面应用或命令行是什么Anthropic官方推出的AI编程工具专注于提供深度、上下文感知的编码协助。成本必须订阅Claude Pro20美元/月或更高版本。核心优势确定性钩子Hooks这是“杀手级”特性。钩子是预设的自动化脚本在特定事件如会话开始、读取某类文件时必定触发。这意味着每次打开Dex你的战略支柱、本周优先级、紧急任务等上下文都会被自动加载人物提及时其档案会自动注入学习到的模式会自动浮现。可靠性极高。持久化学习系统改进和偏好学习更连贯。两种形态桌面应用图形界面支持多会话并行、侧边栏差异对比集成日历、Slack等。命令行CLI在终端中运行极客风格轻量高效。适合谁追求系统可靠性、自动化深度且不介意命令行或愿意使用桌面应用的用户。我的实操心得我强烈建议从Cursor免费版开始。它能让你在10分钟内体验到Dex 80%的核心功能验证这套系统是否适合你的工作流。如果几周后你发现依赖度很高且希望上下文加载100%可靠、自动化更“无感”再平滑迁移到Claude Code桌面版体验更佳。很多深度用户后期会同时使用Cursor用于复杂的文档编辑和检索Claude Code用于需要强上下文保证的深度工作会话。2.3 环境依赖为什么需要Node.js和PythonDex的自动化能力尤其是任务同步依赖于本地运行的后台服务这就需要相应的运行时环境。Git用于从GitHub克隆Dex项目代码库到本地。这是获取Dex“蓝图”的标准方式。Node.js一些辅助脚本和工具链可能基于Node.js环境。安装其长期支持LTS版本能保证兼容性。Python 3.10这是最关键且最容易出错的环节。Dex内置的“Work MCP”服务器是用Python编写的它负责在后台监听任务变更并实现跨文件的任务ID同步。Python 3.10或更高版本是运行该服务器所必需的。许多Mac电脑预装了Python 2.7或3.9必须升级。3. 从零开始的详细搭建指南以下步骤假设你选择从Cursor开始。请严格按照顺序操作我将标注出每个容易踩坑的地方。3.1 第一步基础环境准备一次性工作安装Cursor访问 cursor.com 下载并安装。用邮箱注册一个免费账户即可。安装GitMac用户通常系统已自带或会在后续步骤中提示安装可暂时跳过。Windows用户务必访问 git-scm.com/download/win 下载安装程序。安装时全部选择默认选项即可。安装Node.js访问 nodejs.org 下载标注为“LTS”的版本并安装。安装Python 3.10访问 python.org/downloads 下载最新稳定版如3.11 3.12。Windows用户特别注意安装时务必勾选“Add Python to PATH”这个选项。这是为了让系统在任何位置都能识别python命令否则后续步骤会失败。Mac用户如果系统提示安装“Command Line Developer Tools”请点击“安装”这需要2-3分钟是必要的。环境验证在终端中执行 打开终端MacCmdSpace搜索“终端”WindowsWinR输入“powershell”。 依次输入以下命令并回车检查版本git --version # 应显示版本号如 git version 2.40.1 node --version # 应显示 v18.x 或 v20.x 等 python3 --version # 或 Windows下用 python --version应显示 Python 3.10.x 或更高如果任何一条命令报“未找到”请返回重新安装对应软件并完全关闭终端后重新打开再试。3.2 第二步获取Dex代码并运行安装脚本在Cursor中克隆项目打开Cursor。按下CmdShiftP(Mac) 或CtrlShiftP(Windows) 打开命令面板。输入 “Git: Clone” 并回车。在弹出的输入框中粘贴仓库地址https://github.com/davekilleen/dex.git回车。选择一个本地文件夹如“文档”存放点击“确定”。克隆完成后Cursor会询问是否打开该文件夹点击“Open”。备选方案如果Git克隆失败直接访问 github.com/davekilleen/dex 点击绿色的“Code”按钮选择“Download ZIP”。下载后解压到你的文档文件夹然后在Cursor中选择File - Open Folder打开解压后的dex-main文件夹。运行安装脚本在Cursor中确保左侧文件树导航栏显示的是Dex项目文件夹。点击底部面板的“终端”标签页或通过View - Terminal打开集成终端。在终端中输入以下命令并回车./install.sh等待1-2分钟脚本会自动安装所需的Python包如mcp,pyyaml等。期间会有大量文字滚动这是正常现象。安装成功标志脚本运行完毕终端光标重新闪烁无红色错误信息。同时Cursor底部的MCP服务器面板通常有一个插头图标应显示几个服务器名称如“work”、“person”等旁边有绿色对勾。3.3 第三步角色配置——让Dex真正认识你这是将通用系统变为你个人专属系统的关键一步。在Cursor右侧的聊天面板Claude对话界面中输入以下指令并回车/setup等待约30秒首次加载需要时间Claude会开始向你提问。像回答同事一样自然回答你的角色是什么(例如“高级产品经理”、“营销总监”、“初创公司CEO”)公司规模(例如“50人左右的科技公司”、“跨国企业”、“独立顾问”)你的主要关注领域(例如“用户增长、产品上市、团队管理”、“客户成功、续费率提升”、“财务规划与融资”)配置完成后Claude会确认你的工作空间已就绪。此时Dex会根据你的角色在左侧文件树中生成对应的文件夹结构如01-Strategy02-People等并预装适合你角色的技能命令。重要提示/setup命令只需运行一次。它会创建你的个人配置档案。之后所有操作都将基于此配置。3.4 可选但推荐连接Google日历仅限Mac为了让Dex在生成每日计划/daily-plan时能读取你的真实会议安排需要连接日历。将Google日历添加到Mac原生“日历”应用打开Mac自带的“日历”应用。顶部菜单栏点击“日历” - “添加账户…” - 选择“Google” - 登录你的Google账号。授予Cursor日历访问权限打开“系统设置” - “隐私与安全性” - “日历”。在右侧应用列表中找到“Cursor”并打开其开关。点击“Cursor”字样确保访问权限设置为“完全”。完成以上步骤后Dex就能通过Mac的日历API读取你的会议信息了。Windows系统目前需等待官方支持或使用其他变通方法。4. 核心功能实战与工作流融合系统搭建完毕现在让我们深入核心功能看看如何让它真正为你工作。4.1 每日工作流从混沌到聚焦早晨用/daily-plan启动一天在聊天框输入/daily-planClaude会读取你的日历分析今天的会议数量与时长。评估可用带宽会议密集日它会自动建议2个核心优先级会议较少日则建议3个。关联战略目标从你的“本周优先级”Week_Priorities.md和“季度目标”Quarter_Goals.md中挑选出与今日最相关、最值得推进的2-3项任务。生成计划输出一份简洁的今日计划包括优先级任务、会议准备要点、以及需要跟进的事项。价值你不再需要花15分钟梳理今天要做什么。系统基于你的宏观目标和实时日程帮你做出最优的每日承诺防止过度安排。白天自然语言捕捉与智能归档这是Dex最强大的特性之一——对话式捕捉。你不需要思考“这个信息该存到哪个文件”只需像跟助理说话一样告诉Claude。你“刚才和Sarah开会她担心Q2试点的时间线但对我们的新定价模型很感兴趣。” Claude“我看到你的‘本周优先级’里有‘Sarah团队 onboarding’和‘Q2规划’。需要我把这个信息更新到Sarah的个人页面并关联到‘Q2规划’项目文件吗” 你“是的都关联上。”瞬间相关信息就被归位到了正确的地方人物页和项目文件并打上了时间戳。这种基于上下文的智能路由极大地降低了记录负担提高了信息的可追溯性。傍晚用/daily-review完成闭环输入/daily-reviewClaude会引导你回顾今天完成了什么有什么收获或教训有哪些承诺需要追踪有没有值得记录的职业成就证据这些回顾内容会被自动结构化保存到System/Session_Learnings/目录下成为系统学习和你个人职业发展的素材。4.2 会议智能从不做无准备的会议会前输入/meeting-prep [参会人姓名]。Dex会调取该联系人的完整档案过往会议纪要、待办事项、个人关注点。列出所有与对方相关的未完成行动项。根据会议主题如果有建议本次会议的讨论要点。会后将会议录音转录文本或你自己记的笔记粘贴给Claude并说“处理这份会议纪要”。Dex会自动提取行动项识别出所有任务并为其生成唯一ID如^task-20241027-001。同步到总任务列表这些带ID的任务会同时出现在会议纪要文件和03-Tasks/Tasks.md中。更新人物页任务也会被关联到相关人员的个人页面。结构化归档生成格式清晰的会议纪要包含摘要、决定、后续步骤。任务同步的魔法之后当你在任何地方比如在Tasks.md里标记某个任务完成时Work MCP服务器会在后台运行找到所有包含该任务ID的文件并将其状态统一更新为“已完成”并加上时间戳。彻底解决了任务在多处记录、状态不同步的痛点。4.3 职业发展教练让成长被看见运行一次/career-setup输入你的职位描述、职级体系、近期绩效回顾和成长目标。此后Dex便成为你的私人职业教练。自动证据收集在日常回顾、项目完成、收到反馈时Claude会提示“这似乎是一项值得记录的成就要保存到职业证据库吗”一键生成报告需要向老板汇报时运行/career-coach选择“每周报告”30秒内生成结构清晰的工作进展摘要。晋升差距分析运行/career-coach选择“晋升评估”系统会根据你积累的证据对比下一职级的要求生成一份具体的差距分析和发展计划。你的所有职业数据都安全地存放在本地随着时间推移这份不断丰富的证据库将成为你争取晋升、谈判薪资时最有力的武器。4.4 系统自进化与功能发现Dex不是一个静态工具它会在使用中学习并成长。模式学习如果你多次纠正Claude的某种回复方式比如“不要用项目符号用段落”它会将这条“偏好”记录到System/Working_Preferences.md以后自动遵循。错误捕获如果Claude犯了错比如错误归类了一个任务你可以在回顾中指出。这个“错误模式”会被记录未来尽量避免。新功能推荐运行/dex-level-up系统会分析你的使用日志推荐2-3个你尚未使用但很可能用上的高级功能。例如新手可能被推荐学习使用/triage来清理积压任务而高级用户可能被建议尝试创建自定义的MCP服务器来连接内部系统。自我更新系统后台会每日检查Claude Code是否有新版本发布。如果有它会评估新功能对你的系统有何价值并给出升级建议。5. 高级配置、问题排查与效能提升5.1 从Cursor迁移到Claude Code获得确定性钩子如果你决定追求更高的自动化可靠性可以按以下步骤迁移安装Claude Code桌面版确保你拥有Claude Pro或Max订阅。访问 claude.ai/download 下载并安装。打开应用登录你的Claude账号。点击左上角的“Code”标签页。导入Dex项目在Claude Code中点击“Open Folder”或类似按钮。选择你之前存放Dex项目的文件夹dex或dex-main。开始会话现在你就在Claude Code环境中打开了Dex。你会立即感受到不同每次新会话开始时聊天框上方可能会自动出现一段预加载的上下文这就是“会话启动钩子”在起作用。命令行版本安装供参考 在终端中运行安装脚本Mac用curl -fsSL https://claude.ai/install.sh | bash Windows用PowerShell命令然后通过claude auth登录最后在Dex项目目录下运行claude启动。5.2 常见问题与解决方案速查表问题现象可能原因解决方案运行./install.sh时提示“command not found: git”Git未安装或未正确加入系统路径。Windows用户请重新从官网安装Git确保安装过程中勾选“添加到PATH”。Mac用户通常可在提示时安装命令行工具。运行./install.sh时Python包安装失败提示版本不兼容或找不到。1. pip版本过旧。2. Python版本低于3.10。1. 先升级pippython3 -m pip install --upgrade pip2. 确认Python版本python3 --version。若低于3.10请从python.org下载新版重装。Cursor中MCP服务器显示红色错误。Python依赖包缺失或.mcp.json配置文件中的Python命令路径不对。1. 手动安装依赖pip3 install --user mcp1.0.0,2.0.0 pyyaml python-dateutil2. 检查项目根目录下的.mcp.json文件将command: python尝试改为command: python3或反之。3.完全重启Cursor。/daily-plan不显示我的日历会议。1. (Mac) Google日历未添加到原生日历App。2. Cursor未被授予日历权限。3. 安装脚本中的日历支持包未成功安装。1. 确保已按“3.4”步骤将Google账户添加到Mac日历App。2. 在系统设置中检查Cursor的日历权限是否为“完全”。3. 在终端运行pip3 install --user pyobjc-framework-EventKit然后重启Cursor。任务完成后状态没有在其他文件中同步。Work MCP服务器未正常运行。1. 检查Cursor底部MCP面板“work”服务器是否绿色启用。2. 检查Python版本是否为3.10。3. 尝试在终端位于Dex项目目录下手动启动服务器python3 tools/work_mcp/server.py观察是否有错误输出。Claude似乎“忘记”了我的角色和上下文。在Cursor中使用缺乏确定性钩子。1. 在开始重要会话前手动通过聊天框提供上下文例如“请基于我的角色XX经理和本周优先级文件在XX路径来思考。”2. 考虑迁移到Claude Code以获得自动上下文加载。5.3 效能提升技巧与自定义创建自定义技能SkillsDex的技能本质上是预定义的提示词模板。你可以模仿现有技能在System/Prompts/目录下创建属于自己的技能。例如创建一个/weekly-report技能自动从本周完成的任务和会议记录中提炼要点生成给团队的周报草稿。利用“人物”与“公司”页不要只把02-People/目录当作通讯录。为每个重要合作者建立详细档案记录他们的职业背景、个人兴趣、沟通风格偏好、过往达成的共识和存在的分歧。在每次互动前快速浏览能极大提升沟通质量和关系深度。04-Companies/目录同理用于记录组织层面的信息、关键决策人、合作历史等。定期运行/dex-backlog这个命令会展示系统自动收集的改进想法来自你的学习记录和AI的分析并按影响力排序。定期从这里挑选高价值项目进行实施让你的系统越来越贴合你的需求。演示模式想向同事展示Dex的能力又不想泄露自己的真实数据运行/dex-demo on系统会切换到一个包含模拟数据的演示空间完整展示所有功能。演示完毕运行/dex-demo off即可切回。6. 长期使用策略与思维转变使用Dex一周后你可能会感到效率提升但使用一个月后真正的转变在于思维模式的升级。从信息消费者到系统构建者你不再只是被动地使用软件功能而是开始思考如何将你的工作流程“翻译”成Dex能理解和自动化的规则。你会自然地思考“这个重复性判断能否让Claude基于我的规则来做”“这个信息流转能否通过MCP服务器自动完成”从任务执行到战略聚焦因为日常的执行、跟踪、归档工作被大幅自动化你得以释放出更多的认知带宽用于思考真正的战略问题、人际关系建设和个人成长。Dex帮你打理好了“地面部队”让你能更专注于“空中指挥”。数据的复利效应你与Dex的每一次互动都在训练它丰富你的个人知识库。三个月后你拥有的不仅是一个好用的工具更是一个沉淀了你所有工作上下文、学习成果和关系网络的“数字孪生”大脑。这在岗位变动、项目交接、晋升答辩时将成为无可比拟的优势。最后的建议不要试图在第一天就完美地使用所有功能。从/daily-plan和/meeting-prep开始培养每天与之互动的习惯。当自然语言记录成为肌肉记忆后再逐步探索/career-coach、/triage任务分类整理等高级功能。让这个系统像一棵树一样随着你的使用自然生长最终枝繁叶茂成为你职业生涯中不可或缺的根基。