dsh-structured 0.9.6 → 0.9.9

package/docs/1.0-BASELINE.md

@@ -0,0 +1,38 @@
+# 1.0 基线（0.9.8 冻结版）
+
+## 固定 10 条 prompt
+
+1. P01：给一个 5 人团队做本周发布计划。
+2. P02：解释一个 Redis 连接池泄露的排查顺序。
+3. P03：比较 Postgres 与 SQLite 的适用边界。
+4. P04：把一份长会议记录压缩成决策、风险和下一步。
+5. P05：给一个前端页面做无障碍检查清单。
+6. P06：写一个可回滚的数据库迁移方案。
+7. P07：分析一段 Python 异步代码的死锁风险。
+8. P08：给一个 API 设计写三组验收用例。
+9. P09：用表格比较三种缓存策略。
+10. P10：对一个失败发布做 5-Why 复盘。
+
+## 注入口径（0.9.8）
+
+当前 `BUILTIN_STYLE_TEXT` 940 字符；GenUI 路由 186 字符；尾部提醒 206 字符。合计 1332 字符，约 333 token（按 4 字符/token 估算；不是宿主 tokenizer 实测）。10 条 prompt 共用同一注入段，per-turn 注入增量以宿主实际 tokenizer 为准。
+
+## 输出与结构化率
+
+- 首屏结构化率、散文率：沿用 `docs/METRICS.md` 的 12 个新会话样本（注入 12/12，散文 0/12）；这是 0.9.x 既有样本，不是本轮 10 条固定 prompt 的新跑结果。
+- 输出 token 增量：**未测**；本轮没有调用模型执行 10 条固定 prompt，不能用旧样本冒充。
+- 3×2 桌面实机截图：**未验**；0.9.6 的视觉截图是 web profile 裁图，0.9.8 没有安装到 desktop。
+
+## `style.md` 1.0 迁移语义（冻结）
+
+- `style.md`：非空即整份覆盖内置 `BUILTIN_STYLE_TEXT`；不做片段合并。
+- 需要保留结构规则时，把 `BUILTIN_STYLE_TEXT` 全文复制到 `style.md`，再追加自己的文本。
+- 1.0 的 `persona.md` 只作为**追加层**设计，不改变 `style.md` 的整份覆盖语义；结构规则始终注入，见 `docs/1.0-PERSONA-SPEC.md`。
+- 读取失败、文件为空、权限错误均 fail-open：回退内置规则，不阻断回复。
+- 迁移路径：现有 `style.md` 用户不需要改文件；若 1.0 要同时使用结构规则和人格，按 1.0 spec 使用 `persona.md` 追加，而不是把人格塞进 `style.md`。
+
+## 待验
+
+- 10 条固定 prompt 的实际注入/输出 token。
+- 10 条固定 prompt 的首屏结构化率与散文率。
+- 3×2 桌面实机截图与 800px 实机窄窗。

package/docs/1.0-GATE.md

@@ -0,0 +1,39 @@
+# 1.0 人格 gate（0.9.9，PM 主导）
+
+## 目的
+
+决定 1.0 是否开放 persona 追加层；不评价人格文案好坏，只评价结构保留、token 增量、偏好和 P0。
+
+## 受试与分组
+
+- 5–10 名真实用户；PM 招募/主持，开发只提供夹具与测量。
+- 每组同一批任务，三组顺序随机：
+  1. **无 persona**：仅结构规则。
+  2. **style.md 覆盖**：用户自己的整份 style.md（保留现有语义）。
+  3. **persona.md 追加**：结构规则 + persona 追加层。
+
+## 固定任务
+
+使用 `docs/1.0-BASELINE.md` 的 P01–P10；每人至少完成 5 条，覆盖报告、代码/ diff、比较、风险/下一步。
+
+## 测量
+
+- 结构保留：首屏标题卡/表格/列表/结论等结构不下降；用现有 `scripts/measure-prose.mjs` + 人工抽查。
+- token 增量：同一任务三组的注入 token 与实际输出 token；必须给出数字，不用“差不多”。
+- 偏好：受试者在三组中选最愿意继续用的一组；目标 **≥60% 偏好 persona 追加层**。
+- P0：任何阻断回复、覆盖结构规则、泄露个人信息、改变工具权限/GenUI/代码隔离的案例即 P0。
+
+## 通过条件
+
+1. 结构保留不下降；
+2. token 增量有数字且可接受（PM 定阈值）；
+3. ≥60% 偏好追加层；
+4. 无 P0。
+
+任何一项不满足：1.0 不开人格功能，回到 spec/文档方案。0.9.x 不开放用户入口。
+
+## 当前状态
+
+- 夹具：`test/fixtures/persona-gate/` 三组。
+- 用户 gate：**未执行**（0 名用户）；0.9.9 只能交付“待 gate”，不能伪造 go。
+- 结论：**NO-GO / pending**，直到 PM 提供 5–10 名用户结果。

package/docs/1.0-PERSONA-SPEC.md

@@ -0,0 +1,59 @@
+# 1.0 人格化 spec / schema（0.9.9 草案，不实现）
+
+## 定位
+
+1.0 的人格是 **profile 级追加层**，不是替换层：
+
+1. 结构规则：始终由 base 注入。base 默认是 `BUILTIN_STYLE_TEXT`；`style.md` 非空时按现有契约整份覆盖 base（显式例外，用户自己承担丢失结构规则）。
+2. `persona.md`：只追加在 base 之后，不能删除、替换结构规则，不能修改 host 提示词或消息内容。
+3. 不碰 `AGENTS.md`、`soul`、工具权限、GenUI 路由和代码/diff 隔离。
+
+## 路径与读取顺序
+
+- profile 级路径：`$DSH_PROFILE_DIR/dsh-structured/persona.md`；缺省 profile 目录时按宿主 profile 解析，不读其他 profile。
+- 读取顺序：base（内置或 `style.md` 整份覆盖）→ `persona.md` 追加层。
+- 两个文件都存在时，`style.md` 仍只控制 base；`persona.md` 不参与 base 覆盖。
+- 读取失败、权限错误、文件缺失、schema 不合法：忽略 persona，继续 base，fail-open，不阻断回复。
+
+## Schema
+
+`persona.md` 是 UTF-8 Markdown，可选 frontmatter：
+
+```yaml
+---
+schema: dsh-structured/persona@1
+scope: profile
+append: true
+recommended_max_chars: 4000
+---
+# 称呼与语气
+...
+```
+
+- `schema` 必须精确匹配 `dsh-structured/persona@1`；不匹配时忽略并记录一次非阻断警告。
+- `append` 只能为 `true`；`false` 不提供“替换结构”的入口。
+- `recommended_max_chars` 只是建议；**不硬截断**。超过建议值时在设置页显示提示，不改变实际内容。
+- 正文只作为文本 section 追加；不插值 `{{...}}`，不执行命令，不解析 Markdown 到 DOM。
+
+## 优先级与迁移
+
+1. 结构规则：`BUILTIN_STYLE_TEXT`（默认）或 `style.md`（整份覆盖）。
+2. `persona.md`：追加层，不能覆盖 1。
+3. 其他 profile/全局文件：不参与。
+
+迁移：
+
+- 现有 `style.md` 用户不需要改文件；0.9.x 不读 `persona.md`，行为不变。
+- 1.0 想保留结构规则并加人格：保留/复制 `BUILTIN_STYLE_TEXT` 到 `style.md`，把人格写进 `persona.md`；或保持 `style.md` 为空，使用内置结构 + persona 追加。
+- 不建议把人格塞进 `style.md`，否则会整份覆盖结构规则。
+
+## 隐私与安全
+
+- persona 可能包含个人信息；只保存在本机 profile，不进入 npm 包、不写日志、不上传、不进市场。
+- 文档和设置页必须提示“persona 可能含个人信息，分享 profile 前先清理”。
+- persona 不能包含工具调用、系统指令覆盖、凭据或外部 URL 执行语义；仅作为文本追加。
+
+## 0.9.9 不实现
+
+- 不加设置页入口、不新增命令、不做人格市场/编辑器/预设包、不读 `persona.md` 运行时。
+- 只提供本 spec、三组 gate 夹具和测量口径；1.0 是否上线由 gate 决定。

package/lib/client.js

@@ -1,5 +1,5 @@
-// Generated from src/client.js by scripts/build.mjs — edit src/, then run `npm run build`.
-// dsh-structured client module: renders "结论：" blockquotes as cards.
+// Generated from src/client.js by scripts/build.mjs — edit src/, then run `npm run build`.
+// dsh-structured client module: renders "结论：" blockquotes as cards.
 /**
  * dsh-structured client
  *
@@ -131,12 +131,12 @@ body[data-ds-dark-theme][data-dsh-structured-theme="codex"] [class*="_markdown_"
 }
 body[data-dsh-structured-theme="anthropic"] [class*="_markdown_"]{
   --ds-surface:#FAF9F5;--ds-surface-2:#F5F1E8;--ds-text:#141413;--ds-muted:#6B6359;
-  --ds-border:#E5E0D5;--ds-accent:#CC785C;--ds-accent-text:#A14A2E;--ds-success:#266B4D;--ds-warn:#92400E;--ds-error:#8C1D18;
+  --ds-border:#E5E0D5;--ds-accent:#CC785C;--ds-accent-text:#A14A2E;--ds-success:#266B4D;--ds-warn:#806000;--ds-error:#8C1D18;
   --ds-code-bg:#F5F1E8;--ds-code-text:#141413;
 }
 body[data-ds-dark-theme][data-dsh-structured-theme="anthropic"] [class*="_markdown_"]{
   --ds-surface:#1F1E1D;--ds-surface-2:#2A2825;--ds-text:#F5F1E8;--ds-muted:#A8A29A;
-  --ds-border:#3A3733;--ds-accent:#E8A087;--ds-accent-text:#E8A087;--ds-success:#6FBF9A;--ds-warn:#E0A458;--ds-error:#F28B82;
+  --ds-border:#3A3733;--ds-accent:#E8A087;--ds-accent-text:#E8A087;--ds-success:#6FBF9A;--ds-warn:#EAB308;--ds-error:#F28B82;
   --ds-code-bg:#171614;--ds-code-text:#F5F1E8;
 }
 [class*="_markdown_"] p{margin:.72em 0}