前言¶
在 DeepSeek Harness（DSH）里做计算机相关问答或助教场景时，模型常会给出带版本号、API 或标准条款的陈述，并附上若干 URL。问题在于：这些链接是否属于可采信的官方或同行评议来源，引用层级是否合适，草稿里有没有「写了事实却未挂信源」的段落——若只靠模型自判，难以形成一致规则。
cs-source-reliable 面向上述痛点：它把 119 个经过探测登记的可采集 CS 信源打成注册表数据，并提供两个仅做本地查表的工具（不发起联网请求），再在系统提示里约定何时查找、如何引用、何时做引用审计。下面介绍插件定位、能力与安装用法。
这是什么¶
cs-source-reliable 是 DSH 的联网工具类插件（分类：联网工具；设置里显示为 CS source reliability）。它在 Harness 内捆绑一份信源注册表，覆盖 CS2023 的 17 个知识领域；信源分为教学层（教材、课程、官方文档、标准等）与前沿层（预印本、会议论文、发行说明、安全通告等）。插件不拦截用户请求，由模型在系统提示片段（order 240，位于 plugin-guidance 区间）引导下决定是否调用工具。
维护者与社区目录条目见 SkillHub 与 GitHub 仓库（安装命令以 README 原文为准，见下文）。
注册表里有什么¶
资料记载的规模与字段如下。
- 119 个信源：68 个教学层、51 个前沿层。
- 每条记录含权威层级（
A主规范/官方文档/发行渠道，B同行评议/权威来源，C经策展的二次来源，D仅作线索）、证据类型、content_access（static / portal / js / redirect / frameset / api / binary）、license_class、cache_policy、attribution、refresh_days、last_checked，以及所服务的 CS2023 知识领域代码。
两个面向模型的工具均基于该注册表做本地查找，README 称 Registry 加载约 0.7–2.6 ms，调用延迟在亚毫秒量级；工具输出有上限（例如查找默认最多 5 条、上限 20 条，备注截断至 180 字符）。
核心工具¶
cs_source_find¶
按 URL、关键词或 CS2023 领域代码查找信源。
参数要点：
url：匹配页面（主机 + 路径前缀）。query：关键词，例如"algorithm textbook"或"RFC"。ka：知识领域代码之一：AL AR CN DM DS FPL GV HCI IS MSF OS PDC SEC SE SEP SF SPD。layer：breadth（教学）或depth（前沿）。limit：结果数量上限（默认 5，最大 20）。
返回紧凑记录，含层级、访问方式与刷新策略。示例：
- [python-docs] Python Documentation — A/official-doc; access=static; refresh=30d; https://docs.python.org/3/
关键词排序采用类 IDF 的 token 权重，并对学科 token 加权，使如 "python 3.13 release notes" 更偏向 Python 相关信源。
cs_source_audit¶
对草稿答案中的 URL 引用做机械审计：将每个 URL 映射到已知信源或标为未知，报告层级与访问方式，标出未知域名及 C/D 级引用，统计缺少信源的实质性段落，并给出修正建议。
示例输出形态：
Citations: 2/2 audited, 1 known, 1 unknown; A=1 B=0 C=0 D=0; uncited paragraphs=0
- https://docs.python.org/3/ -> python-docs (A/official-doc)
- https://example.com/blog/post -> unknown; not in the registry: verify the domain yourself before relying on it
模型侧的触发约定¶
README 中的约定包括：
- 在陈述依赖版本、API、标准或「当前状态」的 CS 事实前，先调用
cs_source_find。 - 优先 A/B 级信源；C 作二次参考，D 仅作线索，不得当作事实依据。
- 引用格式为
[source-id] URL，并写明信源上的版本或日期；若无合适注册表项则标明 unsourced。 - 在发送含 URL 引用的草稿前，调用
cs_source_audit。 - 非 CS 话题可跳过两个工具。
安装与启用¶
要求：DeepSeek Harness >=0.2.1-rc.1 <0.3.0-0，Node.js 20+。安装后需重启或重载 profile；插件出现在 Settings → Plugins。
推荐从 release 压缩包安装（README 写明无需构建步骤）：
dsh plugin --profile web add https://github.com/uhygyuf/cs-source-reliable/releases/latest/download/cs-source-reliable.tgz
从 GitHub 源仓库安装：
dsh plugin --profile web add github:uhygyuf/cs-source-reliable
本地开发目录：
dsh plugin --profile web add /absolute/path/to/cs-source-reliable
插件以当前 dsh 进程权限运行；安装前应自行查看仓库源码与许可证（MIT）。社区目录站点 SkillHub 与 DeepSeek / 幻方无官方从属关系，不宜当作官方应用商店。
典型用法（与 README 一致）¶
- 助教或答疑前，用
cs_source_find的query或ka锁定教材、RFC、官方文档等 A/B 级来源。 - 生成含外链的草稿后，用
cs_source_audit清点未知域名、C/D 引用与未引用段落，再改稿。 - 对版本敏感的说法，在引用中保留信源自述的版本或日期，而非仅写「最新」。
适用场景与限制¶
适合：在 DSH 中做 CS 教学、作业辅导、技术问答写作，希望信源选择与引用格式有统一注册表和审计步骤的团队或个人。
务必知晓的限制（来自 README）：
- 工具只查策展注册表，不抓取页面、不独立验证论断真伪；层级数据新鲜度取决于注册表重建与
last_checked。 cs_source_audit不做「该引用是否支撑该句」的语义判断。- A/B 降低风险但不保证正确；版本敏感的表述仍须对齐信源上的版本/日期。
- 合法但未入库的 URL（例如某项目自有 GitHub 仓库）会被标为 unknown。
资料记载 2026-11-06 探测：118/119 返回 HTTP 200；Semantic Scholar 为 429（需 API key）。refresh_days 按信源类别给出建议区间（如通告 2 天、官方文档 30 天、教材 365 天等）。
开发与数据维护（可选）¶
注册表真源为 data/cs-source-matrix.yaml，data/sources.json 由其生成。维护者可执行 npm run build:data 与 node test/check.mjs（README 记载 27 项检查）。这与普通安装用户无直接关系，但说明信源列表可随矩阵更新而迭代。
结尾¶
cs-source-reliable 把 CS 教学的信源选择从「模型即兴」收敛为「注册表 + 查找 + 引用审计」的本地流程，开销主要在约 498 tokens 量级的 schema 与 guidance（README 2026-11-06 测算），适合已在 DSH 上编排 CS 场景的开发者。
- 目录页：https://www.skillhub.cn/plugins/hanwang-ai/cs-source-reliable
- GitHub（README 安装与开发说明）：https://github.com/uhygyuf/cs-source-reliable
- 用户线索中的仓库路径：https://github.com/hanwang-ai/cs-source-reliable
许可证：MIT（以仓库 LICENSE 为准）。
