SuperAPI AI 工具集

pp-restaurant365-odata

数据与分析

查看项目

更新于 10-16 01:32

技能介绍

用途:该技能驱动 restaurant365-odata-pp-cli 二进制,面向 Restaurant365 OData 提供只读的检查、导出、同步与分析能力。仅适用于读取类请求;创建、更新、删除、发布、评论、点赞、邀请、下单、发消息、预订、购买等任何变更远端状态的操作均不得使用。

安装与验证:先确认 CLI 已安装。推荐通过 npx -y @mvanhorn/printing-press-library install restaurant365-odata --cli-only 安装,macOS/Linux 默认二进制目录为 $HOME/.local/bin,Windows 为 %LOCALAPPDATA%\Programs\PrintingPress\bin,需确保该目录在 $PATH。若 npx 不可用,可改用 go install(需 Go 1.26.6+):go install github.com/mvanhorn/printing-press-library/library/commerce/restaurant365-odata/cmd/restaurant365-odata-pp-cli@latest。用 restaurant365-odata-pp-cli --version 验证。

认证:使用 HTTP Basic,需设置 RESTAURANT365_ODATA_USERNAME(通常为 domain\username 形式)、RESTAURANT365_ODATA_PASSWORD 与 RESTAURANT365_ODATA_BASE_URL(示例 https://odata.restaurant365.net/api/v2/views),也支持 R365_ODATA_* 短别名,或写入 ~/.config/restaurant365-odata-pp-cli/config.toml。可用 doctor 检查配置。

主要能力:list-views 列出文档化视图及字段数、日期字段、rowVersion 支持与建议同步模式;describe-view 输出某视图字段与 OData 类型;sample 安全抽样,默认脱敏,需显式加 --include-values 才含值;backfill-plan 生成请求计划,按 DateTimeOffset 窗口或 rowVersion 水位线拆分;deleted-records 检查 EntityDeleted 墓碑;export 导出有界切片(如 JSONL);sync、search 可离线使用本地 SQLite。还提供 company、employee、location、sales-detail、transaction、payroll-summary 等实体读取命令。可用 which "<能力描述>" 按自然语言查找命令。

用法要点:任意命令加 --agent 展开为 --json --compact --no-input --no-color --yes。输出被包裹为 {meta:{source, synced_at, reason}, results:...},数据取 .results,来源取 .meta.source。--select 可裁剪字段减少上下文;--dry-run 预览请求不发;--deliver 支持 stdout、file:<path>、webhook:<url>。支持命名 profile 保存常用参数,显式标志优先于 profile。Exit Code:0 成功、2 用法错误、3 资源未找到、4 需认证、5 API 错误、7 限流、10 配置错误。

建议与限制:私有租户应先使用 schema 或脱敏类命令;导出或同步销售、人力、薪资等日期窗口前先做回填计划;Transaction、TransactionDetail、EntityDeleted 使用 rowVersion 水位线;日期过滤使用 DateTimeOffset 边界而非裸日期。该 CLI 为只读,不得用于任何写入或变更操作。MCP 安装:go install github.com/mvanhorn/printing-press-library/library/commerce/restaurant365-odata/cmd/restaurant365-odata-pp-mcp@latest,并以 claude mcp add restaurant365-odata-pp-mcp -- restaurant365-odata-pp-mcp 注册。具体定价、平台覆盖等资料暂未提供。