yichen-skills 運維指南源碼與安裝版哈希比對及發(fā)布鏈維護詳解【免費下載鏈接】yichen-skills項目地址: https://gitcode.com/gh_mirrors/yi/yichen-skillsyichen-skills 是面向 Claude Code 與 Codex 的開源 Skill 合集涵蓋 X 長文草稿上傳、微信數(shù)據(jù)解析、統(tǒng)一搜索、內(nèi)容歸檔等 21 個技能。安裝之后最常見的運維問題就是本地安裝目錄到底和倉庫源碼差在哪本文帶你用一條只讀哈希比對命令檢查源碼與安裝版差異并掌握 5 步發(fā)布鏈維護流程讓升級既安全又不覆蓋舊版 ?一、先分清兩個角色發(fā)布源與安裝版理解運維的前提是分清兩份代碼的關系角色位置說明公開發(fā)布源本倉庫Git 跟蹤文件所有 Skill 的唯一權(quán)威來源安裝版~/.agents/skills/等本地目錄運行副本是實際被 Agent 加載的代碼三條核心原則出自 docs/skill-maintenance.md個人憑據(jù)、賬號選擇、代理、私有核心及其配置只留在本機不進入公開倉庫修復必須先合并到公開工作區(qū)再測試、發(fā)布、安裝不執(zhí)行雙向自動覆蓋安裝版多出來的文件或運行產(chǎn)物不算差異比對只針對 Git 已跟蹤的公開文件。 如果還沒拿到源碼先克隆倉庫再把各個 Skill 目錄原樣復制進你的技能加載路徑如~/.agents/skills/目錄名保持不變git clone https://gitcode.com/gh_mirrors/yi/yichen-skills二、一條命令完成只讀哈希比對倉庫內(nèi)置了只讀比對腳本 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 函數(shù)不調(diào)用任何 Skill、不讀取密鑰、不寫入也不同步默認安裝根~/.agents/skills和~/.codex/skills可重復指定--local-root覆蓋軟鏈接安全支持根目錄是軟鏈接但不跟隨 Skill 內(nèi)部的嵌套鏈接避免誤讀外部文件不猜新舊不按修改時間推斷哪個版本更新也不枚舉安裝版額外文件和運行產(chǎn)物Grok 插件需顯式指定yichen-grok-consult是 Codex 插件而非普通 Skill必須用--grok-plugin-root顯式給出插件安裝位置腳本不會自動搜索緩存。三、讀懂比對報告3 種狀態(tài)、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因內(nèi)部軟鏈接被跳過的文件屬于安全跳過非錯誤兩個容易忽略的細節(jié)別名機制部分 Skill 的規(guī)范安裝名不帶yichen-前綴腳本內(nèi)置了 ALIASES 映射例如yichen-volc-asr會同時嘗試volc-asr避免其實裝了但沒找到的誤報排除目錄work、.git、node_modules、outputs、logs、private等運行目錄被列入 EXCLUDED 名單本地備份和工作產(chǎn)物不會污染比對結(jié)果。四、5 步維護流程從合并到安裝確認差異后按 源碼與安裝版維護 的固定流程操作建獨立工作區(qū)從遠端最新main檢出核對 public公開/ installed安裝版/ private本機私有三類來源只遷移授權(quán)增量保留公開許可證、來源說明、環(huán)境變量和安全門禁僅遷移明確授權(quán)發(fā)布的通用增量先備份再動刀把受影響文件備份到本機work/記錄路徑、哈希和 Git 提交號安裝前再核一次基線發(fā)現(xiàn)并發(fā)變更就停止覆蓋該文件離線驗證運行受影響模塊的離線測試與必要集成驗證日志中不得出現(xiàn)憑據(jù)或私人內(nèi)容推送后回讀回讀遠端提交確認合入再核對安裝版新增插件代碼可能需要下一次會話重新加載不要擅自中斷當前任務。五、發(fā)布鏈維護這些 Skill故意不一樣比對出差異后別急著覆蓋——部分 Skill 的公開版與本機私有實現(xiàn)有意采用不同發(fā)布鏈見 有意保留的不同發(fā)布鏈Skill公開版本本機私有部分哈希不同屬正常X 文章草稿上傳器固定 tag 的公開版能力以自身 README 為準獨立的私有 Ailu 集成運行時與信任契約不同私有版本號大不代表可整包公開剪映編輯公開入口 Skill私有核心 另行授權(quán)源碼/運行庫哈希固定差異須按配套核心驗證不能改固定值繞過校驗ASR 路由環(huán)境變量注入配置本機可存在目錄外執(zhí)行器和鑰匙串適配不能因 Skill 目錄缺文件就判定未安裝企微官方 CLI可配置 helper私有 helper 可以不同絕不把本機路徑寫進公開代碼Grok 咨詢插件MCP 授權(quán)策略 Skill 入口 一起核對個人.mcp.json的代理與登錄態(tài)配置不被覆蓋入口相同不等于插件完整相同另外系統(tǒng)和插件緩存由各自安裝機制管理沒有本機獨立入口的公開 Skill 不自動安裝或刪除 六、新手高頻疑問Q比對顯示某文件changed可以直接覆蓋嗎先查它是否屬于上表的不同發(fā)布鏈屬于則保留本地版本不屬于才走備份 → 合并 → 驗證流程。Q腳本會修改我的安裝目錄嗎不會。報告自帶read_only: true聲明全程零寫入。Q為什么我安裝版里多出來的文件沒被報告腳本只比對 Git 跟蹤的公開文件安裝側(cè)額外文件和運行產(chǎn)物不在枚舉范圍內(nèi)這是刻意設計。Q新裝的插件不生效新增插件代碼可能需要下一次會話重新加載按流程等待即可。七、相關文件速查維護規(guī)范總綱docs/skill-maintenance.md只讀比對腳本scripts/compare_installed_skills.py別名與排除目錄實現(xiàn)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創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考