Leo3-7/dsh-obsidian-inbox

DSH skill: ingest the conclusions/mistakes/projects from conversations into an Obsidian vault via a 7-step workflow with two-level validation. 把对话结论/错题/项目按七步流程整理进 Obsidian 的 DeepSeek Harness 技能。

Project Overview项目介绍

dsh-obsidian-inbox is a native DSH skill-pack (a dsh.bundle skill-pack) targeted at DeepSeek Harness that moves durable conclusions, explanations, mistakes, and ideas from DSH conversations into an Obsidian vault through a deterministic workflow. It ships on npm as the package dsh-obsidian-inbox, and its repository layout includes package.json (declaring the dsh.bundle field plus a cordis.patch.yml), a lib/index.js plugin entry, a lib/validate.js module that backs both the model tool and an optional CLI, and the skill entry point skills/obsidian-inbox/SKILL.md. Installation is supported three ways: the npm route dsh plugin --profile web add dsh-obsidian-inbox, the source route dsh plugin --profile web add https://github.com/Leo3-7/dsh-obsidian-inbox, or copying skills/obsidian-inbox/ into $DSH_HOME/skills/ (or a skill-filesystem customSkillDirs entry). The bundle is the only supported target.

The intended workflow is to speak a trigger phrase inside a DSH session — for example "整理入库", "保存这个结论", "记录为错题", "记录为项目", or "更新已有笔记" — after which the model follows SKILL.md's seven-step procedure to search the vault by filename, aliases, links, frontmatter, and MOCs, prefer merging into an existing note over creating a copy, refine content to long-term value, place each item in exactly one primary directory, and then run the two-stage validator before reporting success. It is built for individual users, researchers, and students who accumulate Obsidian knowledge from DSH and want a strict, non-destructive pipeline covering考研, AI, projects, ideas, and similar curated folders.

Dependencies are minimal: Node.js ≥ 18 is required, and only built-ins node:fs and node:path are used, so there are no third-party packages to install. The target must be a real Obsidian vault containing a .obsidian configuration directory; the walker skips .obsidian, .dsh, node_modules, and .git. First-run caveats include setting Config.defaultVault to your own vault path (the default is empty) and replacing the author's 00_收件箱 / 01_考研 / 02_AI与编程 / 03_智能制造 / 04_项目 / 05_想法 / 06_错题 / 07_对话精华 taxonomy with your own. The plugin also exposes the obsidian_validate_vault model tool (and an equivalent CLI returning exit 0 on pass, 1 on problems) that reports formula ($/$$, rejecting \(, \[), JSON, Wiki-link, and homonym issues; an item is not declared archived unless validation passes. The license is MIT.

dsh-obsidian-inbox 是一个面向 DeepSeek Harness 的 DSH 原生技能包(dsh.bundle skill-pack),把会话里值得长期保存的结论、错题、想法按确定性流程整理进 Obsidian 知识库。它以 npm 包 dsh-obsidian-inbox 发布,提供 package.json(含 dsh.bundle 与 cordis.patch.yml)、lib/index.js 插件本体、lib/validate.js 校验逻辑,以及 skills/obsidian-inbox/SKILL.md 技能入口。安装方式包括 dsh plugin --profile web add dsh-obsidian-inbox、源码安装,以及直接把技能目录拷到 $DSH_HOME/skills/。插件会通过 ctx.skills 注册为 bundled 技能,并通过 ctx.tools 暴露 obsidian_validate_vault 工具供模型调用。

典型用法是在 DSH 对话里说出触发词「整理入库」「保存这个结论」「记录为错题」「记录为项目」「更新已有笔记」,模型按 SKILL.md 的七步流程检索、合并、提炼并归档到指定 vault。它面向长期使用 Obsidian 沉淀 DSH 会话价值的个人用户,特别是要把零散结论归入考研、AI、项目等主目录并保持 Wiki 链接与 frontmatter 一致的研究者和学习者。流程强调检索优先、合并优先、只保留长期价值,以及公式与结构两级确定性校验。

依赖方面要求 Node.js ≥ 18,仅使用 node:fs / node:path 内置模块,无第三方依赖;目标 vault 需含 .obsidian 目录,walk 会跳过 .obsidian / .dsh / node_modules / .git。首次使用必须在插件 Config.defaultVault 中配置自己的 vault 路径,并把 00_收件箱 等主目录分类替换为个人结构;校验失败(ok=false 或退出码 1)时模型不会宣布「已入库」,需要逐条修复公式($/$$)、JSON、Wiki 链接和同名歧义问题。许可证为 MIT。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-obsidian-inbox

把 Leo3-7/dsh-obsidian-inbox 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

obsidian-inbox

English / 英文: README.en.md npm version · dsh-obsidian-inbox · GitHub

把 DeepSeek Harness(DSH)对话里值得长期保存的结论、解释、错题、想法,按一套确定性的流程整理进 Obsidian 知识库的 DSH 技能(skill)。

这是什么

一个面向 DSH 的 SKILL.md 技能,规定了「整理入库」的七步标准流程,核心原则:

  • 检索优先于归档:写库前先按文件名 / aliases / 链接 / frontmatter / MOC 检索,已存在的就直接合并。
  • 合并优先于新建:只做局部编辑、只更新 updated,不整篇覆盖、不生成副本。
  • 只提炼长期价值:不保存完整聊天、密码令牌、临时噪音。
  • 一个主归属:每个知识只进一个主目录,跨领域用链接和标签表达。
  • 两级确定性校验:公式($/$$、拒绝 \(/\[)+ 结构与 Wiki 链接(.obsidian JSON、[[Link]] 目标、同名歧义),校验不通过不宣布「已入库」。

目录结构

这是一个 DSH 插件(dsh.bundle skill-pack),可安装进任意 profile:

dsh-obsidian-inbox/
├── package.json                   # dsh.bundle → cordis.patch.yml;main → lib/index.js
├── lib/
│   ├── index.js                   # 插件本体:注册 bundled 技能 + obsidian_validate_vault 工具
│   └── validate.js                # 两级确定性校验逻辑(插件所有,工具/复用同一实现)
├── cordis.patch.yml               # 激活该插件(insert 一行)
├── skills/obsidian-inbox/
│   └── SKILL.md                   # 技能说明(DSH 加载的入口)
├── README.md / README.en.md
├── LICENSE
└── .gitignore

一切能力都由插件提供:技能经 ctx.skills 注册为 bundled provider,校验经 ctx.tools 注册为模型工具 obsidian_validate_vault,vault 路径由插件 Config.defaultVault 声明式配置——没有散落的裸脚本或硬编码路径。

在 DSH 里使用

方式 A:npm 安装(推荐,已发布到 npm)

dsh plugin --profile web add dsh-obsidian-inbox
# 或按你的实际 profile 名调整:dsh plugin --profile <name> add dsh-obsidian-inbox

方式 B:GitHub 源码安装(备选)

dsh plugin --profile web add https://github.com/Leo3-7/dsh-obsidian-inbox

方式 C:直接把技能目录拷进 DSH 的技能目录

# 把 skills/obsidian-inbox/ 放到 $DSH_HOME/skills/ 下,或加到
# skill-filesystem 的 customSkillDirs

任一种安装后,插件都会把 skills/obsidian-inbox/ 注册为 bundled 技能,模型目录里即可看到;库校验走 obsidian_validate_vault 工具。

在会话里说触发词即可触发,例如:「整理入库」「保存这个结论」「记录为错题」「记录为项目」「更新已有笔记」。

配置 / 个性化

本技能是作者个人的整理流程,有环境相关的两处需要按你自己的库修改:

  • vault 路径:由插件 Config.defaultVault 决定(默认空,需设为你的库路径);用 obsidian_validate_vault 校验时可传 vault 参数覆盖。
  • 主目录分类:00_收件箱 / 01_考研 / 02_AI与编程 / 03_智能制造 / 04_项目 / 05_想法 / 06_错题 / 07_对话精华 —— 换成你自己的目录结构。

校验(插件工具)

校验是插件暴露的模型工具 obsidian_validate_vault(不是 shell 脚本),在对话里调用即可:

obsidian_validate_vault                    # 用插件配置 defaultVault(需先设为你的库路径)
obsidian_validate_vault (vault: "...")     # 校验指定 vault

返回 { ok, noteCount, problems },ok=false 时逐条列出公式 / JSON / Wiki 链接 / 同名歧义问题。实现集中在 lib/validate.js,工具与(可选)CLI 复用同一份逻辑。

退出码:0 = 通过;1 = 发现问题(会逐条列出公式 / JSON / Wiki 链接 / 同名歧义问题)。

依赖

  • Node.js >= 18(node:fs、node:path 为内置模块,无第三方依赖)。
  • 目标为一个 Obsidian vault(含 .obsidian 配置目录,walk 会跳过 .obsidian / .dsh / node_modules / .git)。

许可证

MIT © Leo3-7

← 上一个 Prev dsh-receipt 下一个 Next dsh-theme-prts →