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工具 |