vps-work 1.0.0

package/.well-known/skills/index.json

@@ -0,0 +1,203 @@
+{
+  "skills": [
+    {
+      "name": "vps-shared",
+      "description": "Vertu CLI 共用约定：登录、能力缓存、当前用户身份、数据查询与反馈。业务域技能开始前应先读本文件。",
+      "files": [
+        "skills/vps-shared/SKILL.md"
+      ]
+    },
+    {
+      "name": "vps-meeting",
+      "description": "查询会议录音、逐字稿、纪要、总结、章节、问答和待办。按本人、递归下属、全域或已授权的指定部门/人员控制访问。入口 `vps-work meeting +…`。触发词：会议、录音、逐字稿、会议纪要、会议总结、会议待办、谁说了什么。",
+      "files": [
+        "skills/vps-meeting/SKILL.md"
+      ]
+    },
+    {
+      "name": "sale-performance-query",
+      "description": "使用 `vps-work sales +…` 查询 Vertu 销售业绩、普通订单、订单财务全景、开票申请状态、正式发票、会计凭证、已对账销售收款和经销商经营数据。",
+      "files": [
+        "skills/sale-performance-query/SKILL.md",
+        "skills/sale-performance-query/references/vps-sales-entities.md",
+        "skills/sale-performance-query/references/vps-sales-shared-params.md",
+        "skills/sale-performance-query/references/vps-sales-headline-kpi.md",
+        "skills/sale-performance-query/references/vps-sales-account-orders.md",
+        "skills/sale-performance-query/references/vps-sales-invoice-attachments.md",
+        "skills/sale-performance-query/references/vps-sales-invoice-status.md",
+        "skills/sale-performance-query/references/vps-sales-order-finance.md",
+        "skills/sale-performance-query/references/vps-sales-order-logistics.md",
+        "skills/sale-performance-query/references/vps-sales-reconciled-receipts.md",
+        "skills/sale-performance-query/references/vps-sales-dealer-orders.md",
+        "skills/sale-performance-query/references/vps-sales-dealer-performance.md",
+        "skills/sale-performance-query/references/vps-sales-agent-five-suite.md",
+        "skills/sale-performance-query/references/vps-sales-dept-breakdown.md",
+        "skills/sale-performance-query/references/vps-sales-customer-mix.md",
+        "skills/sale-performance-query/references/vps-sales-customer-region.md",
+        "skills/sale-performance-query/references/vps-sales-dept-comparison.md",
+        "skills/sale-performance-query/references/vps-sales-target-achievement.md",
+        "skills/sale-performance-query/references/vps-sales-deposit-breakdown.md",
+        "skills/sale-performance-query/references/vps-sales-refund-summary.md",
+        "skills/sale-performance-query/references/vps-sales-service-sales.md",
+        "skills/sale-performance-query/references/vps-sales-daily-trend.md",
+        "skills/sale-performance-query/references/vps-sales-ranking.md",
+        "skills/sale-performance-query/references/vps-sales-per-person-kpi.md",
+        "skills/sale-performance-query/references/vps-sales-personal-okr.md",
+        "skills/sale-performance-query/references/vps-sales-team-pk.md"
+      ]
+    },
+    {
+      "name": "vps-store-management",
+      "description": "门店管理：查询国内渠道门店接待、进店客流、客户画像、意向商品、加微信、有效客户、产品触摸/试用与现场成交过程数据。入口 `vps-work store +reception`。",
+      "files": [
+        "skills/vps-store-management/SKILL.md",
+        "skills/vps-store-management/references/store-reception.md"
+      ]
+    },
+    {
+      "name": "vps-hr",
+      "description": "人力资源：当前用户身份、组织架构、内部在职员工、人员档案、上下级、岗位、工龄、合同、薪酬单据。用户询问公司在职员工、内部员工名单、在职人数或要求排除外部人员时使用。入口 `vps-work hr +…`。",
+      "files": [
+        "skills/vps-hr/SKILL.md"
+      ]
+    },
+    {
+      "name": "vps-product",
+      "description": "VPS 商品与供应链：商品销量、销额、订单数、IOT、折扣与趋势，以及普通库存、VSN 库存位置、价格、发货、齐套物料、机头库存、在库激活和异常 IMEI。",
+      "files": [
+        "skills/vps-product/SKILL.md"
+      ]
+    },
+    {
+      "name": "vps-device-abnormal-statistics",
+      "description": "查询设备在库激活与异常统计：按仓位查看库存、在途和异常 IMEI，并按 IMEI 下钻未处理异常原因；仅限具备 VPS 设备异常分析角色的员工。入口 `vps-work product +abnormal-…`。",
+      "files": [
+        "skills/vps-device-abnormal-statistics/SKILL.md",
+        "skills/vps-device-abnormal-statistics/references/api.md",
+        "skills/vps-device-abnormal-statistics/agents/openai.yaml"
+      ]
+    },
+    {
+      "name": "vps-im",
+      "description": "Vertu IM：读取与发送消息、私聊/群聊/组织群、群发、撤回、互动卡片、群成员管理、机器人、语音视频通话。当用户需要查看会话列表、读历史消息、监听新消息、给某人或某群发消息、群发通知、发审批卡片、撤回消息、建群拉人、管理机器人或发起通话时使用。入口 `vps-work im +…`。触发词：发消息、私聊、群聊、群发、通知、撤回、会话、历史消息、监听、机器人、语音通话、视频通话、IM。",
+      "files": [
+        "skills/vps-im/SKILL.md",
+        "skills/vps-im/references/vps-im-shared-params.md",
+        "skills/vps-im/references/vps-im-read.md",
+        "skills/vps-im/references/vps-im-send.md",
+        "skills/vps-im/references/vps-im-channels.md",
+        "skills/vps-im/references/vps-im-bots.md",
+        "skills/vps-im/references/vps-im-calls.md"
+      ]
+    },
+    {
+      "name": "vps-calendar",
+      "description": "查询、创建和修改 Vertu 日程，并管理日历与多人忙闲。用户要查看某段日期内我的日程、点名查看某个人的忙碌日程、查看指定日历、创建或调整日程，或为会议查多人空闲时间时使用。入口为 `vps-work calendar +…`。",
+      "files": [
+        "skills/vps-calendar/SKILL.md",
+        "skills/vps-calendar/agents/openai.yaml"
+      ]
+    },
+    {
+      "name": "vps-documents",
+      "description": "查询、读取、新建、重命名、复制、导出和共享 Vertu 企业云文档、智能表格与文件夹，并将文档卡片发送到当前 VPS IM 会话。用户提到云文档、V盘文档、企业文档、智能表格、创建文档、读取文档内容、查找文档、修改标题、复制文档、导出 Markdown、设置文档权限或把文档发到当前会话时使用。入口为 `vps-work docs +…`。",
+      "files": [
+        "skills/vps-documents/SKILL.md",
+        "skills/vps-documents/references/api.md",
+        "skills/vps-documents/agents/openai.yaml"
+      ]
+    },
+    {
+      "name": "vps-v-drive",
+      "description": "使用 `vps-work drive +…` 管理账号级云端 V盘中的普通文件和文件夹；文件内容存储于 OSS，并与 VPS Desktop、手机端共用同一份数据。",
+      "files": [
+        "skills/vps-v-drive/SKILL.md"
+      ]
+    },
+    {
+      "name": "vps-creative",
+      "description": "内容创作画布（创意工坊）AI 生成：生图/改图、生视频、文字转语音、AI 音乐、模型列表。返回可下载附件链接（image_url / video_url / url）。用户要求生成图片、画图、配图、生成视频、视频生成、文字转语音、TTS、配音、生成音乐、背景音乐、查可用模型时使用 `vps-work creative +…`。触发词：生图、生成图片、画图、改图、AI绘画、生成视频、生视频、视频生成、文字转语音、TTS、语音合成、配音、生成音乐、AI音乐、背景音乐、BGM、模型列表。",
+      "files": [
+        "skills/vps-creative/SKILL.md"
+      ]
+    },
+    {
+      "name": "vps-tools",
+      "description": "VPS 平台公共工具：按需解析用户附件，以及把本地文件上传到统一 OSS。附件默认读取原文件，复杂 PDF、Office、扫描件才由 Agent 调用 MinerU。",
+      "files": [
+        "skills/vps-tools/SKILL.md",
+        "skills/vps-tools/agents/openai.yaml"
+      ]
+    },
+    {
+      "name": "vps-current-user-identity",
+      "description": "适用场景：用户提到「我」「我的」「本人」「我自己」「我们部门」「本部门」「我的上级」「我的领导」「汇报对象」「我的销售订单 / 采购 / 审批 / 任务」「我创建的」「我负责的」「以我的名义」等任何一人称指代时使用。提供 3 条等价路径取当前身份：(1) CLI vps-work hr +me 一次性返回 user_id / partner_id / employee_id / department_id / department_chain / manager_user_id / company_id；(2) Domain DSL 宏 @me / @my_partner / @my_employee / @my_department / @company / @companies 可在各域命令的 domain 参数中直接用，无需先取身份；(3) vps-work auth status --json 极简身份（uid / login）。常见误区：禁止把 partner_id 当 user_id、禁止扫 res.users 找自己、禁止重复取身份。触发词：我、我的、本人、我自己、我们部门、本部门、我上级、我领导、汇报对象、当前用户、current user、@me、auth status、self identity、me。",
+      "files": [
+        "skills/vps-current-user-identity/SKILL.md"
+      ]
+    },
+    {
+      "name": "vps-daily-report-assistant",
+      "description": "面向 Vertu 日报系统的查询与提交。用户要查打卡未交日报名单、员工日报与个人 OKR、自己的日报、可汇报任务、提交今日日报、同步日报助手卡片时使用。入口 CLI 为 `vps-work report +…`，当前提供 `+checkin-missing`、`+user-summary`、`+mine`、`+tasks`、`+submit`、`+sync`。触发词：日报、未交日报、打卡未交、员工日报、个人 OKR、我的日报、日报任务、提交日报、同步日报助手、daily report。",
+      "files": [
+        "skills/vps-daily-report-assistant/SKILL.md"
+      ]
+    },
+    {
+      "name": "vps-daily-sales-report",
+      "description": "公司级全部门销售总览，含销售额/销量、新老客销售占比、已对账销售收款、环比/同比、部门目标达成率。通过 `vps-work sales +…` 取数。触发词：总销日报、公司日销、已对账收款、销售收款明细、新老客占比、环比、同比、部门达成率、全部门销售。",
+      "files": [
+        "skills/vps-daily-sales-report/SKILL.md"
+      ]
+    },
+    {
+      "name": "vps-task-management-assistant",
+      "description": "面向 Vertu 当前任务中心的项目、任务、待办、PDCA 协助人与个人/团队 OKR 查询和写操作。当用户提到项目进度、任务列表、未完成待办、给某人/自己创建待办或任务、完成待办、待办转任务、协助人代办、我的 OKR 时使用。入口 CLI 为 `vps-work task +…`，当前提供任务中心 `+tc-*` REST 命令与 `+my-okr`。触发词：任务管理、研发管理、项目、任务、待办、todo、创建待办、完成待办、待办转任务、任务中心、项目进度、未完成事项、负责人、协助人、代操作、我的 OKR、团队 OKR。",
+      "files": [
+        "skills/vps-task-management-assistant/SKILL.md"
+      ]
+    },
+    {
+      "name": "vps-hr-compensation-documents",
+      "description": "员工月度工资条只读查询（VPS 原生 HR，vps_tenant_payslips）。本人可查本人已发放工资条，企业管理员可查本企业成员。取数通过 `vps-work hr +payslip`。",
+      "files": [
+        "skills/vps-hr-compensation-documents/SKILL.md"
+      ]
+    },
+    {
+      "name": "vps-okr-management-assistant",
+      "description": "面向 Vertu OKR 的结构化取数与分析。部门使用 `vps-work okr +dept-okr`，员工使用 `+employee-okr`；支持按名称或 ID 过滤，周期必须为 YYYY-MM。当前 CLI 不提供 `+org-tree`、`+dept-objectives` 或 `--include-sub-departments`。",
+      "files": [
+        "skills/vps-okr-management-assistant/SKILL.md"
+      ]
+    },
+    {
+      "name": "vps-pending-approval-assistant",
+      "description": "提供 VPS 审批相关能力：`vps-work approval +wait` / `+my-submitted` / `+my-approved` 拉取待办与历史视图，`+logs` 看单证轨迹，`+pass` / `+refuse` 在明确意图下操作当前步骤。在用户查看待我审批、审批流、签核历史、我提交的审批、我已批过的单子、同意或驳回、统计待办类型或整理审批队列时使用。业务单据金额/明细等结构化取数由对应业务域 skill 负责，本技能不下钻业务表。",
+      "files": [
+        "skills/vps-pending-approval-assistant/SKILL.md"
+      ]
+    },
+    {
+      "name": "vps-sale-personnel-efficiency",
+      "description": "面向销售人效（人产、人均产出）、开单率、个人销售业绩查询、个人 OKR 达成、团队/个人 PK 排名等场景。开单率按开单工号数除以有个人业绩目标工号数；人产按业绩除以同一目标人数。两项固定排除国内渠道-国内代理与AI渠道-AI电商并披露排除项。查某人销售额直接用 personal_okr_achievement + salesperson_like。支持任意时间窗口，通过 `vps-work sales +…` 取数。触发词：人效、人产、人均产出、开单率、开单人数、销售业绩、个人业绩、个人 OKR、PK、销售榜单、个人达成率。",
+      "files": [
+        "skills/vps-sale-personnel-efficiency/SKILL.md"
+      ]
+    },
+    {
+      "name": "vps-work-onboard",
+      "description": "新机器安装 vps-work、登录、铺设公开 skill。触发词：装 vps-work、onboard、初始化 vps-work。",
+      "files": [
+        "skills/vps-work-onboard/SKILL.md"
+      ]
+    },
+    {
+      "name": "vps-work",
+      "description": "VPS Work CLI（npm 包 vps-work，全局命令 vps-work）的安装、登录、使用、升级与卸载引导。触发词：装 vps-work、命令找不到、auth login 报错、升级卸载、Agent skill 安装。",
+      "files": [
+        "skills/vps-work/SKILL.md"
+      ]
+    }
+  ]
+}

package/README.md

@@ -0,0 +1,315 @@
+# vps-work
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D20-green.svg)](https://nodejs.org/)
+[![npm version](https://img.shields.io/npm/v/vps-work.svg)](https://www.npmjs.com/package/vps-work)
+
+[安装](#安装与快速开始) · [AI Agent Skills](#agent-skills) · [认证](#认证) · [快捷命令](#快捷命令) · [进阶](#进阶用法) · [常见问题](#常见问题)
+
+VPS Work CLI 是 Vertu VPS 平台的官方命令行，命令名为 `vps-work`，**取代已弃用的 `vertu-cli`**。登录会话使用独立目录 `~/.vps-work` 与钥匙串服务名 `vps-work`；服务端只识别 `vps-work` 渠道，旧 `vertu-cli` 不再受支持。
+
+Skill 为静态文件，**安装 skill 无需登录**；业务取数需登录 Vertu 账号。
+
+- **npm 包**：[`vps-work`](https://www.npmjs.com/package/vps-work)
+- **全局命令**：`vps-work`（不提供 `vertu-cli` 别名）
+
+## 为什么选 vps-work？
+
+- **为 Agent 设计** — 域级 `SKILL.md` + `vps-work <域> +…` 快捷命令，参数与契约面向 AI 调用优化
+- **安装简单** — `npx vps-work@latest install` 装 CLI，并自动铺设到本机已检测到的 Agent 目录
+- **覆盖面广** — 销售、人资、产品供应链/价格、审批、任务/OKR、日报、IM/站内信/会议等
+- **三层粒度** — `catalog` 活目录 → `exec` 通用执行 → 本机 `+` 快捷命令糖衣
+- **凭据可控** — 系统钥匙串或 `~/.vps-work/config.json`；CI 可用 `VERTU_BOT_INBOUND_KEY` / App Key
+
+## 功能
+
+| 类别 | 能力 |
+|------|------|
+| **平台** | CLI 安装升级、`skill` 子命令、登录会话与 OSS 公共工具（**vps-work** / **vps-work-onboard** / **vps-tools**） |
+| **身份** | 当前用户、部门、上级与组织上下文（**vps-current-user-identity**） |
+| **销售与经营** | 公司总销日报、已对账销售收款、部门下钻、目标达成、OKR 达成、销售人效与 PK（**sale-performance-query** 等） |
+| **人力资源** | 组织架构、人员档案、上下级、岗位、工龄、合同、工资条（**vps-hr**） |
+| **产品与供应链** | 库存、商品价格、发货、齐套物料、机头库存、在库激活与异常 IMEI（**vps-product**、**vps-device-abnormal-statistics**） |
+| **内容创作** | AI 生图、生视频、文字转语音与音乐生成，返回可下载附件链接（**vps-creative**） |
+| **研发与 OKR** | 任务中心任务/待办、部门与个人 OKR（**vps-task-management-assistant**、**vps-okr**） |
+| **日报** | 打卡未交比对、统一日报查询、提交与助手同步（**vps-daily-report-assistant**） |
+| **审批** | 待办队列与处理指引（**vps-approval**） |
+| **协作** | 日程与日历、IM 消息及会话附件下载、站内信、会议录音与纪要（**vps-calendar** / **vps-im** / **vps-mail** / **vps-meeting**） |
+| **Agent 弹窗** | 向当前绑定用户的 VPS 手机端投递可配置的一次性弹窗 |
+| **V盘文件** | 与桌面端、手机端一致的账号级 OSS V盘（**vps-v-drive**） |
+
+完整 skill 列表：`vps-work skill list` 或仓库 [`skills/`](./skills/) 目录。
+
+## 安装与快速开始
+
+### 环境要求
+
+- **Node.js 20+**（`node -v`）
+- `npm` / `npx`
+
+### 快速开始（人类用户）
+
+> **给 AI 助手：** 若你正在帮用户安装，请直接执行 [快速开始（AI Agent）](#快速开始ai-agent) 中的步骤。
+
+#### 安装
+
+任选其一：
+
+```bash
+npx vps-work@latest install
+```
+
+```bash
+npm install -g vps-work@latest
+vps-work skill install --all --agent all   # 全局安装时如需补铺 skill
+```
+
+`install` 会在装包后**自动**把公开 skill 写入本机已存在的 Agent 目录；不需要时可加 `--no-skills`。
+
+业务 skill 目录名仍是 `vps-im` / `vps-hr` 等，`skill install` / `skill update` 覆盖式同步，并自动删除旧包遗留的 `vertu-cli` / `vertu-onboard` 引导 skill。
+
+#### 配置与使用
+
+以下账号密码登录仅供人工用户在交互终端执行。Agent / Bot / Hermes 应使用宿主注入的 app_key，不得执行登录命令或接触用户密码；Hermes 固定使用 `app_id=vertu-hermes-agent`。
+
+```bash
+vps-work auth login
+vps-work auth status
+vps-work sales +headline-kpi
+vps-work --help
+```
+
+默认连接 Vertu 正式环境；如需本地或测试环境，可用 `vps-work auth login --service-url` / `--base-url` 覆盖。更多示例见 [`USAGE.md`](./USAGE.md)、[`examples/README.md`](./examples/README.md)。
+
+`vertu-cli` 已弃用：安装 `vps-work` 后请执行 `npm uninstall -g vertu-cli` 并删除 `~/.vertu`。
+
+### 快速开始（AI Agent）
+
+以下步骤面向 AI Agent。Agent 不得执行账号密码登录或要求用户提供密码；宿主应在启动前完成 app_key 注入。
+
+**第 1 步 — 安装 CLI**
+
+```bash
+npx vps-work@latest install
+```
+
+**第 2 步 — 同步 Skills（若未自动铺设）**
+
+```bash
+vps-work skill list
+vps-work skill install --all --agent all
+```
+
+**第 3 步 — 验证宿主凭证**
+
+```bash
+vps-work auth status
+```
+
+**第 4 步 — 验证**
+
+```bash
+vps-work auth status
+vps-work --version
+vps-work sales +headline-kpi --validate-only
+vps-work hr +headcount --dry-run
+```
+
+升级 CLI 后覆盖同步 skill：`vps-work skill update`。
+
+#### 可选：先落盘 `vps-work-onboard` 再让 Agent 自举
+
+将 onboard skill 写到本机 Agent 目录（与装包无关，适合「只说一句话让 Agent 装好」）：
+
+macOS / Linux：
+
+```bash
+curl -fsSL https://unpkg.com/vps-work@latest/scripts/install-onboard-skill.sh | bash
+```
+
+Windows PowerShell：
+
+```powershell
+irm https://unpkg.com/vps-work@latest/scripts/install-onboard-skill.ps1 | iex
+```
+
+自定义 skill 源地址可设 `VERTU_ONBOARD_RAW`（默认从当前 npm 包版本拉取 `skills/vps-work-onboard/SKILL.md`）。然后对 Agent 说：**用 vps-work-onboard 把 vps-work 装好**。
+
+### 从源码安装（贡献者）
+
+需要本仓库源码时：
+
+```bash
+git clone https://gitee.com/he-linyan/vps-cli.git
+cd vps-cli
+cd packages/vps-work
+npm install && npm run build && npm link
+```
+
+`vps-work` npm 包位于 `packages/vps-work/`。直接维护包时：
+
+```bash
+cd packages/vps-work
+npm install
+npm run build
+```
+
+改 `packages/vps-work/src/` 后执行 `npm run build` 即可让已 `npm link` 的全局命令生效。
+
+## Agent Skills
+
+| Skill | 说明 |
+|-------|------|
+| `vps-shared` | 登录、身份、`+` 约定（其他业务 skill 的前置阅读） |
+| `vps-work` | CLI 安装、skill 子命令、排错 |
+| `vps-work-onboard` | 新机器：装 CLI、铺 skill、登录自检 |
+| `sale-performance-query` | 销售日报、部门 KPI、OKR 达成、人效与 PK |
+| `vps-hr` | 薪酬、工资条、人员信息 |
+| `vps-product` | 库存、商品价格、发货、齐套、机头库存，并路由设备异常查询 |
+| `vps-device-abnormal-statistics` | 仓位在库激活、异常 IMEI 与未处理异常原因下钻 |
+| `vps-creative` | 内容创作画布：AI 生图、生视频、文字转语音、音乐生成与模型列表 |
+| `vps-tools` | 平台公共工具：上传文件到 OSS，返回公开或限时签名访问地址 |
+| `vps-corporate` | 合作企业档案、文件用印、业务管理、规章制度及附件 |
+| `vps-approval` | 待办审批 |
+| `vps-daily-report-assistant` | 打卡未交比对、统一日报查询、提交与同步 |
+| `vps-task-management-assistant` | 任务中心任务、待办、PDCA 协助人、OKR |
+| `vps-documents` | 企业云文档、智能表格与文件夹的查询、创建、单元格更新、导出、共享及 VPS IM 卡片投递 |
+| `vps-v-drive` | 账号级 OSS V盘普通文件、文件夹、传输记录与回收站 |
+| `vps-im` / `vps-mail` / `vps-meeting` | IM 消息与会话附件原文件下载、站内信、会议录音与纪要 |
+
+```bash
+vps-work skill list
+vps-work skill install sale-performance-query vps-hr --agent cursor
+vps-work skill install --all --agent all
+vps-work skill update
+vps-work skill uninstall sale-performance-query --agent cursor
+```
+
+`--agent`：`cursor` / `claude` / `claude-code` / `trae` / `trae-cn` / `openclaw` / `hermes` / `all`。`--dir <path>` 可装到自定义目录（可重复）。布局说明见 [`skills/README.md`](./skills/README.md)。
+
+Agent 管理自己的个人技能使用带 `+` 的业务命令；它们复用宿主注入的 app_key，不需要临时令牌：
+
+```bash
+vps-work skill +create-personal --slug sales-follow-up --title "销售跟进" --description "生成客户跟进计划" --instructions @instructions.md
+vps-work skill +update-personal --slug sales-follow-up --skill-md @SKILL.md --note "补充输出格式"
+vps-work skill +change-category --slug sales-follow-up --category sales
+vps-work skill +request-publication --slug sales-follow-up --note "申请企业公开"
+vps-work skill +delete-personal --slug sales-follow-up
+```
+
+`+create-personal` 和 `+update-personal` 会自动补齐并校正 `SKILL.md` 的 YAML frontmatter，固定以 `--slug` 作为 `name`，同时保留其他 YAML 字段。`skill update` 仍表示同步随包公开技能，二者语义不变。
+
+## 认证
+
+| 命令 | 说明 |
+|------|------|
+| `vps-work auth login` | 登录 Vertu 账号，会话写入钥匙串或 `~/.vps-work/config.json` |
+| `vps-work auth logout [--forget]` | 登出；`--forget` 清理整个 profile |
+| `vps-work auth status [--json]` | 当前会话、企业 `tenant_type` / 产品包与凭据来源 |
+| `vps-work auth tenants` | 列出当前账号可访问的企业（仅人工/宿主切换） |
+| `vps-work auth use --tenant <uuid>` | 切换当前企业；Agent 不得自行执行 |
+| `vps-work catalog [--domain sales]` | 当前企业身份可见的活目录（服务端裁剪） |
+| `vps-work exec --skill <key> --script <key>` | 按 catalog 执行，不必为每个新脚本发 npm |
+| `vps-work install [--tag latest]` | 执行 `npm install -g vps-work@<tag>`（与 `npx vps-work@latest install` 等价） |
+
+CI / 自动化常用环境变量：`VERTU_BOT_INBOUND_KEY`（Bearer）、`VERTU_APP_ID` + `VERTU_APP_KEY`（App Key）。
+
+## 快捷命令
+
+域入口与 lark-cli 类似：**`<域> +<子命令>`**，支持 `--validate-only` / `--dry-run` 本地预览请求载荷；execute 类 shortcut 会直接打印 `skill_key` / `script_key` / `params`，不发网络请求。
+
+| 域 | 示例 |
+|----|------|
+| `sales` | `vps-work sales +headline-kpi` · `+orders` · `+reconciled-receipts` · `+dept-breakdown` · `+customer-mix` · `+target-achievement` · `+per-person-kpi` |
+| `hr` | `vps-work hr +me` · `+org-tree` · `+headcount` · `+profile` · `+subordinates` · `+manager` · `+job-details` · `+contracts` · `+payslip` |
+| `product` | `vps-work product +inventory` · `+price` · `+delivery` · `+kit-materials` · `+phone-head-inventory` · `+abnormal-location` · `+abnormal-location-list` · `+abnormal-details` |
+| `creative` | `vps-work creative +models` · `+image` · `+video` · `+video-status` · `+tts` · `+music` |
+| `corporate` | `vps-work corporate +partner-list` · `+seal-list` · `+business-list` · `+regulation-list` · `+attachments` |
+| `approval` | `vps-work approval +wait` · `+pending --scope department\|all` · `+pass` / `+reject` |
+| `task` | `vps-work task +tc-tasks` · `+tc-todos` · `+tc-todo-create` |
+| `okr` | `vps-work okr +org-tree` · `+dept-okr` |
+| `report` | `vps-work report +checkin-missing` · `+mine` · `+tasks` · `+submit` · `+sync` |
+| `calendar` | `vps-work calendar +mine` · `+person` · `+calendar` · `+create` · `+update` · `+response` · `+respond` · `+calendars` · `+availability` |
+| `docs` | `vps-work docs +list` · `+get` · `+create` · `+rename` · `+sheet-get` · `+sheet-set-cells` · `+share` · `+send` · `+duplicate` · `+export-markdown` |
+| `drive` | `vps-work drive +list` · `+mkdir` · `+create-file` · `+upload` · `+read` · `+write` · `+download` · `+move` · `+remove` · `+restore` |
+| `popup` | `vps-work popup +send --title "提醒" --content "正文"`；管理员可加 `--user-id` / `--login` 推送给他人 |
+| `im` / `mail` / `meeting` | `vps-work im +channels` · `+departments` · `mail +send` · `meeting +list`（轻量列表）· `meeting +detail`（单场详情）· `meeting +statistics`（会议、待办闭环、日程来源，可按部门/模版分组） |
+
+完整列表：`vps-work sales --help`（各域同理）。
+
+常见查询示例：
+
+```bash
+vps-work sales +dept-breakdown --period this_month --group-by dept_l1
+vps-work sales +customer-mix --period this_month
+vps-work sales +reconciled-receipts --order-types sale,service --invoiced true --limit 100
+vps-work sales +target-achievement --period this_month --params '{"group_by":"dept_l1","limit":500}'
+vps-work sales +dept-monthly-okr --period this_month --limit 100 --page 1
+vps-work hr +headcount
+vps-work hr +subordinates --direct
+vps-work corporate +partner-list --search "深圳"
+vps-work corporate +seal-list --kind contract --status finished
+vps-work corporate +seal-list --kind contract --end-date-from 2025-08-13 --end-date-to 2026-08-12 --all
+vps-work corporate +regulation-list
+vps-work product +inventory --product-subcategory "VERTU ALPHAFOLD" --product-material 小牛皮 --product-color 黑色 --group-by store_detail
+vps-work product +price --product-name "VERTU ALPHAFOLD-黑品质套装款-鳄鱼皮-樱花粉-1TB-国内" --limit 20
+vps-work product +price --product-subcategory "VERTU ALPHAFOLD" --product-material 鳄鱼皮 --price-region overseas
+vps-work product +abnormal-location --default-selected
+vps-work product +abnormal-details --imeis 860000000000001,860000000000002 --stat-date 2025-09-01 --end-date 2026-07-02
+```
+
+设备异常三个命令经 vps-service 鉴权代理访问，只允许授权中心已明确分配 `vps_device_abnormal_analyst`（VPS 设备异常分析）角色、具备 `product.device_abnormal:read` 的在职内部员工使用；外部/经销商账号和仅有 `admin:*` 的管理员不放行。
+
+部门销售目标默认使用管理端“部门业绩目标”相同的 `部门OKR_1` 数据；需要核对迁移后的 Postgres 目标表时显式传 `--okr-source postgres`。个人 OKR 仍默认使用 Postgres `vps_okr_*` 数据。
+
+## 进阶用法
+
+### 凭据与路径
+
+| 类型 | 默认位置 |
+|------|----------|
+| 钥匙串 | `service=vps-work`，`account=session:<base_url>` / `bearer:<base_url>` |
+| 配置文件（无钥匙串时） | `~/.vps-work/config.json`（Windows：`%USERPROFILE%\.vps-work\config.json`），权限 `0600` |
+| Skill 目录 | `~/.cursor/skills` · `~/.claude/skills` · `~/.trae/skills` · `~/.trae-cn/skills` · `~/.openclaw/skills` · `~/.hermes/skills` |
+
+### 环境变量
+
+| 变量 | 说明 |
+|------|------|
+| `VERTU_BOT_INBOUND_KEY` | Bot Bearer（CI） |
+| `VERTU_APP_ID` / `VERTU_APP_KEY` | Agent App Key |
+| `VERTU_DISABLE_KEYTAR=1` | 强制文件存储 |
+| `VERTU_DEBUG=1` | 调试输出 |
+
+### 升级 / 卸载
+
+```bash
+npm update -g vps-work
+npm uninstall -g vps-work
+```
+
+## 常见问题
+
+**1. `npm install` 时 keytar 编译失败？**
+keytar 为可选依赖。使用 `npm install -g vps-work --no-optional` 或设置 `VERTU_DISABLE_KEYTAR=1`，CLI 会降级到 `~/.vps-work/config.json`。
+
+**2. Trae 国际版与国内版 skill 目录冲突吗？**
+不冲突：国际版 `~/.trae/skills/`，国内版 `~/.trae-cn/skills/`。`skill install --all` 默认写入两者；只需其一时用 `--agent trae` 或 `--agent trae-cn`。
+
+**3. npm 上的 README 与仓库不一致？**
+以 [npm 包页](https://www.npmjs.com/package/vps-work) 与当前发布的 `README.md` 为准；源码协作见 Gitee 仓库 [he-linyan/vps-cli](https://gitee.com/he-linyan/vps-cli)。
+
+## 开发
+
+```bash
+npm install
+npm run dev -- --help
+npm run typecheck
+npm run lint
+npm test
+npm run build
+```
+
+## 许可证
+
+MIT