personal-knowledge-base
kingsleyasher/personal-knowledge-base
DSH knowledge-base plugin and Windows desktop client sharing original-file indexing, classification, retrieval and compatible library services. 插件 2.5.5 / 客户端 1.1.2。
Install
dsh plugin --profile web add github:kingsleyasher/personal-knowledge-baseREADME
Personal Knowledge Base · Plugin and Desktop Client
Plugin 3.0.0 / client 2.0.0. Independent/shared-library operation, scoped updates and release/visual review fixes. Release notes.
2.4.6 updater limitation: a pristine installation stuck on a pending receipt cannot self-repair from the feed alone. The general recovery entry is a one-time external migration, not a zero-intervention update.
2.4.3 can update directly. Use manual recovery instructions only after an upgrade error; no preliminary transition package is required for the normal path.
Personal-Knowledge-Base is the single maintained repository for the DSH knowledge-base plugin and standalone desktop client. They share a core, contracts and library service while retaining independent installations and versions.
| Product | Published version | Direct download | Release notes |
|---|---|---|---|
| Desktop client · Windows x64 | 2.0.0 | ⬇ Download client installer (EXE) | Client Release |
| DSH knowledge-base plugin | 3.0.0 | ⬇ Download plugin (TGZ) | Plugin Release |
Release entries: client 2.0.0 · plugin 3.0.0. Choose the correct installer/TGZ and verify its product-specific manifest and digest.
One library, two entry points
- Client: full file tree and path navigation, up to four resizable panes, draggable tabs, Markdown/text/code editing, vertically scrolling selectable PDF, image zoom/pan and limited DOCX/XLSX/CSV editing.
- Plugin: DSH import, retrieval, OCR/ASR, organization workflows, relationships, indexing, backup and existing tool/UI entry points.
- Shared modules: text/vector indexing, exclusions, inbox, relationships, reading/annotations and backup. Authorized shared services coordinate writes; do not manually duplicate index databases.
- Connected workspace: the DSH sidebar provides sessions, Agent presets, model/reasoning controls and streamed replies. Users explicitly attach files or selected text. Optional memory integration depends on its corresponding host service.
- Independent operation: local client file/library functions remain available independently. The plugin retains its DSH entry points. Chat, model organization and host-provided global-memory writes require their services to be online.
Download and installation
Desktop client 2.0.0 · Windows x64
Download KnowledgeWorkbench-2.0.0-Setup.exe · Release notes and assets · SHA-256 checksums
Run the EXE to install. The bundled-runtime package includes its runtime. This is the standalone client installer, not a DSH plugin bundle.
DSH plugin 3.0.0
Download local-dsh-knowledge-base-3.0.0.tgz · Release notes and assets
Install the TGZ through DSH plugin management. GitHub highlights only one Latest release, but both products have independent releases. Use the product links above or browse all Releases.
Source, issues and future releases are maintained here. In Releases, choose the correct product: Windows Setup.exe for the client, TGZ for the plugin.
Published plugin 3.0.0: Release · TGZ. See plugin usage and mirror information for extensions and regional sources. Mirror availability can vary.
The existing client installer retains its paper-green interface and animations, requires an empty application directory and preserves personal data on uninstall. Client online checks and verified downloads are implemented; automatic in-place installation and activation remain unfinished. The plugin keeps its existing update manifests and installation flow.
Documentation
| Topic | English | 中文 |
|---|---|---|
| Unified design and evolution | Project record | 设计与演进 |
| Installation and usage | Workbench | 使用说明 |
| Shared architecture | Architecture | 架构 |
| Source development | Development | 开发与构建 |
| Release policy | Versioning | 版本规则 |
| Changes | Release notes | 版本说明 |
| Client details | Client docs | 客户端文档 |
| Retrieval, parsing and performance | Retrieval · Parsing · Performance | 检索 · 解析 · 性能 |
Product showcase · Repository structure · Privacy · Security · Contributing
Source layout
apps/desktop contains the client. src retains plugin adapters and UI paths for compatibility. packages owns the shared core, contracts and service. presets and skills contain DSH configuration rules; installer-design-b owns installer design/implementation; website is the showcase; docs/client contains client guides; tools and tests provide build and verification utilities.
Privacy, evidence and licensing
No personal libraries, conversations, credentials, index databases, runtime configurations, logs or local test outputs belong in Git. Opening a file does not automatically send it to a model; explicit attachments and cloud tasks follow provider configuration and authorization.
The merged client passed a production build and focused checks. See the project record for historical evidence and limits. Static checks and synthetic services do not establish live-model performance, cloud availability, full Office fidelity or every DSH-version compatibility.
MIT licensed. Third-party components retain their licenses; see notices.
Update policy: every eligible version in the selected channel updates automatically, including majors and previews. The client online executor remains unfinished; see version policy.
2.4.13: direct 2.4.3 updates and legacy service handoff (2026-11-05)
Restore the stable feed for direct updates from normal 2.4.3 installations. Identify the published legacy runtime by its exact fingerprint, release the probe connection and wait for its existing idle lifecycle to finish. Require matching process identity and a clean receipt before starting the new service. Never send legacy shutdown or terminate other clients/tasks; timeout offers recovery guidance.
The new client shows recovery help only after an installation or handoff error. A 2.4.3 pnpm failure before new code loads retains the old error UI; its existing release-notes link leads to recovery instructions. Do not claim the new popup exists in that old client. The recovery bundle can reconstruct damaged 2.4.3 code from the pinned public archive, preserving residual files and profile metadata before a transactional upgrade.
Windows evidence uses the actual public 2.4.3 archive, a live service and real pnpm. Initial legacy installation still runs through the old Host installer and cannot retroactively acquire transaction protection. Recovery is the fallback on failure. No live user profile installation or complete Electron UI automation is claimed; other legacy versions are outside this targeted verification.
Local update 2.5.1
Flow cards now keep text, execution settings, and actions in separate sections. Save the model and reasoning effort in the card; Run uses that configuration directly. Only missing required task parameters need an extra form.
2.5.1 task plan follow-up (2026-11-07)
Task plan disclosure and list symbols now use vectors/CSS rather than font-dependent characters. During long knowledge tasks, bounded pre-step checkpoints request truthful todo_write progress updates instead of waiting until the final response. No step is automatically marked complete from tool count or elapsed time. Install the local update package and fully restart DSH to load host changes; real long-task behavior remains an installed-host verification step.
Local update 2.5.2 (2026-11-07)
The task plan expands upward above the composer: its arrow now points up when collapsed and down when expanded.