Harness Deck — Development skill for Claude Code

Harness 观测台 · Watch the harness think

🌐 **中文** | [English](README.en.md)

Harness 观测台 | 把 Claude Code 的 20 个底层 harness 机制黑盒透明化——发一句话，当场看见 Agent 真实运行。实时事件流 + 状态面板 + 每个机制一个可视化面板，从最小 Agent Loop 到 tool dispatch、permission、hooks、memory、subagent、skill、context compaction、cron、MCP 等 20 个机制，全部真实实现而非动画模拟。为想真正理解 Agent 底层机制的开发者与产品人而做。


**格言驱动 · 边聊边学 · 真实工具执行 · 中英双语界面**

📦 **下载安装包**:前往 [GitHub Releases](https://github.com/juicykwok2019/harness-deck/releases/latest) 下载最新版 `Learn Claude Code Setup *.exe`,双击安装。首次运行的 SmartScreen 提示见下方[安装说明](#安装说明--smartscreen-提示)。

---

**⚠️ 免责说明:本客户端为教学演示用途,会在本地沙箱内执行真实命令。初次使用建议按照页面提示词操作学习。如需脱离提示词进行更多探索实验,建议在「设置」里开启 strict 模式(每条 bash 命令都需你确认后才执行)。**

**安全边界:所有文件操作被限制在应用沙箱目录内(`%APPDATA%\Learn Claude Code\sandbox\`),底层黑名单强制拦截 `rm -rf /`、`sudo`、`format`、`shutdown` 等高危命令(无论是否开启 strict 模式)。请使用你自己的 API Key(系统级加密存于本地,不会外泄)。**

---

🙏 致敬 · 来源(Acknowledgments)

本项目是对 **[shareAI-lab/learn-claude-code](https://github.com/shareAI-lab/learn-claude-code)** 的一次 Windows 桌面化再实现。课程结构、机制顺序与核心教学理念皆源自该仓库,在此致敬。

原仓库的主张,也是本应用想传达的内核:

**“Bash is all you need — A nano claude code–like 「agent harness」, built from 0 to 1”**

**“Agency — the capacity to perceive, reason, and act — comes from model training, not from external code orchestration.”** (能动性——感知、推理、行动的能力——源自模型训练,而非外部代码编排。)

它用 6 个阶段、20 个课时(S01 → S20),围绕一个**始终不变的 agent loop**逐一拆解 harness 机制——tool use、permission、hooks、planning、subagent、context 压缩、memory、system prompt、错误恢复、任务系统、后台任务、调度、多 Agent 团队/协议/自治/worktree 隔离、skill 加载、MCP……**每课只新增一个机制**。

本应用继承了这条主线:把每个机制做成**“能在真实对话里看见的东西”**——不是讲解,而是让你亲手触发工具调用、看它执行、看状态流转。课程编号与机制顺序对齐原仓库的 S01–S20。原仓库以 **MIT** 开源;本项目为学习 / 教学用途的独立实现,同样以 MIT 协议开源。

感谢 **shareAI-lab** 及 learn-claude-code 的所有[贡献者](https://github.com/shareAI-lab/learn-claude-code/graphs/contributors)。

🌐 **在线学习平台**: —— 网页版课程 + Agent Loop 模拟器,专业、全面,**强烈推荐配套使用**。

---

为什么做这个客户端 · 与 We