tradecatlabsandGitHub
2daf7f3557
* feat: context - split catalogs by grade * docs: context - sync grade-page navigation
4.3 KiB
Extensions：既有程序与小工具
字多不看
这里保存现存程序、资料维护脚本与固定上游；当前17个一级对象在本域平铺，程序内部源码结构不拆散。
这里的Extensions不是Pi原生扩展的同义词；不能把整个目录交给Pi的-e加载。
快速导航
| 既有对象 | 入口与用途 |
|---|---|
| Skill Seekers | 固定上游源码；原本地适配脚本已退役，按上游说明与具体授权选择使用 |
| Claude官方Skills源 | 保留单一固定源码及独立初始化脚本；Skills域的16个官方入口已移除 |
| tmux、oh-my-tmux | 原固定源码与配置仓库；不是自动安装或启用 |
| 提示词转换 | 原Excel、Markdown、JSONL转换程序 |
| EPUB CSS清理 | 保留的HTML工具文件 |
| Markdown编辑 | 保留的HTML工具文件 |
| 任务卡生成 | 保留的HTML工具文件 |
| 原GitHub Actions定义 | github-actions-ci.yml、github-actions-labeler.yml、github-actions-welcome.yml；已停用，仅保全原定义 |
来自两个自有Skill的33个封装脚本已退役，不保留兼容壳；两个Skill改用原生工具与指令检查。
引用原上游的init_skill.py独立入口继续保留。用户点名的chat-vault、my-nvim、codex-config、MCPlayerTransfer、XHS-image-to-PDF-conversion、两个xhs图文HTML及html-tools-main说明共8项已移除。
当前引用与安装入口已清理；原文件在本地私有工件保全，固定来源初审仍保留历史意见。4个Gitlink、提示词转换器、3个其他HTML、4个资料维护入口和4份Actions历史文件均未移除。
使用方式
先读具体程序的README和来源，再按任务显式调用。Python脚本从仓库根运行；现有Shell脚本可用bash .github/extensions/<脚本名>调用。
程序只存一份；Skill中的指令引用这里，不复制执行实现。Pi Agent使用原生工具和模型选择，不新增运行器或模型HTTP客户端。
正文
检查与维护入口
11个校验脚本和5个测试脚本已迁至仓库根的.github/，不再列作Extensions工具；入口与职责见维护规则。
本域保留以下4个资料维护入口，本次没有扩大迁移范围：
| 范围 | 本域保留入口 |
|---|---|
| 文档目录 | sync-doc-toc.py |
| 功法视图 | sync-gongfa-catalog.py |
| 法器视图 | sync-faqi-catalog.py |
| 研究事实获取 | fetch-research-raw.py；需要明确联网授权 |
共享实现只有一份，5个Python模块直接平铺到.github/；职责与原库规则见维护说明，不再保留lib目录。两个目录生成器从原始JSON中的explanations_v0读取已登记模板说明，输出轻量README导航页及天、地、玄、黄四阶正文；每个对象仍单独使用一张严格三列表格。未定级功法在黄阶文档中单列并标明“不归黄阶”。完整本地检查仍为make test，不执行被审第三方程序，也不证明运行、效果或许可。
依赖与执行边界
检查器使用Python3；功法、法器和资料档案维护使用Python3.10+，共享依赖在.github/，见requirements-gongfa.txt、requirements-faqi.txt。
复用jsonschema、PyYAML和markdown-it-py；v0表格由共享模块按固定三列表格契约安全渲染。转换程序另用其原有requirements。Markdown lint使用Node22+及固定的markdownlint-cli0.48.0。
来源树保持原Git修订。安装、抓取、上传、发布、修改配置和终端注入均有独立副作用，不因移入本域得到授权。 凭据仅从受信来源在运行时注入，不提交真实会话、数据库、API密钥、环境文件或私有模板。