内容
# 路西斯
**你的AI伙伴绘图工具**
[](https://github.com/berkantay/lucius/releases)
[](LICENSE)
[-black)](#install)
[](#set-it-up-with-claude-code)
你说话。克劳德发送一个页面。每一次传递都被保留。
路西斯是一个桌面画布，你的编码代理在上面绘制丰富的、独立的HTML单页——架构探索器、产品简介、交互式解释器、头脑风暴产物——而你通过语音或聊天引导。每次推送都是一个不可变的版本，你可以擦除。突出任何句子进行评论。发布到你自己的Cloudflare Worker，邀请团队成员通过GitHub用户名，并观看他们的评论流回应用程序，而代理的实时活动球旋转。
## 使用克劳德代码设置路西斯
将以下内容粘贴到任何克劳德代码会话中 - 你的代理会完成其余的工作：
```text
在该机器上设置路西斯（github.com/berkantay/lucius）：
1. macOS：运行 curl -fsSL https://raw.githubusercontent.com/berkantay/lucius/main/install.sh | sh
Linux：克隆 https://github.com/berkantay/lucius，cd进入，按照SETUP.md进行操作。
2. 启动应用程序（打开/Applications/lucius.app）并轮询
curl -s http://127.0.0.1:7317/api/ping，直到它回答 {"app":"lucius","ok":true}。
3. 运行 ~/.lucius/src/scripts/doctor，执行missing_steps中的每个条目，并在此步骤后重新运行doctor。永远不要假设某个步骤已完成。
4. 运行 ~/.lucius/src/scripts/verify，直到它打印 VERIFY_OK，并且我确认应用程序显示“how lucius works”。
5. 然后按照lucius-setup技能（~/claude/skills/lucius-setup/SKILL.md）进行操作，从第2阶段开始：询问我正在做什么，并渲染我的第一个关于它的单页。提供发布和邀请功能。
```
自己动手？`curl -fsSL https://raw.githubusercontent.com/berkantay/lucius/main/install.sh | sh`，打开应用程序，完成。从源码和手动路径：[SETUP.md](SETUP.md)。
## 为什么是路西斯
- **版本，非编辑。** 每次迭代都是SQLite中的不可变快照。侧边栏是每个会话的时间线；“返回到较早的版本”是一次点击，而不是道歉。
- **反馈落在你所指的具体内容上。** 突出文本 → 评论，锚定到该短语（类似于tdoc的锚点，适用于新版本）。或者，用十字准线指向任何元素 - 代理会准确读取你所选择的内容。
- **会话是工作空间。** 每个主题一个，每个主题都有自己的历史、评论和实时**思考球**，在代理工作时会显示在侧边栏和发布的页面上，供你和团队查看。
- **发布到你拥有的基础设施。** 一键将会话发布到你的*Cloudflare Worker + R2*（免费层）。文档默认链接可见；设为私有并邀请GitHub用户名 - 未被邀请的访客会遇到登录门。查看者评论会在一分钟内同步回应用程序，代理会在页面上回复更改的内容。
- **原生代理。** 克劳德代码技能编码了产物质量标准（真实规则：基于真实仓库，不简化系统；风格规则：严格单色，抗杂乱列表）。嵌入式MCP服务器（`127.0.0.1:7317/mcp`）向任何会话公开渲染/评论/选择/状态工具。设置、修复、发布和邀请都由`lucius-setup` onboarding技能驱动 - 你的代理操作产品，而不是你。
- **风格是强制的，而不是期望的。** `skill/design.md`明确禁止AI默认外观（奶油色背景，强调色 конфetti，半径汤，统计图填充）。墨水是唯一的强调色。
## 循环
```
1 你说话 2 克劳德构建 3 新版本 4 你审查 5 发布
语音 · 聊天 ─▶ 基础，设计 ─▶ 不变， ─▶ 审查 · 点击 ─▶ 分享 · 邀请
一个截图 渲染 即时 评论
▲ │
└────────────── "实际上，让它分层" ───────────┘
```
反馈的单位是一句话，而不是一个票据。这个仓库在一天内使用其自身的循环构建 - [示例产物](examples/how-lucius-works.html)解释它是由克劳德编写的，在画布上渲染，并作为生成页面的参考进行提交。
## 架构
```
克劳德代码 ──（CLI / MCP， bearer token）──▶ 控制服务器（Rust，tiny_http :7317）
│ SQLite：会话 · 版本 · 评论
│ Tauri事件
▼
应用壳（React + Fluid Functionalism）
分层侧边栏 · 沙盒iframe画布
高亮评论 · 选择 · 球体
│
发布 ──▶ 你的Cloudflare Worker + R2
◀── 评论和状态同步
```
| 路径 | 内容 |
|---|---|
| `src-tauri/` | Rust：SQLite存储，控制服务器 + MCP，发布，评论轮询器 |
| `src/` | React壳基于 [Fluid Functionalism](https://www.fluidfunctionalism.com) |
| `skill/` | 画布技能：SKILL.md（工作流程 + 真实规则），design.md（风格），`lucius` CLI |
| `setup-skill/` | 入门之旅技能（安装 → 首个产物 → 发布 → 邀请） |
| `worker/` | 发布/评论工作器，从 [tdoc](https://github.com/serenakeyitan/tdoc) （MIT）分发，具有访问控制包装器 |
| `scripts/` | `doctor`（机器可读状态） · `verify`（证明循环） · `reset`（重放首运行） |
| `examples/` | 参考产物 |
## 路线图
- 每个会话一个克劳德 - 启动一个专用代理，固定在一个工作空间
- 画布上的评论线程（今日存储 + 锚定；最小UI）
- 签名/ notarized 构建，Linux 包
- 自己的 GitHub OAuth 应用程序，用于查看者登录（当前 tdoc 的共享客户端 ID）
## 鸣谢
通过与克劳德配对，在一天内使用路西斯本身构建。站在：
[tdoc](https://github.com/serenakeyitan/tdoc) （发布工作器 + 评论叠加层，MIT），[Fluid Functionalism](https://www.fluidfunctionalism.com)（壳组件），[thinking-orbs](https://github.com/Jakubantalik/thinking-orbs)（活动球体），[Tauri](https://tauri.app)和[shadcn/ui](https://ui.shadcn.com)。
## 许可证
MIT — 见 [LICENSE](LICENSE)。
