位置与小项
- 类型重复:
PreparedRuntimeCoreAttempt 三份(runtime-core/prepare-attempt.ts:13 导出版、runner/lume-runner.ts:59、runtime-core/mock-attempt.ts:20 手抄);RunRuntimeCoreAttemptOptions 两份(attempt.ts:60、lume-runner.ts:77)——字段靠手工同步,建议统一 import 导出版
- 命名特例:
src/services/agent/subagents/subagent-run.types.ts(全 src 唯一点分 *.types.ts,应为 subagent-run-types.ts);src/services/agent-runtime/interruption/interruption-index.ts(唯一 *-index.ts 伪 barrel,且与同目录 interruption.ts 极易混淆;全仓不使用目录 barrel)
src/types/undici.d.ts:declare module 只声明 4 个类骨架,遮蔽 undici@7.25.0 自带的完整 types;唯一使用点 proxy-settings-manager.ts:201-217 动态 import 后紧跟内联 as 断言,不消费该声明——净效果是把包完整类型替换成骨架,建议删除(对照 qrcode.d.ts 因包无 types 而必要,保留)
src/index.ts(494 行)四块职责:browser RPC HMAC 通道(:71-104+:182-202,自洽子系统,建议拆 rpc/browser-main-transport.ts)、desktop settings 持久化 writer(:108-123)、RPC 分发与慢调用日志(:171-324)、boot/shutdown(:326-489);:459 shutdown 用 require("./services/routine/routine-runner") 而 :388 启动同一模块用 await import——ESM 内 require 依赖 bun 兼容行为,风格不一致且换 runtime 易踩坑
- 原子写样板同构重复 ≥6 处(memory-v2/markdown-store、reading-store、suggest/store、background-extractor 手写 tmp+rename、job-service、lume-config writeYamlAtomic、wiki/markdown-store),细节漂移(有的 rename 失败不清 tmp)——值得抽 infra 原子写工具统一语义
说明
均为低危一致性/可维护性项,可在触碰对应文件时顺手处理,不单独排期。
位置与小项
PreparedRuntimeCoreAttempt三份(runtime-core/prepare-attempt.ts:13 导出版、runner/lume-runner.ts:59、runtime-core/mock-attempt.ts:20 手抄);RunRuntimeCoreAttemptOptions两份(attempt.ts:60、lume-runner.ts:77)——字段靠手工同步,建议统一 import 导出版src/services/agent/subagents/subagent-run.types.ts(全 src 唯一点分 *.types.ts,应为 subagent-run-types.ts);src/services/agent-runtime/interruption/interruption-index.ts(唯一 *-index.ts 伪 barrel,且与同目录 interruption.ts 极易混淆;全仓不使用目录 barrel)src/types/undici.d.ts:declare module 只声明 4 个类骨架,遮蔽 undici@7.25.0 自带的完整 types;唯一使用点 proxy-settings-manager.ts:201-217 动态 import 后紧跟内联 as 断言,不消费该声明——净效果是把包完整类型替换成骨架,建议删除(对照 qrcode.d.ts 因包无 types 而必要,保留)src/index.ts(494 行)四块职责:browser RPC HMAC 通道(:71-104+:182-202,自洽子系统,建议拆 rpc/browser-main-transport.ts)、desktop settings 持久化 writer(:108-123)、RPC 分发与慢调用日志(:171-324)、boot/shutdown(:326-489);:459 shutdown 用 require("./services/routine/routine-runner") 而 :388 启动同一模块用 await import——ESM 内 require 依赖 bun 兼容行为,风格不一致且换 runtime 易踩坑说明
均为低危一致性/可维护性项,可在触碰对应文件时顺手处理,不单独排期。