Skip to content

feat(agentreach): 接入外部发现与补证后端链路 - #70

Merged
LetVGo merged 9 commits into
mainfrom
codex/agentreach-backend-named-actors
Jul 5, 2026
Merged

feat(agentreach): 接入外部发现与补证后端链路#70
LetVGo merged 9 commits into
mainfrom
codex/agentreach-backend-named-actors

Conversation

@Aspetta-arch

Copy link
Copy Markdown
Collaborator

概述

本 PR 提交 AgentReach 外部发现 / 补证后端链路,保持为次级信号层,不替代 GitHub / Trendshift 主链路和主评分结论。

主要内容:

  • 新增 src/externalDiscovery/ 后端模块,支持 AgentReach 上游 artifact 读取、字段归一、实体匹配、脱敏校验、候选聚合、候选解释、公开讨论者提取和外部讨论趋势窗口。
  • 接入 daily / weekly / run-summary / verify-daily,使外部发现、补证、方向观察、官方信号和趋势窗口可以进入后端产物与审计链路。
  • 增加 public-safe 边界:原始外部输入、候选解释缓存、账号态、cookie/session/OAuth/token/private diagnostics 不提交;公开 aggregate / trend window 需要通过脱敏校验。
  • 补充设计文档、exec-plan 和服务说明,记录 AgentReach 后端边界与后续 UI 消费契约。
  • 增加外部发现、补证、候选解释、公开 actor、趋势窗口、verification 等回归测试。

边界说明

  • 本 PR 只提交后端能力和后端消费链路,不包含 /agentreach 前端 UI 展示分支。
  • 不提交本地真实运行产物,不提交 data/raw/external-discovery/ 输入,不提交 candidate explanation cache。
  • 外部发现仍是 secondary-only 信号,只能作为候选观察和补证依据,不能直接提升为主榜高置信结论。

验证

  • pnpm exec tsc --noEmit
  • pnpm test,83 个测试文件 / 406 个测试通过
  • 额外针对 AgentReach 相关测试执行通过:31 个测试文件 / 139 个测试通过

代码质量检查

  • 未发现运行产物、UI 页面代码或本地临时目录混入本后端 PR。
  • 未发现 TODO / FIXME / debugger / ts-ignore / as any 残留。
  • 已将重复的外部平台枚举校验收敛为公共 isExternalPlatform
  • explanations.tstrendWindow.ts 体量偏大,但当前按规则职责拆分清楚且测试覆盖充分;后续如继续扩展,可再拆 selection / scoring / rendering 子模块。

@LetVGo
LetVGo merged commit 6c06556 into main Jul 5, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants