BK
标签投稿

工具模板

内容

工具模板

这个页面就是后续新增自定义工具时可直接照抄的 starter template。

目录结构

content/
├── tags.json
├── list.json
└── my-tool/
    ├── meta.json
    ├── en.index.md
    ├── zh.index.md
    ├── en.installation.md
    ├── zh.installation.md
    ├── en.configuration.md
    ├── zh.configuration.md
    ├── en.data.md
    ├── zh.data.md
    ├── en.faq.md
    └── zh.faq.md

meta.json

{
  "title": { "en": "My Tool", "zh": "我的工具" },
  "description": {
    "en": "One-line summary for cards and page headers.",
    "zh": "用于卡片和页面头部的一句话说明。"
  },
  "github": "https://github.com/example/my-tool",
  "link": ["agent-browser"]
}

content/tags.json

[
  { "key": "devTools", "en": "Dev Tools", "zh": "开发工具" },
  { "key": "open-source", "en": "Open Source", "zh": "开源" }
]

content/list.json 注册示例

{
  "slug": "my-tool",
  "path": "my-group/my-tool",
  "tags": ["devTools", "open-source", "free", "cli", "web"]
}

只有当内容目录和 URL slug 不一致时才需要写 path。 例如 slug: "zzci-chrome" 可以对应到 path: "zzci/chrome"。 标签文案定义放在 content/tags.json，工具条目里只引用 tag key。

常用标签

  • images
  • devTools
  • containers
  • open-source
  • free
  • desktop
  • cli
  • web
  • privacy
  • docker
  • self-hosted
  • automation
  • proxy

初始页面

en.index.md

---
title:
  en: Introduction
  zh: 简介
order: 0
---

## Overview

Describe what the tool does, who it is for, and why it matters.

## Related Workflows

Mention adjacent tools with placeholders like [[agent-browser]] or [[zzci-chrome|zzci/chrome]].

en.installation.md

---
title:
  en: Installation
  zh: 安装
order: 1
---

## Installation

Add the shortest working setup path.

en.configuration.md

---
title:
  en: Configuration
  zh: 配置
order: 2
---

## Configuration

List the switches, ports, files, or environment variables people need.

en.data.md

---
title:
  en: Data & Storage
  zh: 数据说明
order: 3
---

## Data & Storage

Explain what state is persisted, what is ephemeral, and what should be backed up.

en.faq.md

---
title:
  en: FAQ
  zh: 常见问题
order: 4
---

## FAQ

Add the real questions people will ask after trying the tool.

复制同样结构的 zh.*.md 文件，再把正文翻译成中文即可。

占位符链接

请不要在 Markdown 里直接写死带语言前缀的路径，统一使用占位符：

[[agent-browser]]
[[zzci-chrome|zzci/chrome]]
[[bkd/data|数据说明]]

渲染时会自动替换成当前语言的站内链接。