@dsh-external/dsh-nautilus
Vault 观测插件：Obsidian vault 元数据快照 + 编辑统计 + 观测面板（可配置任意 vault）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:chemmy-11/dsh-nautilus#7b80320e417cc985bab42f0c903f42f78fbd1697Nautilus 以 @dsh-external/dsh-nautilus 发布，当前版本为 0.0.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
DeepSeek Harness（dsh）的观测插件（@dsh-external/dsh-nautilus）：会话级量化观测——逐轮遥测（token/缓存/耗时/tps + 自评）与形态分析，外加 OS/GPU 采集层（pulse）。观测数据全部私有化存储（~/.dsh/nautilus/），重启/重载不丢不重。
⚠️ vault 观测腿已于 2026-09-27 下线：本插件不再读写任何 vault（原「Vault 观测」面板与
/api/nautilus/{state,vault,action}三条路由已删除）。笔记检索 / 移动 / 重命名请在会话侧用/obsidian技能（读 Obsidian 的obsidian.json解析活动 vault，多库可切换）。
2026-09-27 起本插件不再观测 vault：全量扫描、fs.watch 编辑监听、vault 统计面板与指向切换整体移除（vault 侧工作交给会话侧 /obsidian 技能，多库支持更自然）。
老库里的 vault_meta / edit_event / vault_config 三张表保留不删（红线：绝不销毁既有数据），但代码不再读写。
把「一段对话对知识库走了多远」变成数字——会话级 LLM 观测 + 量化自评 + 曲线形态分析：
session/event（零宿主源码修改、无第三方插件依赖），数据私有目录隔离（~/.dsh/nautilus/，SQLite，重启/重载不丢不重）；「L 场」是作者私人研究框架（L-theory）的用语；对外部使用者，把这块读作会话级 LLM 观测看板即可——指标本身（token/缓存/TPS/自评）都是标准的可观测性量。
全局（全部工作区）/ 指向（当前指向工作区）——切换即改取数口径，曲线/假设/报告同步；宿主支持矩阵：dsh 0.1.5-rc.2（稳定主用，已实测）+ 0.1.6-alpha.2（并存安装 dsh-next，已实测，见下「适配验证」）；peer 范围 @deepseek-ai/dsh-host-webserver = ^0.1.1-rc.2 || ^0.1.2-alpha.2 || ^0.1.5-rc.1 || ^0.1.6-alpha.1——每个分支都必须自带预发布标签：按 semver 预发布规则，0.1.6-alpha.2 只能被「同元组且带预发布」的比较器匹配，写裸 ^0.1.6 会静默排除 alpha 线（check:deps R4 拦此）；带 tag 的分支同时覆盖 alpha 与日后转正的 stable；
契约面：宿主侧只消费官方 session/event、ctx.webServer.register、ctx.tools.register，客户端只消费 ctx.slots（conversation.view）——不 import 宿主实现，故跨 prerelease 版本无需改码；
依赖面：运行时只 import 随 dsh 安装提供的 in-box 包——@deepseek-ai/cordis（类型）、@deepseek-ai/schemastery（Config schema）、@deepseek-ai/dsh-host-webserver（路由类型）；非 scoped 的 cordis/schemastery 不在安装闭包内，已迁移；
客户端入口：客户端插件就是普通 Cordis 插件（Context 来自 @deepseek-ai/cordis；@deepseek-ai/dsh-client-runtime 在 0.1.5 已移除）；UI 注册表 ctx.slots 由 @deepseek-ai/dsh-client-ui-renderer 提供；只 type-only 跨插件导入，运行时只 require 基线 react；
适配验证（2026-09-13，dsh 0.1.5-rc.2）：先做契约面对照——rc.1→rc.2 的 dsh-host-webserver / dsh-session / dsh-tools / dsh-client-ui-renderer / dsh-client-ui-conversation 产物除版本号外逐字节一致（无接口变更，故不改码）；devDep 精确 pin 升 0.1.5-rc.2（cordis 4.0.2 / schemastery 3.18.2 与 rc.2 依赖一致）；typecheck / build / test（12/12）/ check:deps / check-meta / client shim 全绿；隔离 DSH_HOME 的入口冒烟通过（Standard Schema 默认值与非法值拒绝 + 8 路由 + 1 工具 + 2 事件订阅 + 6 disposer + 新库 schema v3/9 表）。上一轮 0.1.5-rc.1（2026-09-10）同为全绿。
适配验证（2026-09-20，dsh 0.1.6-alpha.2 · 并存安装 dsh-next）：契约面逐项对照 C:\Users\15266\dsh-next\node_modules\@deepseek-ai\* 的类型声明——槽位注册选项（keyed → options.key / list → options.id|order|label，label 仍支持函数形，新增可选 priority）、ctx.layout.selectPanel(MainPanelId|null)、sidebar.panellist 与 SidebarPanelMetadata、WebRoute{kind,path,handler}、（ + ）、 清单字段（），故；peer 追加 分支（devDep 仍 pin ，两版共存）； 新增 R4（宿主 peer 每个分支必须带预发布标签）并做反向验证（裸 被拦下并给出确切分支名）。： 起 0.1.6（端口 3099，探测走进程内叠加、），启动日志 、；启动图含本行（rev ），下发 bundle 含工作台与心跳控件标记； 全 （注：/ 两条已于 2026-09-27 随 vault 观测腿下线）（pulse 15 指标、、）； 切 1s→、→ticks 5→6、非法档位→；六件套全绿（ 22/22）。
dsh plugin --profile <name> add github:chemmy-11/dsh-nautilus
本仓库不提交 lib/，故 git 形式安装在安装时就地构建（prepare / prepack → scripts/prepare.mjs）：pnpm ≥10 必须在 profile 的 pnpm-workspace.yaml 放行 allowBuilds（键形如 @dsh-external/dsh-nautilus@git+…#<sha>）——实测未放行时 pnpm 会直接报错并给出该键（不报错的形态更危险：装出没有 lib/ 的包，加载期才炸）；放行等同授权该包在安装时执行构建代码，建议锁定 commit SHA。构建需要 dsh 源码 checkout，自动探测 $DSH_CHECKOUT 或 ~/dsh-harness，探测不到则回退 npm-devDeps 模式（git 安装时 devDependencies 由包管理器装好）。本地 npm install / npm ci 不隐式整包构建（本地开发用 npm run build）。
配置示例（profile 的 cordis.patch.yml；全部字段都有默认值，通常无需配置）：
- id: nautilus
config:
lField:
enabled: true
historyDays: 30
pulse: # OS/GPU 采集子插件
intervalMs: 5000
enableCounters: true
enableGpu: true
| 端点 | 说明 |
|---|---|
GET /api/nautilus/m2/state | 会话读数（latest / totals / curve / selfcheck 覆盖；?root=all 切全局视图） |
GET/POST /api/nautilus/m2/annotations | 预言标注读写 |
GET /api/nautilus/m2/turn-text | 某轮完整问答原文 |
GET /api/nautilus/m2/analysis | 白盒分析（S 形 / 爆发段 / τ_e） |
GET/POST /api/nautilus/lfield | L 场指向状态 / 切换 |
DSH_CHECKOUT=<dsh-checkout> bash scripts/build.sh # = node scripts/prepare.mjs（host tsc + client esbuild）
构建链为纯 Node 实现（scripts/prepare.mjs + scripts/build-client.mjs），不依赖 bash 环境差异。
两种构建模式（scripts/prepare.mjs 自动选择）：
$DSH_CHECKOUT / ~/dsh-harness → 从 checkout junction 链接 cordis/schemastery/dsh-host-webserver 并复用其 tsc/esbuild；npm install 装好 devDependencies 后直接用本地依赖构建，无需 dsh 源码。.github/workflows/ci.yml 在每次 push/PR 上跑 typecheck + build（npm-devDeps 模式）+ 测试 + 元数据校验（bundle patch / client 双半 / files 清单）；.github/workflows/release.yml 在 v* tag 上自动构建 tgz 并创建 GitHub Release。
cordis/schemastery/dsh-host-webserver，不与任何其它插件耦合；~/.dsh/nautilus/，不混入其它数据源）；安装插件等于在机器上运行第三方代码，权限与运行者相同。安装前请先阅读源码；本插件不访问 vault，只写自己的数据目录 ~/.dsh/nautilus/。
ctx.subprocessspawn(graceMs/maxBytes/signal)exitCode/signal/readFromdsh.clientplatform/inject/immediately?/external?^0.1.6-alpha.10.1.5-rc.2check:deps^0.1.6dsh-next --profile web --patch <临时叠加> [nautilus] Pulse OS/GPU 层已挂载（子插件）[pulse] mode=auto interval=5000ms exec=ctx.subprocess db=…\.dsh-next\nautilus\nautilus.dba05f2c1db892a264-51/api/nautilus/{state,vault,lfield,m2/state,m2/analysis,m2/annotations,pulse/state}statevaultshell=powershellgpuOk=truePOST /pulse/control{mode:auto,intervalMs:1000}{mode:manual,sample:true}test