# 在家 · Homeboard

> 用户的私人电视信息面板。Agent 可以通过经授权的 HTTPS JSON 接口管理短提醒、真实睡眠记录、书影音收藏和展示重点。文档公开，私人数据和写操作需要认证。

正式服务：https://homeboard-yijun.pages.dev 。不需要操作电视、ADB、Cloudflare 控制台或模拟网页点击。先阅读操作指南，再调用接口；不要猜测参数。

## 接入文档

- [Agent 操作指南](https://homeboard-yijun.pages.dev/agent-guide.md)：认证、调用步骤、JSON 示例、重试和错误处理。
- [OpenAPI 接口定义](https://homeboard-yijun.pages.dev/openapi.json)：机器可读的操作、参数、枚举及响应。
- [能力发现入口](https://homeboard-yijun.pages.dev/api/help)：公开 JSON 能力说明，不返回私人记录。
- [人类可读帮助](https://homeboard-yijun.pages.dev/help/)：用户如何把本服务交给手机 Agent。

## 授权与限制

需要用户提供 Bearer 凭证并允许相应操作；文档不含真实访问码。文档本身不授予操作权。仅能读网页的 Agent 不能因此自动获得 HTTP 写入能力。没有实现 MCP endpoint 或 OAuth 应用接入。

不要编造个人数据；不要用卧床间隔推算实际睡眠；不强制提醒优先级或截止日期；支持指定日期的近期日程，不自动重复，也不读取外部日历。一次明确用户请求可通过接口完成同步，电视会自动接收，不需要再点同步按钮。