@tarot-ai/pixel 0.0.1

package/README.md

@@ -0,0 +1,49 @@
+# @tarot-ai/pixel
+
+`@tarot-ai/pixel` 是 Tarot Pixel 的 MCP Runtime，向兼容的 MCP Client
+提供本地设计稿读取、分析、渲染和资源生成能力。
+
+通常不需要单独启动该包，Tarot Pixel 的 Qoder 插件会固定 Runtime
+版本并自动建立 stdio MCP 连接。
+
+## 运行要求
+
+- Node.js 20.19.0 或更高版本。
+- npm 需要具备读取 `@tarot-ai/pixel` 的权限。
+- 截图和组合图片功能需要本机安装 Chrome、Chromium、Edge 或 Brave。
+
+## 手动启动
+
+```bash
+npx --yes --package=@tarot-ai/pixel@0.0.1 -- qoder-pixel
+```
+
+该命令启动 stdio MCP Server。标准输出仅用于 MCP 协议消息，运行日志写入标准错误或
+本地日志文件。
+
+MCP Client 可以使用以下配置：
+
+```json
+{
+  "mcpServers": {
+    "tarot-pixel": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["--yes", "--package=@tarot-ai/pixel@0.0.1", "--", "qoder-pixel"]
+    }
+  }
+}
+```
+
+生产环境应把示例版本替换为经过验证的精确版本，不建议直接使用 `latest`。
+
+## 数据与隐私
+
+- Runtime 默认在当前用户的本地数据目录保存设计稿、资源和渲染结果。
+- 包内不包含 npm token、设计工具凭据或用户密钥。
+- 本地 URL、资源 URI、数据目录和临时渲染路径不应提交到业务仓库。
+- 生成的资源应复制到目标项目后再由业务代码引用。
+
+## 许可证
+
+该包为专有软件，不授予开源许可。随包分发的第三方组件保留各自的许可证声明。