Z-Tasking

Obsidian 插件：按业务项目管理长期 / 临时 / 缺陷任务。每个任务是一篇 Markdown 笔记，支持工作台记进展、全量列表、日历、甘特图和周期汇总。

插件 id：z-tasking（避免与社区里其他 tasking 插件冲突）

功能概览

顶栏「全部项目 / 某项目」会影响：工作台与列表任务、进展明细与复制、日历、甘特、活跃分布、按任务计数。
我的今天与日报始终看全部项目；我的今天可开「按项目」开关做分组标记（不筛选）。

笔记结构

Z-Tasking/
  KVAD/
    _资料/
      某材料.md
    main/
      公告.md
      _公告历史/
      长期/
        某长期事项.md
      临时/
        某临时任务.md
      缺陷/
        某缺陷.md
    V7/
      公告.md
      长期/
  日报/
    2026-09-20.md

默认分支名为 main。旧版无分支段、或项目名含「 - 」的目录，会在首次打开时自动迁入新路径。

---
type: long
status: doing
start: 2026-08-10
end: 2026-09-30
---

任务说明。

## 进展

### [[2026-08-13]] 1.5h
今天做了什么。支持 **Markdown**、列表和 `[[双向链接]]`。

• type：long / temp / bug（也可用路径中的类型目录识别）
• status：todo / doing / done
• 进展标题可带工时，如 ### [[2026-08-13]] 1.5h
• 根目录可在设置里改，默认 Z-Tasking；日报始终在 根/日报/

本地开发

npm install
npm run dev      # 监听构建
npm run build    # 生产构建
npm test         # 单元测试

把本仓库复制或 junction 到：

<Vault>/.obsidian/plugins/z-tasking/

需要这三个文件被 Obsidian 读到：

• manifest.json
• main.js（npm run build 或 npm run dev 生成）
• styles.css

然后在 Obsidian：设置 → 第三方插件 → 启用 Z-Tasking。命令面板：Z-Tasking: 打开任务台。

发布到社区插件

按 官方流程。

发新版本（GitHub Release）

1. 把 package.json / manifest.json 的 version 改成新版本（可用 npm version patch 等，会同步 versions.json）
2. push 到 main 后打 tag（不要加 v 前缀，且必须与 manifest.json 的 version 一致）：

git tag 0.2.0
git push origin 0.2.0

3. GitHub Action .github/workflows/release.yml 会自动：npm ci → npm run build → 校验 tag === manifest version → 创建 Release，并上传 main.js、manifest.json、styles.css

首次提交社区目录

仓库 public、且已有匹配版本的 GitHub Release，还不会出现在 Obsidian 插件库。目录来自 community-plugins.json，必须单独提交：

1. 在 community.obsidian.md 登录，绑定 GitHub，Plugins → New plugin 提交本仓库
2. 按自动审阅反馈修改；通过后约 24 小时内可在 Obsidian 社区插件里搜到

截至 2026-11，本仓库尚未进入该目录（同作者已上架的是 obsidian-plugin-ztranslate）。所以在插件库搜 Z-Tasking / z-tasking 不会有结果。

后续版本只需打 tag 发 Release，无需再向 obsidianmd/obsidian-releases 提 PR。