Introduction¶
When using DSH for development over a long period, valuable context is often scattered across sessions: module boundaries, design decisions, implicit constraints, failed solutions, and maintenance relationships between key files. New sessions cannot reliably inherit this information, and stuffing the entire chat history back into the context is both expensive and prone to introducing outdated conclusions.
Below is an introduction to yu-xin-c/dsh-project-wiki. This is a local-first Wiki plugin for DeepSeek Harness that consolidates accepted project knowledge into Markdown pages within the workspace, supporting native Web viewing, retrieval, proposal review, source expiry checking, and knowledge graphs.
What is it¶
yu-xin-c/dsh-project-wiki is maintained by yu-xin-c under the MIT license. It records the architecture knowledge, design decisions, code constraints, and troubleshooting conclusions that the Agent gains during development as Markdown pages within the workspace.
These pages are not hidden chat memories: users can read, edit, review, and search them; when the source files bound to a page change, the page is also flagged for update.
Core Features¶
The plugin currently provides the following capabilities:
- Native Web Interface: Provides a Wiki view in the DSH Web session.
- Markdown Editing: Create, edit, and delete pages.
- Full-text Search: Lexical search based on FTS5; does not include embedding or vector databases.
- Proposal Review: Agent proposals and formal pages are processed separately; after user approval, they enter the formal knowledge base.
- Source Fingerprint: Pages can associate with relative source files in the workspace and record source fingerprints.
- Expiry Scan: After code changes, check which pages need updating.
- Knowledge Graph & Bi-directional Links: Establish relationships through links between pages and generate an interactive graph.
- Revision History: Retain creation, update, and operation information for pages.
- Agent Tools: Support Agent participation in Wiki operations; persistent proposals and proposal acceptance require manual approval.
Installation and Usage¶
Node.js requirements are:
22.19+ 或 24+
Use the following command to install the plugin:
npx --yes @deepseek-ai/dsh@latest plugin --profile web add github:yu-xin-c/dsh-project-wiki
After installation, register or select a workspace in DSH Web, enter the session bound to that workspace, and you can open the Wiki tab to use it.
Typical Usage¶
Follow the steps below to use:
- Register or select a workspace in DSH Web.
- Create a session bound to that workspace.
- Open the Wiki tab at the top of the session.
- Use “New Page” to record facts, decisions, and constraints, or let the Agent create pending review proposals.
- Add workspace-relative source files, such as
src/services/auth.ts. - After code changes, click “Scan for Expiry” to check which pages need updating.
Applicable Scenarios¶
This plugin is suitable for scenarios that require fixing project knowledge within the workspace:
- Long-term maintenance of the same repository, wishing to consolidate architectural conclusions and maintenance conventions.
- Wanting the knowledge obtained by the Agent to be readable, reviewable, and traceable.
- Wanting a clear correspondence between page sources and code changes.
- Wanting new conclusions from the Agent to enter proposals first, rather than directly overwriting existing knowledge.
Notes and Security Boundaries¶
The following boundaries need to be considered before use:
- This is a project-level local Wiki; it does not provide cloud synchronization or cross-workspace sharing.
- Search is currently lexical search based on FTS5 and does not include embedding or vector databases.
- The plugin will detect source changes but will not automatically determine how new code should rewrite conclusions.
- Pages must be explicitly saved by the Web user, or enter the formal knowledge base after the user approves an Agent proposal.
- Web APIs are exposed only via DSH loopback RPC.
- The active Session and registered workspace are re-verified on every call.
- The Wiki directory must be a relative directory within the workspace.
- Source paths cannot escape the workspace using
.., absolute paths, or symbolic links. - Agent persistent proposals and proposal acceptance operations require manual approval.
- Node.js requirements are
22.19+or24+. - License is MIT.
The plugin runs with the current DSH process and operates on workspace files accessible by that process. It is recommended to check the source code, dependencies, and license before installation to ensure they meet team security requirements.
Conclusion¶
The value of dsh-project-wiki lies in transforming the project knowledge generated by the Agent into visible, reviewable, and traceable workspace pages. It does not pursue the automatic replacement of human judgment, but rather exposes “which conclusions come from which sources and when review is needed.”
GitHub repository:
https://github.com/yu-xin-c/dsh-project-wiki