概览
dsh-insight-dock
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
都是实测出来的,不是猜的。 1. **界面文案目前只有中文。** 每个面向用户的字符串(`说来听听`、`关闭并告诉 agent 为什么`、设置项标签)以及每条工具描述都是中文字面量。没有接 locale 绑定,所以英文 locale 的会话看到的也全是中文。 2. **每一种结束都删除,没有归档。** 不存在「已归档」那一行,也没有它背后的记录。过期尤其不可逆:调短存活时间会直接销毁见解,**再调长也救不回来**。 3. **重启会清空这个坞。** 见解存在内存里,所以活不过 `dsh` 重启,fork 出来的会话也不继承。默认 5 分钟存活时间下这一点看不见;只有当你把存活时间调得很长、**并且**在见解还开着的时候重启,才会撞上。 把见解改成日志驻留——用 `session.append` 写一个只进日志、不面向界面的状态事件,再 `sessionProjections.register`——就能做到 fork 继承与 checkpoint。但那需要用 TypeScript 模块增强去注册事件类型,这是手写 `lib/*.js` 的包做不到的。**这是刻意不付的债**:存活时间以时间为基础时,持久化买不到多少东西。 4. **设置是持久化的**(`~/.dsh/insight-settings.json`),**这是有意的**——存活时间和上限如果每次重启都重置,那这个功能就没法用。它是 side-car,而不是注册进 `ctx.settings` 的命名空间。 5. **设置导航里的图标是 shell 的兜底齿轮。** `settings.section` 的注册只投影 `id`、`order`、`label` 三个字段;图标来自一张内置 id 的封闭表(`models` / `agent-presets` / `plugins`,其余一律齿轮),插件无法提供。 6. **图标会降级。** 坞向 `@deepseek-ai/dsh-client-ui-primitives` 要 `IconLightOutline16`、`IconChevronLeftOutline14`、`IconChevronRightOutline14`,如果这个 require 失败就退回手绘的 16px 内联 SVG。所以缺少 baseline 条目只是外观损失,不会让面板挂掉。
