Oh Chromium Knowledge

SKILL.md — oh-chromium-knowledge

OpenHarmony Chromium 知识库 Skill 供 AI 辅助设计工作流（arkweb-sdd）的 code-analysis、architect 等 skill 调用

元信息

• 知识库仓库: {owner}/{knowledge_repo} (GitCode 公开)
• 数据来源组织: openharmony-tpc (14 个 Chromium 相关仓库)
• Chromium 版本: M144 (144.0.7559.59)
• 适用场景: ArkWeb 代码分析、方案设计、代码审查、版本升级评估

1. 知识库读取协议

1.1 GitCode API 访问

BASE_URL = "https://gitcode.com/api/v5/repos/{owner}/{knowledge_repo}/contents"
AUTH = "PRIVATE-TOKEN: <TOKEN>"（优先 GITCODE_TOKEN，回退 GITLAB_TOKEN）

读取文件（返回 base64 编码内容）：

curl -sL "${BASE_URL}/{path}?ref=master" \
  -H "PRIVATE-TOKEN: ${GITCODE_TOKEN:-${GITLAB_TOKEN}}" \
  | jq -r '.content' | base64 -d

获取目录列表：

curl -sL "${BASE_URL}/{path}?ref=master" \
  -H "PRIVATE-TOKEN: ${GITCODE_TOKEN:-${GITLAB_TOKEN}}"

响应格式（单文件）：

{
  "name": "index.json",
  "path": "index.json",
  "sha": "abc123...",
  "content": "eyJ...base64...",
  "encoding": "base64"
}

**Token 获取：优先环境变量 GITCODE_TOKEN，回退 GITLAB_TOKEN，或从 .env 文件读取

1.2 Agent 必须遵守的读取顺序

Step 1: index.json                     ← 全局路由入口（必须先读）
Step 2: search/by_feature.json         ← 按功能需求快速定位
Step 3: search/by_module.json          ← 按模块定位
Step 4: repos/{repo}/meta.json         ← 仓库元信息（1-2个）
Step 5: repos/{repo}/architecture.md   ← 架构文档（1-2个）
Step 6: repos/chromium_src/arkweb_adapter/routing_table.json  ← 代码路径映射
Step 7: skills/（按需）                  ← 领域开发指南
Step 8: cross_repo/（按需）              ← 跨仓依赖分析

1.3 禁止事项

• ❌ 不要批量扫描 — 不要一次性读取所有 repos/ 下的文件
• ❌ 不要批量读取 search/ — 不要把所有搜索索引全部加载
• ❌ 不要自己拼路径 — 文件路径必须从 index.json 或 search/ 索引中获取
• ❌ 不要把知识库当源码 — 知识库仅作索引参考，具体实现请查看实际代码仓库
• ❌ 不要跳过 Step 1 — 必须先读 index.json 了解全局结构

2. 快速检索路由

2.1 按需求类型 → 推荐文件

routing_table.json 完整路径: repos/chromium_src/arkweb_adapter/routing_table.json

2.2 按 Chromium 模块 → 对应索引

2.3 按仓库 → 对应文件

3. 与其他 Skill 的集成方式

3.1 code-analysis skill 调用

场景: 分析 ArkWeb 特定功能的代码实现

code-analysis skill:
  1. 读取本知识库的 routing_table.json，确定代码路径
  2. 使用代码路径在 chromium_src 仓库中定位具体代码
  3. 结合 architecture.md 理解架构上下文
  4. 参考 chromium_rules.json 确保代码符合规范
  5. 如涉及 OHOS 适配，参考 ohos_dirs.json 和 ohos-adapter-guide.md

3.2 architect skill 调用

场景: 设计 ArkWeb 新功能方案

architect skill:
  1. 读取 arkweb_stack.json 理解完整技术栈
  2. 读取 dependency_graph.json 理解仓库间依赖
  3. 读取对应模块的 architecture.md 理解现有架构
  4. 参考 routing_table.json 中类似功能的实现模式
  5. 参考 upgrade_paths.json 了解版本演进方向

3.3 Subagent 调用示例

在 subagent 场景中获取上下文：

# 伪代码 — subagent 获取知识库上下文

1. 读取 index.json → 获取全局结构
2. 根据任务类型选择检索路径:
   - 功能开发 → search/by_feature.json
   - 模块分析 → search/by_module.json
   - 适配开发 → search/by_ohos_adapter.json
3. 读取 1-2 个相关文件获取具体信息
4. 在代码分析/方案设计中引用知识库信息

3.4 API 调用示例（Python）

import base64, json, urllib.request

TOKEN = "your_gitlab_token"
BASE = "https://gitcode.com/api/v5/repos/{owner}/{knowledge_repo}/contents"

def read_kb_file(path: str, ref: str = "master") -> dict:
    """读取知识库文件"""
    url = f"{BASE}/{path}?ref={ref}"
    req = urllib.request.Request(url, headers={"PRIVATE-TOKEN": TOKEN})
    resp = json.loads(urllib.request.urlopen(req).read())
    content = base64.b64decode(resp["content"]).decode("utf-8")
    return json.loads(content) if path.endswith(".json") else content

# 1. 读取全局路由
index = read_kb_file("index.json")

# 2. 按功能检索
features = read_kb_file("search/by_feature.json")
# 找到"滚动"相关文件
scroll_files = [f for f in features["features"] if f["name"] == "滚动"][0]["files"]

# 3. 读取路由表
routing = read_kb_file("repos/chromium_src/arkweb_adapter/routing_table.json")
scroll_paths = routing["routing"]["滚动"]["chromium_paths"]

4. 知识库维护

4.1 更新索引

手动更新:

1. 修改本地 {project_root}/ 中的文件
2. 通过 Git push 或 API 推送到 GitCode

API 更新（单文件）:

# 1. 获取当前文件 SHA
curl -sL "${BASE_URL}/{path}?ref=master" -H "PRIVATE-TOKEN: ${TOKEN}" | jq '.sha'

# 2. 更新文件
curl -X PUT "${BASE_URL}/{path}?ref=master" \
  -H "PRIVATE-TOKEN: ${TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "update {path}",
    "content": "'"$(base64 -w0 file.json)"'",
    "sha": "{current_sha}"
  }'

4.2 新仓库入库流程

1. 在 repos/ 下新建仓库目录
2. 创建 meta.json（从 GitCode API 获取仓库信息）
3. 创建 architecture.md（编写架构概述）
4. 更新 index.json 的 repo_index 和 repositories
5. 更新 cross_repo/dependency_graph.json（如有依赖关系）
6. 更新 search/by_module.json（添加新模块条目）
7. 提交推送

4.3 版本升级后更新

Chromium 版本升级后需要更新：

1. repos/chromium_src/meta.json — 版本号
2. cross_repo/upgrade_paths.json — 添加新升级路径
3. repos/chromium_src/architecture.md — 新特性和不兼容变更
4. repos/chromium_src/arkweb_adapter/routing_table.json — 新增/变更的代码路径
5. search/by_feature.json — 新增功能特性条目

5. 覆盖范围

5.1 14 个入库仓库

5.2 知识深度

5.3 不在覆盖范围内

• Chromium 上游原版代码（仅覆盖 OHOS 适配分支）
• ArkUI 框架层（ace_engine）的内部实现
• web_webview 的完整 API 文档（参考 oh_component_knowledge）
• 实际源码内容（知识库仅提供索引和架构描述）