README.zh-CN.md - DeepSeek-Reasonix

README.zh-CN.md

1	# Starter Extension
2
3	该目录是一个完整、可安装的 Extension Protocol v1 插件。它的 Sidecar
4	拦截 `input.receive`；以 `starter: ` 开头的文本会在送入模型前追加
5	` [rewritten by starter-extension]`。
6
7	二进制统一使用 `.exe` 后缀是有意设计：这样所有平台可以共用同一份
8	Manifest。Unix 可以正常执行该文件，Windows 则需要可执行文件后缀。
9
10	## 构建与安装
11
12	在 macOS 或 Linux 中进入本目录后运行：
13
14	```sh
15	go build -o bin/starter-extension.exe .
16	plugin_root="$(pwd -P)"
17	reasonix plugin install "$plugin_root" --dry-run
18	reasonix plugin install "$plugin_root" --link --replace --yes
19	```
20
21	Windows PowerShell：
22
23	```powershell
24	go build -o bin/starter-extension.exe .
25	$pluginRoot = (Resolve-Path .).Path
26	reasonix plugin install $pluginRoot --dry-run
27	reasonix plugin install $pluginRoot --link --replace --yes
28	```
29
30	安装前请检查 dry-run 输出中的 `FULL TRUST` 区块。链接安装会持续信任本目录
31	后续的内容变化，而且代码型 Runtime 运行在 Reasonix Sandbox 之外。
32
33	启动新会话，或在当前会话空闲时运行 `/reload`，然后发送：
34
35	```text
36	starter: 解释 Extension Protocol Sidecar 的作用
37	```
38
39	模型会收到改写后的文本。修改 `main.go`、重新构建、执行 `/reload` 后即可
40	再次验证。Manifest 或二进制校验失败时，运行
41	`reasonix plugin doctor starter-extension`。
42
43	## 下一步
44
45	- [`../../README.md`](../../README.md) 说明 SDK 回调与并发契约。
46	- [`../../../../docs/EXTENSIONS.zh-CN.md`](../../../../docs/EXTENSIONS.zh-CN.md)
47	说明重载、性能、缓存、兼容性与信任模型。
48	- [`../../../../docs/PLUGIN_PACKAGES.zh-CN.md`](../../../../docs/PLUGIN_PACKAGES.zh-CN.md)
49	定义 Manifest v1 的全部字段。
50	- [`../../../../docs/EXTENSION_PROTOCOL.zh-CN.md`](../../../../docs/EXTENSION_PROTOCOL.zh-CN.md)
51	是线上协议参考。
52	- [`../fullsidecar/main.go`](../fullsidecar/main.go) 展示 Provider、结构化 UI、
53	strategy、工具、content ref 与关闭流程。
54
55	要发布可分发插件，请为目标平台构建二进制，确保 Manifest runtime 路径与
56	包内文件一致，并提供不可变的源码或 release artifact 供用户安装前审查。
57

57 lines MARKDOWN