add plugin docs (#1025)

* feat(docs): add 'Hosted UI' section and links across multiple languages

- Introduced 'Hosted UI' terminology in the English, Chinese, and Japanese plugin documentation, enhancing clarity on interactive TSX panels and Markdown guides.
- Updated the sidebar and quick start guides to include links to the new 'Hosted UI' section, improving navigation for users.
- Adjusted the structure of plugin directories in documentation to reflect the new UI components and their organization.

* docs: update 'Hosted UI' documentation with detailed usage guidelines and examples

- Enhanced the 'Hosted UI' section in both English and Chinese documentation, providing clearer instructions on when to use Hosted TSX and Markdown for plugin interfaces.
- Added a minimal example layout and clarified the declaration of surfaces in `plugin.toml`.
- Improved explanations of context and actions in Python, along with a quick reference for `PluginSurfaceProps` and `HostedApi`.
- Updated the structure of the documentation to facilitate better navigation and understanding of the hosted UI components.

* docs: enhance 'Hosted UI' documentation and improve plugin configuration details

- Updated the 'Hosted UI' documentation in both English and Chinese, adding essential metadata requirements for plugins.
- Clarified the configuration of surfaces in `plugin.toml`, including permissions and context settings.
- Improved examples for Python context and action handling, ensuring better guidance for plugin developers.
- Enhanced the structure and navigation of the documentation to facilitate user understanding of hosted UI components.

---------

Co-authored-by: LocalBuilder <local@builder>

Author: wislap

docs/.vitepress/config.ts

@@ -182,17 +182,17 @@ function pluginsSidebar(lang: 'en' | 'zh-CN' | 'ja') {
     en: {
       group: 'Plugin Development', overview: 'Overview', quick: 'Quick Start',
       sdk: 'SDK Reference', dec: 'Decorators', ex: 'Examples', adv: 'Advanced Topics',
-      best: 'Best Practices',
+      hosted: 'Hosted UI', best: 'Best Practices',
     },
     'zh-CN': {
       group: '插件开发', overview: '概览', quick: '快速开始',
       sdk: 'SDK 参考', dec: '装饰器', ex: '示例', adv: '进阶话题',
-      best: '最佳实践',
+      hosted: 'Hosted UI', best: '最佳实践',
     },
     ja: {
       group: 'プラグイン開発', overview: '概要', quick: 'クイックスタート',
       sdk: 'SDK リファレンス', dec: 'デコレーター', ex: 'サンプル', adv: '高度なトピック',
-      best: 'ベストプラクティス',
+      hosted: 'Hosted UI', best: 'ベストプラクティス',
     },
   }[lang]
   const p = lang === 'en' ? '' : `/${lang}`
@@ -204,6 +204,7 @@ function pluginsSidebar(lang: 'en' | 'zh-CN' | 'ja') {
         { text: t.quick, link: `${p}/plugins/quick-start` },
         { text: t.sdk, link: `${p}/plugins/sdk-reference` },
         { text: t.dec, link: `${p}/plugins/decorators` },
+        ...(lang === 'ja' ? [] : [{ text: t.hosted, link: `${p}/plugins/hosted-ui` }]),
         { text: t.ex, link: `${p}/plugins/examples` },
         { text: t.adv, link: `${p}/plugins/advanced` },
         { text: t.best, link: `${p}/plugins/best-practices` },

docs/design/llm-prompt-budget.md

@@ -128,7 +128,7 @@ PR #967 之前，全仓字符长度限制散落在各模块的 magic number 里
 | 负面关键词检查 user 上下文条数 | `NEGATIVE_KEYWORD_CHECK_CONTEXT_ITEMS` | 3 |
 
 **Drain 机制（Stage-2 单批 cap）**：
-- 每条 fact 落盘时带 `signal_processed=False` 标记（[memory/facts.py](memory/facts.py)）
+- 每条 fact 落盘时带 `signal_processed=False` 标记（[memory/facts.py](https://github.com/Project-N-E-K-O/N.E.K.O/blob/main/memory/facts.py)）
 - `aextract_facts_and_detect_signals` 拉**全部** unprocessed facts，按 importance DESC 取前 N=20，调 Stage-2
 - 成功 → `amark_signal_processed(ids)` 标记 True；失败 → 不动，下轮 idle tick 重试同一批
 - 多余的 fact（>20）留 `False`，下次 idle 自然 drain