Files

王冕 a27e3b8e43 feat: sync full workspace including web modules, docs, and configurations to Gitea

Optimized the root .gitignore to exclude virtual environments, node modules,
and temp folders to ensure clean and lightweight version tracking.

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-06-09 18:12:25 +08:00

2.6 KiB

Raw Blame History

.axhub/make

这个目录用于存放 Axhub Make 项目的本地运行数据、项目配置索引，以及技能清单。

目录职责

axhub.config.json
- 项目运行配置。
make.json
- 项目级元信息。
entries.json
- 入口扫描结果，通常由程序生成或刷新。
sidebar-tree.json
- 侧边栏树数据，通常由程序生成或刷新。
.dev-server-info.json
- 当前开发服务的本地运行信息。
skills/
- 技能清单目录，包含官方默认清单和当前项目自定义清单。
backups/
- 建议的维护备份目录，技能相关备份统一放到 backups/skills/<timestamp>/。

skills 目录规则

技能清单统一放在：

apps/axhub-make/.axhub/make/skills/

当前采用两层规则：

官方默认清单：*.default.json
用户自定义清单：同名但不带 .default

涉及 4 份 manifest：

skills-manifest.default.json
doc-skills-manifest.default.json
theme-skills-manifest.default.json
install-skills-manifest.default.json

对应的自定义文件分别为：

skills-manifest.json
doc-skills-manifest.json
theme-skills-manifest.json
install-skills-manifest.json

程序读取顺序固定为：

先读自定义清单
若自定义不存在，再回退到 *.default.json

注意事项：

不做 merge，不做覆盖合并，不做深合并。
自定义清单一旦存在，就完整替代对应的默认清单。
官方仓库只维护 *.default.json。
用户自定义清单不发布、不随项目更新覆盖。

技能正文位置

技能正文不在这里，官方技能目录位于：

apps/axhub-make/skills/<skill-id>/

常见文件包括：

apps/axhub-make/skills/<skill-id>/SKILL.md
apps/axhub-make/skills/<skill-id>/references/...

如果需要恢复某个官方默认技能：

先到 skills/*.default.json 找回条目
再到 apps/axhub-make/skills/<skill-id>/ 找回技能正文
最后按需要补回到当前项目自定义清单中

维护建议

修改任何技能清单或技能文档前，先备份。
推荐备份目录：.axhub/make/backups/skills/<timestamp>/
默认备份对象：
- 当前要修改的 manifest 文件
- 当前要修改的 skill 目录

不建议直接手改的文件

以下文件通常属于运行时或扫描产物，除非明确知道影响，否则不要手动编辑：

entries.json
sidebar-tree.json
.dev-server-info.json

前端读取入口

前端技能清单的读取入口在：

apps/prototype-admin/src/index/config/skillManifests.ts

如果后续再调整 manifest 路径，必须同步修改这里的 glob 路径。

2.6 KiB Raw Blame History Unescape Escape