release: bump version to 0.71.0

docs/technical/zh/earth-news-sources.md

@@ -86,6 +86,55 @@ Earth 态势新闻使用 `/api/v1/news/earth-feed` 输出给前端。新闻源
 
 `GET /api/v1/earth/news-sources` 返回默认或已保存配置。`PUT /api/v1/earth/news-sources` 保存配置并递增 `cache_version`，同时清理进程内 region cache。`POST /api/v1/earth/news-sources/reset` 恢复默认源。`POST /api/v1/earth/news-sources/test` 只测试单个 RSS/Atom/Aggregated 源，不写入新闻表。
 
+## 手动新闻内容
+
+手动新闻是内容管理能力，不是 RSS 源配置。Admin 入口是 `智能星球内容 -> 新闻内容`，左栏按 RSS 来源和手动新闻组聚合；进入手动组详情后可以按条添加新闻或上传 JSON 数组批量导入。手动新闻写入 `earth_news_items`，并标记 `feed_type/source_type = manual`；前台展示文案是“手动添加”。它不参与 RSS 连通性测试，也不会进入 RSS 抓取流程。
+
+手动新闻采用“先展示，再精修”的策略：
+
+1. 保存后立即写入 `earth_news_items`。
+2. 没有人工坐标时使用所选区域锚点，`verified=false`。
+3. 有人工坐标时使用 `location_source=manual_location`，`verified=true`，后续 AI 精修不会覆盖该坐标。
+4. 创建或重新处理后进入新闻增强队列，后台补清洗、翻译、分类、重要度、Breaking 和目标位置推断。
+5. 精修完成后更新同一条新闻，并通过 Earth news reload / patch 让前端无感替换。
+
+后台接口挂在 `/api/v1/earth/news-items`：
+
+- `GET /earth/news-groups`：返回 RSS 虚拟来源组和手动新闻组。
+- `POST /earth/news-groups`：新建手动新闻组。
+- `PUT /earth/news-groups/{group_id}`：重命名手动新闻组，并同步组内新闻 meta。
+- `GET /earth/news-items`：分页查询 RSS 与手动新闻，支持来源类型、区域、类型和状态过滤。
+- `POST /earth/news-items`：新增一条手动新闻。
+- `POST /earth/news-items/import`：上传 JSON 数组批量导入，`group_id` 指定当前手动新闻组。
+- `PUT /earth/news-items/{id}`：编辑手动新闻；RSS 新闻只读。
+- `DELETE /earth/news-items/{id}`：删除手动新闻，并触发 Earth 新闻重载。
+- `POST /earth/news-items/{id}/reprocess`：重新进入清洗、翻译和定位队列。
+
+JSON 导入首版只支持数组：
+
+```json
+[
+  {
+    "title": "必填标题",
+    "summary": "可选摘要",
+    "content": "可选正文",
+    "url": "https://example.com/story",
+    "source": "手动添加",
+    "region": "global",
+    "published_at": "2026-05-15T03:00:00Z",
+    "category": "business",
+    "tags": ["manual", "analysis"],
+    "location": {
+      "label": "北京市, 中国",
+      "latitude": 39.9057,
+      "longitude": 116.3913
+    }
+  }
+]
+```
+
+重复导入使用稳定 ID 去重，ID 由标题、发布时间、URL 和来源生成，格式为 `manual:{hash}`。同一条手动新闻再次导入会更新原记录，不会重复出现在 EarthFeed。
+
 ## Feed 查询与类型过滤
 
 星球端和 UE 端统一使用 `GET /api/v1/news/earth-feed` 获取新闻。接口支持服务端过滤，不要求客户端拿全量列表后自行筛选。
@@ -107,6 +156,8 @@ GET /api/v1/news/earth-feed?region=global&categories=business,ecommerce&locale=z
 
 Web 星球端的新闻类型按钮只保存当前浏览器的显示偏好；偏好变化后会重新请求接口。UE 端应直接把类型选择拼到 `categories` 参数里，不需要再做主过滤。
 
+未指定 `sources` 时，服务层会优先选择当前 `locale` 已有可展示标题和摘要的新闻，并从当前启用来源补齐候选后做来源轮转，避免一个来源的最新待处理条目占满默认 12 条。指定 `sources` 时保持精确来源过滤，不做跨来源补齐。数据库查询层只负责区域、类型、来源和排序条件，不包含语言展示策略。
+
 源测试只证明当前 RSS/Atom/XML 能解析到条目，不等于这些条目已经入库展示。展示链路还会检查区域、类型过滤和数据库新鲜度。保存或重置新闻源会递增配置版本并清理缓存；如果当前启用的 Feed 子项在库里没有近期条目，下一次 `earth-feed` 请求会补抓，避免新启用的 36氪、亿邦被旧 Google News 缓存挡住。
 
 ## Breaking News 插队
@@ -163,9 +214,11 @@ Admin 入口是 `Earth 内容 -> 新闻源`。界面不是整包 JSON 编辑，
 ```mermaid
 flowchart LR
   Admin["Admin: Earth 内容 / 新闻源"] --> Source["Source 配置"]
+  ManualAdmin["Admin: Earth 内容 / 新闻内容"] --> ManualAPI["/api/v1/earth/news-items"]
   Source --> Feed["Feed 子项"]
   Feed --> ConfigAPI["/api/v1/earth/news-sources"]
   ConfigAPI --> Config["SystemSetting: earth_news_sources"]
+  ManualAPI --> Store
 
   Earth["Earth 新闻面板"] --> NewsAPI["/api/v1/news/earth-feed"]
   NewsAPI --> Resolver["Source Resolver"]