CanvasTTY 文档

CanvasTTY 是一个基于 Electron 的空间画布桌面，用于承载真实的本地终端和 AI 智能体 CLI 会话。本文档介绍如何运行 MVP、遵守进程与视觉契约，以及如何基于有真实数据源支撑的小组件进行扩展。

指南

指南	内容
快速开始	环境要求、本地启动、首个会话与验证命令
内置浏览器与审计日志	画布控制、设置、智能体访问、网站/文件边界、活动列表与持久化脱敏审计文件
安装、发布与本地数据	安装包格式、未签名预览版注意事项、凭据边界与发布检查
编写小组件	源码级扩展路径、视觉语言、进程边界与 AI 智能体任务简报
运行时插件	Manifest v1、权限、HOME 小组件、画布应用、独立窗口、播放器 media/playlist API、SDK 与安装流程
指标与遥测	订阅限额、会话 token 用量、数据源优先级、隐私、`stale` 状态与测试
安全策略	支持的版本、漏洞报告、本地数据边界、插件、媒体目录授权、浏览器存储与审计日志
更新日志	各版本面向用户的修复与功能

契约	改动以下内容前先阅读
架构	IPC、PTY/浏览器生命周期、持久化、进程职责、智能体传输或服务商适配器
UI 契约	Home、启动流程、Settings、画布行为、终端/浏览器卡片或视觉语义

CanvasTTY 已通过 manifest API v1 支持静态运行时插件。不受信任的 UI 保持在 sandbox iframe/窗口内，只能使用用户明确批准的能力。需要新增主进程服务的可信核心集成仍以源码级贡献方式随应用编译。

不得虚构会话状态、计数器、配额、token 用量、成本、倒计时或进度。必须使用真实的结构化数据源；当数据源无法给出答案时，应显示 loading、stale、unavailable 或 error。

CanvasTTY 基于 MIT 许可证发布。