dsh-grove 0.1.1 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.en.md +102 -0
- package/README.md +25 -5
- package/docs/DETAIL.en.md +5 -1
- package/docs/DETAIL.zh.md +5 -1
- package/locale/en.json +1 -1
- package/locale/zh.json +1 -1
- package/package.json +3 -3
package/README.en.md
ADDED
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
# Grove
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
[简体中文](README.md) · [English](README.en.md)
|
|
6
|
+
|
|
7
|
+
[](LICENSE)
|
|
8
|
+
[](package.json)
|
|
9
|
+
[](package.json)
|
|
10
|
+
|
|
11
|
+
## Personal knowledge and growth
|
|
12
|
+
|
|
13
|
+
**PKGS (Personal Knowledge & Growth System) is a method for long-term personal growth.** It connects exploration, learning, evidence-based research, creation, and reflection. Something you understood years ago may help explain a problem today. Evidence you find tomorrow may change a judgment you make today. Over time, you build knowledge you can draw on again and become better at understanding, judging, researching, and communicating.
|
|
14
|
+
|
|
15
|
+
You can practice the method with paper, Markdown, or tools you already use. The [PKGS guide](docs/PKGS.en.md) explains the design and shows how to develop questions, connect ideas, conduct research, track changes in your views, and share the work with AI.
|
|
16
|
+
|
|
17
|
+
- **Exploration** starts with an observation, uncertainty, or association. You can stop anytime or leave an open question to return to later. You decide when to research it and whether to make something from it.
|
|
18
|
+
- **Knowledge growth** starts by explaining an idea in your own words. Connect concepts, examples, and questions, then test your understanding through use and review.
|
|
19
|
+
- **Research and creation** start with a question worth investigating. Preserve sources, counterexamples, and versions of your judgment. When useful, turn what you learned into an article, report, or proposal. Reflection can give you a starting point for the next exploration.
|
|
20
|
+
|
|
21
|
+
AI can ask questions, compare explanations, surface counterexamples, and help you express an idea. You decide what to believe, keep, and share.
|
|
22
|
+
|
|
23
|
+
## How Grove puts the method into practice
|
|
24
|
+
|
|
25
|
+
Grove connects DeepSeek Harness and Obsidian. The current version connects open-ended conversation, user-confirmed saves, and basic evidence tracking. Choose what to keep from a conversation, save it as Markdown in your own vault, and use versions and wikilinks to revisit relationships among questions, evidence, and claims. You can practice the guide’s learning, reflection, and full research methods by hand.
|
|
26
|
+
|
|
27
|
+
## Install v0.1.1
|
|
28
|
+
|
|
29
|
+
You need Node.js 22 or later, an existing Obsidian vault, and DeepSeek Harness `>=0.2.2-rc.1 <0.3.0`. The `engines.dsh` range determines whether the host loads the bundle.
|
|
30
|
+
|
|
31
|
+
### Install in an existing Harness
|
|
32
|
+
|
|
33
|
+
| Entry point | Steps |
|
|
34
|
+
| --- | --- |
|
|
35
|
+
| Desktop | Open **Plugins → Add plugin** and select this repository directory. The host installs a `link:` dependency. Restart the host after editing the source. |
|
|
36
|
+
| In a session | Ask the agent to call `plugin_manager` with `install_bundle` and pass the directory’s absolute path as `target`. |
|
|
37
|
+
| CLI | Run `dsh plugin --profile <profile> add <directory-or-tgz>`. The Desktop app manages its own profile. Packages installed into `profiles/web` do not appear there. |
|
|
38
|
+
|
|
39
|
+
Check that Grove appears on the **Plugins** page, then ask the model to call `grove_role` in a new session to confirm the tool is registered.
|
|
40
|
+
|
|
41
|
+
### Try a separate profile
|
|
42
|
+
|
|
43
|
+
```sh
|
|
44
|
+
export GROVE_VAULT="/absolute/path/to/Obsidian vault"
|
|
45
|
+
npx --yes @deepseek-ai/dsh@0.2.2-rc.3 plugin --profile grove add "$PWD"
|
|
46
|
+
npx --yes @deepseek-ai/dsh@0.2.2-rc.3 --profile grove
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
Initialize a separate profile once. If the `grove` profile already exists, install or launch directly. In your trial profile, keep host shell access, file editing, general automation, and other extensions from accessing the vault or running confirmation commands on your behalf. Grove’s model tools provide role guidance, drafts, and allowlisted reads. Harness sessions also follow the host’s routing, permissions, and history settings.
|
|
50
|
+
|
|
51
|
+
### Install the command-line tool
|
|
52
|
+
|
|
53
|
+
A global installation puts the package’s `grove` executable on PATH. Installing the plugin in a profile registers it with the host.
|
|
54
|
+
|
|
55
|
+
```sh
|
|
56
|
+
npm pack --pack-destination /tmp
|
|
57
|
+
npm install --global /tmp/dsh-grove-0.1.1.tgz
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
## Everyday use
|
|
61
|
+
|
|
62
|
+
1. Run `grove capture --body 'Why might coordination costs increase as an organization grows?'` and open the `Grove` folder in Obsidian to see the Markdown note.
|
|
63
|
+
2. Explore in Harness. Use `grove_role` for a thinking partner, knowledge assistant, research assistant, critical reviewer, or creation assistant. Ask `grove_propose` to draft a note when you want to keep something, and supply the conversation reference you want to save. You can also end the exploration there.
|
|
64
|
+
3. Run `grove preview DRAFT_ID` in your terminal. Use `grove accept DRAFT_ID` and type `SAVE`, or run `grove discard DRAFT_ID`. Pass `--file` when accepting to supply your edited body.
|
|
65
|
+
4. Use `grove list` and `grove show ASSET_ID --version 1` to revisit your notes. To share selected notes with the model, set `GROVE_READABLE_IDS` to a comma-separated list of asset IDs before starting the host. Restart the host after revoking that access. Content already shared in a session follows the host’s history settings.
|
|
66
|
+
|
|
67
|
+
## Basic research
|
|
68
|
+
|
|
69
|
+
```sh
|
|
70
|
+
grove add question --body 'How does team size affect decision speed?'
|
|
71
|
+
grove add research --question QUESTION_ID --body 'Compare decision authority and coordination costs'
|
|
72
|
+
grove add evidence --body 'Add a checkable excerpt' --source 'https://example.org/report' --locator 'Page 12, paragraph 2'
|
|
73
|
+
grove add claim --body 'My current judgment'
|
|
74
|
+
grove update CLAIM_ID --version 1 --link EVIDENCE_ID --relation supports
|
|
75
|
+
grove update RESEARCH_ID --version 1 --link CLAIM_ID --relation related
|
|
76
|
+
grove update RESEARCH_ID --version 2 --stage analysis
|
|
77
|
+
grove update RESEARCH_ID --version 3 --stage review --status closed
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
Use the IDs returned by the earlier commands. You can revisit stages and pause, reopen, or archive questions and projects. Evidence can support, refute, or qualify a claim. Links target specific versions. When you rewrite a claim, its earlier evidence links stay on the earlier version. You can explicitly adopt evidence again for the new version. A research project can close with or without a deliverable.
|
|
81
|
+
|
|
82
|
+
## Data and removal
|
|
83
|
+
|
|
84
|
+
Version files in `Grove/` use YAML properties, Markdown bodies, and Obsidian wikilinks. Grove reads within its own folder. Copy the whole folder, including hidden drafts, to back it up or move it. You can read and edit bodies in Obsidian while preserving file names and Grove metadata. Use `grove update` to retain the earlier version. The current version records source identifiers and locations you supply. See the [plugin details](docs/DETAIL.en.md) for current limits.
|
|
85
|
+
|
|
86
|
+
To remove the host plugin, run `npx --yes @deepseek-ai/dsh@0.2.2-rc.3 plugin --profile grove remove dsh-grove`. Your vault data stays in place. Remove the command separately with `npm uninstall --global dsh-grove`.
|
|
87
|
+
|
|
88
|
+
## Brand assets
|
|
89
|
+
|
|
90
|
+
See the [brand assets](brand/README.en.md) and the visual identity guide ([English](brand/VI.en.md) · [简体中文](brand/VI.md)). Tests check that the package’s `icon.svg` matches `brand/mark.svg` byte for byte.
|
|
91
|
+
|
|
92
|
+
## Contributing
|
|
93
|
+
|
|
94
|
+
Read the [development contract](AGENTS.en.md) ([简体中文](AGENTS.md)). The Claude Code, Cursor, and Copilot instructions point to the same contract. See the [development guide](docs/development/README.md) for issue structure, acceptance, and review rules, and the [journal](docs/journal/) for handoffs. Before making changes, run the tests and `bash scripts/check-compat.sh`.
|
|
95
|
+
|
|
96
|
+
## Verify from source
|
|
97
|
+
|
|
98
|
+
```sh
|
|
99
|
+
npm ci
|
|
100
|
+
npm test
|
|
101
|
+
npm pack
|
|
102
|
+
```
|
package/README.md
CHANGED
|
@@ -1,10 +1,30 @@
|
|
|
1
1
|
# Grove（知林）
|
|
2
2
|
|
|
3
|
-
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
[简体中文](README.md) · [English](README.en.md)
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
[](LICENSE)
|
|
8
|
+
[](package.json)
|
|
9
|
+
[](package.json)
|
|
10
|
+
|
|
11
|
+
## 个人知识与认知成长
|
|
12
|
+
|
|
13
|
+
**PKGS（Personal Knowledge & Growth System）是一套面向个人长期成长的方法。** 它把思想探索、知识学习、证据研究、创造和反思接起来。过去读懂的东西可以解释今天遇到的问题，今天形成的判断也可以因明天发现的证据而改变。长期积累的是能重新调用的知识，以及理解、判断、研究和表达的能力。
|
|
14
|
+
|
|
15
|
+
这套方法可以用纸笔、Markdown 或自己熟悉的工具实践。[PKGS 方法指南](docs/PKGS.zh.md)从设计依据讲到日常操作，包括如何孵化问题、建立知识关联、开展研究、记录观点的变化，以及怎样与 AI 分工。
|
|
16
|
+
|
|
17
|
+
- **思想探索**从一个观察、困惑或联想开始。你可以随时停下，也可以留一个开放问题以后接着想。研究和产出都由你选择。
|
|
18
|
+
- **知识成长**从用自己的话解释开始。把概念、例子和疑问连起来，在应用和回顾中检验理解。
|
|
19
|
+
- **研究与创造**从值得核查的问题开始。保留来源、反例和判断的不同版本，需要时把形成的认识写成文章、报告或方案。复盘所得可以成为下一轮探索的起点。
|
|
20
|
+
|
|
21
|
+
AI 可以追问、比较解释、查找反例和协助表达。你决定相信什么、留下什么以及和谁分享。
|
|
22
|
+
|
|
23
|
+
## Grove 如何实践这套方法
|
|
24
|
+
|
|
25
|
+
Grove 是连接 DeepSeek Harness 和 Obsidian 的插件。当前版本把自由对话、自主保存和基础证据研究接在一起。你可以从会话挑出值得保留的内容，把它保存成自己 vault 里的 Markdown，并用版本和双链回看问题、证据与判断的关联。指南里的学习、反思和完整研究方法可以手工实践。
|
|
26
|
+
|
|
27
|
+
## 安装 v0.1.2
|
|
8
28
|
|
|
9
29
|
需要 Node.js 22 或更高版本、一个已有的 Obsidian vault，以及 DeepSeek Harness `>=0.2.2-rc.1 <0.3.0`。兼容范围由 `engines.dsh` 声明：它必须是范围而不是某一个精确版本，否则 dsh 会把整个 bundle 判为不兼容并跳过加载。
|
|
10
30
|
|
|
@@ -34,7 +54,7 @@ npx --yes @deepseek-ai/dsh@0.2.2-rc.3 --profile grove
|
|
|
34
54
|
|
|
35
55
|
```sh
|
|
36
56
|
npm pack --pack-destination /tmp
|
|
37
|
-
npm install --global /tmp/dsh-grove-0.1.
|
|
57
|
+
npm install --global /tmp/dsh-grove-0.1.2.tgz
|
|
38
58
|
```
|
|
39
59
|
|
|
40
60
|
## 日常使用
|
|
@@ -61,7 +81,7 @@ grove update RESEARCH_ID --version 3 --stage review --status closed
|
|
|
61
81
|
|
|
62
82
|
## 数据和卸载
|
|
63
83
|
|
|
64
|
-
`Grove/` 内的版本文件使用 YAML 属性、Markdown 正文和 Obsidian 双链。Grove 不读 vault 中其他笔记。复制整个 `Grove/` 文件夹即可备份或迁移，点号开头的草稿文件也会随整目录迁移。可在 Obsidian 阅读及编辑正文，保留文件名和 Grove 元数据。要保留更改前的版本，使用 `grove update
|
|
84
|
+
`Grove/` 内的版本文件使用 YAML 属性、Markdown 正文和 Obsidian 双链。Grove 不读 vault 中其他笔记。复制整个 `Grove/` 文件夹即可备份或迁移，点号开头的草稿文件也会随整目录迁移。可在 Obsidian 阅读及编辑正文，保留文件名和 Grove 元数据。要保留更改前的版本，使用 `grove update`。本版证据使用用户填写的来源标识与定位。当前能力的边界见[插件详情](docs/DETAIL.zh.md)。
|
|
65
85
|
|
|
66
86
|
用 `npx --yes @deepseek-ai/dsh@0.2.2-rc.3 plugin --profile grove remove dsh-grove` 卸载宿主插件。数据留在 vault，终端命令可通过 `npm uninstall --global dsh-grove` 单独卸载。
|
|
67
87
|
|
package/docs/DETAIL.en.md
CHANGED
|
@@ -1,6 +1,10 @@
|
|
|
1
1
|
# Grove
|
|
2
2
|
|
|
3
|
-
Grove
|
|
3
|
+
Grove connects DeepSeek Harness and Obsidian to help you build knowledge you can revisit and revise, and develop your own judgment over time. The current plugin supports open-ended exploration, user-confirmed saves, and basic research.
|
|
4
|
+
|
|
5
|
+
- **Explore freely and pursue research when it serves you.** Start with a passing idea and stop whenever you like. Keep an open question for later and decide whether to develop it into a project or a finished work.
|
|
6
|
+
- **Keep the evidence and the history of your thinking.** Record where evidence came from and link it to the version of a claim it supports, challenges, or qualifies. Revisit that record when your judgment changes.
|
|
7
|
+
- **Think with AI and stay in control of your knowledge.** AI can ask questions, offer other explanations, and draft notes. You decide what to adopt, save, and share. Your saved knowledge lives in your own Obsidian vault as Markdown.
|
|
4
8
|
|
|
5
9
|
## What it provides
|
|
6
10
|
|
package/docs/DETAIL.zh.md
CHANGED
|
@@ -1,6 +1,10 @@
|
|
|
1
1
|
# Grove（知林）
|
|
2
2
|
|
|
3
|
-
Grove
|
|
3
|
+
Grove 是连接 DeepSeek Harness 与 Obsidian 的个人知识成长插件，帮助你积累可回看、可修正的知识，在长期探索中形成自己的判断。当前版本支持自由探索、自主保存和基础研究。
|
|
4
|
+
|
|
5
|
+
- **自由探索，按需研究。** 从一个念头开始，随时停下。你可以留下开放问题，等值得深究时再开展研究，成果由你决定。
|
|
6
|
+
- **保留依据和修订过程。** 记录证据出处，把支持、反驳或限定的证据连到具体版本，以便重查和修正判断。
|
|
7
|
+
- **AI 协助思考，你掌握判断和知识。** AI 可以追问、提出不同解释和起草。你决定采纳、保存和分享什么，留下的知识以 Markdown 保存在自己的 Obsidian vault 中。
|
|
4
8
|
|
|
5
9
|
## 提供什么
|
|
6
10
|
|
package/locale/en.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"meta": {
|
|
3
3
|
"title": "Grove",
|
|
4
|
-
"description": "
|
|
4
|
+
"description": "Explore with AI in DeepSeek Harness and pursue research with traceable evidence. You choose what to save and share. Keep knowledge you can revisit and revise in your own Obsidian vault.",
|
|
5
5
|
"detail": "docs/DETAIL.en.md"
|
|
6
6
|
}
|
|
7
7
|
}
|
package/locale/zh.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"meta": {
|
|
3
3
|
"title": "Grove（知林）",
|
|
4
|
-
"description": "在 Obsidian vault
|
|
4
|
+
"description": "在 DeepSeek Harness 中与 AI 自由探索，按需开展有据可查的研究。你决定保存和分享什么，知识以可回看、可修正的 Markdown 笔记留在自己的 Obsidian vault。",
|
|
5
5
|
"detail": "docs/DETAIL.zh.md"
|
|
6
6
|
}
|
|
7
7
|
}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-grove",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.1.2",
|
|
4
|
+
"description": "Explore with AI in DeepSeek Harness and grow knowledge you can revisit and revise in your own Obsidian vault",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"main": "./src/plugin.js",
|
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
},
|
|
14
14
|
"icon": "icon.svg",
|
|
15
15
|
"bin": {
|
|
16
|
-
"grove": "
|
|
16
|
+
"grove": "src/cli.js"
|
|
17
17
|
},
|
|
18
18
|
"files": [
|
|
19
19
|
"src",
|