dsh-plugin-t-expert 0.4.26 → 0.4.37

package/data/experts/engineering/tencentcloud-api/skills/tcapi/SKILL.md

@@ -0,0 +1,298 @@
+---
+name: tcapi
+display_name: 腾讯云 API 助手
+description: Skill to call Cloud API for Tencent Cloud (腾讯云). Used for cloud automation or resource management. 当用户需要查询、创建、管理腾讯云资源，或执行云 API 自动化操作时触发。
+version: 1.0.0
+tags: [tccli, cloud-api, tencent-cloud, automation]
+keywords: [腾讯云, tccli, cloud api, 云资源, 云管理, 自动化运维]
+prompt_template: 对 {service} 产品执行 {action} 操作
+examples:
+  - 查询广州地域的 CVM 实例
+  - 创建一台按量计费的云服务器
+  - 查看 COS 存储桶列表
+---
+
+# 腾讯云 API 助手
+
+统一使用 **tccli** 命令行工具调用腾讯云 API，实现云资源的查询、创建、修改、删除等操作。
+
+## 适用场景
+
+- 云资源查询与管理（CVM / COS / CBS / VPC / TKE 等 200+ 产品）
+- 自动化运维（批量操作、定时任务、脚本编排）
+- 云 API 接口探索与文档检索
+
+## 不适用场景
+
+- 不支持 Terraform / Pulumi 等 IaC 编排工具
+- 不做多云管理（仅限腾讯云）
+- 不做费用充值、账号注册等非 API 操作
+
+## 前置条件
+
+- 已安装 tccli，未安装参考 [references/install.md](references/install.md)
+- 已完成凭证配置（详见下方「Step 2 凭证配置」）
+
+## 核心原则
+
+> 1. **优先检索最佳实践 → 再查接口文档 → 最后调用 API**。不要跳过文档检索直接调用，避免用错接口或遗漏参数。
+> 2. **在线文档是实时态，本地 tccli 是版本快照**。以在线文档（`cloudcache.tencentcs.com`）为准判断接口/参数是否存在；本地 tccli 因版本差异，可能缺少新接口、或残留已下线的旧接口。遇到本地报「无此接口」或服务端报「接口已下线」时，先查在线文档确认真实情况，再决定升级 tccli 或换用替代接口。
+
+## 执行流程
+
+### Step 0：环境自检（首次任务必做，一次探测串起所有分支）
+
+在真正调用业务接口前，先做一次探测，把环境状态判定清楚，避免中途反复失败：
+
+```sh
+# ① 是否安装 & 能否直接跑
+command -v tccli >/dev/null 2>&1 && tccli cvm DescribeRegions >/dev/null 2>&1 && echo "TCCLI_OK" || echo "TCCLI_NEED_CHECK"
+```
+
+判定分支：
+
+| 探测结果 | 状态 | 处理 |
+|:--------|:-----|:-----|
+| 返回 `TCCLI_OK` | 已安装、可运行、凭证有效 | 直接进入 Step 1 |
+| `command not found` | **未安装** | 引导安装（[references/install.md](references/install.md)）；若已装 Python 也可直接用 Step 5 兼容模式 |
+| `bad interpreter` / `No module named tccli` | **装了但 shebang/环境坏** | 切换 Step 5 兼容模式（动态探测 Python 调用），本会话后续统一使用 |
+| 报 `secretId is invalid` / `AuthFailure.SecretIdNotFound` | **凭证缺失** | 进入 Step 2 配置凭证 |
+
+> 探测通过（`TCCLI_OK`）后，本会话无需再重复自检，直接调用即可。
+
+### Step 1：检索 API 文档
+
+调用前先通过 curl + grep 检索业务、接口、最佳实践、数据结构。参考 [references/refs.md](references/refs.md) 获取完整检索方式。
+
+#### 1.1 发现业务
+
+检索 tccli 服务名（如 cvm、cbs）：
+
+```sh
+curl -s https://cloudcache.tencentcs.com/capi/refs/services.md | grep 云服务器
+```
+
+参考输出：
+
+```
+[cvm](service/cvm/index.md) | 云服务器 | 2017-03-12 | ...
+```
+
+#### 1.2 发现最佳实践
+
+优先检索是否有匹配当前场景的最佳实践：
+
+```sh
+curl -s https://cloudcache.tencentcs.com/capi/refs/service/cvm/practices.md | grep 重装
+```
+
+#### 1.3 检索接口
+
+若最佳实践未覆盖，在业务接口列表中检索（接口名即 tccli 的 `<Action>`）：
+
+```sh
+curl -s https://cloudcache.tencentcs.com/capi/refs/service/cvm/actions.md | grep "扩容\|磁盘"
+```
+
+#### 1.4 阅读接口文档
+
+获取参数说明和支持的地域信息：
+
+```sh
+curl -s https://cloudcache.tencentcs.com/capi/refs/service/cvm/action/ResizeInstanceDisks.md
+```
+
+#### 1.5 阅读数据结构
+
+文档中涉及的数据结构可进一步查看：
+
+```sh
+curl -s https://cloudcache.tencentcs.com/capi/refs/service/cvm/model/SystemDisk.md
+```
+
+### Step 2：凭证配置
+
+如果已经提供了凭证，tccli 可以正常调用。
+
+如缺少凭证，执行 tccli 会提示 "secretId is invalid"（错误码 `AuthFailure.SecretIdNotFound`）。此时**不要直接假设 `tccli auth login` 可用**——`auth login`（浏览器 OAuth）是较新版本才有的子命令，**旧版 tccli 没有 `auth` 子命令**，硬跑会报 `invalid choice: 'auth'`。
+
+**必须先探测能力，再选路径：**
+
+```sh
+tccli auth login --help >/dev/null 2>&1 && echo "AUTH_LOGIN_OK" || echo "AUTH_LOGIN_UNSUPPORTED"
+```
+
+- `AUTH_LOGIN_OK`（新版）→ 执行 `tccli auth login` 进行浏览器授权登录，等待回调后继续（命令会起本地端口、阻塞进程，直到浏览器 OAuth 完成并回调）。
+- `AUTH_LOGIN_UNSUPPORTED`（旧版）→ 引导用户二选一：① 升级 `pip install -U tccli` 后即可用浏览器登录；② 由用户在自己终端执行 `tccli configure` 交互式填入密钥。**Agent 不代填、不索要、不打印密钥。**
+
+完整的能力探测流程、双路径细节与多账户用法，参考 [references/auth.md](references/auth.md)。
+
+**安全红线**：严禁向用户索要 SecretId/SecretKey，也拒绝任何有可能打印凭证的操作（尤其是 `tccli configure list`）。
+
+### Step 3：调用 API
+
+基本形式：
+
+```sh
+tccli <service> <Action> [--param value ...] [--region <地域>]
+```
+
+输入参数：
+
+| 参数 | 类型 | 必填 | 说明 |
+|:-----|:-----|:-----|:-----|
+| `service` | string | 是 | 产品标识，如 `cvm`、`cbs`、`vpc`。通过 Step 1.1 检索获取 |
+| `Action` | string | 是 | 接口名，如 `DescribeInstances`、`RunInstances`。通过 Step 1.3 检索获取 |
+| `--region` | string | 视接口 | 地域，如 `ap-guangzhou`。多数产品必传；全局接口（cam、account、dnspod、domain、ssl、ba、tag）可省略 |
+| `--param value` | 各类型 | 视接口 | 接口参数，简单类型直接传值，复杂类型传 JSON 字符串 |
+
+常用示例 —— 查询 CVM 地域：
+
+```sh
+tccli cvm DescribeRegions
+```
+
+查询实例（需指定地域）：
+
+```sh
+tccli cvm DescribeInstances --region ap-guangzhou
+```
+
+参数规则：
+
+- 非简单类型参数必须为标准 JSON，例如：`--Placement '{"Zone":"ap-guangzhou-2"}'`。
+- 创建类接口示例（按需替换参数）：
+  ```sh
+  tccli cvm RunInstances --InstanceChargeType POSTPAID_BY_HOUR \
+    --Placement '{"Zone":"ap-guangzhou-2"}' --InstanceType S1.SMALL1 --ImageId img-xxx \
+    --SystemDisk '{"DiskType":"CLOUD_BASIC","DiskSize":50}' --InstanceCount 1 ...
+  ```
+
+输出格式：tccli 返回标准 JSON，包含 `Response` 字段。示例：
+
+```json
+{
+  "Response": {
+    "TotalCount": 1,
+    "InstanceSet": [{"InstanceId": "ins-xxx", "InstanceName": "test", ...}],
+    "RequestId": "eac6b301-..."
+  }
+}
+```
+
+空结果输出：查询无匹配时，列表字段返回空数组，计数字段为 0：
+
+```json
+{
+  "Response": {
+    "TotalCount": 0,
+    "InstanceSet": [],
+    "RequestId": "eac6b301-..."
+  }
+}
+```
+
+效率约束：腾讯云 API 默认限频为 **10 次/秒**（部分接口更低），批量操作时需控制调用频率，避免触发 `RequestLimitExceeded`。建议串行调用或加间隔，不要并发轰炸。
+
+避免并行调用：tccli 当前并行调用存在配置文件竞争问题，会导致响应失败。当前请逐个接口调用。
+
+### 本地参数强转陷阱（type coercion）
+
+部分 tccli 版本会按本地 schema 把某些参数强制类型转换后再发出，与云端期望不符，导致"永远 InvalidParameter"但用户参数其实填对了——这是**本地 tccli 的锅，不是用户的锅**：
+
+- **典型信号**：服务端返回 `InvalidParameter`，message 指向"参数 X 取值类型错误 / 应为 date"等，但你传入的值语义上是对的。例如 TRTC 某些日期参数被本地标成 `Timestamp` 强转整数时间戳，云端实际要 `YYYY-MM-DD` 纯日期。
+- **识别**：先 `tccli <svc> <Action> --help` 看参数类型标注；若本地类型是 Timestamp/Integer 而在线文档写的是 Date/String，基本可确诊。
+- **缓解（按优先级）**：
+  1. 查在线文档确认参数真实类型与格式（必要时用纯日期而非时间戳）；
+  2. 试 `--cli-unfold-arguments` 让 tccli 不再做本地合并/转换；
+  3. 若仍被本地强转卡死，绕过 tccli 用 Python SDK（`tencentcloud-sdk-python`）直连，把原始值（如纯日期字符串）原样赋给请求参数发出，即可通过云端类型校验。
+- **重要**：这类 `InvalidParameter` 是"假参数错"，不要甩锅给用户参数填错。
+
+### Step 3.5：输出解析规范（stdout/stderr 分流与 JSON 健壮性）
+
+tccli 的 stdout 与 stderr 是两条独立流，解析时必须严格区分，否则会把警告/错误文本当结果吞掉导致解析崩溃。
+
+**① 分流捕获，禁止盲目 `2>&1`**
+- 正常调用只解析 stdout；stderr 单独落盘便于诊断：
+  ```sh
+  tccli <service> <Action> [--region <地域>] 2>/tmp/tccli_err.log
+  ```
+- 不要把 `2>&1` 当作习惯写法——一旦 tccli 把 `WARNING` / `DeprecationWarning` / 版本提示吐到 stderr，合并流会让 stdout 前被塞入非 JSON 文本，导致 `json.loads` 直接崩溃。
+
+**② 解析前"抠 JSON"**
+- 即便做了分流，也先用正则提取首个 `{` 到末个 `}` 的闭区间（或 `[...]`）再 `json.loads`，避免前后缀文本（版本提示、空格、回车）导致失败：
+  ```python
+  import re, json
+  m = re.search(r'\{.*\}|\[.*\]', raw, re.DOTALL)
+  data = json.loads(m.group(0)) if m else None
+  ```
+
+**③ 解析失败兜底（不抛 Traceback）**
+- 若 stdout 无法解析为 JSON：提示"输出非预期 JSON"，并回显原始 stdout 前 N 字符供诊断，而非抛出 Python 堆栈。
+- 若 stdout 无 JSON 而 stderr 含异常信息，按以下规则解析：
+  - **锚点优先**：以 `[TencentCloudSDKException]` 为唯一权威锚点提取 `code` / `message` / `requestId`，**忽略同行 stderr 里 `usage:` 帮助块等噪音**（它们常与异常挤在同一段，不能"出现 usage 就判参数错"而误伤）。
+  - **区分本地错 vs 服务端错**：有 `requestId` → 服务端已受理并返回（如 `InvalidParameter` / `InternalError` / `UnauthorizedOperation`）；无 `requestId` 且只有 `usage:` → 本地 argparse 参数解析错，与云端无关。
+  - 优雅翻译为可读错误（见 Step 4 异常表），不要退化为崩溃。
+- 注意：服务端报错、权限拒绝、接口下线等异常大多落在 **stderr**，分离流是正确翻译错误码的前置条件。
+
+### Step 4：异常处理
+
+调用失败时，tccli 会返回包含 `Error` 字段的 JSON：
+
+```json
+{
+  "Response": {
+    "Error": { "Code": "AuthFailure.SecretIdNotFound", "Message": "secretId is invalid" },
+    "RequestId": "xxx"
+  }
+}
+```
+
+常见错误及处理：
+
+| 错误码 | 含义 | 处理方式 |
+|:------|:-----|:---------|
+| `AuthFailure.SecretIdNotFound` | 凭证缺失或无效 | 先探测 `tccli auth login --help`：支持则 `tccli auth login`；不支持（旧版）则升级 `pip install -U tccli` 或引导用户 `tccli configure`（详见 Step 2 / references/auth.md） |
+| `AuthFailure.UnauthorizedOperation` | 无权限 | 检查 CAM 策略，确认子账号有该接口权限 |
+| `InvalidParameterValue` | 参数值不合法 | 查阅接口文档确认参数取值范围 |
+| `ResourceNotFound` | 资源不存在 | 确认资源 ID 和地域是否正确 |
+| `RequestLimitExceeded` | 请求频率超限 | 等待后重试，或减少并发调用频率 |
+| `UnsupportedOperation` / `DeprecatedOperation` / `InvalidAction` | 接口已下线/更名，或本地版本认得但云端已淘汰 | 检索在线文档确认现行接口，改用替代接口；勿死磕旧接口 |
+| 本地 `invalid choice: 'XxxAction'` / argparse 报错，非服务端返回 | **旧版 tccli 本地缺少该新接口**（发布快照落后于云端） | 引导 `pip install -U tccli` 升级；或先查在线文档确认接口存在后再操作 |
+| `DryRunOperation` | DryRun 操作成功 | 非真实错误，表示参数校验通过 |
+| `UnsupportedRegion` | 不支持的地域 | 查阅接口文档确认支持的地域列表 |
+| `ResourceInsufficient` | 资源不足 | 换可用区或调整规格重试 |
+| 网络超时 / 连接失败 | 网络不通 | 检查网络连通性，确认是否需要代理 |
+| `InternalError`（message 含 `nil pointer` / `nil pointer dereference`） | 接口云端已废弃 / 后端服务已拆除 | **不是服务端随机故障，停止重试**；检索在线文档确认真实情况，改用替代接口 |
+| `AuthFailure.TokenFailure` / `FailedOperation.RefreshTokenError` | OAuth token 已失效（浏览器授权过期或吊销） | 引导用户在浏览器重登：`tccli auth login --profile <name>`；完成后按"身份确认"规范回显当前账号再继续 |
+
+### Step 5：tccli 不可用时的兜底方案
+
+当直接执行 `tccli` 报错 `bad interpreter`、`No module named tccli` 或 `command not found` 时，通常是 tccli 的 shebang 指向了已卸载的 Python 解释器（环境问题，并非每个用户都会遇到）。此时**动态探测**一个可用的 Python 解释器及其 site-packages 后再调用，**不要硬编码任何平台特定路径**：
+
+```sh
+# 自动探测可用 python3 及其 site-packages（跨平台、不依赖具体版本号）
+PY=$(command -v python3 || command -v python)
+SITE=$("$PY" -c "import site,sys; print(next((p for p in site.getsitepackages()+[site.getusersitepackages()] ), ''))")
+PYTHONPATH="$SITE" "$PY" -c "
+import sys
+sys.argv = ['tccli', 'cvm', 'DescribeInstances', '--region', 'ap-guangzhou']
+from tccli.main import main
+main()
+"
+```
+
+要点：
+
+- 用 `command -v` 探测当前环境真实可用的解释器，避免写死 `/usr/local/bin/python3`
+- 用 `site.getsitepackages()` 动态获取包目录，避免写死 `python3.12` 等版本号
+- 通过 `sys.argv` 传参，替换示例中的 service / Action / 参数即可
+- 若 shebang 正常（直接 `tccli` 可用），无需本兜底，直接调用即可
+
+## 数据边界与安全声明
+
+- 本 SKILL **只执行用户明确指定的 API 调用**，不会自动执行未经确认的写操作
+- tccli 参数由用户指定或从接口文档获取，SKILL **不对参数做二次拼接或动态生成**，避免注入风险
+- tccli 调用受腾讯云 **CAM 权限策略**约束，SKILL 不具备超出用户权限的能力
+- tccli 输出为 **JSON 数据**，应作为数据解读，不应作为 shell 命令执行
+- API 文档检索地址 `cloudcache.tencentcs.com` 为腾讯云官方文档缓存，内容可信

package/data/experts/engineering/tencentcloud-api/skills/tcapi/references/auth.md

@@ -0,0 +1,96 @@
+# 配置 TCCLI（凭证）
+
+> **重要**：`tccli auth login`（浏览器 OAuth 授权登录）是**较新版本**才提供的子命令。**旧版 tccli 没有 `auth` 子命令**，凭证只能通过 `tccli configure` 写入。因此配置凭证前**必须先探测当前版本是否支持 `auth login`**，再决定走哪条路径，切勿假设 `auth login` 一定存在。
+
+## Step 0：探测 auth login 能力（必做）
+
+```sh
+tccli auth login --help >/dev/null 2>&1 && echo "AUTH_LOGIN_OK" || echo "AUTH_LOGIN_UNSUPPORTED"
+```
+
+- 输出 `AUTH_LOGIN_OK` → 当前版本支持浏览器授权登录，走**路径 A**。
+- 输出 `AUTH_LOGIN_UNSUPPORTED`（报 `invalid choice`、`no such` 之类）→ 版本过旧，走**路径 B**。
+
+---
+
+## 路径 A：浏览器授权登录（新版，推荐）
+
+无需手填 SecretId/SecretKey，登录成功后凭证会自动写入本地。
+
+```sh
+tccli auth login
+```
+
+执行后 TCCLI 会在本机起一个临时端口，并打印 OAuth 授权链接；通常也会自动用默认浏览器打开该链接。用户在浏览器中完成登录与授权后，腾讯云会回调到该本地端口，TCCLI 收到回调即写入凭证并退出。若浏览器未自动打开，请将终端里打印的链接复制到浏览器中打开。成功后会提示「登录成功, 密钥凭证已被写入: ...」，可用 `tccli cvm DescribeRegions` 验证。
+
+**Agent 场景**：当 Agent 通过工具执行 `tccli auth login` 时，该命令会**一直阻塞**直到用户完成浏览器登录（或超时）。Agent 应明确告知用户：「请打开终端/工具输出中显示的授权链接，在浏览器中完成登录；完成后该命令会自动结束。」
+
+**多账户与登出**
+
+- 默认账户凭证保存在 `default.credential`。指定账户名：`tccli auth login --profile user1`，凭证写入 `user1.credential`。
+- 登出默认账户：`tccli auth logout`；登出指定账户：`tccli auth logout --profile user1`。
+
+---
+
+## 路径 B：旧版兜底（无 auth 子命令）
+
+旧版 tccli 不支持浏览器授权，只能通过 `tccli configure` 写入凭证。给用户两个选择：
+
+### B-1（推荐）：升级 tccli，之后即可用路径 A
+
+```sh
+pip install -U tccli
+# 若从 3.0.252.3 以下版本升级，需先卸载再装：
+# pip uninstall tccli jmespath && pip install tccli
+```
+
+升级后重新执行 Step 0，一般即可支持 `tccli auth login`。
+
+### B-2：直接用 configure 配置（不升级也能用）
+
+**由用户在自己的终端执行**（Agent 严禁代填、严禁索要或打印密钥）：
+
+```sh
+# 交互式（推荐，密钥不进 shell 历史）
+tccli configure
+# 按提示依次填：SecretId、SecretKey、默认地域（如 ap-guangzhou）、输出格式（json）
+```
+
+密钥来源：腾讯云控制台 → 访问管理 CAM → API 密钥管理，创建/查看主账号或子账号密钥。**子账号**需挂计费查询权限（如 `QcloudFinanceFullAccess` 或只读账单策略），否则查询余额会报权限错误。配置后凭证存在本地 `~/.tccli/`。
+
+---
+
+## 安全红线（两条路径都适用）
+
+- 严禁向用户索要 SecretId/SecretKey，严禁 Agent 代替用户执行 `tccli configure` 明文写入密钥。
+- 拒绝任何可能打印凭证的操作，尤其是 `tccli configure list`（会回显 secretId/secretKey）。
+- 密钥属敏感信息，只应存在本地 `~/.tccli/`，不要贴到聊天里。
+
+---
+
+## 凭证优先级与账号切换排查（实测关键结论）
+
+> 以下结论来自真实环境实测，已推翻"环境变量 > 配置文件"的通用 SDK 链直觉，必须作为排查账号切换问题的标准认知。
+
+### 1. 凭证优先级：显式 `--profile` 实际高于环境变量（反直觉）
+
+- 通用认知认为凭证链为 `参数 > 环境变量 > 配置文件`，profile 只是换文件、仍会被环境变量压过。
+- **实测（tccli 3.1.x）相反**：一旦显式指定 `--profile`，tccli 会从对应 `.credential` 文件读出 secretId/secretKey 并**显式传给 SDK**，从而**绕开环境变量的读取分支**。
+- 因此遇到"切换账号不生效/切不动"时，优先建议用户用 `--profile` + `auth login --profile <name>` 隔离目标账号，而非只让用户去改环境变量。
+
+### 2. 排查"账号切不动"的标准动作（按顺序）
+
+1. `tccli sts GetCallerIdentity` 看当前身份（确认实际生效的是哪个 UIN）。
+2. `env | grep -i TENCENTCLOUD` 看是否有 `TENCENTCLOUD_SECRET_ID` / `TENCENTCLOUD_SECRET_KEY` 环境变量覆盖。
+3. 检查 `~/.tccli/` 下有哪些 profile 及 `.credential`（`ls ~/.tccli/`）。
+4. 若"带环境变量时不带 --profile 返回旧账号、带 --profile 返回新账号" → 确诊"环境变量干扰"，给出方案：统一用 `--profile <name>` 隔离（推荐），或当前 shell `unset TENCENTCLOUD_SECRET_ID TENCENTCLOUD_SECRET_KEY`，或单条命令 `env -u TENCENTCLOUD_SECRET_ID -u TENCENTCLOUD_SECRET_KEY tccli ...`。
+
+### 3. 识别"父进程注入的环境变量"
+
+- 当环境变量出现在进程 env 中、却搜遍 `~/.zshrc` / `.zprofile` / `.zshenv` / `launchctl` / `~/Library/LaunchAgents` 都找不到来源时，**应判断为启动当前工具/IDE 进程的父进程注入**，并沿进程树继承给所有子进程。
+- 此类变量不落盘于任何文件，改 shell 配置无法清除；不要引导用户去改永远改不掉的地方，直接给"用 --profile 隔离"或"在该工具/IDE 的启动环境里清除"的建议。
+
+### 4. 避免假阳性排查
+
+- 用 `launchctl getenv X && echo "存在"` 这类写法，空字符串也会让退出码为 0，从而**误报"存在"**。应显示变量实际取值再判断。
+- 递归 `grep ~` 遍历家目录易超时中断（退出码 137），应限定目录或加超时处理。

package/data/experts/engineering/tencentcloud-api/skills/tcapi/references/install.md

@@ -0,0 +1,27 @@
+# 安装 TCCLI
+
+**前提**：系统已安装 Python 2.7+ 与 pip。TCCLI 依赖 TencentCloudApi Python SDK，安装时会自动处理依赖。
+
+**安装方式**：
+
+```sh
+# 方式一：pip（推荐，Windows / Mac / Linux 通用）
+pip install tccli
+
+# 若从 3.0.252.3 以下版本升级，需先卸载再装：
+# pip uninstall tccli jmespath && pip install tccli
+
+# 方式二：macOS Homebrew
+brew tap tencentcloud/tccli
+brew install tccli
+# 更新：brew upgrade tccli
+
+# 方式三：源码安装
+# git clone https://github.com/TencentCloud/tencentcloud-cli.git && cd tencentcloud-cli && python setup.py install
+```
+
+验证安装：
+
+```sh
+tccli --version
+```

package/data/experts/engineering/tencentcloud-api/skills/tcapi/references/refs.md

@@ -0,0 +1,49 @@
+# 信息库检索步骤与示例
+
+通过 curl + grep 检索业务、接口、最佳实践、数据结构。入口与结构见 SKILL.md「信息库」节。
+
+## 发现业务
+
+确定对应的 tccli 服务名（如 cvm、cbs）。
+
+```sh
+curl -s https://cloudcache.tencentcs.com/capi/refs/services.md | grep 云服务器
+```
+
+参考输出：
+
+```
+[cvm](service/cvm/index.md) | 云服务器 | 2017-03-12 | ...
+```
+
+## 检索业务最佳实践
+
+优先检索是否有匹配当前场景的最佳实践。
+
+```sh
+curl -s https://cloudcache.tencentcs.com/capi/refs/service/cvm/practices.md | grep 重装
+```
+
+## 检索接口
+
+若最佳实践未覆盖，在业务接口列表中检索（接口名即 tccli 的 <Action>）。
+
+```sh
+curl -s https://cloudcache.tencentcs.com/capi/refs/service/cvm/actions.md | grep "扩容\|磁盘"
+```
+
+## 阅读接口文档
+
+确认参数、地域、版本（tccli 一般自动匹配版本）：
+
+```sh
+curl -s https://cloudcache.tencentcs.com/capi/refs/service/cvm/action/ResizeInstanceDisks.md
+```
+
+## 阅读数据结构
+
+文档中涉及的数据结构可进一步查看：
+
+```sh
+curl -s https://cloudcache.tencentcs.com/capi/refs/service/cvm/model/SystemDisk.md
+```

package/data/experts/engineering/tiderider-sentiment/.codebuddy-plugin/plugin.json

@@ -0,0 +1,74 @@
+{
+  "name": "tiderider-sentiment",
+  "version": "1.2.2",
+  "description": "DataBrain X TideRider unified game-opinion expert: TideRider deep-analysis lane (anomaly attribution, Steam profiling, topic/version trends, bug-library radar, reports) plus DataBrain quick-metrics lane (single-value metrics, hot posts, alerts, competitor events, content trends, crawler), fronted by a single intent-routing agent",
+  "author": {
+    "name": "TideRider Team",
+    "email": "tiderider@example.com"
+  },
+  "expertType": "agent",
+  "agentName": "tiderider-analyst",
+  "agents": [
+    "./agents/tiderider-analyst.md"
+  ],
+  "skills": [
+    "./skills/bigquery-sentiment",
+    "./skills/steam-deep-analysis",
+    "./skills/bug-radar",
+    "./skills/databrain-opinion-metrics",
+    "./skills/databrain-opinion-summary",
+    "./skills/databrain-opinion-hotposts",
+    "./skills/databrain-opinion-alert",
+    "./skills/databrain-competitor-events",
+    "./skills/databrain-game-content-trend",
+    "./skills/opinions-crawler"
+  ],
+  "displayName": {
+    "en": "DataBrain X TideRider",
+    "zh": "DataBrain X TideRider"
+  },
+  "profession": {
+    "en": "Game Sentiment Analyst",
+    "zh": "游戏舆情分析师"
+  },
+  "displayDescription": {
+    "en": "Game sentiment analyst via BigQuery: anomaly detection, topic attribution, trend reports.",
+    "zh": "游戏舆情分析师：基于多平台玩家评论，做异动归因、话题提取、版本趋势对比，并生成精品可视化分析报告。"
+  },
+  "avatar": "avatars/expert.png",
+  "categoryId": "04-DataAI",
+  "defaultInitPrompt": {
+    "zh": "帮我分析一下这款游戏最近一周的舆情",
+    "en": "Analyze the sentiment of this game over the past week"
+  },
+  "tags": [
+    {
+      "en": "Game Sentiment",
+      "zh": "游戏舆情"
+    },
+    {
+      "en": "Player Analysis",
+      "zh": "玩家分析"
+    },
+    {
+      "en": "BigQuery",
+      "zh": "数据智能"
+    }
+  ],
+  "quickPrompts": [
+    {
+      "en": "Analyze the sentiment of this game over the past week",
+      "zh": "帮我分析一下这款游戏最近一周的舆情"
+    },
+    {
+      "en": "Compare sentiment across game versions",
+      "zh": "帮我对比不同版本的舆情变化"
+    },
+    {
+      "en": "Deep-dive into player playtime segments",
+      "zh": "做一个玩家游玩时长分段的深度分析"
+    }
+  ],
+  "plugin": "tiderider-sentiment",
+  "dependencies": {}
+}

package/data/experts/engineering/tiderider-sentiment/.downloaded_at

@@ -0,0 +1 @@
+2026-09-29T03:25:13.322088+00:00

package/data/experts/engineering/tiderider-sentiment/.imported-from-workbuddy

@@ -0,0 +1,7 @@
+{
+  "plugin": "tiderider-sentiment",
+  "division": "engineering",
+  "categoryId": "04-DataAI",
+  "importedAt": "2026-09-29T12:42:08",
+  "source": "workbuddy expert marketplace (COS)"
+}

package/data/experts/engineering/tiderider-sentiment/CHANGELOG.md

@@ -0,0 +1,65 @@
+# Changelog
+
+本文件记录 `tiderider-sentiment` 专家包（DataBrain × TideRider 游戏舆情专家）的版本变更。
+遵循 [语义化版本](https://semver.org/lang/zh-CN/) 规范。
+
+---
+
+## [1.2.2] - 2026-08-13
+
+### 变更 / 方法论沉淀
+- **BigQuery 成本铁律补全（query-rules 第 2b 条）**：新增「时间分区 + UID 聚簇」双层裁剪与「单文本列」硬约束。游戏明确时必须按 `unified_edition_id` 聚簇过滤，实跑扫描再降 100–200x；明确提示 **dry-run 看不出聚簇收益（估算偏高、会误导），成本以实际 `total_bytes_billed` 为准**；禁止 `COALESCE` 双读文本列；取帖下评论时加 `comment_time` 宽松下界、不设上界（评论入库晚于发帖）。
+- **字段口径更正（Common Field Reference）**：
+  - `reviewer` = 作者昵称、约 100% 填充（更正早期"无作者字段"的误判），用于 KOL/作者聚合与引文归属；`follower_number` 取 `MAX` 不取 `SUM`。
+  - `comment_parent_id` 非 `-1` 时其值等于所回复主帖的 `comment_id`，可自连接构建「主帖 → 观众评论」评论树。
+  - `country='global'` 是**无地理信息兜底桶**（Discord/YouTube 等常无法定位发帖人），**非真实地区**——禁止当作第一大地区，应单列标注并按可定位行计算真实国别份额。
+
+### 说明
+- 本次为文档/方法论层面的知识沉淀，不改动任一 skill 的脚本行为；上述取数与口径规则同步存在于本地 `link-kol-sentiment-tracking` skill（link/kol/voice 三模式）的实测基准中。
+
+## [1.2.1] - 2026-07-31
+
+### 修复 / 合规
+- **埋点上报补齐 `platform` 字段**：按 DataBrain openskill 规范，在全部 skill 的埋点 `extInfo` 中补上 `platform=workbuddy`（与 `dataSource=skill` 平级），使上报满足 `source=skill + platform=workbuddy` 的要求。
+  - `databrain-competitor-events`：原有 `platform` 参数默认值 `""` → `workbuddy`（函数签名 + CLI 默认值统一常量化）。
+  - 其余 skill：新增常量 `_PLATFORM="workbuddy"` 并写入 `extInfo`。
+- 统一采用「skill 内埋点」方案：BigQuery 直连型 skill 不经过 DataBrain 下游网关，无法服务端代埋，故所有 skill 均在本地 `report_log.py` 上报（非阻塞后台线程，令牌缺失/异常时静默兜底，绝不影响主流程）。
+
+### 安全 / 打包
+- 分发包严格排除真实 `.env`、Service Account 私钥、`__pycache__/`、`.DS_Store` 等敏感与平台特定文件，仅保留 `.env.example` 占位模板。
+
+## [1.2.0] - 2026-07-30
+
+### 新增
+- **新增 `bug-radar` skill（Bug 库雷达）**：接入 TideRider Bug 库，支持
+  - 活跃技术问题 Top 榜（含分类、严重度、可解释综合分 Score）；
+  - 分类维度汇总（崩溃稳定性 / 账号付费 / 玩法 / 网络 / 性能等 9 类）；
+  - 升温预警（问题日增长率突增识别）；
+  - 单问题日趋势与生命周期；
+  - 证据引用（按互动度挑选代表性原文 + 来源链接）；
+  - 游戏覆盖探测。
+- **Bug × 舆情融合 playbook**：定义了「异动归因 / 综合报告 / 主动预警 / 内容侧 vs 质量侧拆分」四类融入时机，通过游戏 UID 对齐实现 Bug 与舆情数据的干净关联；分析师 agent 路由表同步登记 Bug 触发信号与联动信号。
+
+### 说明
+- Bug 库通道对连接方式有要求（需具备直连数据仓库的凭据）；不满足时优雅降级为纯舆情回答，不影响主流程。
+- 首批覆盖 Subway Surfers；数据管线扩展到其它游戏后自动可用（schema 通用、UID 已对齐）。
+
+## [1.1.1] - 2026-07-24
+
+### 变更
+- 移除内置的「太湖」环境令牌，令牌一律由用户本地 `.env` / 运行时注入提供，避免任何凭据随包分发。
+
+## [1.1.0] - 2026-07
+
+### 新增
+- DataBrain 快查车道多个 skill：单值指标、热帖、预警、竞品事件、内容趋势、舆情爬虫。
+- 统一意图路由 agent，将「TideRider 深度分析车道」与「DataBrain 快查车道」整合到单一入口。
+
+## [1.0.0] - 2026-06
+
+### 新增
+- 专家包首个版本：TideRider 舆情深度分析（异动归因、Steam 画像、话题/版本趋势、报告生成）。
+
+---
+
+> 数据源统一表述为 **DataBrain × TideRider**。对外文案不暴露任何底层库表名。