yichen-skills 运维指南源码与安装版哈希比对及发布链维护详解【免费下载链接】yichen-skills项目地址: https://gitcode.com/gh_mirrors/yi/yichen-skillsyichen-skills 是面向 Claude Code 与 Codex 的开源 Skill 合集涵盖 X 长文草稿上传、微信数据解析、统一搜索、内容归档等 21 个技能。安装之后最常见的运维问题就是本地安装目录到底和仓库源码差在哪本文带你用一条只读哈希比对命令检查源码与安装版差异并掌握 5 步发布链维护流程让升级既安全又不覆盖旧版 ️一、先分清两个角色发布源与安装版理解运维的前提是分清两份代码的关系角色位置说明公开发布源本仓库Git 跟踪文件所有 Skill 的唯一权威来源安装版~/.agents/skills/等本地目录运行副本是实际被 Agent 加载的代码三条核心原则出自 docs/skill-maintenance.md个人凭据、账号选择、代理、私有核心及其配置只留在本机不进入公开仓库修复必须先合并到公开工作区再测试、发布、安装不执行双向自动覆盖安装版多出来的文件或运行产物不算差异比对只针对 Git 已跟踪的公开文件。 如果还没拿到源码先克隆仓库再把各个 Skill 目录原样复制进你的技能加载路径如~/.agents/skills/目录名保持不变git clone https://gitcode.com/gh_mirrors/yi/yichen-skills二、一条命令完成只读哈希比对仓库内置了只读比对脚本 scripts/compare_installed_skills.py直接运行python3 scripts/compare_installed_skills.py # 自定义安装根目录可重复传入 --local-root首个命中生效 python3 scripts/compare_installed_skills.py --local-root $HOME/.agents/skills它的工作方式对新手非常友好 只算哈希不动手对 Git 已跟踪的公开 Skill 文件逐一计算 SHA-256见 digest 函数不调用任何 Skill、不读取密钥、不写入也不同步默认安装根~/.agents/skills和~/.codex/skills可重复指定--local-root覆盖软链接安全支持根目录是软链接但不跟随 Skill 内部的嵌套链接避免误读外部文件不猜新旧不按修改时间推断哪个版本更新也不枚举安装版额外文件和运行产物Grok 插件需显式指定yichen-grok-consult是 Codex 插件而非普通 Skill必须用--grok-plugin-root显式给出插件安装位置脚本不会自动搜索缓存。三、读懂比对报告3 种状态、4 个字段脚本输出一份 JSON 报告顶层就两个关键声明read_only: true和version_precedence_inferred: false只读、不推断版本新旧。每个 Skill 一条记录字段含义新手怎么理解status: identical公开文件全部一致✅ 无需处理status: different存在改动或缺失⚠️ 看下面两个字段定位status: not_found本地未安装该 Skill想用时再装identical/changed逐文件列出一致 / 哈希不同的路径精确到文件不用自己 diffmissing_locally公开版有、本地缺的文件升级安装即可补齐nested_links_skipped因内部软链接被跳过的文件属于安全跳过非错误两个容易忽略的细节别名机制部分 Skill 的规范安装名不带yichen-前缀脚本内置了 ALIASES 映射例如yichen-volc-asr会同时尝试volc-asr避免其实装了但没找到的误报排除目录work、.git、node_modules、outputs、logs、private等运行目录被列入 EXCLUDED 名单本地备份和工作产物不会污染比对结果。四、5 步维护流程从合并到安装确认差异后按 源码与安装版维护 的固定流程操作建独立工作区从远端最新main检出核对 public公开/ installed安装版/ private本机私有三类来源只迁移授权增量保留公开许可证、来源说明、环境变量和安全门禁仅迁移明确授权发布的通用增量先备份再动刀把受影响文件备份到本机work/记录路径、哈希和 Git 提交号安装前再核一次基线发现并发变更就停止覆盖该文件离线验证运行受影响模块的离线测试与必要集成验证日志中不得出现凭据或私人内容推送后回读回读远端提交确认合入再核对安装版新增插件代码可能需要下一次会话重新加载不要擅自中断当前任务。五、发布链维护这些 Skill故意不一样比对出差异后别急着覆盖——部分 Skill 的公开版与本机私有实现有意采用不同发布链见 有意保留的不同发布链Skill公开版本本机私有部分哈希不同属正常X 文章草稿上传器固定 tag 的公开版能力以自身 README 为准独立的私有 Ailu 集成运行时与信任契约不同私有版本号大不代表可整包公开剪映编辑公开入口 Skill私有核心 另行授权源码/运行库哈希固定差异须按配套核心验证不能改固定值绕过校验ASR 路由环境变量注入配置本机可存在目录外执行器和钥匙串适配不能因 Skill 目录缺文件就判定未安装企微官方 CLI可配置 helper私有 helper 可以不同绝不把本机路径写进公开代码Grok 咨询插件MCP 授权策略 Skill 入口 一起核对个人.mcp.json的代理与登录态配置不被覆盖入口相同不等于插件完整相同另外系统和插件缓存由各自安装机制管理没有本机独立入口的公开 Skill 不自动安装或删除 六、新手高频疑问Q比对显示某文件changed可以直接覆盖吗先查它是否属于上表的不同发布链属于则保留本地版本不属于才走备份 → 合并 → 验证流程。Q脚本会修改我的安装目录吗不会。报告自带read_only: true声明全程零写入。Q为什么我安装版里多出来的文件没被报告脚本只比对 Git 跟踪的公开文件安装侧额外文件和运行产物不在枚举范围内这是刻意设计。Q新装的插件不生效新增插件代码可能需要下一次会话重新加载按流程等待即可。七、相关文件速查维护规范总纲docs/skill-maintenance.md只读比对脚本scripts/compare_installed_skills.py别名与排除目录实现ALIASES / EXCLUDED上传器公开版说明yichen-x-article-draft-uploader/README.md剪映公开入口说明yichen-jianying-edit/README.mdGrok 插件说明plugins/yichen-grok-consult/README.md【免费下载链接】yichen-skills项目地址: https://gitcode.com/gh_mirrors/yi/yichen-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考