用途:该技能仅用于 Jinkō SDK 的安装、认证与凭据检查,目标是先证明 Python 能通过 jinko-sdk 认证并读取一个项目条目列表,再进入模型、vpop、协议、输出集或试验等工作流。
主要能力:确认 Python 3.10+;按需安装 SDK 与 dotenv 支持;引导创建 API 密钥;配置 JINKO_API_KEY 与 JINKO_PROJECT_ID;运行或改写连接检查脚本,快速暴露配置、认证、授权或项目读取权限问题;验证通过后可用 client.search(...) 只读浏览项目。
使用方式:安装命令为 pip install jinko python-dotenv。在 shell 或本地 .env 中设置 JINKO_API_KEY 和 JINKO_PROJECT_ID,可参考 assets/.env.example 模板,不要把密钥粘贴到聊天中。运行 python skills/jk-sdk-setup/scripts/check_jinko_connection.py 进行验证;该脚本会加载 .env、脱敏显示配置、要求两个变量、构造 JinkoClient() 并调用 client.auth_check()。仅在调试本地配置时使用 --show-config。验证通过后可用 from jinko import JinkoClient; client = JinkoClient(); client.search(limit=20, table_columns="compact") 浏览项目。
适用场景:首次连接 Jinkō、安装 SDK、检查凭据、排查认证或项目读取权限问题,以及在进入具体工作流前做只读探索。
限制:该技能不覆盖模型、vpop、协议、输出集或试验等具体工作流;SDK 虽支持 JINKO_BASE_URL,但除非用户明确需要,不引入其他环境;search() 不能替代快速失败检查。故障排查:ConfigurationError 检查两个变量;缺少 JINKO_API_KEY 参考 https://doc.jinko.ai/docs/api/;AuthenticationError 视为密钥缺失、过期、格式错误或复制错误;AuthorizationError 视为密钥有效但无项目权限;其他请求失败检查 JINKO_PROJECT_ID 与网络;导入错误则在当前环境重装。使用 direnv 时确保 .envrc 加载 .env 并执行 direnv allow。