pi-anchor 0.5.0 → 0.5.1

package/README.md

@@ -1,12 +1,12 @@
 # ⌖ Anchor
 
-> **A digital sticky note docked below your Pi editor — with four clever touches.**  
-> Stick a note in 0ms (`pin: ...`), see it persistently below your editor (`belowEditor`, zero collision with `aboveEditor` extensions), track long tasks with micro progress bars `[■■□□ 2/4]`, jump straight back to the original conversation session (`↪`), and auto-tear off on `git commit`.
+> **A digital sticky note docked below your Pi editor — 0ms instant stick, micro progress bars `[■■□□ 2/4]`, 1-click session teleport (`↪`), and automatic teardown on `git commit`.**
 
 [![CI Status](https://github.com/3ZEROS12/anchor/actions/workflows/ci.yml/badge.svg)](https://github.com/3ZEROS12/anchor/actions/workflows/ci.yml)
 [![Node v20+](https://img.shields.io/badge/Node-v20+-22c55e.svg)](package.json)
 [![TypeScript Strict](https://img.shields.io/badge/TypeScript-Strict-3b82f6.svg)](tsconfig.json)
 [![Tests: 10 Passed](https://img.shields.io/badge/Tests-10%20Passed-22c55e.svg)](tests/store.test.ts)
+[![Startup: < 45ms](https://img.shields.io/badge/Startup-%3C%2045ms-success.svg)](package.json)
 [![License: MIT](https://img.shields.io/badge/License-MIT-f97316.svg)](LICENSE)
 
 **English** | [简体中文](./README_zh.md)
@@ -16,58 +16,104 @@ pi install npm:pi-anchor
 ```
 
 <p align="center">
-  <img src="assets/hero-en.svg" alt="Anchor Sticky Notes" width="820">
+  <img src="assets/hero-en.svg" alt="Anchor Below-Editor Sticky Strip" width="820">
 </p>
 
 ```text
-╭─ Pi Editor ──────────────────────────────────────────────────────────────────────╮
+  ┌─ [aboveEditor stays 100% free for pi-lingual and other HUD widgets] ────────────┐
+╭─┴─ Pi Editor ────────────────────────────────────────────────────────────────────╮
 │ ❯ pin: Refactor auth flow: 1. Extract interface 2. HttpOnly cookie 3. Unit tests │
-╰──────────────────────────────────────────────────────────────────────────────────╯
-  ⌖ #1 [■■□□ 2/4] Refactor auth flow ▸ Unit tests (app · auth.ts ↪)
+╰─┬────────────────────────────────────────────────────────────────────────────────╯
+  └─► ⌖ #1 [■■□□ 2/4] Refactor auth flow ▸ Unit tests (app · auth.ts ↪)
 ```
 
 ---
 
-## Why Anchor?
+## Core Value
 
-When you're deep in a coding session and think *"Wait — I need to check the rate-limit fallback in `src/gateway.ts` after this"*, or when you pause a multi-day task for the night:
-- Writing a `TODO.md` inside your repo pollutes `git status` and burns prompt tokens on every turn.
-- Normal startup banners vanish the second you send a message, so you forget what you wrote.
+Late at night, mid-way through fixing a bug, you spot a second issue in `src/auth.ts` or need to pause a multi-step refactor until tomorrow. Standard ways of recording that note create immediate friction:
 
-**Anchor is a real sticky note stuck right under your Pi input box (`belowEditor`)** — stored outside your repo in `~/.anchor/state.json` (4 source files, 0 dependencies), designed for **human hands first**:
+1. **Terminal Exit Wipes Working Memory**: Closing the terminal or running `/new` clears the agent's context. Yesterday's unfinished steps and the conversation history behind them vanish.
+2. **`TODO.md` Pollutes Git & Burns Context Tokens**: Tracking personal reminders inside repository markdown files dirties `git status` and re-injects stale checklists into the system prompt on every turn.
+3. **Splash Banners Vanish When You Start Typing**: Traditional startup widgets disappear on the first message. For the rest of a two-hour session, your notes are hidden unless you manually run a slash command.
 
-### 1. Docked Below Your Editor & 0ms Instant Stick (`pin: ...`)
-- **Zero Widget Collision**: Anchor docks its 1-line strip **below** your editor (`placement: "belowEditor"`), leaving the space above your editor (`aboveEditor`) 100% free for tools like `pi-lingual`.
-- **0ms Human Input**: Type `pin: Check token expiry` (or `note: ...`, `便签: ...`, `/pin ...`) directly in the editor. Anchor intercepts it in **0.00ms** without triggering an LLM call or burning tokens, and automatically links the file you were just editing.
+**Anchor acts like a physical sticky note stuck to the bottom bezel of your Pi editor**:
+- **Persistent Below-Editor Strip (`belowEditor`)**: Docks a single-line note strip directly beneath your input box. It stays in view while you code, leaves `aboveEditor` untouched for extensions like `pi-lingual`, and collapses to 0 lines when empty.
+- **0ms Human-First Capture (`pin: ...`)**: Type `pin: Check token expiry` (or `/pin ...`) straight into the editor. An input hook intercepts the text in `0.00ms` without calling the language model or spending tokens.
+- **Micro Progress Bar (`[■■□□ 2/4]`)**: Write `[2/4]` or numbered steps (`1. Extract interface 2. HttpOnly cookie 3. Unit tests`) in your note to get an inline 4-cell progress bar with next-step hints.
+- **Session Teleport (`↪ Jump to session`)**: Every note bookmarks the exact `.jsonl` session file where it was created or last touched. Select `↪ Jump to session` in `/anchor` to switch Pi straight back to that conversation.
 
-### 2. Micro Progress Bar for Long Tasks (`[■■□□ 2/4]`)
-- Write a ratio (`[2/4]` or `5/30`) or numbered steps (`1. Extract interface 2. HttpOnly cookie 3. Unit tests`) in your note:
-  ```text
-  /pin Refactor auth flow: 1. Extract interface 2. HttpOnly cookie 3. Unit tests
-  ```
-- Anchor renders a crisp micro progress bar (`[■■□□ 2/3] ▸ Unit tests`) right on the sticky strip. Run `/step 1` (or select `▶ Advance step` in `/anchor`) to tick it forward. Simple one-off notes stay 100% bar-free.
+---
+
+## How It Works
+
+| Mode / Action | What You Input | What the Engine Does | What You See | Best For |
+| :--- | :--- | :--- | :--- | :--- |
+| **Stick a Note (0ms)** | Type `pin: Fix auth in src/auth.ts` or `/pin ...` | Intercepts via input hook in `0ms`, extracts file paths, and links current `sessionFile` | 1-line strip appears below editor: `⌖ #1 Fix auth (app · auth.ts ↪)` | Capturing a tangent without derailing the current prompt |
+| **Track Multi-Step Work** | Type `/pin Refactor: 1. API 2. Cookie 3. Tests` then `/step 1` | Parses step list and increments `done / total` counter in `~/.anchor/state.json` | Strip updates in place: `⌖ #1 [■■□□ 2/3] Refactor ▸ Tests` | Multi-session features and long-running study goals |
+| **Resume Context (`↪`)** | Run `/anchor` ➔ select `↪ Jump to session` (or `/anchor jump 1`) | Invokes Pi's native `ctx.switchSession(note.sessionFile)` | Terminal switches directly back to the original conversation transcript | Picking up a complex task days later with full history |
+| **Auto-Tear on Commit** | Commit code (`git commit -m "feat: fix auth"`) or run `/done 1` | Matches commit message against active notes (filtering generic stop-words) | Note archives to `archive.jsonl`; strip clears (`⌖ Auto-torn off #1`) | Keeping the sticky strip clean without manual bookkeeping |
+
+---
 
-### 3. Conversation Session Bookmark (`↪ Jump to session`)
-- Every sticky note automatically bookmarks the Pi conversation session (`sessionFile`) where it was created or last worked on.
-- Days later, open `/anchor` and pick **`↪ Jump to session`** (or run `/anchor jump 1`) to teleport Pi straight back into that exact conversation history.
+## Features & Engineering Answers
 
-### 4. File Whisper & Auto-Tear on `git commit`
-- **1-Line File Whisper (0 Idle Tokens)**: Briefs the AI once on Turn 1, then consumes **0 tokens** on Turn 2+. When the AI reads or edits a matching file, Anchor slips a 1-line comment (`// ⌖ Note #1: ...`) onto that file result (strictly skipping `.json` and `.env`).
-- **Auto-Tear on Commit**: When `git commit -m "..."` matches your note, Anchor tears the note off automatically (`⌖ Auto-torn off #1`). Run `/anchor undo` anytime to put it back.
+### 1. Will the sticky strip collide with `pi-lingual` or overflow narrow split panes?
+Anchor mounts its widget with `{ placement: "belowEditor" }`. Extensions that render translation cards or diagnostics above the input box (`aboveEditor`) never overlap with Anchor.  
+On narrow terminal splits (such as 50-column tmux panes), the strip measures visual column widths using Unicode East Asian Width rules (CJK/emoji = 2 cells, ASCII = 1 cell) and dynamically folds multiple notes into `⌖ 3: #1 [■■□□ 2/4] Refactor… +2` while stripping unclosed brackets before ellipses.
+
+### 2. Does keeping sticky notes cost tokens on every turn?
+**Turn 2+ consumes 0 system prompt tokens.**  
+Anchor injects a compact summary of active notes only on Turn 1 of a cold session. From Turn 2 onwards, the system prompt hook returns nothing. When the agent reads or edits a file that matches a note's path or glob (`src/auth/*.ts`), Anchor appends a single syntax-safe comment line (`// ⌖ Note #1: ...`) to that tool result, while returning `null` for `.json`, `.env`, lockfiles, and binaries.
+
+### 3. What happens to old notes or accidental `git commit` matches?
+- **7-Day Quiet Mode (Zero Silent Deletion)**: Notes untouched for more than 7 days transition to `sleeping` (`quiet`). They stop appearing in Turn-1 prompts for unrelated workspaces, remain 100% visible in `/anchor`, and wake up automatically when you open their target project.
+- **Stop-Word Filtered Commit Matching & 1-Tap Undo**: Commit matching strips generic words (`fix`, `feat`, `chore`, `bug`, `update`) so a commit like `fix: typo in bug template` never tears off a note titled `fix bug in login`. If you ever tear off a note by mistake, `/anchor undo` pops the last entry from `archive.jsonl` right back onto your strip.
+- **Bracketed Ratio Parsing**: Progress ratios require explicit brackets (`[2/4]` or `(5/30)`), ensuring calendar dates in note titles (like `Before 10/12 release`) are never mistaken for progress bars.
+
+### 4. Storage Topology & Cross-Process Lock Safety
+All state lives in `~/.anchor/` outside your git repository:
+```text
+~/.anchor/
+├── state.json      # Active and quiet sticky notes (< 2KB, atomic temp-file + rename)
+├── state.lock      # Cross-process exclusive lock (fs.openSync 'wx' + dead-PID reclamation)
+└── archive.jsonl   # Append-only history of torn-off notes (powers /anchor undo)
+```
 
 ---
 
 ## Commands
 
-| Where | Input / Command | What It Does |
+| Where | Input / Command | Description |
 | :--- | :--- | :--- |
 | **Pi Editor** | `pin: <note>` or `便签: <note>` | Stick a note in **0ms** without calling the LLM |
-| **Pi Slash** | `/pin <note>` | Stick a note (supports `[1/4]` or `1. A 2. B` steps) |
-| **Pi Slash** | `/anchor` | Open interactive board (tear off, `+1` step, or `↪` jump to session) |
+| **Pi Slash** | `/pin <note>` | Stick a note (supports `[1/4]` or `1. A 2. B 3. C` steps) |
+| **Pi Slash** | `/anchor` | Open interactive sticky note board (tear off, `+1` step, `↪` jump to session, or read details) |
 | **Pi Slash** | `/step 1` | Advance progress bar on note `#1` by `+1` |
 | **Pi Slash** | `/anchor jump 1` | Switch Pi back to the conversation session linked to note `#1` |
-| **Pi Slash** | `/done 1` / `/anchor undo` | Tear off note `#1`, or put back the last torn-off note |
-| **Terminal CLI** | `anchor` / `anchor step 1` / `anchor done 1` | View, step, or tear off notes outside Pi |
+| **Pi Slash** | `/done 1` / `/anchor 1` | Tear off note `#1` and archive it |
+| **Pi Slash** | `/anchor undo` | Put back the most recently torn-off note |
+| **Terminal CLI** | `anchor` / `anchor "<note>"` | View or stick notes from any shell outside Pi |
+| **Terminal CLI** | `anchor step 1` / `anchor done 1` / `anchor undo` | Advance progress, tear off, or restore notes from the command line |
+
+---
+
+## Author's Note
+
+Anchor started because I hated watching `TODO.md` files rot inside my git repositories, yet closing my terminal at night always meant losing track of what I still needed to fix the next morning.
+
+In its early versions, I over-engineered the solution. By `v0.3`, Anchor had grown into a 10-file miniature project manager with four cognitive quadrants (`Today`, `Upcoming`, `Habits`, `Backlog`), `[P0]` priority tags, daily recurring habit trackers, pre-flight shell test runners on startup, and a graveyard eviction state machine. Ironically, the more features it gained, the less I wanted to use it. Worse, its startup banner disappeared the moment I typed my first message, hiding my notes for the rest of the coding session.
+
+In `v0.4` and `v0.5`, I threw away 60% of the codebase and rebuilt Anchor around four files (`types.ts`, `store.ts`, `tui.ts`, `extension.ts`) as a simple digital sticky note:
+1. Dock the 1-line note strip **below** the editor (`belowEditor`) so it stays in sight while coding and never fights with `pi-lingual` above the editor.
+2. Let human hands stick a note in `0ms` by typing `pin: ...` without waiting on a model call.
+3. Add a 4-cell progress bar (`[■■□□ 2/4]`) for multi-step refactors and bookmark the session file (`↪`) so clicking a note teleports you back to the exact conversation where the work started.
+
+```bash
+npm run typecheck  # Strict tsc --noEmit check (0 errors)
+npm test           # Native Node test runner (10/10 passing)
+npm run build      # Dual ESM/CJS compilation via tsup + declaration emit
+```
 
 ---
 

package/README_zh.md

@@ -1,12 +1,12 @@
 # ⌖ Anchor
 
-> **贴在 Pi 输入框正下方的电子便签 —— 专为顺手盲打与跨会话续传设计。**  
-> 敲 `便签: ...` 0ms 瞬贴上屏，在输入框**正下方 (`belowEditor`)** 常驻 1 行极简便签条（与上方 `pi-lingual` 零冲突），支持长线任务**迷你进度条 `[■■□□ 2/4]`**、**一键穿越回当时的对话上下文 (`↪`)**，以及 **`git commit` 自动撕便签**。
+> **贴在 Pi 输入框正下方的电子便签 —— `便签: ...` 0ms 瞬贴上屏、长线任务迷你进度条 `[■■□□ 2/4]`、一键切回原对话上下文 (`↪`)，`git commit` 提交代码自动撕便签。**
 
 [![CI 状态](https://github.com/3ZEROS12/anchor/actions/workflows/ci.yml/badge.svg)](https://github.com/3ZEROS12/anchor/actions/workflows/ci.yml)
 [![Node v20+](https://img.shields.io/badge/Node-v20+-22c55e.svg)](package.json)
 [![TypeScript Strict](https://img.shields.io/badge/TypeScript-Strict-3b82f6.svg)](tsconfig.json)
 [![Tests: 10 Passed](https://img.shields.io/badge/Tests-10%20通过-22c55e.svg)](tests/store.test.ts)
+[![启动耗时: < 45ms](https://img.shields.io/badge/启动耗时-%3C%2045ms-success.svg)](package.json)
 [![开源协议: MIT](https://img.shields.io/badge/开源协议-MIT-f97316.svg)](LICENSE)
 
 [English](./README.md) | **简体中文**
@@ -16,56 +16,107 @@ pi install npm:pi-anchor
 ```
 
 <p align="center">
-  <img src="assets/hero-zh.svg" alt="Anchor 电子便签预览" width="820">
+  <img src="assets/hero-zh.svg" alt="Anchor 输入框下方常驻便签条预览" width="820">
 </p>
 
 ```text
-╭─ Pi 输入框 ──────────────────────────────────────────────────────────────────────╮
+  ┌─ [输入框上方 aboveEditor 完全留给 pi-lingual 等插件，上下零冲突] ─────────────┐
+╭─┴─ Pi 输入框 ────────────────────────────────────────────────────────────────────╮
 │ ❯ 便签: 重构登录鉴权流: 1. 抽出接口 2. 替换Cookie 3. 补单测 4. 压测              │
-╰──────────────────────────────────────────────────────────────────────────────────╯
-  ⌖ #1 [■■□□ 2/4] 重构登录鉴权流 ▸ 补单测 (app · auth.ts ↪)
+╰─┬────────────────────────────────────────────────────────────────────────────────╯
+  └─► ⌖ #1 [■■□□ 2/4] 重构登录鉴权流 ▸ 补单测 (app · auth.ts ↪)
 ```
 
 ---
 
-## 为什么这次真正顺手了？（四大巧思）
+## Core Value
 
-### 1. 输入框正下方常驻 1 行便签条 (`belowEditor`) + 0ms 瞬贴
-* **绝不跟上方插件抢地盘**：便签条挂载在输入框**正下方 (`belowEditor`)**，把输入框上方 (`aboveEditor`) 完全留给 `pi-lingual` 等高频伴学卡片，上下分工井然有序。
-* **真·便签常驻视野**：有便签时在输入框下沿安静显示 1 行，不再像以前那样“刚发第一句话就神秘消失”；无便签时 0 行完全隐形。
-* **自己随手写，0ms 上屏**：直接在输入框敲 `便签: 明天检查网关重试`（或 `pin: ...`、`/pin ...`），**0.00ms 当场拦截贴上便签条**，不用苦等大模型转圈调工具，不花 1 个 Token，还会自动关联你当前正在改的代码文件。
+深夜写代码查问题时，你经常顺眼看到另一个文件里的隐患，或者手头的长线重构今天只做了一半。传统的记录方式总有三处具体的别扭：
 
-### 2. 长线任务迷你进度条 (`[■■□□ 2/4]`)
-* 遇到跨天或分步任务，随手在便签里写上进度比（如 `[5/30]`）或分步序号（`1. 抽出接口 2. 替换Cookie 3. 补单测`）：
-  ```text
-  便签: 重构登录鉴权流: 1. 抽出接口 2. 替换Cookie 3. 补单测
-  ```
-* 便签条会自动渲染出 4 格迷你进度条与下一步提示：`[■■□□ 2/3] ▸ 补单测`。敲 `/step 1`（或在 `/anchor` 菜单里点 `▶ Advance step`）即可推进一格；普通单句备忘则保持纯粹文字，绝不画蛇添足。
+1. **关掉终端或开新会话即失忆**：按下 `Ctrl+C` 或敲 `/new` 开启新会话，昨晚改到哪一步、当时那场对话聊了什么上下文，瞬间断线。
+2. **`TODO.md` 弄脏 Git 且每轮白烧 Token**：在项目根目录维护待办文件，既制造杂乱的 Git 修改记录，又在每一轮对话里反复把旧清单塞进系统提示词。
+3. **开局闪现横幅一打字就消失**：普通插件只在打开终端时闪一下提示，你发完第一句话它就自我隐藏。接下来两个小时写代码，除非专门敲命令查询，否则根本看不见自己记了什么。
 
-### 3. 绑定原对话 Session，一键穿越回去 (`↪ Jump to session`)
-* 贴便签或修改关联代码时，Anchor 会自动记录当前对话的 `sessionFile` 书签（显示 `↪` 标记）。
-* 哪怕过了好几天、开了十几个新窗口，当你看到便签想接着干时，打开 `/anchor` 选中它点击 **`↪ Jump to session`**（或敲 `/anchor jump 1`），Pi 就会**直接切换回当时那场对话的完整上下文**！
+**Anchor 的定位很单纯：贴在 Pi 输入框下边框的一张电子便签**：
+- **输入框正下方常驻 1 行 (`belowEditor`)**：便签条固定在输入框下沿，写代码时抬眼可见；输入框上方空间完全留给 `pi-lingual` 等插件；没有便签时自动收起为 0 行。
+- **自己随手敲，0ms 瞬贴 (`便签: ...`)**：直接在输入框敲 `便签: 检查网关超时重试`（或 `pin: ...`、`/pin ...`），输入钩子在 `0.00ms` 内直接拦截上屏，不调用大模型、不耗费 1 个 Token，并自动关联当前刚修改过的代码文件。
+- **长线任务迷你进度条 (`[■■□□ 2/4]`)**：在便签里写 `[2/4]` 或分步序号 `1. 抽出接口 2. 替换Cookie 3. 补单测`，便签条自动显示 4 格进度条与下一步提示。
+- **原对话一键穿越 (`↪ Jump to session`)**：每张便签自动记录创建或施工时的会话文件路径（`sessionFile`）。在 `/anchor` 面板中点击 `↪ Jump to session`，直接切回当时那场对话。
 
-### 4. 碰文件顺手递纸条 & `git commit` 自动撕便签
-* **碰文件递纸条（平时 0 Token）**：首轮对话简要提醒，第 2 轮起 **0 Token**；当 AI 读取或修改关联文件时，在文件结果末尾顺手附带 1 行语法安全注释（`// ⌖ Note #1: ...`，严格跳过 `.json`/`.env`）。
-* **提交代码自动撕下**：执行 `git commit -m "..."` 命中便签内容时，当场自动撕下归档；撕错了敲 `/anchor undo` 一秒贴回。
+---
+
+## How It Works
+
+| 操作场景 | 你的输入 | 后台执行逻辑 | 界面即时反馈 | 适用时刻 |
+| :--- | :--- | :--- | :--- | :--- |
+| **0ms 随手贴便签** | 输入框敲 `便签: 把 src/auth.ts 改用 Cookie` | `input` 钩子 0ms 拦截，提取文件路径并记录当前 `sessionFile` | 输入框下方立即浮现：`⌖ #1 把 src/auth.ts 改用 Cookie (app · auth.ts ↪)` | 改代码中途冒出支线念头，不想打断当前对话 |
+| **分步推进长任务** | 敲 `/pin 重构: 1. 接口 2. Cookie 3. 单测` 后敲 `/step 1` | 解析分步列表并在 `~/.anchor/state.json` 推进完成步数 | 下方便签条实时变为：`⌖ #1 [■■□□ 2/3] 重构 ▸ 单测` | 跨天重构、分步排障或刷课程章节 |
+| **切回原对话 (`↪`)** | 敲 `/anchor` 选中便签点 `↪ Jump to session`（或 `/anchor jump 1`） | 调用 Pi 原生 `ctx.switchSession(note.sessionFile)` | 终端直接切回贴这张便签时的完整历史对话上下文 | 隔了几天回来继续施工，需要找回当时的讨论细节 |
+| **提交代码自动撕** | 执行 `git commit -m "feat: 登录改用 Cookie"` 或敲 `/done 1` | 过滤通用停用词后比对提交信息与便签关键词 | 便签自动归档至 `archive.jsonl`，下方便签条同步消失 | 写完代码顺手提交，免去手动打勾销账 |
 
 ---
 
-## 常用操作速查
+## Features & Engineering Answers
+
+### 1. 下方常驻便签条会和 `pi-lingual` 冲突，或者在窄分屏下撑爆换行吗？
+Anchor 显式指定 `{ placement: "belowEditor" }` 挂载在输入框下方，与挂载在输入框上方（`aboveEditor`）的 `pi-lingual` 物理隔离，上下各司其职。  
+面对 50 列宽度的窄分屏终端，排版函数按 Unicode 东亚字符宽度标准（中文/Emoji 计 2 列，ASCII 计 1 列）动态计算剩余预算：窄屏下自动折叠为 `⌖ 3: #1 [■■□□ 2/4] 重构登录… +2`，并在省略号截断前自动清理未闭合的左括号。
+
+### 2. 便签常驻显示，会不会每一轮对话都偷偷消耗上下文 Token？
+**第 2 轮起系统提示词消耗为 0 Token。**  
+界面上的便签条是纯本地终端 TUI 渲染组件。仅在会话第 1 轮冷启动时，Anchor 向系统提示词注入一次简短摘要；从第 2 轮起完全静默。只有当 AI 读取或编辑了便签关联的代码文件时，Anchor 才在该文件工具返回结果末尾追加 1 行对应语言的注释（`// ⌖ Note #1: ...`），遇到 `.json`、`.env`、锁文件与二进制文件则严格返回 `null` 跳过。
+
+### 3. 很久没碰的旧便签会丢吗？普通的 `git commit -m "fix bug"` 会不会误撕便签？
+- **7 天转静默，永不自动删数据**：超过 7 天未触碰的便签自动标记为 `quiet`（不在无关工程的首轮提示词里刷存在感），但在 `/anchor` 列表中始终保留，一旦进入对应工程目录即自动唤醒。
+- **停用词过滤与一键反悔**：Git 提交匹配会自动剔除 `fix`、`feat`、`bug`、`修复`、`优化` 等高频泛化词，杜绝无关提交误删便签。万一手动撕错了，敲 `/anchor undo` 即可从 `archive.jsonl` 原样贴回。
+- **进度比防误判守卫**：比例进度条严格要求带括号（如 `[2/4]` 或 `(5/30)`），日常写 `10/12 前发布接口` 等日期数字绝不会被误判为进度条。
+
+### 4. 全局存储拓扑与多窗口并发锁
+所有便签数据独立存放在用户主目录 `~/.anchor/`，项目仓库保持 100% 干净：
+```text
+~/.anchor/
+├── state.json      # 当前便签状态表 (< 2KB，临时文件写入 + 原子 rename)
+├── state.lock      # 跨进程排他文件锁 (fs.openSync 'wx' + 死进程 PID 自动回收)
+└── archive.jsonl   # 已撕下便签的追加式历史记录 (支撑 /anchor undo 秒级恢复)
+```
+
+---
 
-| 位置 | 输入 / 命令 | 作用 |
+## Commands
+
+| 位置 | 输入 / 命令 | 作用说明 |
 | :--- | :--- | :--- |
-| **输入框直接敲** | `便签: <内容>` 或 `pin: <内容>` | **0ms 直接贴便签**（不触发大模型请求，自动绑定当前改过的文件与 Session） |
-| **斜杠命令** | `/pin <内容>` | 贴一张新便签（支持写 `[2/5]` 或 `1. A 2. B` 自动生成进度条） |
-| **斜杠命令** | `/anchor` | 打开交互面板（支持撕便签、推进度 `+1`、`↪` 穿越回原对话 Session） |
-| **斜杠命令** | `/step 1` | 将 `#1` 便签的进度条往前推进 `+1` 步 |
-| **斜杠命令** | `/anchor jump 1` | 直接切换回 `#1` 便签绑定的那次历史对话 (`switchSession`) |
-| **斜杠命令** | `/done 1` / `/anchor undo` | 撕掉 `#1` 便签，或把刚撕掉的便签重新贴回来 |
-| **终端 CLI** | `anchor` / `anchor step 1` / `anchor done 1` | 不进 Pi 也能在外部终端查看、推进度或撕便签 |
+| **Pi 输入框直敲** | `便签: <内容>` 或 `pin: <内容>` | **0ms 直接贴便签**（不触发大模型请求，自动绑定当前改过的文件与 Session） |
+| **Pi 斜杠命令** | `/pin <内容>` | 贴一张新便签（支持写 `[1/4]` 或 `1. A 2. B 3. C` 自动生成进度条） |
+| **Pi 斜杠命令** | `/anchor` | 打开交互面板（回车可撕便签、推进度 `+1`、`↪` 切回原对话 Session、看详情） |
+| **Pi 斜杠命令** | `/step 1` | 将 `#1` 便签的进度条往前推进 `+1` 步 |
+| **Pi 斜杠命令** | `/anchor jump 1` | 直接切换回 `#1` 便签绑定的那场历史对话 (`switchSession`) |
+| **Pi 斜杠命令** | `/done 1` / `/anchor 1` | 按编号 `#1` 直接撕下便签并归档 |
+| **Pi 斜杠命令** | `/anchor undo` | 把刚刚撕下的便签重新贴回原位 |
+| **系统命令行** | `anchor` / `anchor "<内容>"` | 不进 Pi 也能在外部终端查看或贴便签 |
+| **系统命令行** | `anchor step 1` / `anchor done 1` / `anchor undo` | 在外部终端推进进度、撕便签或撤销 |
+
+---
+
+## Author's Note
+
+做 Anchor 的初衷很简单：我讨厌项目仓库里的 `TODO.md` 弄脏 Git 提交历史，但每天深夜关掉终端时，又需要有个地方随手记一句“明天接着改哪儿”。
+
+早期版本里，我犯了典型的过度设计病。到 `v0.3` 时，Anchor 膨胀成了 10 个源码文件的小型任务管理系统：塞进了四象限分类（`Today`、`Upcoming`、`Habits`、`Backlog`）、`[P0]` 优先级标签、每日习惯打卡、启动时同步阻塞跑测试脚本，甚至还有一套自动把过期任务移入坟场的淘汰机制。结果功能越堆越多，我自己反而越用越别扭——尤其荒诞的是，开局弹出的便签提示在我发出第一句话后就自动隐藏了，真正写代码的几个小时里根本看不见它。
+
+在 `v0.4` 和 `v0.5` 中，我删掉了 60% 的代码，只留 4 个核心文件（`types.ts`、`store.ts`、`tui.ts`、`extension.ts`），让它老老实实回归一张贴在输入框下沿的电子便签：
+1. 用 `belowEditor` 把单行便签条固定在输入框正下方，写代码时一眼能瞥见，同时把输入框上方的位置让给 `pi-lingual`。
+2. 便签本来就是给人自己随手写的，敲一句 `便签: ...` 在 0ms 内直接上屏，不必等大模型转圈。
+3. 针对跨天的大活，顺手加上 4 格迷你进度条（`[■■□□ 2/4]`）和原对话书签（`↪`），点一下就能切回当时的对话上下文接着干。
+
+```bash
+npm run typecheck  # TypeScript 严格类型检查 (0 错误)
+npm test           # 原生 Node 测试运行器 (10/10 全绿通过)
+npm run build      # tsup 双格式打包与类型声明生成
+```
 
 ---
 
-## 开源协议
+## License
 
 MIT © [Jason Song](https://github.com/3ZEROS12)

package/bin/anchor.js

@@ -30,8 +30,8 @@ if (args.length === 0 || args[0] === 'list' || args[0] === 'ls') {
   const sorted = sortAnchorsForDisplay(allNotes, process.cwd());
   console.log(`\n⌖ Notes (${sorted.length}):\n`);
 
-  sorted.forEach((a, idx) => {
-    const num = String(idx + 1).padStart(2, '0');
+  sorted.forEach((a) => {
+    const num = a.id.replace(/^anc-/, '').padStart(2, '0');
     const bar = a.progress ? `${formatProgressBar(a.progress)} ` : '';
     const origin = formatOrigin(a) + (a.sessionFile ? ' ↪' : '');
     const age = a.status === 'sleeping'
@@ -66,13 +66,13 @@ if (args[0] === 'step' || args[0] === '+') {
   const idInput = args[1] || '1';
   const delta = args[2] ? parseInt(args[2], 10) : 1;
   try {
-    const allNotes = store
-      .list({ cwd: process.cwd(), all: true })
-      .filter(a => a.status === 'active' || a.status === 'sleeping');
-    const sorted = sortAnchorsForDisplay(allNotes, process.cwd());
-
-    let targetId = idInput;
-    if (/^\d+$/.test(idInput)) {
+    const direct = store.get(idInput);
+    let targetId = direct ? direct.id : idInput;
+    if (!direct && /^\d+$/.test(idInput)) {
+      const allNotes = store
+        .list({ cwd: process.cwd(), all: true })
+        .filter(a => a.status === 'active' || a.status === 'sleeping');
+      const sorted = sortAnchorsForDisplay(allNotes, process.cwd());
       const seqIndex = parseInt(idInput, 10);
       if (seqIndex >= 1 && seqIndex <= sorted.length) {
         targetId = sorted[seqIndex - 1].id;
@@ -111,13 +111,13 @@ if (args[0] === 'done' || args[0] === 'rm' || args[0] === 'close') {
     process.exit(1);
   }
   try {
-    const allNotes = store
-      .list({ cwd: process.cwd(), all: true })
-      .filter(a => a.status === 'active' || a.status === 'sleeping');
-    const sorted = sortAnchorsForDisplay(allNotes, process.cwd());
-
-    let targetId = idInput;
-    if (/^\d+$/.test(idInput)) {
+    const direct = store.get(idInput);
+    let targetId = direct ? direct.id : idInput;
+    if (!direct && /^\d+$/.test(idInput)) {
+      const allNotes = store
+        .list({ cwd: process.cwd(), all: true })
+        .filter(a => a.status === 'active' || a.status === 'sleeping');
+      const sorted = sortAnchorsForDisplay(allNotes, process.cwd());
       const seqIndex = parseInt(idInput, 10);
       if (seqIndex >= 1 && seqIndex <= sorted.length) {
         targetId = sorted[seqIndex - 1].id;

package/dist/{chunk-VXEQDTK4.js → chunk-XL3YH2AF.js}

@@ -66,10 +66,10 @@ function extractProgressFromText(rawTitle) {
       progress: { done: 0, total: steps.length, steps }
     };
   }
-  const ratioMatch = rawTitle.match(/(?:\[(\d{1,3})\/(\d{1,3})\]|\((\d{1,3})\/(\d{1,3})\)|(?:^|\s)(\d{1,3})\/(\d{1,3})(?=\s|$))/);
+  const ratioMatch = rawTitle.match(/(?:\[(\d{1,3})\/(\d{1,3})\]|\((\d{1,3})\/(\d{1,3})\))/);
   if (ratioMatch) {
-    const done = parseInt(ratioMatch[1] ?? ratioMatch[3] ?? ratioMatch[5], 10);
-    const total = parseInt(ratioMatch[2] ?? ratioMatch[4] ?? ratioMatch[6], 10);
+    const done = parseInt(ratioMatch[1] ?? ratioMatch[3], 10);
+    const total = parseInt(ratioMatch[2] ?? ratioMatch[4], 10);
     if (!isNaN(done) && !isNaN(total) && total >= 2 && total <= 500 && done >= 0 && done <= total) {
       const stripped = rawTitle.replace(ratioMatch[0], " ").replace(/\s+/g, " ").trim();
       return {
@@ -91,7 +91,8 @@ function isAnchorTargetingWorkspace(anchor, targetCwd) {
   }
   if (anchor.files && anchor.files.length > 0) {
     for (const f of anchor.files) {
-      if (isSameOrSubPath(f, normTarget)) return true;
+      const resolvedFile = !path.isAbsolute(f) && !/^[a-zA-Z]:\//.test(f) && anchor.cwd ? `${anchor.cwd.replace(/\\/g, "/").replace(/\/+$/, "")}/${f.replace(/^\/+/, "")}` : f;
+      if (isSameOrSubPath(resolvedFile, normTarget)) return true;
     }
   }
   if (anchor.cwd && isSameOrSubPath(anchor.cwd, normTarget)) {
@@ -181,6 +182,41 @@ function makeSafeTaskAnnotation(filePath, anchor) {
   const num = anchor.id.replace(/^anc-/, "");
   return "\n\n" + fmt(`\u2316 Note #${num}: ${anchor.title}`);
 }
+var COMMIT_STOP_WORDS = /* @__PURE__ */ new Set([
+  "fix",
+  "feat",
+  "chore",
+  "docs",
+  "test",
+  "tests",
+  "refactor",
+  "style",
+  "perf",
+  "build",
+  "ci",
+  "bug",
+  "issue",
+  "update",
+  "add",
+  "remove",
+  "todo",
+  "note",
+  "task",
+  "the",
+  "and",
+  "for",
+  "with",
+  "\u4FEE\u590D",
+  "\u4F18\u5316",
+  "\u66F4\u65B0",
+  "\u6DFB\u52A0",
+  "\u4FEE\u6539",
+  "\u5B8C\u6210",
+  "\u95EE\u9898",
+  "\u4EFB\u52A1",
+  "\u6A21\u5757",
+  "\u529F\u80FD"
+]);
 function matchesCommitMessage(anchor, commitMessages) {
   const idLower = anchor.id.toLowerCase();
   const numId = `#${anchor.id.replace(/^anc-/, "")}`;
@@ -189,21 +225,22 @@ function matchesCommitMessage(anchor, commitMessages) {
   if (typeof Intl !== "undefined" && Intl.Segmenter) {
     try {
       const seg = new Intl.Segmenter("und", { granularity: "word" });
-      titleTokens = Array.from(seg.segment(title)).filter((s) => s.isWordLike).map((s) => s.segment.trim().toLowerCase()).filter((t) => t.length >= 2);
+      titleTokens = Array.from(seg.segment(title)).filter((s) => s.isWordLike).map((s) => s.segment.trim().toLowerCase()).filter((t) => t.length >= 2 && !COMMIT_STOP_WORDS.has(t));
     } catch {
-      titleTokens = title.split(/[\s,._\-\/]+/).filter((t) => t.length >= 2);
+      titleTokens = title.split(/[\s,._\-\/]+/).filter((t) => t.length >= 2 && !COMMIT_STOP_WORDS.has(t));
     }
   } else {
-    titleTokens = title.split(/[\s,._\-\/]+/).filter((t) => t.length >= 2);
+    titleTokens = title.split(/[\s,._\-\/]+/).filter((t) => t.length >= 2 && !COMMIT_STOP_WORDS.has(t));
   }
   for (const msg of commitMessages) {
     const msgLower = msg.toLowerCase();
-    if (msgLower.includes(idLower) || msgLower.includes(numId)) {
+    if (msgLower.includes(idLower) || new RegExp(`(?:^|\\s|\\()${numId}(?:\\b|\\)|$)`).test(msgLower)) {
       return { matched: true, message: msg };
     }
     if (titleTokens.length > 0) {
       const hits = titleTokens.filter((tok) => msgLower.includes(tok)).length;
-      if (hits >= Math.min(2, titleTokens.length)) {
+      const requiredHits = titleTokens.length === 1 ? 1 : 2;
+      if (hits >= requiredHits) {
         return { matched: true, message: msg };
       }
     }
@@ -504,9 +541,10 @@ var AnchorStore = class {
       if (idx === -1) throw new Error(`Note not found: ${id}`);
       const current = state.anchors[idx];
       const now = Date.now();
-      const total = explicitTotal && explicitTotal >= 2 ? explicitTotal : current.progress?.total || 4;
+      const safeDelta = Number.isFinite(delta) ? delta : 1;
+      const total = explicitTotal && Number.isFinite(explicitTotal) && explicitTotal >= 1 ? explicitTotal : current.progress?.total || 4;
       const prevDone = current.progress?.done || 0;
-      const nextDone = Math.max(0, Math.min(total, prevDone + delta));
+      const nextDone = Math.max(0, Math.min(total, prevDone + safeDelta));
       current.progress = {
         ...current.progress || {},
         done: nextDone,
@@ -749,15 +787,24 @@ function updateStartupBanner(ctx, store) {
           const titleClipped = truncateToWidth(a.title, availTitle);
           return [truncateToWidth(`${prefix}${titleClipped}${nextStep}${suffix}`, width)];
         }
-        const countTag = fg("accent", `\u2316 ${sorted.length} notes: `);
-        const segments = sorted.slice(0, 3).map((a) => {
+        const maxItems = width < 68 ? 1 : width < 100 ? 2 : 3;
+        const visibleSlice = sorted.slice(0, maxItems);
+        const countTag = fg("accent", `\u2316 ${sorted.length}: `);
+        const moreCount = sorted.length - visibleSlice.length;
+        const moreSuffix = moreCount > 0 ? fg("dim", ` +${moreCount}`) : "";
+        const perSlotWidth = Math.max(
+          10,
+          Math.floor((width - getDisplayWidth(countTag) - getDisplayWidth(moreSuffix) - (visibleSlice.length - 1) * 5) / visibleSlice.length)
+        );
+        const segments = visibleSlice.map((a) => {
           const num = a.id.replace(/^anc-/, "");
           const bar = a.progress ? `${formatProgressBar(a.progress)} ` : "";
-          const shortTitle = truncateToWidth(a.title, Math.max(14, Math.floor((width - 20) / Math.min(3, sorted.length)) - 12));
+          const prefix = `#${num} ${bar}`;
+          const titleBudget = Math.max(6, perSlotWidth - getDisplayWidth(prefix));
+          const shortTitle = truncateToWidth(a.title, titleBudget);
           return `${fg("dim", `#${num}`)} ${bar}${shortTitle}`;
         });
-        const more = sorted.length > 3 ? fg("dim", ` +${sorted.length - 3}`) : "";
-        return [truncateToWidth(`${countTag}${segments.join(fg("dim", "  \xB7  "))}${more}`, width)];
+        return [truncateToWidth(`${countTag}${segments.join(fg("dim", " \xB7 "))}${moreSuffix}`, width)];
       },
       invalidate: () => {
       }
@@ -798,7 +845,7 @@ async function openAnchorDashboard(ctx, store) {
   if (!anchor) return;
   const currentSessionFile = ctx.sessionManager?.getSessionFile?.();
   const canJumpSession = Boolean(
-    anchor.sessionFile && fs2.existsSync(anchor.sessionFile) && typeof ctx.switchSession === "function" && (!currentSessionFile || path2.resolve(anchor.sessionFile) !== path2.resolve(currentSessionFile))
+    anchor.sessionFile && fs2.existsSync(anchor.sessionFile) && typeof ctx.switchSession === "function" && (!currentSessionFile || !isSameOrSubPath(anchor.sessionFile, currentSessionFile))
   );
   const stepLabel = anchor.progress ? `\u25B6 Advance step (${anchor.progress.done}/${anchor.progress.total} \u2794 ${Math.min(anchor.progress.total, anchor.progress.done + 1)}/${anchor.progress.total})` : "\u25B6 Start progress bar (1/4)";
   const actions = [
@@ -887,11 +934,14 @@ function parseAnchorCommandInput(raw) {
   };
 }
 function parseQuickNoteInput(text) {
-  const m = (text || "").trim().match(/^(?:pin|note|便签|备忘)\s*[:：]\s*(.+)$/i);
-  return m && m[1].trim() ? m[1].trim() : null;
+  const m = (text || "").trim().match(/^(?:pin|note|便签|备忘)\s*[:：]\s*(.*)$/i);
+  if (!m) return null;
+  return m[1].trim();
 }
 function resolveAnchorTarget(store, idOrIndex, cwd) {
   const clean = idOrIndex.trim().replace(/^#/, "");
+  const direct = store.get(clean);
+  if (direct) return direct.id;
   if (/^\d+$/.test(clean)) {
     const seqIndex = parseInt(clean, 10);
     const visible = store.list({ cwd, all: true }).filter((a) => a.status === "active" || a.status === "sleeping");
@@ -900,7 +950,7 @@ function resolveAnchorTarget(store, idOrIndex, cwd) {
       return sorted[seqIndex - 1].id;
     }
   }
-  return store.get(clean)?.id;
+  return void 0;
 }
 function getSessionFileSafe(ctx) {
   try {
@@ -949,7 +999,13 @@ function extension_default(pi) {
   pi.on("input", async (event, ctx) => {
     if (event?.source === "extension") return { action: "continue" };
     const quickNote = parseQuickNoteInput(String(event?.text || ""));
-    if (!quickNote) return { action: "continue" };
+    if (quickNote === null) return { action: "continue" };
+    if (!quickNote) {
+      if (hasActiveUI(ctx)) {
+        await openAnchorDashboard(ctx, store);
+      }
+      return { action: "handled" };
+    }
     const anc = createStickyNoteFromUser(quickNote, ctx);
     const bar = anc.progress ? ` ${formatProgressBar(anc.progress)}` : "";
     if (hasActiveUI(ctx)) {
@@ -1201,7 +1257,7 @@ ${snippet}` };
         return;
       }
       const rawTrimmed = (args || "").trim();
-      if (/^(?:#?anc-\d+|#\d+)$/i.test(rawTrimmed)) {
+      if (/^(?:#?anc-\d+|#?\d+)$/i.test(rawTrimmed)) {
         const resolvedId = resolveAnchorTarget(store, rawTrimmed, ctx.cwd);
         if (resolvedId) {
           const settled = store.settle(resolvedId, { settledBy: "manual" });

package/dist/{extension-Cq1NH1jT.d.cts → extension-CvTgSv1L.d.cts}

@@ -197,8 +197,13 @@ declare function parseAnchorCommandInput(raw: string): {
 /**
  * Detect 0ms human-first quick note prefix in the input box:
  * e.g. `pin: 明天把Token改Cookie` or `便签: 检查网关重试 [1/4]`
+ * Returns `{ matched: true, note: '...' }` (or `note: ''` if user typed bare `pin:`)
  */
 declare function parseQuickNoteInput(text: string): string | null;
+/**
+ * Resolve note target by exact ID first (`#2` -> `anc-2`), falling back to 1-based display row index
+ * only when no note with that ID exists. Prevents settling the wrong note when sort order differs from ID order!
+ */
 declare function resolveAnchorTarget(store: AnchorStore, idOrIndex: string, cwd?: string): string | undefined;
 declare function export_default(pi: ExtensionAPI): void;
 

package/dist/{extension-Cq1NH1jT.d.ts → extension-CvTgSv1L.d.ts}

@@ -197,8 +197,13 @@ declare function parseAnchorCommandInput(raw: string): {
 /**
  * Detect 0ms human-first quick note prefix in the input box:
  * e.g. `pin: 明天把Token改Cookie` or `便签: 检查网关重试 [1/4]`
+ * Returns `{ matched: true, note: '...' }` (or `note: ''` if user typed bare `pin:`)
  */
 declare function parseQuickNoteInput(text: string): string | null;
+/**
+ * Resolve note target by exact ID first (`#2` -> `anc-2`), falling back to 1-based display row index
+ * only when no note with that ID exists. Prevents settling the wrong note when sort order differs from ID order!
+ */
 declare function resolveAnchorTarget(store: AnchorStore, idOrIndex: string, cwd?: string): string | undefined;
 declare function export_default(pi: ExtensionAPI): void;
 

package/dist/extension.cjs

@@ -103,10 +103,10 @@ function extractProgressFromText(rawTitle) {
       progress: { done: 0, total: steps.length, steps }
     };
   }
-  const ratioMatch = rawTitle.match(/(?:\[(\d{1,3})\/(\d{1,3})\]|\((\d{1,3})\/(\d{1,3})\)|(?:^|\s)(\d{1,3})\/(\d{1,3})(?=\s|$))/);
+  const ratioMatch = rawTitle.match(/(?:\[(\d{1,3})\/(\d{1,3})\]|\((\d{1,3})\/(\d{1,3})\))/);
   if (ratioMatch) {
-    const done = parseInt(ratioMatch[1] ?? ratioMatch[3] ?? ratioMatch[5], 10);
-    const total = parseInt(ratioMatch[2] ?? ratioMatch[4] ?? ratioMatch[6], 10);
+    const done = parseInt(ratioMatch[1] ?? ratioMatch[3], 10);
+    const total = parseInt(ratioMatch[2] ?? ratioMatch[4], 10);
     if (!isNaN(done) && !isNaN(total) && total >= 2 && total <= 500 && done >= 0 && done <= total) {
       const stripped = rawTitle.replace(ratioMatch[0], " ").replace(/\s+/g, " ").trim();
       return {
@@ -128,7 +128,8 @@ function isAnchorTargetingWorkspace(anchor, targetCwd) {
   }
   if (anchor.files && anchor.files.length > 0) {
     for (const f of anchor.files) {
-      if (isSameOrSubPath(f, normTarget)) return true;
+      const resolvedFile = !import_node_path.default.isAbsolute(f) && !/^[a-zA-Z]:\//.test(f) && anchor.cwd ? `${anchor.cwd.replace(/\\/g, "/").replace(/\/+$/, "")}/${f.replace(/^\/+/, "")}` : f;
+      if (isSameOrSubPath(resolvedFile, normTarget)) return true;
     }
   }
   if (anchor.cwd && isSameOrSubPath(anchor.cwd, normTarget)) {
@@ -218,6 +219,41 @@ function makeSafeTaskAnnotation(filePath, anchor) {
   const num = anchor.id.replace(/^anc-/, "");
   return "\n\n" + fmt(`\u2316 Note #${num}: ${anchor.title}`);
 }
+var COMMIT_STOP_WORDS = /* @__PURE__ */ new Set([
+  "fix",
+  "feat",
+  "chore",
+  "docs",
+  "test",
+  "tests",
+  "refactor",
+  "style",
+  "perf",
+  "build",
+  "ci",
+  "bug",
+  "issue",
+  "update",
+  "add",
+  "remove",
+  "todo",
+  "note",
+  "task",
+  "the",
+  "and",
+  "for",
+  "with",
+  "\u4FEE\u590D",
+  "\u4F18\u5316",
+  "\u66F4\u65B0",
+  "\u6DFB\u52A0",
+  "\u4FEE\u6539",
+  "\u5B8C\u6210",
+  "\u95EE\u9898",
+  "\u4EFB\u52A1",
+  "\u6A21\u5757",
+  "\u529F\u80FD"
+]);
 function matchesCommitMessage(anchor, commitMessages) {
   const idLower = anchor.id.toLowerCase();
   const numId = `#${anchor.id.replace(/^anc-/, "")}`;
@@ -226,21 +262,22 @@ function matchesCommitMessage(anchor, commitMessages) {
   if (typeof Intl !== "undefined" && Intl.Segmenter) {
     try {
       const seg = new Intl.Segmenter("und", { granularity: "word" });
-      titleTokens = Array.from(seg.segment(title)).filter((s) => s.isWordLike).map((s) => s.segment.trim().toLowerCase()).filter((t) => t.length >= 2);
+      titleTokens = Array.from(seg.segment(title)).filter((s) => s.isWordLike).map((s) => s.segment.trim().toLowerCase()).filter((t) => t.length >= 2 && !COMMIT_STOP_WORDS.has(t));
     } catch {
-      titleTokens = title.split(/[\s,._\-\/]+/).filter((t) => t.length >= 2);
+      titleTokens = title.split(/[\s,._\-\/]+/).filter((t) => t.length >= 2 && !COMMIT_STOP_WORDS.has(t));
     }
   } else {
-    titleTokens = title.split(/[\s,._\-\/]+/).filter((t) => t.length >= 2);
+    titleTokens = title.split(/[\s,._\-\/]+/).filter((t) => t.length >= 2 && !COMMIT_STOP_WORDS.has(t));
   }
   for (const msg of commitMessages) {
     const msgLower = msg.toLowerCase();
-    if (msgLower.includes(idLower) || msgLower.includes(numId)) {
+    if (msgLower.includes(idLower) || new RegExp(`(?:^|\\s|\\()${numId}(?:\\b|\\)|$)`).test(msgLower)) {
       return { matched: true, message: msg };
     }
     if (titleTokens.length > 0) {
       const hits = titleTokens.filter((tok) => msgLower.includes(tok)).length;
-      if (hits >= Math.min(2, titleTokens.length)) {
+      const requiredHits = titleTokens.length === 1 ? 1 : 2;
+      if (hits >= requiredHits) {
         return { matched: true, message: msg };
       }
     }
@@ -540,9 +577,10 @@ var AnchorStore = class {
       if (idx === -1) throw new Error(`Note not found: ${id}`);
       const current = state.anchors[idx];
       const now = Date.now();
-      const total = explicitTotal && explicitTotal >= 2 ? explicitTotal : current.progress?.total || 4;
+      const safeDelta = Number.isFinite(delta) ? delta : 1;
+      const total = explicitTotal && Number.isFinite(explicitTotal) && explicitTotal >= 1 ? explicitTotal : current.progress?.total || 4;
       const prevDone = current.progress?.done || 0;
-      const nextDone = Math.max(0, Math.min(total, prevDone + delta));
+      const nextDone = Math.max(0, Math.min(total, prevDone + safeDelta));
       current.progress = {
         ...current.progress || {},
         done: nextDone,
@@ -785,15 +823,24 @@ function updateStartupBanner(ctx, store) {
           const titleClipped = truncateToWidth(a.title, availTitle);
           return [truncateToWidth(`${prefix}${titleClipped}${nextStep}${suffix}`, width)];
         }
-        const countTag = fg("accent", `\u2316 ${sorted.length} notes: `);
-        const segments = sorted.slice(0, 3).map((a) => {
+        const maxItems = width < 68 ? 1 : width < 100 ? 2 : 3;
+        const visibleSlice = sorted.slice(0, maxItems);
+        const countTag = fg("accent", `\u2316 ${sorted.length}: `);
+        const moreCount = sorted.length - visibleSlice.length;
+        const moreSuffix = moreCount > 0 ? fg("dim", ` +${moreCount}`) : "";
+        const perSlotWidth = Math.max(
+          10,
+          Math.floor((width - getDisplayWidth(countTag) - getDisplayWidth(moreSuffix) - (visibleSlice.length - 1) * 5) / visibleSlice.length)
+        );
+        const segments = visibleSlice.map((a) => {
           const num = a.id.replace(/^anc-/, "");
           const bar = a.progress ? `${formatProgressBar(a.progress)} ` : "";
-          const shortTitle = truncateToWidth(a.title, Math.max(14, Math.floor((width - 20) / Math.min(3, sorted.length)) - 12));
+          const prefix = `#${num} ${bar}`;
+          const titleBudget = Math.max(6, perSlotWidth - getDisplayWidth(prefix));
+          const shortTitle = truncateToWidth(a.title, titleBudget);
           return `${fg("dim", `#${num}`)} ${bar}${shortTitle}`;
         });
-        const more = sorted.length > 3 ? fg("dim", ` +${sorted.length - 3}`) : "";
-        return [truncateToWidth(`${countTag}${segments.join(fg("dim", "  \xB7  "))}${more}`, width)];
+        return [truncateToWidth(`${countTag}${segments.join(fg("dim", " \xB7 "))}${moreSuffix}`, width)];
       },
       invalidate: () => {
       }
@@ -834,7 +881,7 @@ async function openAnchorDashboard(ctx, store) {
   if (!anchor) return;
   const currentSessionFile = ctx.sessionManager?.getSessionFile?.();
   const canJumpSession = Boolean(
-    anchor.sessionFile && import_node_fs2.default.existsSync(anchor.sessionFile) && typeof ctx.switchSession === "function" && (!currentSessionFile || import_node_path2.default.resolve(anchor.sessionFile) !== import_node_path2.default.resolve(currentSessionFile))
+    anchor.sessionFile && import_node_fs2.default.existsSync(anchor.sessionFile) && typeof ctx.switchSession === "function" && (!currentSessionFile || !isSameOrSubPath(anchor.sessionFile, currentSessionFile))
   );
   const stepLabel = anchor.progress ? `\u25B6 Advance step (${anchor.progress.done}/${anchor.progress.total} \u2794 ${Math.min(anchor.progress.total, anchor.progress.done + 1)}/${anchor.progress.total})` : "\u25B6 Start progress bar (1/4)";
   const actions = [
@@ -923,11 +970,14 @@ function parseAnchorCommandInput(raw) {
   };
 }
 function parseQuickNoteInput(text) {
-  const m = (text || "").trim().match(/^(?:pin|note|便签|备忘)\s*[:：]\s*(.+)$/i);
-  return m && m[1].trim() ? m[1].trim() : null;
+  const m = (text || "").trim().match(/^(?:pin|note|便签|备忘)\s*[:：]\s*(.*)$/i);
+  if (!m) return null;
+  return m[1].trim();
 }
 function resolveAnchorTarget(store, idOrIndex, cwd) {
   const clean = idOrIndex.trim().replace(/^#/, "");
+  const direct = store.get(clean);
+  if (direct) return direct.id;
   if (/^\d+$/.test(clean)) {
     const seqIndex = parseInt(clean, 10);
     const visible = store.list({ cwd, all: true }).filter((a) => a.status === "active" || a.status === "sleeping");
@@ -936,7 +986,7 @@ function resolveAnchorTarget(store, idOrIndex, cwd) {
       return sorted[seqIndex - 1].id;
     }
   }
-  return store.get(clean)?.id;
+  return void 0;
 }
 function getSessionFileSafe(ctx) {
   try {
@@ -985,7 +1035,13 @@ function extension_default(pi) {
   pi.on("input", async (event, ctx) => {
     if (event?.source === "extension") return { action: "continue" };
     const quickNote = parseQuickNoteInput(String(event?.text || ""));
-    if (!quickNote) return { action: "continue" };
+    if (quickNote === null) return { action: "continue" };
+    if (!quickNote) {
+      if (hasActiveUI(ctx)) {
+        await openAnchorDashboard(ctx, store);
+      }
+      return { action: "handled" };
+    }
     const anc = createStickyNoteFromUser(quickNote, ctx);
     const bar = anc.progress ? ` ${formatProgressBar(anc.progress)}` : "";
     if (hasActiveUI(ctx)) {
@@ -1237,7 +1293,7 @@ ${snippet}` };
         return;
       }
       const rawTrimmed = (args || "").trim();
-      if (/^(?:#?anc-\d+|#\d+)$/i.test(rawTrimmed)) {
+      if (/^(?:#?anc-\d+|#?\d+)$/i.test(rawTrimmed)) {
         const resolvedId = resolveAnchorTarget(store, rawTrimmed, ctx.cwd);
         if (resolvedId) {
           const settled = store.settle(resolvedId, { settledBy: "manual" });

package/dist/extension.d.cts

@@ -1,2 +1,2 @@
 import '@earendil-works/pi-coding-agent';
-export { z as default, t as parseAnchorCommandInput, u as parseQuickNoteInput, x as resolveAnchorTarget } from './extension-Cq1NH1jT.cjs';
+export { z as default, t as parseAnchorCommandInput, u as parseQuickNoteInput, x as resolveAnchorTarget } from './extension-CvTgSv1L.cjs';

package/dist/extension.d.ts

@@ -1,2 +1,2 @@
 import '@earendil-works/pi-coding-agent';
-export { z as default, t as parseAnchorCommandInput, u as parseQuickNoteInput, x as resolveAnchorTarget } from './extension-Cq1NH1jT.js';
+export { z as default, t as parseAnchorCommandInput, u as parseQuickNoteInput, x as resolveAnchorTarget } from './extension-CvTgSv1L.js';

package/dist/extension.js

@@ -3,7 +3,7 @@ import {
   parseAnchorCommandInput,
   parseQuickNoteInput,
   resolveAnchorTarget
-} from "./chunk-VXEQDTK4.js";
+} from "./chunk-XL3YH2AF.js";
 export {
   extension_default as default,
   parseAnchorCommandInput,

package/dist/index.cjs

@@ -130,10 +130,10 @@ function extractProgressFromText(rawTitle) {
       progress: { done: 0, total: steps.length, steps }
     };
   }
-  const ratioMatch = rawTitle.match(/(?:\[(\d{1,3})\/(\d{1,3})\]|\((\d{1,3})\/(\d{1,3})\)|(?:^|\s)(\d{1,3})\/(\d{1,3})(?=\s|$))/);
+  const ratioMatch = rawTitle.match(/(?:\[(\d{1,3})\/(\d{1,3})\]|\((\d{1,3})\/(\d{1,3})\))/);
   if (ratioMatch) {
-    const done = parseInt(ratioMatch[1] ?? ratioMatch[3] ?? ratioMatch[5], 10);
-    const total = parseInt(ratioMatch[2] ?? ratioMatch[4] ?? ratioMatch[6], 10);
+    const done = parseInt(ratioMatch[1] ?? ratioMatch[3], 10);
+    const total = parseInt(ratioMatch[2] ?? ratioMatch[4], 10);
     if (!isNaN(done) && !isNaN(total) && total >= 2 && total <= 500 && done >= 0 && done <= total) {
       const stripped = rawTitle.replace(ratioMatch[0], " ").replace(/\s+/g, " ").trim();
       return {
@@ -155,7 +155,8 @@ function isAnchorTargetingWorkspace(anchor, targetCwd) {
   }
   if (anchor.files && anchor.files.length > 0) {
     for (const f of anchor.files) {
-      if (isSameOrSubPath(f, normTarget)) return true;
+      const resolvedFile = !import_node_path.default.isAbsolute(f) && !/^[a-zA-Z]:\//.test(f) && anchor.cwd ? `${anchor.cwd.replace(/\\/g, "/").replace(/\/+$/, "")}/${f.replace(/^\/+/, "")}` : f;
+      if (isSameOrSubPath(resolvedFile, normTarget)) return true;
     }
   }
   if (anchor.cwd && isSameOrSubPath(anchor.cwd, normTarget)) {
@@ -245,6 +246,41 @@ function makeSafeTaskAnnotation(filePath, anchor) {
   const num = anchor.id.replace(/^anc-/, "");
   return "\n\n" + fmt(`\u2316 Note #${num}: ${anchor.title}`);
 }
+var COMMIT_STOP_WORDS = /* @__PURE__ */ new Set([
+  "fix",
+  "feat",
+  "chore",
+  "docs",
+  "test",
+  "tests",
+  "refactor",
+  "style",
+  "perf",
+  "build",
+  "ci",
+  "bug",
+  "issue",
+  "update",
+  "add",
+  "remove",
+  "todo",
+  "note",
+  "task",
+  "the",
+  "and",
+  "for",
+  "with",
+  "\u4FEE\u590D",
+  "\u4F18\u5316",
+  "\u66F4\u65B0",
+  "\u6DFB\u52A0",
+  "\u4FEE\u6539",
+  "\u5B8C\u6210",
+  "\u95EE\u9898",
+  "\u4EFB\u52A1",
+  "\u6A21\u5757",
+  "\u529F\u80FD"
+]);
 function matchesCommitMessage(anchor, commitMessages) {
   const idLower = anchor.id.toLowerCase();
   const numId = `#${anchor.id.replace(/^anc-/, "")}`;
@@ -253,21 +289,22 @@ function matchesCommitMessage(anchor, commitMessages) {
   if (typeof Intl !== "undefined" && Intl.Segmenter) {
     try {
       const seg = new Intl.Segmenter("und", { granularity: "word" });
-      titleTokens = Array.from(seg.segment(title)).filter((s) => s.isWordLike).map((s) => s.segment.trim().toLowerCase()).filter((t) => t.length >= 2);
+      titleTokens = Array.from(seg.segment(title)).filter((s) => s.isWordLike).map((s) => s.segment.trim().toLowerCase()).filter((t) => t.length >= 2 && !COMMIT_STOP_WORDS.has(t));
     } catch {
-      titleTokens = title.split(/[\s,._\-\/]+/).filter((t) => t.length >= 2);
+      titleTokens = title.split(/[\s,._\-\/]+/).filter((t) => t.length >= 2 && !COMMIT_STOP_WORDS.has(t));
     }
   } else {
-    titleTokens = title.split(/[\s,._\-\/]+/).filter((t) => t.length >= 2);
+    titleTokens = title.split(/[\s,._\-\/]+/).filter((t) => t.length >= 2 && !COMMIT_STOP_WORDS.has(t));
   }
   for (const msg of commitMessages) {
     const msgLower = msg.toLowerCase();
-    if (msgLower.includes(idLower) || msgLower.includes(numId)) {
+    if (msgLower.includes(idLower) || new RegExp(`(?:^|\\s|\\()${numId}(?:\\b|\\)|$)`).test(msgLower)) {
       return { matched: true, message: msg };
     }
     if (titleTokens.length > 0) {
       const hits = titleTokens.filter((tok) => msgLower.includes(tok)).length;
-      if (hits >= Math.min(2, titleTokens.length)) {
+      const requiredHits = titleTokens.length === 1 ? 1 : 2;
+      if (hits >= requiredHits) {
         return { matched: true, message: msg };
       }
     }
@@ -568,9 +605,10 @@ var AnchorStore = class {
       if (idx === -1) throw new Error(`Note not found: ${id}`);
       const current = state.anchors[idx];
       const now = Date.now();
-      const total = explicitTotal && explicitTotal >= 2 ? explicitTotal : current.progress?.total || 4;
+      const safeDelta = Number.isFinite(delta) ? delta : 1;
+      const total = explicitTotal && Number.isFinite(explicitTotal) && explicitTotal >= 1 ? explicitTotal : current.progress?.total || 4;
       const prevDone = current.progress?.done || 0;
-      const nextDone = Math.max(0, Math.min(total, prevDone + delta));
+      const nextDone = Math.max(0, Math.min(total, prevDone + safeDelta));
       current.progress = {
         ...current.progress || {},
         done: nextDone,
@@ -813,15 +851,24 @@ function updateStartupBanner(ctx, store) {
           const titleClipped = truncateToWidth(a.title, availTitle);
           return [truncateToWidth(`${prefix}${titleClipped}${nextStep}${suffix}`, width)];
         }
-        const countTag = fg("accent", `\u2316 ${sorted.length} notes: `);
-        const segments = sorted.slice(0, 3).map((a) => {
+        const maxItems = width < 68 ? 1 : width < 100 ? 2 : 3;
+        const visibleSlice = sorted.slice(0, maxItems);
+        const countTag = fg("accent", `\u2316 ${sorted.length}: `);
+        const moreCount = sorted.length - visibleSlice.length;
+        const moreSuffix = moreCount > 0 ? fg("dim", ` +${moreCount}`) : "";
+        const perSlotWidth = Math.max(
+          10,
+          Math.floor((width - getDisplayWidth(countTag) - getDisplayWidth(moreSuffix) - (visibleSlice.length - 1) * 5) / visibleSlice.length)
+        );
+        const segments = visibleSlice.map((a) => {
           const num = a.id.replace(/^anc-/, "");
           const bar = a.progress ? `${formatProgressBar(a.progress)} ` : "";
-          const shortTitle = truncateToWidth(a.title, Math.max(14, Math.floor((width - 20) / Math.min(3, sorted.length)) - 12));
+          const prefix = `#${num} ${bar}`;
+          const titleBudget = Math.max(6, perSlotWidth - getDisplayWidth(prefix));
+          const shortTitle = truncateToWidth(a.title, titleBudget);
           return `${fg("dim", `#${num}`)} ${bar}${shortTitle}`;
         });
-        const more = sorted.length > 3 ? fg("dim", ` +${sorted.length - 3}`) : "";
-        return [truncateToWidth(`${countTag}${segments.join(fg("dim", "  \xB7  "))}${more}`, width)];
+        return [truncateToWidth(`${countTag}${segments.join(fg("dim", " \xB7 "))}${moreSuffix}`, width)];
       },
       invalidate: () => {
       }
@@ -862,7 +909,7 @@ async function openAnchorDashboard(ctx, store) {
   if (!anchor) return;
   const currentSessionFile = ctx.sessionManager?.getSessionFile?.();
   const canJumpSession = Boolean(
-    anchor.sessionFile && import_node_fs2.default.existsSync(anchor.sessionFile) && typeof ctx.switchSession === "function" && (!currentSessionFile || import_node_path2.default.resolve(anchor.sessionFile) !== import_node_path2.default.resolve(currentSessionFile))
+    anchor.sessionFile && import_node_fs2.default.existsSync(anchor.sessionFile) && typeof ctx.switchSession === "function" && (!currentSessionFile || !isSameOrSubPath(anchor.sessionFile, currentSessionFile))
   );
   const stepLabel = anchor.progress ? `\u25B6 Advance step (${anchor.progress.done}/${anchor.progress.total} \u2794 ${Math.min(anchor.progress.total, anchor.progress.done + 1)}/${anchor.progress.total})` : "\u25B6 Start progress bar (1/4)";
   const actions = [
@@ -952,11 +999,14 @@ function parseAnchorCommandInput(raw) {
   };
 }
 function parseQuickNoteInput(text) {
-  const m = (text || "").trim().match(/^(?:pin|note|便签|备忘)\s*[:：]\s*(.+)$/i);
-  return m && m[1].trim() ? m[1].trim() : null;
+  const m = (text || "").trim().match(/^(?:pin|note|便签|备忘)\s*[:：]\s*(.*)$/i);
+  if (!m) return null;
+  return m[1].trim();
 }
 function resolveAnchorTarget(store, idOrIndex, cwd) {
   const clean = idOrIndex.trim().replace(/^#/, "");
+  const direct = store.get(clean);
+  if (direct) return direct.id;
   if (/^\d+$/.test(clean)) {
     const seqIndex = parseInt(clean, 10);
     const visible = store.list({ cwd, all: true }).filter((a) => a.status === "active" || a.status === "sleeping");
@@ -965,7 +1015,7 @@ function resolveAnchorTarget(store, idOrIndex, cwd) {
       return sorted[seqIndex - 1].id;
     }
   }
-  return store.get(clean)?.id;
+  return void 0;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { A as Anchor, a as AnchorProgress, b as AnchorStore } from './extension-Cq1NH1jT.cjs';
-export { c as AnchorEvidence, d as AnchorPriority, e as AnchorStatus, f as AnchorStoreState, C as COMMENT_FORMATS, M as MS_PER_DAY, Q as QUIET_AFTER_DAYS, T as TouchMatchResult, g as acquireSyncLock, h as atomicRenameWithRetry, i as extractPathsFromText, j as extractProgressFromText, k as findMatchedAnchors, l as getDefaultStorageDir, m as globToRegExp, n as isAnchorTargetingWorkspace, o as isSameOrSubPath, p as makeSafeTaskAnnotation, q as matchAnchorAgainstTouchedFiles, r as matchesCommitMessage, s as normalizePath, t as parseAnchorCommandInput, u as parseQuickNoteInput, v as renderActiveAnchorsContext, w as renderColdStartAnchorsContext, x as resolveAnchorTarget, y as sweepQuietNotes } from './extension-Cq1NH1jT.cjs';
+import { A as Anchor, a as AnchorProgress, b as AnchorStore } from './extension-CvTgSv1L.cjs';
+export { c as AnchorEvidence, d as AnchorPriority, e as AnchorStatus, f as AnchorStoreState, C as COMMENT_FORMATS, M as MS_PER_DAY, Q as QUIET_AFTER_DAYS, T as TouchMatchResult, g as acquireSyncLock, h as atomicRenameWithRetry, i as extractPathsFromText, j as extractProgressFromText, k as findMatchedAnchors, l as getDefaultStorageDir, m as globToRegExp, n as isAnchorTargetingWorkspace, o as isSameOrSubPath, p as makeSafeTaskAnnotation, q as matchAnchorAgainstTouchedFiles, r as matchesCommitMessage, s as normalizePath, t as parseAnchorCommandInput, u as parseQuickNoteInput, v as renderActiveAnchorsContext, w as renderColdStartAnchorsContext, x as resolveAnchorTarget, y as sweepQuietNotes } from './extension-CvTgSv1L.cjs';
 import { ExtensionContext, ExtensionCommandContext } from '@earendil-works/pi-coding-agent';
 
 declare function stripAnsi(str: string): string;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as Anchor, a as AnchorProgress, b as AnchorStore } from './extension-Cq1NH1jT.js';
-export { c as AnchorEvidence, d as AnchorPriority, e as AnchorStatus, f as AnchorStoreState, C as COMMENT_FORMATS, M as MS_PER_DAY, Q as QUIET_AFTER_DAYS, T as TouchMatchResult, g as acquireSyncLock, h as atomicRenameWithRetry, i as extractPathsFromText, j as extractProgressFromText, k as findMatchedAnchors, l as getDefaultStorageDir, m as globToRegExp, n as isAnchorTargetingWorkspace, o as isSameOrSubPath, p as makeSafeTaskAnnotation, q as matchAnchorAgainstTouchedFiles, r as matchesCommitMessage, s as normalizePath, t as parseAnchorCommandInput, u as parseQuickNoteInput, v as renderActiveAnchorsContext, w as renderColdStartAnchorsContext, x as resolveAnchorTarget, y as sweepQuietNotes } from './extension-Cq1NH1jT.js';
+import { A as Anchor, a as AnchorProgress, b as AnchorStore } from './extension-CvTgSv1L.js';
+export { c as AnchorEvidence, d as AnchorPriority, e as AnchorStatus, f as AnchorStoreState, C as COMMENT_FORMATS, M as MS_PER_DAY, Q as QUIET_AFTER_DAYS, T as TouchMatchResult, g as acquireSyncLock, h as atomicRenameWithRetry, i as extractPathsFromText, j as extractProgressFromText, k as findMatchedAnchors, l as getDefaultStorageDir, m as globToRegExp, n as isAnchorTargetingWorkspace, o as isSameOrSubPath, p as makeSafeTaskAnnotation, q as matchAnchorAgainstTouchedFiles, r as matchesCommitMessage, s as normalizePath, t as parseAnchorCommandInput, u as parseQuickNoteInput, v as renderActiveAnchorsContext, w as renderColdStartAnchorsContext, x as resolveAnchorTarget, y as sweepQuietNotes } from './extension-CvTgSv1L.js';
 import { ExtensionContext, ExtensionCommandContext } from '@earendil-works/pi-coding-agent';
 
 declare function stripAnsi(str: string): string;

package/dist/index.js

@@ -34,7 +34,7 @@ import {
   truncateToWidth,
   updateAnchorStatusBar,
   updateStartupBanner
-} from "./chunk-VXEQDTK4.js";
+} from "./chunk-XL3YH2AF.js";
 export {
   AnchorStore,
   COMMENT_FORMATS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-anchor",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "A digital sticky note docked below your Pi editor — stick notes in 0ms (pin: ...), track long tasks with micro progress bars [■■□□], jump back to the original session (↪), and auto-tear off on git commit.",
   "type": "module",
   "main": "dist/index.js",

package/src/extension.ts

@@ -71,14 +71,25 @@ export function parseAnchorCommandInput(raw: string): {
 /**
  * Detect 0ms human-first quick note prefix in the input box:
  * e.g. `pin: 明天把Token改Cookie` or `便签: 检查网关重试 [1/4]`
+ * Returns `{ matched: true, note: '...' }` (or `note: ''` if user typed bare `pin:`)
  */
 export function parseQuickNoteInput(text: string): string | null {
-  const m = (text || '').trim().match(/^(?:pin|note|便签|备忘)\s*[:：]\s*(.+)$/i);
-  return m && m[1].trim() ? m[1].trim() : null;
+  const m = (text || '').trim().match(/^(?:pin|note|便签|备忘)\s*[:：]\s*(.*)$/i);
+  if (!m) return null;
+  return m[1].trim();
 }
 
+/**
+ * Resolve note target by exact ID first (`#2` -> `anc-2`), falling back to 1-based display row index
+ * only when no note with that ID exists. Prevents settling the wrong note when sort order differs from ID order!
+ */
 export function resolveAnchorTarget(store: AnchorStore, idOrIndex: string, cwd?: string): string | undefined {
   const clean = idOrIndex.trim().replace(/^#/, '');
+  // 1. Exact ID match first (matches #num shown in TUI and CLI!)
+  const direct = store.get(clean);
+  if (direct) return direct.id;
+
+  // 2. Fallback to 1-based display row index
   if (/^\d+$/.test(clean)) {
     const seqIndex = parseInt(clean, 10);
     const visible = store
@@ -89,7 +100,7 @@ export function resolveAnchorTarget(store: AnchorStore, idOrIndex: string, cwd?:
       return sorted[seqIndex - 1].id;
     }
   }
-  return store.get(clean)?.id;
+  return undefined;
 }
 
 function getSessionFileSafe(ctx?: ExtensionContext): string | undefined {
@@ -152,7 +163,14 @@ export default function (pi: ExtensionAPI) {
   pi.on('input', async (event: any, ctx: ExtensionContext) => {
     if (event?.source === 'extension') return { action: 'continue' };
     const quickNote = parseQuickNoteInput(String(event?.text || ''));
-    if (!quickNote) return { action: 'continue' };
+    if (quickNote === null) return { action: 'continue' };
+
+    if (!quickNote) {
+      if (hasActiveUI(ctx)) {
+        await openAnchorDashboard(ctx, store);
+      }
+      return { action: 'handled' };
+    }
 
     const anc = createStickyNoteFromUser(quickNote, ctx);
     const bar = anc.progress ? ` ${formatProgressBar(anc.progress)}` : '';
@@ -433,7 +451,7 @@ export default function (pi: ExtensionAPI) {
       }
 
       const rawTrimmed = (args || '').trim();
-      if (/^(?:#?anc-\d+|#\d+)$/i.test(rawTrimmed)) {
+      if (/^(?:#?anc-\d+|#?\d+)$/i.test(rawTrimmed)) {
         const resolvedId = resolveAnchorTarget(store, rawTrimmed, ctx.cwd);
         if (resolvedId) {
           const settled = store.settle(resolvedId, { settledBy: 'manual' });

package/src/store.ts

@@ -101,11 +101,11 @@ export function extractProgressFromText(rawTitle: string): { cleanTitle: string;
     };
   }
 
-  // 2. Check explicit ratio tag: "[2/5]", "(0/4)", or trailing/standalone "5/30"
-  const ratioMatch = rawTitle.match(/(?:\[(\d{1,3})\/(\d{1,3})\]|\((\d{1,3})\/(\d{1,3})\)|(?:^|\s)(\d{1,3})\/(\d{1,3})(?=\s|$))/);
+  // 2. Check explicit bracketed ratio tag: "[2/5]" or "(0/4)" (requires brackets so dates like 10/12 are never hijacked)
+  const ratioMatch = rawTitle.match(/(?:\[(\d{1,3})\/(\d{1,3})\]|\((\d{1,3})\/(\d{1,3})\))/);
   if (ratioMatch) {
-    const done = parseInt(ratioMatch[1] ?? ratioMatch[3] ?? ratioMatch[5], 10);
-    const total = parseInt(ratioMatch[2] ?? ratioMatch[4] ?? ratioMatch[6], 10);
+    const done = parseInt(ratioMatch[1] ?? ratioMatch[3], 10);
+    const total = parseInt(ratioMatch[2] ?? ratioMatch[4], 10);
     if (!isNaN(done) && !isNaN(total) && total >= 2 && total <= 500 && done >= 0 && done <= total) {
       const stripped = rawTitle
         .replace(ratioMatch[0], ' ')
@@ -137,7 +137,10 @@ export function isAnchorTargetingWorkspace(anchor: Anchor, targetCwd?: string):
 
   if (anchor.files && anchor.files.length > 0) {
     for (const f of anchor.files) {
-      if (isSameOrSubPath(f, normTarget)) return true;
+      const resolvedFile = (!path.isAbsolute(f) && !/^[a-zA-Z]:\//.test(f) && anchor.cwd)
+        ? `${anchor.cwd.replace(/\\/g, '/').replace(/\/+$/, '')}/${f.replace(/^\/+/, '')}`
+        : f;
+      if (isSameOrSubPath(resolvedFile, normTarget)) return true;
     }
   }
 
@@ -221,6 +224,12 @@ export function makeSafeTaskAnnotation(filePath: string, anchor: Anchor): string
   return '\n\n' + fmt(`⌖ Note #${num}: ${anchor.title}`);
 }
 
+const COMMIT_STOP_WORDS = new Set([
+  'fix', 'feat', 'chore', 'docs', 'test', 'tests', 'refactor', 'style', 'perf', 'build', 'ci',
+  'bug', 'issue', 'update', 'add', 'remove', 'todo', 'note', 'task', 'the', 'and', 'for', 'with',
+  '修复', '优化', '更新', '添加', '修改', '完成', '问题', '任务', '模块', '功能'
+]);
+
 /**
  * Clever Touch 3: Match a `git commit -m "..."` message against a sticky note (supports CJK & English)
  */
@@ -236,22 +245,23 @@ export function matchesCommitMessage(anchor: Anchor, commitMessages: string[]):
       titleTokens = Array.from(seg.segment(title))
         .filter((s: any) => s.isWordLike)
         .map((s: any) => s.segment.trim().toLowerCase())
-        .filter((t: string) => t.length >= 2);
+        .filter((t: string) => t.length >= 2 && !COMMIT_STOP_WORDS.has(t));
     } catch {
-      titleTokens = title.split(/[\s,._\-\/]+/).filter(t => t.length >= 2);
+      titleTokens = title.split(/[\s,._\-\/]+/).filter(t => t.length >= 2 && !COMMIT_STOP_WORDS.has(t));
     }
   } else {
-    titleTokens = title.split(/[\s,._\-\/]+/).filter(t => t.length >= 2);
+    titleTokens = title.split(/[\s,._\-\/]+/).filter(t => t.length >= 2 && !COMMIT_STOP_WORDS.has(t));
   }
 
   for (const msg of commitMessages) {
     const msgLower = msg.toLowerCase();
-    if (msgLower.includes(idLower) || msgLower.includes(numId)) {
+    if (msgLower.includes(idLower) || new RegExp(`(?:^|\\s|\\()${numId}(?:\\b|\\)|$)`).test(msgLower)) {
       return { matched: true, message: msg };
     }
     if (titleTokens.length > 0) {
       const hits = titleTokens.filter(tok => msgLower.includes(tok)).length;
-      if (hits >= Math.min(2, titleTokens.length)) {
+      const requiredHits = titleTokens.length === 1 ? 1 : 2;
+      if (hits >= requiredHits) {
         return { matched: true, message: msg };
       }
     }
@@ -615,11 +625,12 @@ export class AnchorStore {
 
       const current = state.anchors[idx];
       const now = Date.now();
-      const total = explicitTotal && explicitTotal >= 2
+      const safeDelta = Number.isFinite(delta) ? delta : 1;
+      const total = explicitTotal && Number.isFinite(explicitTotal) && explicitTotal >= 1
         ? explicitTotal
         : (current.progress?.total || 4);
       const prevDone = current.progress?.done || 0;
-      const nextDone = Math.max(0, Math.min(total, prevDone + delta));
+      const nextDone = Math.max(0, Math.min(total, prevDone + safeDelta));
 
       current.progress = {
         ...(current.progress || {}),

package/src/tui.ts

@@ -1,5 +1,5 @@
 import type { ExtensionCommandContext, ExtensionContext } from '@earendil-works/pi-coding-agent';
-import { AnchorStore, isAnchorTargetingWorkspace } from './store.ts';
+import { AnchorStore, isAnchorTargetingWorkspace, isSameOrSubPath } from './store.ts';
 import type { Anchor, AnchorProgress } from './types.ts';
 import fs from 'node:fs';
 import path from 'node:path';
@@ -238,16 +238,26 @@ export function updateStartupBanner(ctx: ExtensionContext, store: AnchorStore):
           return [truncateToWidth(`${prefix}${titleClipped}${nextStep}${suffix}`, width)];
         }
 
-        // Multiple notes: compact horizontal sticky strip (`⌖ #1 ... · #2 ...`)
-        const countTag = fg('accent', `⌖ ${sorted.length} notes: `);
-        const segments = sorted.slice(0, 3).map(a => {
+        // Multiple notes: adaptive horizontal sticky strip (fits narrow 50-col and wide terminals cleanly)
+        const maxItems = width < 68 ? 1 : (width < 100 ? 2 : 3);
+        const visibleSlice = sorted.slice(0, maxItems);
+        const countTag = fg('accent', `⌖ ${sorted.length}: `);
+        const moreCount = sorted.length - visibleSlice.length;
+        const moreSuffix = moreCount > 0 ? fg('dim', ` +${moreCount}`) : '';
+        const perSlotWidth = Math.max(
+          10,
+          Math.floor((width - getDisplayWidth(countTag) - getDisplayWidth(moreSuffix) - (visibleSlice.length - 1) * 5) / visibleSlice.length)
+        );
+
+        const segments = visibleSlice.map(a => {
           const num = a.id.replace(/^anc-/, '');
           const bar = a.progress ? `${formatProgressBar(a.progress)} ` : '';
-          const shortTitle = truncateToWidth(a.title, Math.max(14, Math.floor((width - 20) / Math.min(3, sorted.length)) - 12));
+          const prefix = `#${num} ${bar}`;
+          const titleBudget = Math.max(6, perSlotWidth - getDisplayWidth(prefix));
+          const shortTitle = truncateToWidth(a.title, titleBudget);
           return `${fg('dim', `#${num}`)} ${bar}${shortTitle}`;
         });
-        const more = sorted.length > 3 ? fg('dim', ` +${sorted.length - 3}`) : '';
-        return [truncateToWidth(`${countTag}${segments.join(fg('dim', '  ·  '))}${more}`, width)];
+        return [truncateToWidth(`${countTag}${segments.join(fg('dim', ' · '))}${moreSuffix}`, width)];
       },
       invalidate: () => {}
     });
@@ -313,7 +323,7 @@ export async function openAnchorDashboard(
     anchor.sessionFile &&
     fs.existsSync(anchor.sessionFile) &&
     typeof (ctx as ExtensionCommandContext).switchSession === 'function' &&
-    (!currentSessionFile || path.resolve(anchor.sessionFile) !== path.resolve(currentSessionFile))
+    (!currentSessionFile || !isSameOrSubPath(anchor.sessionFile, currentSessionFile))
   );
 
   const stepLabel = anchor.progress