sino-bc-cli 1.8.31-beta.2 → 1.8.31

package/README.md

@@ -185,20 +185,20 @@ Agent 在 API 域未知或有歧义时先选业务域，再选择一级目录对
 | `/schema` | 列出可调接口；`/schema <name>` 看入参 |
 | `/get-config` | 查看公开配置及 AT/RT 是否已配置，不显示令牌内容 |
 | `/set-config` | 交互隐藏输入 AT/RT、从非 TTY JSON 标准输入导入令牌，或写网关地址 |
-| `/auth` | `login` 浏览器登录；`status` 查看身份；`logout` 退出 |
+| `/auth` | `login` 浏览器登录；`status --json` 查看本地身份状态；`logout` 退出 |
 | `/tenant` | 仅 `list`：列出当前身份可用的签约主体 |
 | `/uninstall` | 清理技能、本机配置和身份；默认同时卸载全局包 |
 
-`/auth status` 只查看本地身份，不联网补查资料。本人资料有效期为成功补查后的 24 小时；`profileCache` 标明 `fresh`（有效）、`expired`（过期）或 `missing`（缺失）。过期资料不再作为当前资料展示，下次普通业务调用时按需补查，普通补查失败仍继续业务。主动查询本人或他人的资料只返回查询结果，不更新这份缓存。
+`sino-bc-cli /auth status --json` 在终端和自动化中都返回 JSON 信封，状态从 `data.localStatus` 读取，解释见 `data.message`。它只判断本地状态，不向服务器验证、不刷新令牌；正常业务调用会自动尝试续期，无需每次先查状态。`refresh_needed` 不表示已经刷新成功，也无需先登录。
 
-新登录成功或手动更换访问令牌会清除旧资料；同一身份续期、仅更新刷新令牌或修改网关地址不清资料，也不延长资料有效期。Passport 各主体独立计时，缓存不会替你选择主体。资料有效期只影响展示，不代表登录或接口权限有效期。
+`/get-config` 的 `exists=false` 只表示公开配置使用默认值；本人资料为空或过期也不表示未登录。状态含义、资料缓存和失败后的完整处理规则见通过 `/skill` 定位的 shared；鉴权失败优先读取 `error.params[].reason`，不能只凭 `token_expired` / `token_invalid` 重新登录。
 
 ```bash
 sino-bc-cli /init
 sino-bc-cli /skill
 sino-bc-cli /skill target add ~/my-agent/skills
 sino-bc-cli /auth login
-sino-bc-cli /auth status
+sino-bc-cli /auth status --json
 sino-bc-cli /tenant list
 sino-bc-cli /schema
 sino-bc-cli /schema biz-line-list
@@ -212,7 +212,7 @@ sino-bc-cli /uninstall --yes
 
 自动化导入时，由可信凭证提供程序向 `sino-bc-cli /set-config --stdin` 输送 JSON：`{"authToken":"…","refreshToken":"…"}`。也可只传 `authToken`（清除旧 RT），或在已有 AT 时只传 `refreshToken`（空字符串表示清除 RT）。不要把真实令牌放进命令行参数或终端历史。
 
-需要签约主体的接口，把 `/tenant list` 的主体 ID 和 `/auth status` 的认证上下文成对传入 `--corporation-id`、`--auth-context-id`。
+需要签约主体的接口，把 `/tenant list` 的主体 ID 和 `/auth status --json` 的 `data.authContextId` 成对传入 `--corporation-id`、`--auth-context-id`。
 
 ## 调用样例
 

package/dist/affordance/im.md

@@ -36,7 +36,8 @@
 
 - **WHEN**：分页查询群消息
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli im +page --data '{...}'`
+- **示例**：`sino-bc-cli im +page --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +replies
 
@@ -76,7 +77,8 @@
 
 - **WHEN**：业务项目告警
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli im +alert --data '{...}'`
+- **示例**：`sino-bc-cli im +alert --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## api
 

package/dist/affordance/project.md

@@ -292,13 +292,15 @@
 
 - **WHEN**：按飞书群查询关联项目
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli project +chat-projects --data '{...}'`
+- **示例**：`sino-bc-cli project +chat-projects --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +chats
 
 - **WHEN**：查询机器人所在飞书群
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli project +chats --data '{...}'`
+- **示例**：`sino-bc-cli project +chats --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## api
 

package/dist/api-doc/README.md

@@ -57,6 +57,8 @@ CLI 从平台密钥存储读取身份令牌（macOS/Linux 为 AES 密文，Windo
 
 TTY 默认表格，非 TTY 默认 JSON 信封。成功 stdout，失败 stderr；参数/配置错误退出码 2，一般 API 错误 1。上游响应由 CLI 解包到 data，不需要调用者重复解包。
 
+查看本地身份状态使用 `sino-bc-cli /auth status --json`，从成功信封的 `data.localStatus`、`data.message`、`data.authContextId` 读取。状态不验证服务端授权；正常业务调用会自动尝试续期，无需每次先查状态。资料为空或配置文件不存在均不能单独证明未登录；失败优先按最终 `error.params[].reason` 处理，完整规则见下方 shared。
+
 先读 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取主体绑定、高风险写确认或鉴权恢复等 references；`--yes` 不绕过身份或主体校验。可用 `sino-bc-cli /skill` 查询 shared 的真实文件路径。
 
 ## 维护同步

package/dist/api-doc/oapi/im.md

@@ -108,12 +108,16 @@ taskId / logId 二选一。
 
 `POST /sino-bc-nexus/lark/im/message/page`
 
-主体上下文：`tenant=false`。
+主体上下文：`tenant=true`。
 
 角色范围：`sso/passport/system`。
 
 风险：`read`。
 
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli im api lark-im-message-page --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
 必填 chatId。
 
 ### 日期字段说明（代码同步）
@@ -251,12 +255,16 @@ taskId / logId 二选一。
 
 `POST /sino-bc-nexus/lark/im/chat/project-unmatched/alert`
 
-主体上下文：`tenant=false`。
+主体上下文：`tenant=true`。
 
-角色范围：`sso/system`。
+角色范围：`sso`。
 
 风险：`write`。
 
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli im api lark-im-chat-project-unmatched-alert --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
 # 每日 Summary 群无法匹配项目告警
 
 
@@ -265,4 +273,3 @@ taskId / logId 二选一。
 | 字段 | 类型 | 位置 | 必填 | 说明 |
 | --- | --- | --- | --- | --- |
 | `chatId` | string | body | 是 | 无法匹配项目的飞书群ID；必填，最长128字符，发送前trim |
-| `description` | string | body | 否 | 报警描述 |

package/dist/api-doc/oapi/project.md

@@ -1034,12 +1034,16 @@
 
 `POST /sino-bc-nexus/project/chat/projects`
 
-主体上下文：`tenant=false`。
+主体上下文：`tenant=true`。
 
 角色范围：`sso/system`。
 
 风险：`read`。
 
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-chat-projects --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
 按飞书群 ID 查询当前签约主体下的有效项目绑定，并仅返回当前用户拥有 PROJECT_QUERY 权限的项目。结果为数组，不分页；未匹配到可查询项目时返回空数组。
 
 **输入参数（--data）**
@@ -1052,10 +1056,14 @@
 
 `POST /sino-bc-nexus/project/chat/chats`
 
-主体上下文：`tenant=false`。
+主体上下文：`tenant=true`。
 
 角色范围：`sso/system`。
 
 风险：`read`。
 
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli project api project-chat-chats --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
 查询当前用户身份所属飞书租户内，机器人仍在群内且未删除的群列表。返回全部匹配记录，不分页，不按项目或关键词筛选。

package/dist/generated/api-catalog.json

@@ -15152,7 +15152,7 @@
         ]
       }
     },
-    "tenant": false,
+    "tenant": true,
     "roleScope": [
       "sso",
       "system"
@@ -15198,7 +15198,7 @@
         ]
       }
     },
-    "tenant": false,
+    "tenant": true,
     "roleScope": [
       "sso",
       "system"
@@ -27619,7 +27619,7 @@
         }
       }
     },
-    "tenant": false,
+    "tenant": true,
     "roleScope": [
       "sso",
       "passport",
@@ -28309,11 +28309,6 @@
           "description": "无法匹配项目的飞书群ID；必填，最长128字符，发送前trim",
           "minLength": 1,
           "maxLength": 128
-        },
-        "description": {
-          "type": "string",
-          "title": "报警描述",
-          "description": "报警描述"
         }
       },
       "required": [
@@ -28325,10 +28320,9 @@
       "title": "无业务结果，result为空或省略；code=0表示处理成功，不保证飞书已送达",
       "description": "无业务结果，result为空或省略；code=0表示处理成功，不保证飞书已送达"
     },
-    "tenant": false,
+    "tenant": true,
     "roleScope": [
-      "sso",
-      "system"
+      "sso"
     ]
   },
   {