安装
npx @lark-project/meegle@latest install适合谁
如果你已经在用 Meegle（飞书项目），希望在终端管理工项、排期和数据，而不必打开浏览器，这个工具对得上。它是 Meegle 的命令行工具，说明页见
https://github.com/larksuite/meegle-cli
更合适的人已经有可登录的 Meegle 空间，本机 Node.js 不低于 16（自带 npm / npx），并且接受只走官方这一条安装命令。安装向导会：全局安装或升级 CLI、装上附带的 AI Agent Skill、配置 Meegle 主机，并启动登录。这四步都会改本机环境，适合愿意在本机完成授权的人。
若你只想在网页里点工项、并不打算装全局命令行或让 agent 调项目数据，就不必走这条向导。官方写明向导会把附带技能装进若干编程环境，也写了其他 agent；不要把点名理解成排他名单，也不要另找未记载的市场安装。第一次请做只读查看，而不是创建或改排期。向导把 CLI 与技能绑在同一次安装里，不能只拷技能文件夹来跳过登录。没有 Meegle 主机地址和可登录账号时，先准备这两样，再执行 npx。
3 分钟完成第一次尝试
只走官方这一条安装路径：
npx @lark-project/meegle@latest install
不要改写成 skills add、插件或市场指令。执行前先确认：本机 Node.js >= 16；你准备在本机全局安装 CLI；你愿意接着配置主机并完成登录。这四件事有副作用，先看向导将写入的位置和要登录的主机，确认后再继续。
装完后重启你要用的 agent，确认附带技能已出现。官方没有写出技能的斜杠命令或 CLI 子命令清单，第一次触发以向导装进去的技能名称为准。
在已登录、技能可见的 agent 里，做一次低风险任务：请它只读查看若干工作项或当前排期，先列出将调用的命令或技能名、是否写入本地、会不会改 Meegle 上的字段。你确认纯读取后，再允许它查询。
成功信号：终端或对话里出现来自 Meegle 的工作项或排期数据，而不再要求打开浏览器。若向导停在登录页，先完成主机配置和登录，不要换成未记载的安装包名。若技能未出现，重启 agent，并确认向导已走到安装技能那一步。若它要求打开浏览器才能读数据，说明登录或主机未完成，回到向导，而不是再装一遍别的包。
使用案例
案例一：在终端查看工作项。官方能力是管理工项、排期和数据。第一次只做查看：指定一个你有权看的空间或视图，让附带技能或 CLI 读出工项标题与状态。页面没有给出具体子命令拼写，缺了就问已安装的技能“只读列出工作项”，不要臆造 meegle xxx。任何创建、指派、关单动作都先停在计划步骤。
案例二：查看排期与数据，仍不改浏览器流程。同一句话把 schedules 和 data 与 work items 并列。做法是对同一空间读排期或字段数据，用于核对日历，而不是改日期。登录未完成时不要跑。官方没有写导出格式或批量改期接口；没写到的批量更新不要做。两条案例都建立在向导已经装好 CLI、技能、主机并完成登录之后，不是第二套安装。若对话里出现未在说明页出现的子命令，先对照向导装入的技能说明，对不上就不要执行。
使用边界
运行要求是 Node.js >= 16，并带有 npm / npx。低于该版本不要强行改安装命令。向导会全局安装或升级 CLI、写入技能、配置主机并启动登录；你不能只“装技能、不登录”还指望读到空间数据。
官方安装只有 npx @lark-project/meegle@latest install。不要发明第二条 skills add 或插件市场路径。介绍里点到的环境名称不是唯一可用名单；未点名的环境既不被保证也不被排除，以向导实际写入的位置为准。
管理工项和排期会碰到写操作。没有确认前，只允许读取。官方没有列出子命令表，也没有写出登出、卸载或多主机切换的步骤；缺了这些，就停在向导已完成的范围里。不要把产品主页或飞书项目介绍页当成第二条安装地址。全局升级 CLI 可能覆盖旧版本，执行向导前先确认你接受升级。登录会打开授权流程，在不信任的机器上不要跑。