需将结构化知识库数据接入神奇海螺试验场自定义数据模块，支持CSV文件上传、手动注入和API批量导入三种方式，分别适用于不同规模与场景需求。
如果您希望在神奇海螺试验场中引入专属知识内容并驱动个性化地图标记与分析能力，则需将结构化知识库数据接入其自定义数据支持模块。以下是实现该目标的具体操作路径：
一、准备符合规范的知识库数据文件
神奇海螺试验场当前仅接受以CSV格式组织的结构化地理语义数据，每条记录须包含明确的空间标识与属性描述，确保系统可自动解析地理位置并映射至省级行政单元。数据字段必须严格包含“province”（省份全称，如“广东省”）、“tag_type”（标记类型，须从预设六类中选择：“居住过”“游玩过”“工作过”“求学过”“途经”“计划去”）、“notes”（可选备注，不超过50字符）。
1、使用Excel或文本编辑器新建表格，按上述三列填写至少5条真实有效记录；
2、保存为UTF-8编码的CSV文件，文件名不得含空格或中文标点，推荐命名为“my_knowledge_v1.csv”；
3、检查province列中所有省份名称是否与国家统计局最新《中华人民共和国行政区划代码》完全一致，任何错别字（如“ Guangdong”“廣東”“粤”）均会导致上传失败。
二、通过地图界面手动注入知识条目
该方式适用于条目数量较少（≤20条）、需即时验证标记效果的场景。系统不依赖文件上传，而是将知识库内容逐条转化为交互式标记动作，直接写入当前会话的地图图层。
1、打开神奇海螺试验场网页，点击右上角“我的知识库”按钮进入管理面板；
2、点击“新增知识条目”，在弹出表单中依次输入省份名称、选择标记类型、填写简要说明；
3、点击“确认添加”，页面左下角将实时显示该省份在地图上的高亮色块；
4、重复步骤2–3，直至全部知识条目录入完毕，每次添加后务必等待3秒以上再操作下一条，避免接口限流导致丢失。
三、调用API批量导入知识库（需开发者权限）
当知识条目超过50条或需与内部业务系统打通时，应使用官方开放的RESTful API进行程序化注入。此方式绕过前端界面限制，支持异步提交与状态轮询，适合自动化流程集成。
1、登录神奇海螺试验场开发者中心，进入“API密钥管理”，生成一对有效期为30天的Access Key与Secret Key；
2、构造POST请求，目标URL为https://api.heluo.ai/v1/kb/import，Header中加入Authorization: Bearer {AccessKey}；
3、Body采用multipart/form-data格式，上传已准备好的CSV文件，并附加参数{"mode": "merge", "overwrite": false}；
4、收到HTTP 202响应后，记录返回的task_id，随后调用GET /v1/kb/task/{task_id}查询进度，仅当status字段返回“completed”且processed_count与total_count相等时，方可视为全部成功。
