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、登录、平台连通、当前目录

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

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

要点：

• 配置里永远没有密钥。 编程助手的入口是 stdio 形式的 guansd mcp（或 OAuth 的按应用 HTTP 入口）； 凭据全部在 ~/.guansd/credentials.json，随时可在控制台撤销（账号菜单 → 本地开发授权 / 各应用的 应用设置 → 本地开发）。
• 权限跟人走。 每次调用都实时核验你的团队成员身份与负责人身份；离开团队或被撤销即刻失效。
• 第一次用、还没有账号：guansd login 打开的页面里用手机号直接注册，接着创建（或加入）团队， 流程会自动接着走到授权页——不用回终端重跑。
• SSH / 无浏览器环境：guansd login 自动改用设备配对（RFC 8628）——终端显示短代码，在手机或任意 浏览器里确认即可（未登录会先登录；--device / --browser 可强制指定方式）。
• CI：GUANSD_TOKEN 环境变量优先于本机凭据（在控制台该应用的 应用设置 → 本地开发 生成长期令牌）。

发布半程也在终端里：guansd check（预检）→ guansd verify "主流程"（平台验收 AI 真浏览器验证， 要实际操作过才算数）→ guansd promote（发布正式版，需负责人在控制台开启开关）→ guansd rollback。 部署完追问两句：guansd runtime（此刻在不在跑；开发版还会报密钥/功能权限是否就绪）、 guansd history（版本历史，标出正在服务和可回滚的）、guansd verify --status（回看没等完的验证）。

查看类命令（apps / whoami / runtime / history / status / logs / check / verify --status）都支持 --json，原样输出接口返回，给脚本和编程助手用；guansd apps 一行一个应用：正式版在跑哪一版、开发版最近一次 部署怎么样、哪些功能还待授权、近 7 天几个人在用。任何命令后加 --help 看它的参数——只显示说明，不会执行 （认不出的参数会被拒绝，不会被静默忽略）。发布后 guansd promote 会直接列出这次上线仍待授权的功能。

全部命令：guansd help。