DeepSeek Harness 插件

dsh-obsidian-channel

Let a DSH agent read and write your local Obsidian vault, with approval and one-click rollback.(英文原文)

跳到安装方式

来源信息

GitHub 仓库
ShengenWu/dsh-obsidian-channel
最近更新
2026年8月18日
分类
自动化与任务
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/ShengenWu/dsh-obsidian-channel
插件名:dsh-obsidian-channel
作者:ShengenWu

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器4 个文件
README.zh.md来源说明 · 只读预览
README 语言

dsh-obsidian-channel

English · 中文

![version](https://github.com/ShengenWu/dsh-obsidian-channel/releases) ![dsh](https://github.com/deepseek-ai/deepseek-harness) ![license](../LICENSE) ![node](https://nodejs.org) ![topic](https://github.com/topics/dsh-plugin)

DeepSeek Harness 里管本地 Obsidian 库。

点侧边栏的 📓,会打开这个库的首页。从首页丢一句话给 agent,它会在库里读笔记、写日记、改双链。改库之前会先问你;改完能一笔一笔撤回。Obsidian 本身不用开。

你需要什么

  • 已安装并能跑起来的 dsh web
  • 适配版本:dsh 0.1.0-rc.6
  • 本机有一个普通的 Obsidian vault 目录

安装

dsh plugin --profile web add github:ShengenWu/dsh-obsidian-channel

然后重启 dsh web,打开 http://127.0.0.1:3080 。

本地开发可以改成 dsh plugin --profile web add /你的/checkout/路径

第一次用

1. 点左侧 📓 Obsidian。 2. 如果还没绑过库,填 vault 的绝对路径(macOS / Linux 类似 /Users/you/Notes,Windows 类似 D:\Notes),点绑定。 3. 你会看到库首页。默认两块是 继续(最近笔记)和 本库变更(journal + 回滚)。今日 / 搜索 / 结构 / 待整理 / 断链 在设置 → Obsidian 里按需打开。 4. 点一条笔记或点「写今日日记」之类的快捷操作。dsh 会在这个 vault 上开一个新会话,把草稿放进输入框。你改完再自己发送,插件不会偷偷帮你发出去。

绑定过一次就会记住。之后点 📓 只是打开首页,不会再新建一个工作区。

![库首页](homepage.png)

平时怎么用

从首页聊。 点笔记、点断链、或者自己在底栏打字。每次都是新的 vault 会话,避免跟上一轮对话缠在一起。

日记跟着 Obsidian 走。 首页和 agent 会先读库里的 .obsidian/daily-notes.json。你在 Obsidian 里把日记设成 Daily + MM-DD-YYYY,这里就不会自作聪明改成别的格式。真要覆盖,去 Settings → Obsidian。

改库要过你这一关。 默认每次写入都会弹出审批。你可以改成「这一轮任务里同类写入只问一次」,也可以改成不问(不建议)。

写错了就撤回。 Settings → Obsidian 下面有变更历史,能看改前改后,一键回滚。回滚自己也会留一条记录,还可以再撤。

在设置里改这些:

  • vault 路径
  • 写入要不要问你
  • 日记目录和日期格式(可选,不填就用 Obsidian 自己的)
  • 额外不让碰的目录
  • 变更记录留多久(默认 30 天)

![设置](setting.png)

vault 会话默认会走 Obsidian 模式:不干涉其他工作空间的模式设定,人设按「帮你整理知识库」来,而不是按写代码来。

读笔记用 dsh 自带的 read / grep / glob 就行。真正改笔记(新建、整篇替换、追加、删除)请让它走 obsidian_* 工具,这样才进变更记录、才能撤回。插件会拦住对着这个 vault 的原生 write / edit。

0.1.1-rc.1 新加了什么

0.1.0 之后的预发布。指定这版:dsh plugin --profile web add github:ShengenWu/dsh-obsidian-channel#v0.1.1-rc.1

  • 知识库和日记文件夹用系统选择器
  • 首页卡片三种尺寸(小 / 中 / 大),可拖拽,大小在右上角 ⋯ 里改
  • 点笔记会弹出整页编辑(左边源码,右边预览)
  • 「今日日记」就是今天这篇:点开可写,没有就新建;右上角 Agent 跳到这个库的 Workspace
  • 最近笔记标题按一级标题 → YAML title → 文件名
  • 点 Obsidian 不会和 SSH / 看板同时亮着

这版还没有:模板建卡、周报、输入框 [[ 补全。

0.1.0 里有什么

  • [x] 侧边栏入口和库首页(今日 / 最近 / 变更 / 断链 / 快捷操作)
  • [x] 带审批的新建、更新、追加、删除、批量改
  • [x] 变更日志和一键回滚
  • [x] 设置页(绑库、审批策略、日记习惯)
  • [x] 日记路径跟 Obsidian 设置对齐
  • [x] vault 会话默认 Obsidian 模式;只有在这个库里才会加 vault 说明
  • [x] 原生 write / edit 进 vault 会被拒绝
  • [x] 可开关的库首页(壳 + 组件;默认是「继续」和「本库变更」)
  • [x] 搜索、列表、结构、反链、带链接改写的 journaled 移动
  • [x] 字面量 oldString / newString 更新
  • [x] 从本机 Obsidian 配置探测 vault
  • [x] 运行时 skill obsidian-vault(写代码的会话也能调)
  • [ ] 按模板建卡、出周报
  • [ ] 输入框 [[ 补全 — 打双链时按笔记标题补全

已知限制:agent 如果用 bash 直接改文件,还绕得过我们的写守卫,这种改动不会进变更记录。vault 会话里尤其要注意。

许可

[MIT](../LICENSE)

欢迎大家提issue:<https://github.com/ShengenWu/dsh-obsidian-channel/issues>

本仓库代码使用 dsh、Grok 4.6 以及 DeepSeek-v4-Pro-0813 构建。