Przejdź do treści
Biblioteka skilli
Produktywność osobista · Integracja z narzędziem

suiji-note

/suiji-note

Łączy się z serwisem notatek przez HTTP MCP, czyta i przeszukuje notatki, a zapisuje je dopiero po potwierdzeniu zmian.

Licencja
MIT
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

96/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność21 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Łączy się z serwisem notatek przez HTTP MCP, czyta i przeszukuje notatki, a zapisuje je dopiero po potwierdzeniu zmian.

Oryginalny opis (EN)

连接随记的 HTTP MCP 服务,读取、搜索并写入本地笔记;写入前必须让用户审查具体改动并明确确认。用户提到随记、MCP 笔记、读取/整理本地笔记时使用。

Jak działa

  1. 连接步骤
  2. 初始化
  3. 可用工具
  4. 写入规则:必须先审查再确认
  5. 安全
Sekcje z nagłówków SKILL.md, w oryginale · 151 linii, 217 słów
Podgląd SKILL.md
---
name: suiji-note
description: 连接随记的 HTTP MCP 服务,读取、搜索并写入本地笔记;写入前必须让用户审查具体改动并明确确认。用户提到随记、MCP 笔记、读取/整理本地笔记时使用。
---

# 随记 MCP

随记是 DSH 的本地 Markdown 笔记插件。它提供一个 HTTP MCP 服务。

## 连接步骤

1. 让用户打开随记设置页,找到「MCP 连接」。
2. 复制设置页显示的地址和 Token。不要猜测 Token,也不要把 Token 写入文件或日志。
3. 用下面的请求头连接:

```text
Authorization: Bearer <TOKEN>
Content-Type: application/json
```

默认地址:

```text
http://127.0.0.1:53152/dsh-agentic-notes/mcp
```

如果用户改过端口,以设置页显示为准。

## 初始化

先发送:

```json
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"suiji-skill","version":"1.0.0"}}}
```

再发送:

```json
{"jsonrpc":"2.0","method":"notifications/initialized"}
```

之后用:

```json
{"jsonrpc":"2.0","id":2,"method":"tools/list"}
```

## 可用工具

只读:

- `list_notebooks`
- `list_notes`
- `search_notes`
- `read_note`
- `read_todo`
- `read_stickies`

提示:

- `notify`:显示一条全局 toast

写入(直接落盘):

- `create_note`
- `write_note`
- `rename_note`
- `move_note`
- `delete_note`
- `update_frontmatter`
- `todo_add` / `todo_update` / `todo_delete`
- `memo_create` / `memo_update` / `memo_delete`
- `update_notebook`:改笔记本的名称、描述、关键词和「Agent 自动更新」规则;「仅人工更新」规则只读

## 写入规则:必须先审查再确认

这些工具会直接修改文件,不会弹插件确认框。  
所以写入前必须由你完成审查步骤,不能直接调用写工具。

### 第一步:读取目标

在提出改动前,先用只读工具读取:

- 目标笔记当前内容
- 目标笔记本里的相关标题
- 目标笔记本的 `agentRules` 与 `manualRules`(都来自 `list_notebooks`)。两条规则冲突时,以 `manualRules` 为准,它的约束无条件优先
- `manualRules` 是仅人工维护的规则:**绝对禁止修改**,只能读;任何写入都会被宿主拒绝,也不要用改写笔记内容的方式绕过它
- 待办或便笺的当前状态

### 第二步:向用户展示改动

用下面的格式给用户看,不要只写“我将修改笔记”:

```text
准备写入:
- 操作:write / create / delete / rename / move
- 目标:<笔记本>/<笔记路径>
- 变更:<新增/删除/替换了什么>
- 正文预览:<关键段落或完整新内容>
- 影响:<会覆盖哪些内容、是否删除文件、是否移动图片>
```

如果一次有多个操作,逐条列出。

删除、移动、重命名、覆盖已有正文必须单独说明。

### 第三步:等待明确确认

只有用户明确回复以下意思之一,才可以调用写工具:

- 确认
- 可以
- 执行
- 没问题
- 按这个改

以下回复不算确认:

- 沉默
- “先看看”
- “你觉得呢”
- 只回复了方案的一部分
- 只说了“继续”但没有针对具体改动

如果用户修改了方案,重新展示改动并再次确认。

### 第四步:执行并报告

确认后:

1. 调用对应写工具。
2. 报告实际结果,例如:
   ```text
   已写入:<路径>
   ```
3. 如果工具返回错误,原样说明,不要声称成功。

### 禁止

- 不要在用户确认前调用任何写工具。
- 不要把“已读取”当成“已确认”。
- 不要因为用户之前确认过别的改动,就默认这次也确认。
- 不要用 notify 代替确认步骤。

设置读写是插件内部工具,不通过 MCP 暴露。

## 安全

- 只连接 `127.0.0.1`。
- 不把 Token 发给其他域名。
- 不把 Token 写进仓库、日志或笔记。
- 不尝试传绝对路径或 `..`。
- 不调用不存在或未授权的工具。

Wersje

W bazie nie ma innych skilli o nazwie suiji-note.

Migawka bazy z 13.11.2026 · wersja paczki 19a9f3e653db (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100note
    Zapisuje notatki z czytania do ustrukturyzowanego pliku notatek podczas sesji czytania, gdy użytkownik prosi o notatki lub zapis.
  • 100note-assistant
    Tworzy, wyszukuje i porządkuje lokalne notatki w QuickNotes przez CLI lub serwer MCP, z eksportem do Markdown.
  • 100make-note
    Tworzy dobrze ustrukturyzowane notatki w Obsidian z podpowiedziami tagów z bieżącego vaultu przez MCP.
  • 95update-note
    Wyszukuje notatki w Carta CRM i pomaga zaktualizować komentarze do deali, które edytuje się przez skill update-deal, bo samodzielna edycja notatek nie jest dostępna przez MCP.
  • 100mcp-server-obsidian
    Instaluje serwer MCP Obsidian do przeszukiwania notatek Markdown, tworzenia ich i linków zwrotnych oraz obsługuje jego narzędzia.
  • 100note
    Tworzy notatki podczas pracy i zarządza nimi, żeby zapamiętać wnioski i zachować je na później.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.