# worklog-workbench **Repository Path**: cy4ever/worklog-workbench ## Basic Information - **Project Name**: worklog-workbench - **Description**: 本地 Electron 工具 V0.3.11：采用通透玻璃界面维护代码修改记录。支持 TAPD 编号/关键词/链接录入、行内和批量状态操作、场景筛选、自定义目录与同步盘多台电脑编辑。 工作空间目录窗口可查看、导出内置 Worklog Skill；详情可初始化并关联具体任务目录。Skill 与 App 共用同一台账，唯一规则真源在个人 Skill 仓库。详见 V0.3.11。 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-09-06 - **Last Updated**: 2026-09-09 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 工作空间 · 研发台账 本地 Electron 工具 V0.3.18：采用通透玻璃界面维护代码修改记录。支持 TAPD 编号/关键词/链接录入、行内和批量状态操作、场景筛选、自定义目录与同步盘多台电脑编辑。 工作空间目录窗口可查看、导出内置 Worklog Skill；详情可初始化并关联具体任务目录。Skill 与 App 共用同一台账，唯一规则真源在个人 Skill 仓库。详见 [V0.3.11](docs/v0.3.11-worklog.md)。 ## 配套 Worklog Skill 源码根目录的 [skill/worklog](skill/worklog) 是随工作台交付的完整 Skill，入口为 [SKILL.md](skill/worklog/SKILL.md)。其中 `scripts/` 存放执行脚本，`references/` 存放使用约定，`bundle.json` 记录版本及文件 SHA-256。 维护真源仍是 `C:/workspace/self/personal-agent-skills/skills/global/worklog`；本仓库的 `skill/worklog` 是分发副本，不独立修改规则。维护者在真源完成修改并按个人配置流程发布后，执行 `npm run prepare-skill` 更新本目录。`npm start` 和 `npm run pack` 也会先从相邻的 `personal-agent-skills` 仓库同步，因此这些命令要求真源目录可访问。 发布包会把本目录内置到 `resources/worklog`。用户可通过 App 的“工作空间目录 → 内置 Worklog Skill”导出到客户端的 Skill 目录，也可复制整个 `skill/worklog` 目录进行安装；不要覆盖已有受管安装。使用时需要 Python，先启动一次 App 生成本机连接配置，再让 AI 使用 `$worklog` 查询或登记台账。Skill 与 App 共用台账及工作目录关联，认证和运行数据不放入 Skill。 仅使用本仓库已经内置的副本构建时，运行 `npx electron-builder --win dir`；输出在 `dist/win-unpacked`，无需再次读取个人真源。它与 `npm run pack` 的区别是不会执行同步 Skill 的前置步骤。 ## 日常使用 - 双击桌面“工作空间”。列表直接调整一个工作状态，支持批量修改；快捷保存成功不弹提示。点击标题打开详情，左侧返回、Esc 或点击遮罩关闭，未保存草稿会提醒。 - 左侧按开发中、待提测、测试中、待上线、已上线、已合并排列；也可保存当前筛选。点击预设会清除当前关键词、状态、仓库和日期条件；点击已保存的自定义筛选会恢复其完整条件。Ctrl+K 搜索，Ctrl+N 新增，Ctrl+S 保存草稿。 - Ctrl+加号/减号调整界面缩放，Ctrl+0 恢复 100%；缩放比例在本机保存。详情材料逐项显示，本地文档旁的“打开所在目录”可在资源管理器中定位文件；展开的材料区在后台刷新时保持展开。 - 详情按说明、仓库和备注紧凑展示。点击对应铅笔独立修改、保存或取消；上线分支可直接点击修改。状态使用分组菜单，支持方向键和 Esc。关联与材料设置保留在详情折叠区。 - 新增时输入 TAPD 短编号、完整编号、标题关键词或详情链接，选择候选带入身份和标题，保留已写摘要。查询不修改 TAPD；本地开发状态与 TAPD 原状态分别保存。 - 在完成代码任务时告诉 AI：`使用 $worklog，把这次几个问题分别登记到修改记录工作台，保留各仓库修改和实际验证结果。` - 查询时说：`使用 $worklog，找出编号 1005529 的修改记录。` 更新时明确具体事项；相同短编号可能有不同记录。 - “设置与备份”配置本机工作数据目录、同步盘目录、容量及 TAPD。切换资料目录会先复制并校验，保留原目录，重启后界面和 Skill 都读取新位置。已有库须明确选择，未完成迁移不会被当成可用库。 - Excel 导出遵循当前筛选；导入重复来源或已有记录 ID 会跳过，不覆盖现有编辑。浏览表适合阅读与分享；重新导入采用工作簿中的完整记录页，浏览表的手工改动不会自动回写数据库。 仓库管理可维护中文名、服务名及 PC/后端/小程序类型；详情一键复制“服务名＋上线分支”或问题概要，缺失上线分支时先补齐。 TAPD 默认仅填 Access Token；项目编号和 Basic 认证收进高级设置。列表编号可直接打开 TAPD。启动后分批自动刷新，详情可手动刷新；手工标题和备注受保护。认证权限或令牌过期会在详情显示实际错误。 原文件 `E:\work\workLog\代码修改记录.xlsx` 只读导入。历史原字段保留；“已合并”原样显示为最终合并阶段；其他阶段按登记内容显示，不再重复呈现待核实。导入日期是资料创建日期，不冒充实际代码修改日期。 ## 位置 | 内容 | 位置 | |---|---| | 应用源码 | `C:\workspace\self\worklog-workbench` | | 本机桌面程序 | `E:\work\.agentic\runtime\worklog-workbench\app-v0.3.18`，桌面快捷方式指向此版本 | | 首次数据位置 | `E:\work\.agentic\runtime\worklog-workbench\data\worklog.sqlite`，以设置或 CLI info 为准 | | 设备私有配置 | `%APPDATA%\worklog-workbench`，不放同步盘 | | 数据备份 | 当前资料目录的 `backups`，最多 3 份受管备份 | | 随源码交付的 Skill | [`skill/worklog`](skill/worklog) | | Skill 维护真源 | `C:\workspace\self\personal-agent-skills\skills\global\worklog` | 备份恢复：先退出工作台并停止向它写入的 CLI；把整个数据目录另行保留，再将选定备份复制成新数据目录的 `worklog.sqlite`，使用 `WORKLOG_DATA_DIR` 指向新目录启动并核对。不直接覆盖正在运行的数据库或只复制正在使用的 WAL 主文件。 ## 开发与验证 要求 Node.js 24+；当前交付验证 Windows x64。 ```powershell npm ci npm start npm test npm run test:desktop npm run pack ``` CLI 不要求桌面程序正在运行： ```powershell node src/cli.cjs list --q 1005529 node src/cli.cjs save --input E:\work\.agentic\runtime\worklog-workbench\requests\request.json node src/cli.cjs backup ``` 请求使用 UTF-8 JSON 文件，字段见 [接口约定](docs/contract.md)。写入带唯一操作 ID，更新同时核对版本，冲突时保留草稿。当前版本只交付 Windows 桌面；云服务器、密码本、iPhone/Android 客户端尚未实现。 ## 同步盘使用 每台电脑使用各自的本机资料目录，在“多端同步”中选择同一个网盘同步目录。不要让多台电脑直接打开同一份 SQLite。第二台电脑首次从空库同步即可取得记录，无需再次导入 Excel。 同步目录只有 `worklog-sync-v1`：每设备一个 `current.json` 和最多 3 份备份；附件按内容哈希去重。相同内容不重写快照。默认总空间上限 256 MiB（可调整），按本机可见文件和原子替换峰值核算；超额停止发布，本地修改保留。网盘自身历史版本及尚未传到本机的其他设备文件不受本程序直接控制。 窗口启动、恢复焦点及每 60 秒接收同步；有编辑草稿、弹窗或正在操作时跳过，手动“同步”可立即检查。保存后会尝试发布，失败单独提示。Skill 的 `save` 同样支持保存后同步，`sync` 可独立重试。不同事项自动合入，同一事项并发修改保留双方，在“同步冲突”中选择；不按设备时间覆盖。 历史每条记录保留最近 20 次，本机备份最多 3 份。幂等请求响应有 256 MiB 上限，达到后拒绝新写操作并保留重放能力；本期不做无限日志归档。附件每个最多 20 MiB，添加后即占空间；不自动删除未引用附件或他设备文件。 TAPD API 账户/口令或访问令牌只在本机系统安全存储中加密保存，另一台电脑需自行配置；不会进入快照。原始 SQL/报告等大文件仍建议使用已有归档路径，需要跨设备携带时再添加附件。 仓库字典同步使用 V2 快照，参与编辑的电脑请全部升级 V0.3+。应用“工作空间”为暂用名称；当前应用切换器只有已实现的研发台账。 V0.3.1：详情编号点击复制，旁边独立图标打开TAPD。研发流程为开发中→待提测→测试中→待上线→已上线→已合并；“最近更新”为辅助视图。修复列表滚动背景溢出及表头多选框被挤压。 V0.3.3：状态、仓库支持搜索多选，同组按或匹配；状态有阶段颜色。SQL、配置变更在详情主区域分别编辑，支持未填写、无、有及补充说明。 V0.3.4：宽屏使用可交互左右分栏，左侧切换记录、修改状态会更新右侧；1250px及以下采用模态抽屉。标题15px，正文13px。SQL/配置开关在详情外侧直接保存，说明按需编辑，快捷修改直接保存。 V0.3.5：删除撤销入口和快捷保存成功提示；SQL/配置开关原位更新，保留详情滚动与展开状态。 V0.3.6：列表标题下显示SQL/配置变更标识，区分有、无和未填写；详情开关保存后原位更新对应标签。 V0.3.7：列表统一按创建时间倒序，同时间按ID倒序；编辑旧记录不会改变其创建时间排序位置。 V0.3.8：左下角 TAPD 入口、设置和详情可查看请求记录，支持仅失败筛选与手动重试。每次重试新增记录，原失败保留；本机保留最近 200 次操作，每次最多 50 个接口结果，不进入同步盘。升级前只存在内存中的失败无法补回。 已保存的 TAPD 认证显示固定掩码；点击输入新令牌替换，留空保留。保存容量等其他设置不改变凭据。 左侧“工作空间”维护名称与本地目录，详情铅笔手动关联，“打开目录”在文件管理器中打开。名称固定作为关联标识，可修改路径或移除本机映射；不删除目录和台账。每机最多 20 个工作空间，名称最多 50 字。工作空间名称随台账同步、导出，目录路径只存本机；其他电脑配置同名工作空间即可使用不同路径。参与同步的电脑应升级到 V0.3.8 或以上，旧版本不认识新增字段。工作空间目录与应用资料目录是独立设置。 V0.3.9：历史TAPD同步使用原表需求/缺陷类型区分同号事项。工作空间是WorkLog根目录，每条台账关联具体任务子目录；Skill通过link-directory传入目录，详情打开任务目录。联动规则与验证见 docs/v0.3.9-skill-link.md。 V0.3.11：挂起的台账停止TAPD自动同步和自动重试，不计入待重试数量；保留手动同步及历史请求。 ## 最近修改记录 | 版本 | 修改内容 | |---|---| | V0.3.18 | 修复自定义筛选切换到预设后列表为空：点击预设清除残留的关键词、状态、仓库和日期条件，并同步重置控件；再次点击自定义筛选恢复原条件。 | | V0.3.17 | 移除任务“待合并”阶段，流程为“已上线 → 已合并”，已合并作为终态并停止自动 TAPD 同步。历史待合并兼容显示为已上线，旧筛选兼容映射；保留手动纠错及独立的仓库合并标记。 | | V0.3.16 | 内置 Worklog Skill 并封装 Windows 免安装包和独立 Skill 包；源码副本统一放在 `skill/worklog`，同步打包入口与哈希校验，保留个人仓库单一真源。 | | V0.3.15 | 本地材料增加“打开所在目录”：文件在资源管理器中定位，目录直接打开，网页保持原打开方式。 | | V0.3.14 | 材料链接分行显示；后台刷新保留详情折叠区展开状态和滚动位置。支持 Ctrl+加号/减号缩放、Ctrl+0 复位并记住本机比例，窗口适配较小屏幕。 | | V0.3.13 | 仓库局部编辑支持“移除此仓库”，可移除最后一个关联；不删除仓库字典和磁盘目录，并保留并发修改保护。 | | V0.3.12 | 修复仓库待合并标记导致待上线任务混入待合并列表的问题，当时改为按任务阶段筛选；该任务阶段在 V0.3.17 移除。 | V0.3.16 的压缩包是该版本的独立交付物，不会随源码更新自动变为 V0.3.18。本机已更新至 V0.3.18；需要分发新版本时应重新打包。