dsh-task-ledger 0.0.131 → 0.0.133
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +82 -4
- package/README.zh-CN.md +86 -0
- package/assets/icon.svg +4 -0
- package/dist/client.js +1328 -907
- package/dist/client.js.map +1 -1
- package/dist/host/routes.js +31 -2
- package/dist/index.d.ts +15 -0
- package/dist/index.js +37 -2
- package/locale/en.json +6 -0
- package/locale/zh.json +6 -0
- package/package.json +12 -4
- package/skill/README.md +122 -30
- package/skill/SKILL.md +1 -1
- package/skill/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,8 +1,86 @@
|
|
|
1
1
|
# dsh-task-ledger
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**English** · [简体中文](https://github.com/cq-guojia/dsh-task-ledger/blob/main/packages/plugin/README.zh-CN.md)
|
|
4
4
|
|
|
5
|
-
-
|
|
6
|
-
- the **task-ledger** skill bundled for global agent use
|
|
5
|
+
A [DeepSeek Harness](https://www.npmjs.com/package/@deepseek-ai/dsh) (dsh) plugin that gives the `task-ledger` skill a board. The agent records tasks, progress and conclusions as plain files in the repository; this plugin reads those files and presents them as a working view — in-flight work by owner, unclaimed tasks, overdue and stalled items, and a history of everything closed.
|
|
7
6
|
|
|
8
|
-
|
|
7
|
+
Nothing is stored outside the repository. There is no account, no hosted backend and no service marketplace involved.
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
## Install
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
dsh plugin add dsh-task-ledger
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
The plugin bundles the skill: once installed, every dsh session has the ledger commands available and no separate skill installation is required.
|
|
18
|
+
|
|
19
|
+
Requirements: dsh. The plugin reads Git repositories; multi-user synchronisation uses Git 2.27 or newer.
|
|
20
|
+
|
|
21
|
+
## What the board provides
|
|
22
|
+
|
|
23
|
+
### Overview
|
|
24
|
+
|
|
25
|
+
| Element | Content |
|
|
26
|
+
|---|---|
|
|
27
|
+
| Summary cards | My open tasks, unclaimed, overdue, closed this week, in progress, backlog, stalled, closed last week |
|
|
28
|
+
| Trend chart | Closed, still-open and newly created tasks per day or per week, with a "mine only" scope |
|
|
29
|
+
| Task list | In-flight tasks with state, tags, owner and last update; tabs for all, unclaimed, in progress, backlog, overdue and stalled |
|
|
30
|
+
| Filters | Workspace, owner and free-text search |
|
|
31
|
+
|
|
32
|
+
Overdue means seven days elapsed since the task was claimed; stalled means three days without an update. Both are derived from timestamps, never entered by hand.
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
|
|
36
|
+
### Task actions
|
|
37
|
+
|
|
38
|
+
Each row exposes the actions its state permits: claim, resume, complete, release and cancel.
|
|
39
|
+
|
|
40
|
+
- **Resume** opens an agent session with a prompt that reads the recorded progress and reports back.
|
|
41
|
+
- **Complete** offers two modes: close directly with a one-line summary, or hand the task to an agent, which reads the progress, writes the conclusion and remaining issues, then closes it.
|
|
42
|
+
- **Cancel** records a reason.
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
### History
|
|
47
|
+
|
|
48
|
+
A separate view aggregates everything closed: a trend chart switchable between day, week and month, counters for today, this week, this month and this quarter with previous-period comparison, and the closed tasks grouped by day, showing creator, owner and execution time.
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
### Identity and settings
|
|
53
|
+
|
|
54
|
+
The first visit asks for an identity — create a new one or claim an existing one from the ledger roster. The settings page allows renaming (propagated to every registered ledger, committed and pushed where a remote exists), switching identity, and managing the list of ledgers: add a directory, or hide one from the board without affecting the data.
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
|
|
58
|
+
## Where the data lives
|
|
59
|
+
|
|
60
|
+
```
|
|
61
|
+
ledger/
|
|
62
|
+
├── pool.json unclaimed tasks (shared)
|
|
63
|
+
├── owners.json index: identity → shard file
|
|
64
|
+
├── owners/<hash>.json one shard per person
|
|
65
|
+
├── worklog/<YYYYMM>/*.md task documents
|
|
66
|
+
└── history/<YYYYMM>.md closed tasks
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
The plugin only reads this structure, except for the actions listed above, which run the same CLI that the skill uses. State files are never edited by the board directly.
|
|
70
|
+
|
|
71
|
+
## Using the ledger
|
|
72
|
+
|
|
73
|
+
The board is a view over the ledger; the ledger itself is driven by what you say to the agent — open a task, claim it, record progress, hand it back, close it, cancel it. Which phrase triggers which operation, and the rules the agent follows, are listed in the [`task-ledger`](https://www.npmjs.com/package/task-ledger) README.
|
|
74
|
+
|
|
75
|
+
## Other agents
|
|
76
|
+
|
|
77
|
+
Agents that are not dsh can install the same skill on its own — with the skills CLI, or by copying `packages/skill` into their skills directory; see the [`task-ledger`](https://www.npmjs.com/package/task-ledger) package for per-agent installation.
|
|
78
|
+
|
|
79
|
+
## Links
|
|
80
|
+
|
|
81
|
+
- Repository and full documentation: <https://github.com/cq-guojia/dsh-task-ledger>
|
|
82
|
+
- The skill package: [`task-ledger`](https://www.npmjs.com/package/task-ledger)
|
|
83
|
+
|
|
84
|
+
## Licence
|
|
85
|
+
|
|
86
|
+
MIT
|
package/README.zh-CN.md
ADDED
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
# dsh-task-ledger
|
|
2
|
+
|
|
3
|
+
[English](README.md) · **简体中文**
|
|
4
|
+
|
|
5
|
+
[DeepSeek Harness](https://www.npmjs.com/package/@deepseek-ai/dsh)(dsh)插件，为 `task-ledger` skill 提供看板。任务、进度与结论由代理以纯文本文件写入仓库；本插件读取这些文件，呈现为一个可操作的视图 —— 按责任人划分的在办工作、待认领任务、逾期与停滞项，以及全部已结案任务的历史。
|
|
6
|
+
|
|
7
|
+
所有数据都在仓库内，不依赖账号、托管后端或任何服务市场。
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
## 安装
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
dsh plugin add dsh-task-ledger
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
插件已内置 skill：安装后每个 dsh 会话都可直接使用台账命令，无需另行安装 skill。
|
|
18
|
+
|
|
19
|
+
环境要求：dsh 本体。插件读取 Git 仓库；多人同步需 Git 2.27 及以上。
|
|
20
|
+
|
|
21
|
+
## 看板提供什么
|
|
22
|
+
|
|
23
|
+
### 总览
|
|
24
|
+
|
|
25
|
+
| 元素 | 内容 |
|
|
26
|
+
|---|---|
|
|
27
|
+
| 统计卡 | 我的待办、待认领、逾期、本周结案、进行中、积压、停滞、上周结案 |
|
|
28
|
+
| 趋势图 | 按日或按周展示已结、未结与新建任务，可限定「只看我的」 |
|
|
29
|
+
| 任务列表 | 在办任务的状态、标签、责任人与最后更新时间；可按全部、待认领、进行中、积压、逾期、停滞切换 |
|
|
30
|
+
| 筛选 | 工作区、执行人与关键词检索 |
|
|
31
|
+
|
|
32
|
+
「逾期」指认领后已过七天；「停滞」指三天没有进展。两者均由时间戳推导，不可手工填写。
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
|
|
36
|
+
### 任务操作
|
|
37
|
+
|
|
38
|
+
每一行只显示当前状态允许的操作：认领、继续、完成、释放、取消。
|
|
39
|
+
|
|
40
|
+
- **继续** — 打开代理会话，提示词要求代理读取已记录的进度并汇报。
|
|
41
|
+
- **完成** — 两种方式：直接结案并写一句摘要；或交给代理，由代理读完进度、写出结论与遗留问题后结案。
|
|
42
|
+
- **取消** — 记录理由。
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
### 历史
|
|
47
|
+
|
|
48
|
+
独立视图聚合全部已结案任务：可在日、周、月之间切换的趋势图；今日、本周、本月、本季度的结案计数，并与上一周期对照；以及按日分组的结案任务，列出创建人、执行人与执行时间。
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
### 身份与设置
|
|
53
|
+
|
|
54
|
+
首次进入需确认身份 —— 新建，或从台账名册中认领已有身份。设置页支持修改昵称（同步至每一本已登记台账，有远端则提交并推送）、切换身份，以及管理台账清单：添加目录，或将某一本从看板上隐藏（数据不受影响）。
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
|
|
58
|
+
## 数据落点
|
|
59
|
+
|
|
60
|
+
```
|
|
61
|
+
ledger/
|
|
62
|
+
├── pool.json 公共池:未认领任务
|
|
63
|
+
├── owners.json 索引:身份 → 分片文件
|
|
64
|
+
├── owners/<hash>.json 每人一份分片
|
|
65
|
+
├── worklog/<年月>/*.md 任务正文
|
|
66
|
+
└── history/<年月>.md 已结案任务
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
除上述操作外，插件只读这套结构；写操作走与 skill 相同的命令行工具，看板不会直接改写状态文件。
|
|
70
|
+
|
|
71
|
+
## 怎么用
|
|
72
|
+
|
|
73
|
+
看板只是台账之上的一层视图；台账本身由你对代理说的话驱动 —— 建任务、认领、记进度、退回、结案、取消。哪句话触发哪个操作，以及代理必须遵守的约束，见 [`task-ledger`](https://www.npmjs.com/package/task-ledger) 包的 README。
|
|
74
|
+
|
|
75
|
+
## 其他代理
|
|
76
|
+
|
|
77
|
+
非 dsh 的代理可单独安装同一份 skill —— 用 skills CLI，或把 `packages/skill` 复制进其技能目录；各代理的安装方式见 [`task-ledger`](https://www.npmjs.com/package/task-ledger) 包。
|
|
78
|
+
|
|
79
|
+
## 链接
|
|
80
|
+
|
|
81
|
+
- 仓库与完整文档：<https://github.com/cq-guojia/dsh-task-ledger>
|
|
82
|
+
- skill 包：[`task-ledger`](https://www.npmjs.com/package/task-ledger)
|
|
83
|
+
|
|
84
|
+
## 许可
|
|
85
|
+
|
|
86
|
+
MIT
|
package/assets/icon.svg
ADDED
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="153 153 718 696" width="718" height="696">
|
|
2
|
+
<path d="M725.333333 181.333333A117.333333 117.333333 0 0 1 842.666667 298.666667v298.666666A117.333333 117.333333 0 0 1 725.333333 714.666667h-181.333333v42.666666h74.666667a32 32 0 0 1 0 64h-213.333334a32 32 0 0 1 0-64h74.666667v-42.666666H298.666667A117.333333 117.333333 0 0 1 181.333333 597.333333V298.666667A117.333333 117.333333 0 0 1 298.666667 181.333333h426.666666zM298.666667 245.333333c-29.44 0-53.333333 23.893333-53.333334 53.333334v298.666666c0 29.44 23.893333 53.333333 53.333334 53.333334h426.666666c29.44 0 53.333333-23.893333 53.333334-53.333334V298.666667c0-29.44-23.893333-53.333333-53.333334-53.333334H298.666667z" fill="#405580"></path>
|
|
3
|
+
<path d="M384 480a32 32 0 0 1 32 32v42.666667a32 32 0 0 1-64 0v-42.666667a32 32 0 0 1 32-32z m128-85.333333a32 32 0 0 1 32 32v128a32 32 0 0 1-64 0v-128a32 32 0 0 1 32-32z m128-85.333334a32 32 0 0 1 32 32v213.333334a32 32 0 0 1-64 0V341.333333a32 32 0 0 1 32-32z" fill="#FF7D03"></path>
|
|
4
|
+
</svg>
|