@dsh-external/dsh-xuegulin
Vault 观测插件：Obsidian vault 元数据快照 + 编辑统计 + 观测面板（可配置任意 vault）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:chemmy-11/dsh-xuegulin#c402fb7908d07544eb3324fb4f88073816fe2790Xuegulin 以 @dsh-external/dsh-xuegulin 发布，当前版本为 0.0.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →Vault 观测插件（@dsh-external/dsh-xuegulin）——为 DeepSeek Harness（dsh）提供 Obsidian vault 的元数据快照与编辑活动统计：文件清单（路径/修改时间/大小/字数）、编辑操作计数（fs.watch 实时感知 + 去抖合并）、观测面板（今日/本周/活跃 Top/最近编辑流）。
vaultRoot 指向任意 Obsidian vault 即可观测（不限于特定库）；统计与快照存插件私有目录（~/.dsh/xuegulin/），vault 本体零写入（只读扫描，不创建/修改任何 vault 内文件）。
fs.watch（recursive）实时感知 vault 变更（Obsidian 关闭时同样可采），500ms 去抖合并，kind 区分 created/modified/deleted；重复事件幂等（session_key），热重载/重启不重复记账；dsh-docs/ 等（exclude 可调），统计与展示均不涉及被排除目录；~/.dsh/xuegulin/）。dsh plugin --profile <name> add github:chemmy-11/dsh-xuegulin
git 形式安装会在本机构建（prepare 脚本需要 dsh 源码 checkout：自动探测 $DSH_CHECKOUT 或 ~/dsh-harness）；pnpm ≥10 首次安装需在 profile 的 pnpm-workspace.yaml 按提示放行 allowBuilds。
配置示例（profile 的 cordis.patch.yml 覆盖行，整行替换；vaultRoot 必配）：
- id: xuegulin
config:
vaultRoot: 'C:/path/to/your/obsidian/vault'
exclude: [dsh-docs]
watchEnabled: true
pollIntervalMs: 21600000
debounceMs: 500
GET /api/xuegulin/state（同源访问）返回：totals（文件数/字数）、today/week（编辑次数/修改文件数/新增文件/活跃 Top）、recent（最近 20 条编辑流）。
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（含 @deepseek-ai/cordis、@deepseek-ai/dsh-host-webserver、schemastery、typescript、esbuild）后直接用本地依赖构建，无需 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，不与任何其它插件耦合；安装插件等于在机器上运行第三方代码，权限与运行者相同。安装前请先阅读源码；本插件对目标 vault 只读，不执行写入。