dsh-jianji 1.0.25 → 1.0.27

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 CHANGED
@@ -17,22 +17,59 @@ dsh --profile web
17
17
 
18
18
  插件同时向模型注册以下工具,待办、记录、灵感和常用标签均可读取与修改:
19
19
 
20
- - `jianji_list`:按类型、状态、关键词和数量读取数据。
21
- - `jianji_get`:读取一条待办、记录或灵感的全部字段。
22
- - `jianji_create`:新建待办、记录或灵感;待办支持文字醒目样式,灵感需要主题与内容。
20
+ - `jianji_list`:按类型、状态、来源、日期、关键词和数量读取数据。
21
+ - `jianji_get`:按 id 或 `sourceKey` 读取一条待办、记录或灵感的全部字段。
22
+ - `jianji_create`:新建待办、记录或灵感;待办支持文字醒目样式和“AI 整理”来源字段,灵感需要主题与内容。
23
23
  - `jianji_update`:更新状态、正文、截止日期、标签、置顶、排序或灵感主题等字段,可追加执行结果。
24
24
  - `jianji_delete`:软删除或永久删除待办、记录与灵感。
25
25
  - `jianji_tags`:读取、添加或移除常用标签。
26
+ - `jianji_sync_ai_tasks`:按天批量写入“AI 整理”待办,以 `sourceKey` 去重,供每日定时任务增量产出和更新。
26
27
 
27
28
  待办卡片和详情页提供“派发给 DSH”。派发时可以补充执行方式、范围、验收标准等提示词;插件会创建新会话并立即发送任务,要求 DSH 读取最新待办、执行期间更新为“进行中”、完成后更新为“已完成”并回写执行结果。会话 id、工作区和提示词会记录在待办数据中,可从详情页重新打开对应的 DSH 会话。
28
29
 
29
30
  DSH Web 端和 Electron 桌面端共用同一个 Host 数据源。Gitee 私人令牌、DeepSeek API Key 与 GitHub 更新令牌也由 Host 持久化,但不会进入待办接口、同步仓库或模型工具可读取的数据。旧版本保存在插件页面 localStorage 中的配置会在首次加载时自动迁移到 Host。
30
31
 
32
+ ## AI 固定接口
33
+
34
+ 简记的全部数据只通过固定的 `jianji_*` 工具读写,模型不需要、也不应该直接改 localStorage、同步文件或 DSH 存储。
35
+
36
+ | 数据 | 读取 | 新建 | 更新 | 删除 |
37
+ | --- | --- | --- | --- | --- |
38
+ | 待办 `task` | `jianji_list` / `jianji_get` | `jianji_create` | `jianji_update` | `jianji_delete` |
39
+ | 记录 `record` | `jianji_list` / `jianji_get` | `jianji_create` | `jianji_update` | `jianji_delete` |
40
+ | 灵感 `inspiration` | `jianji_list` / `jianji_get` | `jianji_create` | `jianji_update` | `jianji_delete` |
41
+ | 常用标签 `common_tag` | `jianji_tags`(`list`) | `jianji_tags`(`add`) | — | `jianji_tags`(`remove`) |
42
+ | AI 整理待办 | `jianji_list`(`source: "ai"`) | `jianji_sync_ai_tasks` | `jianji_sync_ai_tasks` / `jianji_update` | `jianji_sync_ai_tasks`(`removeMissing`)/ `jianji_delete` |
43
+
44
+ 待办字段固定为 `title`、`notes`、`status`(`todo` / `doing` / `held` / `done`)、`emphasis`、`dueDate`、`tags`、`pinned`、`order`,以及“AI 整理”用的 `source`(`manual` / `ai`)、`sourceKey`、`sourceDate`(`YYYY-MM-DD`);记录为 `title`、`body`;灵感为 `topic`、`body`。所有字段都会随 Gitee 同步在设备之间保持一致。
45
+
46
+ ### AI 整理(待办的子分类)
47
+
48
+ “AI 整理”是待办下的独立子分类,条目全部来自模型从聊天记录里整理出的内容:
49
+
50
+ - 界面上在“待办”工具栏的 `全部 / AI 整理` 里切换;`全部` 仍然包含这些待办,并带“AI 整理”角标,方便一起看板排版。
51
+ - 每日任务调用 `jianji_sync_ai_tasks` 一次性写入当天结果:同一个 `sourceKey` 更新已有待办而不是重复创建;省略 `status` 时保留你已经改过的状态(例如已完成);`removeMissing: true` + `scope: "date"` 只清理同一天产出的旧条目,`scope: "all"` 清理全部 AI 整理条目。
52
+
53
+ 每日定时任务提示词示例:
54
+
55
+ ```text
56
+ 读取我最近 24 小时的 DSH 会话和聊天记录,整理出仍然需要我动手完成的事项。
57
+ 调用 jianji_sync_ai_tasks:
58
+ - date 用今天(Asia/Shanghai)的 YYYY-MM-DD;
59
+ - 每项给出稳定的 sourceKey(同一条事项跨天保持不变)、title、notes、dueDate、tags;
60
+ - removeMissing 传 true,scope 传 date。
61
+ 不要改动 source 为 manual 的普通待办。
62
+ ```
63
+
64
+ 对应的定时任务每天 08:30 触发(Asia/Shanghai):`DTSTART;TZID=Asia/Shanghai:20261115T083000` 搭配 `RRULE:FREQ=DAILY`。
65
+
31
66
  ## 功能
32
67
 
33
68
  - 移动端顶部提供记录、待办、灵感三个主入口,待办状态通过列表分组和筛选查看。
34
69
  - 移动端合并顶部导航并显示同步状态,新建或编辑时使用应用内状态、日期选择器和操作提示。
35
70
  - PC 顶部栏统一提供记录、待办、同步、设置和热力图入口,设置与热力图在弹窗中完成操作。
71
+ - PC 四列看板每条泳道可以单独打马赛克,排序右侧有“全部马赛克 / 还原全部”一键切换;马赛克状态由 DSH Host 持久化,重启或换了端口也能恢复。
72
+ - 待办新增“AI 整理”子分类,模型从聊天记录整理的待办集中在这里,每天可由定时任务增量产出和更新。
36
73
  - 灵感按主题自动聚合,每个主题下可以持续追加、编辑和删除独立灵感。
37
74
  - 独立的完整记录与随笔空间,不进入待办状态和完成流程。
38
75
  - 新建或编辑待办、新建记录或灵感时可以上传图片,由 DeepSeek 识别文字并预填标题、正文、主题、到期日与标签。