DSH Plugins Marketplace

DSH Plugins

Plugins

/

Tools & Capabilities

/

wishos-plan-book

w

wishos-plan-book

Manifest valid

Document-form plan task-book plugin for DeepSeek Harness: one entry skill plus three tools — structure check, skeleton generator, package self-check — for a four-element task book, with the protocol r

hasBundlePatch

wishos-plan-book · 计划任务书(文档态计划)独立插件

创作者 / Creator:ZiMing-X(GitHub: https://github.com/ZiMing-X)· 许可证 / License:Apache-2.0(见 LICENSE)

一句话:把「计划任务书」从 V12 技能束里拆出来单独装 —— 1 个入口技能 + 3 个工具 + 规程全文,即插即用、自带门禁、可一行回滚。

这是 0.2.0 公开版:references/ 已做「署名归一 + 内部项目代号脱敏」(md5 见 gate.mjs A9 与 SPLIT.md),原私有版归档在内部 dist。

30 秒上手(装完之后)

① 自检      plan_book_health()                        → ok=true(技能已注册 · 7/7 夹具)
② 生成骨架  plan_book_new    path=docs/某任务-任务书-v1.0.md  title="某任务"  batches=5
③ 填实质内容(人/agent 逐批填四要素)
④ 校验      plan_book_check  path=docs/某任务-任务书-v1.0.md
            → extractable 且 placeholders=0 = 真过;
              extractable_with_placeholders = 结构过但还没填完;
              not_extractable = 缺表 / 表里缺键 / 没总门禁

对话里直接说下面这些词,技能会自动触发: 计划任务书 / 任务书 / 文档态计划 / 分批执行计划 / 四要素 / 推进门禁 / 总门禁 / 计划冻结 / 执行记录 / 复盘回流。

你想干什么怎么说 / 怎么调
判断这事该不该写任务书「这任务要不要写任务书?」→ 技能按门槛表判(单步/即问即答 ⇒ 豁免)
写一份新任务书「帮我写个任务书」或 plan_book_new
审一份已有任务书「按四要素校验这份计划」或 plan_book_check
查插件是否正常plan_book_health
看四要素怎么写 / 正反样例让技能读 references/four-elements.md(按需,不常驻上下文)

它是不是独立 / 即插即用

  • 零第三方依赖:plugin.js 只 import node:fs / node:path / node:url(门禁 A10 每次复跑)。
  • 只依赖 DSH 核心服务:inject = ['skills', 'tools'],两者都是宿主自带能力,不需要其它插件。
  • 资源全在包内:技能正文读 skills/plan-book/SKILL.md,references/、schema、manifest 都按包内路径解析(resourceBase 指向包内目录);不读宿主其它目录、不改预设技能根。
  • 一条命令安装:dsh plugin add "file:<tgz>" —— 同时写 dependencies 与 dsh.profile.bundles,本机实测热加载、无需重启。
  • 与其它 wishos 包无关:wishos-v12-core-skills(不依赖)、wishos-core / wishos-ops(无关)。
  • 兼容面:Node >=22.19.0;dsh >=0.2.1-rc.2 <0.2.2-0 || >=0.2.2-rc.1 <0.3.0-0(engines 声明,门禁 A6 校验)。

已知边界(诚实登记):

#边界处置
1install.cmd / install.ps1 仅 WindowsLinux/macOS(如 NAS 容器)直接用 tgz:dsh plugin add "file:/path/x.tgz"
2dsh plugin remove 是否自动清 dsh.profile.bundles 那一行未验证卸载后用 uninstall.ps1 报告残留,或人工核对 profile 的 package.json 两处
3宿主若不支持热加载重启 dsh(会中断当前会话)后再调 plan_book_health
4本包是文档态计划机器态计划(JSON / MetaSkill)走 plan-template → plan-executor,不归本包

包布局

wishos-plan-book/
├── package.json              # dsh.bundle.patch + exports/files + engines.dsh
├── cordis.patch.yml          # 一行 insert(id = wishos-plan-book)
├── plugin.js                 # 技能注册 + 3 工具 + 结构判据内核(零依赖)
├── skills.manifest.json      # 技能清单(name/description/whenToUse)
├── skills/plan-book/
│   ├── SKILL.md              # 入口技能:判档 → 六步 → 四要素 → 三条硬规则 → 反模式
│   └── references/
│       ├── doc-plan-protocol.md   # 规程全文(字节一致复制 · md5 见 SPLIT.md)
│       └── four-elements.md       # 四要素写法 + 正反样例
├── schemas/plan-book.schema.json  # 任务书 frontmatter 约束
├── locale/{zh,en}.json · icon.svg
├── tools/dev/gate.mjs        # 包内门禁(结构 10 + mock 冒烟 + 夹具 + 能红 + parity)
├── SPLIT.md                  # 拆解清单:边界 / 逐件 md5 / 退场 / 未验证
├── LICENSE                   # Apache-2.0
└── README.md

工具

工具参数判据(缺一不可)
plan_book_checkpathstatus=extractable 且 placeholders=0 才算真过;extractable_with_placeholders 表示结构过关但实质未填
plan_book_newpath title [plan_id] [batches=3] [date] [execution_log] [scope] [redlines] [force=false]生成件自身须过 plan_book_check;已存在文件默认拒绝覆盖
plan_book_health—ok=true:1 技能已注册 + references 在盘 + 7 项结构夹具全过

结构判据与 Python 参考实现 _plan4-check.py 同源不同实现(互为探针): 表头四键须落在 4 个不同列 · 每行四列非空(— 表示“无”,不等于留空)· 全文须有 total_gate/「总门禁」声明。

安装

方式 A(推荐 · 即插即用):tgz 一条命令

# 1) 找 dsh CLI(不在 PATH 时用本机 checkout 路径,按实际安装位置改)
$dsh = (Get-Command dsh -ErrorAction SilentlyContinue).Source
if (-not $dsh) { $dsh = "$env:USERPROFILE\dsh-0.2.1\node_modules\.bin\dsh.cmd" }

# 2) 备份 profile 配置(保险)
$pkg = "$env:USERPROFILE\.dsh\profiles\web\package.json"
Copy-Item $pkg "$pkg.bak-$(Get-Date -Format yyyyMMdd-HHmmss)"

# 3) 安装(file: + 正斜杠;包在哪个目录就 Resolve-Path 哪个)
& $dsh plugin --profile web add "file:$((Resolve-Path .\wishos-plan-book-0.2.0.tgz).Path -replace '\\','/')"

Linux / macOS:

dsh plugin --profile web add "file:/path/to/wishos-plan-book-0.2.0.tgz"

实测 2026-11-07:dsh CLI 0.2.1-rc.2 · pnpm 11.28.7 · 8.7 s。dsh plugin add 会同时写 dependencies 与 dsh.profile.bundles,宿主热加载后 plan-book 技能与 3 个工具即可用。

方式 B(开发态):link 源码目录

& $dsh plugin --profile web add "link:<包源码目录绝对路径>"
node <包源码目录>\tools\dev\gate.mjs --parity "<元项目>\docs"

link: 指向源码,改完即生效;挪走/改名包目录会断链。file:(tgz)是安装副本,不受源码改动影响。

装完就地验证(三步,均已实测通过)

node "$env:USERPROFILE\.dsh\profiles\web\node_modules\wishos-plan-book\tools\dev\verify-install.mjs" "$env:USERPROFILE\.dsh\profiles\web"
# V0–V4 全绿:包可解析 / 入口可 import / 导出形态对 / 版本一致
# 然后在会话里调用:
#   plan_book_health                                   → ok=true(3/3 文件 · 已注册 · 7/7 夹具)
#   plan_book_check  path=<任一任务书.md>                → 真任务书应 extractable
#   plan_book_new    path=<新路径> title=<标题> batches=3 → extractable_with_placeholders + 拒覆盖

宿主侧门槛(包内自证):dsh.bundle.patch 已声明 · engines.dsh 覆盖 0.2.1-rc.2 · 零第三方依赖 · 包内零盘符绝对路径 · 入口同时声明 main 与 exports["."]。

验证(不需要装宿主)

cd <包源码目录>
node tools/dev/gate.mjs                 # 结构 + mock 宿主冒烟 + 夹具 + 能红 → 期望退码 0(18 项)
node tools/dev/gate.mjs --parity "<元项目>\docs"   # 追加 JS↔Python parity(127 份真实文档:22 PASS / 105 FAIL,mismatch 0)

--parity 需要 Python 在 PATH(参考实现路径写在 gate.mjs 顶部 PY_REF,只读;便携包里可用环境变量 PLAN4_CHECK 指定)。 已知好/坏样本对照也已实测:医保 v1.1(12 行四键)→ extractable;v1.0 → not_extractable(理由「缺表」)。

卸载 / 回滚

& $dsh plugin --profile web remove wishos-plan-book
# 删后人工核对 profile\package.json 两处(dependencies + dsh.profile.bundles)是否都已清掉
# —— remove 是否自动清 bundles 行未验证;然后重启宿主

包目录保留不删即可(未激活=零副作用)。一键卸载(Windows):uninstall.ps1 -Profile web,它会报告 bundles 残留。

退场(移走预设里同名的 doc-plan-protocol,避免双副本)见 SPLIT.md §四 —— 装成并通过验证后才做。

与其它包的关系

包关系
wishos-v12-core-skills不依赖。它若装过,本包的 plan-book 与它的 doc-plan-protocol 是两套并存;退场步骤负责收掉重复
wishos-core无关(persona/工具面 vs 计划文档形态)
wishos-ops无关

许可证 / License

Apache-2.0(全文见 LICENSE):可自由使用、修改、再分发;请保留 LICENSE 与版权声明。 技能正文与规程全文改写自项目内部协议(公开版已做「署名归一 + 内部项目代号脱敏」,不改变条款含义)。 Copyright 2026 ZiMing-X(GitHub: https://github.com/ZiMing-X)。

Versions

Latest versionPublishedSize
0.2.0——

Comments

Loading…

Similar plugins

docgen

by JohnXu22786

Document workshop skill pack: four pure-prompt Agent Skills that turn a codebase into READMEs, PR descriptions, changelogs and code reviews, installed into dsh via a dsh.bundle plugin row.

Tools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 0

MIT

Python

Sep 27, 2026

dsh plugin --profile web add dsh-docgen

by bauerelizabeth07139

DeepSeek Harness plugin that bundles the simple-plan skill: plan, execute with worker subagents, verify every deliverable with memoryless verifier subagents, and fix in at most three cycles. The Skill is shipped by the bundle, so there is nothing to copy into a skills directory.

Tools & CapabilitiesSessions & MessagesManifest valid

★ 0

MIT

JavaScript

Oct 8, 2026

dsh plugin --profile web add dsh-simple-plan

by hasan-aghayev

Automatically orchestrates complex DeepSeek Harness requests. It detects when delegation is useful, builds a dependency-aware plan, assigns bounded researcher, architect, backend, frontend, tester, an

Workflow & AutomationManifest valid

★ 0

MIT

TypeScript

Oct 22, 2026

dsh plugin --profile web add dsh-task-orchestrator

Delivery workflow preset for DeepSeek Harness: an agent protocol plus seven tools that keep user requests verbatim, record feedback decisions, plan tasks with acceptance criteria, log real verificatio

Workflow & AutomationManifest valid

★ 0

dsh plugin --profile web add dsh-plugin-dev-workflow

by KratosLee-6

DeepSeek Harness Plugins · A local-first DeepSeek Harness plugin for discovering, combining, and turning skills into actionable ideas.

Tools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 1

MIT

TypeScript

Nov 8, 2026

dsh plugin --profile web add dsh-plugin-spark

by CHAAAAA

DeepSeek Harness(DSH)的项目与工程管理插件,把需求、项目文档、Git 提交、AI 提交信息、代码评审、工作树、后台任务与周报聚合到一个侧边栏工作台里。

Manifest valid

★ 0

MIT

TypeScript

Nov 2, 2026

dsh plugin --profile web add dsh-devbench-plugin