---
name: discourse_forum
description: Use for public Discourse-based community discussions, especially Linux DO, when queries need Chinese AI/dev forum posts and native operator troubleshooting.
version: 1
languages: [zh, mixed]
methods:
  - id: api_search
    impl: methods/api_search.py
    requires: []
    rate_limit: {per_min: 20, per_hour: 400}
fallback_chain: [api_search]
when_to_use:
  query_languages: [zh, mixed]
  query_types: [community, developer, product-feedback, tech-discussion, chinese-ugc]
  domain_hints: [linux.do, linux do, discourse, forum, claude code]
  avoid_for: [academic, consumer-lifestyle, multimedia]
quality_hint:
  typical_yield: medium
  chinese_native: true
layer: leaf
domains: [chinese-ugc]
scenarios: [developer-community, ai-tools, troubleshooting, public-forum]
model_tier: Fast
---

## Overview

Public Discourse communities are a distinct forum surface: long-form troubleshooting, operator notes, product limitations, and community-native workarounds. This channel starts with Linux DO as the first built-in source.

## How To Search

- `api_search` — queries the site's public Discourse search endpoint and maps topic-oriented results into canonical topic URLs.

## Known Quirks

- Discourse search payloads can vary by site version and plugin stack.
- Some public forums may block anonymous search or require region-specific network access.
- v1 ships with a built-in Linux DO preset only; more Discourse communities can be added later through site presets.

# Quality Bar

- Evidence items have non-empty title and url.
- Multiple posts from the same topic deduplicate to one evidence item.
- HTTP or payload failures degrade to an empty result list.
