hoyyang/dsh-project-manager 预览 preview

hoyyang/dsh-project-manager

Project board for DeepSeek Harness: kanban card groups, cards linked to landfill-project memory, mounted repos and sessions.

Project Overview项目介绍

dsh-project-manager is a native kanban plugin built specifically for DeepSeek Harness (DSH). It is installed with dsh plugin add dsh-project-manager (or dsh plugin add github:ho yyang/dsh-project-manager) into a DSH web instance running 0.1.5-rc.1 or newer, requires no account, no API key, and no setup, and uses the official DSH workspaceRegistry plus a systemPrompt.context hook to inject card memory. The data model maps card groups to parent projects and cards to tasks; each card can reference several on-disk /landfill-project STATE.md files, mount several repositories, and bind several DSH sessions. A "Project Hub" (hub) workspace is auto-registered at the top of the DSH sidebar so every project session lives in one place.

The typical workflow is: open the "Project Board" panel or the per-group board button, create a card group, hit Enter repeatedly in the stage footer to spawn cards, then in card details link STATE.md memories and mount repositories selected from DSH's existing workspaces (or via DSH's native folder picker). New sessions are launched from "Open session from this card" with auto-titles "Group · Card", and existing archived or live sessions are attachable via a searchable two-column picker grouped by repository. Card memories are injected each turn with deduplication against a fixed "already-read" set computed at link time, so next_action and STATE paths arrive automatically and are not re-read. Cards can be dragged across stages or advanced by the agent through card_manage, repo_manage, phase_move, and task_manage tools, with every move, link, mount, and recovery appending to events.jsonl for full audit traceability.

Configuration is zero-touch by design but overridable in the profile's cordis.patch.yml with the top-level id dsh-project-manager, exposing dataDir (default <DSH_HOME>/dsh-project-manager), aiRoot (default <HOME>/.ai, read-only), hubTitle, projectSessionMode (danger-full-access or inherit), and memoryMaxBytes (default 6000). Local build uses npm install, npm run build, npm run build:client, npm run typecheck, and npm test running 33 node:test unit cases plus Playwright GUI checks against a real DSH web instance. Limitations: the "Restore active" button depends on a core patch shipped by dsh-manage-sessions (otherwise it is greyed out with an explanatory tooltip); there is no inter-process lock when multiple DSH instances share one DSH_HOME; HTTP routes accept only loopback origins with same-origin write checks and do not touch git operations, credentials, or the network; removing a card group deletes only symlinks, never real repositories. License is MIT, published on npm and on GitHub at hoyyang/dsh-project-manager with a changelog, staged isolation verification per release, in-place upgrade compatibility from 0.2.0 dropping legacy category fields while preserving stage and card positions, and idempotent uninstall that leaves user data intact.

dsh-project-manager 是面向 DeepSeek Harness(DSH)的原生看板插件,通过 dsh plugin add dsh-project-manager 安装到 DSH 0.1.5-rc.1 以上的 web 端,零配置、零账号、零 API Key 即可启用。核心模型是「卡片组即父项目、卡片即任务」,每张卡片可关联多个 /landfill-project 落盘项目(STATE.md)、挂载多个仓库、绑定多个会话;DSH 侧栏自动置顶「项目区」工作区,会话标题统一为「卡片组 · 卡片」。安装路径支持官方 npm 包和 github:hoyyang/dsh-project-manager 直装两种方式。

典型工作流是新建卡片组 → 在阶段列底部连续回车添加卡片 → 关联落盘 STATE 与仓库 → 在卡片详情用「以此卡片新建会话」或「关联已有会话」;新会话每轮自动注入去重后的卡片记忆,已读 STATE 不重复读取,状态与 next_action 随上下文进入下一轮。看板支持拖拽推进阶段、批量导入落盘项目、跨工作区归档会话一键恢复活跃,以及 agent 在项目会话内调用 card_manage / repo_manage / phase_move / task_manage 四个工具自助推进并写入 events.jsonl 审计日志。

依赖上,落盘项目默认只读扫描 ~/.ai,数据目录默认 <DSH_HOME>/dsh-project-manager,可在 profile 的 cordis.patch.yml 覆盖 dataDir / aiRoot / hubTitle / projectSessionMode / memoryMaxBytes。项目会话默认 danger-full-access 权限,HTTP 路由仅本机回环且校验同源,不读写凭据、不访问网络、不执行 git;「恢复活跃」功能依赖 dsh-manage-sessions 的核心补丁,多个 DSH 进程共用 DSH_HOME 时无跨进程锁。许可证为 MIT。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
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 add dsh-project-manager

把 hoyyang/dsh-project-manager 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-project-manager

banner

给 DeepSeek Harness 加一块项目看板:卡片组管父项目,卡片管任务;每张卡片关联落盘项目记忆、挂载仓库、绑定会话,从卡片开的会话自动带上项目上下文。

English · Releases · 更新日志

npm downloads release license stars

安装

dsh plugin add dsh-project-manager

备选(直接从 GitHub 装):

dsh plugin add github:hoyyang/dsh-project-manager

零配置、开箱即用:装完重启 dsh web 即可,不需要账号、API Key 或任何设置项。要求 DSH 0.1.5-rc.1(实测通过,其他版本未验证)。落盘项目默认从 ~/.ai 只读扫描;要改数据目录或权限模式见下文「配置」。

功能

项目看板

  • 按项目看全局:每个卡片组一条泳道,阶段(列)名称、数量、顺序都能改;卡片在阶段内拖动排序(键盘 Alt+↑/↓),拖到别的阶段即推进。
  • 每个阶段随手加卡:阶段底部常驻「添加卡片」,回车连续添加,Esc 收起;也能从落盘项目批量导入。
  • 卡片带着项目记忆走:卡片组和卡片都能关联多个 /landfill-project 落盘项目(STATE.md),会话读取「卡片组 ∪ 卡片」去重后的记忆:一行状态、next_action、STATE 路径。
  • 会话自动读记忆,读过的不重复:从卡片新建或手动关联的会话,每一轮自动注入卡片记忆;关联时扫描会话记录,已经 read 过的 STATE 不再注入。
  • 关联已有会话:搜索会话名或仓库,活跃 / 已归档两列按仓库分组、新的在前,勾选进入「已选会话」后一次保存;一个会话只属于一张卡片。
  • 已归档一键恢复:已关联列表显示名字与状态,已归档的不能打开,点「恢复活跃」回到工作区原来的位置;「解除关联」二次确认,不删会话。
  • 挂载仓库:「添加挂载仓库」弹窗从 dsh 已添加的工作区勾选,或用 dsh 的系统选文件夹对话框;默认名称是文件夹名、可改、可多选。
  • 项目区工作区:插件在工作区列表置顶一个「项目区」,项目会话集中在这里;标题旁的看板按钮打开看板,「+」先选卡片再建会话。
  • agent 也能改看板:4 个工具 card_manage / repo_manage / phase_move / task_manage,在项目会话里不传 card 就作用于本会话的卡片。

和已有插件的差别:dsh-project-kanban 等看板插件按工作区记待办;本插件不做通用待办,只做「项目 → 落盘记忆 → 仓库 → 会话」这条链:卡片即项目,会话自动继承项目上下文。

快速上手(30 秒)

  1. 点击侧栏的「项目看板」(有「项目区」后改点它标题旁的看板按钮),再点击右上角「新建卡片组」,输入组名后按回车。
  2. 点击任意阶段底部的「添加卡片」,输入标题后按回车;可以连续输入多张。
  3. 打开卡片详情,点击「关联的落盘项目」旁的「关联」,勾选落盘项目后保存。
  4. 打开「卡片组设置」,点击仓库旁的「添加」,勾选 dsh 已有的工作区或点击「选择文件夹…」,再点击「保存」。
  5. 点击卡片详情底部的「以此卡片新建会话」:会话出现在「项目区」,标题是「卡片组 · 卡片」,已带上记忆。
  6. 点击「本卡片的会话」旁的「关联已有会话」,勾选已有会话后点击「保存关联」。
  7. 拖动卡片到下一个阶段,或点击详情里的「推进到 …」按钮推进进度。

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-theme-prts 下一个 Next dsh-conversation-share →