@pi-claudian/auto-save-to-markdown 0.3.1 → 0.3.3

package/README.md

@@ -78,14 +78,14 @@ session_file: "~/.pi/agent/sessions/--Users-me-project-20260829-050500_ab12.json
 
 # Fix login redirect loop
 
-User · 13:05:12
+User <span style="font-size: 0.5em; color: var(--text-faint);">2026-08-29 13:05:12</span>
 ===
 
 The login page redirects in a loop after the auth refactor...
 
 ---
 
-Assistant · 13:05:40 · claude-sonnet-4-5
+Assistant <span style="font-size: 0.5em; color: var(--text-faint);">2026-08-29 13:05:40 · claude-sonnet-4-5</span>
 ===
 
 > [!tldr]- Thinking
@@ -113,12 +113,15 @@ previews are wrapped in inline code spans (with a delimiter sized to survive
 backticks inside the content), so raw tool output renders literally instead of
 being parsed as markdown.
 
-Each message block opens with a setext level-1 info header (`User · …`,
-underlined with `===`) — one level above the `##` headings AI content
-typically starts with, and distinguishable from content `#` headings when
-parsing — and ends with a `---` separator wrapped in single blank lines
-(extra blank lines are trimmed), so blocks are easy to tell apart both when
-reading and when splitting the file programmatically.
+Each message block opens with a setext level-1 info header (`User`,
+`Assistant`) underlined with `===` — one level above the `##` headings AI
+content typically starts with, and distinguishable from content `#` headings
+when parsing. The header's metadata (local date-time, and the model for
+assistant messages) sits in a small faint `<span>` (`0.5em`, Obsidian's
+`--text-faint` color), so the role stays visually dominant while the details
+remain a glance away. Each block ends with a `---` separator wrapped in single
+blank lines (extra blank lines are trimmed), so blocks are easy to tell apart
+both when reading and when splitting the file programmatically.
 
 ### Fragmented thinking repair
 
@@ -165,6 +168,10 @@ always contains the complete conversation, not the compacted context.
 PI_CLAUDIAN_DEBUG=1 pi
 ```
 
+Any value other than an explicit false token (empty, `0`, `false`, `no`, `off` —
+case-insensitive) enables it; unset the variable (or set one of those tokens)
+to turn it off.
+
 ## License
 
 MIT

package/README.zh.md

@@ -68,14 +68,14 @@ session_file: "~/.pi/agent/sessions/--Users-me-project-20260829-050500_ab12.json
 
 # 修复登录重定向死循环
 
-User · 13:05:12
+User <span style="font-size: 0.5em; color: var(--text-faint);">2026-08-29 13:05:12</span>
 ===
 
 auth 重构之后登录页一直重定向死循环……
 
 ---
 
-Assistant · 13:05:40 · claude-sonnet-4-5
+Assistant <span style="font-size: 0.5em; color: var(--text-faint);">2026-08-29 13:05:40 · claude-sonnet-4-5</span>
 ===
 
 > [!tldr]- Thinking
@@ -101,10 +101,12 @@ Obsidian 对 HTML 块内嵌 Markdown 的渲染不可靠；在非 Obsidian 环境
 压过内容中的反引号序列），工具的原始输出因此按字面渲染，不会被当作
 Markdown 解析。
 
-每个消息块以 setext 一级信息头（`User · …`，下一行以 `===` 下划）开头——
-高于 AI 内容常见的 `##` 二级标题，解析时也能与内容中的 `#` 一级标题区分
-开——并以"上下各一个空行"包裹的 `---` 分隔线结尾（多余空行会被裁剪），
-无论是阅读还是程序化切分，都能清楚地区分每个消息块。
+每个消息块以 setext 一级信息头（`User`、`Assistant`，下一行以 `===` 下划）
+开头——高于 AI 内容常见的 `##` 二级标题，解析时也能与内容中的 `#` 一级标题
+区分开。信息头的元数据（本地日期时间，assistant 消息还带模型名）放在一个小号
+浅色 `<span>` 中（`0.5em`，Obsidian 的 `--text-faint` 颜色），角色名因此保持
+醒目，细节又触手可及。每个消息块以"上下各一个空行"包裹的 `---` 分隔线结尾
+（多余空行会被裁剪），无论是阅读还是程序化切分，都能清楚地区分每个消息块。
 
 ### 碎片化 thinking 修复
 
@@ -144,6 +146,9 @@ markdown 文件只记录**一个分支**——即该分支看到的 root→leaf
 PI_CLAUDIAN_DEBUG=1 pi
 ```
 
+除显式假值（空串、`0`、`false`、`no`、`off`，忽略大小写）以外的任何值都会开启
+调试；取消该变量或将其设为其中某个假值即可关闭。
+
 ## 许可
 
 MIT

package/debug.ts

@@ -1,9 +1,10 @@
 /**
  * Shared debug logging for all @pi-claudian extensions.
  *
- * Enable by setting the PI_CLAUDIAN_DEBUG environment variable to any truthy
- * value (e.g. "1"). Output goes to stderr via console.error, so it never mixes
- * with pi's stdout and can be captured separately:
+ * Enable by setting the PI_CLAUDIAN_DEBUG environment variable to any value
+ * other than an explicit false token (empty, "0", "false", "no", "off" —
+ * case-insensitive). Output goes to stderr via console.error, so it never
+ * mixes with pi's stdout and can be captured separately:
  *
  *   PI_CLAUDIAN_DEBUG=1 pi            # show inline
  *   PI_CLAUDIAN_DEBUG=1 pi 2>debug.log  # capture to a file
@@ -15,9 +16,11 @@
  */
 
 const TAG = "[pi-claudian]";
-const enabled = Boolean(process.env.PI_CLAUDIAN_DEBUG);
+const FALSE_TOKENS = new Set(["", "0", "false", "no", "off"]);
+const raw = process.env.PI_CLAUDIAN_DEBUG?.trim().toLowerCase();
+const enabled = raw !== undefined && !FALSE_TOKENS.has(raw);
 
-/** Log a debug message when PI_CLAUDIAN_DEBUG is set. */
+/** Log a debug message when PI_CLAUDIAN_DEBUG is set to an enabling value. */
 export function debug(...args: unknown[]): void {
   if (!enabled) return;
   console.error(TAG, ...args);

package/index.ts

@@ -21,9 +21,12 @@
  *   cumulative cost and tokens (input, output, cache read/write), message
  *   count, created/updated timestamps, project root and session file.
  * - Body format: every message block opens with a setext-H1 info header
- *   (`User · HH:MM:SS` / `Assistant · HH:MM:SS · model`, underlined with
- *   `===`, distinct from the `#`/`##` ATX headings AI content uses) and
- *   ends with a `---` separator wrapped in single blank lines.
+ *   (`User <span …>YYYY-MM-DD HH:MM:SS</span>` /
+ *   `Assistant <span …>YYYY-MM-DD HH:MM:SS · model</span>`, where the span
+ *   renders the metadata as small faint text — Obsidian CSS variables, so it
+ *   degrades gracefully elsewhere — underlined with `===`, distinct from the
+ *   `#`/`##` ATX headings AI content uses) and ends with a `---` separator
+ *   wrapped in single blank lines.
  * - Tool call/result folding: calls live in the assistant entry while their
  *   results are separate toolResult entries; saves pair them by toolCall id
  *   and fold each assistant block's calls, with a short result preview each,
@@ -224,10 +227,28 @@ export default function (pi: ExtensionAPI) {
     );
   }
 
-  /** Local-time clock label for a message entry: HH:MM:SS. */
-  function clock(iso: string): string {
+  /** Local-time label for a message entry: YYYY-MM-DD HH:MM:SS. */
+  function dateTime(iso: string): string {
     const d = new Date(iso);
-    return `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+    return (
+      `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}` +
+      ` ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`
+    );
+  }
+
+  /**
+   * Wrap header metadata (timestamp, model) in a small faint span: 0.5em text
+   * in Obsidian's `--text-faint` color, so the role stays visually dominant.
+   * HTML-escaped because the model string lands inside a raw HTML span.
+   */
+  function metaSpan(text: string): string {
+    const safe = text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+    return `<span style="font-size: 0.5em; color: var(--text-faint);">${safe}</span>`;
+  }
+
+  /** Setext-H1 info header: `Role <span …>meta</span>` underlined with `===`. */
+  function messageHeader(role: string, meta: string): string {
+    return `${role} ${metaSpan(meta)}\n===`;
   }
 
   /** Make a string safe for use as a filename component. */
@@ -387,7 +408,7 @@ export default function (pi: ExtensionAPI) {
     // precedes the text it produced, instead of being grouped after the fact.
     // Setext H1 (`===` underline): one level above the `##` headings AI
     // content typically starts with, and distinct from content `#` headings.
-    const header = `Assistant · ${t}${m.model ? ` · ${m.model}` : ""}\n===`;
+    const header = messageHeader("Assistant", [t, m.model].filter(Boolean).join(" · "));
     const parts: string[] = [];
     const thinkings: string[] = [];
     const flushThinking = () => {
@@ -436,9 +457,9 @@ export default function (pi: ExtensionAPI) {
     const blocks: string[] = [];
     for (const e of entries) {
       const m = e.message;
-      const t = clock(e.timestamp);
+      const t = dateTime(e.timestamp);
       if (m.role === "user") {
-        blocks.push(`User · ${t}\n===\n\n${userText(m.content)}`);
+        blocks.push(`${messageHeader("User", t)}\n\n${userText(m.content)}`);
       } else if (m.role === "assistant") {
         blocks.push(renderAssistant(m, t, results));
       } else if (m.role === "toolResult") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-claudian/auto-save-to-markdown",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Pi extension that automatically saves each completed conversation turn as a markdown file with YAML frontmatter, one file per session-tree branch.",
   "type": "module",
   "license": "MIT",