From 92b3eda9cbdf666aa57c0116db5e82b0884fe39b Mon Sep 17 00:00:00 2001
From: tradecatlabs <288998340+tradecatlabs@users.noreply.github.com>
Date: Thu, 22 Oct 2026 04:20:01 +0800
Subject: [PATCH] =?UTF-8?q?refactor:=20extensions=20-=20=E5=90=88=E5=B9=B6?=
=?UTF-8?q?=E5=81=9C=E7=94=A8Actions=E8=AF=B4=E6=98=8E=E5=B9=B6=E7=B2=BE?=
=?UTF-8?q?=E7=AE=80=E7=9B=AE=E5=BD=95=20(#198)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.github/AGENTS.md | 2 +-
.github/extensions/AGENTS.md | 4 ++--
.github/extensions/README.md | 19 ++++++++++++++++---
.github/extensions/github-actions.md | 23 -----------------------
AGENTS.md | 2 +-
5 files changed, 20 insertions(+), 30 deletions(-)
delete mode 100644 .github/extensions/github-actions.md
diff --git a/.github/AGENTS.md b/.github/AGENTS.md
index 337f3276..517dfa0e 100644
--- a/.github/AGENTS.md
+++ b/.github/AGENTS.md
@@ -52,7 +52,7 @@
`ISSUE_TEMPLATE/`、`CODEOWNERS`、`FUNDING.yml`、`PULL_REQUEST_TEMPLATE.md`、`SECURITY.md`、`WIKI.md`、`labeler.yml`、`lint_config.json`保留现有位置；用户本次点名workflows，不扩改其他协作入口。
-- `workflows/`已退役，不再作为平台例外；禁止重建目录、符号链接或兼容壳。原3个定义以`github-actions-*.yml`在Extensions平铺，说明见`extensions/github-actions.md`。
+- `workflows/`已退役，不再作为平台例外；禁止重建目录、符号链接或兼容壳。原3个定义以`github-actions-*.yml`在Extensions平铺为历史原件，说明见[Extensions README](extensions/README.md#retired-github-actions)。
- 自动CI、Labeler和Welcome不再触发；本地校验/测试由根Makefile调用同级维护脚本，资料维护仍调用Extensions入口，不把空远端检查当CI成功。
- CODEOWNERS仍由`@tukuaiai`、`@tradecatlabs`覆盖，仅迁移路径，不改变审批或豁免资格。
- 原自动化定义逐字节保全，不执行或读取其secret表达式；恢复自动化须显式授权，不能只搬回路径而忽略权限、输入及检查生产者。
diff --git a/.github/extensions/AGENTS.md b/.github/extensions/AGENTS.md
index aa750eab..4e8c7783 100644
--- a/.github/extensions/AGENTS.md
+++ b/.github/extensions/AGENTS.md
@@ -1,7 +1,7 @@
# Extensions维护规则
- 本域收纳既有程序、小工具、资料维护入口、适配器和固定源码；不是仅指Pi原生TypeScript扩展。11个校验和5个测试入口现归`.github/`维护层，不再算本域对象。
-- 当前17个一级对象在域根平铺；保留程序内部包结构、相互调用关系及上游原生目录，不逐文件拆成工具。用户指定退役的8项不留目录、软链接或兼容壳；原lib中的4个模块已直接平铺到`.github/`，不再保留库目录。
+- 当前16个一级对象在域根平铺；保留程序内部包结构、相互调用关系及上游原生目录，不逐文件拆成工具。用户指定退役的8项不留目录、软链接或兼容壳；原lib中的4个模块已直接平铺到`.github/`，不再保留库目录。
- 代码只存一份；两个自有Skills现为原生工具与规范指令，原33个专属封装脚本已退役，不重建别名或包装层。四个Gitlink及Skill Seekers嵌套configs保持锁定修订，不复制、格式化或自动升级上游。
- 固定源码与原9项范围排除继续保留；搬位置不等于激活、许可证批准、身份合并、独立审查或效果证明。
- `sync-gongfa-catalog.py`和`sync-faqi-catalog.py`从各自`data.json.explanations_v1`读取18项说明，生成轻量README导航页及天、地、玄、黄四阶正文；每个对象仍独立使用三列表格。v1是唯一活动载荷；v0仅保留为历史模板，不接受旧载荷兼容。功法未定级记录只作为黄阶文档中的独立附录，明确不归黄阶；新论证字段依据已登记说明和来源边界撰写，第17项必须写明图尔敏Warrant所要求的证据—主张推理桥梁，不得以字段交叉引用代替；不从候选、源码或外部资料自动补写未核实事实。
@@ -12,5 +12,5 @@
- 用户退役程序时，先核对消费用例是否仍验证独立的档案合同；不因实现移除而删除冻结来源、排除、权限及完整性测试。原审与评级不因下线实现改写，当前绑定如实清理；历史正文保留，相关链接定位到已发布固定Git修订，不作为当前执行入口。
- 不执行被审第三方程序、安装器、上传、抓取或排除服务来补造验证；不读真实凭据、会话或数据库。
- API、命令和路径变化同步本域README、受影响Skill、根README/AGENTS、Makefile和活动导航。本地校验范围不随Actions退役缩减。
-- `github-actions-*.yml`是已退役的原自动化定义，逐字节保全，不在本域执行或自动加载；说明见`github-actions.md`。不得擅自恢复`.github/workflows/`或把本地结果冒充远端CI。
+- `github-actions-*.yml`是已退役的原自动化定义，逐字节保全，不在本域执行或自动加载；说明见[Extensions README](README.md#retired-github-actions)。不得擅自恢复`.github/workflows/`或把本地结果冒充远端CI。
- 此目录不能整体作为Pi原生扩展加载；只有符合原生扩展契约且经具体任务授权的模块才能执行。
diff --git a/.github/extensions/README.md b/.github/extensions/README.md
index f6ea0f9b..dfced3fa 100644
--- a/.github/extensions/README.md
+++ b/.github/extensions/README.md
@@ -2,7 +2,7 @@
## 字多不看
-这里保存现存程序、资料维护脚本与固定上游；当前17个一级对象在本域平铺，程序内部源码结构不拆散。
+这里保存现存程序、资料维护脚本与固定上游；当前16个一级对象在本域平铺，程序内部源码结构不拆散。
这里的Extensions不是Pi原生扩展的同义词；不能把整个目录交给Pi的`-e`加载。
## 快速导航
@@ -16,11 +16,11 @@
| [EPUB CSS清理](clean_epub_css.html) | 保留的HTML工具文件 |
| [Markdown编辑](markdown-bianjiqi.html) | 保留的HTML工具文件 |
| [任务卡生成](task%20card%20generator.html) | 保留的HTML工具文件 |
-| [原GitHub Actions定义](github-actions.md) | `github-actions-ci.yml`、`github-actions-labeler.yml`、`github-actions-welcome.yml`；已停用，仅保全原定义 |
+| [已停用的GitHub Actions定义](#retired-github-actions) | 3份历史YAML；不在原生工作流目录，不会被GitHub发现或执行 |
来自两个自有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历史文件均未移除。
+当前引用与安装入口已清理；原文件在本地私有工件保全，固定来源初审仍保留历史意见。4个Gitlink、提示词转换器、3个其他HTML、4个资料维护入口和3份Actions历史定义均保留。
完整细粒度目录（点击展开/收起）
@@ -28,6 +28,7 @@
- [使用方式](#使用方式)
- [正文](#正文)
- [检查与维护入口](#检查与维护入口)
+- [已停用的GitHub Actions定义](#retired-github-actions)
- [依赖与执行边界](#依赖与执行边界)
@@ -53,6 +54,18 @@
共享实现只有一份，5个Python模块直接平铺到`.github/`；职责与原库规则见[维护说明](../AGENTS.md#维护脚本与共享库)，不再保留lib目录。两个目录生成器从原始JSON中的`explanations_v1`读取唯一活动说明载荷，输出轻量README导航页及天、地、玄、黄四阶正文；每个对象仍单独使用一张18项严格三列表格。v0仅保留为历史模板，不接受旧载荷兼容。未定级功法在黄阶文档中单列并标明“不归黄阶”。完整本地检查仍为`make test`，不执行被审第三方程序，也不证明运行、效果或许可。
+
+
+### 已停用的 GitHub Actions 定义
+
+| 历史职责 | 原定义 | 原工作范围 |
+|---|---|---|
+| CI | [github-actions-ci.yml](github-actions-ci.yml) | Markdown、本地导航/结构/索引与外链检查 |
+| PR自动标签 | [github-actions-labeler.yml](github-actions-labeler.yml) | 按PR变更自动添加标签 |
+| 首次贡献者欢迎 | [github-actions-welcome.yml](github-actions-welcome.yml) | 首次Issue/PR贡献者欢迎 |
+
+这3份YAML逐字节保留为历史记录，位于Extensions而非GitHub发现工作流的`.github/workflows/`目录；不会自动执行，其中的事件、权限、Action版本和secret表达式不构成当前授权。恢复自动化须先获明确授权，并同时恢复平台发现路径和对应检查生产者。外链规则仍记录在根目录`.lychee.toml`，但本地`make test`不运行旧的联网Lychee检查，也不等同远端CI。
+
### 依赖与执行边界
检查器使用Python3；功法、法器和资料档案维护使用Python3.10+，共享依赖在`.github/`，见[requirements-gongfa.txt](../requirements-gongfa.txt)、[requirements-faqi.txt](../requirements-faqi.txt)。
diff --git a/.github/extensions/github-actions.md b/.github/extensions/github-actions.md
deleted file mode 100644
index 5a7b2064..00000000
--- a/.github/extensions/github-actions.md
+++ /dev/null
@@ -1,23 +0,0 @@
-# 原GitHub Actions定义（已停用）
-
-用户要求清除workflows目录，因此原定义直接平铺至Extensions，`.github/workflows/`不再保留。
-GitHub不会自动发现本目录的定义；自动CI、PR打标签和首次贡献者欢迎均已停用，不是换路径后仍在运行。
-
-## 原定义与职责
-
-| 原定义 | 保全位置 | 历史职责 |
-|---|---|---|
-| CI | [github-actions-ci.yml](github-actions-ci.yml) | 原Markdown、本地导航/结构/索引与外链检查 |
-| Labeler | [github-actions-labeler.yml](github-actions-labeler.yml) | 原PR自动标签 |
-| Welcome | [github-actions-welcome.yml](github-actions-welcome.yml) | 原首次Issue/PR贡献者欢迎 |
-
-3份YAML保持原字节，包括历史路径注释、事件、权限、Action版本及平台secret表达式；保全不是执行或重新授权。
-原目录规则已并入本域AGENTS，不保留第二份治理文件、空目录或符号链接。
-
-## 本地检查与保护
-
-- 从仓库根运行`make test`；其检查范围不缩减，也不自动执行以上定义。
-- 主Ruleset和main经典保护仅移除已无Actions生产者的`markdown-lint`、`link-checker`必需检查。
-- 签名、线性历史、PR、禁止强推/删除及原审批规则保留，不伪造成功checks或独立审核。
-- 原目录不得重建；如需恢复自动化，必须显式授权，并共同恢复原生发现路径和对应检查生产者。
-- 外链规则仍在仓库根`.lychee.toml`；本地`make test`不包含原Lychee公网外链任务，不声称同等远端覆盖。
diff --git a/AGENTS.md b/AGENTS.md
index 70a839d3..d82c4dd1 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -14,7 +14,7 @@
|---|---|
| `.github/context/` | 公开规则、知识、文档、数据和参考资料；研究档案仅保留在已有本机副本；详见本域AGENTS |
| `.github/skills/` | 仅保留auto-skill、auto-tmux两个自有指令入口，使用原生工具；原专属封装已退役 |
-| `.github/extensions/` | 当前17个一级对象：现存程序、资料维护入口、固定源码与历史定义；不是全部可由Pi的`-e`加载 |
+| `.github/extensions/` | 当前16个一级对象：现存程序、资料维护入口、固定源码与历史定义；不是全部可由Pi的`-e`加载 |
| `.github/ISSUE_TEMPLATE/`及固定配置 | 现有GitHub协作入口；本次仅退役workflows，不扩改其他平台配置 |
| `.github/CONTRIBUTORS.md` | 根README迁出的贡献者名单与鸣谢；只维护独立文档 |
| `.github/check-*.py`、`test-*.py`、4个平铺共享模块及requirements | 仓库维护层：11个校验、6个测试及唯一配套实现；不保留lib目录，不是用户侧Extensions工具 |