用途:该技能为自托管代码片段管理服务 ByteStash 提供读写访问,用于保存、检索、整理和分享代码片段。
主要能力:只读操作包括列出、搜索和获取片段;写入操作包括创建、更新和删除片段;分享管理支持创建、查看和删除公开、受保护或限时分享链接;组织功能通过标签对片段分类。支持多文件片段,每个片段可包含多个代码文件,含文件名、代码内容、语言和显示顺序。
使用方式:需在 ~/.claude-homelab/.env 中配置 BYTESTASH_URL 和 BYTESTASH_API_KEY,API 密钥在 ByteStash 网页界面 Settings → API Keys 创建,建议 chmod 600 保护该文件。命令通过 scripts/bytestash-api.sh 调用,例如 list、search "docker"、search --category "bash"、get <snippet-id>、create、push、update、delete、share、shares、unshare、view-share。创建单文件片段用 create 并传入 --title、--description、--categories、--code、--language、--filename;多文件用 push 并传入 --files。分享可加 --protected 或 --expires 86400。删除操作需用户确认。
适用场景:保存代码片段、按标题或分类查找片段、生成分享链接、整理片段标签、管理多文件项目结构示例。
限制:所有 API 操作均需 API 密钥,不支持匿名访问;分类为标签,无层级结构;无批量操作;分享链接不可更新,只能删除后重建;部分部署的分享端点可能要求 JWT 认证。命令默认返回 JSON,可用 jq 过滤。通过 zsh-tool 调用脚本时需使用 pty: true,否则输出不可见。