neulens

neulens 是以 NeuG 为存储引擎的本地知识分析 CLI。它独立于 DeepSeek Harness 运行；模型服务由用户配置，不绑定 DeepSeek。原始资料导入后，CLI 可检索证据、抽取带引文的 Claim 和 Finding，并让人或模型审核后发布。Agent 可以通过同一套命令使用已发布的知识。

状态：开发预览，尚未发布 npm 包。 当前仓库的 main 不代表稳定发行版；请勿用预览版管理生产 Library 或直接迁移旧 dsh-neug-kb Library。已实现能力、未实现项目和验收条件见交付检查表；首发与后续 npm 发布步骤见发行流程。

从哪里开始

需要 Node.js ^22.19.0 或 >=24.0.0。NeuG 原生运行目标是 macOS arm64 与 Linux x64；正式发行前仍需完成干净安装验收。在本仓库中安装开发版命令：

npm ci
npm run build
npm link
neulens doctor
neulens init
neulens model prepare

init 准备与当前 NeuG 版本匹配的扩展并生成用户配置；model prepare 下载默认的本地 embedding 模型，可能使用网络和磁盘。命令不会安装或启动 DeepSeek Harness。完整的建库、导入、查询和可选模型抽取步骤见快速开始。

产品对象

| 对象 | 用户能做什么 | | --- | --- | | Library | 当前目录下由名称指定的本地目录；存放 NeuG 数据库、冻结原件及版本化产物。library create 不扫描文件。 | | Namespace | Library 内的资料和结果范围。namespace use 选择默认范围；all 只用于聚合读取。 | | Source | 通过 source import 显式导入的 Markdown 或可抽取文本的 PDF。原文件无需移动到 Library。 | | Claim | 连接实体或概念的有向关系，附带 Source 证据；可手工创建或由模型发现。 | | Scenario / Finding | Scenario 是 Library 级、可跨 Namespace 复用的问题集合；Finding 是在一个 Namespace 内针对某份 Source、某个问题发布的带引文答案。 | | Job / Review | 导入、索引和模型抽取由持久 Job 执行。Claim/Finding 先成为候选，经人工或显式自动审核后才由 job publish 发布。 |

query search 先找原文 Chunk，也可沿已发布 Claim/Finding 扩展到相关证据。跨论文综合报告由 Agent 阅读原文和已发布结果完成，不另设 report 资源或命令。仓库提供 neulens CLI skill 和 文献综述 skill 作为 Agent 的操作指引。

命令、参数与 JSON 输入格式按模块维护在CLI 文档索引。默认 stdout 是单个 JSON 响应；review list/get --format text 提供人工可读证据。开发检查使用 npm run typecheck、npm run build 和 npm test。本仓库代码采用 Apache-2.0；迁入的原有核心代码许可声明见 THIRD_PARTY_LICENSES/DEEPSEEK.txt。