[{"data":1,"prerenderedAt":532},["ShallowReactive",2],{"integrations-zh:/zh/integrations/cli":3},{"id":4,"title":5,"active":6,"body":7,"description":517,"extension":518,"eyebrow":519,"icon":520,"image":521,"meta":522,"name":523,"navTitle":523,"navigation":6,"order":524,"path":525,"seo":526,"slug":527,"status":528,"stem":529,"summary":530,"toc":521,"__hash__":531},"integrations_zh/zh/integrations/cli.md","CLI 与 shell 脚本 + OpenPets",true,{"type":8,"value":9,"toc":499},"minimark",[10,128,154,260,305,365,392,449],[11,12,16,17,16,21,16,25,16,109],"section",{"id":13,"className":14},"overview",[15],"docs-section","\n  ",[18,19,20],"h2",{"id":20},"此集成的功能",[22,23,24],"p",{},"\n    OpenPets CLI 允许终端命令与正在运行的 OpenPets 桌面应用通信。当你希望通过 shell 脚本、npm 脚本、本地构建命令、git hook 或自定义自动化工具触发宠物反应时，可以使用它。\n  ",[26,27,30,31,16],"div",{"className":28},[29],"docs-table-wrap","\n    ",[32,33,34,35,34,52,30],"table",{},"\n      ",[36,37,38,39,34],"thead",{},"\n        ",[40,41,42,46,49],"tr",{},[43,44,45],"th",{},"命令",[43,47,48],{},"功能说明",[43,50,51],{},"适用场景",[53,54,38,55,38,70,38,83,38,96,34],"tbody",{},[40,56,57,64,67],{},[58,59,60],"td",{},[61,62,63],"code",{},"npx -y @open-pets/cli@latest status",[58,65,66],{},"检查桌面应用是否可达。",[58,68,69],{},"设置检查和故障排查。",[40,71,72,77,80],{},[58,73,74],{},[61,75,76],{},"npx -y @open-pets/cli@latest pets",[58,78,79],{},"列出已安装的宠物并标记默认宠物。",[58,81,82],{},"在路由设置前查找宠物 ID。",[40,84,85,90,93],{},[58,86,87],{},[61,88,89],{},"npx -y @open-pets/cli@latest react \u003Creaction>",[58,91,92],{},"在不显示文本的情况下更改宠物反应。",[58,94,95],{},"静默成功、错误、测试、等待或工作状态。",[40,97,98,103,106],{},[58,99,100],{},[61,101,102],{},"npx -y @open-pets/cli@latest say \u003Cmessage>",[58,104,105],{},"显示一条简短的可见对话气泡。",[58,107,108],{},"有意义的本地自动化状态更新。",[22,110,111,112,115,116,119,120,123,124,127],{},"\n    CLI 以 npm 包 ",[61,113,114],{},"@open-pets/cli"," 的形式分发。桌面应用不会安装 shell 命令；一次性命令可用 ",[61,117,118],{},"npx","，显式包执行可用 ",[61,121,122],{},"npm exec","，如果想要永久的 ",[61,125,126],{},"openpets"," 命令，也可以选择全局 npm 安装。\n  ",[11,129,16,132,16,135],{"id":130,"className":131},"requirements",[15],[18,133,134],{"id":134},"使用要求",[136,137,30,138,30,142,30,151,16],"ul",{},[139,140,141],"li",{},"OpenPets 桌面应用必须正在运行。",[139,143,144,145,147,148,150],{},"使用 ",[61,146,118],{},"、",[61,149,122],{}," 或可选全局 npm 安装时，必须有可用的 Node.js 和 npm。",[139,152,153],{},"CLI 通过 OpenPets 本地 IPC 与桌面应用通信，不通过云服务发送命令。",[11,155,16,158,16,162,16,168,16,188,16,203,16,219,16,235,16,244],{"id":156,"className":157},"quick-start",[15],[18,159,161],{"id":160},"使用-npx-快速开始","使用 npx 快速开始",[22,163,164,165,167],{},"\n    当你不想全局安装时，使用 ",[61,166,118],{},"。以下示例始终获取最新发布的 OpenPets CLI。\n  ",[26,169,30,172,30,183,16],{"className":170},[171],"docs-code",[26,173,176,180],{"className":174},[175],"docs-code-bar",[177,178,179],"span",{},"检查桌面状态",[177,181,182],{},"bash",[184,185,186],"pre",{},[61,187,63],{},[26,189,30,191,30,199,16],{"className":190},[171],[26,192,194,197],{"className":193},[175],[177,195,196],{},"列出已安装的宠物",[177,198,182],{},[184,200,201],{},[61,202,76],{},[26,204,30,206,30,214,16],{"className":205},[171],[26,207,209,212],{"className":208},[175],[177,210,211],{},"发送反应",[177,213,182],{},[184,215,216],{},[61,217,218],{},"npx -y @open-pets/cli@latest react success",[26,220,30,222,30,230,16],{"className":221},[171],[26,223,225,228],{"className":224},[175],[177,226,227],{},"显示简短消息",[177,229,182],{},[184,231,232],{},[61,233,234],{},"npx -y @open-pets/cli@latest say \"Build finished\" --reaction celebrating",[22,236,237,238,240,241,243],{},"\n    如果你的 npm 环境有过期的 ",[61,239,118],{}," 缓存元数据，等效的 ",[61,242,122],{}," 形式为：\n  ",[26,245,30,247,30,255,16],{"className":246},[171],[26,248,250,253],{"className":249},[175],[177,251,252],{},"npm exec 形式",[177,254,182],{},[184,256,257],{},[61,258,259],{},"npm exec --yes --package=@open-pets/cli@latest -- openpets --help",[11,261,16,264,16,267,16,273,16,289],{"id":262,"className":263},"global-install",[15],[18,265,266],{"id":266},"可选的全局安装",[22,268,269,270,272],{},"\n    如果你希望在终端直接输入 ",[61,271,126],{},"，可以全局安装 CLI。这与下载桌面应用是分开的操作。\n  ",[26,274,30,276,30,284,16],{"className":275},[171],[26,277,279,282],{"className":278},[175],[177,280,281],{},"一次性安装",[177,283,182],{},[184,285,286],{},[61,287,288],{},"npm install -g @open-pets/cli",[26,290,30,292,30,300,16],{"className":291},[171],[26,293,295,298],{"className":294},[175],[177,296,297],{},"直接使用",[177,299,182],{},[184,301,302],{},[61,303,304],{},"openpets status\nopenpets react testing\nopenpets say \"Tests are running\" --reaction testing",[11,306,16,309,16,313,16,316,16,332,16,348],{"id":307,"className":308},"script-examples",[15],[18,310,312],{"id":311},"shell-脚本示例","Shell 脚本示例",[22,314,315],{},"\n    保持消息简短且面向用户。对于嘈杂的步骤使用反应，仅在有意义的时刻使用语音。\n  ",[26,317,30,319,30,327,16],{"className":318},[171],[26,320,322,325],{"className":321},[175],[177,323,324],{},"npm test 通知",[177,326,182],{},[184,328,329],{},[61,330,331],{},"npm test \\\n  && npx -y @open-pets/cli@latest say \"Tests passed\" --reaction success \\\n  || npx -y @open-pets/cli@latest say \"Tests failed\" --reaction error",[26,333,30,335,30,343,16],{"className":334},[171],[26,336,338,341],{"className":337},[175],[177,339,340],{},"构建脚本",[177,342,182],{},[184,344,345],{},[61,346,347],{},"npx -y @open-pets/cli@latest react running\npnpm build\nnpx -y @open-pets/cli@latest react success",[26,349,30,351,30,360,16],{"className":350},[171],[26,352,354,357],{"className":353},[175],[177,355,356],{},"package.json 脚本",[177,358,359],{},"json",[184,361,362],{},[61,363,364],{},"{\n  \"scripts\": {\n    \"test:pet\": \"npm test && npx -y @open-pets/cli@latest say 'Tests passed' --reaction success\"\n  }\n}",[11,366,16,369,16,372,16,375],{"id":367,"className":368},"reactions",[15],[18,370,371],{"id":371},"可用反应",[22,373,374],{},"\n    CLI 接受与 OpenPets 本地客户端和 MCP 工具相同的反应名称：\n  ",[26,376,30,378,30,387,16],{"className":377},[171],[26,379,381,384],{"className":380},[175],[177,382,383],{},"反应名称",[177,385,386],{},"text",[184,388,389],{},[61,390,391],{},"idle\nthinking\nworking\nediting\nrunning\ntesting\nwaiting\nwaving\nsuccess\nerror\ncelebrating",[11,393,16,396,16,399,16,402],{"id":394,"className":395},"safety",[15],[18,397,398],{"id":398},"消息安全",[22,400,401],{},"\n    宠物语音在你的桌面上可见。将其视为一个微型公开状态频道，而非日志输出。\n  ",[26,403,30,405,16],{"className":404},[29],[32,406,34,407,34,417,30],{},[36,408,409],{},[40,410,411,414],{},[43,412,413],{},"良好示例",[43,415,416],{},"应避免的内容",[53,418,38,419,38,429,38,439,34],{},[40,420,421,426],{},[58,422,423],{},[61,424,425],{},"Build finished.",[58,427,428],{},"完整命令输出或错误堆栈。",[40,430,431,436],{},[58,432,433],{},[61,434,435],{},"Tests are running.",[58,437,438],{},"文件路径、URL 或私有仓库详情。",[40,440,441,446],{},[58,442,443],{},[61,444,445],{},"Waiting for review.",[58,447,448],{},"密钥、令牌、提示词或用户消息。",[11,450,16,453,16,456,16,463,16,477,16,481,16,493,16,496],{"id":451,"className":452},"troubleshooting",[15],[18,454,455],{"id":455},"故障排查",[457,458,460,462],"h3",{"id":459},"npx-y-open-petsclilatest-status-提示应用不可用",[61,461,63],{}," 提示应用不可用",[136,464,30,465,30,468,30,471,16],{},[139,466,467],{},"先打开 OpenPets 桌面应用。",[139,469,470],{},"如果桌面应用在运行时被更新，请重启它。",[139,472,473,474,476],{},"再次运行 ",[61,475,63],{},"。",[457,478,480],{"id":479},"桌面应用没有安装-shell-命令","桌面应用没有安装 shell 命令",[22,482,483,484,147,487,489,490,492],{},"\n    下载桌面应用不会安装 shell 命令。请使用 ",[61,485,486],{},"npx -y @open-pets/cli@latest ...",[61,488,122],{},"，或在需要永久命令时通过 npm 全局安装 ",[61,491,114],{},"。\n  ",[457,494,495],{"id":495},"反应名称被拒绝",[22,497,498],{},"\n    请使用上面列出的反应名称之一。CLI 在将反应名称发送到桌面应用之前会进行验证。\n  ",{"title":500,"searchDepth":501,"depth":501,"links":502},"",2,[503,504,505,506,507,508,509,510],{"id":20,"depth":501,"text":20},{"id":134,"depth":501,"text":134},{"id":160,"depth":501,"text":161},{"id":266,"depth":501,"text":266},{"id":311,"depth":501,"text":312},{"id":371,"depth":501,"text":371},{"id":398,"depth":501,"text":398},{"id":455,"depth":501,"text":455,"children":511},[512,515,516],{"id":459,"depth":513,"text":514},3,"npx -y @open-pets/cli@latest status 提示应用不可用",{"id":479,"depth":513,"text":480},{"id":495,"depth":513,"text":495},"使用已发布的 OpenPets npm CLI 检查桌面状态、列出宠物、发送反应、显示简短消息，并将 OpenPets 接入本地 shell 自动化流程。","md","npm CLI","fa6-solid:terminal",null,{},"CLI 与 shell 脚本",5,"/zh/integrations/cli",{"title":5,"description":517},"cli","已支持","zh/integrations/cli","通过 @open-pets/cli 在终端命令、npm 脚本、git hooks 和本地自动化中发送宠物反应和简短消息。","SLnGyf4_f7fup_u8yzxND1eYwIrIbrGgD0xCBSzAYEI",1779284856848]