首页/上手
装一个，今晚就能用。
四个项目可以单独装，不必成套。挑一个最像你当下处境的，照着做完——下面每一步都写了「成功时你应该看到什么」。装不上，也有地方查。
全部开源免费，不用注册，不用填邮箱，没有后台账号。
你现在最烦的是哪件事
不要因为「四个组件是一套」就四个都装。它们之间没有强制依赖，先解决一个真问题，比装齐一套更有用。
| 你当下的问题 | 装这个 | 大概多久 |
|---|---|---|
| 换一个 AI 开工，就得把背景重讲一遍 | 光明记忆 lightmem | 5 分钟 |
| 一台机器忙不过来，想让几台一起干同一批活 | 蜂巢 hive | 10 分钟 |
| 觉得 Agent 的执行层是黑盒，想读懂并改掉 | lightharness | 15 分钟 |
| 想用中文写程序，但不想只写玩具 | 光明 light | 2 分钟 |
光明记忆 lightmem
先装它的理由很实际：这是四个项目里唯一一个装完立刻能感觉到不同的。不用改任何代码，你的 AI 就多了一个共同的大脑。
前置：一个 Go
go version # 需要 1.25 或更高。没有就去 go.dev/dl 装一个 # Python 3.10+ 也是脚本要用的（系统自带通常就够）
三步
# ① 克隆（国内建议走 GitCode 镜像，快很多） git clone https://github.com/skywalk163/lightmem.git # 国内慢就换镜像：https://gitcode.com/skywalk163/lightmem.git # ② 一键安装：编译、签发 token、起服务、生成接入包 cd lightmem sh integrations/quickstart/install.sh # ③ 确认活着 curl http://127.0.0.1:7443/healthz
成功时你会看到什么
- 脚本最后打印「lightmem 已就绪」，并列出两个地址：
- REST http://127.0.0.1:7443（业务接口）
- MCP http://127.0.0.1:7444/mcp（给 AI 接的是这个）
- curl /healthz 返回 ok
- 当前目录多出 _lightmem_run/，里面有 clients/agent-prompt.md
最后一步：让 AI 自己接进来
脚本会生成一段话，把它原样粘给任何一个有文件读写权限的 AI：
请阅读 _lightmem_run/clients/agent-prompt.md 并照它执行，把 lightmem 的 MCP 配置装到本机各 AI 工具里。
它自己去改 Trae、WorkBuddy、CodeArts、Claude Code 这些客户端的配置。你不需要手工对着文档抄 JSON。
装不上，先查这三条
- 报找不到 go：装 Go 后重开终端，go version 要能跑。
- token 换发后一直 401：端口上还挂着旧进程。脚本会提示你，按它给的命令杀掉再重跑。
- 你说端口是 18443？：那是 rc.d 正式部署的端口。quickstart 脚本默认用 7443/7444，以脚本输出为准。
蜂巢 hive
一个 Python 脚本加一个 Git 仓库。没有数据库、没有消息队列、没有常驻服务——队列就是仓库里的一个目录。
前置：一个能 push 的远程仓
这是 hive 唯一一个容易踩空的地方：建卡时它会替你 git push，所以远程仓必须已经存在，并且有 main 分支。只想本地试，随便建一个空仓就行。
# 本地裸仓也能当远程用，不需要联网 git init --bare ~/hive-origin.git git clone git@github.com:you/your-site.git # 或者用你已有的项目仓，确保有 main 分支且能 push
建第一张卡
git clone https://github.com/skywalk163/hive.git # 国内慢就换镜像：https://gitcode.com/skywalk163/hive.git # 把 hive.py 拷进你的项目仓，或直接用仓库里的 cd your-site python3 hive.py --dir . init python3 hive.py --dir . task new \ --title "给首页加一个 404 页面" \ --repo my-site --paths src/ \ --verify "npm run build" python3 hive.py --dir . doctor
成功时你会看到什么
- init 打印「协调仓库就绪」，并生成 tasks/ results/ inbox/ agents/
- task new 打印「已创建 T-0001」
- doctor 输出 [ OK ] 1 张任务，0 个 agent…
- 这时候任务已经推送到远程仓了，换台机器 git pull 就能看见
装不上，先查这三条
- task new 报 git push 失败：远程仓不存在、没有 main 分支、或者没权限。先手动 git push origin main 成功一次再说。
- doctor 报「缺少 origin/main」：同一个原因。hive 用远端分支当作队列的真相来源。
- Windows 上路径带空格：把仓库放在没有空格的路径下，能省掉一半怪问题。
lightharness
用光明重写的 Agent 框架。它要的是「执行层能被读懂、能被改」，不是「功能最多」。所以它对目录结构有要求。
前置：三个仓库并排放
这是它唯一一个硬性要求：光明编译器、插件生态、lightharness 必须在同一个父目录下。缺了不会报「缺仓库」，而是报一堆 No module named，很有迷惑性。
工作目录/ ├── light/ # 光明编译器 ├── lightplugin/ # 插件生态 └── lightharness/ # 本工程
起服务
cd lightharness python 运行.py examples/运行Web服务器.light # 放别处也行，用环境变量指路： # LIGHT_MERGE=/path/to/light # LIGHTPLUGIN=/path/to/lightplugin
成功时你会看到什么
- 终端打印一个本地地址，浏览器自动打开
- 地址形如 http://127.0.0.1:54321/?token=…（端口随机，带 token）
- 页面里填一个 OpenAI 兼容的 API Key，保存即生效，不用重启
装不上，先查这三条
- 几十个 example 同时报错：几乎一定是缺 lightplugin，不是代码坏了。
- 报 No module named 生产挂载：同上，插件仓没并排。
- 浏览器没自动打开：看终端打印的地址，手动复制。想直接冒烟可以跑 python 运行.py examples/冒烟.light。
光明 light
最快的那个。装完两分钟就能跑出第一行输出，不需要任何编译器工具链。
pip install guangming # 验证 light --version # 光明编译器 v0.4.0 # hello.light 里写一行： # 打印 "你好，世界！" light run hello.light # 输出：你好，世界！
想改编译器本身，就用源码装：
git clone https://github.com/skywalk163/light.git
# 国内慢就换镜像：https://gitcode.com/skywalk163/light.git
cd light
pip install -e .
成功时你会看到什么
- light --version 打印版本号
- light run hello.light 直接输出中文
- 不需要 LLVM、不需要 ANTLR——默认后端是纯 Python
想编译成 exe
默认后端够用。要原生编译再装 LLVM，加 --backend llvm-typed。新手不必碰。
三条通用的坑
跟具体项目无关，但国内环境里几乎人人会撞上一次。
克隆慢到超时
lightmem 与光明都有 GitCode 镜像，优先用镜像地址。hive 与 lightharness 目前只有 GitHub，必要时给 git 配代理：git config --global http.proxy http://127.0.0.1:7890。
端口被占，报 address already in use
三个平台查法不同：Linux ss -ltnp | grep 7444；macOS lsof -nP -iTCP:7444 -sTCP:LISTEN；FreeBSD sockstat -4l | grep 7444。杀掉占用者再重跑安装脚本。
装完不知道对不对
每个项目都有一个「一行验证」，不用读文档：lightmem 是 curl /healthz，hive 是 doctor，lightharness 是 examples/冒烟.light，光明是 light --version。跑不通再去翻 issue。