dsh-knowledge-lite

Readme

# dsh-knowledge-lite

给 DeepSeek Harness（dsh）用的本地知识库插件。每篇笔记是一个 Markdown 文件，数据完全在你本机，不依赖任何云服务。

## 功能

- **本地纯文本存储**：每篇一个 `.md`，可用任意外部编辑器直接修改
- **全文搜索 + 标签筛选**
- **层级目录**：目录即磁盘文件夹，可在文件管理器里手动移动文件，库自动识别
- **附件**：拖入文件自动分流
  - 文本类（`.txt`/`.md`/`.py`/`.json`/`.csv`…）→ 直接进正文
  - Office（`.docx`/`.xlsx`/`.pptx`）→ 原件存入 `files/`，同时**零依赖抽取文本**写进正文（可搜索、可被 AI 引用）
  - 其他（`.pdf`/图片/压缩包…）→ 原样存入 `files/`，双击「打开」交给系统程序
  - 删除笔记连带清理其附件
- **拖拽移动**：把笔记拖到任意目录节点即移动
- **对话导出**：把 dsh 对话整理成笔记（writeback）

## 安装

上架 DSH 插件市场后，可在 dsh 的 `设置 → 插件市场` 搜索 `dsh-knowledge-lite` 一键安装。

手动 / 开发模式（针对 dsh `0.2.0-rc.2` / Windows）：

```bash
git clone https://github.com/fangqiing/dsh-knowledge-lite.git
cd dsh-knowledge-lite
pnpm install          # 依赖用 link: 协议，改动即时生效，无需重装
# 把插件链接进 dsh 的插件目录并重启 dsh（安装前需彻底退出 dsh，否则 EPERM）
```

> 宿主版本需与 `peerDependencies` 中的 `@deepseek-ai/dsh-*` `0.2.0-rc.2` 匹配。

## 兼容性

- **宿主**：DeepSeek Harness `0.2.0-rc.2`
- **平台**：Windows（默认笔记根目录写死 `E:/dsh-kb`，其他平台需改 `lib/config.js` 的 `DEFAULT_ROOT`）
- **分类建议**：知识管理 / 效率工具

## 目录结构

| 文件 | 职责 |
|---|---|
| `lib/store.js` | 笔记与层级目录的存储、扫描、移动、删除 |
| `lib/index.js` | 宿主（Node）侧入口与 RPC |
| `lib/client.js` | 浏览器半侧 UI（目录树、编辑器、附件列表） |
| `lib/attachments.js` | Office 文档零依赖文本抽取（ZIP + XML，无第三方库） |
| `lib/writeback.js` | 把对话抽取为笔记候选 |
| `lib/config.js` | 笔记根目录等路径配置 |
| `lib/writeback-prompts.js` | 抽取提示词 |

## 已知限制

- **默认笔记根目录写死为 `E:/dsh-kb`**（Windows 专属）。其他平台需改 `lib/config.js` 的 `DEFAULT_ROOT`，或首次启动后在设置里改。
- 主要在 Windows + dsh `0.2.0-rc.2` 下验证。

## License

MIT