# 安装 ShipLang 扩展开发技能 请帮助用户完成下载、配置和安装。你需要能够操作用户本机的文件与终端;只有网页阅读能力时,说明缺少什么能力,不声称安装成功。本文件是一次性引导,安装后的正式技能不包含它,也不需要额外安装器。 ## 1. 下载技能 - ZIP:https://raw.githubusercontent.com/84583728/extension-policies/main/docs/shiplang-extension.zip - SHA-256:`975ab6923b04bec17a8dfa89b48098b8eb04591bf667d7086ee4e353b626e58c` - 包内根目录:`shiplang-extension/`,共 11 个文件。 下载到本次新建的临时目录,核对 SHA-256 后解压;解压路径必须留在该目录内,不接受绝对路径、`..` 越界或符号链接。阅读解压后的 `SKILL.md`,保留全部 11 个技能文件。无需创建 setup.py、配置 JSON、回执、测试目录或另一个安装技能。 ## 2. 收集必要信息 先复用用户本次已提供的信息,再一次性询问仍缺少的内容: 1. **ShipLang 开发者 ID**:1–8 位小写字母或数字。在 https://e.shiplang.com/zh 注册或查看自己的 ID。 2. **开发者邮箱**:用于扩展底部和隐私协议的联系方式。 3. **GitHub 发布信息**:用户名/组织名、隐私政策仓库、分支;已有自定义 Pages 域名时再提供站点根网址。用户明确暂不需要发布时,可以跳过 GitHub,并说明以后只能先生成本地隐私页面。 没有 GitHub 时,引导用户到 https://github.com/signup 注册并验证邮箱;到 https://github.com/new 创建公开仓库(例如 `privacy`),勾选 README 初始化分支,记录真实分支名。已有合适仓库直接复用。 需要发布时,引导用户在 https://github.com/settings/personal-access-tokens/new 创建 fine-grained Token:Resource owner 选自己的账号/组织,Only select repositories 只选该仓库,Contents 设为 Read and write;有效期由用户决定。登录密码、验证码由用户自己输入。Token 稍后通过终端隐藏输入,不让用户发到聊天,也不写进 Markdown 或 Python 源码。当前没有额外的 ShipLang API Key 需要填写。 ## 3. 填写并安装 只修改解压出的副本,使用用户自己的值: | 文件 | 要填的内容 | | --- | --- | | `references/SDK接入.md` | 将 `{{SHIPLANG_DEVELOPER_ID}}` 替换为开发者 ID | | `references/开发规范.md` | 将 `{{DEVELOPER_EMAIL}}` 替换为开发者邮箱 | | `references/隐私协议.md` | 将 `{{DEVELOPER_EMAIL}}` 替换为同一个邮箱 | | `references/隐私协议_GitHub发布.py` | 填写顶部 `OWNER`、`REPO`、`BRANCH`、`SITE_URL`;没有自定义域名时 `SITE_URL` 留空。保持 `ACTION="status"`、`PROJECT_DIR=""`、`TOKEN_PROMPT=True`、`REPLACE_TOKEN=False` | 跳过 GitHub 时 `OWNER` 保持空。Python 字符串必须正确转义;不要把用户输入拼成可执行命令。`demo_...` 是格式示例,不是用户的 AppId;将来为每个新产品生成自己的 AppId。ShipLang 服务邮箱 `e@shiplang.com` 和 `support@shiplang.com` 保持原样。 确定当前 AI 客户端实际支持的技能目录,将配置好的 `shiplang-extension` 文件夹完整安装进去。例如 Codex 用户级目录为 `~/.agents/skills/`;其他客户端使用其实际目录。目标目录已存在时保留原技能,向用户说明冲突后再选择更新或其他目标,不直接覆盖。不要把临时下载目录当作正式安装目录。 ## 4. 保存授权并检查 需要 GitHub 发布时,在**已安装技能**的 `references/隐私协议_GitHub发布.py` 顶部依次设置并执行: 1. `ACTION="store-token"`:在用户可见终端运行 `python3 "<正式技能绝对路径>/references/隐私协议_GitHub发布.py"`,由用户无回显输入 Token。脚本会将它保存到同目录 `.github-pages-token`,权限为 0600。已有凭证先复用,用户要求轮换时才设 `REPLACE_TOKEN=True`。 2. `ACTION="check"`:运行同一脚本,验证 GitHub 用户、仓库和分支的读取授权。失败时按报错修正,不能把本地存在 Token 当成授权成功。此检查不写远端;Contents 写权限在设置页核实,实际发布和 Pages 上线留到真实产品页面准备好后验证。 3. 验证完成后恢复 `ACTION="status"`、`REPLACE_TOKEN=False`。不要输出凭证内容。 首次实际发布隐私页面后,在该仓库 Settings → Pages 选择 Deploy from a branch、已配置分支和 `/docs`,然后再次运行发布验证。安装时不发布虚构的隐私页面。 批量翻译所需的 MCP 按正式技能 `references/多语言.md` 配置:复用或建立持久 Python 环境,安装依赖,注册**正式技能中脚本的绝对路径**,再用临时语言目录试调用。已有可用翻译工具则复用;用户选择稍后配置时记录该项未启用。依赖环境和 MCP 配置不能放在即将删除的临时目录。 检查正式目录的 `SKILL.md`、8 份文档和2个 Python 工具都存在,3处身份/邮箱占位符已替换,Python 语法有效。核实客户端能发现技能;需要刷新或重启时说明。区分“文件已安装”“授权已验证”和“客户端已加载”,未验证的如实说明。 ## 5. 完成后自动清理 所选配置和检查完成后,删除**本次创建的**临时解压目录、下载的 ZIP,以及你为执行引导而下载的 `install.md` 副本;不要删除正式技能、Token、持久 Python 环境、MCP 配置或用户原有文件。不需要额外建立清理脚本或安装回执。 若本文件仅在线读取,没有本地副本可删,直接说明引导未落盘。远端公开 MD 和 ZIP 是供其他用户安装的分发文件,始终保留。安装未完成时保留本次临时文件并说明待办,不执行成功后的清理。 最后简要告知正式技能的绝对路径、已配置功能、跳过或未验证项,以及临时引导是否已清理。安装后的目录包含用户自己的信息和授权,不能直接重新公开分享;再次分享使用上方干净 ZIP。