航海日志 xh0915/dsh-voyage-log

开发

pnpm install
pnpm run typecheck
pnpm test
pnpm run build

- src/shared/ —— 纯函数：解析事件、统计、脱敏、生成报告。不依赖 Harness，可以单独测试。
- src/client/ —— 浏览器端：标签页、时间线、排行榜、导出。
- src/index.ts —— 服务端入口：注册标签页，接上 sessionQuery。

测试覆盖解析、统计、脱敏、导出这几块。

协议

MIT
技术细节（要改代码的人点这里）

目录

package.json # dsh.bundle.patch + dsh.client、脚本、peer 依赖 cordis.patch.yml # 把宿主插件行挂进 profile dsh.plugin.json # 注册表清单 src/index.ts # 宿主入口：Config、Remote 服务、Typert 清单 src/runtime.ts # voyage.build(sessionId)：读日志、整理、返回 src/fold.ts # 整理引擎：原始事件 -> 轮次、行、汇总 src/redact.ts # 本地脱敏 src/schema.ts # Zod 线上契约（类型由此推导，不会漂移） src/contract.ts # 宿主与客户端共享的严格 InvocationDescriptor src/typert.ts # 宿主反射清单 src/client/index.tsx # 客户端入口：挂 Remote、注册标签页 src/client/view.tsx # 航海日志视图 src/client/report.ts # Markdown 摘要 + 自包含 HTML 报告 src/client/styles.ts # 主题令牌样式表（跟随 Harness 明暗） src/client/locales.ts # 中文 / 英文文案 tests/ # 整理、脱敏、接口、报告单元测试 build.mjs # esbuild 双构建：宿主 ESM + 客户端 CJS

客户端半边不贡献任何 prompt、工具或会话事件——ctx.typert.register() 只发布反射元数据。这个插件只是在你自己数据上加的一层界面。

开发

pnpm run check # 类型检查 + lint + 测试 + 构建

改名

fork 后要改名的话，这些地方必须同步：package.json → name、exports、files；build.mjs → __ModuleLoader__.load 的 id；src/index.ts → name；src/client/remote.ts → 十六进制编码的 TypertRemoteNamespace$…；src/client/locales.ts → locale 命名空间；src/client/index.tsx → slot id；src/typert.ts → package；src/contract.ts → invocation id；cordis.patch.yml → id 与 name；dsh.plugin.json → id。

许可证

MIT

作者：里卡多 / xh0915