HyperLeo AgentOS Dashboard · 数据架构、素材来源与设计逻辑 / Data architecture, sources & design logic
| 页面 | 作用 |
|---|---|
index.html | 技能管理看板 Skills：技能目录的表格展示（搜索 / 筛选 / 排序 / 详情） |
governance.html | 治理看板 Governance：结论优先的治理摘要、行动队列、技能工作台与能力版图 |
about.html | 本页：设计说明与素材来源 |
一句话：看板是“只读投影”，不是数据源；真正的数据由本地治理技能扫描产生，网页只负责展示。
治理看板由 hyperleo-ui-sentinel 的设计品味契约与 hyperleo-skill-governance 的治理数据共同驱动：
no_data 显式展示，禁止用 0 或空字符串假装；异常数字可定位到技能行与规则编号。| 素材 | 来源 | 位置 / 说明 |
|---|---|---|
| Skills 元数据 | GitHub HyperLeo86/codex-skill-hub + 本地安装库 |
~/.codex/skills/（当前快照 24 个技能）；读取 SKILL.md frontmatter：name / description / license / metadata.version |
| SKILLCARD | 技能目录内 SKILLCARD.yaml |
部分技能提供，用于补充分类、成熟度与展示名称 |
| 治理数据 | hyperleo-skill-governance 扫描脚本 | scan_registry.py → registry.json / registry.db；gov_rules.py → queue.json |
| 数据库（唯一真相源） | 本地 SQLite | ~/.codex/skill-governance/registry.db（本地文件，不随网页发布） |
| Schema | 治理技能 references + canonical + GitHub | registry.schema.json、skillcard.schema.json（最新版见第 5 节） |
| 环境变量 | ~/.codex/.env（23 个键名） |
仅供本机工具使用（部署密钥 / API Key 等）；本网页不读取、不展示任何密钥值 |
| 部署链路 | GitHub 仓库 + hyperleo-ecs-deploy 技能 | rsync → docker compose → nginx → https://agentos.togee.cn（旧版 IP:8080 保留作回退） |
唯一真相源是本地 SQLite 数据库 registry.db，网页只是它的快照投影。完整链路：
本地唯一真相源（SQLite registry.db，当前 24 个技能）
│ scan_registry.py 导出
▼
registry.json（机器可读导出）+ queue.json（治理队列）
│ cp 拷贝（快照）
▼
网页仓库 governance-registry.json / governance-queue.json
│ docker/nginx 静态托管
▼
https://agentos.togee.cn/governance.html
因此：数据库在本地，网页在远端，二者不是实时连接。要更新网页数据，必须重跑扫描 → 拷贝 → 部署（见第 6 节）。这是设计有意为之（看板只读、无后端、无密钥），代价是数据有快照延迟。
| 项目 | 路径 | 状态 |
|---|---|---|
| 真实数据库（唯一真相源） | ~/.codex/skill-governance/registry.db |
SQLite，本地唯一真相源 |
| 注册表 JSON 导出 | governance-registry.json |
24 个技能的公开快照；部署前移除本机绝对路径 |
| 治理队列 JSON | governance-queue.json |
当前治理队列快照 |
| registry.schema.json（最新） | ~/.codex/skills/hyperleo-skill-governance/references/ + ~/Documents/codex-skill-hub/hyperleo-skill-governance/references/ + GitHub commit 55aa170 |
6,910 B，含 declared_envs |
| registry.schema.json（旧副本） | /Users/leo/Documents/Codex/2026-08-09/guan/outputs/ |
6,837 B，缺 declared_envs，建议以技能内版本为准 |
| skillcard.schema.json | 技能 references / canonical / outputs | 1,363 B，SKILLCARD.yaml 契约 |
| 设计默认数据目录 | ~/.codex/skill-governance/ |
已启用，保存 registry.db 与 usage.db |
mkdir -p ~/.codex/skill-governance
python3 ~/.codex/skills/hyperleo-skill-governance/scripts/scan_registry.py --root ~/.codex/skills --out ~/.codex/skill-governance/registry.json --db ~/.codex/skill-governance/registry.db
python3 ~/.codex/skills/hyperleo-skill-governance/scripts/gov_rules.py ~/.codex/skill-governance/registry.json --out ~/.codex/skill-governance/queue.json
cp ~/.codex/skill-governance/registry.json ~/Documents/Codex/HyperLeo-AgentOS-Dashboard/governance-registry.json
cp ~/.codex/skill-governance/queue.json ~/Documents/Codex/HyperLeo-AgentOS-Dashboard/governance-queue.json
cd ~/Documents/Codex/HyperLeo-AgentOS-Dashboard
git add governance-*.json && git commit -m "data: 刷新治理数据快照" && git push origin main
python3 ~/.codex/skills/hyperleo-ecs-deploy/scripts/deploy.py --card deploy-card.json --apply
以后可以把这一段做成一条命令或自动化（例如：重新扫描 → 拷贝 → 提交推送 → 部署），需要的话告诉我。
COPY . 并做多路径验证。sync_status="local" 不在 schema 枚举里；5 份 SKILLCARD 的 skill_type 大小写与 schema 不一致。