yu-xin-c/dsh-project-wiki 预览 preview

yu-xin-c/dsh-project-wiki

可审计的本地工作区项目Wiki,配备DeepSeek Harness原生Web界面

Project Overview项目介绍

DSH Project Wiki is a native plugin built exclusively for DeepSeek Harness that delivers an auditable, workspace-local project knowledge base. It captures architecture insights, design decisions, code constraints, and troubleshooting takeaways from agent-assisted development sessions as human-editable Markdown files stored directly in your project workspace. You can install it directly from GitHub using the DSH CLI with a single command, or clone the repository locally and install it from your checked out copy. It requires Node.js 22.19 or newer, and includes prebuilt bundles so no extra build step is needed for GitHub installs.

This plugin is designed for individual developers and teams that use DSH for long-term agent-assisted development. It solves the common problem of valuable context being scattered across multiple chat sessions, where old decisions and constraints can’t be easily reused in new sessions. Instead of loading entire old chat histories into your context window, it lets you curate approved project knowledge that agents can search and reference directly. All agent-generated knowledge requires manual approval before it’s added to the wiki, so you retain full control over what becomes permanent project context.

DSH Project Wiki is released under the permissive MIT open source license, so you can use it freely for personal or commercial projects. It stores all accepted wiki pages in your project’s .dsh/wiki directory, and you can commit these pages to Git for version control and team collaboration. It includes full-text search powered by SQLite FTS5, an interactive knowledge graph view, and stale content detection that flags pages when their source files change. It currently does not support cloud sync, cross-workspace sharing, or vector-based embedding search, and these are intentional limits to keep the tool focused on local, auditable knowledge.

这是一款专为 DeepSeek Harness 开发的原生插件,提供可审计、本地优先的项目 Wiki 能力,帮助将开发过程中获得的架构知识、设计决策、代码约束与排障结论沉淀下来。所有知识以 Markdown 形式保存在工作区内,支持人工阅读、编辑、审查,还可纳入 Git 版本控制,并能在源码变动时自动标记过期知识状态。

它面向使用 DSH 进行开发的团队与个人,解决 Coding Agent 上下文散落、旧会话信息无法继承的问题。典型工作流程为:由 Agent 生成知识提案,经人工审核接受后存入 Wiki,后续可随时检索查阅,也能扫描检测过期知识并更新。它支持知识图谱展示、双向链接与全文检索,帮助梳理模块间依赖关系。

该插件遵循 MIT 开源许可协议,免费可商用,要求 Node.js 版本为 22.19+ 或 24+。它默认单个工作区最多支持 1000 个页面,可配置范围为 1-10000,暂不支持云同步与跨工作区共享,也不提供向量检索能力。安装可直接通过 GitHub 远程安装,也可本地克隆后安装。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:yu-xin-c/dsh-project-wiki

把 yu-xin-c/dsh-project-wiki 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

DSH Project Wiki

面向 DeepSeek Harness 的可审计、本地优先项目 Wiki。

DSH Project Wiki 把 Agent 在开发过程中获得的架构知识、设计决策、代码约束和排障结论沉淀为工作区内的 Markdown 页面。它不是隐藏的聊天记忆:被接受的知识可以阅读、编辑、审查、搜索和提交到 Git,来源文件发生变化时也会明确标记为待更新。

An auditable, workspace-local project Wiki for DeepSeek Harness, with a native Web view and review-gated Agent contributions.

DSH Project Wiki 在 DSH Web 中的运行界面

为什么需要它

长时间使用 Coding Agent 时,真正有价值的上下文往往散落在会话里:模块边界、隐含约束、曾经失败的方案、关键文件和维护约定。新会话无法可靠继承这些信息,而把全部聊天记录重新塞进上下文既昂贵,也容易引入过期结论。

DSH Project Wiki 提供一层可控的项目记忆:

  • 知识归属于工作区:每个已注册的 DSH workspace 拥有独立 Wiki。
  • Markdown 是事实源:页面保存在仓库中,可以直接审查、备份和版本控制。
  • Agent 先提案、再接受:模型生成的知识不会自动成为已确认事实。
  • 结论可追溯到源码:页面可以记录工作区相对路径及其 SHA-256 指纹。
  • 过期知识可见:来源文件变化或消失后,页面会显示为“待更新”。
  • 索引可随时重建:SQLite FTS5 只负责检索,不承载唯一数据。

核心能力

能力 说明
原生 Web 界面 在 DSH 会话中增加 Wiki 标签,集中展示页面、提案、状态和正文
Markdown 编辑 创建、编辑和删除页面,支持 GFM 表格、列表、代码块等语法
全文检索 使用 SQLite FTS5 搜索标题、摘要、标签和正文
提案审核 Agent 提案与正式页面分开保存,用户可以在界面中接受或拒绝
来源指纹 保存页面时计算来源文件 SHA-256,并显示短指纹用于审查
过期扫描 比较已记录指纹和当前文件,标记变化或缺失的来源
知识图谱与双向链接 正文使用 [[page-slug]] 或 [[Page title]] 建立关系,自动计算反向链接并生成可交互图谱
修订记录 页面记录 revision、创建时间、更新时间及 Web/Agent 操作者
Agent 工具 根 Agent 可以搜索、读取、检查来源、创建提案和应用提案

工作方式

flowchart LR
  Session["DSH Session"] --> Registry["Workspace Registry"]
  Registry --> Service["Project Wiki Service"]
  Web["Wiki Web View"] -->|Loopback RPC| Service
  Agent["Root Agent"] -->|Wiki tools| Service
  Service --> Pages["Markdown pages"]
  Service --> Proposals["Review proposals"]
  Service --> Index["Rebuildable FTS5 index"]
  Service --> Sources["Workspace source fingerprints"]

每次 Web RPC 或 Agent 工具调用都会从活动 Session 重新取得 cwd,再通过 DSH WorkspaceRegistry 解析真实工作区。插件不会信任浏览器传入的目录,也不会让一个会话读取另一个工作区的 Wiki。

知识图谱

图谱视图把当前工作区已经接受的 Wiki 页面组织成一张可交互的有向图。它和全文检索互补:搜索适合直接找到某个结论,图谱适合观察模块之间的依赖、共同上下文和知识空白。

DSH Project Wiki 知识图谱视图

图结构直接从 Markdown 派生,不维护另一套不可见的图数据库:

  • 节点:每个正式页面对应一个节点,标题用于显示,页面状态决定颜色。
  • 有向边:页面正文中的 [[target]] 生成一条“当前页面 → 目标页面”的边。
  • 目标解析:target 可以是页面 slug 或标题;匹配会进行 Unicode NFKC 规范化、去除首尾空格并忽略大小写。
  • 未解析节点:链接目标尚不存在时,图中保留一个虚线空心节点,侧栏同时显示未解析数量。
  • 去重:同一页面多次引用相同目标只生成一条关系,节点度数仍可用于视觉权重。
  • 状态:绿色表示有效页面,琥珀色表示来源已变化,空心节点表示未解析链接;当前选中页面带蓝色描边。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-sidebar-Explorer-Plus 下一个 Next dsh-web-artifact-designer →