前言¶
售前、解決方案或內部成本評估時，經常要在控制台和價目頁之間來回切換，把「幾核幾 G、哪個地域、包年還是按量」翻譯成詢價參數。手工查一輪 CVM，再換產品查 CDB、Redis，容易漏項，也不方便把結果整理成給客戶看的報價單。
下面介紹 SkillHub 上的社區技能 騰訊雲價格查詢（座標 @user_2211ee67/tencent-cloud-product）。它把多類騰訊雲產品的中文描述解析成結構化參數，調用本地 Python 腳本或打包好的價格數據完成詢價，並支持生成 Excel 報價單。與單純讓模型去搜網頁價目相比，技能文檔要求 Agent 優先走本地腳本，減少幻覺和過時報價。
這是什麼¶
騰訊雲價格查詢 是基於通用 SKILL.md 格式的 Agent Skill，發佈在 SkillHub，來源爲 community，分類 business-ops，當前頁面版本 1.0.9，發佈者 user_2211ee67。SkillHub 標註 requires_api_key=true（需配置騰訊雲 API 密鑰）。頁面顯示評分 100000，下載 1082 次（數據取自 SkillHub 技能頁，會隨時間變化）。
技能包內 SKILL.md 作者字段爲 Blacknoisy。定位是：用自然語言或結構化輸入查詢騰訊雲多產品價格，並可生成報價單。
核心功能¶
已覈實支持的產品與能力如下（與官方簡介一致）：
| 產品 | 說明 |
|---|---|
| CVM | 雲服務器，包年包月 / 按量等 |
| CDB | 雲數據庫 MySQL |
| Redis | 分佈式緩存 |
| Lighthouse | 輕量應用服務器 |
| SQL Server | 關係型數據庫實例 |
| COS | 對象存儲 |
| CDN | 內容分發網絡 |
| IM / Push | 即時通信、消息推送 |
| TRTC | 實時音視頻 |
共性能力：
- 自然語言解析：各產品有對應的
scripts/parse_*_input.py，例如 CVM 用parse_input.py，CDB 用parse_cdb_input.py。 - 數量：全產品支持解析「幾臺 / 幾套 / 數量 n」，並按數量彙總總價。
- 報價單：
scripts/generate_quote.py可根據查詢結果生成 Excel；客戶公司、客戶經理等字段可按SKILL.md說明填寫或留空。 - 密鑰配置：複製
credentials.example.json爲credentials.json填入secretId、secretKey，或使用環境變量TCC_SECRET_ID、TCC_SECRET_KEY，也可兼容 TCCLI 配置。
執行策略（技能內「強制執行規則」）：
- 命中覆蓋範圍時，優先調用本地腳本，不要先聯網搜索。
- TRTC、IM、Push、CDN、COS 默認讀取技能包內
outputs/下的 JSON 價格文件，而非實時抓網頁；僅當本地數據缺失或損壞時再提示補文件或確認是否兜底。 - CVM、CDB、Redis、Lighthouse、SQL Server 等通過騰訊雲 Python SDK 調用對應詢價接口（如 CVM 的
InquiryPriceRunInstances），需有效密鑰與相應產品權限。
安裝與啓用¶
1. 安裝 SkillHub CLI（如尚未安裝）¶
command -v skillhub && skillhub --version
未安裝時可按 SkillHub 安裝文檔執行（完整安裝示例）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
文檔地址：https://skillhub.cn/install/skillhub.md
2. 安裝技能到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前客戶端識別的 skills 目錄。SkillHub 文檔給出的常見路徑：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝命令（與 skillhub search 輸出一致）：
skillhub install tencent-cloud-product --namespace user_2211ee67 --dir ~/.cursor/skills
也可在對話中讓 AI 按安裝說明執行：請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_2211ee67/tencent-cloud-product。
安裝完成後，一般需要重啓或重新加載當前 Agent，才能識別新技能。
3. 安裝 Python 依賴與密鑰¶
進入技能安裝目錄後：
pip install tencentcloud-sdk-python
複製並編輯密鑰文件：
cp credentials.example.json credentials.json
credentials.json 示例結構：
{
"secretId": "AKIDxxxxxxxxxxxxxxxx",
"secretKey": "xxxxxxxxxxxxxxxx"
}
請勿將真實密鑰提交到版本庫；技能說明中已將 credentials.json 列入忽略項。
典型用法¶
在對話中直接詢價¶
技能 trigger 列表包含多種中文表述，例如「南京地區 4 核 8g」「查詢 CVM 價格」「CDN 價格查詢」「生成報價單」等。啓用技能後，用自然語言描述地域、規格、時長即可；Agent 應按 SKILL.md 中的產品路由選擇腳本（CVM：parse_input.py + query_cvm_price.py；CDN：parse_cdn_input.py + query_cdn_price.py，其餘產品同理）。
詢價結束後，可追問「是否需要生成報價單？」，或直接輸入類似：報價單：雲服務器 4 核 8G 一年。
命令行復現（CVM）¶
在技能目錄下，先解析再詢價：
python3 scripts/parse_input.py "南京，SA5，4核8g，50g通用型ssd雲盤，1M包年包月帶寬，時長爲1年"
python3 scripts/query_cvm_price.py '{"region":"ap-nanjing","instance_type":"SA3.LARGE8","disk_size":50,"disk_type":"CLOUD_BSSD","bandwidth":1,"period":12,"charge_type":"PREPAID"}'
解析腳本會輸出地域、實例類型、磁盤類型、帶寬計費方式、period（月）等字段；缺參時技能要求向用戶補問硬盤、帶寬、時長等。
命令行復現（CDB）¶
python3 scripts/parse_cdb_input.py "南京 MySQL雲數據庫 4核8g 150g硬盤 一年多少錢"
python3 scripts/query_cdb_price.py tmp_params.json
命令行復現（Redis）¶
python3 scripts/parse_redis_input.py "查詢廣州地區 Redis 3個分片 分片容量4g 2個副本 1年的價格"
python3 scripts/query_redis_price.py '{"region":"ap-guangzhou","type_id":16,"mem_size":4096,"goods_num":1,"period":12,"billing_mode":1,"redis_shard_num":3,"redis_replicas_num":2,"product_version":"local"}'
報價單¶
在已有查詢結果的前提下，由 Agent 調用：
python3 scripts/generate_quote.py
（具體入參以技能目錄內腳本幫助或 SKILL.md 爲準；生成邏輯內置在腳本中，發佈包不依賴外部 Excel 模板。）
適用場景與注意¶
適合誰
- 需要在 Cursor、Claude Code、Codex 等環境中快速做騰訊雲多產品組合詢價的售前、架構師、運維或開發者。
- 希望用統一的中文話術驅動詢價，並偶爾導出報價單 Excel 的團隊。
限制與注意
- 密鑰與權限：未配置
credentials.json或環境變量時，依賴 API 的產品無法詢價；子賬號需具備對應產品 API 權限。CVM 使用前需已開通服務並完成實名認證（見SKILL.md「賬戶要求」）。 - 價格數據來源：CDN/COS/IM/Push/TRTC 依賴包內
outputs/快照，不等於官網實時價；CVM 等走 API 的結果也僅供參考，以控制台下單爲準。 - API 頻率：文檔提到默認約 10 次/秒 限制，批量比價需控制調用節奏。
- 計費語義：技能對「一年」與「帶寬按量」有明確規則（例如默認「一年」爲實例與帶寬均包年包月，除非用戶單獨說明帶寬按量），避免 Agent 誤讀爲全按量。
- 機型與可用區：CVM 須通過接口校驗可用區與機型可售性，技能不會自動替用戶改機型；失敗時應按提示換機型或地域。
結尾¶
經過上面的步驟，你可以在 Agent 裏用一句話覆蓋 CVM 到 TRTC 等多類騰訊雲詢價，並在需要時落到腳本與報價單。官方 SkillHub 頁面與 API 入口：
- 技能頁：https://www.skillhub.cn/skills/user_2211ee67/tencent-cloud-product
- API 座標：https://api.skillhub.cn/user_2211ee67/tencent-cloud-product
安裝與 skills 目錄說明：https://skillhub.cn/install/skillhub.md
