@zihanw/pi-forge 0.5.2 → 0.5.4

package/docs/zh-CN/guides/web-editor.md

@@ -10,7 +10,7 @@
 
 `/preset ui restart` 会替换 server，`/preset ui stop` 会关闭它。
 
-编辑器绑定在带 session token 的可用 `127.0.0.1` 端口；多个项目可以同时运行。读取、预览和 payload 检查在合适范围内可用；写入要求 Pi 信任项目，并且文件被限制在 pi-forge 的 stack/profile 存储内。可以在 `.pi/forge/config.json` 中设置偏好端口：
+编辑器绑定在带 session token 的可用 `127.0.0.1` 端口；多个项目可以同时运行。读取、预览和 payload 检查在合适范围内可用；写入要求 Pi 信任项目，并且文件被限制在 Pi Forge 的预设/Profile 存储内。可以在 `.pi/forge/config.json` 中设置偏好端口：
 
 ```json
 {
@@ -22,13 +22,14 @@
 
 ## 界面语言
 
-编辑器界面提供英文和中文。使用顶栏的语言选择器（Auto / English / 中文）；选择会写入项目配置中的 `webEditor.locale`。默认为 `Auto`，跟随浏览器语言，首次页面渲染也会参考浏览器的 `Accept-Language` 请求头。界面框架、内置 stack/profile 界面以及预览/差异停靠栏均已本地化；编译器诊断信息、插件提供的设置页面以及堆栈内容（条目名称、块文本）保持其原始语言。
+编辑器界面提供英文和中文。使用顶栏的语言选择器（Auto / English / 中文）；选择会写入项目配置中的 `webEditor.locale`。默认为 `Auto`，跟随浏览器语言，首次页面渲染也会参考浏览器的 `Accept-Language` 请求头。界面框架、内置预设/Profile 界面以及预览/差异停靠栏均已本地化；编译器诊断信息、插件提供的设置页面以及预设中自行编写的内容保持其原始语言。
 
-## Prompt stack 工作区
+## 预设工作区
 
 支持：
 
-- 从默认 Pi mirror 新建 stack；
+- 从默认 Pi mirror 新建预设；
+- 在 **堆栈** tab 中编排有序的 Block/Slot；
 - 结构化和原始 JSON 编辑；
 - 拖拽排序、启用/禁用、校验和完整编译预览；
 - 工具/skill 搜索、精确名称 chips 和通配符策略；
@@ -36,13 +37,13 @@
 - 原生 pi-forge JSON 导入；
 - 导出、fork、删除和 payload 捕获。
 
-已有 ID 在编辑时不可修改；需要新 ID 时使用 **Fork**，避免破坏 profile 引用和当前选择。工具栏的 scope 下拉（默认 `project`）决定新建、导入和 fork 的写入位置：选择 `global` 写入用户全局 `~/.pi/forge/prompt-stacks`，选择 `project` 写入项目 `.pi/forge/prompt-stacks`。列表会为全局 stack 显示 `global` badge；保存和删除通过 `global:<id>` 路由精确作用于全局文件。保存、导入、fork 和删除后会重新加载当前 Pi session。
+已有 ID 在编辑时不可修改；需要新 ID 时使用 **Fork**，避免破坏 Profile 引用和当前选择。工具栏的 scope 下拉（默认 `project`）决定新建、导入和 fork 的写入位置：选择 `global` 写入用户全局 `~/.pi/forge/prompt-stacks`，选择 `project` 写入项目 `.pi/forge/prompt-stacks`；这些目录名在 0.5.3 中为兼容性暂时保留。列表会为全局预设显示 `global` badge；保存和删除通过 `global:<id>` 路由精确作用于全局文件。保存、导入、fork 和删除后会重新加载当前 Pi session。
 
 ## Agent profile 工作区
 
-列表显示 profile ID、名称、模型、思考等级、stack、校验状态、auto-activation 和 last-applied provenance。每个 profile 都带 `project` / `global` scope badge；同 ID 的 shadow 对会显示 `shadows global:<id>` 或 `shadowed by project:<id>`。
+列表显示 Profile ID、名称、模型、思考等级、预设、校验状态、auto-activation 和 last-applied provenance。每个 Profile 都带 `project` / `global` scope badge；同 ID 的 shadow 对会显示 `shadows global:<id>` 或 `shadowed by project:<id>`。
 
-可信项目通过 **New profile** 旁的 scope 下拉（默认 `project`）选择目标 scope：选择 `global` 写入用户全局 `~/.pi/forge/agent-profiles`，选择 `project` 写入项目 `.pi/forge/agent-profiles`。全局 profile 可通过显式 `global:<id>` 路由编辑、校验、保存、一次性应用和删除；未限定路由始终只作用于项目资源。编辑全局 profile 时，stack 下拉只显示全局 stack。Model 选项来自 Pi registry，thinking 选项反映模型支持，stack 选项来自同一个 repository。编辑器会拒绝同 scope 内第二个 auto-activation profile。
+可信项目通过 **New profile** 旁的 scope 下拉（默认 `project`）选择目标 scope：选择 `global` 写入用户全局 `~/.pi/forge/agent-profiles`，选择 `project` 写入项目 `.pi/forge/agent-profiles`。全局 Profile 可通过显式 `global:<id>` 路由编辑、校验、保存、一次性应用和删除；未限定路由始终只作用于项目资源。编辑全局 Profile 时，预设下拉只显示全局预设。Model 选项来自 Pi registry，thinking 选项反映模型支持，预设选项来自同一个 repository。编辑器会拒绝同 scope 内第二个 auto-activation Profile。
 
 ## Delegation
 

package/examples/custom-system-status-extension/README.md

@@ -2,12 +2,12 @@
 
 This example shows how trusted pi-forge extension modules can register a custom macro and custom slot without importing `@zihanw/pi-forge` from a loose Pi extension file.
 
-At registration time it captures one machine snapshot, then registers:
+It registers two renderers that sample the machine when the prompt is compiled:
 
-- `{{ extensions.cpuLoad }}` macro: one-line CPU load summary.
-- `machine-status` slot: CPU load, OS load average, memory, and uptime snapshot.
+- `{{ extensions.cpuLoad }}` macro: one-line CPU load summary sampled when that macro is rendered.
+- `machine-status` slot: CPU load, OS load average, memory, and uptime sampled when that slot is rendered.
 
-The renderers only format that captured value, so repeated prompt compilation over the same registered extension is deterministic. The snapshot stays fixed until the extension is reloaded; this is intentionally a registration/pure-render example, not live telemetry or an async sampled CPU-utilization profiler.
+This is compile-time telemetry, not a continuous sampler: no background timer runs and nothing streams while the model is generating. pi-forge performs the full Stack compilation for the first provider request of each user turn (and for explicit Preview/Diff compilation); tool-result follow-up requests do not rerun the full Stack. The macro and slot render independently, so their snapshots may differ slightly.
 
 ## Try It
 
@@ -26,8 +26,7 @@ Start Pi, trust the project if prompted, then run:
 /preset use custom-system-status
 ```
 
-Use `/preset diagnostics` to confirm the extension file is listed under loaded pi-forge extensions.
-Run `/preset reload` whenever you want to capture a fresh machine snapshot.
+Use `/preset diagnostics` to confirm the extension file is listed under loaded pi-forge extensions. Start another user turn or recompile Preview to sample again. `/preset reload` is only needed after changing the extension or stack files.
 
 ## Where To Put The Extension
 

package/examples/custom-system-status-extension/index.ts

@@ -24,7 +24,7 @@ interface ForgeRegistrationApi {
 	}): () => void;
 }
 
-interface SystemStatusSnapshot {
+export interface SystemStatusSnapshot {
 	logicalCores: number;
 	cpuModel: string;
 	load1: number;
@@ -37,20 +37,23 @@ interface SystemStatusSnapshot {
 	uptimeSeconds: number;
 }
 
-export default function registerSystemStatus(api: ForgeRegistrationApi): void {
-	const snapshot = Object.freeze(readSystemStatus());
+export default function registerSystemStatus(
+	api: ForgeRegistrationApi,
+	sampleSystemStatus: () => SystemStatusSnapshot = readSystemStatus,
+): void {
 	api.registerMacro({
 		name: "cpuLoad",
 		source: "pi-forge-example-system-status",
-		description: "Machine CPU load captured when the trusted extension was registered.",
+		description: "Machine CPU load sampled when the prompt is compiled.",
 		dependencies: [],
-		render: () => formatCpuLoad(snapshot),
+		// Renderers run during prompt compilation. Read a fresh snapshot for each render.
+		render: () => formatCpuLoad(Object.freeze(sampleSystemStatus())),
 	});
 
 	api.registerSlot({
 		name: "machine-status",
 		source: "pi-forge-example-system-status",
-		description: "Machine CPU, memory, and uptime captured when the trusted extension was registered.",
+		description: "Machine CPU, memory, and uptime sampled when the prompt is compiled.",
 		dependencies: [],
 		options: {
 			format: { type: "enum", values: ["plain", "xml"], default: "plain" },
@@ -59,6 +62,8 @@ export default function registerSystemStatus(api: ForgeRegistrationApi): void {
 			includeUptime: { type: "boolean", default: true },
 		},
 		render: (ctx) => {
+			// Do not capture this at registration time: sample when the slot is rendered.
+			const snapshot = Object.freeze(sampleSystemStatus());
 			const includeMemory = ctx.options.includeMemory !== false;
 			const includeUptime = ctx.options.includeUptime !== false;
 			const heading = typeof ctx.options.heading === "string" && ctx.options.heading.trim()

package/examples/fake-assistant-direct-output-prompt-stack.json

@@ -0,0 +1,48 @@
+{
+  "schemaVersion": 2,
+  "type": "pi-forge.prompt-stack",
+  "id": "fake-assistant-direct-output",
+  "name": "Fake Assistant: Direct Output",
+  "description": "Model-specific experiment: append an ordinary assistant text message after chat history to suggest that tagged reasoning has already finished. Compatibility varies by model, provider, and endpoint; verify with an A/B run before use.",
+  "autoActivate": false,
+  "mode": "replace",
+  "defaults": {
+    "syntheticMessagesVisible": false,
+    "unresolvedMacroPolicy": "warn"
+  },
+  "context": {
+    "allowDuplicateChatHistory": false,
+    "mergeConsecutiveRoles": false
+  },
+  "tools": {
+    "deny": [
+      "*"
+    ]
+  },
+  "items": [
+    {
+      "kind": "block",
+      "id": "direct-answer-role",
+      "name": "Direct Answer Role",
+      "enabled": true,
+      "role": "system",
+      "content": "You are a concise assistant. Answer the user's latest request directly and include only the requested result."
+    },
+    {
+      "kind": "slot",
+      "id": "chat-history",
+      "name": "Chat History",
+      "enabled": true,
+      "slot": "chat-history"
+    },
+    {
+      "kind": "block",
+      "id": "fake-completed-thinking",
+      "name": "Fake Completed Thinking",
+      "enabled": true,
+      "role": "assistant",
+      "content": "<think>思考已完成，直接输出结果。</think>"
+    }
+  ],
+  "parameters": {}
+}

package/examples/minimal-prompt-stack.json

@@ -3,7 +3,7 @@
   "type": "pi-forge.prompt-stack",
   "id": "minimal",
   "name": "Minimal Worker",
-  "description": "Bare-minimum stack: one role block, one tools slot, chat history. Policy allows bash only - what you see is literally everything that gets sent.",
+  "description": "Minimal Pi approximation of the DeepSeek Harness Minimal shape: the exact one-line persona, chat history, and only Pi's stock bash plus edit. It does not replicate DSH's persistent shell, editor tool, PTY, sandbox, or deployment semantics.",
   "autoActivate": false,
   "mode": "replace",
   "defaults": {
@@ -12,7 +12,8 @@
   },
   "tools": {
     "allow": [
-      "bash"
+      "bash",
+      "edit"
     ]
   },
   "items": [
@@ -29,7 +30,10 @@
       "id": "chat-history",
       "name": "Chat History",
       "enabled": true,
-      "slot": "chat-history"
+      "slot": "chat-history",
+      "options": {
+        "includeSummaries": false
+      }
     }
   ],
   "parameters": {}

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@zihanw/pi-forge",
-	"version": "0.5.2",
-	"description": "Pi extension for prompt stacks, one-shot agent profiles, policy, import, and debugging.",
+	"version": "0.5.4",
+	"description": "Pi extension for editable context presets, one-shot agent profiles, tool policy, and request debugging.",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/MacroSony/pi-forge.git"