TCM Prescription API

中医药方剂API查询技能。通过HTTP API查询中医药方剂数据库中的方剂资料。支持方剂搜索、方剂详情查看、分类浏览、症状推荐等功能。网站注册用户可通过API Key进行认证，获取更完整的方剂数据。This skill should be used when the user mentions: 查方剂、搜索方剂...

Security Scan

The skill's code, instructions, and requirements are internally consistent with a TCM prescription lookup API client, but there are privacy and transport-security concerns (HTTP + raw IP) and a small mismatch around how API keys are handled that you should review before use.

Purpose & Capability

The name/description (TCM prescription API) match the included files: SKILL.md, API reference, README, and a shell script that performs the documented HTTP calls. Required binaries (curl, python3) are appropriate and proportional to the stated purpose.

Instruction Scope

Runtime instructions stay within the stated purpose (search, detail, categories, symptom-based recommendation). They require the user to provide an API Key for full features and instruct the agent to validate it via the API. The guide also instructs the agent to 'remember' the key in the current session for subsequent requests — functionally reasonable but a privacy-sensitive behavior. Important security note: all API endpoints use plain HTTP (http://119.91.226.122), so API Keys and responses would be transmitted unencrypted.

Install Mechanism

No install spec; instruction-only with a helper script. No downloads or archive extraction. This is the lowest-risk install model.

Credentials

The skill declares no required environment variables, which mostly matches usage. The provided script accepts an optional TCM_API_KEY environment variable (TCM_API_KEY) for convenience — this is reasonable but not listed in the metadata. No unrelated secrets or extra credentials are requested. However, the skill asks users to paste their API Key into chat (or set an env var), which is sensitive and should be done with caution.

Persistence & Privilege

The skill does not request always:true, does not modify other skills or system config, and has no config-path requirements. Remembering the API Key in the current conversation is expected for functionality but is a privacy-sensitive runtime behavior — it does not appear to persist outside the conversation by design.

Assessment

This skill appears to do what it says (query a TCM prescriptions API) and the included script and docs match the described functionality. Before installing, consider: 1) The API endpoints use plain HTTP and a raw IP (http://119.91.226.122), so any API Key or query data you send will travel unencrypted and could be intercepted—prefer an HTTPS endpoint. 2) The skill asks you to provide your API Key (format tcm_live_xxxx). Don’t paste long-lived or highly privileged secrets into chat unless you trust the service; if possible create a limited-scope or ephemeral key and revoke it after use. 3) Verify the service/operator (Phal Studio) and the IP/domain independently — a raw IP and no homepage increase risk of phishing or malicious endpoints. 4) Note the minor metadata mismatch: the script uses TCM_API_KEY (environment) though requires.env is empty. If you proceed, prefer setting an env var in a secure runner or use a disposable key rather than pasting keys into conversation. If you want, I can: check whether the endpoint supports HTTPS, suggest safer ways to provide a key, or redact a key before logging.

中医药方剂 API 查询技能

用途

通过中医药方剂数据库的 REST API 接口，查询方剂名称、组成、功用、主治、方解、方歌、用法、禁忌、加减变化等完整资料。支持模糊搜索、分类浏览和基于症状的方剂推荐。

触发条件

当用户的请求涉及以下任一场景时，加载此技能：

• 方剂搜索：用户想查找某个方剂（如"查一下桂枝汤"、"搜索麻黄汤"、"find Guizhi Tang"）
• 方剂详情：用户想了解某个方剂的完整资料（如"桂枝汤的组成是什么"、"桂枝汤的功用"、"tell me about Mahuang Tang"）
• 分类浏览：用户想浏览某类方剂（如"解表剂有哪些"、"清热剂的方剂"、"show me diaphoretic formulas"）
• 症状推荐：用户描述症状并希望推荐方剂（如"头痛发热怎么办"、"推荐治感冒的方剂"、"what formula for headache and fever"）
• 方剂数据查询：泛化的中医药方数据需求（如"方剂数据库"、"中药方资料"、"TCM formula database"）

前置条件

用户需要提供 API Key 来使用完整功能：

1. API Key：注册用户在网站上生成的 API Key（格式：tcm_live_xxxx），通过请求头 X-API-Key 传递
2. 无 Key 公开访问：搜索和分类查询无需 API Key 即可使用基本功能

首次使用引导（重要）

CRITICAL：当检测到用户是首次使用此技能时（即用户尚未提供过 API Key），必须执行以下引导流程：

判断条件：用户消息中未包含 API Key（格式 tcm_live_ 开头的字符串），且在当前对话中尚未完成 API Key 设置。

引导步骤：

1. 欢迎与介绍：向用户简要介绍技能功能，然后引导注册：

欢迎使用中医药方剂查询！我可以帮你搜索方剂、查看方剂详情、浏览分类和根据症状推荐方剂。

为了使用完整功能（包括症状推荐），你需要一个 API Key。获取方式：

1. 访问网站 http://119.91.226.122 注册账号
2. 登录后在「个人中心」生成 API Key
3. 将 API Key 发给我即可（格式：tcm_live_xxxx）

如果你已经有 API Key，请直接发给我。如果没有，可以先浏览公开的方剂数据，稍后再注册。

2. 等待用户响应：

   • 如果用户提供了 API Key → 验证并保存，进入正常查询流程
   • 如果用户说"先看看"、"跳过"或类似意图 → 使用无认证模式继续，但提醒症状推荐功能受限
   • 如果用户询问如何注册 → 详细说明注册步骤

3. API Key 验证：当用户提供 API Key 后，调用状态接口验证：

curl -s "http://119.91.226.122/api/api-keys/status?key=USER_PROVIDED_KEY"

验证成功后告知用户：API Key 验证成功，现在可以使用全部功能了。

4. 后续对话：在当前会话中记住用户的 API Key，后续请求自动附加。不再重复引导。

注意：引导流程只执行一次。如果用户已经提供了 API Key 或明确表示跳过，后续查询不再引导。

API 服务地址

• API 基础地址：http://119.91.226.122/api
• 网站首页：http://119.91.226.122
• 健康检查：http://119.91.226.122/health

API 接口说明

详细的 API 接口文档请查阅 references/api-reference.md。以下是核心接口概览：

1. 搜索方剂

curl -s "http://119.91.226.122/api/prescriptions/search?q=桂枝&page=1&limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

参数说明：

• q 或 keyword：搜索关键词（方剂名称、药物组成等）
• category：按分类筛选（如"解表剂"、"清热剂"）
• page：页码，默认 1
• limit 或 pageSize：每页条数，默认 20

2. 获取方剂详情

curl -s "http://119.91.226.122/api/prescriptions/PRESCRIPTION_ID" \
  -H "X-API-Key: YOUR_API_KEY"

返回方剂的完整信息：名称、别名、组成、功用、主治、方解、方歌、用法、禁忌、加减变化、来源等。

3. 获取方剂分类

curl -s "http://119.91.226.122/api/prescriptions/categories"

返回所有方剂分类列表（如解表剂、泻下剂、和解剂、清热剂等）。

4. 症状推荐方剂（需要 API Key）

curl -s -X POST "http://119.91.226.122/api/prescriptions/recommend" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"symptoms": ["头痛", "发热", "恶风", "汗出"]}'

5. 健康检查

curl -s "http://119.91.226.122/health"

执行流程

当用户触发此技能时，按以下流程执行：

Step 0：检查 API Key 状态

在执行任何查询之前，先检查用户是否已提供 API Key：

1. 检查当前对话中用户是否已提供过 API Key
2. 如果尚未提供 → 执行「首次使用引导」（见前置条件章节）
3. 如果用户已提供 → 验证 Key 有效性，然后继续
4. 如果用户明确跳过 → 使用无认证模式继续

Step 1：识别用户意图

分析用户请求，判断属于以下哪种类型：

意图	关键词示例	对应接口
搜索方剂	"查"、"搜索"、"找" + 方剂名	GET /api/prescriptions/search
方剂详情	"组成"、"功用"、"主治"、"详情" + 方剂名	先搜索获取 ID，再 GET /api/prescriptions/:id
分类浏览	"分类"、"有哪些" + 分类名	GET /api/prescriptions/categories 然后按分类搜索
症状推荐	"症状"、"推荐"、"治什么" + 症状描述	POST /api/prescriptions/recommend

Step 2：构建 API 请求

根据识别的意图，构建对应的 API 请求。参考 scripts/query_prescriptions.sh 脚本中的实现方式。

如果用户提供了 API Key，将其加入 X-API-Key 请求头。如果未提供，则尝试无认证访问。

Step 3：执行查询

使用 execute_command 工具执行 curl 命令调用 API。使用 python3 -m json.tool 格式化 JSON 输出以便阅读。

Step 4：解析与呈现结果

将 API 返回的 JSON 数据解析后，以清晰的中文格式呈现给用户：

• 搜索结果：列出匹配的方剂名称、分类、简要功用，提示用户可以选择查看详情
• 方剂详情：展示完整方剂资料，按"组成 → 功用 → 主治 → 方解 → 用法 → 禁忌 → 加减变化"的顺序组织
• 分类列表：以表格形式展示所有分类及各方剂数量
• 症状推荐：列出推荐的方剂及其推荐理由

Step 5：追问与深入

查询完成后，询问用户是否需要：

• 查看某个方剂的详细信息
• 查看其他分类的方剂
• 调整搜索条件

辅助脚本

scripts/query_prescriptions.sh 提供了封装好的命令行工具，可用于快速查询。用法：

bash scripts/query_prescriptions.sh search "桂枝"              # 搜索方剂
bash scripts/query_prescriptions.sh detail PRESCRIPTION_ID     # 查看详情
bash scripts/query_prescriptions.sh categories                   # 获取分类
bash scripts/query_prescriptions.sh recommend "头痛,发热,恶风"  # 症状推荐
bash scripts/query_prescriptions.sh health                       # 健康检查

脚本支持通过环境变量 TCM_API_KEY 传入 API Key。

注意事项

1. 首次使用必须引导注册：用户首次触发技能时，引导其访问网站注册并获取 API Key
2. API 有速率限制（每分钟 100 次请求），避免短时间内大量调用
3. 症状推荐接口必须提供有效的 API Key
4. 方剂 ID 为系统内部标识，可通过搜索接口获取
5. 搜索支持中文方剂名、药物名等多种关键词，中文搜索时需进行 URL 编码
6. 公开接口可返回完整方剂信息（组成、用法、适应症、禁忌、注意事项）
7. API Key 验证接口：GET /api/api-keys/status?key=<key> 可检查 Key 状态

关于

• 技能名称：tcm-prescription-api
• 开发者：Phal Studio
• 客服邮箱：[e-mail]