# 友点AI (YouDian AI)

> 告诉友点AI你想解决什么——提交需求/想法、投稿AI产品、查询审核状态。
> 友点AI相信：所有互联网产品，都值得用AI重新做一遍。

## 何时使用

当用户说出类似下面的话时，使用本 Skill：

- "帮我给友点AI提个需求" / "我有个软件想法，帮我提交给友点AI"
- "给友点AI反馈一下，XX 能不能支持 XX 功能"
- "帮我把我的AI工具/产品提交到友点AI"
- "帮我看看昨天提交给友点AI的需求审核了吗"

## 配置

```
YOUDIANAI_BASE_URL = https://youdianai.cc
YOUDIANAI_API_KEY  = yd_live_xxxxxxxx   # 向友点AI管理员申请
```

所有请求携带请求头：

```
Authorization: Bearer $YOUDIANAI_API_KEY
Content-Type: application/json
```

## Action 1: submit_feedback — 提交需求/意见/想法

`POST https://youdianai.cc/api/v1/feedback`

请求体：

```json
{
  "type": "new_product | feature | improve | work | life | redo | other",
  "title": "一句话标题（2-120字）",
  "content": "整理后的详细描述",
  "original_input": "用户的原话（必填，原样保留）",
  "agent": "你的Agent名称，如 claude-code",
  "skill_version": "1.0.0",
  "product_slug": "关联产品slug（可选，如 mdfk）",
  "product_name": "提到的软件名（可选，如 Outlook）",
  "problem": "现在遇到了什么问题（可选）",
  "current_solution": "当前是怎么解决的（可选）",
  "pain_point": "哪里最麻烦（可选）",
  "expect_ai": "希望AI怎么解决（可选）",
  "attachments": [{ "name": "截图", "url": "https://..." }],
  "contact": { "name": "昵称", "email": "a@b.c", "wechat": "wxid" },
  "co_create": "willing | unwilling | contact_me"
}
```

响应：`{ submission_id, status: "pending", track_url }`

### 整理规则（重要）

1. **必须保留 original_input**：用户的原话一字不改地放入 original_input，你整理的结果放入 title/content。后台会同时展示两份，避免你理解错误。
2. title 是一句短语（≤30字更好）；content 按你理解的结构化描述写。
3. 能识别出关联产品时尽量填 product_slug 或 product_name。
4. type 判断：新产品想法→new_product；某软件缺功能→feature；改进现有产品→improve；工作流程问题→work；生活场景→life；"XX该重做一遍"→redo。

### 示例

用户说："帮我告诉友点AI，我希望他们做一个能根据文件内容自动整理文件夹的软件。"

你应提交：type=new_product, title="AI文件整理助手", content="用户希望系统根据文件内容，而不是依靠文件名和目录，对本地文件进行自动识别、分类和整理。", original_input="帮我告诉友点AI，我希望他们做一个能根据文件内容自动整理文件夹的软件。"

## Action 2: submit_product — 提交AI工具上架

`POST https://youdianai.cc/api/v1/products`

请求体：

```json
{
  "name": "产品名称（必填）",
  "tagline": "一句话介绍（必填）",
  "description": "详细介绍（必填，≥10字）",
  "website": "https://官网（必填）",
  "ai_value": "AI改变了什么（必填）——这个产品到底用AI重新做了什么",
  "developer": "开发者名称",
  "category": "AI写作|AI视频|AI开发|AI设计|AI Agent|AI办公|AI输入|AI搜索|AI效率|AI生活",
  "tags": ["标签1", "标签2"],
  "platforms": ["Web", "Windows", "macOS", "iOS", "Android", "浏览器插件"],
  "pricing": "免费|Freemium|付费|订阅",
  "github": "https://github.com/...",
  "logo": "emoji或图片链接",
  "screenshots": ["https://截图链接"],
  "core_features": "核心能力，每行一条",
  "contact": { "name": "联系人", "email": "a@b.c" },
  "original_input": "用户的原话"
}
```

响应：`{ submission_id, status: "pending", track_url }`

信息不全时，先向用户询问：官网是什么？产品主要做什么？AI改变了什么？整理完整后再提交。

## Action 3: query_submission — 查询审核状态

`GET https://youdianai.cc/api/v1/submissions/{submission_id}`

响应：`{ submission_id, title, status, status_label, track_url, review_note }`

status 可能的值：pending（待审核）/ reviewing（审核中）/ approved（已通过）/ rejected（已拒绝）/ merged（已合并）/ to_internal（转内部）/ to_idea（转创意广场）/ to_product_req（转产品需求池）/ to_redo（转AI重做清单）/ in_dev（研发中）/ done（已完成）。

## 行为准则

- 所有提交的内容默认进入待审核，不会直接上线；不要向用户承诺"已发布"。
- 不要代替用户编造需求；原话与整理内容必须能对应。
- 同一需求不要重复提交；查询即可。
- 尊重频率限制（默认每 Key 每小时 20 次），超限会返回 429。
- 提交成功后，把 submission_id 和 track_url 告诉用户，方便其查询进度。

## 未来将开放的能力

search_products（搜索友点AI产品）/ search_ideas / search_redo / vote_idea / comment_idea / submit_bug。