深知政务智查

该 skill 用于政务问答场景，优先给出可执行的办理步骤、条件、材料、渠道和依据。

配置

配置文件位于 skill 目录下的 config.ini：

endpoint: 调用地址，公开版默认使用 https://open.dknowc.cn/chat/trusted/unification
api_key: API Key。使用前请访问 https://platform.dknowc.cn 注册/登录并申请 API Key，然后填入 config.ini
sz_user_id: 用户标识，可选；如接入方要求传入用户标识再填写，普通公开版使用可留空
area: 默认 深圳市
credible_chat_scope: 默认 onlyNorms
stream: 默认 true
material: 默认 true，用于返回正文角标、参考材料、原文段落和源链接

首次使用前必须完成：

打开 https://platform.dknowc.cn。
注册或登录账号。
在平台申请 API Key。
打开本 skill 目录下的 config.ini，将申请到的 Key 填入 api_key。

不要把他人的 API Key 写入公开仓库或公开分发包。

session_id 默认留空。只有需要多轮对话上下文管理时，才通过配置或 --session-id 动态传入。

不要把 knowledgeServiceType 改成 credibleRecall。政务智查固定使用：

{
  "knowledgeServiceType": "credibleChat",
  "credibleChatScope": "onlyNorms"
}

调用方式

python3 {baseDir}/scripts/gov_chat.py "社保迁移怎么办理？"

常用调试：

python3 {baseDir}/scripts/gov_chat.py "社保迁移怎么办理？" --show-payload
python3 {baseDir}/scripts/gov_chat.py "社保迁移怎么办理？" --json-only
python3 {baseDir}/scripts/gov_chat.py "社保迁移怎么办理？" --auto-request-id
python3 {baseDir}/scripts/gov_chat.py "深圳公积金提取需要什么材料？" --material --item

输出默认是人类可读摘要；需要给其他程序消费时使用 --json-only，会输出聚合后的结构化 JSON。需要链路排查时使用 --auto-request-id 或显式传 --request-id。

地域规则

该 skill 面向深圳用户；当用户没有明确说明地域时，默认按 深圳市 处理。
当用户明确说明其他地域时，以用户指定地域为准，不要强行改回深圳市。
示例：用户问“公文会签需要哪些部门参与？”时，按“深圳市公文会签”理解；用户问“北京市公文会签需要哪些部门参与？”时，按北京市处理。

跨渠道稳定回复规则

政务智查的最终回复要优先保证用户能看懂、能核对、能复制链接。不要依赖特定渠道的 Markdown、表格、脚注或链接渲染能力。

面向用户回复时，正文保持自然表达，不插入 [^1^]、[依据1] 等标记。
接口返回的引用信息只用于筛选末尾“参考依据”，不要直接暴露给用户。
默认在回复末尾输出“参考依据”，只列出本次回复实际使用的来源，不要默认输出完整召回清单。
“参考依据”是该 skill 的核心特色，必须逐条、逐字段输出，不得压缩成“《标题》- 发布单位，日期”这种单行摘要。
每条参考依据必须保留以下字段：标题、发文字号（如有）、发布单位、发布日期、链接、相关内容。
每条参考依据内部字段必须换行展示，字段前使用 - 短横线；不同依据条目之间必须空一行，避免在聊天窗口中挤成一整段。
不要使用 Markdown 表格、HTML、[标题](链接)、查看、同上 等依赖渲染或上下文补全的表达。
链接必须以完整纯文本 URL 输出，用户复制或点击都应能使用。
如果接口未返回源链接或材料信息，明确写“接口未返回源链接”或“接口未返回对应材料”，不得补写或猜测来源。
如果某个字段接口未返回，保留字段名并写“接口未返回”，不要直接省略该字段。
如果用户追问“哪句话对应哪条依据”，再输出“观点与依据对应”清单；默认回答不做逐句标注。

推荐格式：

回复内容：
深圳市保障性住房主要包括公共租赁住房、保障性租赁住房和人才住房三类。
符合条件的青年人才可关注租金补贴、过渡性住房或人才住房配租政策。

参考依据
1. 《深圳市保障性住房管理办法》
   - 发文字号：深府规〔2023〕...号
   - 发布单位：深圳市人民政府
   - 发布日期：2023-...
   - 链接：https://...
   - 相关内容：...

2. 《...》
   - 发文字号：接口未返回
   - 发布单位：接口未返回
   - 发布日期：接口未返回
   - 链接：接口未返回源链接
   - 相关内容：...

如果用户追问“来源在哪”“依据怎么看”，优先重新列出本轮已使用的“参考依据”纯文本来源清单；只有用户明确要求“完整来源清单”时，才输出完整材料列表，并仍然使用纯文本列表，不使用表格。

回答原则

优先给用户可执行的办理步骤、条件、材料、渠道。
涉及政策依据时，打开 --material 或在配置中启用 material=true。
涉及线上办理入口时，打开 --item 或在配置中启用 item=true。
不要把“原文清单/召回结果”作为默认体验。