Tutorial 1 Orientation zh

教程 1 · 入门

🌎 语言： 简体中文 — 查看全部 33 种语言

目标： 运行项目、认识你的 AI 智能体，并执行一次测试门禁，让之后的步骤成为肌肉记忆。

← 返回 首页 · 下一章： 教程 2：代码如何工作

---

1. 为什么选择一个玩笑应用？

学习与编程智能体协作时，最合适的代码应当小、真实、风险低。LockedIn CLI 三者兼具：

• 小： 一个核心文件、一个入口点、一套测试、零依赖。
• 真实： 它可安装为全局 lockedin 命令，行为像真正的 AI CLI。
• 风险低： 它是讽刺作品。即使智能体让谦虚自夸又谦虚了 20%，也不会有人被紧急呼叫。

你因此可以专注于真正的技能：清楚描述改动、让智能体完成工作，并验证结果。

2. 获取代码

git clone https://github.com/xjamesmorris/lockedin-cli.git
cd lockedin-cli

检查 Node 版本（需要 18+）：

node --version

无需安装任何东西，也不用为依赖运行 npm install，因为项目没有依赖。这是刻意的： 可变因素越少，学习越专注。

3. 运行

试试真实程序：

node bin/lockedin.js            # 启动画面和横幅
node bin/lockedin.js post       # 生成一篇“思想领导力”帖子
node bin/lockedin.js aura       # 扫描你的职业气场
node bin/lockedin.js            # 不带参数，进入聊天会话

在会话中输入 /help，随便探索，然后用 /exit 离开。所有内容都从本地词池生成： 无网络、无账户。完整列表见 命令参考。

4. 运行测试门禁

这是整套教程最重要的命令：

npm test

你应看到一整屏绿色检查，结尾类似 pass 318。这套测试就是安全网。从现在开始，工作流始终是：

修改 → npm test → 只有全部变绿才能交付。

5. 认识你的智能体

在项目文件夹内打开编程智能体，让它能看到文件。使用 GitHub Copilot CLI 时运行：

copilot

先让智能体帮你了解项目，不要立即改动。可以这样提示：

“请用两段话介绍这个仓库：说明每个顶层文件和文件夹的用途，以及如何运行应用和测试。 暂时不要修改任何内容。”

把回答与你在步骤 3–4 中看到的内容对照。习惯先让智能体解释，再编辑，这是之后会反复使用的核心习惯。

---

✅ 和你的智能体一起试试

1. 问它：“node bin/lockedin.js reflect '我的咖啡凉了' 会打印什么？ 哪个文件决定输出？” 然后亲自运行命令核对。
2. 让它运行测试并报告结果：“运行 npm test，告诉我有多少项检查通过。”

你已经见过应用、测试和智能体。下一章将解释这个代码库为何如此适合智能体协作。

下一章：教程 2：代码如何工作