Skip to content

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

深知晓(skills.sh 渠道版本)

这是深知晓的 skills.sh 渠道分发版本。功能逻辑与 full 版保持一致,但不内置深知可信统一接口 API Key;首次调用本 Skill 时,由 Agent 通过 MaaS 注册接口完成手机号注册、验证码确认、API Key 获取和本地配置写入,用户只需提供手机号和收到的验证码。MaaS 管理平台地址为 https://platform.dknowc.cn/ ,新用户注册后会有 300 次体验额度;体验额度用完后,可到 MaaS 管理平台充值。完成实名认证后,平台也可能提供 100 元赠金,具体以 MaaS 平台页面展示为准。

能力范围

  • 咨询导办:调用深知可信统一接口 credibleChat 能力,回答税务社保、法规政策、行业标准、证照补贴资质申办、买房购车、养老育儿、上学就业等工作与公共服务问题。
  • 可信搜索:用户明确要求查找原文、依据、材料、来源或召回结果时,调用 scripts/trusted_search.py 返回重点材料摘要和知识专库链接。
  • 深度搜索:复杂政策研究、方案设计、多地区/多层级政策对比、企业补贴与税惠综合判断等场景,可调用 scripts/deep_query.py 接入深度搜索接口,输出搜索过程、分组和重点材料。
  • 复杂任务:支持企业补贴测算、税务优惠判断、政策调研、跨地区对比、投标方案背景和合规义务分析等多轮澄清式 ReAct 工作流;信息不足时先追问关键条件,必要时先搜索建立证据池再追问。
  • 分析写作:支持分析调研、拟稿写文等工作场景,输出内容可逐项索引于动态更新的权威知识网络。
  • 本地化服务:支持结合用户问题智能识别或切换城市,提供本地化精准知识服务。
  • 可信溯源:问答模式默认返回可信溯源报告链接,来源核验以报告页为准。
  • 稳定输出:脚本只输出接口正文的必要清洗版,不在聊天窗口重组参考依据、事项清单或政策文件清单。
  • 默认参数:问答模式使用 credibleChatScope=allmaterial=trueitem=truepolicy=truetraceurl=truestream=true;搜索模式默认 policy=trueitem=trueknow_base=truesegment_count=2simplified=true

首次启动初始化

skills.sh 渠道版的初始化与具体任务无关:只要调用本 Skill,Agent 就应先运行 python3 scripts/initialize.py。只有返回 ready=trueconfig_ini=trueapi_key_configured=true 后,才继续处理原任务。简单咨询、整理、改写、拟稿、分析等场景也遵循该规则。

如果初始化结果显示 api_key_configured=falseconfig_ini=false,或 blocking_issues 包含 api_key_missing,必须先引导用户完成 Key 复用或 MaaS 注册配置,不得先输出答案、草稿、大纲、材料清单或分析结论。

注册并配置深知可信统一接口 API Key

skills.sh 渠道版默认使用:

  • 接入点 type=11,即可信统一接口。
  • 渠道码 8C8D411C-6A46-4E99-887D-87D9A1329930
  • 本地 config.ini 保存可信统一接口 Key,由 Agent 自动创建,公开包不携带该文件。

如果当前深知晓没有配置 Key,Agent 会先询问用户是否允许复用当前运行环境已安装 Skills 目录下其他 dknowc* Skill 的本地 Key。用户同意后可执行:

node scripts/register.mjs scan-reuse
node scripts/register.mjs reuse-key --from <候选目录名或 slug>

扫描范围仅限当前 Skill 同级目录下一级 dknowc* Skill,只读取 _meta.jsonconfig.ini,不会展示完整 Key。

如用户不复用、未找到候选或复用失败,再进入 MaaS 注册。注册第二步会携带平台固定 grantToken,手机号已注册时可通过验证码查回已有可用 API Key;默认不主动新建 Key。第 1 步,发送短信验证码:

node scripts/register.mjs send --phone 13812345678

返回 status=true 后,暂停并请用户提供收到的 6 位验证码。

第 2 步,注册并获取 API Key:

node scripts/register.mjs register --phone 13812345678 --vcode 123456 --organ 个人 --name 用户

成功后,脚本会把 API Key 自动写入本 Skill 根目录下的 config.ini,不会在标准输出中返回完整 Key。用户不需要手动复制 Key,也不需要手动编辑配置文件。

如自动注册链路失败,可降级访问 MaaS 管理平台:

https://platform.dknowc.cn/

可信统一接口固定为:

https://open.dknowc.cn/chat/trusted/unification

可信搜索接口固定为:

https://open.dknowc.cn/dependable/search

深度搜索接口固定为:

https://open.dknowc.cn/llm-api/proxy-builtin/deep-query/v2

config.ini 只存在于用户本地安装后的 Skill 目录中,不得上传、打包或公开分享。发布包检查会阻止该文件进入公开包。

常用测试

语法检查:

python3 -m py_compile scripts/initialize.py scripts/gov_chat.py scripts/trusted_search.py scripts/deep_query.py scripts/check_release.py
node --check scripts/register.mjs

发布检查:

python3 scripts/check_release.py

请求参数检查:

python3 scripts/gov_chat.py "社保迁移怎么办理?" --show-payload --dry-run
python3 scripts/trusted_search.py "公积金租房提取政策原文" --show-payload --dry-run
python3 scripts/deep_query.py "重庆智能化改造补贴和税惠综合判断" --area 重庆 --show-payload --dry-run

Public 版说明

  • 本版本 slug 为 dknowc-know,展示名为“深知晓”。
  • 本版本不内置 API Key。
  • 用户可通过 Agent 调用 scripts/register.mjs,用手机号和验证码注册 MaaS 账号并获取深知可信统一接口 API Key。
  • 注册成功后,Agent 自动把 API Key 写入本地 config.ini,用户不需要查看或手动配置 Key。
  • MaaS 管理平台地址为 https://platform.dknowc.cn/,可用于查看体验额度、充值;完成实名认证后,平台也可能提供 100 元赠金,具体以 MaaS 平台页面展示为准。
  • 如调用失败或提示 API Key 未配置,请重新执行注册流程或检查本地 config.ini 是否存在且有效。

About

深知晓 GitHub Public 版 Agent Skill

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages