Apollo School Analyzer（DSH SDK JSON-RPC）

@apollo-music/dsh-agent-school-analyzer 是独立的数据生成 Agent runtime。它由 analysis supervisor 调度，不属于政策专家，也不接企业微信。当前精确兼容 DeepSeek Harness 0.1.1-rc.2。

0.3.1 不再是 Web/headless Profile Bundle，也不需要安装到 DSH_HOME。包内同时提供 SDK client worker 和独立 JSON-RPC child composition：

• apollo-school-analyzer-jsonrpc：stdout 只输出 JSON-RPC JSONL 帧的 SDK child。
• apollo-school-analyzer run ...：Supervisor 使用的稳定 CLI；它通过 SDK client 启动上述 child。
• dist/pipeline/：随包发布的 supervisor、validator、archive、Expert index builder 与 seal 脚本，不依赖源码仓库的兄弟目录。

DSH 0.1.1-rc.2 runtime 及完整递归 peer 闭包都以固定版本普通 dependencies 发布，支持 pnpm autoInstallPeers: false。宿主只需允许 @deepseek-ai/dsh-subprocess-local、node-pty 和 koffi 的原生构建。

开发与发布只以 [email protected] 和本目录的 pnpm-lock.yaml 为依赖解析权威；不要生成或提交 package-lock.json。pnpm-workspace.yaml 固定关闭自动 peer 安装、启用严格 peer 门禁，并显式记录允许或拒绝的依赖构建脚本。首次安装使用 pnpm install，CI 与发布门禁使用 pnpm install --frozen-lockfile。

安装与配置

npm install @apollo-music/[email protected]

主要环境变量：

APOLLO_KB_ROOT=/var/lib/apollo/analyzer/hfk-bremen
APOLLO_DATA_ANALYST_SESSION_ROOT=/var/lib/apollo/analyzer-runtime/sessions

APOLLO_DATA_ANALYST_PROVIDER=dashscope-intl
APOLLO_DATA_ANALYST_MODEL=qwen3.8-max
DASHSCOPE_INTL_API_KEY=...
DASHSCOPE_INTL_BASE_URL=...

APOLLO_DATA_ANALYST_DSH_HOME 仅保留一版兼容回退名称；它现在只表示 SDK JSONL session 根，不再是 Profile home。模型 provider、model、凭据、知识库根、phase workspace 和 session root 都由 worker 显式传给 child，不依赖宿主自动继承。

CLI

从 OSS 只物化一所学校的工作区：

apollo-school-analyzer workspace hydrate hfm-weimar \
  --root /var/lib/apollo/analyzer/hfm-weimar

运行或续接一个 phase：

apollo-school-analyzer run institution hamburger-konservatorium
apollo-school-analyzer run faculty hfk-bremen
apollo-school-analyzer run programmes hfk-bremen
apollo-school-analyzer run faculty hfk-bremen apollo-data-hfk-bremen-faculty-...

Supervisor 与 release：

apollo-school-analyzer supervisor start
apollo-school-analyzer supervisor status
apollo-school-analyzer supervisor enqueue hfk-bremen programmes

apollo-school-analyzer release build --all
apollo-school-analyzer release seal
apollo-school-analyzer release publish --channel stable

0.3.1 只生成 apollo.school-expert-release/v2 / channel/v2。每校 policy-manifest.json 的全部 content_sha256 文件（包括嵌套的逐专业、逐教授和引用目录）都会逐路径、逐摘要校验后复制进不可变归档；SQLite index 仍保持 apollo.school-expert-index/v1。归档还包含 query-school-expert-index.mjs 的审计副本及 SHA-256，但下载端只能执行其安装包内、且与该摘要完全一致的查询器，不能执行归档中的脚本。

成功与否仍只看固定 validator；模型最终回复不是完成门禁。所有尝试固定使用 dashscope-intl/qwen3.8-max，不自动回退到其他模型。Provider 不可用或内容检查失败时保留失败状态并由 Supervisor 重试或上报。session provenance 会记录实际 provider/model 和 dsh-sdk-jsonrpc transport。

直接 JSON-RPC 运行面

部署方通常无需直接调用 child；如需嵌入自己的父进程，可用固定命令：

node node_modules/@apollo-music/dsh-agent-school-analyzer/dist/jsonrpc-bin.js

除上面的全局参数外，父进程必须显式传入 APOLLO_ANALYSIS_SCHOOL_ID、APOLLO_ANALYSIS_PHASE、该 phase 的精确 APOLLO_ANALYSIS_WORKSPACE、APOLLO_DATA_ANALYST_MODEL_API_KEY，以及非 DeepSeek provider 的 APOLLO_DATA_ANALYST_MODEL_BASE_URL。该 child 不加载 Web、终端 UI、企微 Bridge、交互审批、Skill、Workflow、Goal 或 Subagent。

开发检查：

pnpm run typecheck
pnpm test
pnpm run test:install
npm pack --dry-run

完整架构与隔离规则见 DESIGN.md。