@yosai/cli 0.0.0-stage → 0.2.0

package/dist/skills/yos-transcript/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: yos-transcript
+description: YOS 录音转写查询（transcript list 列表 / transcript detail 详情，含分段、纪要、思维导图、音频地址与字段坑）。用户想看会议录音转写、要纪要、查某次会议内容时使用
+---
+
+# YOS 录音转写（transcript）
+
+只读两个命令：`list` 拿记录 ID，`detail` 拿全文。**CLI 不提供转写正文的检索入口**，`retrieve` 域查不到会议内容。
+
+## 1. `transcript list` — 我的转写
+
+```bash
+yos transcript list                                    # 第 1 页，10 条
+yos transcript list --json                             # 需要 transcriptionUserId 时必须用这个
+yos transcript list --keyword 节前周会 --json           # 只匹配标题（不搜正文）
+yos transcript list --relation owner --json            # owner=我建的 / shared=别人分享的
+yos transcript list --start 2026-09-28 --end 2026-10-10 --json   # 必须 yyyy-MM-dd
+yos transcript list --page 2 --size 20 --json          # size 上限 50
+yos transcript list --status summarized --json          # 状态过滤（合法值见下）
+```
+
+| flag | 工具参数 | 说明 | 缺省 |
+|---|---|---|---|
+| `--page` | `page` | ≥1 | 1 |
+| `--size` | `size` | 每页条数，1~50；越界 → `错误: --size 超过上限 50：1000`（exit 2） | 10 |
+| `--status` | `status` | `recording`（录制中/转写中）\| `recorded`（待总结）\| `summarizing`（总结中）\| `summarized`（总结完成，实测 `statusName: 总结完成`）。非法值 → `错误: --status 取值非法：xxx` + `提示: 可选：recording / recorded / summarizing / summarized`（exit 2） | 不过滤 |
+| `--relation` | `relation_type` | `owner`（我创建）\| `shared`（他人分享给我）\| `all`（实测记录里 `relationType: "owner"`）。非法值 → exit 2 | `all` |
+| `--keyword` | `keyword` | **只按标题匹配**，正文/纪要里的词搜不到（实测：某词在纪要 JSON 中出现 6 次，但 `--keyword` 结果 `total=0`） | 无 |
+| `--start` / `--end` | `start_date` / `end_date` | 格式严格 `yyyy-MM-dd`，含当日；中文时间表达由 CLI 本地拒绝：`错误: --start 日期格式应为 yyyy-MM-dd：本周`；起晚于止 → `错误: 日期区间非法：--start 晚于 --end` + `提示: 起 … 应不晚于止 …`（均 exit 2，不发请求） | 无 |
+
+真实响应（注意：分页壳与 `kb list` 不同，用 `list` 字段而非 `records`）：
+
+```json
+{"current":1,"size":10,"pages":7,"total":67,"list":[
+  {"transcriptionUserId":"2105108032979103745","transcriptionCode":"TT00006601","title":"节前周会",
+   "transcriptionType":"realtime","status":"summarized","statusName":"总结完成",
+   "totalDurationMs":1778346,"createTime":"2026-09-30 09:30:40","creatorName":"张三","relationType":"owner"}]}
+```
+
+- 列表字段是 **`list`**，分页字段为 `current` / `size` / `pages` / `total`（`pages` 即总页数）；与 `kb list` / `upgrade-log` 的 `records` / `page` 壳不同，解析时不要套用
+- `transcriptionType` 实测值 `realtime`（实时录音）；时长 `totalDurationMs` 是毫秒，向用户表述要换算成分钟
+- **失败状态的记录恒被服务端排除**，在 CLI 里永远看不到，用户问「今天那个转写失败的会议」时直接说明该记录不可见，不要反复换过滤条件找
+- 不加 `--json` 也输出同一段 JSON 原文（本域没有人类渲染）
+
+## 2. `transcript detail` — 取全文与纪要
+
+```bash
+yos transcript detail 2105108032979103745 --json
+```
+
+位置参数是 **`transcriptionUserId`（19 位纯数字，来自返回体 `list[].transcriptionUserId` 字段）**，不是 `TT` 开头的 `transcriptionCode`：
+
+```
+$ yos transcript detail TT00006601
+错误: 转写归属记录 ID 需为数字，实际收到：TT00006601
+提示: TT 开头的是转写编码，本命令需要对应的数字 ID                 # exit 2，不发请求
+```
+
+真实响应字段（`--json` 二次解析后）：
+
+| 字段 | 形态与用途 |
+|---|---|
+| `summary` | **Markdown 字符串**（实测 3202 字），结构为「一、核心结论 / 二、整体概述 / 关键决策展开」。可直接落盘或摘录，是回答「这次会说了什么」的首选 |
+| `sentences[]` | 逐句：`globalStartMs` / `globalEndMs` / `speakerName` / `speakerLabel` / 文本。实测某会议 154 句 |
+| `speakers[]` | 仅 `userCode` / `userName` |
+| `mindMap` | **双重编码 JSON 字符串**（形如 `"{\"children\":[...]}"`），需再 `JSON.parse` 一次才能用；不解析就当它是空 |
+| `audioUrl` | COS 预签名下载地址（原音频可下载，注意有效期） |
+| `transcriptionCode` / `title` / `status` | 与 list 一致 |
+
+说话人可信度（表述时必须带保留）：
+
+- `speakerLabel`（声纹聚类编号）与人名是**多对多**：实测 label `3` 同时对应「张三/李四/王五/说话人」四个名字，label `1` 对应三个
+- 实测 154 句里 **41 句（27%）`speakerName` 是未解析的「说话人」**
+- 没有 `speakerLabel ↔ userCode` 的映射字段，也没有按说话人/时间戳过滤的参数：要「某人说了什么」就拉全量 `sentences` 在本地按 `speakerName` 过滤，并向用户说明未识别句段可能存在
+- 说话人纠错、纪要编辑 CLI 都不支持（转写域仅两个工具），需要改动请引导用户到客户端
+
+非「已完成」状态的转写调 `detail` 会被服务端拒绝（转写中/失败不可读）。
+
+## 3. 标准流程
+
+```bash
+yos transcript list --json                                  # 1. 取 transcriptionUserId
+yos transcript list --keyword '<标题关键词>' --json          #    或按标题缩小；--start/--end 缩小日期范围
+yos transcript detail 2105108032979103745 --json             # 2. 取纪要与逐句
+#                                          3. 回答：先给 summary 要点，需举证时引用 sentences 的毫秒时间戳（换算成 mm:ss）
+```
+
+「最近一次会议」= `list` 首条（实测按时间新在前），但用户给的是主题词时优先 `--keyword` + 标题人工确认，不要凭顺序猜是哪场会。
+
+## 4. 做不到的事
+
+不检索转写正文（`--keyword` 只搜标题）；不按说话人或时间点过滤；不导出（自行把 `summary` 落盘）；不查询转写进度；不纠错说话人、不改纪要；看不到失败记录。有这类诉求用 `yos support feedback '<诉求>'` 记录。

package/dist/tool-domains.js

@@ -0,0 +1,38 @@
+const DOMAIN_ORDER = [
+    '知识库管理',
+    'cortex 检索原语',
+    '帮助手册与客户端升级',
+    '转写查询',
+    '用户反馈',
+    '其他',
+];
+function matchDomain(name) {
+    if (name.startsWith('retrieve_')) {
+        return 'cortex 检索原语';
+    }
+    if (name.startsWith('kb_') || name.startsWith('docs_')) {
+        return '知识库管理';
+    }
+    if (name.startsWith('support_feedback')) {
+        return '用户反馈';
+    }
+    if (name.startsWith('support_')) {
+        return '帮助手册与客户端升级';
+    }
+    if (name.startsWith('transcript_')) {
+        return '转写查询';
+    }
+    return '其他';
+}
+export function groupTools(tools) {
+    const buckets = new Map();
+    for (const tool of tools) {
+        const domain = matchDomain(tool.name);
+        const list = buckets.get(domain) ?? [];
+        list.push(tool);
+        buckets.set(domain, list);
+    }
+    return DOMAIN_ORDER
+        .map((domain) => ({ domain, tools: buckets.get(domain) ?? [] }))
+        .filter((group) => group.tools.length > 0);
+}

package/dist/version-state.js

@@ -0,0 +1,30 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { configDir } from './config.js';
+function versionStatePath() {
+    return join(configDir(), 'version-state');
+}
+export function loadVersionState() {
+    const path = versionStatePath();
+    if (!existsSync(path)) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        if (typeof parsed.version !== 'string' || parsed.version === '') {
+            return null;
+        }
+        return {
+            version: parsed.version,
+            updatedAt: typeof parsed.updatedAt === 'string' ? parsed.updatedAt : '',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function saveVersionState(version) {
+    mkdirSync(configDir(), { recursive: true, mode: 0o700 });
+    const state = { version, updatedAt: new Date().toISOString() };
+    writeFileSync(versionStatePath(), `${JSON.stringify(state, null, 2)}\n`, { mode: 0o600 });
+}

package/package.json

@@ -1,6 +1,32 @@
 {
   "name": "@yosai/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "YOS 能力的 Agent 执行入口：工具调用、知识库管理与文件上传",
+  "type": "module",
+  "bin": {
+    "yos": "dist/index.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc && node scripts/copy-assets.mjs && chmod +x dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "release": "node scripts/release.mjs"
+  },
+  "license": "Apache-2.0",
+  "private": false,
+  "devDependencies": {
+    "@types/node": "^26.6.3",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.2"
+  }
+}