smh-api-ai

让 AI 编程助手更懂腾讯云智能媒资托管（SMH）。安装后，你的 AI 助手（CodeBuddy、Cursor、Claude Code、codex）在接入 SMH 时能稳定生成安全、可运行、可追溯官方来源的代码。

它是面向外部开发者的 AI 接入辅助包，不是 SDK，也不会调用真实 SMH API 或接触你的密钥；只提升 AI 生成接入代码的质量。实际调用仍使用官方 SDK / API。

一期重点覆盖完整网盘接入主路径：业务用户绑定 Space、后端签发 / 缓存 / 续期 AccessToken、最小权限 grant、客户端上传 / 下载 / 列表 / 移动 / 复制 / 搜索 / 回收站，LibrarySecret 严格留在服务端。

安装

在你的项目根目录执行（Node.js ≥ 16）：

# 按你使用的 IDE 选择 --ide
npx smh-api-ai@latest init --ide codebuddy --mcp
npx smh-api-ai@latest init --ide cursor --mcp
npx smh-api-ai@latest init --ide claude --mcp
npx smh-api-ai@latest init --ide codex --mcp
# 或一次性装到所有支持的 IDE
npx smh-api-ai@latest init --ide all --mcp

默认安装 规则 + 技能 + 本地知识库；加 --mcp 才写入只读 MCP 配置。可用 --rules / --skills 精确控制。

常用命令：

npx smh-api-ai@latest doctor                 # 检查安装
npx smh-api-ai@latest update --ide <你的IDE>  # 更新到最新版
npx smh-api-ai@latest uninstall --ide <你的IDE> # 卸载（保留你自己的文件与其它 MCP server）

支持的 --ide：codebuddy、cursor、claude、codex、all。

codex 说明

codex 的机制与其它 IDE 不同：规则写进仓库根 AGENTS.md 的 <!-- smh-api-ai --> 托管块（保留你原有内容）；codex 无原生技能概念，改由 AGENTS.md 引用本地知识库；MCP 配置在全局 ~/.codex/config.toml，本包不会自动修改，而是生成 .smh-api-ai/codex-mcp.toml 片段供你手动合并。

安装产物

• .smh-api-ai/knowledge/：endpoint、错误码、grant、集成清单和 SDK 示例知识。
• .smh-api-ai/install.json：安装元数据。
• 各 IDE 规则：.cursor/rules/smh.mdc、.codebuddy/rules/smh.mdc、.claude/rules/smh.md；codex 为 AGENTS.md 托管块。
• 各 IDE 技能：.cursor/skills/smh-*、.codebuddy/skills/smh-*、.claude/skills/smh-*。
• 可选只读 MCP：.mcp.json、.cursor/mcp.json、.codebuddy/mcp.json；codex 为 .smh-api-ai/codex-mcp.toml。

uninstall 只移除本包生成的产物与 smh-api-ai MCP 条目，保留同一配置中的其它 server。

只读 MCP

MCP 不调用真实 SMH API、不接收密钥，只查询本地知识，提供 7 个只读工具：

• smh_list_api_groups、smh_search_api、smh_get_endpoint、smh_sdk_example、smh_recommend_grant、smh_explain_error、smh_check_project

说明

• 接口、参数、错误码、SDK 版本等最终以腾讯云智能媒资托管官方文档为准：https://cloud.tencent.com/document/product/1339
• 一期公开包暂不包含 Python SDK 示例，待公开渠道可用后补充。

许可

MIT，详见 LICENSE。