@isdou/dsh-journal 0.0.0-stage → 0.1.4

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/LICENSE ADDED
@@ -0,0 +1,10 @@
1
+ Copyright (c) 2026 isdou. All rights reserved.
2
+
3
+ This package is distributed for installation and use with DeepSeek Harness.
4
+ Permission is granted to download, install, and run an unmodified copy for that
5
+ purpose. No open-source license is granted. Permission to modify, redistribute,
6
+ sublicense, or incorporate this code into another product is not granted by this
7
+ publication. All other rights are reserved by the copyright holder.
8
+
9
+ Third-party software, including dependencies and the host, remains subject to
10
+ its own licenses.
package/README.md CHANGED
@@ -1,3 +1,119 @@
1
- # Temporary Holding Version
1
+ # DSH 日记 · DSH Journal
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ > **写了一整天代码,下班 3 秒搞定工作周报。**
4
+ > 自动穿透 DeepSeek Harness 会话足迹与文件改动,一键提炼清晰的结构化工作日报、周报与项目总结。
5
+
6
+ ## 为什么需要 DSH 日记?
7
+
8
+ 每天跟 AI 结对编程、修改了数十个文件,下班面对空白的汇报框抓耳挠腮?
9
+ - **一键穿透会话足迹**:自动识别会话消息与工具调用记录,智能过滤失败尝试,精准提炼「做了什么、已交付、待办项」。
10
+ - **结构化成果交付**:保留完整上下文来源,区分计划、失败探索与实际完成,让向上汇报和团队同步条理分明。
11
+ - **纯本地极速与隐私保障**:本地整理完全不消耗模型 Token;AI 总结按需触发且数据不出本地配置模型,支持一键编辑、复制与导出 Markdown。
12
+
13
+ ## 能做什么
14
+
15
+ - 按日、周、月或自定起止日期整理,支持 IANA 时区,包含开始和结束当天。
16
+ - 读取所选期间内的消息和工具执行记录,也能找到较早创建、本期仍有活动的会话。
17
+ - AI 报告聚焦 **做了什么、已完成、待办**;保留来源,区分计划、失败与实际完成。
18
+ - 使用 DSH 已配置的模型,可为简报单独选择模型;支持时自动使用关闭思考或较轻推理档。
19
+ - 根据模型上下文容量安排完整输入,容量不足时再分批,最多并发两批。
20
+ - 本地整理不调用模型;报告可编辑、保存、复制和下载为 Markdown。
21
+
22
+ ![DSH 日记示例界面](assets/preview.png)
23
+
24
+ 截图使用合成示例数据,不含真实会话。
25
+
26
+ ## 安装
27
+
28
+ 已验证 **DeepSeek Harness 0.2.2-rc.3**(macOS Desktop 与隔离 Web),运行时要求 Node 24.9 及以上。接口处于预览阶段,其他 DSH 版本需要重新验证。
29
+
30
+ 在 DSH 的 **插件 → 添加插件 → Git 来源** 中输入:
31
+
32
+ ```text
33
+ github:isdou/dsh-journal#v0.1.3
34
+ ```
35
+
36
+ Web 命令行安装:
37
+
38
+ ```sh
39
+ dsh plugin --profile web add github:isdou/dsh-journal#v0.1.3
40
+ ```
41
+
42
+ macOS Desktop 使用应用随附的 CLI:
43
+
44
+ ```sh
45
+ '/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh' plugin --profile desktop add github:isdou/dsh-journal#v0.1.3
46
+ ```
47
+
48
+ 安装或升级后按 DSH 提示重启。也可在本仓库的 Releases 下载 `.tgz`,在插件页选择本地安装包。
49
+
50
+ 添加本插件的发现索引:
51
+
52
+ ```text
53
+ https://raw.githubusercontent.com/isdou/dsh-journal/main/index.json
54
+ ```
55
+
56
+ ## 使用
57
+
58
+ 1. 在左侧打开 **DSH 日记**,选择日期和时区。
59
+ 2. 点击 **扫描记录** 核对来源与数量。
60
+ 3. 选择 **AI 工作报告** 或 **本地记录整理**,点击 **生成报告**。
61
+ 4. 阅读、编辑、保存、复制或下载。范围说明和源会话可展开查看。
62
+
63
+ 周报快捷范围为本周一至今天,月报为本月一日至今天。首版由用户点击生成,不含定时调度或外部发送。
64
+
65
+ 生成时间取决于记录量和模型。公开版默认沿用宿主模型;为简报配置已支持关闭思考的快速模型,可以减少等待。日常对话的默认模型与推理设置不受简报偏好影响。
66
+
67
+ ## 数据、模型与隐私
68
+
69
+ 默认报告与偏好保存在:
70
+
71
+ ```text
72
+ <DSH_HOME>/storages/dsh-journal/reports/
73
+ ```
74
+
75
+ `DSH_HOME` 默认为 `~/.dsh`。备份该目录可保留报告;升级安装包不会更换报告目录。从同一目录中的本地旧版升级时,仅将原安装目录 `data/reports/` 内的报告及偏好复制到新位置,保留原文件,且不覆盖新位置已有内容。
76
+
77
+ 可通过 `ISDOU_DSH_JOURNAL_DATA_DIR` 指定独立报告目录。使用显式目录时不自动迁移旧安装目录的数据。
78
+
79
+ 报告目录的 `preferences.json` 仅保存简报模型标识,不保存密钥。默认沿用宿主配置:
80
+
81
+ ```json
82
+ { "reportModel": null }
83
+ ```
84
+
85
+ 如需单独选择 DSH 已配置的模型,将 `reportModel` 设为含 `provider` 和 `model` 的对象,值使用你自己的模型标识。修改后重新加载插件或重启 DSH。指定模型不可用时明确报错,不静默换到另一模型。
86
+
87
+ 插件通过宿主只读会话服务读取记录,不修改源会话,也不执行记录中的工具。扫描、本地整理和浏览历史均不请求模型;只有点击生成 AI 报告时,所选期间的文字与执行证据才会发送给页面显示的简报模型。该模型可能是云端服务,适用其自身的数据处理规则。
88
+
89
+ 插件没有自建上传服务、遥测或广告。发布包不含会话、报告、模型偏好或凭据。报告可能含工作记录,请按自己的资料保管。
90
+
91
+ ## 覆盖范围
92
+
93
+ - 文件操作次数只反映记录中可确认的文件工具结果,不等于唯一文件数、全部 Git 改动或净增删行数。
94
+ - 终端命令造成的变更、DSH 外部修改和未持久化快照可能不完整。
95
+ - 读取可见文字和工具结果,不解析图片、附件正文或模型内部思考;分支继承前缀去重。
96
+ - 会话无法读取时保留覆盖提示,避免把读取失败当作没有活动。
97
+ - AI 输出仍需按来源核对,成功写入不等于测试通过、发布或用户验收。
98
+
99
+ ## 开发与验证
100
+
101
+ 源码位于本目录,Host 和 Client 使用原生 ESM,React 由宿主共享,无需另外构建 UI。
102
+
103
+ ```sh
104
+ npm ci
105
+ npm test
106
+ npm run check
107
+ npm pack --dry-run
108
+ npm run dev
109
+ ```
110
+
111
+ 开发命令使用本机已安装 DSH CLI,默认启动 `http://127.0.0.1:3082`。`DSH_HOME`、`DSH_AGENTS_HOME` 与报告目录均显式指向本项目 `.dev/`;通过 `DSH_JOURNAL_CLI` 可指定 CLI 路径。开发环境不复制用户的模型凭据。
112
+
113
+ 可显式运行 `node scripts/seed-demo.mjs` 准备合成会话。存储、日期边界、证据读取、模型预算、无损来源表、取消/失败和模型覆盖均有自动测试;真实界面和模型效果另外验证。
114
+
115
+ ## 授权与反馈
116
+
117
+ Copyright © 2026 isdou。允许下载、安装、运行原版;其他权利保留,详见 [LICENSE](LICENSE)。依赖及宿主遵循各自许可证。
118
+
119
+ [问题反馈](https://github.com/isdou/dsh-journal/issues) · [发布版本](https://github.com/isdou/dsh-journal/releases) · [DSH 官方项目](https://github.com/deepseek-ai/deepseek-harness)
Binary file