Skip to content

docs(faq): add Kubernetes version, skill credentials and port conflict entries - #907

Open
FenjuFu wants to merge 1 commit into
iflytek:mainfrom
FenjuFu:docs/faq-community-qa-2026-09
Open

FenjuFu wants to merge 1 commit into
iflytek:mainfrom
FenjuFu:docs/faq-community-qa-2026-09

Conversation

@FenjuFu

@FenjuFu FenjuFu commented Sep 29, 2026

Copy link
Copy Markdown
Member

问题

社区交流群(9 月 7 日—20 日)里反复出现、而现有 FAQ 尚未覆盖的三个问题:

  • 启动时报 listen tcp4 0.0.0.0:80: bind: address already in use,不知道端口在哪里改;
  • 在低版本 Kubernetes 上部署是否可行;
  • Skill 里含认证凭据时该如何处理、SkillHub 有没有脱敏规范。

改动

在中英文 FAQ(docs/skillhub/faq.md、docs/skillhub/en/faq.md)中各新增 3 条:

  • Kubernetes 版本要求:引用官方 Kubernetes 部署指南中的 v1.24+ 前置条件。
  • 技能包里可以放 API Key、Token 等凭据吗?:说明发布前校验会识别疑似硬编码凭据(以及 v0.2.20 fix(validation): ignore credential expressions #830 减少误报),建议只放环境变量名 / 占位符并在 SKILL.md 中说明,由使用方在 Agent 环境中配置;注明 SkillHub 目前不提供密钥托管或注入。
  • 80 端口被占用:通过 .env.release 中的 WEB_PORT / API_PORT 修改对外端口,同步更新 SKILLHUB_PUBLIC_BASE_URL,再 up -d --force-recreate 重建容器;注明一键部署脚本生成的 .env.release 默认路径。

验证

  • 有效 diff 仅 docs/skillhub/faq.md 与 docs/skillhub/en/faq.md,中英文条目一一对应。
  • 对照当前 main 核对:compose.release.yml 中的 ${WEB_PORT:-80} / ${API_PORT:-8080},.env.release.example 中的默认值,scripts/runtime.sh 的 ${TMPDIR:-/tmp}/skillhub-runtime/.env.release,以及 docs/skillhub/guide/kubernetes.md 的前置条件。
  • 提交带 Signed-off-by。

风险

纯文档变更,不改变部署行为。

…t entries

Signed-off-by: FenjuFu <fufenjupku@gmail.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant