Luke-Yong/dsh-plugin-project-management

dsh-plugin-project-management

一个 DeepSeek Harness 插件，它会
就某个项目对用户进行访谈，生成项目时间线 / 甘特图，
并将其导出为 Word 或 Excel。

该 agent 掌控整个循环：它运行结构化访谈（通过
project-interview 技能），将功能分解为任务，并使用五个工具
来验证、排期、调整、持久化和导出。排期计算是
确定性的。项目（定义 + 时间线）会持久化到工作区
项目文件（data/project_management/project_data.json），从而在多个
会话之间得以保留，并且该插件会在会话恢复时提醒 agent 存在已有的时间线。

工具

| 工具 | 用途 |
|---|---|
| pm_project_define | 将访谈结果验证/规范化为一个标准的 ProjectDefinition（功能、优先级、日期、里程碑、按持续时间分配的 agent 预算、约束）；并持久化它 |
| pm_timeline_generate | 确定性调度器：依赖感知、工作日感知的日期计算（周末 + 该国的公共假日，通过 calendar.country）、关键路径、截止日期 + 预算可行性检查；持久化定义 + 时间线 |
| pm_timeline_update | 修补任务（重命名、依赖关系、工作量、agent 数量、手动日期固定），重新排期并持久化 |
| pm_project_load | 从 data/project_management/project_data.json 加载已保存的项目（定义 + 时间线）——在恢复会话时使用 |
| pm_timeline_export | 写出 .docx（摘要、任务排期、里程碑、预算）或 .xlsx（Summary、Tasks、彩色甘特图工作表） |

技能

- project-interview —— 对话式访谈协议：功能 →
优先级 → 时间线/里程碑 → 按持续时间分配的 agent 预算（小时 /
成本 / agent 数量 / 自定义，附带一个周期）→ 约束。

安装

构建该插件（服务端 + 浏览器 bundle），然后使用 Cordis overlay
补丁加载它：

npm install
npm run build       # tsc server → dist/, esbuild client → lib/client.js

从 GitHub 安装

prepare 脚本会自动构建两部分，因此从 GitHub 安装无需
提交 dist//lib/（它们已被 gitignore）。直接从 GitHub 将插件
安装到 web profile：

dsh plugin --profile web add github:Luke-Yong/dsh-plugin-project-management

这会在 profile 目录内转发执行 pnpm add github:Luke-Yong/dsh-plugin-project-management。
等同于手动将该包安装到 DeepSeek
Harness checkout 中：

npm install github:Luke-Yong/dsh-plugin-project-management

./package.json 被导出，以供需要 dsh.client manifest 的工具使用。

从 DeepSeek Harness checkout 安装：

pnpm dsh web --patch /absolute/path/to/dsh-plugin-project-management/cordis.yml

该插件包必须能够从配置树的 baseUrl 解析到——请将其安装
或 pnpm link 到 harness checkout 中（根据 client-modules 解析规则，
它是 cordis.yml 包的依赖项）。
打开 http://127.0.0.1:3080 并提问，例如：

为我的移动应用规划一个时间线，并将其导出为 Word 和 Excel。

Web UI

项目管理 Web UI

该插件附带一个浏览器端部分，包含两个界面：

- 对话头部视图标签页中的 Project 标签页（即
conversation.view 插槽——与 ui-trajectory 使用的机制相同）。注意：
视图标签页环仅在会话激活后（≥ 1 轮对话）才会出现。
- 编辑器堆栈内的 紧凑项目停靠栏（conversation.input.dock），
即使会话为空也会渲染，并在项目存在时自动出现，
因此在标签页显示之前即可访问项目管理。

选择该标签页（或查看停靠栏）会显示：项目名称、描述和
最后更新时间；时间线跨度、任务数量和可行性；阶段、关键
路径、里程碑和未解决的冲突；代理预算模型。

该面板从
/plugins/project-management/state 读取当前会话保存的项目状态（服务器解析会话 cwd——会话
头部 → 工作区注册表 → 进程 cwd——并读取
data/project_management/project_data.json）。无需修改 harness——
两个界面均可与原生 Web 应用配合使用。

流程

1. 代理会询问你（功能、截止日期、里程碑、按
时长分配的代理预算）。
2. 它调用 pm_project_define 来锁定并持久化该定义。
3. 它将功能分解为任务并调用 pm_timeline_generate。
4. 它与您一起审查可行性，并通过 pm_timeline_update 进行调整。
5. 它使用 pm_timeline_export 导出（format: docx | xlsx）。

持久化与会话恢复

- 定义和时间线会保存到 /data/project_management/project_data.json，
采用 templates/gantt.html 使用的项目计划 schema（project、tiers、
phases、tasks、milestones、sprints——外加一个用于插件
往返状态的 _dsh 块）。布局遵循 Project-Journey Planner 示例：
data/project_management/project_data.json 由 templates/gantt.html 使用。
- 在同一工作区中的新会话中，当存在时间线时，插件会向
模型上下文注入一条提醒，告知代理已保存的计划及其冲突；
然后代理调用 pm_project_load 以继续。
- 写入是原子的（临时文件 + 重命名）。旧版 .dsh-pm/project.json 会
作为向后兼容的回退方案被读取。

注意事项 / MVP 限制

- 每个工作区仅支持单个项目。

路线图

- 通过 presentCall / presentResult 实现自定义 Web UI 甘特图视图。
- 多项目和实时代理预算跟踪。