dsh-weekly-report-lau 1.2.2 → 1.3.1
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 +191 -201
- package/lib/index.js +1 -1
- package/package.json +5 -13
- package/plugin.json +142 -168
- package/service/engine/gen-weekly.mjs +8 -33
- package/service/engine/lib/rules.mjs +99 -4
- package/service/public/index.html +336 -336
- package/smoke.mjs +80 -9
- package//346/223/215/344/275/234/344/275/277/347/224/250/346/211/213/345/206/214.html +259 -267
- package/install.mjs +0 -526
- package/install.sh +0 -29
- package//344/270/200/351/224/256/345/256/211/350/243/205.cmd +0 -44
- package//344/270/200/351/224/256/345/256/211/350/243/205.command +0 -29
- package//344/270/200/351/224/256/345/256/211/350/243/205.vbs +0 -93
package/README.md
CHANGED
|
@@ -1,201 +1,191 @@
|
|
|
1
|
-
# 周报工作台 · dsh-weekly-report v1.
|
|
2
|
-
|
|
3
|
-
**装上即用的 DSH
|
|
4
|
-
|
|
5
|
-
> 使用者手册:[`操作使用手册.html`](./操作使用手册.html)(单页、导航 + 搜索 + 一键复制)。本文是维护者速览。
|
|
6
|
-
|
|
7
|
-
## 版本号规则
|
|
8
|
-
|
|
9
|
-
| 变化类型 | 动哪一位 | 例子 |
|
|
10
|
-
|---|---|---|
|
|
11
|
-
| 小改动(文案、样式、单点修复) | 最后一位 | `1.1.0` → `1.1.1` |
|
|
12
|
-
| 功能级 / 行为变化 | 第二位 | `1.0.x` → `1.1.0` |
|
|
13
|
-
| 不兼容的大改版 | 第一位 | `1.x` → `2.0.0` |
|
|
14
|
-
|
|
15
|
-
当前 **1.
|
|
16
|
-
|
|
17
|
-
当前 **1.
|
|
18
|
-
|
|
19
|
-
|
|
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
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
-
|
|
175
|
-
-
|
|
176
|
-
-
|
|
177
|
-
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
-
|
|
182
|
-
- `
|
|
183
|
-
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
-
|
|
188
|
-
-
|
|
189
|
-
-
|
|
190
|
-
-
|
|
191
|
-
-
|
|
192
|
-
- 引擎 `--where` 路径解析正常;`renderReport` 输出与历史周报样例逐字一致(含「重要说明:无」缺省与全半角冒号);`--perf-template-check` 成功识别 11 张月度考核表。
|
|
193
|
-
- 本机实际数据被正确识别:已有 API Key、处理人、输出目录、7 份历史周报、11 张绩效表。
|
|
194
|
-
|
|
195
|
-
## 安全与回滚
|
|
196
|
-
|
|
197
|
-
- 服务只监听 `127.0.0.1`;周报读取限制在输出目录内,静态资源防目录穿越。
|
|
198
|
-
- 配置 / Key 写前自动备份,损坏文件另存 `.corrupt` 不静默覆盖。
|
|
199
|
-
- `node install.mjs --uninstall` 恢复原 `node_modules` 链接、`package.json` 依赖与 bundle 清单、旧版 `service/server.cjs`,并移除自动插入的配置块;`<data>` 数据完整保留。
|
|
200
|
-
- 所有被改动的文件都有时间戳备份,集中在 `<data>/backups/`(原链接、旧 server.cjs)与 DSH profile 目录(`*.bak-*`)。
|
|
201
|
-
- 索引/配置可能包含个人信息,**不要把 `<data>` 目录打包分享**。
|
|
1
|
+
# 周报工作台 · dsh-weekly-report v1.3.1
|
|
2
|
+
|
|
3
|
+
**装上即用的 DSH 完整插件**:即装即用,自动注册 bundle、自动常驻面板服务、自动打开面板,全程不用敲命令。API Key、输出目录、绩效表与模板由使用者按需提供,插件负责识别并据此生成、输出。
|
|
4
|
+
|
|
5
|
+
> 使用者手册:[`操作使用手册.html`](./操作使用手册.html)(单页、导航 + 搜索 + 一键复制)。本文是维护者速览。
|
|
6
|
+
|
|
7
|
+
## 版本号规则
|
|
8
|
+
|
|
9
|
+
| 变化类型 | 动哪一位 | 例子 |
|
|
10
|
+
|---|---|---|
|
|
11
|
+
| 小改动(文案、样式、单点修复) | 最后一位 | `1.1.0` → `1.1.1` |
|
|
12
|
+
| 功能级 / 行为变化 | 第二位 | `1.0.x` → `1.1.0` |
|
|
13
|
+
| 不兼容的大改版 | 第一位 | `1.x` → `2.0.0` |
|
|
14
|
+
|
|
15
|
+
当前 **1.3.1**:新增「补创工单」时间规则——工单里填报的工时日期早于工单创建日期时(先干活、后补单),周报「时间」起点以**工时日期**为准,不再用建单日期;终点沿用现口径(已完成取完成日,未完成拉到本周日)。例:11/9 建单、工时填 11/6 → 未完成显示「11月6日-15日」。跨月补创工单恢复识别(不再连带屏蔽任务中心),但产出仍严格按本次生成周期判定,工时不在生成跨度内时「识别但不生产」,不会把上月活儿重复报进本月周报。时间计算抽成 `weekTimeOf` 纯函数,冒烟测试直接覆盖该规则(96/96)。
|
|
16
|
+
|
|
17
|
+
当前 **1.3.0**:移除整套「本地 link 安装 + 旧宿主兼容转发 + 一键安装器」机制,插件回归纯 npm 包形态——不再携带 install.mjs 与一键安装脚本,bundle 由包内 `cordis.patch.yml` 自动挂载、宿主心跳每 20s 保活;安装 / 升级 / 卸载统一走 `pnpm add` / `pnpm remove`。README 与操作手册同步改为标准流程说明。
|
|
18
|
+
|
|
19
|
+
当前 **1.2.2**:修复安装校验 install.mjs --verify 的「dependency 已注册」在 npm 安装形态下(profile 依赖为版本范围 ^1.2.x)被误判红字——现兼容 link: 本地链接与 npm 版本范围两种安装形态;清理本地私库后该项的旧宿主转发无关校验自动达标。
|
|
20
|
+
|
|
21
|
+
当前 **1.2.1**:修复历史页「复制全文」在旧版 WebView 内核里因 Clipboard API 被禁用而失败(新增 execCommand 降级 + 自动选中兜底);手动复制强制只写纯文本,粘贴不再带字体/底色/行号,历史页 Ctrl+A 只选中周报正文。1.2.0 新增「定时生成」模块(设置页配置每周生成时间,插件内置调度器到点自动生成并同步绩效表,默认周六 12:00、默认关闭;左下角实时展示定时安排)。1.1.3 面板服务与面板页显示的版本号都直接读 `package.json`,不会再出现「包是新的、界面还是旧号」。1.1.3 概览「周报格式」预览改为通用脱敏示例值(不含真实学校、链接或工单号),并移除「看真实数据」入口。1.1.2 面板样式全面改用 flex 布局(兼容不支持 CSS Grid 的旧内核 WebView)、开关改为「滑块 / 文案 / 已开启已关闭徽标」单行 flex 结构、按钮与说明文字分层更清晰。1.1.1 修复开关滑块与文字重叠、开关增加「已开启/已关闭」状态徽标、结构检测结果不再贴顶。
|
|
22
|
+
|
|
23
|
+
## 安装(标准流程:npm)
|
|
24
|
+
|
|
25
|
+
本插件通过 npm 发布,**安装、升级、卸载只走标准流程**,不需要任何本地安装器或脚本:
|
|
26
|
+
|
|
27
|
+
1. 在 DSH 的 profile 目录(`%USERPROFILE%\.dsh\profiles\desktop`)执行:
|
|
28
|
+
```bash
|
|
29
|
+
pnpm add dsh-weekly-report-lau
|
|
30
|
+
```
|
|
31
|
+
或编辑 `package.json` 的 `dependencies` 加入 `"dsh-weekly-report-lau": "^1.3.1"` 后 `pnpm install`。
|
|
32
|
+
2. bundle 由包内 `cordis.patch.yml` 自动挂载;Host 半身由宿主心跳每 20 秒保活、挂了自动拉起;面板地址 `http://127.0.0.1:8798/`。
|
|
33
|
+
3. **不需要重启 DSH**:新包就位后,宿主下一次心跳(≤20 秒)即拉起新版本面板;若侧边栏没刷新,点面板里的刷新即可。
|
|
34
|
+
|
|
35
|
+
### 为什么是标准流程
|
|
36
|
+
|
|
37
|
+
注册插件要写 profile 的依赖与 `dsh.profile.bundles`、挂载 `cordis.patch.yml` 的 insert 块——这些由 DSH 在 `pnpm install` 时按 npm 包元数据自动完成,无需任何本机安装脚本。旧版的「链接 node_modules」「兼容转发旧 server.cjs」「一键安装脚本」等机制已全部移除,插件就是纯粹的 npm 包。
|
|
38
|
+
|
|
39
|
+
环境依赖只有两条:**Node ≥ 20**(DSH 自带)、**本机 DSH profile 目录可写**;不依赖联网(绩效表组件已随包自带),不需要 Python 或外部服务。
|
|
40
|
+
|
|
41
|
+
| 命令 | 用途 |
|
|
42
|
+
|---|---|
|
|
43
|
+
| `pnpm add dsh-weekly-report-lau` | 安装 / 升级到最新版 |
|
|
44
|
+
| `pnpm remove dsh-weekly-report-lau` | 卸载,使用者数据(`%USERPROFILE%\.dsh\weekly-report\`)完整保留 |
|
|
45
|
+
| `npm run repair` | 检查并修复历史周报里被切断的记录 |
|
|
46
|
+
|
|
47
|
+
面板地址:`http://127.0.0.1:8798/`,也可以直接在浏览器打开。
|
|
48
|
+
|
|
49
|
+
## 是不是「完全插件化、装完即用」
|
|
50
|
+
|
|
51
|
+
**是。** 本包是完整的 DSH 插件:`package.json` 声明 `dsh.bundle` / `dsh.client`,含 Host 半身(保活)、浏览器半身(侧边栏入口)、本地面板服务、周报生成引擎和面板网页,不依赖桌面脚本、Python 或外部服务。**`pnpm add dsh-weekly-report-lau` 即完成全部动作并自动打开面板**,装完侧边栏直接可用,无需重启 DSH。
|
|
52
|
+
|
|
53
|
+
三点边界说清楚:
|
|
54
|
+
|
|
55
|
+
| 事项 | 实际情况 |
|
|
56
|
+
|---|---|
|
|
57
|
+
| 安装动作 | `pnpm add dsh-weekly-report-lau` 即可,无命令行输入。若从 DSH 插件页添加本包,Host 半身会自举数据目录、面板服务与绩效表组件,能力一致。 |
|
|
58
|
+
| 绩效表组件 | **完整分发包自带 `node_modules/exceljs`,零网络、零补装**。只有用户主动精简掉 `node_modules` 时才需要补装 —— 已由安装器与设置页按钮自动完成,不再依赖 PATH 里的 npm。 |
|
|
59
|
+
| 需要使用者提供 | API Key、处理人、输出目录、绩效表目录与模板 —— 这是数据,不是插件不完整。 |
|
|
60
|
+
|
|
61
|
+
安装形态为纯 npm 包,无额外自检脚本;面板在线状态见侧边栏状态点,或访问 `http://127.0.0.1:8798/api/ping` 返回 JSON。
|
|
62
|
+
|
|
63
|
+
## 装完之后只需三件事
|
|
64
|
+
|
|
65
|
+
1. **设置 → 研发平台接入**:粘贴你的 API Key(工单数据来源),填处理人姓名,可点「测试连接」验证。
|
|
66
|
+
2. **设置 → 输出与模板**:填周报输出目录;需要绩效表时再填绩效表目录(放入月度考核表 .xlsx);模板不改就沿用约定格式。
|
|
67
|
+
3. **生成**:选本周 / 上周 / 本月 / 自定义区间,点「开始生成」。
|
|
68
|
+
|
|
69
|
+
邮件通知**默认关闭**、SMTP 全空,插件不预置任何凭据。概览页的「准备情况」会把还缺什么直接说清楚。
|
|
70
|
+
|
|
71
|
+
## 口径与约定
|
|
72
|
+
|
|
73
|
+
本包在开发期参考了 DeepSeek Harness 的历史会话索引(仅用于确定规则与偏好,**运行时不读取会话内容**)。沿用下来的约定:
|
|
74
|
+
|
|
75
|
+
| 约定 | 内容 | 落实位置 |
|
|
76
|
+
|---|---|---|
|
|
77
|
+
| 周报块格式 | `【类别】/ 学校 / 时间 / 事项 / 工作内容 / 重要说明 / 进度`;每周六 12:00 | `service/engine/templates/周报模板.txt`、`render.mjs` |
|
|
78
|
+
| 绩效表口径 | 本月全部周报内容、时间一致、**格式保持不能改变**;每周生成时导入,月底复核 | `--perf-auto` / `--perf-check`,`perf.mjs` 只改明细行 |
|
|
79
|
+
| 界面偏好 | 美观简洁、方便查看内容与引用/附件 | 全新 `service/public/` 四页轻界面 + 历史页全文预览 |
|
|
80
|
+
| 稳定性 | 不允许「识别不到 / 面板失败」 | 安装自动注册、`/api/ping` 轻量保活、宿主心跳保活 |
|
|
81
|
+
| 常驻方式 | 保持在线、不打扰 | 20 秒心跳静默拉起,`windowsHide` 无窗口,不装计划任务 |
|
|
82
|
+
|
|
83
|
+
## 架构
|
|
84
|
+
|
|
85
|
+
```
|
|
86
|
+
DSH 侧边栏「周报」
|
|
87
|
+
└─ iframe → http://127.0.0.1:8798/ ← service/server.cjs(Node 标准库)
|
|
88
|
+
├─ service/public/ 全新面板 UI(原生 HTML/CSS/JS)
|
|
89
|
+
├─ service/paths.cjs 数据目录 / 配置 / 模板 / 历史
|
|
90
|
+
├─ service/engine/ gen-weekly.mjs + lib/*.mjs(工单采集 / 渲染 / 绩效表)
|
|
91
|
+
└─ <data>/ %USERPROFILE%\.dsh\weekly-report\
|
|
92
|
+
config.json / api-key.txt / reports/ / logs/
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
- `lib/index.js`:DSH Host 半身,20 秒探活、挂了静默拉起。
|
|
96
|
+
- `lib/client.js`:浏览器半身,侧边栏入口 + 在线状态点。
|
|
97
|
+
- `plugin.json`:机器可读能力清单(安装方式、配置边界、格式与规则)。
|
|
98
|
+
|
|
99
|
+
## 面板交互与尺寸适配
|
|
100
|
+
|
|
101
|
+
- **统一展开/收起**:运行日志、生成结果「查看内容 / 收起内容」、周报全文、组件补装 / 月底复核输出、概览的周报格式预览,共 5 处都带状态按钮,按钮文案随状态切换,收起后不占空间。
|
|
102
|
+
- **自动匹配页面尺寸**:`100dvh` 三段式布局(顶栏 / 导航 / 主内容区自滚),所有日志、预览、弹窗高度用 `clamp()` + `dvh` 按视口计算;在 DSH 侧边栏 iframe 里也会按 iframe 实际高度适配,不出现双滚动条。
|
|
103
|
+
- **历史周报查找**:左侧列表按视口高度自适应并内部上下滚动,搜索框吸顶、显示「共 N 份 / 显示 M 份」;右侧全文独立滚动,内容多时不会把页面撑长。
|
|
104
|
+
- **消除留白**:移除固定 `min-height:440px` 与空态 `padding-top:150px`,空态改为 flex 居中;卡片间距、矮屏(≤760px)与窄屏(≤980px)分别收紧。
|
|
105
|
+
|
|
106
|
+
## 数据正确性与交互修复(本轮)
|
|
107
|
+
|
|
108
|
+
| 现象 | 根因 | 修复 |
|
|
109
|
+
|---|---|---|
|
|
110
|
+
| 周报里一条记录「学校 / 项目」为空 | 该任务无 `school_name`,`splitSchool` 也推不出校名,`{{school}}` 渲染成空行;周报条目又用空行分隔,于是一条记录被切成两段 | `rules.mjs` 用 `resolveSchool()` 多级兜底(校名 → 标题推断 → 产品 → 标题首段 → 通用事项);`render.mjs` 再把所有字段压成单行并清掉模板空行,双保险。历史文件由 `repair-report.mjs` 按 `【类别】` 行重新分块合并,已在历史页提供「检查格式」入口,写前备份、正常文件幂等不重写 |
|
|
111
|
+
| 右上角「打开数据目录」及所有打开目录按钮无反应 | 后端 `execFile('explorer.exe', ..., () => {})` 把异步错误整个吞掉,永远返回 `ok:true`;前端三处又是 `void post(...)` 不看结果 | 改用 `WINDIR` 绝对路径 + `spawn`,预检路径存在性、监听 `error`、返回真实结果;传文件路径时用 `/select,` 直接选中;前端统一 `openPath()` 给 toast,失败自动复制路径兜底 |
|
|
112
|
+
| 概览「周报格式」像是写死的 | 预览用的是 `builtinText`(内置模板),字段值全是固定示例词 | 改用**当前生效模板**渲染,明确标注「示例值」,说明学校/项目/事项/时间/进度都由工单数据填充;新增「看真实数据」切换到最近一份周报的首条记录;保存模板后实时刷新 |
|
|
113
|
+
|
|
114
|
+
**「打开数据目录」的功能点**:打开 `%USERPROFILE%\.dsh\weekly-report\`,里面是 `config.json`(配置)、`api-key.txt`、周报输出与运行日志 —— 用于查看、备份或排查,不会修改任何内容。
|
|
115
|
+
|
|
116
|
+
## 绩效表:结构识别 + 只改目标格(v1.1.0 重做)
|
|
117
|
+
|
|
118
|
+
使用者反馈「绩效表结构被改了」,根因是旧实现把版式写死(B/D/J/K/L/M、明细固定第 7 行),并且**每写一次就先把整块六列清空再重写**,还统一覆盖字体、强行改日期格式;条目超过可写行数时还会插行下移考核区块。
|
|
119
|
+
|
|
120
|
+
现在改成:
|
|
121
|
+
|
|
122
|
+
| 环节 | 做法 |
|
|
123
|
+
|---|---|
|
|
124
|
+
| 认版式 | `service/engine/lib/perf-map.mjs` 按**表头文字**找列(类别/任务名称/开始时间/结束时间/是否完成/评定),按「工作任务考核」区块标题算可写行数,「被考评人/考评时间/填报时间」也按标签找右侧单元格;认不出的字段退回默认列并在面板里标出来 |
|
|
125
|
+
| 写入 | 只改真正需要变的格子:值相同就跳过;已有内容的格子只改值不动样式;**不再清空整块、不再统一覆盖字体**;日期格式沿用模板该列已有格式 |
|
|
126
|
+
| 结构 | 写前写后各取一次结构指纹(总行数、列数、合并区数量与位置、考核区块行),有变化会在结果里如实报告,不再偷偷改 |
|
|
127
|
+
| 行数不够 | **默认不插行**,只提示「本月 N 条、可写 M 行,超出部分未写入」;确实要扩展行时在设置里勾「允许自动扩展行」 |
|
|
128
|
+
| 备份 | 每次就地写入前,把原表复制到同目录 `.perf-backup\<文件名>.<时间戳>.xlsx`,只留最近 8 份 |
|
|
129
|
+
| 使用者模板 | 设置页「绩效表模板」可指定任意一张 xlsx;留空则用当月的表或目录里最新的表。旁边的「检测表格结构」不写任何文件,把识别结果(哪列、哪几行、哪个格子)摊开给人核对 |
|
|
130
|
+
|
|
131
|
+
命令行也可以单独看:`node service/engine/gen-weekly.mjs --config <cfg> --perf-layout <xlsx>`。
|
|
132
|
+
生成时加 `--perf-preview` 只预览「将会改动哪些单元格」,不落盘。
|
|
133
|
+
|
|
134
|
+
## 周报时间口径(本周未完成 → 开始时间 ~ 本周周日)
|
|
135
|
+
|
|
136
|
+
旧版把未完成事项的结束时间拉到「统计区间末尾」,周报里出现过 `11月9日-30日` 这种越过本周的写法。
|
|
137
|
+
|
|
138
|
+
现在的口径固定为:
|
|
139
|
+
|
|
140
|
+
- **已完成**:开始时间 ~ 实际完成时间;同一天则只写一天;
|
|
141
|
+
- **未完成**:开始时间 ~ **本周周日**(本周一算起点,周日为结束),且任何一条的结束时间都不许越过本周周日;
|
|
142
|
+
- 开始时早于本周的,起点收在本周一(周报只记本周发生的事);
|
|
143
|
+
- **补创工单例外(v1.3.1)**:工时日期早于工单创建日期时,起点以**工时日期**为准,不再用建单日期(例:11/9 建单、工时 11/6 → 起点 11/6)。跨月补创工单会恢复识别,但工时不在本次生成跨度内时不写入本期周报。
|
|
144
|
+
|
|
145
|
+
时间计算统一由 `rules.mjs` 的 `weekTimeOf` 产出(含补创规则),`gen-weekly.mjs` 的 `itemsOfWeek`、末尾兜底裁剪、以及 `perf.mjs` 的 `itemsToPerfRows`(写绩效表时同样按周口径,不再写月末)共用同一口径。
|
|
146
|
+
|
|
147
|
+
## 数据来源边界
|
|
148
|
+
|
|
149
|
+
- **运行时数据源**:研发平台 MCP 的工单 / 任务 / 工时(需使用者提供 API Key)。
|
|
150
|
+
- **会话数据**:仅作为开发期设计参考,插件运行期间不读取 `~/.dsh/sessions`,也不读取 WorkBuddy 会话。
|
|
151
|
+
- **零凭据**:包内不含 API Key、SMTP 授权码、任何本机绝对路径或个人信息。
|
|
152
|
+
|
|
153
|
+
## 依赖
|
|
154
|
+
|
|
155
|
+
| 功能 | 依赖 |
|
|
156
|
+
|---|---|
|
|
157
|
+
| 周报 txt 生成、模板、历史、面板 | **零第三方依赖**,Node ≥ 20 标准库 |
|
|
158
|
+
| 绩效表 .xlsx 写入 / 月底复核 | `exceljs@4.4.0`(可选),设置页「补装绩效表组件」一键安装;未安装时明确提示,不影响周报主功能 |
|
|
159
|
+
|
|
160
|
+
**完整分发包保留 `node_modules/`(内含 `exceljs` 及其依赖),绩效表写入与月底复核零网络开箱可用**,不需要点任何补装按钮。若为了减小体积主动删掉它,安装器与设置页「检测 / 补装组件」会自动补回。
|
|
161
|
+
|
|
162
|
+
补装失败曾复现为 `'node' 不是内部或外部命令`:面板服务由 DSH 内置 Node 启动,那个目录只有 `node.exe`、没有 npm,而旧实现用 `npm.cmd + shell` 依赖 PATH。现已改为 `service/perf-deps.cjs` 统一处理:
|
|
163
|
+
|
|
164
|
+
- 组件已自带就**直接短路**,绝不重复安装;
|
|
165
|
+
- 真需要装时,用当前 Node 的绝对路径直调 `npm-cli.js`,并把 node 目录注入子进程 PATH,不经 shell / `.cmd`;
|
|
166
|
+
- 带 `error` 监听、150 秒超时、可读中文原因与手动命令,绝不抛未捕获异常拖垮面板服务;
|
|
167
|
+
- 面板输出区带状态与「收起输出」,失败时给出可复制的手动命令。
|
|
168
|
+
|
|
169
|
+
## 验证记录(2026-11-13)
|
|
170
|
+
|
|
171
|
+
- 全量语法检查:`npm run check`,24 个 `.mjs` / `.cjs` / `.js` 全部通过。
|
|
172
|
+
- `node smoke.mjs`:**67/67 通过**(新增:绩效表版式自动识别、写入只改目标格且不动结构、不覆盖其它行、未完成取本周周日、结构识别接口参数校验、设置页可指定模板、面板可检测结构、版本号取自 package.json、CMD 安装脚本纯 ASCII)。
|
|
173
|
+
- 面板在线自检:宿主心跳 ≤20s 拉起,访问 `http://127.0.0.1:8798/api/ping` 返回 JSON(面板 v1.3.1)。
|
|
174
|
+
- 前端静态校验:JS 引用的 91 个 DOM id 全部存在。
|
|
175
|
+
- **打开目录实测**:修前 `explorer.exe` 进程被拉起但窗口隐藏(带窗口的 explorer 数量不变);修后同一路径 1 → 2,确认窗口可见。不存在的路径返回 `ok:false` + 原因。
|
|
176
|
+
- **周报时间实测**:真实数据生成本周(2026-11-09 ~ 11-15)周报 18 条,逐条解析结束日期,**越界 0 条**;未完成事项从 `11月9日-30日` 变为 `11月9日-15日`。
|
|
177
|
+
- **绩效表实测**:11 月表识别为「表头第 6 行、明细 7~37 行、B/D/J/K/L/M、被考评人 D3、考评时间 D4、填报时间 K3」;就地写入只改动 **2 个单元格**(两条未完成事项 11/30 → 11/15),结构指纹前后一致(64 行 / 186 个合并区 / 区块 38·45·53 未移动),备份落在 `.perf-backup/`。
|
|
178
|
+
- 真实数据修复:`周报_2026-11-09_2026-11-15.txt` 第 13 条补全为「演示环境」,条目数 19 → 18(两半合并),其余 5 份历史周报**未被重写**;复检 0 处待修。
|
|
179
|
+
- 补装链路实测:返回 `ok:true / mode:bundled`,服务保持在线;组件已随包自带,无需联网。
|
|
180
|
+
- 分发包为纯 npm 包(不含任何本地安装脚本),从 registry 安装即标准流程,无额外校验脚本需要运行。
|
|
181
|
+
- **接管验证**:手动杀掉面板服务后,DSH 宿主心跳在 12 秒内拉起新面板(v1.1.0),确认免重启链路成立。
|
|
182
|
+
- 引擎 `--where` 路径解析正常;`renderReport` 输出与历史周报样例逐字一致(含「重要说明:无」缺省与全半角冒号);`--perf-template-check` 成功识别 11 张月度考核表。
|
|
183
|
+
- 本机实际数据被正确识别:已有 API Key、处理人、输出目录、7 份历史周报、11 张绩效表。
|
|
184
|
+
|
|
185
|
+
## 安全与回滚
|
|
186
|
+
|
|
187
|
+
- 服务只监听 `127.0.0.1`;周报读取限制在输出目录内,静态资源防目录穿越。
|
|
188
|
+
- 配置 / Key 写前自动备份,损坏文件另存 `.corrupt` 不静默覆盖。
|
|
189
|
+
- 从 DSH 插件页卸载,或 `pnpm remove dsh-weekly-report-lau`,恢复原依赖与 bundle 清单;`<data>` 数据完整保留。
|
|
190
|
+
- 所有被改动的文件都有时间戳备份,集中在 `<data>/backups/`(原链接、旧 server.cjs)与 DSH profile 目录(`*.bak-*`)。
|
|
191
|
+
- 索引/配置可能包含个人信息,**不要把 `<data>` 目录打包分享**。
|
package/lib/index.js
CHANGED
|
@@ -107,7 +107,7 @@ async function ensureService() {
|
|
|
107
107
|
/**
|
|
108
108
|
* 自举绩效表组件:完整包自带 node_modules 时是零成本的同步判断;
|
|
109
109
|
* 精简包(例如从 DSH 插件页安装)才在后台异步补装,不阻塞 DSH 启动。
|
|
110
|
-
* 这样无论用
|
|
110
|
+
* 这样无论用 pnpm 安装还是插件页直装,能力都一致。
|
|
111
111
|
*/
|
|
112
112
|
let bootstrapped = false
|
|
113
113
|
function bootstrapPerfDeps() {
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-weekly-report-lau",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.3.1",
|
|
4
4
|
"type": "module",
|
|
5
|
-
"description": "周报工作台 · 装上即用的 DSH
|
|
5
|
+
"description": "周报工作台 · 装上即用的 DSH 完整插件:即装即用、自动常驻、面板零手工启动,按使用者提供的 API Key 与路径模板生成周报与绩效表。",
|
|
6
6
|
"main": "./lib/index.js",
|
|
7
7
|
"exports": {
|
|
8
8
|
".": "./lib/index.js",
|
|
@@ -20,17 +20,12 @@
|
|
|
20
20
|
"locale",
|
|
21
21
|
"icon.svg",
|
|
22
22
|
"cordis.patch.yml",
|
|
23
|
-
"install.mjs",
|
|
24
23
|
"smoke.mjs",
|
|
25
24
|
"plugin.json",
|
|
26
25
|
"README.md",
|
|
27
|
-
"操作使用手册.html"
|
|
28
|
-
"一键安装.vbs",
|
|
29
|
-
"一键安装.cmd",
|
|
30
|
-
"一键安装.command",
|
|
31
|
-
"install.sh"
|
|
26
|
+
"操作使用手册.html"
|
|
32
27
|
],
|
|
33
|
-
"comment:distribution": "完整分发包请保留 node_modules/(内含 exceljs
|
|
28
|
+
"comment:distribution": "完整分发包请保留 node_modules/(内含 exceljs,绩效表功能零网络可用);精简包可在设置页自动补装。",
|
|
34
29
|
"dsh": {
|
|
35
30
|
"bundle": {
|
|
36
31
|
"patch": "./cordis.patch.yml"
|
|
@@ -45,13 +40,10 @@
|
|
|
45
40
|
"@deepseek-ai/cordis": "~4.0.5"
|
|
46
41
|
},
|
|
47
42
|
"scripts": {
|
|
48
|
-
"setup": "node install.mjs",
|
|
49
|
-
"verify": "node install.mjs --verify",
|
|
50
|
-
"uninstall": "node install.mjs --uninstall",
|
|
51
43
|
"smoke": "node smoke.mjs",
|
|
52
44
|
"repair": "node service/engine/repair-report.mjs",
|
|
53
45
|
"serve": "node service/server.cjs",
|
|
54
|
-
"check": "node --check service/server.cjs && node --check service/paths.cjs && node --check service/perf-deps.cjs && node --check service/engine/repair-report.mjs && node --check service/engine/lib/perf.mjs && node --check service/engine/lib/perf-map.mjs && node --check service/engine/gen-weekly.mjs && node --check
|
|
46
|
+
"check": "node --check service/server.cjs && node --check service/paths.cjs && node --check service/perf-deps.cjs && node --check service/engine/repair-report.mjs && node --check service/engine/lib/perf.mjs && node --check service/engine/lib/perf-map.mjs && node --check service/engine/gen-weekly.mjs && node --check smoke.mjs && node --check lib/index.js && node --check service/public/app.js"
|
|
55
47
|
},
|
|
56
48
|
"engines": {
|
|
57
49
|
"node": ">=20",
|