dsh-milieu

让工作区成为新的单位。

把协议装进工作区，让ai正确管理工作区（协议具体介绍参见最下方）。 预加载会话，让用户永远能直接使用到精读过工作区的ai 会话重读机制，让用户知道ai是否需要重读工作区。

它解决什么问题

• 新会话从零开始：本插件提供预加载会话功能，用户打开工作区时，永远维护一个精读过工作区的预加载会话
• 认知会过期：本插件提供会话重读机制，工作区修改达到一定阈值时，会话会提醒重读。
• ai工作区杂乱无章：插件提供情景协议，规范ai的工作区。协议核心定义为“环境=信息+工具”，信息分为认知库+外部库，让ai关注真正重要的东西且能参考外部信息；工具库规范ai工作流程，让ai不再自我限制、不再过度自信。

它做什么

1. 把协议装进工作区

装好之后，每次会话开场它会做四件事：

1. 补全三个库（review/ tools/ external/）：缺就建目录，只建目录，不铺内容；
2. 把协议写进工作区：AGENTS.md 里只加一个托管段（<!-- dsh-milieu:begin … --> … <!-- dsh-milieu:end -->），段外一字不动；同时写 .dsh-milieu/ 三份文件（定义 / 建议 / 原因）；
3. 生成状态文件：扫一遍工作区，记下"变了什么"（事件流），客户端据此判断该不该提醒重读；
4. 注入一页状态（review/STATE.md）：上半是 agent 写的判断，下半是机器扫出的材料（变更账 / 三个库 / 最近改动 / 受管会话）。首装没有这一页时，先建一个只带判断段标记的骨架。

为什么写文件，而不是注入提示词？ 因为用户可能自己建会话——那条会话不归我们管，注入不进去；但它同样需要知道协议。 写进工作区文件，任何读这个工作区的 AI 都看得见。 同一份定义只此一处，避免"两个版本"。

2. 预加载会话，维护"会话的认知"

• 预加载会话：打开 preloadSession 后，工作区没有一条"已经读过"的会话就建一条，并让它真读一次；空白会话会补读；被人用过的旧会话转成 active，再建一条干净的。
• 该重读时提醒：界面按五关判断——这条会话归不归我们管 → 弹过没有 → 工作区变没变 → 变化够不够大 → 距会话最后活动够不够久。都过了才弹「这个工作区变了，要不要重读」。
• 重读带变更摘要：点"重读"发出去的请求里带变更视图——30 天内用过的会话给"文件名 + 旧→新大小变化"；超过 30 天只给文件名（认知库最多 20 条）和其它库的两个索引文件。
• 只提示，不自动重发。改代码、跑脚本都不会被它打断。

preloadSession 默认关闭：它会真跑一次 agent（花 token、动会话列表）。要用再在配置里打开。

30 秒看懂它怎么跑

安装 → 打开工作区
  ├─ 会话开场：补三库 → 写协议 → 生成状态文件 → 注入状态页
  ├─ 切进会话：读状态文件 → 五关判据 → （工作区变了就）弹卡片
  └─ 点「重读」：发一条带变更摘要的请求 → 那条会话的 AI 重新认识工作区

安装

从 npm（推荐）

dsh plugin --profile desktop add dsh-milieu

web 版把 desktop 换成 web。也可以在 DSH 里：插件管理器 → 安装 → 填 dsh-milieu。

从 GitHub

github:sxwpskd/dsh-milieu

想钉版本：在仓库的 commit 页面复制 SHA，写成 github:sxwpskd/dsh-milieu#<sha>。

装完完全退出 DSH，再打开。需要 DSH 0.2.x（含 0.2.1 预发布）；本包零依赖。

装好后的建议

让ai读一下插件，调整对应配置，整理工作区。 预加载会话、重读机制都有阈值配置，一般需要更改配置才能启动。

它会写你工作区的什么

只碰这四处：

• AGENTS.md：只维护托管段（<!-- dsh-milieu:begin … --> 到 <!-- dsh-milieu:end --> 之间）；段外一个字不动；
• .dsh-milieu/：协议三份（DEFINITION / SUGGESTIONS / RATIONALE）+ preload.json 诊断；
• 三个库目录（review/ tools/ external/）：缺就建目录，不铺内容；
• 认知库里的 STATE.md：缺就建状态页骨架；只重写 <!-- judgement --> 以下的材料段。

卸载插件不会撤销这些文件：协议是写给工作区的，不是插件的私有数据；插件走了，工作区仍按协议运转。要撤销就手动删托管段、.dsh-milieu/ 或库目录。

配置

默认值只有一处：顶层在 index.js 的 DEFAULT_CONFIG，阈值在 criteria.js；补丁层 cordis.patch.yml 只写覆盖。 宿主把生效的 criteria 写进 milieu-state.json，客户端读同一份。

边界与已知限制

• preloadSession 默认关：会真跑一次 agent，要自己打开。
• 预加载受认知库门槛限制：新建预加载前要求认知库 ≥ 10 文件 / ≥ 10 KB（readiness）。全新工作区会被拦住——这是有意的，避免在"还没建立认知"的地方乱建会话。
• 多工作区还没验：空 workspaceRoot 时，只有一个工作区就直接用，多个时用平台顺序里的第一个；"每个工作区各管各的"还没做。
• 没有持久日志（第二期）：出问题先看 .dsh-milieu/preload.json 和界面上的调试行（criteria.debug）。
• 卸载不清理：见上一节。
• 失败只报告，不兜底：写不进去、服务取不到，日志里说清原因，不会假装成功，也不会把宿主拖崩。
• 不做定期整理：只做协议、状态、预加载、重读提示这四件事。

开发计划，开发须知

协议、状态页、预加载会话、重读提示都已经跑通。接下来补的是：

• 日志：出问题时能看到插件做了什么，而不是靠猜。
• 设置界面：不用改配置文件，在界面里调开关和阈值。
• 多工作区：每个工作区各管各的，而不是只认一个。

workspaceRegistry.resolveByPath(root)                  // ① 工作区 id（list() 按路径兜底）
sessionController.inspect(sessionId)                   // ② 已有？看有没有第二条 user/message
//    空白 → prompt 补读；已用过 → 转 active，再建新的；只读过一次 → 认领
sessionController.create({ workspaceId, sessionId })   // ③ 建/认领：只有传 id 才会 attach
workspaceRegistry.unarchiveSession(sessionId)          // ④ 从归档集合拿回来
sessionController.prompt({ sessionId, content })       // ⑤ 真读一次（平台补消息 id/来源）

协议：为什么跨会话需要它

这个插件落的是一个小协议：环境 = 信息 + 工具。

• 信息回答"有什么"：工作区里有什么、哪些是我的认知、哪些是外部材料；
• 工具回答"我能对它做什么"：能力要落成工具，不能现场拼命令；

为什么跨会话需要它？ DSH 的每个会话都是一个"没有记忆"的 AI。没有协议时，每个会话都会重新发明一套"这个工作区怎么管"；命名、目录、哪些能改，每次都不一样。把协议写进工作区文件（AGENTS.md 托管段 + .dsh-milieu/），任何读这个工作区的 AI 都看得见，包括你自己建的、插件不注入的会话。认知才会累积，而不是每次归零。

完整定义见 DEFINITION.md；建议层 / 原因层见 SUGGESTIONS.md / RATIONALE.md。

不装插件也可以用这套协议。 如果你在写别的插件或工作流，欢迎直接采用；觉得哪里不对，欢迎来改——协议是活的约定，不是刻在石头上的。

联系

• 邮箱：3292950454@qq.com
• Issue：github.com/sxwpskd/dsh-milieu/issues（优先；问题公开，别人也能搜到答案）

License

MIT。见 LICENSE。