开发者指南：结构与边界
以当前实现和最新决策为准。历史测试记录是证据，不意味着全部业务流程已经产品化。
GitHub项目与开发入口
- 主体核验项目实体仓库：业务代码、来源适配、搜索工具、宿主机开发桥接、测试和开发说明。
- 项目开发接续指南：获取源码、配置环境和运行离线验证。
- 本指南源码仓库：公开文稿、生成器和静态资源。
以上源码仓库均为私有，需要项目所有者授予GitHub访问权限。指南网页公开不代表业务代码开源，也不代表查询API已对外部署。
git clone --recurse-submodules https://github.com/chenponsh/entity_identity_agent.git模块关系
调用方
└─ entity_api：HTTP异步接口、SQLite队列、输入校验
└─ service：定位、多候选、渠道预算、结果封装
├─ 工商CLI适配
├─ nhc_query：医疗登记浏览器适配
└─ internet：已登记官方网页／PDF读取
entity_search：CleverSee标准库客户端、CLI、共享缓存
├─ 独立工具调用
└─ Hermes插件 → 原生web_search
下一阶段：把共享搜索与语义判断接入业务定位／统计流程已运行的业务路径
有信用代码时精确查并核对返回代码；正常未命中或格式异常且有名称时回退名称。来源失败与未命中分开，不对代码模糊搜索。
当前名称路径仍先做工商名称精确查询，未命中后用工商关键词搜索候选，再按稳定标识逐一核验。当前分数是名称包含关系／字符相似度，不是互联网语义概率。
没有选择工商时不隐式补查。已登记规范全称可通过本次可信网页建立上下文；未登记名称及单医疗渠道的通用独立定位仍有缺口。
已确认但尚待接入的路径
名称查询优先互联网发现现实称谓、旧名、合并与院区关系，再形成候选并精确核验。CleverSee主检索提供方已经确定并交付；仍需把检索结果转为可审计的候选判断、业务范围、weight与统计事实。
实现时保留原有信用代码精确优先分支，不能让语义模型修改代码或把院区名称凭空变成独立法律主体。
执行约束
来源串行、有单次预算与医疗提交间隔。工商某维度无权限后停止重复查询该维度；额度或授权失败停止后续工商调用。预算未覆盖的候选仍需保留说明。
业务任务保存每次来源调用的独立证据目录，避免多候选覆盖。队列重启不会自动重跑中断任务。检索工具有一小时成功缓存与按查询锁；生产级整体截止时间、跨服务预算和外部鉴权仍待完善。
开发者首先检查什么
- API输入和当前schema_version，而非旧版本字段草案。
- 每次来源响应的真实形状、状态和权限，而非传统接口的假定契约。
- 候选去重依据是否为信用代码／稳定ID，同名不同标识能否独立返回。
- mask是否控制渠道，输出是否按属性归组。
- 新值是否保留口径、统计年、来源与推断关系。
- 测试是否区分合成页面、模拟适配器和真实来源调用。
源码导航
| 相对路径 | 责任 |
|---|---|
| entity_api/ | API、持久队列、匹配、结果和登记网页适配 |
| nhc_query/ | 浏览器、限速、验证码协作、医疗字段读取 |
| entity_search/ | CleverSee共享客户端与缓存 |
| entity_host_bridge/ | 运行主机后台开发任务、状态、取消及受限Git备份入口 |
| integrations/hermes/ | 原生工具插件和共享技能 |
| tests/ | 离线、HTTP、浏览器合成场景及工具测试 |
| docs/ | 内部详细接口与设计文档 |
此公开站是经过整理的发布快照；内部文档中的部署信息和证据文件不随站点公开。更新站点时需对照代码及状态记录，不自动把全部内部Markdown发布出去。
Telegram／Hermes到宿主机的开发与Git入口现已实现，手机Git状态收发、真实Codex任务和私有GitHub推送均已验证。它服务开发协作，不是对外业务查询API；使用方式见宿主机开发说明。