- 简介
- 目录大纲
- 最新文档
AI-Light 主题格式指南
AI-Light 主题格式指南 | 项目 | 内容 | |---|---| | 格式版本 | V1 | | 文件扩展名 | .ailight-theme.json | | 机器契约 | JSON Schema Draft 2020-12（随应用发布） | | 示例主题 | 内置主题目录（随应用发布） | 主题描述“业务状态应该呈现什么灯光与声音”。设备只执行编译后的场景，不理解 WORKIN...……
leon - 2026年9月5日 14:44
AI-Light Hook API 使用指南
AI-Light Hook API 使用指南 | 项目 | 内容 | |---|---| | API 版本 | V1.0 | | 机器契约 | 运行时 GET /openapi.json（由 Rust DTO 与 Handler 注解生成） | | 默认地址 | http://127.0.0.1:25679 | | 服务范围 | 仅本机回环地址 | Hook API 接收 AI 编程工具或适...……
leon - 2026年9月5日 14:44
主题文件参考
主题文件参考 本章面向需要分享、版本管理或手工编辑主题的高级用户。大多数主题可以直接通过“主题创作器”完成，无需编辑 JSON。 AI Light 用户主题使用 .ailight-theme.json 文件。主题主要包含： 主题名称和版本； 可复用的灯光与声音效果； 任务状态到效果的映射。 使用原则 标准状态为 IDLE / WORKING / WAITING / SUCCESS ...……
leon - 2026年9月5日 14:44
高级接入参考
高级接入参考 本章面向需要接入其他工具或编写自动化的高级用户。Claude Code、Codex 和 WorkBuddy 用户应优先使用应用中的“一键连接”。 AI Light 应用会在本机启动状态服务。服务只监听 127.0.0.1，不会直接接受其他电脑的连接。默认优先使用端口 25679；如果端口被占用，应用会自动选择后续可用端口，因此自定义接入不应把端口写死。 查看当前接口文档 ...……
leon - 2026年9月5日 14:44
术语表
术语表 | 术语 | 含义 | |---|---| | AI Light 应用 | 安装在电脑上的桌面软件 | | AI Light 设备 / 状态灯 | 通过蓝牙接收灯效与声音的实体设备 | | AI 编程工具 | Claude Code、Codex 等产生任务状态的工具 | | 状态 | 空闲、工作中、等你回复、已完成或出错了 | | 主题 | 把状态转换成灯光、动画和声音的方案 | |...……
leon - 2026年9月5日 14:39
