工具集 yiiilin/dsh-plugins

@yiln-dsh/dsh-plugins

一个 DSH Web 插件包，内含八个内部功能模块。这个工作区就是项目根目录；依赖、版本、构建、测试和发布都在这里管理，不在各个功能目录里。

当前版本：0.1.2（已作为 public 发布到 npm）。已验证目标：DSH 0.2.0-rc.2。

功能

| 模块 | Loader row ID | 用途 |
| Auth Webserver | webserver-auth | 带认证的局域网网关，TOTP/Passkeys，PWA，移动端布局和配置编辑器。 |
| Delete Session | dsh-delete-session | 带确认的单条/批量删除，级联删除子代理，并保护持久化路径。 |
| Git Graph | dsh-git-graph | 右侧栏显示 Git 历史、工作区改动和文件 diff。 |
| Mentor | dsh-mentor | 隔离的无工具咨询，每会话串行队列，可持久重放，全局设置。 |
| Session List Cache | session-list-cache | 合并并缓存并发的会话枚举。 |
| Web Daemon | web-daemon | Systemd 管理、服务器指标和中断会话恢复。 |
| Session Mode | session-mode | 每会话的 normal / delegate-writes 权限：受限主智能体拿到裁剪过的工具目录外加执行守卫，并配独立的系统提示词。 |
| Work Journal | dsh-work-journal | 按日/周/月生成本 harness 的用途报告，从持久会话存储投影而来：一个 work_journal 工具、一条 /journal 命令，以及右侧栏面板。 |

安装后由单个 bundle 拥有这些模块。它们各自的 Cordis row 保留独立的 Config schema 和现有设置命名空间。Auth 会话、Passkeys、Mentor 日志、恢复记录、HTTP 路由和 Git 标签页标识都沿用原来的名称和位置。

安装

安装已发布的包：

dsh plugin --profile web add @yiln-dsh/dsh-plugins@0.1.2

或者安装当前工作区构建：

npm install
npm run build
dsh plugin --profile web add file:/path/to/dsh-plugin

源码改动后，刷新本地 file: 安装。Host 改动要重启 daemon，Client 改动要刷新浏览器；不要以为运行中的进程会自动加载复制过来的文件。

file: 目录依赖从 lockfile 解析，所以即使包里新增了文件，pnpm 也可能报 Already up to date，什么都不投影。重新添加前先删掉已投影的包，否则新模块不会出现在组合后的配置档里：

rm -rf "$DSH_HOME/profiles/web/node_modules/@yiln-dsh/dsh-plugins"
dsh plugin --profile web add file:/path/to/dsh-plugin

重启前先确认组合后的树里带有该 row：

dsh --profile web --dump-config | grep -c session-mode

从六个包迁移

不要把这套套件和六个旧 bundle 同时启用：它们的 row ID、路由和注册会重叠。先备份 Web 配置档和插件状态，从独立进程停掉 worker，移除旧的六个包，安装套件，并迁移用户补丁里显式写死的旧 name 覆盖项。保留所有 Config 值、行 ID 和状态目录。重启并刷新 GUI。

迁移辅助脚本默认是 dry-run，通过显式模式切换：

node scripts/migrate-profile.mjs --check /absolute/profile/cordis.patch.yml
node scripts/migrate-profile.mjs --write /absolute/profile/cordis.patch.yml

它只改动已知的 Loader 模块地址，保留注释和 !!js，绝不求值表达式，并校验其他配置值保持不变。它不会卸载或安装包，也不会删除持久化状态。

会话模式

用 composer 工具栏里权限控件右侧的开关，或者 /agent-mode on 和 /agent-mode off。打开委托写入后，主智能体变为只读，由 worker 执行编辑和命令执行：未经审计的工具会从主智能体面向模型的目录中移除，即使仍有调用进来，单调守卫也会拒绝。Agent Teams 协调工具对负责协调的主智能体保持可用。开关标签和两个状态词都通过 Client locale 字典本地化。两种模式各有独立的 normalPrompt 和 delegateWritesPrompt Config 字段。选择在重启后保留；worker 的权限和提示词使用创建时捕获的模式。
配置和边界见 Session Mode。

工作日志

直接问 harness 你做过什么，不用提前准备任何东西。日志读取的就是对话回放所用的同一批会话日志，所以它覆盖安装之前的历史，也不会和实际发生的事对不上。

- 在对话里：问「我昨天做了什么」/「总结一下这周」，智能体会调用 work_journal。
- 不用模型：/journal week、/journal 2026-09-13、/journal status、/journal rebuild。
- 在 GUI 里：右侧 Sidebar 的「工作日志」标签页，带范围切换、项目筛选和复制 Markdown 操作。

重启后的第一次查询会构建整个索引；之后的遍历只读变化的部分。如果报告无法从整个存储构建，它会明说，而不是悄悄少算。报告统计你自己的提示词、工具调用、写入的文件、运行的命令、每日活跃窗口和按项目汇总。投影规则、增量索引和配置见 Work Journal。

开发

npm run build
npm run check
npm test
DSH_EDITOR_QA_URL=http://isolated-test-host:3095/ npm run test:editor
DSH_MODE_QA_URL=http://127.0.0.1:<isolated-port>/ npm run test:modes:browser
npm pack

浏览器测试使用 Auth 模块里的合成 fixture，并拒绝生产端口。不要把会改数据的测试流程指向生产环境。

目录结构

- package.json：唯一的插件包清单和版本。
- cordis.patch.yml：根发现锚点和八行功能声明。
- index.js：空操作的 Host 发现锚点。
- src/<feature>/：内部 Host/Client 实现和功能测试。
- src/features.js：用于组合与迁移检查的规范标识。
- client.js：生成的单一 Client 入口；请改功能源码，不要改这里。
- scripts/：客户端生成、校验和配置档迁移。
- test/：根包契约和迁移契约。
- docs/：功能说明、兼容性调研和验证证据。
- skills/：仓库技能素材，不是第二个插件包。

文档驱动开发源码 用一套小而统一的文档布局，保存人类可读的领域/模块契约。它的模块示例 展示了公开入口、状态归属和限定范围的文档维护。运行 node skills/doc-driven-development/scripts/check.mjs 可执行该技能的隔离包回归测试；这些素材不会被插件构建安装或发布，现有项目文档也不会自动迁移。

发布

提升根版本号，同时更新本 README 和兼容性说明。运行构建、语法检查、测试，再做一次打包安装冒烟测试。只在收到请求时才提交和推送；只在明确要求发布后，才用 npm publish --access public 发布。内部模块没有独立版本号。