guansd（观思动 CLI）

观思动本地开发命令行：登录一次，在你自己的编程助手（Codex / Claude Code / Qoder / Trae / CodeBuddy / WorkBuddy …）里 查看应用、创建应用、拿到代码、推送并部署到开发版。WorkBuddy 用户也可以在它的连接器市场直接安装「观思动」连接器 （包源码在仓库的 packages/cli/workbuddy/），安装和登录都由 WorkBuddy 代劳。

npm i -g guansd        # 国内网络可加 --registry=https://registry.npmmirror.com
guansd login           # 浏览器授权一次；凭据只存本机 ~/.guansd（0600）。私有部署加 --origin
guansd setup           # 把平台接进本机已装的编程助手（--client qoder 只看某一个的说明）
guansd doctor          # 自检：环境、PATH、登录、平台连通、当前目录

前置：Node 20+ 和 git。只有「在本地把应用跑起来」需要一个数据库：默认起一个 Docker 容器（仓库里的 docker-compose.dev.yml）；没有 Docker 就用本机已有的 Postgres——node tools/local-up.mjs --postgres postgres://localhost:5432， 会为这份代码建两个专属库并记进 .env.local，以后照常 node tools/local-up.mjs run。

改完编程助手的 MCP 配置后要完全退出并重启它；重启后工具列表里出现「guansd」才算接好。 setup 生成的配置一律用绝对路径——GUI 启动的编辑器常常没有终端的 PATH，裸 guansd 会静默失败。

之后在任意助手里：create_app 建应用 → guansd clone org/slug 拿代码（凭证自动签发，无需再开浏览器）→ 改代码、git push origin work → deploy_dev / guansd deploy。仓库内的 AGENTS.md 带着助手跑完整个循环。

建应用时可以顺手把网址定了：guansd create 设备报修 --slug repair。网址标识在创建这一刻定死——后台预置会 把它写进域名、仓库和数据库，之后再改会被拒。不指定就按名称取拼音，常常二十几个字符 （设备报修与维保工单 → shebeibaoxiuyuweibaogongdan.<团队>.guansd.cn），所以想要短网址就在这一步给。

要点：

• 配置里永远没有密钥。 编程助手的入口是 stdio 形式的 guansd mcp（或 OAuth 的按应用 HTTP 入口）； 凭据全部在 ~/.guansd/credentials.json，随时可在控制台撤销（账号菜单 → 本地开发授权 / 各应用的 应用设置 → 本地开发）。
• 权限跟人走。 每次调用都实时核验你的团队成员身份与负责人身份；离开团队或被撤销即刻失效。
• 第一次用、还没有账号：guansd login 打开的页面里用手机号直接注册，接着创建（或加入）团队， 流程会自动接着走到授权页——不用回终端重跑。
• SSH / 无浏览器环境：guansd login 自动改用设备配对（RFC 8628）——终端显示短代码，在手机或任意 浏览器里确认即可（未登录会先登录；--device / --browser 可强制指定方式）。
• CI：GUANSD_TOKEN 环境变量优先于本机凭据（在控制台该应用的 应用设置 → 本地开发 生成长期令牌）。
• 运行反馈：每条命令结束后向平台发一条极简事件（命令名、成功/失败、错误码、耗时、版本、运行在哪个助手里），只有名称和代码，绝不含参数、输出或路径；平台管理员据此看出「登录后卡在哪一步」。设 GUANSD_NO_TELEMETRY=1 关闭。

发布半程也在终端里：guansd check（预检）→ guansd verify "主流程"（平台验收 AI 真浏览器验证， 要实际操作过才算数）→ guansd promote（发布正式版，需负责人在控制台开启开关）→ guansd rollback。 部署完追问两句：guansd runtime（此刻在不在跑；开发版还会报密钥/功能权限是否就绪）、 guansd history（版本历史，标出正在服务和可回滚的）、guansd verify --status（回看没等完的验证； verify --no-wait 发起后立即返回验证 id，shell 有超时限制时用）。数据本身：guansd schema（每张表的列、 主外键、索引——写 SELECT 前先看）、guansd query "<SELECT …>"（只读，最多 200 行；列名不存在时报错里附真实列名； --env prod 查正式版，需负责人开着「允许本地开发操作正式版」）。

查看类和部署类命令（apps / whoami / runtime / history / status / logs / check / schema / query / deploy / verify / promote / rollback）都支持 --json：成功时输出接口返回的 JSON；失败时输出带 error（服务端错误码）、message、httpStatus 的 JSON，退出码仍为 1——脚本和编程助手按 error 分支就行，不用解析 中文提示。guansd apps 一行一个应用：正式版在跑哪一版、开发版最近一次部署怎么样、哪些功能还待授权、近 7 天几个人 在用。任何命令后加 --help 看它的参数——只显示说明，不会执行（认不出的参数会被拒绝，不会被静默忽略）。发布后 guansd promote 会直接列出这次上线仍待授权的功能。

全部命令：guansd help。